@agent-os-sdk/client 0.9.26 → 0.9.28

package/src/modules/tenants.ts

@@ -1,79 +0,0 @@
-/**
- * Tenants Module - Fully Typed
- */
-
-import type { RawClient, APIResponse, components } from "../client/raw.js";
-
-type UpdateTenantRequest = components["schemas"]["UpdateTenantRequest"];
-
-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 class TenantsModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    /**
-     * List all tenants the user has access to.
-     */
-    /**
-     * List all tenants the user has access to.
-     */
-    async list(): Promise<APIResponse<TenantListResponse>> {
-        return this.client.GET<TenantListResponse>("/v1/api/tenants", {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get the current tenant.
-     */
-    async get(): Promise<APIResponse<Tenant>> {
-        return this.client.GET<Tenant>("/v1/api/tenants/current", {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Update the current tenant.
-     */
-    async update(body: {
-        name?: string;
-        slug?: string;
-    }): Promise<APIResponse<Tenant>> {
-        return this.client.PUT<Tenant>("/v1/api/tenants/current", {
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get tenant settings.
-     */
-    async getSettings(): Promise<APIResponse<Record<string, unknown>>> {
-        return this.client.GET<Record<string, unknown>>("/v1/api/tenants/current/settings", {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Update tenant settings.
-     */
-    async updateSettings(settings: Record<string, unknown>): Promise<APIResponse<void>> {
-        return this.client.PUT<void>("/v1/api/tenants/current/settings", {
-            body: settings,
-            headers: this.headers(),
-        });
-    }
-}

package/src/modules/threads.ts

@@ -1,343 +0,0 @@
-/**
- * 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";
-
-// Response types
-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 class ThreadsModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    // ======================== 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?: {
-        channel?: string;
-        external_conversation_id?: string;
-        metadata?: Record<string, unknown>;
-        /** Idempotency key for safe retries. When set, duplicate requests with the same key return the original response. */
-        idempotency_key?: string;
-    }): Promise<APIResponse<Thread>> {
-        // Send canonical X-Idempotency-Key header + body idempotency_key for backend contract parity.
-        const headers: Record<string, string> = { ...this.headers() };
-        if (body?.idempotency_key) {
-            headers["X-Idempotency-Key"] = body.idempotency_key;
-        }
-
-        return this.client.POST<Thread>("/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: string): Promise<APIResponse<Thread>> {
-        return this.client.GET<Thread>("/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?: PaginationParams & {
-        workspace_id?: string;
-    }): Promise<APIResponse<ThreadListResponse>> {
-        return this.client.GET<ThreadListResponse>("/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?: { workspace_id?: string },
-        options?: { pageSize?: number; maxItems?: number; signal?: AbortSignal }
-    ): AsyncGenerator<Thread, void, unknown> {
-        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: string): Promise<APIResponse<void>> {
-        return this.client.DELETE<void>("/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: string): Promise<APIResponse<ThreadState>> {
-        return this.client.GET<ThreadState>("/v1/api/threads/{id}/state", {
-            params: { path: { id: threadId } },
-            headers: this.headers(),
-        });
-    }
-
-    /** Alias: threads.state() -> threads.getState() */
-    state = (threadId: string) => this.getState(threadId);
-
-    // ======================== History ========================
-
-    /**
-     * Get the history of a thread.
-     */
-    async getHistory(threadId: string): Promise<APIResponse<ThreadHistory>> {
-        return this.client.GET<ThreadHistory>("/v1/api/threads/{id}/history", {
-            params: { path: { id: threadId } },
-            headers: this.headers(),
-        });
-    }
-
-    /** Alias: threads.history() -> threads.getHistory() */
-    history = (threadId: string) => this.getHistory(threadId);
-
-    // ======================== Runs ========================
-
-    /**
-     * Get runs for a thread.
-     * @example
-     * ```ts
-     * const { data } = await client.threads.getRuns("thread-uuid");
-     * ```
-     */
-    async getRuns(threadId: string, params?: PaginationParams & {
-        status?: string
-    }): Promise<APIResponse<ThreadRunsResponse>> {
-        return this.client.GET<ThreadRunsResponse>("/v1/api/threads/{id}/runs", {
-            params: { path: { id: threadId }, query: params },
-            headers: this.headers(),
-        });
-    }
-
-    /** Alias: threads.runs() -> threads.getRuns() */
-    runs = (threadId: string, params?: PaginationParams & { status?: string }) =>
-        this.getRuns(threadId, params);
-
-    /**
-     * Create a run within a thread.
-     */
-    async createRun(threadId: string, body: {
-        agent_id: string;
-        input?: unknown;
-        idempotency_key?: string;
-    }): Promise<APIResponse<ThreadRun>> {
-        return this.client.POST<ThreadRun>("/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: string, params?: PaginationParams): Promise<APIResponse<ThreadMessagesResponse>> {
-        return this.client.GET<ThreadMessagesResponse>("/v1/api/threads/{id}/messages", {
-            params: { path: { id: threadId }, query: params },
-            headers: this.headers(),
-        });
-    }
-
-    /** Alias: threads.messages() -> threads.getMessages() */
-    messages = (threadId: string, params?: PaginationParams) => this.getMessages(threadId, params);
-
-    /**
-     * Add a message to a thread.
-     */
-    async addMessage(threadId: string, body: {
-        role?: "human" | "system" | "developer";
-        content: string;
-        metadata?: Record<string, unknown>;
-    }): Promise<APIResponse<ThreadMessage>> {
-        return this.client.POST<ThreadMessage>("/v1/api/threads/{id}/messages", {
-            params: { path: { id: threadId } },
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    // ======================== Search ========================
-
-    /**
-     * Search threads.
-     */
-    async search(body: {
-        workspace_id?: string;
-        agent_id?: string;
-        created_after?: string;
-        created_before?: string;
-        sort_by?: string;
-        sort_desc?: boolean;
-    } & PaginationParams): Promise<APIResponse<ThreadSearchResponse>> {
-        return this.client.POST<ThreadSearchResponse>("/v1/api/threads/search", {
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    // ======================== Copy/Fork ========================
-
-    /**
-     * Copy/fork a thread.
-     */
-    async copy(threadId: string, options?: { copy_history?: boolean }): Promise<APIResponse<Thread>> {
-        return this.client.POST<Thread>("/v1/api/threads/{id}/copy", {
-            params: { path: { id: threadId } },
-            body: options ?? {},
-            headers: this.headers(),
-        });
-    }
-
-    // ======================== Prune ========================
-
-    /**
-     * Prune old threads.
-     */
-    async prune(body: {
-        workspace_id?: string;
-        older_than_days?: number;
-        dry_run?: boolean;
-    } & PaginationParams): Promise<APIResponse<ThreadPruneResponse>> {
-        return this.client.POST<ThreadPruneResponse>("/v1/api/threads/prune", {
-            body,
-            headers: this.headers(),
-        });
-    }
-}

package/src/modules/tools.ts

@@ -1,91 +0,0 @@
-/**
- * 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; // compatibility/display only
-    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 class ToolsModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    /**
-     * List all available tools.
-     */
-    async list(params?: {
-        category?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<APIResponse<ToolListResponse>> {
-        return this.client.GET<ToolListResponse>("/v1/api/tools", {
-            params: { query: params },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get a tool by name.
-     */
-    async get(toolName: string): Promise<APIResponse<Tool>> {
-        return this.client.GET<Tool>("/v1/api/tools/{name}", {
-            params: { path: { name: toolName } },
-            headers: this.headers(),
-        });
-    }
-
-    async getDefinitions(version: string = "1"): Promise<APIResponse<ToolDefinitionsResponse>> {
-        return this.client.GET<ToolDefinitionsResponse>("/v1/api/tools/definitions", {
-            params: { query: { version } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Call a tool directly (testing).
-     */
-    async call(toolName: string, args: unknown): Promise<APIResponse<ToolCallResult>> {
-        return this.client.POST<ToolCallResult>("/v1/api/tools/{name}/call", {
-            params: { path: { name: toolName } },
-            body: { arguments: args },
-            headers: this.headers(),
-        });
-    }
-}

package/src/modules/traces.ts

@@ -1,133 +0,0 @@
-/**
- * Traces Module - Fully Typed
- */
-
-import type { RawClient, APIResponse, components } from "../client/raw.js";
-
-export type SpanData = components["schemas"]["SpanData"];
-type BatchIngestRequest = components["schemas"]["BatchIngestRequest"];
-type AddFeedbackRequest = components["schemas"]["AddFeedbackRequest"];
-
-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 class TracesModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    /**
-     * List traces.
-     */
-    async list(params?: {
-        run_id?: string;
-        from?: string;
-        to?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<APIResponse<TraceListResponse>> {
-        return this.client.GET<TraceListResponse>("/v1/api/traces", {
-            params: { query: params },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get a trace by ID.
-     */
-    async get(traceId: string): Promise<APIResponse<TraceDetail>> {
-        return this.client.GET<TraceDetail>("/v1/api/traces/{id}", {
-            params: { path: { id: traceId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get spans for a trace.
-     */
-    async getSpans(traceId: string): Promise<APIResponse<SpanListResponse>> {
-        return this.client.GET<SpanListResponse>("/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: string): Promise<APIResponse<SpansByRunResponse>> {
-        return this.client.GET<SpansByRunResponse>(`/v1/api/traces/by-run/${runId}`, {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Ingest spans (batch).
-     */
-    async ingest(spans: SpanData[]): Promise<APIResponse<void>> {
-        return this.client.POST<void>("/v1/api/traces/ingest", {
-            body: { spans },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Add feedback to a span.
-     */
-    async addFeedback(feedback: FeedbackRequest): Promise<APIResponse<void>> {
-        return this.client.POST<void>("/v1/api/traces/feedback", {
-            body: feedback,
-            headers: this.headers(),
-        });
-    }
-}