@agent-os-sdk/client 0.1.0

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

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

package/dist/modules/runs.js

@@ -0,0 +1,187 @@
+/**
+ * Runs Module - Core execution API (Fully Typed)
+ *
+ * Naming conventions:
+ * - get* for singular items
+ * - list* for collections
+ * - create*, update*, delete* for mutations
+ */
+import { streamSSE } from "../sse/client.js";
+export class RunsModule {
+    client;
+    baseUrl;
+    headers;
+    constructor(client, baseUrl, headers) {
+        this.client = client;
+        this.baseUrl = baseUrl;
+        this.headers = headers;
+    }
+    // ======================== CRUD ========================
+    /**
+     * Create a new run.
+     * @example
+     * ```ts
+     * const { data } = await client.runs.create({
+     *   agent_id: "agent-uuid",
+     *   input: { message: "Hello" }
+     * });
+     * ```
+     */
+    async create(body) {
+        return this.client.POST("/v1/api/runs", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a run by ID.
+     */
+    async get(runId) {
+        return this.client.GET("/v1/api/runs/{runId}", {
+            params: { path: { runId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * List runs with optional filters.
+     */
+    async list(params) {
+        return this.client.GET("/v1/api/runs", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    // ======================== Execution ========================
+    /**
+     * Wait for run completion synchronously.
+     */
+    async wait(body) {
+        return this.client.POST("/v1/api/runs/wait", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create batch runs.
+     */
+    async batch(body) {
+        return this.client.POST("/v1/api/runs/batch", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Cancel a running run.
+     */
+    async cancel(runId, reason) {
+        return this.client.POST("/v1/api/runs/{runId}/cancel", {
+            params: { path: { runId } },
+            body: { reason },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Resume a run waiting for human input (HITL).
+     */
+    async resume(runId, input) {
+        return this.client.POST("/v1/api/runs/{runId}/resume", {
+            params: { path: { runId } },
+            body: { input },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Rerun from start (stateless).
+     */
+    async rerun(runId) {
+        return this.client.POST("/v1/api/runs/{runId}/rerun", {
+            params: { path: { runId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Replay from checkpoint (stateful).
+     */
+    async replay(runId, checkpointId, mode) {
+        return this.client.POST("/v1/api/runs/{runId}/replay", {
+            params: { path: { runId } },
+            body: { checkpoint_id: checkpointId, mode },
+            headers: this.headers(),
+        });
+    }
+    // ======================== Events ========================
+    /**
+     * Get run events for timeline (paged, no SSE).
+     * @example
+     * ```ts
+     * const { data } = await client.runs.getEvents("run-uuid");
+     * ```
+     */
+    async getEvents(runId, params) {
+        return this.client.GET("/v1/api/runs/{runId}/events", {
+            params: { path: { runId }, query: params },
+            headers: this.headers(),
+        });
+    }
+    /** Alias: runs.events() -> runs.getEvents() */
+    events = (runId, params) => this.getEvents(runId, params);
+    // ======================== Checkpoints ========================
+    /**
+     * Get checkpoints for a run.
+     */
+    async getCheckpoints(runId) {
+        return this.client.GET("/v1/api/runs/{runId}/checkpoints", {
+            params: { path: { runId } },
+            headers: this.headers(),
+        });
+    }
+    /** Alias: runs.checkpoints() -> runs.getCheckpoints() */
+    checkpoints = (runId) => this.getCheckpoints(runId);
+    // ======================== STREAMING ========================
+    /**
+     * Stream run events via SSE.
+     * @example
+     * ```ts
+     * for await (const event of client.runs.stream("run-uuid")) {
+     *   console.log(event.data);
+     * }
+     * ```
+     */
+    stream(runId, options) {
+        const url = `${this.baseUrl}/v1/api/runs/${runId}/stream`;
+        return streamSSE(url, {
+            ...options,
+            headers: { ...this.headers(), ...options?.headers },
+        });
+    }
+    /**
+     * Create run and stream output.
+     * @example
+     * ```ts
+     * for await (const event of client.runs.createAndStream({
+     *   agent_id: "...",
+     *   input: { message: "Hello" }
+     * })) {
+     *   console.log(event);
+     * }
+     * ```
+     */
+    async *createAndStream(body, options) {
+        const { data, error } = await this.create(body);
+        if (error || !data) {
+            throw new Error(`Failed to create run: ${JSON.stringify(error)}`);
+        }
+        const runId = data.run_id;
+        yield* this.stream(runId, options);
+    }
+    /**
+     * Join an existing run's stream (resume watching).
+     */
+    join(runId, options) {
+        const url = `${this.baseUrl}/v1/api/runs/${runId}/join`;
+        return streamSSE(url, {
+            ...options,
+            headers: { ...this.headers(), ...options?.headers },
+        });
+    }
+}

package/dist/modules/store.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Store Module - Fully Typed
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface StoreValue {
+    key: string;
+    value: string;
+    ttl_seconds?: number;
+    created_at: string;
+    expires_at?: string;
+}
+export interface StoreKeysResponse {
+    keys: string[];
+    total: number;
+}
+export declare class StoreModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * Get a value by key.
+     */
+    get(key: string): Promise<APIResponse<StoreValue>>;
+    /**
+     * Set a value.
+     */
+    set(key: string, value: string, ttlSeconds?: number): Promise<APIResponse<StoreValue>>;
+    /**
+     * Delete a value.
+     */
+    delete(key: string): Promise<APIResponse<void>>;
+    /**
+     * List all keys.
+     */
+    listKeys(prefix?: string): Promise<APIResponse<StoreKeysResponse>>;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/modules/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAI3E,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;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,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAOxD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAQ5F;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAOrD;;OAEG;IACG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;CAM3E"}

package/dist/modules/store.js

@@ -0,0 +1,48 @@
+/**
+ * Store Module - Fully Typed
+ */
+export class StoreModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * Get a value by key.
+     */
+    async get(key) {
+        return this.client.GET("/v1/api/store/{key}", {
+            params: { path: { key } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Set a value.
+     */
+    async set(key, value, ttlSeconds) {
+        return this.client.PUT("/v1/api/store/{key}", {
+            params: { path: { key } },
+            body: { value, ttl_seconds: ttlSeconds },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Delete a value.
+     */
+    async delete(key) {
+        return this.client.DELETE("/v1/api/store/{key}", {
+            params: { path: { key } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * List all keys.
+     */
+    async listKeys(prefix) {
+        return this.client.GET("/v1/api/store", {
+            params: { query: { prefix } },
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/tenants.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Tenants Module - Fully Typed
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface Tenant {
+    id: string;
+    name: string;
+    slug: string;
+    owner_id?: string;
+    settings?: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+}
+export interface TenantListResponse {
+    items: Tenant[];
+    total: number;
+}
+export declare class TenantsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * Get the current tenant.
+     */
+    get(): Promise<APIResponse<Tenant>>;
+    /**
+     * Update the current tenant.
+     */
+    update(body: {
+        name?: string;
+        slug?: string;
+    }): Promise<APIResponse<Tenant>>;
+    /**
+     * Get tenant settings.
+     */
+    getSettings(): Promise<APIResponse<Record<string, unknown>>>;
+    /**
+     * Update tenant settings.
+     */
+    updateSettings(settings: Record<string, unknown>): Promise<APIResponse<void>>;
+}
+//# sourceMappingURL=tenants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.d.ts","sourceRoot":"","sources":["../../src/modules/tenants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAI3E,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACV,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEpF;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAMzC;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAOhC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAMlE;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;CAMtF"}

package/dist/modules/tenants.js

@@ -0,0 +1,45 @@
+/**
+ * Tenants Module - Fully Typed
+ */
+export class TenantsModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * Get the current tenant.
+     */
+    async get() {
+        return this.client.GET("/v1/api/tenants/current", {
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Update the current tenant.
+     */
+    async update(body) {
+        return this.client.PUT("/v1/api/tenants/current", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get tenant settings.
+     */
+    async getSettings() {
+        return this.client.GET("/v1/api/tenants/current/settings", {
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Update tenant settings.
+     */
+    async updateSettings(settings) {
+        return this.client.PUT("/v1/api/tenants/current/settings", {
+            body: settings,
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/threads.d.ts

@@ -0,0 +1,181 @@
+/**
+ * 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.
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+import type { PaginationParams, PaginatedResponse } from "../client/helpers.js";
+export interface Thread {
+    id: string;
+    workspace_id: string;
+    tenant_id: string;
+    channel?: string;
+    external_conversation_id?: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+}
+export interface ThreadState {
+    thread_id: string;
+    values: Record<string, unknown>;
+    next?: string[];
+    tasks?: unknown[];
+    metadata?: Record<string, unknown>;
+}
+export interface ThreadHistory {
+    thread_id: string;
+    checkpoints: unknown[];
+}
+export interface ThreadMessage {
+    id: string;
+    thread_id: string;
+    role: "human" | "assistant" | "system" | "developer";
+    content: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+}
+export interface ThreadRun {
+    run_id: string;
+    thread_id: string;
+    agent_id: string;
+    status: string;
+    created_at: string;
+    completed_at?: string;
+}
+export type ThreadListResponse = PaginatedResponse<Thread>;
+export type ThreadMessagesResponse = PaginatedResponse<ThreadMessage>;
+export type ThreadRunsResponse = PaginatedResponse<ThreadRun>;
+export interface ThreadSearchResponse {
+    items: Thread[];
+    total: number;
+}
+export interface ThreadPruneResponse {
+    deleted_count: number;
+    thread_ids: string[];
+}
+export declare class ThreadsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * Create a new thread.
+     * @example
+     * ```ts
+     * const { data: thread } = await client.threads.create();
+     * ```
+     */
+    create(body?: {
+        channel?: string;
+        external_conversation_id?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<APIResponse<Thread>>;
+    /**
+     * Get a thread by ID.
+     * @example
+     * ```ts
+     * const { data: thread } = await client.threads.get("thread-uuid");
+     * ```
+     */
+    get(threadId: string): Promise<APIResponse<Thread>>;
+    /**
+     * List all threads.
+     * @example
+     * ```ts
+     * const { data } = await client.threads.list({ limit: 20 });
+     * ```
+     */
+    list(params?: PaginationParams & {
+        workspace_id?: string;
+    }): Promise<APIResponse<ThreadListResponse>>;
+    /**
+     * Delete a thread.
+     */
+    delete(threadId: string): Promise<APIResponse<void>>;
+    /**
+     * Get the current state of a thread.
+     * @example
+     * ```ts
+     * const { data: state } = await client.threads.getState("thread-uuid");
+     * ```
+     */
+    getState(threadId: string): Promise<APIResponse<ThreadState>>;
+    /** Alias: threads.state() -> threads.getState() */
+    state: (threadId: string) => Promise<APIResponse<ThreadState>>;
+    /**
+     * Get the history of a thread.
+     */
+    getHistory(threadId: string): Promise<APIResponse<ThreadHistory>>;
+    /** Alias: threads.history() -> threads.getHistory() */
+    history: (threadId: string) => Promise<APIResponse<ThreadHistory>>;
+    /**
+     * Get runs for a thread.
+     * @example
+     * ```ts
+     * const { data } = await client.threads.getRuns("thread-uuid");
+     * ```
+     */
+    getRuns(threadId: string, params?: PaginationParams & {
+        status?: string;
+    }): Promise<APIResponse<ThreadRunsResponse>>;
+    /** Alias: threads.runs() -> threads.getRuns() */
+    runs: (threadId: string, params?: PaginationParams & {
+        status?: string;
+    }) => Promise<APIResponse<ThreadRunsResponse>>;
+    /**
+     * Create a run within a thread.
+     */
+    createRun(threadId: string, body: {
+        agent_id: string;
+        input?: unknown;
+        idempotency_key?: string;
+    }): Promise<APIResponse<ThreadRun>>;
+    /**
+     * Get messages in a thread.
+     * @example
+     * ```ts
+     * const { data } = await client.threads.getMessages("thread-uuid");
+     * ```
+     */
+    getMessages(threadId: string, params?: PaginationParams): Promise<APIResponse<ThreadMessagesResponse>>;
+    /** Alias: threads.messages() -> threads.getMessages() */
+    messages: (threadId: string, params?: PaginationParams) => Promise<APIResponse<ThreadMessagesResponse>>;
+    /**
+     * Add a message to a thread.
+     */
+    addMessage(threadId: string, body: {
+        role?: "human" | "system" | "developer";
+        content: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<APIResponse<ThreadMessage>>;
+    /**
+     * Search threads.
+     */
+    search(body: {
+        workspace_id?: string;
+        agent_id?: string;
+        created_after?: string;
+        created_before?: string;
+        sort_by?: string;
+        sort_desc?: boolean;
+    } & PaginationParams): Promise<APIResponse<ThreadSearchResponse>>;
+    /**
+     * Copy/fork a thread.
+     */
+    copy(threadId: string, options?: {
+        copy_history?: boolean;
+    }): Promise<APIResponse<Thread>>;
+    /**
+     * Prune old threads.
+     */
+    prune(body: {
+        workspace_id?: string;
+        older_than_days?: number;
+        dry_run?: boolean;
+    } & PaginationParams): Promise<APIResponse<ThreadPruneResponse>>;
+}
+//# sourceMappingURL=threads.d.ts.map

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

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