@argosvix/sdk 0.4.22-alpha.0 → 0.5.0

package/dist/approvals.js

@@ -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}`);
@@ -83,7 +88,7 @@ async function callApi(opts, path, init = {}) {
     }
     return body;
 }
-/** 承認依頼を作成する。 account owner へ email 通知が飛ぶ。 */
+/** Create an approval request. Sends an email notification to the account owner. */
 export async function requestApproval(params) {
     const body = {
         action: params.action,
@@ -102,7 +107,7 @@ export async function requestApproval(params) {
     }
     return res.approval;
 }
-/** 承認依頼の現在状態を 1 回取得する。 */
+/** Fetch the current state of an approval request once. */
 export async function getApproval(params) {
     const res = (await callApi(params, `/v1/gate/approvals/${encodeURIComponent(params.id)}`));
     if (!res || !res.approval) {
@@ -111,8 +116,9 @@ export async function getApproval(params) {
     return res.approval;
 }
 /**
- * 承認 / 否認 / 期限切れまで 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 async function waitForApproval(params) {
     const baseInterval = Math.max(MIN_POLL_INTERVAL_MS, params.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
@@ -124,7 +130,7 @@ export async function waitForApproval(params) {
             status = approval.status;
         }
         catch (err) {
-            // 一時的な network / 429 は次の poll で再試行 (= 4xx の恒久 error は throw)
+            // Transient network errors / 429 are retried on the next poll; permanent 4xx errors are thrown.
             if (err instanceof ArgosvixApprovalError &&
                 err.status !== null &&
                 err.status !== 429 &&
@@ -136,7 +142,7 @@ export async function waitForApproval(params) {
             return status;
         if (Date.now() >= deadline)
             return "expired";
-        // jitter (= 0-20%) で複数 agent の poll が同期して rate limit に張り付くのを防ぐ
+        // Jitter (0-20%) prevents multiple agents' polls from synchronizing and pinning the rate limit.
         const jitter = baseInterval * 0.2 * Math.random();
         await new Promise((resolve) => setTimeout(resolve, baseInterval + jitter));
     }

package/dist/approvals.js.map

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

package/dist/budgetGate.d.ts

@@ -1,8 +1,9 @@
 import type { ArgosvixConfig } from "./types.js";
 /**
- * model 名の canonical form (= R72b MEDIUM 3)。 Gemini 系 SDK が保持する
- * "models/gemini-pro" の provider prefix を除去し、 allowlist 比較を
- * TS / Python 両 SDK で同一にする。 export = test + Python 側と並走 verify 用。
+ * Canonical form of a model name. Strips the "models/" provider prefix that
+ * Gemini-family SDKs keep (e.g. "models/gemini-pro") so allowlist comparison
+ * behaves identically in the TypeScript and Python SDKs. Exported for tests
+ * and for cross-verification against the Python implementation.
  */
 export declare function canonicalizeModelName(model: string): string;
 export declare class ArgosvixBudgetExceededError extends Error {
@@ -19,13 +20,13 @@ export declare class ArgosvixPolicyViolationError extends Error {
     readonly detail: string;
     constructor(reason: PolicyViolationReason, detail: string);
 }
-/** wrapper が check() に渡す呼び出し文脈。 */
+/** Call context the wrapper passes to check(). */
 export interface GateCheckContext {
-    /** request の model 名 (= 取れない経路では payload から補完)。 */
+    /** Model name of the request (backfilled from the payload on paths where it is not directly available). */
     model?: string | undefined;
-    /** provider に渡す request payload (= policy の PII / secret 検査対象)。 */
+    /** Request payload sent to the provider (subject to the policy gate's PII / secret scan). */
     payload?: unknown;
-    /** 監査 Tier 2 = この呼び出しの実効 tags(= tag gate の該当判定に使う)。 */
+    /** Effective tags of this call (used to decide which tag gates apply). */
     tags?: Record<string, string> | undefined;
 }
 export declare class RuntimeGate {
@@ -36,43 +37,48 @@ export declare class RuntimeGate {
     private lastAttemptFailed;
     private warnedEndpoint;
     private warnedNoPolicy;
-    /** 直近の成功 fetch 以降にこのプロセスが record した消費の補正値。 */
+    /** Spend recorded by this process since the last successful fetch (local compensation). */
     private localSpendUsd;
-    /** 監査 Tier 2 = tag 別のローカル消費補正(key = JSON([tagKey,tagValue]))。 */
+    /** Per-tag local spend compensation (key = JSON([tagKey,tagValue])). */
     private tagLocalSpend;
     constructor(config: ArgosvixConfig);
-    /** monotonic clock。wall clock の逆行 (NTP step / VM resume) に影響されない。 */
+    /** Monotonic clock; unaffected by wall-clock regressions (NTP step / VM resume). */
     private now;
     /**
-     * gate が実際に enforce され得るか(= 完全互換 wrap の identity fast path 判定用)。
-     * false なら check() は即 return するため、呼び出し前の await を省略して
-     * 元の APIPromise をそのまま返せる。
+     * Whether the gate can actually enforce anything (used by the fully
+     * compatible wrap to decide its identity fast path). When false, check()
+     * returns immediately, so the pre-call await can be skipped and the original
+     * APIPromise returned as-is.
      */
     get isActive(): boolean;
-    /** opt-in + 送信可能な構成のときだけ動く。それ以外は完全 no-op。 */
+    /** Active only when opted in and configured for sending; otherwise a complete no-op. */
     private get active();
     /**
-     * recorder.record() から呼ばれる。TTL 窓内のローカル消費補正。
-     * tag gate は config.tags を判定基準にする(= この client の全 call が config.tags を
-     * 持つため、 該当 tag gate には project gate と同様に全 call が加算される)。
+     * Called from recorder.record(). Local spend compensation within the TTL
+     * window. Tag gates are matched against config.tags: every call made by
+     * this client carries config.tags, so all calls accrue to the matching tag
+     * gates, just like the project gate.
      */
     noteSpend(costUsd: number): void;
     /**
-     * LLM 呼び出し直前の enforce。超過なら throw、それ以外は素通し。
-     * backend 障害は enforce mode に従って fail-open / fail-closed。
+     * Enforcement right before the LLM call. Throws when the limit is exceeded,
+     * passes through otherwise. Backend outages fail open or fail closed
+     * according to the enforce mode.
      */
     check(ctx?: GateCheckContext): Promise<void>;
     private evaluate;
-    /** ポリシーゲートのローカル評価 (= モデル allowlist / PII / secret)。 */
+    /** Local evaluation of the policy gate (model allowlist / PII / secrets). */
     private evaluatePolicy;
     private isStale;
-    /** 直近 fetch が失敗していた場合、FAILURE_RETRY_MS 経過まで再試行しない。 */
+    /** If the last fetch failed, do not retry until FAILURE_RETRY_MS has elapsed. */
     private attemptAllowed;
     private refresh;
     /**
-     * gate endpoint の決定。 ingest endpoint を override している場合は同 prefix
-     * から導出し、 導出できない形 (= /v1/ingest で終わらない custom URL) なら
-     * gate を無効化する (= 他環境向け Bearer key を production に送らない、R65b M-2)。
+     * Resolves the gate endpoint. When the ingest endpoint is overridden, the
+     * gate endpoint is derived from the same prefix; if it cannot be derived
+     * (a custom URL not ending in /v1/ingest), the gate is disabled instead.
+     * This avoids sending a Bearer key meant for another environment to
+     * production.
      */
     private gateEndpoint;
     private fetchOnce;

package/dist/budgetGate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"budgetGate.d.ts","sourceRoot":"","sources":["../src/budgetGate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgDjD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAQ/C;AAED,qBAAa,kCAAmC,SAAQ,KAAK;;CAO5D;AAED,MAAM,MAAM,qBAAqB,GAC7B,mBAAmB,GACnB,cAAc,GACd,iBAAiB,CAAC;AAEtB,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM;CAM1D;AAuCD,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC3C;AAOD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAS;IAC/B,8CAA8C;IAC9C,OAAO,CAAC,aAAa,CAAK;IAC1B,iEAAiE;IACjE,OAAO,CAAC,aAAa,CAA6B;gBAEtC,MAAM,EAAE,cAAc;IAIlC,qEAAqE;IACrE,OAAO,CAAC,GAAG;IAIX;;;;OAIG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,6CAA6C;IAC7C,OAAO,KAAK,MAAM,GAOjB;IAED;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAehC;;;OAGG;IACG,KAAK,CAAC,GAAG,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BtD,OAAO,CAAC,QAAQ;IAwEhB,uDAAuD;IACvD,OAAO,CAAC,cAAc;IA4CtB,OAAO,CAAC,OAAO;IAKf,sDAAsD;IACtD,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,OAAO;IAUf;;;;OAIG;IACH,OAAO,CAAC,YAAY;YAmBN,SAAS;CA8LxB;AAGD,OAAO,EAAE,WAAW,IAAI,UAAU,EAAE,CAAC"}
+{"version":3,"file":"budgetGate.d.ts","sourceRoot":"","sources":["../src/budgetGate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuDjD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAQ/C;AAED,qBAAa,kCAAmC,SAAQ,KAAK;;CAO5D;AAED,MAAM,MAAM,qBAAqB,GAC7B,mBAAmB,GACnB,cAAc,GACd,iBAAiB,CAAC;AAEtB,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM;CAM1D;AAyCD,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,2GAA2G;IAC3G,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC3C;AAOD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAS;IAC/B,2FAA2F;IAC3F,OAAO,CAAC,aAAa,CAAK;IAC1B,wEAAwE;IACxE,OAAO,CAAC,aAAa,CAA6B;gBAEtC,MAAM,EAAE,cAAc;IAIlC,oFAAoF;IACpF,OAAO,CAAC,GAAG;IAIX;;;;;OAKG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,wFAAwF;IACxF,OAAO,KAAK,MAAM,GAOjB;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAehC;;;;OAIG;IACG,KAAK,CAAC,GAAG,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BtD,OAAO,CAAC,QAAQ;IA4EhB,6EAA6E;IAC7E,OAAO,CAAC,cAAc;IAgDtB,OAAO,CAAC,OAAO;IAKf,iFAAiF;IACjF,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,OAAO;IAUf;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;YAmBN,SAAS;CAmMxB;AAGD,OAAO,EAAE,WAAW,IAAI,UAAU,EAAE,CAAC"}