@agent-os-sdk/client 0.9.26 → 0.9.28

package/dist/modules/threads.js

@@ -0,0 +1,225 @@
+/**
+ * Threads Module - Fully Typed
+ *
+ * Naming conventions:
+ * - get* for singular items
+ * - list* for collections
+ * - create*, update*, delete* for mutations
+ *
+ * Convenience aliases are provided for common access patterns.
+ */
+export class ThreadsModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    // ======================== CRUD ========================
+    /**
+     * Create a new thread.
+     * @example
+     * ```ts
+     * const { data: thread } = await client.threads.create();
+     *
+     * // With idempotency (safe to retry)
+     * const { data: thread } = await client.threads.create({
+     *   idempotency_key: "my-unique-key"
+     * });
+     * ```
+     */
+    async create(body) {
+        // Send canonical X-Idempotency-Key header + body idempotency_key for backend contract parity.
+        const headers = { ...this.headers() };
+        if (body?.idempotency_key) {
+            headers["X-Idempotency-Key"] = body.idempotency_key;
+        }
+        return this.client.POST("/v1/api/threads", {
+            body: body ?? {},
+            headers,
+        });
+    }
+    /**
+     * Get a thread by ID.
+     * @example
+     * ```ts
+     * const { data: thread } = await client.threads.get("thread-uuid");
+     * ```
+     */
+    async get(threadId) {
+        return this.client.GET("/v1/api/threads/{id}", {
+            params: { path: { id: threadId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * List all threads.
+     * @example
+     * ```ts
+     * const { data } = await client.threads.list({ limit: 20 });
+     * ```
+     */
+    async list(params) {
+        return this.client.GET("/v1/api/threads", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Iterate through all threads with automatic pagination.
+     *
+     * @example
+     * ```ts
+     * for await (const thread of client.threads.iterate()) {
+     *     console.log(thread.id);
+     * }
+     * ```
+     */
+    async *iterate(filters, options) {
+        const pageSize = options?.pageSize ?? 100;
+        const maxItems = options?.maxItems ?? Infinity;
+        let offset = 0;
+        let yielded = 0;
+        let hasMore = true;
+        while (hasMore && yielded < maxItems) {
+            if (options?.signal?.aborted)
+                return;
+            const response = await this.list({
+                ...filters,
+                limit: Math.min(pageSize, maxItems - yielded),
+                offset,
+            });
+            if (response.error)
+                throw response.error;
+            const data = response.data;
+            for (const thread of data.items) {
+                if (yielded >= maxItems)
+                    return;
+                yield thread;
+                yielded++;
+            }
+            offset += data.items.length;
+            hasMore = offset < data.total && data.items.length > 0;
+        }
+    }
+    /**
+     * Delete a thread.
+     */
+    async delete(threadId) {
+        return this.client.DELETE("/v1/api/threads/{id}", {
+            params: { path: { id: threadId } },
+            headers: this.headers(),
+        });
+    }
+    // ======================== State ========================
+    /**
+     * Get the current state of a thread.
+     * @example
+     * ```ts
+     * const { data: state } = await client.threads.getState("thread-uuid");
+     * ```
+     */
+    async getState(threadId) {
+        return this.client.GET("/v1/api/threads/{id}/state", {
+            params: { path: { id: threadId } },
+            headers: this.headers(),
+        });
+    }
+    /** Alias: threads.state() -> threads.getState() */
+    state = (threadId) => this.getState(threadId);
+    // ======================== History ========================
+    /**
+     * Get the history of a thread.
+     */
+    async getHistory(threadId) {
+        return this.client.GET("/v1/api/threads/{id}/history", {
+            params: { path: { id: threadId } },
+            headers: this.headers(),
+        });
+    }
+    /** Alias: threads.history() -> threads.getHistory() */
+    history = (threadId) => this.getHistory(threadId);
+    // ======================== Runs ========================
+    /**
+     * Get runs for a thread.
+     * @example
+     * ```ts
+     * const { data } = await client.threads.getRuns("thread-uuid");
+     * ```
+     */
+    async getRuns(threadId, params) {
+        return this.client.GET("/v1/api/threads/{id}/runs", {
+            params: { path: { id: threadId }, query: params },
+            headers: this.headers(),
+        });
+    }
+    /** Alias: threads.runs() -> threads.getRuns() */
+    runs = (threadId, params) => this.getRuns(threadId, params);
+    /**
+     * Create a run within a thread.
+     */
+    async createRun(threadId, body) {
+        return this.client.POST("/v1/api/threads/{id}/runs", {
+            params: { path: { id: threadId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    // ======================== Messages ========================
+    /**
+     * Get messages in a thread.
+     * @example
+     * ```ts
+     * const { data } = await client.threads.getMessages("thread-uuid");
+     * ```
+     */
+    async getMessages(threadId, params) {
+        return this.client.GET("/v1/api/threads/{id}/messages", {
+            params: { path: { id: threadId }, query: params },
+            headers: this.headers(),
+        });
+    }
+    /** Alias: threads.messages() -> threads.getMessages() */
+    messages = (threadId, params) => this.getMessages(threadId, params);
+    /**
+     * Add a message to a thread.
+     */
+    async addMessage(threadId, body) {
+        return this.client.POST("/v1/api/threads/{id}/messages", {
+            params: { path: { id: threadId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    // ======================== Search ========================
+    /**
+     * Search threads.
+     */
+    async search(body) {
+        return this.client.POST("/v1/api/threads/search", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    // ======================== Copy/Fork ========================
+    /**
+     * Copy/fork a thread.
+     */
+    async copy(threadId, options) {
+        return this.client.POST("/v1/api/threads/{id}/copy", {
+            params: { path: { id: threadId } },
+            body: options ?? {},
+            headers: this.headers(),
+        });
+    }
+    // ======================== Prune ========================
+    /**
+     * Prune old threads.
+     */
+    async prune(body) {
+        return this.client.POST("/v1/api/threads/prune", {
+            body,
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/tools.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Tools Module - Fully Typed
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface Tool {
+    name: string;
+    description?: string;
+    category?: string;
+    parameters?: Record<string, unknown>;
+    required_credentials: string[];
+    is_builtin: boolean;
+    created_at?: string;
+}
+export interface ToolListResponse {
+    items: Tool[];
+    total: number;
+}
+export interface ToolDefinition {
+    capability_ref: string;
+    capability_version: string;
+    execution_binding: string;
+    slug?: string;
+    required_credentials: string[];
+    name: string;
+    description?: string;
+    type: string;
+    version?: number;
+    input_schema?: Record<string, unknown>;
+    output_schema?: Record<string, unknown>;
+}
+export interface ToolDefinitionsResponse {
+    version: string;
+    tools: ToolDefinition[];
+}
+export interface ToolCallResult {
+    success: boolean;
+    output?: unknown;
+    error?: string;
+}
+export declare class ToolsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List all available tools.
+     */
+    list(params?: {
+        category?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<ToolListResponse>>;
+    /**
+     * Get a tool by name.
+     */
+    get(toolName: string): Promise<APIResponse<Tool>>;
+    getDefinitions(version?: string): Promise<APIResponse<ToolDefinitionsResponse>>;
+    /**
+     * Call a tool directly (testing).
+     */
+    call(toolName: string, args: unknown): Promise<APIResponse<ToolCallResult>>;
+}
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/modules/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,WAAW,IAAI;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAW;IACR,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,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAO1C;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAOjD,cAAc,CAAC,OAAO,GAAE,MAAY,GAAG,OAAO,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;IAO1F;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;CAOpF"}

package/dist/modules/tools.js

@@ -0,0 +1,45 @@
+/**
+ * Tools Module - Fully Typed
+ */
+export class ToolsModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * List all available tools.
+     */
+    async list(params) {
+        return this.client.GET("/v1/api/tools", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a tool by name.
+     */
+    async get(toolName) {
+        return this.client.GET("/v1/api/tools/{name}", {
+            params: { path: { name: toolName } },
+            headers: this.headers(),
+        });
+    }
+    async getDefinitions(version = "1") {
+        return this.client.GET("/v1/api/tools/definitions", {
+            params: { query: { version } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Call a tool directly (testing).
+     */
+    async call(toolName, args) {
+        return this.client.POST("/v1/api/tools/{name}/call", {
+            params: { path: { name: toolName } },
+            body: { arguments: args },
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/traces.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Traces Module - Fully Typed
+ */
+import type { RawClient, APIResponse, components } from "../client/raw.js";
+export type SpanData = components["schemas"]["SpanData"];
+export interface FeedbackRequest {
+    span_id: string;
+    score?: string;
+    comment?: string;
+    corrections?: Record<string, unknown>;
+}
+export interface Trace {
+    trace_id: string;
+    run_id?: string;
+    root_span_id: string;
+    name: string;
+    status: "ok" | "error" | "pending";
+    start_time: string;
+    end_time?: string;
+    duration_ms?: number;
+    span_count: number;
+}
+export interface Span {
+    trace_id: string;
+    span_id: string;
+    parent_span_id?: string;
+    name: string;
+    kind: string;
+    status: string;
+    status_message?: string;
+    start_time_unix_nano: number;
+    end_time_unix_nano?: number;
+    run_id?: string;
+    attributes?: Record<string, unknown>;
+    events?: unknown[];
+}
+export interface TraceListResponse {
+    items: Trace[];
+    total: number;
+}
+export interface SpanListResponse {
+    items: Span[];
+    total: number;
+}
+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;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List traces.
+     */
+    list(params?: {
+        run_id?: string;
+        from?: string;
+        to?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<TraceListResponse>>;
+    /**
+     * Get a trace by ID.
+     */
+    get(traceId: string): Promise<APIResponse<TraceDetail>>;
+    /**
+     * 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).
+     */
+    ingest(spans: SpanData[]): Promise<APIResponse<void>>;
+    /**
+     * Add feedback to a span.
+     */
+    addFeedback(feedback: FeedbackRequest): Promise<APIResponse<void>>;
+}
+//# sourceMappingURL=traces.d.ts.map

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

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

package/dist/modules/traces.js

@@ -0,0 +1,65 @@
+/**
+ * Traces Module - Fully Typed
+ */
+export class TracesModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * List traces.
+     */
+    async list(params) {
+        return this.client.GET("/v1/api/traces", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a trace by ID.
+     */
+    async get(traceId) {
+        return this.client.GET("/v1/api/traces/{id}", {
+            params: { path: { id: traceId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get spans for a trace.
+     */
+    async getSpans(traceId) {
+        return this.client.GET("/v1/api/traces/{id}/spans", {
+            params: { path: { id: traceId } },
+            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).
+     */
+    async ingest(spans) {
+        return this.client.POST("/v1/api/traces/ingest", {
+            body: { spans },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Add feedback to a span.
+     */
+    async addFeedback(feedback) {
+        return this.client.POST("/v1/api/traces/feedback", {
+            body: feedback,
+            headers: this.headers(),
+        });
+    }
+}