@argosvix/sdk 0.4.22-alpha.0 → 0.5.0

package/dist/policyScan.d.ts

@@ -1,43 +1,50 @@
 /**
- * ポリシーゲートの block 判定用スキャン (= ランタイム制御プレーン Phase 2、
- * R66b fix bundle で redaction.ts の流用から分離・再設計)。
+ * Scan used for the policy gate's block decision (part of the runtime control
+ * plane; separated and redesigned from the earlier reuse of redaction.ts).
  *
- * redaction.ts の PATTERNS は「false positive 寛容 (= 過剰マスク OK)」設計で、
- * block の判定述語に流用すると正当な呼び出しを production で止めてしまう
- * (= timestamp がカード番号扱い、 数値 ID が電話番号扱い、 base64 が secret 扱い)。
- * 本 module は逆方針 = 「false negative 寛容 / false positive 厳禁」で設計する:
+ * The PATTERNS in redaction.ts are designed to be false-positive tolerant
+ * (over-masking is acceptable). Reusing them as a blocking predicate would stop
+ * legitimate calls in production (timestamps treated as card numbers, numeric
+ * IDs as phone numbers, base64 as secrets). This module takes the opposite
+ * stance: false negatives are tolerated, false positives are strictly avoided:
  *
- *   - 検査対象は payload の JSON 文字列化ではなく、 object を再帰 walk して
- *     集めた string 値のみ (= 数値 field / TypedArray は最初から対象外、
- *     JSON escape で改行跨ぎ検知が壊れる問題も解消)
- *   - data: URL の base64 本体と「空白を含まない超長文字列」は binary 扱いで
- *     skip (= 画像 / file blob の確率的 false positive と CPU 浪費の防止)
- *   - カード番号は Luhn checksum 検証付き (= 13 桁の epoch ms 等を弾く)
- *   - 電話番号 / マイナンバーは区切り文字必須の形のみ (= 連続数字に match しない)
- *   - secret は左右境界付き (= base64 中や ID 文字列の部分一致を防ぐ)
+ *   - The scan target is not the JSON stringification of the payload but only
+ *     the string values collected by recursively walking the object (numeric
+ *     fields / TypedArrays are excluded from the start; this also fixes the
+ *     problem where JSON escaping broke detection across newlines)
+ *   - The base64 body of data: URLs and very long strings containing no
+ *     whitespace are treated as binary and skipped (prevents probabilistic
+ *     false positives on images / file blobs and wasted CPU)
+ *   - Card numbers are verified with a Luhn checksum (rejects e.g. 13-digit
+ *     epoch-ms values)
+ *   - Phone numbers / Japanese My Number only match separator-delimited forms
+ *     (no match on runs of consecutive digits)
+ *   - Secrets require boundaries on both sides (prevents partial matches
+ *     inside base64 or ID strings)
  *
- * 検知時は「どの field か (JSON path) + masked snippet」を返し、 顧客が
- * false positive を debug できるようにする (= 平文は返さない)。
+ * On detection, returns which field matched (JSON path) plus a masked snippet
+ * so customers can debug false positives (plaintext is never returned).
  */
 export interface PolicyScanHit {
     kind: "pii" | "secret";
     pattern: string;
-    /** 検知した string 値の JSON path (例: messages[2].content)。 */
+    /** JSON path of the detected string value (e.g. messages[2].content). */
     path: string;
-    /** masked snippet (例: "al***om")。 平文は含まない。 */
+    /** Masked snippet (e.g. "al***om"). Never contains plaintext. */
     snippet: string;
 }
-/** Luhn checksum (= カード番号の実在性検証)。 */
+/** Luhn checksum (validates that a card number is plausible). */
 export declare function luhnValid(digits: string): boolean;
 interface TextValue {
     path: string;
     text: string;
 }
-/** payload object から string 値だけを path 付きで再帰収集する。 */
+/** Recursively collect only string values from the payload object, with their paths. */
 export declare function collectTextValues(payload: unknown): TextValue[];
 /**
- * payload を walk して最初の violation を返す。 検知なしは null。
- * secrets を PII より先に評価する (= credential は PII より深刻、 告知の優先度)。
+ * Walk the payload and return the first violation, or null if none detected.
+ * Secrets are evaluated before PII (credentials are more severe than PII, so
+ * they take reporting priority).
  */
 export declare function scanPolicyViolation(payload: unknown, opts: {
     pii: boolean;

package/dist/policyScan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policyScan.d.ts","sourceRoot":"","sources":["../src/policyScan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AA+CD,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAejD;AAcD,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,CAgC/D;AAwCD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACvC,aAAa,GAAG,IAAI,CAkBtB"}
+{"version":3,"file":"policyScan.d.ts","sourceRoot":"","sources":["../src/policyScan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;CACjB;AAiDD,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAejD;AAcD,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,CAgC/D;AAwCD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACvC,aAAa,GAAG,IAAI,CAkBtB"}

package/dist/policyScan.js

@@ -1,52 +1,60 @@
 /**
- * ポリシーゲートの block 判定用スキャン (= ランタイム制御プレーン Phase 2、
- * R66b fix bundle で redaction.ts の流用から分離・再設計)。
+ * Scan used for the policy gate's block decision (part of the runtime control
+ * plane; separated and redesigned from the earlier reuse of redaction.ts).
  *
- * redaction.ts の PATTERNS は「false positive 寛容 (= 過剰マスク OK)」設計で、
- * block の判定述語に流用すると正当な呼び出しを production で止めてしまう
- * (= timestamp がカード番号扱い、 数値 ID が電話番号扱い、 base64 が secret 扱い)。
- * 本 module は逆方針 = 「false negative 寛容 / false positive 厳禁」で設計する:
+ * The PATTERNS in redaction.ts are designed to be false-positive tolerant
+ * (over-masking is acceptable). Reusing them as a blocking predicate would stop
+ * legitimate calls in production (timestamps treated as card numbers, numeric
+ * IDs as phone numbers, base64 as secrets). This module takes the opposite
+ * stance: false negatives are tolerated, false positives are strictly avoided:
  *
- *   - 検査対象は payload の JSON 文字列化ではなく、 object を再帰 walk して
- *     集めた string 値のみ (= 数値 field / TypedArray は最初から対象外、
- *     JSON escape で改行跨ぎ検知が壊れる問題も解消)
- *   - data: URL の base64 本体と「空白を含まない超長文字列」は binary 扱いで
- *     skip (= 画像 / file blob の確率的 false positive と CPU 浪費の防止)
- *   - カード番号は Luhn checksum 検証付き (= 13 桁の epoch ms 等を弾く)
- *   - 電話番号 / マイナンバーは区切り文字必須の形のみ (= 連続数字に match しない)
- *   - secret は左右境界付き (= base64 中や ID 文字列の部分一致を防ぐ)
+ *   - The scan target is not the JSON stringification of the payload but only
+ *     the string values collected by recursively walking the object (numeric
+ *     fields / TypedArrays are excluded from the start; this also fixes the
+ *     problem where JSON escaping broke detection across newlines)
+ *   - The base64 body of data: URLs and very long strings containing no
+ *     whitespace are treated as binary and skipped (prevents probabilistic
+ *     false positives on images / file blobs and wasted CPU)
+ *   - Card numbers are verified with a Luhn checksum (rejects e.g. 13-digit
+ *     epoch-ms values)
+ *   - Phone numbers / Japanese My Number only match separator-delimited forms
+ *     (no match on runs of consecutive digits)
+ *   - Secrets require boundaries on both sides (prevents partial matches
+ *     inside base64 or ID strings)
  *
- * 検知時は「どの field か (JSON path) + masked snippet」を返し、 顧客が
- * false positive を debug できるようにする (= 平文は返さない)。
+ * On detection, returns which field matched (JSON path) plus a masked snippet
+ * so customers can debug false positives (plaintext is never returned).
  */
 const MAX_DEPTH = 8;
 const MAX_STRINGS = 500;
-// 1 string あたりの scan 上限 (= 超過分は先頭のみ scan、 hot path の CPU cap)
+// Per-string scan cap (anything beyond it only has its head scanned; CPU cap for the hot path)
 const MAX_STRING_SCAN_CHARS = 262_144;
-// 空白を含まない長大文字列は binary / base64 とみなして skip する閾値
+// Threshold above which a long string with no whitespace is treated as binary / base64 and skipped
 const BINARY_LIKE_MIN_CHARS = 4_096;
-// ---- PII (block 用、 false positive 厳禁方針) ----
+// ---- PII (for blocking; false positives strictly avoided) ----
 const EMAIL_RE = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/;
-// カード番号候補 (= 区切りあり/なし 13-19 桁)。 match 後に Luhn 検証する。
+// Card number candidates (13-19 digits, with or without separators). Luhn-verified after matching.
 const CC_CANDIDATE_RE = /(?<![\d-])(?:\d[ -]?){12,18}\d(?![\d-])/g;
-// 区切り必須の電話形 (JP 0 始まり + 国際 + 形)。 連続数字には match しない。
+// Phone forms requiring separators (JP leading-0 form + international form). Does not match runs of consecutive digits.
 const PHONE_JP_RE = /(?<!\d)0\d{1,4}[- ]\d{1,4}[- ]\d{3,4}(?!\d)/;
 const PHONE_INTL_RE = /(?<![\dA-Za-z])\+\d{1,3}[- ]\d{1,4}(?:[- ]\d{2,4}){1,3}(?!\d)/;
-// マイナンバーは 4-4-4 の区切り形のみ (= 12 桁連続は ID と区別不能なので対象外)
+// Japanese My Number only in the 4-4-4 separated form (12 consecutive digits are indistinguishable from IDs, so excluded)
 const MY_NUMBER_RE = /(?<![\d-])\d{4}-\d{4}-\d{4}(?![\d-])/;
-// IPv4 は octet 値 (0-255) まで検証
+// IPv4 validates octet values (0-255)
 const IPV4_RE = /(?<![\d.])(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(?![\d.])/;
-// IPv6 (= R72b MEDIUM 3 検知拡張)。 false positive 厳禁方針のため保守的に:
-//   - 完全形 (= 8 group / 7 colon) または
-//   - "::" 圧縮形で左側に 2 group 以上 (例 2001:db8::1)
-// に限定する。 時刻 "12:34:56" (3 group / :: なし)、 C++ "std::vector" (hex 外)、
-// MAC "00:1A:..." (6 group / :: なし) には match しない。 "fe80::1" のような
-// 左 1 group の圧縮形は意図的に対象外 (= 短い hex::hex が code 中で偶発しうる)。
+// IPv6 (detection added in a later revision). Kept conservative to strictly avoid
+// false positives; limited to:
+//   - the full form (8 groups / 7 colons), or
+//   - the "::" compressed form with 2+ groups on the left (e.g. 2001:db8::1)
+// Does not match times like "12:34:56" (3 groups, no "::"), C++ "std::vector"
+// (non-hex), or MACs "00:1A:..." (6 groups, no "::"). Compressed forms with a
+// single left group like "fe80::1" are intentionally excluded (a short hex::hex
+// can occur incidentally in code).
 const IPV6_RE = /(?<![0-9A-Fa-f:])(?:(?:[0-9A-Fa-f]{1,4}:){7}[0-9A-Fa-f]{1,4}|(?:[0-9A-Fa-f]{1,4}:){2,6}:(?:[0-9A-Fa-f]{1,4}(?::[0-9A-Fa-f]{1,4}){0,5})?)(?![0-9A-Fa-f:])/;
-// ---- secrets (左右境界付き) ----
-const B = "(?<![A-Za-z0-9_-])"; // 左境界 (= base64 / ID 中の部分一致防止)
+// ---- secrets (bounded on both sides) ----
+const B = "(?<![A-Za-z0-9_-])"; // Left boundary (prevents partial matches inside base64 / ID strings)
 const SECRET_PATTERNS = [
-    // anthropic を openai より先に (= sk-ant- が openai 扱いになる dead pattern 防止)
+    // anthropic before openai (otherwise sk-ant- would be classified as openai, making that pattern dead)
     { name: "anthropic_api_key", re: new RegExp(`${B}sk-ant-[A-Za-z0-9_-]{20,}`) },
     { name: "openai_api_key", re: new RegExp(`${B}sk-(?!ant-)[A-Za-z0-9_-]{20,}`) },
     { name: "aws_access_key", re: new RegExp(`${B}AKIA[0-9A-Z]{16}(?![A-Za-z0-9])`) },
@@ -57,7 +65,7 @@ const SECRET_PATTERNS = [
     { name: "private_key_block", re: /-----BEGIN [A-Z ]*PRIVATE KEY-----/ },
     { name: "argosvix_api_key", re: new RegExp(`${B}argk_[a-z0-9]{20,}`) },
 ];
-/** Luhn checksum (= カード番号の実在性検証)。 */
+/** Luhn checksum (validates that a card number is plausible). */
 export function luhnValid(digits) {
     if (digits.length < 13 || digits.length > 19)
         return false;
@@ -85,12 +93,12 @@ function maskSnippet(match) {
 function isBinaryLike(text) {
     if (text.startsWith("data:") && text.includes(";base64,"))
         return true;
-    // 空白を一切含まない長大文字列 = base64 / blob / 連結 token とみなす
+    // A very long string with no whitespace at all is treated as base64 / a blob / concatenated tokens
     if (text.length >= BINARY_LIKE_MIN_CHARS && !/\s/.test(text))
         return true;
     return false;
 }
-/** payload object から string 値だけを path 付きで再帰収集する。 */
+/** Recursively collect only string values from the payload object, with their paths. */
 export function collectTextValues(payload) {
     const out = [];
     const seen = new Set();
@@ -111,7 +119,7 @@ export function collectTextValues(payload) {
         if (!value || typeof value !== "object" || depth >= MAX_DEPTH)
             return;
         if (seen.has(value))
-            return; // circular 防御
+            return; // guard against circular references
         seen.add(value);
         if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer)
             return;
@@ -166,8 +174,9 @@ function scanTextForSecret(text) {
     return null;
 }
 /**
- * payload を walk して最初の violation を返す。 検知なしは null。
- * secrets を PII より先に評価する (= credential は PII より深刻、 告知の優先度)。
+ * Walk the payload and return the first violation, or null if none detected.
+ * Secrets are evaluated before PII (credentials are more severe than PII, so
+ * they take reporting priority).
  */
 export function scanPolicyViolation(payload, opts) {
     if (!opts.pii && !opts.secrets)

package/dist/policyScan.js.map

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

package/dist/pricing.d.ts

@@ -18,13 +18,13 @@ export declare const PRICING: Record<Provider, Record<string, PricingEntry>>;
  */
 export declare function calculateCost(provider: Provider, model: string, promptTokens: number, completionTokens: number): number;
 /**
- * キャッシュトークンを考慮した USD コスト + キャッシュ削減額。
+ * USD cost accounting for cache tokens, plus the cache savings amount.
  *
- * promptTokens は「キャッシュ読取 + 書込を含む input 合計」。 内訳:
- *   uncached = promptTokens − cachedReadTokens − cachedWriteTokens(下限 0)
+ * promptTokens is the total input including cache reads and writes. Breakdown:
+ *   uncached = promptTokens − cachedReadTokens − cachedWriteTokens (floored at 0)
  *   cost = uncached×input + cachedRead×input×readMult + cachedWrite×input×writeMult + completion×output
- *   savings = cachedRead×input×(1 − readMult)  ← 読取割引の価値(書込プレミアムは savings に含めない)
- * 未知モデルは {0, 0}。
+ *   savings = cachedRead×input×(1 − readMult)  ← value of the read discount (the write premium is not included in savings)
+ * Unknown models return {0, 0}.
  */
 export declare function calculateCostWithCache(provider: Provider, model: string, promptTokens: number, completionTokens: number, cachedReadTokens: number, cachedWriteTokens: number): {
     costUsd: number;

package/dist/pricing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIzD;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAyFlE,CAAC;AAoBF;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAGR;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,GACxB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CA2B9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIxD;AAYD,qFAAqF;AACrF,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIzD;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAyFlE,CAAC;AAsBF;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAGR;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,GACxB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CA2B9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIxD;AAYD,qFAAqF;AACrF,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/pricing.js

@@ -12,7 +12,7 @@ const warnedUnknownModels = new Set();
 export const PRICING = {
     openai: {
         "gpt-5.5": { inputPer1M: 5.0, outputPer1M: 30.0 },
-        // xAI Grok(OpenAI 互換 API 経由 = provider は openai として届く)
+        // xAI Grok (arrives with provider "openai" because it is called via the OpenAI-compatible API)
         "grok-4.5": { inputPer1M: 2.0, outputPer1M: 6.0 },
         "gpt-5.4": { inputPer1M: 2.5, outputPer1M: 15.0 },
         "gpt-5.4-mini": { inputPer1M: 0.75, outputPer1M: 4.5 },
@@ -57,19 +57,19 @@ export const PRICING = {
         "claude-3-haiku": { inputPer1M: 0.25, outputPer1M: 1.25 },
     },
     gemini: {
-        // Gemini 3 series (= 2026-05-19 GA、 ai.google.dev/pricing 確認済)
+        // Gemini 3 series (GA 2026-05-19; verified against ai.google.dev/pricing)
         "gemini-3.5-flash": { inputPer1M: 1.5, outputPer1M: 9.0 },
-        // 3.1-pro は context size tier あり、 ≤200k 用 default を carry (preview ID は prefix match で解決)
+        // 3.1-pro has context-size pricing tiers; we use the ≤200k default (preview IDs resolve via prefix match)
         "gemini-3.1-pro": { inputPer1M: 2.0, outputPer1M: 12.0 },
         "gemini-3-flash": { inputPer1M: 0.5, outputPer1M: 3.0 },
-        // Gemini 2.5 series (= 訂正、 2026-05 WebFetch で 公式 page 確認)
-        // 2.5-pro は context size tier あり、 ≤200k 用 default を carry (= 我々は size を tracking していない)
+        // Gemini 2.5 series (corrected 2026-05 against the official pricing page)
+        // 2.5-pro has context-size pricing tiers; we use the ≤200k default (we do not track context size)
         "gemini-2.5-pro": { inputPer1M: 1.25, outputPer1M: 10.0 },
         "gemini-2.5-flash": { inputPer1M: 0.3, outputPer1M: 2.5 },
         // Gemini 2 series
         "gemini-2.0-flash": { inputPer1M: 0.1, outputPer1M: 0.4 },
         "gemini-2.0-pro": { inputPer1M: 1.25, outputPer1M: 5.0 },
-        // Gemini 1.5 series (= legacy carry)
+        // Gemini 1.5 series (kept for legacy records)
         "gemini-1.5-pro": { inputPer1M: 1.25, outputPer1M: 5.0 },
         "gemini-1.5-flash": { inputPer1M: 0.075, outputPer1M: 0.3 },
     },
@@ -100,15 +100,17 @@ export const PRICING = {
     },
 };
 /**
- * プロバイダ別のプロンプトキャッシュ単価倍率(input 単価に対する比率)。
- *   read  = キャッシュ読取(割引)/ write = キャッシュ書込(プレミアム、 Anthropic のみ)
- * 公式 2026-06-27 verify(各 provider 公式 pricing):
- *   - OpenAI 自動キャッシュ = 読取 input の 50%、 書込課金なし
- *   - Anthropic 明示キャッシュ = 読取 10% / 書込 125%(5 分 TTL 既定)。
- *     ⚠ 1 時間 TTL の書込は 200% だが、 token 内訳列を持たないため既定の 5 分 = 125% で計上
- *     (= 1h キャッシュ利用時のみ書込コストを軽め計上。 詳細は pricing-update-runbook.md)
- *   - Gemini context cache = 読取 10%(2026-06 に 25%→10% へ改定、 公式 verify 済)
- *   - Mistral = キャッシュ課金なし
+ * Per-provider prompt-cache price multipliers (as a ratio of the input rate).
+ *   read  = cache read (discounted) / write = cache write (premium, Anthropic only)
+ * Verified 2026-06-27 against each provider's official pricing:
+ *   - OpenAI automatic caching: reads at 50% of input; no write charge
+ *   - Anthropic explicit caching: reads at 10% / writes at 125% (5-minute TTL
+ *     default). Note: 1-hour-TTL writes cost 200%, but we lack a token
+ *     breakdown column, so we bill at the default 5-minute rate of 125%
+ *     (write cost is slightly underestimated only when the 1h cache is used).
+ *   - Gemini context cache: reads at 10% (revised from 25% to 10% in 2026-06,
+ *     officially verified)
+ *   - Mistral: no cache pricing
  */
 const CACHE_MULTIPLIERS = {
     openai: { read: 0.5, write: 1.0 },
@@ -127,13 +129,13 @@ export function calculateCost(provider, model, promptTokens, completionTokens) {
         .costUsd;
 }
 /**
- * キャッシュトークンを考慮した USD コスト + キャッシュ削減額。
+ * USD cost accounting for cache tokens, plus the cache savings amount.
  *
- * promptTokens は「キャッシュ読取 + 書込を含む input 合計」。 内訳:
- *   uncached = promptTokens − cachedReadTokens − cachedWriteTokens(下限 0)
+ * promptTokens is the total input including cache reads and writes. Breakdown:
+ *   uncached = promptTokens − cachedReadTokens − cachedWriteTokens (floored at 0)
  *   cost = uncached×input + cachedRead×input×readMult + cachedWrite×input×writeMult + completion×output
- *   savings = cachedRead×input×(1 − readMult)  ← 読取割引の価値(書込プレミアムは savings に含めない)
- * 未知モデルは {0, 0}。
+ *   savings = cachedRead×input×(1 − readMult)  ← value of the read discount (the write premium is not included in savings)
+ * Unknown models return {0, 0}.
  */
 export function calculateCostWithCache(provider, model, promptTokens, completionTokens, cachedReadTokens, cachedWriteTokens) {
     const providerPricing = PRICING[provider];
@@ -180,8 +182,8 @@ function warnOnceUnknown(key, message) {
         return;
     warnedUnknownModels.add(key);
     // eslint-disable-next-line no-console
-    console.warn(`[argosvix] ${message} — pricing returned 0. Update PRICING table in @argosvix/sdk` +
-        ` (see https://github.com/argosvix/Argosvix/blob/main/docs/handoff/pricing-update-runbook.md).`);
+    console.warn(`[argosvix] ${message} — pricing returned 0. Cost for this model will not be tracked` +
+        ` until the SDK's pricing table is updated. Check for a newer @argosvix/sdk release.`);
 }
 /** Test-only helper: reset the warn-once state. Do not call from production code. */
 export function __resetPricingWarnings() {

package/dist/pricing.js.map

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

package/dist/prompts.d.ts

@@ -1,45 +1,48 @@
 /**
- * 2026-07-02 #4 = デプロイ済みプロンプトの SDK 解決。
+ * SDK-side resolution of deployed prompts.
  *
- * backend GET /v1/prompts/resolve?name=&label= (Free OK) を叩き、(name, label) の
- * 現行版を返す。withPrompt() と組み合わせると、そのプロンプトで生成した LLM 呼び出しに
- * `prompt` タグ({name}@v{version})が自動付与され、版別の品質/コスト比較が成立する。
+ * Calls the backend GET /v1/prompts/resolve?name=&label= (available on the
+ * Free plan) and returns the current version for (name, label). Combined with
+ * withPrompt(), LLM calls made with that prompt automatically get a `prompt`
+ * tag ({name}@v{version}), enabling per-version quality/cost comparison.
  *
  *   const p = await resolvePrompt("support-bot", { apiKey: process.env.ARGOSVIX_API_KEY! });
  *   await withPrompt(p, async () => {
  *     await client.chat.completions.create({ ... p.template ... });
  *   });
  *
- * 設計:
- *   - TTL キャッシュ(既定 60 秒)= 呼び出し毎の resolve fetch を避ける(本番 hot path)。
- *   - fetch 失敗時は「期限切れでもキャッシュがあればそれを返す」stale フォールバック
- *     (プロンプト取得の一時障害でアプリの本流を止めない)。キャッシュも無ければ throw。
+ * Design:
+ *   - TTL cache (default 60 seconds) avoids a resolve fetch on every call
+ *     (production hot path).
+ *   - On fetch failure, a stale fallback returns the cached value even if it
+ *     has expired (a transient prompt-fetch outage must not stop the app's
+ *     main flow). If there is no cache either, it throws.
  */
 export interface ResolvePromptOptions {
-    /** Argosvix API キー(argk_...)。 */
+    /** Argosvix API key (argk_...). */
     apiKey: string;
-    /** デプロイ環境ラベル。既定 "production"。 */
+    /** Deployment environment label. Defaults to "production". */
     label?: string;
-    /** backend endpoint。既定 https://ingest.argosvix.com。 */
+    /** Backend endpoint. Defaults to https://ingest.argosvix.com. */
     endpoint?: string;
-    /** キャッシュ TTL(ms)。0 で無効。既定 60000。 */
+    /** Cache TTL in ms. 0 disables caching. Defaults to 60000. */
     cacheTtlMs?: number;
     signal?: AbortSignal;
 }
 export interface ResolvedPrompt {
-    /** prompt_registry の版 ID。 */
+    /** Version ID in the prompt registry. */
     id: string;
     name: string;
     version: number;
-    /** プロンプト本文(テンプレート)。 */
+    /** Prompt body (template). */
     template: string;
-    /** {{var}} 変数名の一覧(登録時に指定があれば)。 */
+    /** List of {{var}} variable names (if specified at registration). */
     variables: string[] | null;
     label: string;
-    /** withPrompt / tags.prompt に使うタグ値({name}@v{version})。 */
+    /** Tag value used by withPrompt / tags.prompt ({name}@v{version}). */
     tag: string;
 }
-/** test-only = キャッシュを空にする。 */
+/** Test-only: clears the cache. */
 export declare function _clearPromptCache(): void;
 export declare function resolvePrompt(name: string, options: ResolvePromptOptions): Promise<ResolvedPrompt>;
 //# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;CACb;AASD,8BAA8B;AAC9B,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAsEzB"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;CACb;AASD,mCAAmC;AACnC,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAuEzB"}

package/dist/prompts.js

@@ -1,25 +1,28 @@
 /**
- * 2026-07-02 #4 = デプロイ済みプロンプトの SDK 解決。
+ * SDK-side resolution of deployed prompts.
  *
- * backend GET /v1/prompts/resolve?name=&label= (Free OK) を叩き、(name, label) の
- * 現行版を返す。withPrompt() と組み合わせると、そのプロンプトで生成した LLM 呼び出しに
- * `prompt` タグ({name}@v{version})が自動付与され、版別の品質/コスト比較が成立する。
+ * Calls the backend GET /v1/prompts/resolve?name=&label= (available on the
+ * Free plan) and returns the current version for (name, label). Combined with
+ * withPrompt(), LLM calls made with that prompt automatically get a `prompt`
+ * tag ({name}@v{version}), enabling per-version quality/cost comparison.
  *
  *   const p = await resolvePrompt("support-bot", { apiKey: process.env.ARGOSVIX_API_KEY! });
  *   await withPrompt(p, async () => {
  *     await client.chat.completions.create({ ... p.template ... });
  *   });
  *
- * 設計:
- *   - TTL キャッシュ(既定 60 秒)= 呼び出し毎の resolve fetch を避ける(本番 hot path)。
- *   - fetch 失敗時は「期限切れでもキャッシュがあればそれを返す」stale フォールバック
- *     (プロンプト取得の一時障害でアプリの本流を止めない)。キャッシュも無ければ throw。
+ * Design:
+ *   - TTL cache (default 60 seconds) avoids a resolve fetch on every call
+ *     (production hot path).
+ *   - On fetch failure, a stale fallback returns the cached value even if it
+ *     has expired (a transient prompt-fetch outage must not stop the app's
+ *     main flow). If there is no cache either, it throws.
  */
 const DEFAULT_ENDPOINT = "https://ingest.argosvix.com";
 const DEFAULT_LABEL = "production";
 const DEFAULT_TTL_MS = 60_000;
 const cache = new Map();
-/** test-only = キャッシュを空にする。 */
+/** Test-only: clears the cache. */
 export function _clearPromptCache() {
     cache.clear();
 }
@@ -27,17 +30,18 @@ export async function resolvePrompt(name, options) {
     const endpoint = options.endpoint ?? DEFAULT_ENDPOINT;
     const label = options.label ?? DEFAULT_LABEL;
     const ttl = options.cacheTtlMs ?? DEFAULT_TTL_MS;
-    // キャッシュキーに apiKey を含める: 同一プロセスで複数アカウントのキーを使う構成で、
-    // 別アカウントのキャッシュ済みプロンプトを掴む cross-account 汚染を防ぐ
-    // (observation sink の cross-account ガードと同じ判断)。in-memory のみで永続化しない。
+    // Include the apiKey in the cache key: in setups where a single process uses
+    // keys for multiple accounts, this prevents cross-account contamination where
+    // one account picks up another account's cached prompt (same reasoning as the
+    // observation sink's cross-account guard). In-memory only; never persisted.
     const key = `${options.apiKey}|${endpoint}|${name}|${label}`;
     const hit = cache.get(key);
     if (hit && hit.expiresAt > Date.now())
         return hit.value;
     let res;
-    // 既定 10 秒 timeout(Python SDK と対称)。resolve が hang するとアプリの
-    // 本流(プロンプトを引いてから LLM を呼ぶ経路)を塞ぐため、上限を必ず切る。
-    // 呼び出し側の signal 指定があればそちらを優先。
+    // Default 10-second timeout (mirroring the Python SDK). A hanging resolve
+    // would block the app's main flow (fetch the prompt, then call the LLM), so
+    // always enforce an upper bound. A caller-provided signal takes precedence.
     const ctrl = options.signal ? null : new AbortController();
     const timer = ctrl ? setTimeout(() => ctrl.abort(), 10_000) : null;
     try {
@@ -50,7 +54,7 @@ export async function resolvePrompt(name, options) {
     }
     catch (err) {
         if (hit)
-            return hit.value; // ネットワーク断/timeout = stale フォールバック
+            return hit.value; // network failure / timeout = stale fallback
         throw err;
     }
     finally {
@@ -59,7 +63,7 @@ export async function resolvePrompt(name, options) {
     }
     if (!res.ok) {
         if (hit && res.status >= 500)
-            return hit.value; // サーバー障害のみ stale 許容
+            return hit.value; // stale allowed only for server failures
         const body = (await res.json().catch(() => ({})));
         throw new Error(`resolvePrompt(${name}, ${label}) failed (${res.status}): ${body.error ?? ""}`);
     }

package/dist/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;AACvD,MAAM,aAAa,GAAG,YAAY,CAAC;AACnC,MAAM,cAAc,GAAG,MAAM,CAAC;AAiC9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE5C,mCAAmC;AACnC,MAAM,UAAU,iBAAiB;IAC/B,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,OAA6B;IAE7B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,cAAc,CAAC;IACjD,6EAA6E;IAC7E,8EAA8E;IAC9E,8EAA8E;IAC9E,4EAA4E;IAC5E,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;IAE7D,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC;IAExD,IAAI,GAAa,CAAC;IAClB,0EAA0E;IAC1E,4EAA4E;IAC5E,4EAA4E;IAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,IAAI,CAAC;QACH,MAAM,GAAG,GACP,GAAG,QAAQ,4BAA4B,kBAAkB,CAAC,IAAI,CAAC,EAAE;YACjE,UAAU,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YACrB,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,MAAM,EAAE,EAAE;YACtD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAK,CAAC,MAAM;SACvC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,6CAA6C;QACxE,MAAM,GAAG,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,yCAAyC;QACzF,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAuB,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,KAAK,KAAK,aAAa,GAAG,CAAC,MAAM,MAAM,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAC/E,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CASxC,CAAC;IACT,MAAM,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC;IACvB,IACE,CAAC,CAAC;QACF,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,EAC9B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,KAAK,GAAmB;QAC5B,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,SAAsB,CAAC,CAAC,CAAC,IAAI;QACxE,KAAK;QACL,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE;KAC/B,CAAC;IACF,IAAI,GAAG,GAAG,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC"}