@argosvix/sdk 0.4.22-alpha.0 → 0.5.0

package/dist/query.d.ts

@@ -1,13 +1,13 @@
 /**
- * Argosvix Query API client(= 呼び出し履歴と集計を取得する helper)。
+ * Argosvix Query API client (helper for fetching call history and aggregates).
  *
- * 公開している endpoint:
- *   - POST /v1/query/calls     呼び出し履歴(filter + 最大 200 件)
- *   - POST /v1/query/aggregate provider / model / day で 集計
+ * Exposed endpoints:
+ *   - POST /v1/query/calls     call history (filter + up to 200 records)
+ *   - POST /v1/query/aggregate aggregation by provider / model / day
  *
- * 認証 = Bearer API key(dashboard /verify で 1 回だけ表示される key)。
+ * Auth: Bearer API key (the key shown exactly once at dashboard /verify).
  *
- * 使用例:
+ * Usage:
  *   import { queryCalls, queryAggregate } from "@argosvix/sdk";
  *
  *   const { records } = await queryCalls({
@@ -20,19 +20,19 @@
  *     filter: { groupBy: "day", metric: "cost" },
  *   });
  *
- * fetch は Node 18+ / Workers / browser で標準利用可能。 endpoint を 変えたい場合
- * (= self-hosted / staging) は `endpoint` を carry。
+ * fetch is natively available on Node 18+ / Workers / browsers. To target a
+ * different endpoint (self-hosted / staging), pass `endpoint`.
  */
 import type { Provider } from "./types.js";
 export interface QueryCallsFilter {
-    /** ISO 8601 UTC timestamp(inclusive)*/
+    /** ISO 8601 UTC timestamp (inclusive) */
     startTime?: string;
-    /** ISO 8601 UTC timestamp(inclusive)*/
+    /** ISO 8601 UTC timestamp (inclusive) */
     endTime?: string;
     provider?: Provider;
-    /** model 名 完全一致(1-128 chars)*/
+    /** Exact model name match (1-128 chars) */
     model?: string;
-    /** 1-200(default 50)*/
+    /** 1-200 (default 50) */
     limit?: number;
 }
 export interface CallRecord {
@@ -57,7 +57,7 @@ export interface QueryCallsOptions {
     /** default = https://ingest.argosvix.com */
     endpoint?: string;
     filter?: QueryCallsFilter;
-    /** abort controller signal を 渡したい場合 */
+    /** Optional AbortController signal */
     signal?: AbortSignal;
 }
 export interface QueryCallsResponse {
@@ -75,7 +75,7 @@ export interface QueryAggregateFilter {
     metric?: AggregateMetric;
 }
 export interface AggregateGroup {
-    /** provider 名 / model 名 / 日付 (YYYY-MM-DD) */
+    /** Provider name / model name / date (YYYY-MM-DD) */
     key: string;
     value: number;
     count: number;
@@ -94,19 +94,19 @@ export interface QueryAggregateResponse {
     };
 }
 /**
- * Argosvix backend が JSON で 返す { error: string } を Error として throw する
- * 簡易 helper。 非 200 status は すべて Error 扱い。
+ * Small helper that throws the { error: string } JSON returned by the Argosvix
+ * backend as an Error. Every non-200 status is treated as an Error.
  */
 export declare class ArgosvixQueryError extends Error {
     readonly status: number;
     constructor(status: number, message: string);
 }
 /**
- * 呼び出し履歴を 取得。
+ * Fetch call history.
  */
 export declare function queryCalls(options: QueryCallsOptions): Promise<QueryCallsResponse>;
 /**
- * 呼び出しの集計を 取得。
+ * Fetch call aggregates.
  */
 export declare function queryAggregate(options: QueryAggregateOptions): Promise<QueryAggregateResponse>;
 export type PercentileMetric = "latency" | "cost";
@@ -126,15 +126,15 @@ export interface QueryPercentilesOptions {
 }
 export interface QueryPercentilesResponse {
     metric: PercentileMetric;
-    /** 50 percentile(records なし時 null)*/
+    /** 50th percentile (null when there are no records) */
     p50: number | null;
     p95: number | null;
     p99: number | null;
     count: number;
 }
 /**
- * latency_ms / cost_usd の percentile (p50/p95/p99) を 取得。
- * avg では見えない外れ値の分布を 把握する debug 用途。
+ * Fetch percentiles (p50/p95/p99) for latency_ms / cost_usd.
+ * A debugging aid for understanding outlier distributions that averages hide.
  */
 export declare function queryPercentiles(options: QueryPercentilesOptions): Promise<QueryPercentilesResponse>;
 //# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

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

package/dist/query.js

@@ -1,13 +1,13 @@
 /**
- * Argosvix Query API client(= 呼び出し履歴と集計を取得する helper)。
+ * Argosvix Query API client (helper for fetching call history and aggregates).
  *
- * 公開している endpoint:
- *   - POST /v1/query/calls     呼び出し履歴(filter + 最大 200 件)
- *   - POST /v1/query/aggregate provider / model / day で 集計
+ * Exposed endpoints:
+ *   - POST /v1/query/calls     call history (filter + up to 200 records)
+ *   - POST /v1/query/aggregate aggregation by provider / model / day
  *
- * 認証 = Bearer API key(dashboard /verify で 1 回だけ表示される key)。
+ * Auth: Bearer API key (the key shown exactly once at dashboard /verify).
  *
- * 使用例:
+ * Usage:
  *   import { queryCalls, queryAggregate } from "@argosvix/sdk";
  *
  *   const { records } = await queryCalls({
@@ -20,13 +20,13 @@
  *     filter: { groupBy: "day", metric: "cost" },
  *   });
  *
- * fetch は Node 18+ / Workers / browser で標準利用可能。 endpoint を 変えたい場合
- * (= self-hosted / staging) は `endpoint` を carry。
+ * fetch is natively available on Node 18+ / Workers / browsers. To target a
+ * different endpoint (self-hosted / staging), pass `endpoint`.
  */
 const DEFAULT_ENDPOINT = "https://ingest.argosvix.com";
 /**
- * Argosvix backend が JSON で 返す { error: string } を Error として throw する
- * 簡易 helper。 非 200 status は すべて Error 扱い。
+ * Small helper that throws the { error: string } JSON returned by the Argosvix
+ * backend as an Error. Every non-200 status is treated as an Error.
  */
 export class ArgosvixQueryError extends Error {
     status;
@@ -63,22 +63,22 @@ async function postJson(url, apiKey, body, signal) {
     return (await res.json());
 }
 /**
- * 呼び出し履歴を 取得。
+ * Fetch call history.
  */
 export async function queryCalls(options) {
     const endpoint = options.endpoint ?? DEFAULT_ENDPOINT;
     return postJson(`${endpoint}/v1/query/calls`, options.apiKey, options.filter ?? {}, options.signal);
 }
 /**
- * 呼び出しの集計を 取得。
+ * Fetch call aggregates.
  */
 export async function queryAggregate(options) {
     const endpoint = options.endpoint ?? DEFAULT_ENDPOINT;
     return postJson(`${endpoint}/v1/query/aggregate`, options.apiKey, options.filter ?? {}, options.signal);
 }
 /**
- * latency_ms / cost_usd の percentile (p50/p95/p99) を 取得。
- * avg では見えない外れ値の分布を 把握する debug 用途。
+ * Fetch percentiles (p50/p95/p99) for latency_ms / cost_usd.
+ * A debugging aid for understanding outlier distributions that averages hide.
  */
 export async function queryPercentiles(options) {
     const endpoint = options.endpoint ?? DEFAULT_ENDPOINT;

package/dist/recorder.d.ts

@@ -1,5 +1,22 @@
 import type { ArgosvixConfig, LlmCallRecord, ObservationRecord } from "./types.js";
 import { BudgetGate } from "./budgetGate.js";
+/**
+ * Plaintext body limit for backend ingest (same value as
+ * MAX_PLAINTEXT_BODY_BYTES = 64 * 1024 in the backend's ingest handler). The
+ * backend checks `promptBody.length` (UTF-16 code unit count), so the SDK
+ * counts in the same unit (not UTF-8 bytes — the name says BYTES but the
+ * actual check is in code units).
+ */
+export declare const INGEST_MAX_BODY_UNITS: number;
+/** Marker in the same format as the streaming capture (client.ts STREAM_TRUNCATED_MARKER). */
+export declare const BODY_TRUNCATED_MARKER = "\u2026[truncated]";
+/**
+ * Truncate a body before sending. The backend rejects an over-limit record
+ * wholesale, so records with 64KB-256KB bodies used to disappear silently.
+ * Fit within the limit including the marker, and never split a surrogate pair
+ * at the cut point (do not send a broken lone surrogate).
+ */
+export declare function truncateBodyForIngest(text: string): string;
 /**
  * Per-wrap() instance-based recorder.
  * Avoids module-level global state to keep test isolation clean and to let
@@ -20,31 +37,34 @@ export declare class Recorder {
      */
     private inFlightFlush;
     /**
-     * Periodic flush の one-shot timer(buffer が空→非空になった契機で 1 本だけ張る)。
-     * permanent setInterval は GC 阻害 + unref 忘れで Node プロセスを生かし続けるため避ける。
-     * flush 開始時に clear、host が短命 runtime(Workers/Edge)なら timer 配送は保証されない
-     * ので従来どおり flushClient() 明示が必須(docs)。
+     * One-shot timer for periodic flushes (armed only when the buffer goes from
+     * empty to non-empty). A permanent setInterval is avoided because it blocks
+     * GC and a forgotten unref keeps the Node process alive. Cleared when a
+     * flush starts. On short-lived host runtimes (Workers/Edge) timer delivery
+     * is not guaranteed, so an explicit flushClient() remains required, as documented.
      */
     private idleFlushTimer;
     /**
-     * Runtime 予算ゲート (= config.budgetGate opt-in 時のみ実動作、それ以外は
-     * 完全 no-op)。 wrapper が LLM 呼び出し前に check() を await する。
+     * Runtime budget gate (active only when config.budgetGate is opted in;
+     * otherwise a complete no-op). The wrapper awaits check() before each LLM call.
      */
     readonly budgetGate: BudgetGate;
     constructor(config?: ArgosvixConfig);
     /**
-     * buffer に record が入っている間、flushIntervalMs 後に 1 回だけ flush を予約する。
-     * 既に予約済み / disabled / apiKey 無 / interval 0 なら何もしない。
+     * While records sit in the buffer, schedule exactly one flush after
+     * flushIntervalMs. Does nothing if already scheduled, disabled, without an
+     * apiKey, or with an interval of 0.
      */
     private scheduleIdleFlush;
-    /** #1 R4 = ObservationSink: この recorder が observation を送れるか(disabled / apiKey 無は不可)。 */
+    /** ObservationSink: whether this recorder can send observations (not when disabled or without an apiKey). */
     get observationsEnabled(): boolean;
-    /** #1 R4 = ObservationSink: cross-account 送信防止のための routing キー(= api_key)。 */
+    /** ObservationSink: routing key (the api_key) used to prevent cross-account sends. */
     get observationsRoutingKey(): string | undefined;
     record(record: LlmCallRecord): void;
-    /** #1 R4 = observation(withSpan が emit する typed ノード)をバッファに積む。
-     * error は例外メッセージの自動収集で prompt 断片 / PII / secret を含みうるため、
-     * records と同じく redaction(opt-out 可)+ 長さ上限を通してから送る。 */
+    /** Buffer an observation (a typed node emitted by withSpan).
+     * The error field is auto-collected from exception messages and can contain
+     * prompt fragments / PII / secrets, so like records it goes through
+     * redaction (opt-out possible) plus a length cap before sending. */
     recordObservation(obs: ObservationRecord): void;
     /**
      * Flush the buffer to the backend with retry.
@@ -61,12 +81,12 @@ export declare class Recorder {
     flush(): Promise<LlmCallRecord[]>;
     private doFlush;
     /**
-     * captureContent と disablePiiRedaction の組み合わせに応じて、record の
-     * 平文フィールド(promptBody / completionBody / toolCalls)を加工する。
+     * Process the record's plaintext fields (promptBody / completionBody /
+     * toolCalls) according to the captureContent / disablePiiRedaction combination:
      *
-     *   captureContent = false (default) → 全平文フィールドを削除
-     *   captureContent = true, disablePiiRedaction = false (default) → redaction 適用
-     *   captureContent = true, disablePiiRedaction = true → 無加工で carry
+     *   captureContent = false (default) → remove all plaintext fields
+     *   captureContent = true, disablePiiRedaction = false (default) → apply redaction
+     *   captureContent = true, disablePiiRedaction = true → pass through unmodified
      */
     private sanitizeContent;
     getBufferSize(): number;
@@ -76,6 +96,6 @@ export declare class Recorder {
      */
     __resetForTesting(): void;
 }
-/** test-only = warn-once flag をリセットする。 */
+/** Test-only: resets the warn-once flag. */
 export declare function _resetQuotaWarn(): void;
 //# sourceMappingURL=recorder.d.ts.map

package/dist/recorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAW7C;;;;;;;GAOG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAuB;IAGrC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC;;;;;OAKG;IACH,OAAO,CAAC,aAAa,CAAyC;IAC9D;;;;;OAKG;IACH,OAAO,CAAC,cAAc,CAA8C;IACpE;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;gBAEpB,MAAM,GAAE,cAAmB;IAKvC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAoBzB,wFAAwF;IACxF,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED,6EAA6E;IAC7E,IAAI,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAE/C;IAED,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAkDnC;;0DAEsD;IACtD,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAkB/C;;;;;;;;;;;OAWG;IACG,KAAK,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YA8BzB,OAAO;IAkFrB;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IA6EvB,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,iBAAiB,IAAI,IAAI;CAI1B;AAcD,0CAA0C;AAC1C,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAW7C;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,QAAY,CAAC;AAC/C,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB,sBAAiB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED;;;;;;;GAOG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAuB;IAGrC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC;;;;;OAKG;IACH,OAAO,CAAC,aAAa,CAAyC;IAC9D;;;;;;OAMG;IACH,OAAO,CAAC,cAAc,CAA8C;IACpE;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;gBAEpB,MAAM,GAAE,cAAmB;IAKvC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAoBzB,6GAA6G;IAC7G,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED,sFAAsF;IACtF,IAAI,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAE/C;IAED,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAqDnC;;;wEAGoE;IACpE,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAkB/C;;;;;;;;;;;OAWG;IACG,KAAK,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YA8BzB,OAAO;IAmFrB;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IA8FvB,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,iBAAiB,IAAI,IAAI;CAI1B;AAcD,4CAA4C;AAC5C,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}