@argosvix/sdk 0.4.21-alpha.0 → 0.4.23-alpha.0

package/README.md

@@ -2,7 +2,7 @@
 
 Transparent observability wrapper for AI provider SDKs. Wrap a single line of code and get cost, latency, token, and error records for every LLM call across OpenAI, Anthropic, Gemini, and Mistral.
 
-> 🟢 **Alpha released** — backend ingest (`ingest.argosvix.com`) and dashboard (`dashboard.argosvix.com`) are live. Published on npm as `@argosvix/sdk@alpha`. The entire sign-up to API-key flow runs in the browser; a Free plan and paid plans (Pro / Team) are available. See [`CHANGELOG.md`](./CHANGELOG.md) for the full change log.
+> 🟢 **Alpha released** — backend ingest (`ingest.argosvix.com`) and dashboard (`dashboard.argosvix.com`) are live. Published on npm as `@argosvix/sdk@alpha`. The entire sign-up to API-key flow runs in the browser; a Free plan and paid plans (Pro / Team) are available.
 >
 > Design principles:
 > - **No end-user PII is sent.** By default, prompt and completion bodies are never recorded; only token counts, cost, latency, and error codes leave your process. Content capture is a separate opt-in (`captureContent`, see below) and always applies PII masking before send.
@@ -38,7 +38,7 @@ Alternatively, run `npx @argosvix/cli init` — it opens the browser for a one-t
 ```bash
 export ARGOSVIX_API_KEY=argk_...
 # Default ingest endpoint = https://ingest.argosvix.com
-# Override with ARGOSVIX_API_BASE if you self-host the backend.
+# Override with ARGOSVIX_API_BASE if you route requests through a proxy.
 ```
 
 ## Quick start
@@ -132,7 +132,7 @@ There are three gates. The first two are enforced inside `wrap(...)` by evaluati
 cached backend config locally (no proxy, no per-call round trip). The third is an
 explicit request/await pair around a sensitive operation.
 
-A full runnable example lives in [`examples/headless-control-plane`](../../examples/headless-control-plane).
+Full usage details live in the docs: <https://argosvix.com/en/docs/sdk-reference>.
 
 ### Budget gate
 
@@ -396,12 +396,7 @@ for await (const chunk of stream) {
 
 ## Examples
 
-The [`examples/`](../../examples/) directory contains minimum-viable integrations for four stacks:
-
-- [`examples/nextjs-openai/`](../../examples/nextjs-openai/) — Next.js 14 App Router.
-- [`examples/express-anthropic/`](../../examples/express-anthropic/) — Express with streaming and SIGTERM flush.
-- [`examples/lambda-gemini/`](../../examples/lambda-gemini/) — AWS Lambda with `@google/genai` (note: container-reuse semantics).
-- [`examples/workers-anthropic/`](../../examples/workers-anthropic/) — Cloudflare Workers with the `flushClient` pattern.
+Integration guides for common stacks (Next.js App Router, Express with streaming and SIGTERM flush, AWS Lambda with `@google/genai`, Cloudflare Workers with the `flushClient` pattern) are available in the docs: <https://argosvix.com/en/docs/guides>.
 
 ## Alert webhooks
 

package/dist/aiSdkMiddleware.d.ts

@@ -1,23 +1,26 @@
 import type { ArgosvixConfig } from "./types.js";
 import { Recorder } from "./recorder.js";
 /**
- * 監査 Tier 2 = Vercel AI SDK (`ai` パッケージ) 統合。
+ * Vercel AI SDK (`ai` package) integration.
  *
- * AI SDK の `wrapLanguageModel({ model, middleware })` に渡せる
- * LanguageModelV2 / V4 互換のミドルウェアを返す。 `generateText` /
- * `streamText` / `generateObject` など AI SDK 経由の全呼び出しを、 プロバイダ
- * SDK を直接 wrap() しなくても観測できる (= 「AI SDK 内部からの呼び出しも記録
- * できるか」への答え = はい、 サポート 4 プロバイダについて)。
+ * Returns a LanguageModel middleware (compatible with ai@5-7) that can be
+ * passed to the AI SDK's `wrapLanguageModel({ model, middleware })`. All calls
+ * made through the AI SDK — `generateText` / `streamText` / `generateObject`
+ * and so on — become observable without wrap()ing the provider SDK directly.
+ * In other words: yes, calls originating inside the AI SDK are recorded too,
+ * for the four supported providers.
  *
- * AI SDK へのハード依存は持たない (= 型は構造的に定義、 `ai` を import しない)。
- * V2 (ai@5) と V4 (ai@6) でミドルウェアの形 (wrapGenerate / wrapStream) は同じ。
- * usage のフィールド名差 (旧: cachedInputTokens / reasoningTokens、 新:
- * inputTokenDetails.cacheReadTokens / outputTokenDetails.reasoningTokens) は
- * 両対応で読む。
+ * There is no hard dependency on the AI SDK (types are defined structurally;
+ * `ai` is never imported). The middleware shape (wrapGenerate / wrapStream) is
+ * the same across ai@5-7. Differences in usage shape (v7: inputTokens /
+ * outputTokens as object breakdowns; v5-6: numbers plus cachedInputTokens /
+ * inputTokenDetails etc.; the even older v4 line: promptTokens /
+ * completionTokens) are normalized by extractTokens().
  *
- * 設計方針: 観測コードは決してホストの LLM 呼び出しを壊さない。 記録は best-effort
- * (= 記録中の例外は握りつぶしてログのみ)。 成功記録は doGenerate の try の外で行い、
- * 記録時の例外で「成功した呼び出し」が error 扱いに化けないようにする。
+ * Design principle: observation code must never break the host's LLM call.
+ * Recording is best-effort (exceptions while recording are swallowed and only
+ * logged). Success recording happens outside the doGenerate try block, so a
+ * recording exception can never turn a successful call into an error.
  *
  * @example
  *   import { openai } from "@ai-sdk/openai";
@@ -36,10 +39,21 @@ interface AiSdkModelLike {
     modelId?: string;
     provider?: string;
 }
+/** The object breakdown carried by usage.inputTokens / usage.outputTokens in ai@7. */
+interface AiSdkTokenBreakdown {
+    total?: number;
+    noCache?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    text?: number;
+    reasoning?: number;
+}
 interface AiSdkUsage {
-    inputTokens?: number;
-    outputTokens?: number;
+    inputTokens?: number | AiSdkTokenBreakdown;
+    outputTokens?: number | AiSdkTokenBreakdown;
     totalTokens?: number;
+    promptTokens?: number;
+    completionTokens?: number;
     cachedInputTokens?: number;
     reasoningTokens?: number;
     inputTokenDetails?: {
@@ -49,6 +63,7 @@ interface AiSdkUsage {
     outputTokenDetails?: {
         reasoningTokens?: number;
     };
+    raw?: unknown;
 }
 interface AiSdkGenerateResult {
     usage?: AiSdkUsage;
@@ -79,15 +94,16 @@ interface WrapStreamOptions {
     model?: AiSdkModelLike;
 }
 /**
- * argosvixMiddleware() の戻り値。 AI SDK の middleware として使えるほか、
- * 短命ランタイム用に flush() / recorder を直接公開する。 flushClient(これ) も可。
+ * Return value of argosvixMiddleware(). Usable as an AI SDK middleware, and
+ * additionally exposes flush() / recorder directly for short-lived runtimes.
+ * flushClient(middleware) works as well.
  */
 export interface ArgosvixAiSdkMiddleware {
     wrapGenerate: (opts: WrapGenerateOptions) => Promise<AiSdkGenerateResult>;
     wrapStream: (opts: WrapStreamOptions) => Promise<AiSdkStreamResult>;
-    /** バッファをバックエンドへ flush し送信完了を待つ (= Workers / Lambda / Edge の finally 用)。 */
+    /** Flushes the buffer to the backend and waits for the send to complete (for finally blocks on Workers / Lambda / Edge). */
     flush: () => Promise<void>;
-    /** この middleware が使う Recorder (= getRecorder 相当)。 */
+    /** The Recorder this middleware uses (equivalent to getRecorder). */
     readonly recorder: Recorder;
 }
 export declare function argosvixMiddleware(config?: ArgosvixConfig): ArgosvixAiSdkMiddleware;

package/dist/aiSdkMiddleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aiSdkMiddleware.d.ts","sourceRoot":"","sources":["../src/aiSdkMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,YAAY,CAAC;AAK1E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,UAAU;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,iBAAiB,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,kBAAkB,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,eAAe;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,UAAU,iBAAiB;IACzB,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,mBAAmB;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC/C,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC1E,UAAU,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpE,2EAA2E;IAC3E,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAyGD,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,cAAmB,GAAG,uBAAuB,CAkQvF"}
+{"version":3,"file":"aiSdkMiddleware.d.ts","sourceRoot":"","sources":["../src/aiSdkMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,YAAY,CAAC;AAK1E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sFAAsF;AACtF,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,UAAU;IAElB,WAAW,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,iBAAiB,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,kBAAkB,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAElD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,eAAe;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,UAAU,iBAAiB;IACzB,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,mBAAmB;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC/C,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC1E,UAAU,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpE,4HAA4H;IAC5H,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AA4KD,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,cAAmB,GAAG,uBAAuB,CAmQvF"}

package/dist/aiSdkMiddleware.js

@@ -4,13 +4,15 @@ import { generateId } from "./ids.js";
 import { calculateCostWithCache } from "./pricing.js";
 import { Recorder } from "./recorder.js";
 /**
- * AI SDK の provider 文字列 (例 "openai.chat" / "anthropic.messages" /
- * "google.generative-ai" / "mistral.chat") を Argosvix の 4 プロバイダへ寄せる。
+ * Maps the AI SDK's provider string (e.g. "openai.chat" /
+ * "anthropic.messages" / "google.generative-ai" / "mistral.chat") onto
+ * Argosvix's four providers.
  *
- * 名前空間 (= 最初の "." より前) の完全一致で判定する。 substring 一致は
- * "openai-compatible" / "not-openai" を誤って openai に寄せるため使わない。
- * 該当なし = null (= backend が provider を厳格 enum 検証するため、 サポート外
- * provider を fabricate せず記録をスキップする)。
+ * Matching is an exact comparison on the namespace (the part before the first
+ * "."). Substring matching is deliberately avoided because it would wrongly
+ * map "openai-compatible" / "not-openai" to openai. No match returns null:
+ * the backend validates provider against a strict enum, so instead of
+ * fabricating an unsupported provider, recording is skipped.
  */
 function mapProvider(raw) {
     if (!raw)
@@ -39,7 +41,7 @@ function warnUnsupportedProvider(raw) {
     console.warn(`[argosvix] AI SDK provider "${label}" is not one of openai/anthropic/gemini/mistral; ` +
         `the call runs normally but is not recorded. Pass config.provider to override.`);
 }
-/** 記録は best-effort。 ここで投げてもホストの呼び出しを壊さない。 */
+/** Recording is best-effort. Exceptions thrown here never break the host's call. */
 function safeRun(fn) {
     try {
         fn();
@@ -49,27 +51,91 @@ function safeRun(fn) {
         console.error("[argosvix] AI SDK middleware recording failed (non-fatal):", err);
     }
 }
+/** Only finite numbers pass (NaN / Infinity / objects / strings become 0). A guard against polluting records. */
+function toCount(v) {
+    return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
 /**
- * AI SDK の正規化 usage から Argosvix の記録用トークン内訳を取り出す。
- * inputTokens は AI SDK 仕様上「キャッシュ読取を含む input 合計」なので、
- * calculateCostWithCache の promptTokens (= cache 込み input) にそのまま渡す。
+ * Normalizes AI SDK usage out of all three shapes seen across ai@5-7.
+ *
+ * - ai@7: inputTokens/outputTokens are objects
+ *   ({ total, noCache, cacheRead(, cacheWrite) } / { total, text, reasoning }).
+ *   total is the cache-read-inclusive sum, so it is used directly as
+ *   promptTokens; cacheRead maps to cachedReadTokens and reasoning to
+ *   reasoningTokens
+ * - ai@5-6: inputTokens/outputTokens are numbers (cache-read-inclusive input
+ *   total). Breakdowns come from the top-level cachedInputTokens /
+ *   reasoningTokens or from inputTokenDetails / outputTokenDetails
+ * - older v4 line: numbers under the promptTokens/completionTokens naming
+ *
+ * Unknown shapes fall back defensively to 0 (NaN / "[object Object]" must
+ * never end up in a record). promptTokens is returned as the
+ * cache-read-inclusive input total, as calculateCostWithCache expects.
  */
 function extractTokens(usage) {
-    const promptTokens = usage?.inputTokens ?? 0;
-    const completionTokens = usage?.outputTokens ?? 0;
-    const cachedReadTokens = usage?.cachedInputTokens ?? usage?.inputTokenDetails?.cacheReadTokens ?? 0;
-    const cachedWriteTokens = usage?.inputTokenDetails?.cacheWriteTokens ?? 0;
-    const reasoningTokens = usage?.reasoningTokens ?? usage?.outputTokenDetails?.reasoningTokens ?? 0;
+    let promptTokens = 0;
+    let completionTokens = 0;
+    let cachedReadTokens = 0;
+    let cachedWriteTokens = 0;
+    let reasoningTokens = 0;
+    const input = usage?.inputTokens;
+    if (typeof input === "number") {
+        // ai@5-6: a number (cache-read-inclusive input total)
+        promptTokens = toCount(input);
+    }
+    else if (input !== null && typeof input === "object") {
+        // ai@7: object breakdown
+        cachedReadTokens = toCount(input.cacheRead);
+        cachedWriteTokens = toCount(input.cacheWrite);
+        promptTokens =
+            typeof input.total === "number" && Number.isFinite(input.total)
+                ? input.total
+                : toCount(input.noCache) + cachedReadTokens + cachedWriteTokens;
+    }
+    else {
+        // older v4 line (0 when input is undefined)
+        promptTokens = toCount(usage?.promptTokens);
+    }
+    const output = usage?.outputTokens;
+    if (typeof output === "number") {
+        completionTokens = toCount(output);
+    }
+    else if (output !== null && typeof output === "object") {
+        reasoningTokens = toCount(output.reasoning);
+        completionTokens =
+            typeof output.total === "number" && Number.isFinite(output.total)
+                ? output.total
+                : toCount(output.text) + reasoningTokens;
+    }
+    else {
+        completionTokens = toCount(usage?.completionTokens);
+    }
+    // ai@5-6 breakdown fallback (never overwrites values already taken from the v7 object)
+    if (cachedReadTokens === 0) {
+        cachedReadTokens =
+            toCount(usage?.cachedInputTokens) || toCount(usage?.inputTokenDetails?.cacheReadTokens);
+    }
+    if (cachedWriteTokens === 0) {
+        cachedWriteTokens = toCount(usage?.inputTokenDetails?.cacheWriteTokens);
+    }
+    if (reasoningTokens === 0) {
+        reasoningTokens =
+            toCount(usage?.reasoningTokens) || toCount(usage?.outputTokenDetails?.reasoningTokens);
+    }
+    const rawTotal = usage?.totalTokens;
+    const totalTokens = typeof rawTotal === "number" && Number.isFinite(rawTotal)
+        ? rawTotal
+        : promptTokens + completionTokens;
     return {
         promptTokens,
         completionTokens,
-        totalTokens: usage?.totalTokens ?? promptTokens + completionTokens,
+        totalTokens,
         cachedReadTokens,
         cachedWriteTokens,
         reasoningTokens,
     };
 }
-/** stream パートが「初回トークン」(本文 / 推論 / ツール) を載せているか (= TTFT 用)。 */
+/** Whether a stream part carries a "first token" (text / reasoning / tool) — used for TTFT. */
 function partHasOutput(part) {
     const t = part.type;
     if (!t)
@@ -82,7 +148,7 @@ function partHasOutput(part) {
         t === "tool-input-start" ||
         t === "tool-input-delta");
 }
-/** AI SDK のエラー (APICallError 等) から status / code を best-effort 抽出。 */
+/** Best-effort extraction of status / code from AI SDK errors (APICallError etc.). */
 function extractErrorDetails(err) {
     if (!err || typeof err !== "object")
         return undefined;
@@ -99,10 +165,10 @@ function extractErrorDetails(err) {
 }
 export function argosvixMiddleware(config = {}) {
     const recorder = new Recorder(config);
-    // withSpan が emit する observation の送信先として登録 (= wrap() と同じ扱い)。
+    // Register as a destination for the observations withSpan emits (same treatment as wrap()).
     _registerObservationSink(recorder);
     const callTags = { ...(config.tags ?? {}) };
-    // trace 軸は呼び出し入口で snapshot する (= await 後に ambient が消えても取り違えない)。
+    // Trace fields are snapshotted at call entry, so nothing is misattributed even if the ambient context is gone after an await.
     function buildTraceMeta() {
         const meta = {};
         const ambient = config.autoContext === false ? undefined : getAmbientTraceContext();
@@ -183,7 +249,7 @@ export function argosvixMiddleware(config = {}) {
             recorder.record(record);
         });
     }
-    /** config.provider 明示 > model.provider からの推定。 推定不能 = null。 */
+    /** Explicit config.provider wins over inference from model.provider. Returns null when inference fails. */
     function resolveProvider(model) {
         if (config.provider)
             return config.provider;
@@ -201,7 +267,7 @@ export function argosvixMiddleware(config = {}) {
             const id = generateId();
             const traceMeta = buildTraceMeta();
             const requestMeta = buildRequestMeta(params);
-            // 予算 / ポリシーゲート (= opt-in 時のみ実動作)。 block は error 記録 + rethrow。
+            // Budget / policy gate (only active when opted in). A block is recorded as an error and rethrown.
             try {
                 await recorder.budgetGate.check({ model: modelId, payload: params });
             }
@@ -217,7 +283,7 @@ export function argosvixMiddleware(config = {}) {
                 recordError(id, provider, modelId, start, traceMeta, requestMeta, err);
                 throw err;
             }
-            // 成功記録は try の外 (= 記録時の例外で成功呼び出しが error に化けない)。
+            // Success recording stays outside the try block so a recording exception cannot turn a successful call into an error.
             const usedModel = result.response?.modelId ?? modelId;
             recordSuccess(id, provider, usedModel, start, result.usage, undefined, traceMeta, requestMeta);
             return result;
@@ -245,19 +311,20 @@ export function argosvixMiddleware(config = {}) {
                 streamResult = await doStream();
             }
             catch (err) {
-                // stream の初期化失敗 (= auth / validation / connection) も観測する。
+                // Stream initialization failures (auth / validation / connection) are observed too.
                 recordError(id, provider, modelId, start, traceMeta, requestMeta, err);
                 throw err;
             }
             const { stream, ...rest } = streamResult;
             const reader = stream.getReader();
             let usedModel = modelId;
-            let finishUsage; // finish パートの usage を優先
-            let lastUsage; // finish が無い adapter 用の fallback
+            let finishUsage; // prefer the finish part's usage
+            let lastUsage; // fallback for adapters without a finish part
             let ttftMs;
-            let recorded = false; // 二重記録防止
-            // 自前 pump = 正常完走でも消費中エラーでも 1 回だけ記録する
-            // (= TransformStream.flush はエラー時に発火しないため使わない)。
+            let recorded = false; // guards against double recording
+            // Hand-rolled pump: record exactly once whether the stream completes
+            // normally or errors mid-consumption. (TransformStream.flush is not used
+            // because it does not fire on error.)
             const observed = new ReadableStream({
                 async pull(controller) {
                     let chunk;
@@ -295,7 +362,7 @@ export function argosvixMiddleware(config = {}) {
                     controller.enqueue(part);
                 },
                 cancel(reason) {
-                    // 消費側が途中 cancel = usage 未確定なので記録しない (= 仕様上 token 不明)。
+                    // A mid-stream cancel by the consumer means usage was never finalized, so nothing is recorded (tokens are unknowable by spec).
                     return reader.cancel(reason);
                 },
             });
@@ -312,7 +379,7 @@ export function argosvixMiddleware(config = {}) {
         },
         recorder,
     };
-    // flushClient(middleware) / getRecorder(middleware) を wrap 済みと同経路で動かす。
+    // Makes flushClient(middleware) / getRecorder(middleware) work through the same path as wrapped clients.
     _registerRecorderFor(middleware, recorder);
     return middleware;
 }

package/dist/aiSdkMiddleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"aiSdkMiddleware.js","sourceRoot":"","sources":["../src/aiSdkMiddleware.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"aiSdkMiddleware.js","sourceRoot":"","sources":["../src/aiSdkMiddleware.ts"],"names":[],"mappings":"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"}

package/dist/approvals.d.ts

@@ -1,17 +1,22 @@
 /**
- * 人間承認ゲートの SDK API (= ランタイム制御プレーン Phase 3)。
+ * Human approval gate SDK API (part of the runtime control plane).
  *
- * agent の危険操作 (= 削除 / 送金 / 退会等) の前に呼ぶと、 Argosvix backend に
- * 承認依頼が作られ、 account owner へ email 通知が飛ぶ。 人間が dashboard
- * (/approvals) か email link で承認 / 否認するまで `waitForApproval()` が待つ。
+ * Call this before a dangerous agent operation (deletion, money transfer,
+ * account cancellation, etc.). It creates an approval request on the Argosvix
+ * backend and sends an email notification to the account owner.
+ * `waitForApproval()` blocks until a human approves or denies the request via
+ * the dashboard (/approvals) or the email link.
  *
- * 設計:
- *   - wrap() とは独立した明示 API (= LLM 呼び出し単位ではなく操作単位)
- *   - timeout 切れ / waitForApproval の待ち時間超過は "expired" / "denied"
- *     扱いで返す = default-deny。 呼び出し側は approved 以外で操作を中止する
- *   - polling は default 5 秒間隔 + jitter。 backend の read rate limit は
- *     account 単位 60/分 のため、 同時に待てる approval は実質 ~5 件
- *     (= 超過分は 429 → 次 poll で再試行されるので安全側だが遅くなる)
+ * Design:
+ *   - An explicit API independent of wrap() (scoped per operation, not per
+ *     LLM call)
+ *   - A backend-side timeout or an exceeded waitForApproval wait returns
+ *     "expired" / "denied" — i.e. default-deny. Callers must abort the
+ *     operation for any status other than "approved".
+ *   - Polling defaults to a 5-second interval plus jitter. The backend read
+ *     rate limit is 60/min per account, so only about ~5 approvals can be
+ *     awaited concurrently (excess polls get 429 and retry on the next tick,
+ *     which is safe but slower).
  *
  * @example
  * import { requestApproval, waitForApproval } from "@argosvix/sdk";
@@ -19,7 +24,7 @@
  * const approval = await requestApproval({
  *   apiKey: "argk_...",
  *   action: "delete_user",
- *   summary: "user usr_123 を削除します (LTV $0、90 日 inactive)",
+ *   summary: "Delete user usr_123 (LTV $0, inactive for 90 days)",
  * });
  * const status = await waitForApproval({ apiKey: "argk_...", id: approval.id });
  * if (status !== "approved") throw new Error(`not approved: ${status}`);
@@ -41,49 +46,52 @@ export declare class ArgosvixApprovalError extends Error {
     constructor(message: string, status?: number | null);
 }
 export interface ApprovalClientOptions {
-    /** Argosvix API key (= 必須)。 */
+    /** Argosvix API key (required). */
     apiKey: string;
     /**
-     * API base の override (= self-host / test 用)。 未指定は
-     * https://ingest.argosvix.com。 ArgosvixConfig.endpoint (= .../v1/ingest)
-     * を渡した場合は prefix を導出する。
+     * API base override (for self-hosting / tests). Defaults to
+     * https://ingest.argosvix.com. If an ArgosvixConfig.endpoint value
+     * (.../v1/ingest) is passed, the prefix is derived from it.
      */
     endpoint?: string;
     /**
-     * 承認を紐づける project (= X-Project-Id header で送信、 record の projectId と同方式)。
-     * 未指定は backend が account の default project に倒す (= 後方互換)。
+     * Project to associate approvals with (sent as the X-Project-Id header, the
+     * same mechanism as a record's projectId). When unset, the backend falls
+     * back to the account's default project (backward compatible).
      */
     projectId?: string;
 }
 export interface RequestApprovalParams extends ApprovalClientOptions {
-    /** 操作の識別子 (= 1-128 文字、 [A-Za-z0-9._: -])。 例: "delete_user" */
+    /** Operation identifier (1-128 chars, [A-Za-z0-9._: -]). Example: "delete_user" */
     action: string;
-    /** 人間が読む 1 行説明 (= 1-500 文字)。 承認 email にそのまま載る。 */
+    /** One-line human-readable description (1-500 chars). Shown verbatim in the approval email. */
     summary: string;
-    /** 補足 JSON object (= 4KB まで、 任意)。 */
+    /** Supplementary JSON object (up to 4KB, optional). */
     metadata?: Record<string, unknown>;
-    /** 承認期限秒 (= 60-86400、 default 3600)。 期限切れ = expired = deny 扱い。 */
+    /** Approval deadline in seconds (60-86400, default 3600). Expiry means "expired", treated as deny. */
     timeoutSeconds?: number;
 }
-/** 承認依頼を作成する。 account owner へ email 通知が飛ぶ。 */
+/** Create an approval request. Sends an email notification to the account owner. */
 export declare function requestApproval(params: RequestApprovalParams): Promise<ApprovalRequestShape>;
-/** 承認依頼の現在状態を 1 回取得する。 */
+/** Fetch the current state of an approval request once. */
 export declare function getApproval(params: ApprovalClientOptions & {
     id: string;
 }): Promise<ApprovalRequestShape>;
 export interface WaitForApprovalParams extends ApprovalClientOptions {
     id: string;
-    /** polling 間隔 ms (= default 5000、 最小 1000)。 */
+    /** Polling interval in ms (default 5000, minimum 1000). */
     pollIntervalMs?: number;
     /**
-     * 待機の上限 ms (= default 1 時間)。 超過時は "expired" を返す = default-deny。
-     * backend 側の依頼 timeout とは独立 (= 短い方が先に効く)。
+     * Maximum wait in ms (default 1 hour). On exceeding it, returns "expired"
+     * — i.e. default-deny. Independent of the backend-side request timeout
+     * (whichever is shorter takes effect first).
      */
     timeoutMs?: number;
 }
 /**
- * 承認 / 否認 / 期限切れまで polling して最終 status を返す。
- * "approved" 以外が返ったら呼び出し側は操作を実行しないこと (= default-deny)。
+ * Poll until the request is approved, denied, or expired, then return the
+ * final status. If anything other than "approved" is returned, the caller
+ * must not execute the operation (default-deny).
  */
 export declare function waitForApproval(params: WaitForApprovalParams): Promise<Exclude<ApprovalStatus, "pending">>;
 //# sourceMappingURL=approvals.d.ts.map

package/dist/approvals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../src/approvals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AASH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;gBACnB,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW;CAK1D;AAED,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmDD,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8CAA8C;AAC9C,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAe/B;AAED,0BAA0B;AAC1B,wBAAsB,WAAW,CAC/B,MAAM,EAAE,qBAAqB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,oBAAoB,CAAC,CAS/B;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CA4B7C"}
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../src/approvals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AASH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;gBACnB,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW;CAK1D;AAED,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmDD,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,sGAAsG;IACtG,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,oFAAoF;AACpF,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAe/B;AAED,2DAA2D;AAC3D,wBAAsB,WAAW,CAC/B,MAAM,EAAE,qBAAqB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,oBAAoB,CAAC,CAS/B;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CA4B7C"}