@agent-os-sdk/client 0.9.4 → 0.9.6

package/dist/modules/runs.d.ts

@@ -11,7 +11,8 @@ import type { PaginationParams, PaginatedResponse } from "../client/helpers.js";
 type WaitRunResponse = components["schemas"]["WaitRunResponse"];
 type BatchRunResponse = components["schemas"]["BatchRunResponse"];
 type CancelRunResponse = components["schemas"]["CancelRunResponse"];
-type CheckpointListResponse = components["schemas"]["CheckpointListResponse"];
+type CheckpointIndexResponse = components["schemas"]["CheckpointIndexResponse"];
+type RunReplayResponse = components["schemas"]["RunReplayResponse"];
 export interface Run {
     run_id: string;
     status: RunStatus;
@@ -187,25 +188,11 @@ export declare class RunsModule {
     /**
      * Replay from checkpoint (stateful).
      * Creates a NEW run that starts from the specified checkpoint.
-     *
-     * @param runId - The original run to replay from
-     * @param checkpointId - The checkpoint ID to start from
-     * @param options - Replay options
-     * @returns New run created from checkpoint
-     *
-     * @example
-     * ```ts
-     * const checkpoints = await client.runs.getCheckpoints(runId)
-     * const newRun = await client.runs.replay(runId, checkpoints[2].id, {
-     *   mode: 'best_effort',
-     *   reason: 'Debugging step 3'
-     * })
-     * ```
      */
-    replay(runId: string, checkpointId?: string, options?: {
+    replay(runId: string, checkpointId: string, options?: {
         mode?: "best_effort" | "strict";
         reason?: string;
-    }): Promise<APIResponse<CreateRunResponse>>;
+    }): Promise<APIResponse<RunReplayResponse>>;
     /**
      * Get canonical run events from SSOT ledger (polling by seq).
      */
@@ -250,12 +237,11 @@ export declare class RunsModule {
     /**
      * Get checkpoints for a run.
      */
-    getCheckpoints(runId: string): Promise<APIResponse<CheckpointListResponse>>;
+    getCheckpoints(runId: string): Promise<APIResponse<CheckpointIndexResponse>>;
     /** Alias: runs.checkpoints() -> runs.getCheckpoints() */
     checkpoints: (runId: string) => Promise<APIResponse<{
         run_id?: string;
-        total_checkpoints?: number;
-        checkpoints?: components["schemas"]["CheckpointNode"][] | null;
+        checkpoints?: components["schemas"]["CheckpointIndexItem"][] | null;
     }>>;
     /**
      * Follow a run attempt's canonical event stream with automatic reconnection.

package/dist/modules/runs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/modules/runs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIhF,KAAK,eAAe,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAChE,KAAK,gBAAgB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAClE,KAAK,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAC;AACpE,KAAK,sBAAsB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,wBAAwB,CAAC,CAAC;AAG9E,MAAM,WAAW,GAAG;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,WAAW,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC;CAC1C;AAGD,MAAM,MAAM,SAAS,GACf,SAAS,GACT,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,mBAAmB,GACnB,SAAS,CAAC;AAEhB,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAErD,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED,qBAAa,UAAU;IACP,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAIrC;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,IAAI,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG;YAAE,UAAU,EAAE,IAAI,CAAA;SAAE,CAAC;QACvD,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,qHAAqH;QACrH,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAa3C;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAMnD;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG;QACnC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAMzC;;;;;;;;;;;;;;;OAeG;IACI,OAAO,CACV,OAAO,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,EACD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACzE,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC;IAgCrC;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG;YAAE,UAAU,EAAE,IAAI,CAAA;SAAE,CAAC;QACvD,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAMzC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,eAAe,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/D,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAM1C;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAOrF;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAOhF;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAMnE;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CACR,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,GACF,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAa1C;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;QACnC,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAa/C,+CAA+C;IAC/C,MAAM,GAAI,OAAO,MAAM,EAAE,QAAQ;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,iDACvD;IAElC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;QACpC,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAe/C;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAMjF,yDAAyD;IACzD,WAAW,GAAI,OAAO,MAAM;;;sBA+U6z9O,qBAAsB;QA/Unz9O;IAI5D;;;;;;;;;;;;;;;;;;OAkBG;IACI,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC;IA8HpH;;OAEG;IACI,eAAe,CAClB,IAAI,EAAE;QACF,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG;YAAE,UAAU,EAAE,IAAI,CAAA;SAAE,CAAC;QACvD,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,wCAAwC;QACxC,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B,EACD,OAAO,CAAC,EAAE,aAAa,GACxB,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC;IAe7C;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CACT,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,EAC1C,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1E,OAAO,CAAC,WAAW,CAAC;CAwC1B;AAMD,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,qDAAqD;IACrD,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,6CAA6C;IAC7C,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,qCAAqC;AACrC,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/modules/runs.ts"],"names":[],"mappings":"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"}

package/dist/modules/runs.js

@@ -165,26 +165,11 @@ export class RunsModule {
     /**
      * Replay from checkpoint (stateful).
      * Creates a NEW run that starts from the specified checkpoint.
-     *
-     * @param runId - The original run to replay from
-     * @param checkpointId - The checkpoint ID to start from
-     * @param options - Replay options
-     * @returns New run created from checkpoint
-     *
-     * @example
-     * ```ts
-     * const checkpoints = await client.runs.getCheckpoints(runId)
-     * const newRun = await client.runs.replay(runId, checkpoints[2].id, {
-     *   mode: 'best_effort',
-     *   reason: 'Debugging step 3'
-     * })
-     * ```
      */
     async replay(runId, checkpointId, options) {
-        return this.client.POST("/v1/api/runs/{runId}/replay", {
-            params: { path: { runId } },
+        return this.client.POST("/v1/api/runs/{runId}/checkpoints/{checkpointId}/replay", {
+            params: { path: { runId, checkpointId } },
             body: {
-                checkpoint_id: checkpointId,
                 mode: options?.mode,
                 reason: options?.reason
             },
@@ -247,7 +232,7 @@ export class RunsModule {
      * Get checkpoints for a run.
      */
     async getCheckpoints(runId) {
-        return this.client.GET("/v1/api/runs/{runId}/checkpoints", {
+        return this.client.GET("/v1/api/runs/{runId}/checkpoints/index", {
             params: { path: { runId } },
         });
     }

package/dist/modules/traces.d.ts

@@ -45,6 +45,11 @@ export interface SpanListResponse {
 export interface TraceDetail extends Trace {
     spans: Span[];
 }
+export interface SpansByRunResponse {
+    run_id: string;
+    spans: Span[];
+    count: number;
+}
 export declare class TracesModule {
     private client;
     private headers;
@@ -67,6 +72,11 @@ export declare class TracesModule {
      * Get spans for a trace.
      */
     getSpans(traceId: string): Promise<APIResponse<SpanListResponse>>;
+    /**
+     * Get all spans associated with a run.
+     * Maps to: GET /v1/api/traces/by-run/{runId}
+     */
+    getByRun(runId: string): Promise<APIResponse<SpansByRunResponse>>;
     /**
      * Ingest spans (batch).
      */

package/dist/modules/traces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traces.d.ts","sourceRoot":"","sources":["../../src/modules/traces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC;AAIzD,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,KAAK;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,IAAI;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAY,SAAQ,KAAK;IACtC,KAAK,EAAE,IAAI,EAAE,CAAC;CACjB;AAED,qBAAa,YAAY;IACT,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEpF;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAO3C;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAO7D;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAOvE;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAO3D;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;CAM3E"}
+{"version":3,"file":"traces.d.ts","sourceRoot":"","sources":["../../src/modules/traces.ts"],"names":[],"mappings":"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"}

package/dist/modules/traces.js

@@ -35,6 +35,15 @@ export class TracesModule {
             headers: this.headers(),
         });
     }
+    /**
+     * Get all spans associated with a run.
+     * Maps to: GET /v1/api/traces/by-run/{runId}
+     */
+    async getByRun(runId) {
+        return this.client.GET(`/v1/api/traces/by-run/${runId}`, {
+            headers: this.headers(),
+        });
+    }
     /**
      * Ingest spans (batch).
      */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@agent-os-sdk/client",
-    "version": "0.9.4",
+    "version": "0.9.6",
     "description": "Official TypeScript SDK for Agent OS platform",
     "type": "module",
     "main": "./dist/index.js",
@@ -50,4 +50,4 @@
         "dist",
         "src"
     ]
-}
+}

package/src/client/AgentOsClient.ts

@@ -58,7 +58,6 @@ import { AuthModule } from "../modules/auth.js";
 import { CatalogModule } from "../modules/catalog.js";
 import { CheckpointsModule } from "../modules/checkpoints.js";
 import { CronsModule } from "../modules/crons.js";
-import { DlqModule } from "../modules/dlq.js";
 import { EvaluationModule } from "../modules/evaluation.js";
 import { FilesModule } from "../modules/files.js";
 import { GraphsModule } from "../modules/graphs.js";
@@ -107,7 +106,6 @@ export class AgentOsClient {
     readonly checkpoints: CheckpointsModule;
     readonly playground: PlaygroundModule;
     readonly crons: CronsModule;
-    readonly dlq: DlqModule;
     readonly store: StoreModule;
     readonly audit: AuditModule;
     readonly usage: UsageModule;
@@ -145,6 +143,8 @@ export class AgentOsClient {
         this._client = createRawClient({
             baseUrl: options.baseUrl,
             headerProvider: () => this._resolveHeaders(),
+            network: options.network,
+            hooks: options.hooks,
         });
 
         // Module header getter (sync fallback for backwards compat with module internals)
@@ -175,7 +175,6 @@ export class AgentOsClient {
         this.checkpoints = new CheckpointsModule(this._client, getHeaders);
         this.playground = new PlaygroundModule(this._client, getHeaders);
         this.crons = new CronsModule(this._client, getHeaders);
-        this.dlq = new DlqModule(this._client, getHeaders);
         this.store = new StoreModule(this._client, getHeaders);
         this.audit = new AuditModule(this._client, getHeaders);
         this.usage = new UsageModule(this._client, getHeaders);

package/src/client/auth.ts

@@ -6,6 +6,9 @@
  * - API Token (server): Uses aosk_* token with embedded claims
  */
 
+import type { NetworkConfig } from "./config.js";
+import type { SDKHooks } from "./raw.js";
+
 // ============================================================================
 // Auth Provider Types
 // ============================================================================
@@ -82,6 +85,10 @@ export type AgentOsClientOptions = {
      * Only set to true if you understand the security implications.
      */
     allowApiTokenInBrowser?: boolean
+    /** Network policy (timeouts/retries). */
+    network?: Partial<NetworkConfig>
+    /** Optional request lifecycle hooks for observability */
+    hooks?: SDKHooks
     /** Custom headers to add to all requests */
     headers?: Record<string, string>
 }

package/src/client/raw.ts

@@ -7,8 +7,13 @@
 
 import createClient, { type Client } from "openapi-fetch";
 import type { components, paths } from "../generated/openapi.js";
+import { createErrorFromResponse } from "../errors/factory.js";
+import { AgentOsError, NetworkError, TimeoutError } from "../errors/index.js";
 import { httpRequestBuilder } from "./HttpRequestBuilder.js";
 import type { OperationContext } from "./OperationContext.js";
+import { mergeNetworkConfig, type NetworkConfig } from "./config.js";
+import { withRetry } from "./retry.js";
+import { withTimeout } from "./timeout.js";
 
 // Re-export types for external use
 export type { components, paths };
@@ -17,6 +22,8 @@ export type ClientOptions = {
     baseUrl: string;
     headers?: Record<string, string>;
     headerProvider?: () => Promise<Record<string, string>>;
+    /** Network behavior (timeouts/retries). Defaults to DEFAULT_NETWORK_CONFIG. */
+    network?: Partial<NetworkConfig>;
     /** Hooks for observability (OTEL, Sentry, etc.) */
     hooks?: SDKHooks;
 };
@@ -100,6 +107,12 @@ export function createTypedClient(options: ClientOptions): TypedClient {
  */
 export function createRawClient(options: ClientOptions) {
     const { baseUrl, headers: defaultHeaders = {}, headerProvider } = options;
+    const networkConfig = mergeNetworkConfig(options.network);
+    type ErrorPayload = { code?: string; message?: string; details?: unknown } & Record<string, unknown>;
+    type HttpAgentOsError = AgentOsError & {
+        response?: Response;
+        payload?: ErrorPayload;
+    };
 
     async function request<T>(
         method: string,
@@ -195,63 +208,115 @@ export function createRawClient(options: ClientOptions) {
 
         let response: Response;
         try {
-            response = await doFetch(opts?.signal);
-        } catch (fetchError) {
-            const durationMs = Date.now() - startTime;
-            // Call onError hook
-            await options.hooks?.onError?.({
-                method,
-                url: fullUrl,
-                error: fetchError instanceof Error ? fetchError : new Error(String(fetchError)),
-                durationMs,
-                requestId: clientRequestId,
-            });
-
-            // Network error - return as error
-            return {
-                error: {
-                    code: "NETWORK_ERROR",
-                    message: fetchError instanceof Error ? fetchError.message : "Network request failed"
-                },
-                response: new Response(null, { status: 503, statusText: "Network Error" })
-            };
-        }
+            const hasIdempotencyKey = Boolean(
+                opts?.idempotencyKey ||
+                headers["X-Idempotency-Key"] ||
+                headers["Idempotency-Key"]
+            );
+
+            const executeAttempt = async (signal?: AbortSignal): Promise<Response> => {
+                const attemptResponse = await withTimeout(async (timeoutSignal) => {
+                    try {
+                        return await doFetch(timeoutSignal);
+                    } catch (fetchError) {
+                        // Preserve AbortError semantics for caller-provided cancellation.
+                        if (fetchError instanceof Error && fetchError.name === "AbortError") {
+                            throw fetchError;
+                        }
+
+                        throw new NetworkError(
+                            fetchError instanceof Error ? fetchError.message : "Network request failed",
+                            fetchError instanceof Error ? fetchError : undefined
+                        );
+                    }
+                }, opts?.timeoutMs ?? networkConfig.timeoutMs, signal);
+
+                if (!attemptResponse.ok) {
+                    let errorBody: ErrorPayload | undefined;
+                    try {
+                        errorBody = await attemptResponse.json() as ErrorPayload;
+                    } catch {
+                        // Ignore JSON parse errors and fallback to status text.
+                    }
 
-        const durationMs = Date.now() - startTime;
+                    const typedError = createErrorFromResponse(attemptResponse, errorBody, path) as HttpAgentOsError;
+                    typedError.response = attemptResponse;
+                    typedError.payload = errorBody;
+                    throw typedError;
+                }
 
-        // Extract requestId for tracing (prefer server requestId if available)
-        const requestId = response.headers.get("x-request-id") ?? clientRequestId;
+                return attemptResponse;
+            };
 
-        if (!response.ok) {
-            let errorBody: { code?: string; message?: string; details?: unknown } | undefined;
-            try {
-                errorBody = await response.json();
-            } catch {
-                // Ignore JSON parse errors
+            if (opts?.retry === false) {
+                response = await executeAttempt(opts?.signal);
+            } else {
+                response = await withRetry(
+                    (signal) => executeAttempt(signal),
+                    networkConfig.retry,
+                    { method, hasIdempotencyKey },
+                    opts?.signal
+                );
             }
+        } catch (requestError) {
+            const durationMs = Date.now() - startTime;
+            const error = requestError instanceof Error ? requestError : new Error(String(requestError));
+            const typedError = requestError instanceof AgentOsError ? requestError as HttpAgentOsError : undefined;
+            const errorResponse = typedError?.response;
+            const requestId = errorResponse?.headers.get("x-request-id")
+                ?? typedError?.requestId
+                ?? clientRequestId;
 
             // Call onError hook
             await options.hooks?.onError?.({
                 method,
                 url: fullUrl,
-                error: new Error(errorBody?.message || response.statusText),
+                error,
                 durationMs,
                 requestId,
             });
 
+            if (typedError && errorResponse) {
+                return {
+                    error: {
+                        code: typedError.backendCode || typedError.code,
+                        message: typedError.message,
+                        details: typedError.details,
+                        // Include full payload for validation hints and backend-specific fields.
+                        ...typedError.payload,
+                    },
+                    response: errorResponse,
+                    meta: { requestId },
+                };
+            }
+
+            if (error instanceof TimeoutError) {
+                return {
+                    error: {
+                        code: error.code,
+                        message: error.message,
+                    },
+                    response: new Response(null, { status: 408, statusText: "Request Timeout" }),
+                    meta: { requestId },
+                };
+            }
+
+            // Network/abort/unexpected errors - return as standardized transport error.
             return {
                 error: {
-                    code: errorBody?.code || `HTTP_${response.status}`,
-                    message: errorBody?.message || response.statusText,
-                    details: errorBody?.details,
-                    // Include full error body for 422 responses with hints
-                    ...errorBody,
+                    code: "NETWORK_ERROR",
+                    message: error.message || "Network request failed"
                 },
-                response,
+                response: new Response(null, { status: 503, statusText: "Network Error" }),
                 meta: { requestId },
             };
         }
 
+        const durationMs = Date.now() - startTime;
+
+        // Extract requestId for tracing (prefer server requestId if available)
+        const requestId = response.headers.get("x-request-id") ?? clientRequestId;
+
         // Call onResponse hook
         await options.hooks?.onResponse?.({
             method,
@@ -384,6 +449,8 @@ export type WaitRunResponse = components["schemas"]["WaitRunResponse"];
 export type BatchRunRequest = components["schemas"]["BatchRunRequest"];
 export type BatchRunResponse = components["schemas"]["BatchRunResponse"];
 export type ReplayRequest = components["schemas"]["ReplayRequest"];
+export type RunReplayRequest = components["schemas"]["RunReplayRequest"];
+export type RunReplayResponse = components["schemas"]["RunReplayResponse"];
 export type CancelRequest = components["schemas"]["CancelRequest"];
 export type CancelRunResponse = components["schemas"]["CancelRunResponse"];
 

package/src/generated/openapi.ts

@@ -2637,172 +2637,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/api/runs/dlq": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** List DLQ messages. */
-        get: {
-            parameters: {
-                query?: {
-                    messageType?: string;
-                    skip?: number;
-                    take?: number;
-                };
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/api/runs/dlq/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** Get a specific DLQ message. */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        /** Delete/acknowledge a DLQ message. */
-        delete: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/api/runs/dlq/{id}/retry": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /** Retry a DLQ message (re-enqueue the original operation). */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/api/runs/dlq/purge": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post?: never;
-        /** Purge all DLQ messages for the tenant. */
-        delete: {
-            parameters: {
-                query?: {
-                    messageType?: string;
-                };
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description OK */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-            };
-        };
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/v1/api/evaluations/datasets": {
         parameters: {
             query?: never;
@@ -5544,7 +5378,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ReplayResponse"];
+                        "application/json": components["schemas"]["RunReplayResponse"];
                     };
                 };
                 /** @description Not Found */
@@ -9249,6 +9083,16 @@ export interface components {
             } | null;
             /** Format: int32 */
             version_number?: number | null;
+            execute?: boolean;
+            provider?: string | null;
+            model?: string | null;
+            /** Format: uuid */
+            credential_id?: string | null;
+            credential_name?: string | null;
+            /** Format: double */
+            temperature?: number | null;
+            /** Format: int32 */
+            max_tokens?: number | null;
         };
         /**
          * @description Playground request - note: TenantId/WorkspaceId from body are IGNORED,
@@ -9365,6 +9209,8 @@ export interface components {
             query?: string | null;
             /** Format: int32 */
             top_k?: number;
+            /** Format: float */
+            min_score?: number | null;
             filters?: {
                 [key: string]: unknown;
             } | null;
@@ -9494,6 +9340,16 @@ export interface components {
             mode?: string | null;
             reason?: string | null;
         };
+        RunReplayResponse: {
+            /** Format: uuid */
+            run_id?: string;
+            /** Format: uuid */
+            replayed_from_run_id?: string;
+            /** Format: uuid */
+            replayed_from_checkpoint_id?: string;
+            mode?: string | null;
+            status?: string | null;
+        };
         RunResponse: {
             /** Format: uuid */
             run_id?: string;