菜单
How to use @t4h.framework/http HttpClient, http singleton, HttpRequestActivityInput, HttpAuth, OAuth2, HttpClientRequestClaim. Use when calling HTTP from workflows or extending OAuth2.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Documents @t4h.framework/amber (Amber client, Ticket operations, HTTP activities, Basic auth, runtime-claims peers). Use when implementing ticket or protocol flows—integration, creation, updates, transfers, tabulation, comments, locks—or when the user asks about ticket/protocol integration, creating tickets or protocols, or similar; also when they mention @t4h.framework/amber or Amber channel APIs.
Guides assembling T4H apps with Workflow definitions, default-export App wiring, and routing to the correct framework-* skill per @t4h.framework package. Use when scaffolding workflows, structuring main plus src/workflows, nesting startWorkflow, or choosing which package skill to read for HTTP, auth, ORM, Amber, cache, FS, SFTP, or SMTP.
How to use @t4h.framework/cache CacheClaim get/set, TTL, and Serializable values; pairing with @t4h.framework/http OAuth2. Use when implementing caches or imports from @t4h.framework/cache.
How to use @t4h.framework/core App, Workflow, Authorization, Env, Claim, History, Binary, Serializable, startWorkflow, StartWorkflowActivity, WorkflowClaim, and WorkflowRef. Use when building T4H apps, workflows, nested workflow starts, or importing from @t4h.framework/core.
How to use @t4h.framework/fs FileSystemClaim read/write and Binary. Use when handling filesystem claims or imports from @t4h.framework/fs.
How to use @t4h.framework/jwks JWKSAuthorization, context fields, and the authorize module JWT vs raw signature paths. Use when configuring JWKS app authorization or imports from @t4h.framework/jwks.
| name | t4h-framework-http |
| description | How to use @t4h.framework/http HttpClient, http singleton, HttpRequestActivityInput, HttpAuth, OAuth2, HttpClientRequestClaim. Use when calling HTTP from workflows or extending OAuth2. |
HttpClient methods go through HttpRequestActivity (History.bind): each call performs an HTTP request via HttpClientRequestClaim and writes the response body through FileSystemClaim for the returned Body.
Install @t4h.framework/cache, @t4h.framework/core, and @t4h.framework/fs together with this package.
httphttp is a singleton Http (extends HttpClient) with empty config. extend(partialConfig) returns a new HttpClient merged with HttpClientConfig.
HttpClientConfig| Field | Purpose |
|---|---|
baseUrl | Optional base for new URL(url, baseUrl). |
auth | HttpAuth or { username, password } (Basic Authorization header). |
HttpClient methodsrequest(url, config?) merges url, client auth / baseUrl, and HttpRequestActivityInput fields.
get, post, put, patch, delete set method (and body where applicable). get has no body.
HttpRequestActivityInput| Field | Notes |
|---|---|
url | Required (path or absolute URL). |
baseUrl | Overrides client default when set. |
method | Defaults to GET in the activity if omitted. |
body | { json: Serializable }, { text: string }, or { form: nested object } (supports Binary, nesting). |
headers | Record<string, string | string[] | undefined>. |
auth | Same as HttpClientConfig.auth → Authorization header. |
redirect | 'follow' | 'manual' | number; default 'follow'. |
retry | true (default) or HttpRequestActivityInputRetryOptions (limit, methods, status, backoffLimit, jitter, …). |
HttpAuthAbstract: implement getAuthorizationHeader() (full value, e.g. Bearer …). The base class wires a Claim that includes CacheClaim (used by OAuth2 for token storage).
OAuth2<TConfig extends OAuth2Config> extends HttpAuth, uses HttpClientRequestClaim + CacheClaim. OAuth2Config: tokenUrl, clientId. Default toToken(): POST application/x-www-form-urlencoded from toTokenBody(), JSON response as OAuth2Token, cache key oauth2:token:${clientId}, TTL from expires_in, refresh via refresh_token when present and expired.
| Class | Behavior |
|---|---|
OAuth2ClientCredentials | grant_type: client_credentials + client_secret. |
OAuth2GrantResourceOwnerPassword | grant_type: password + clientSecret, username, password (on top of OAuth2Config). |
OAuth2Token: access_token, optional refresh_token, expires_in, token_type.
HttpClientRequestClaimrequest(input: HttpClientRequestClaimInput): url is a URL; body: Buffer, FormData, Readable, URLSearchParams, or undefined; headers, redirect, retry. Response: status, headers, body as Readable.
Override toToken() in OAuth2 subclasses when the token endpoint expects something other than form body (then call this.claims.http.request(...)).
force-manual-processmicro-services/force-manual-process/src/workflows/service-tabulate.ts: http.patch with auth. LapisLazuliOAuth2ClientCredentials (extends OAuth2ClientCredentials) overrides toToken() to POST JSON to the token URL and parse OAuth2Token.