@agent-os-sdk/client 0.9.26 → 0.9.27

package/dist/modules/usage.js

@@ -0,0 +1,43 @@
+/**
+ * Usage Module — Tenant-level usage metrics and quotas.
+ *
+ * Endpoints: GET /v1/api/quotas, GET /v1/api/usage
+ * Source: runtime.cost_events aggregation
+ */
+// =============================================================================
+// Module
+// =============================================================================
+export class UsageModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * Get current quota status (tenant-level).
+     */
+    async getQuotas(params) {
+        const query = {
+            workspaceId: params?.workspaceId ?? params?.workspace_id,
+        };
+        return this.client.GET("/v1/api/quotas", {
+            params: { query },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get usage metrics with real data from runtime.cost_events.
+     */
+    async getUsage(params) {
+        const query = {
+            workspaceId: params?.workspaceId ?? params?.workspace_id,
+            from: params?.from,
+            to: params?.to,
+        };
+        return this.client.GET("/v1/api/usage", {
+            params: { query },
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/vectorStores.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Vector Stores Module - Fully Typed
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface VectorStore {
+    id: string;
+    name: string;
+    embedding_provider: string;
+    embedding_model: string;
+    dimension: number;
+    credential_binding_key?: string;
+    file_count: number;
+    created_at: string;
+}
+export interface VectorStoreListResponse {
+    items: VectorStore[];
+    total: number;
+}
+export interface VectorSearchResult {
+    id: string;
+    chunk_index: number;
+    content_text: string;
+    score: number;
+    file_id?: string;
+}
+export interface VectorQueryResult {
+    query: string;
+    results: VectorSearchResult[];
+    total_results: number;
+}
+export interface VectorStoreFile {
+    id: string;
+    file_id: string;
+    filename: string;
+    status: "pending" | "processing" | "completed" | "failed";
+    created_at: string;
+}
+export interface VectorStoreFilesResponse {
+    items: VectorStoreFile[];
+    total: number;
+}
+export declare class VectorStoresModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List all vector stores.
+     */
+    list(params?: {
+        workspace_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<VectorStoreListResponse>>;
+    /**
+     * Get a vector store by ID.
+     */
+    get(storeId: string): Promise<APIResponse<VectorStore>>;
+    /**
+     * Create a new vector store.
+     */
+    create(body: {
+        name: string;
+        embedding_provider?: string;
+        embedding_model?: string;
+        dimension?: number;
+        credential_binding_key?: string;
+    }): Promise<APIResponse<VectorStore>>;
+    /**
+     * Delete a vector store.
+     */
+    delete(storeId: string): Promise<APIResponse<void>>;
+    /**
+     * Query a vector store for similar content.
+     */
+    query(storeId: string, body: {
+        query: string;
+        top_k?: number;
+        min_score?: number;
+    }): Promise<APIResponse<VectorQueryResult>>;
+    /**
+     * List files in a vector store.
+     */
+    listFiles(storeId: string, params?: {
+        skip?: number;
+        take?: number;
+    }): Promise<APIResponse<VectorStoreFilesResponse>>;
+    /**
+     * Attach a file to a vector store.
+     */
+    attachFile(storeId: string, fileId: string): Promise<APIResponse<VectorStoreFile>>;
+    /**
+     * Remove a file from a vector store.
+     */
+    removeFile(storeId: string, fileId: string): Promise<APIResponse<void>>;
+    /**
+     * Bind a vector store to an agent.
+     */
+    bindAgent(storeId: string, agentId: string): Promise<APIResponse<void>>;
+}
+//# sourceMappingURL=vectorStores.d.ts.map

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

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

package/dist/modules/vectorStores.js

@@ -0,0 +1,159 @@
+/**
+ * Vector Stores Module - Fully Typed
+ */
+function toVectorStore(item) {
+    return {
+        id: item.id ?? "",
+        name: item.name ?? "",
+        embedding_provider: item.embedding_provider ?? item.embeddingProvider ?? "",
+        embedding_model: item.embedding_model ?? item.embeddingModel ?? "",
+        dimension: item.dimension ?? 0,
+        credential_binding_key: item.credential_binding_key ?? item.credentialBindingKey ?? undefined,
+        file_count: item.file_count ?? item.fileCount ?? 0,
+        created_at: item.created_at ?? item.createdAt ?? "",
+    };
+}
+function toVectorStoreFile(item) {
+    return {
+        id: item.id ?? "",
+        file_id: item.file_id ?? item.fileId ?? "",
+        filename: item.filename ?? "",
+        status: (item.status ?? "pending"),
+        created_at: item.created_at ?? item.createdAt ?? "",
+    };
+}
+export class VectorStoresModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * List all vector stores.
+     */
+    async list(params) {
+        const response = await this.client.GET("/v1/api/vector-stores", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+        const items = Array.isArray(response.data)
+            ? response.data.map((item) => toVectorStore(item))
+            : [];
+        return {
+            ...response,
+            data: {
+                items,
+                total: items.length,
+            },
+        };
+    }
+    /**
+     * Get a vector store by ID.
+     */
+    async get(storeId) {
+        const response = await this.client.GET("/v1/api/vector-stores/{vectorStoreId}", {
+            params: { path: { vectorStoreId: storeId } },
+            headers: this.headers(),
+        });
+        if (!response.data) {
+            return response;
+        }
+        return {
+            ...response,
+            data: toVectorStore(response.data),
+        };
+    }
+    /**
+     * Create a new vector store.
+     */
+    async create(body) {
+        const response = await this.client.POST("/v1/api/vector-stores", {
+            body,
+            headers: this.headers(),
+        });
+        if (!response.data) {
+            return response;
+        }
+        return {
+            ...response,
+            data: toVectorStore(response.data),
+        };
+    }
+    /**
+     * Delete a vector store.
+     */
+    async delete(storeId) {
+        return this.client.DELETE("/v1/api/vector-stores/{vectorStoreId}", {
+            params: { path: { vectorStoreId: storeId } },
+            headers: this.headers(),
+        });
+    }
+    // ======================== Query ========================
+    /**
+     * Query a vector store for similar content.
+     */
+    async query(storeId, body) {
+        return this.client.POST("/v1/api/vector-stores/{vectorStoreId}/query", {
+            params: { path: { vectorStoreId: storeId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    // ======================== Files ========================
+    /**
+     * List files in a vector store.
+     */
+    async listFiles(storeId, params) {
+        const response = await this.client.GET("/v1/api/vector-stores/{vectorStoreId}/files", {
+            params: { path: { vectorStoreId: storeId }, query: params },
+            headers: this.headers(),
+        });
+        const items = Array.isArray(response.data)
+            ? response.data.map((item) => toVectorStoreFile(item))
+            : [];
+        return {
+            ...response,
+            data: {
+                items,
+                total: items.length,
+            },
+        };
+    }
+    /**
+     * Attach a file to a vector store.
+     */
+    async attachFile(storeId, fileId) {
+        const response = await this.client.POST("/v1/api/vector-stores/{vectorStoreId}/files", {
+            params: { path: { vectorStoreId: storeId } },
+            body: { file_id: fileId },
+            headers: this.headers(),
+        });
+        if (!response.data) {
+            return response;
+        }
+        return {
+            ...response,
+            data: toVectorStoreFile(response.data),
+        };
+    }
+    /**
+     * Remove a file from a vector store.
+     */
+    async removeFile(storeId, fileId) {
+        return this.client.DELETE("/v1/api/vector-stores/{vectorStoreId}/files/{fileId}", {
+            params: { path: { vectorStoreId: storeId, fileId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Bind a vector store to an agent.
+     */
+    async bindAgent(storeId, agentId) {
+        return this.client.POST("/v1/api/vector-stores/{vectorStoreId}/bind-agent", {
+            params: { path: { vectorStoreId: storeId } },
+            body: { agent_id: agentId },
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/workspaces.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Workspaces Module - Fully Typed
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+/** Event emitted by workspace-level SSE stream. */
+export interface WorkspaceEvent {
+    type: string;
+    workspace_id: string;
+    run_id?: string;
+    agent_id?: string;
+    old_status?: string;
+    new_status?: string;
+    ts: number;
+}
+/** Options for followEvents(). */
+export interface WorkspaceFollowOptions {
+    /** AbortSignal to kill the SSE connection. Required for cleanup. */
+    signal?: AbortSignal;
+}
+export interface Workspace {
+    id: string;
+    tenant_id: string;
+    name: string;
+    is_default: boolean;
+    settings?: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+}
+export interface WorkspaceListResponse {
+    items: Workspace[];
+    total: number;
+}
+export declare class WorkspacesModule {
+    private client;
+    private getTenantId;
+    private headers;
+    constructor(client: RawClient, getTenantId: () => string, headers: () => Record<string, string>);
+    /**
+     * List all workspaces.
+     */
+    list(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<WorkspaceListResponse>>;
+    /**
+     * Get a workspace by ID.
+     */
+    get(workspaceId: string): Promise<APIResponse<Workspace>>;
+    /**
+     * Create a new workspace.
+     */
+    create(body: {
+        name: string;
+        is_default?: boolean;
+    }): Promise<APIResponse<Workspace>>;
+    /**
+     * Update a workspace.
+     */
+    update(workspaceId: string, body: {
+        name?: string;
+    }): Promise<APIResponse<Workspace>>;
+    /**
+     * Delete a workspace.
+     */
+    delete(workspaceId: string): Promise<APIResponse<void>>;
+    /**
+     * Get workspace quotas.
+     */
+    getQuotas(workspaceId: string): Promise<APIResponse<WorkspaceQuotaResponse>>;
+    /**
+     * Get workspace usage.
+     */
+    getUsage(workspaceId: string, params?: {
+        from?: string;
+        to?: string;
+    }): Promise<APIResponse<WorkspaceUsageResponse>>;
+    /**
+     * Stream workspace events via SSE.
+     * Workspace identity flows via X-Workspace-Id header (same as all SDK methods).
+     *
+     * @param options - AbortSignal for cleanup (MUST be used to avoid leaking connections)
+     *
+     * @example
+     * ```ts
+     * const controller = new AbortController();
+     * for await (const event of client.workspaces.followEvents({ signal: controller.signal })) {
+     *   if (event.type === 'run_status_changed') {
+     *     console.log(`Run ${event.run_id} → ${event.new_status}`);
+     *   }
+     * }
+     * // On cleanup:
+     * controller.abort();
+     * ```
+     */
+    followEvents(options?: WorkspaceFollowOptions): AsyncGenerator<WorkspaceEvent, void, unknown>;
+}
+export interface WorkspaceQuotaResponse {
+    workspace_id: string;
+    quotas: {
+        runs_per_month: Quota;
+        tokens_per_month: Quota;
+        agents_max: Quota;
+        storage_mb: Quota;
+    };
+    reset_at: string;
+    source: string;
+}
+export interface Quota {
+    limit: number;
+    used: number;
+    remaining: number;
+}
+export interface WorkspaceUsageResponse {
+    workspace_id: string;
+    period: {
+        from: string;
+        to: string;
+    };
+    usage: {
+        total_runs: number;
+        completed_runs: number;
+        failed_runs: number;
+        total_tokens: number;
+        input_tokens: number;
+        output_tokens: number;
+        total_duration_ms: number;
+        estimated_count: number;
+    };
+    daily_breakdown: Array<{
+        date: string;
+        runs: number;
+        tokens_in: number;
+        tokens_out: number;
+        duration_ms: number;
+    }>;
+    source: string;
+}
+//# sourceMappingURL=workspaces.d.ts.map

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

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

package/dist/modules/workspaces.js

@@ -0,0 +1,121 @@
+/**
+ * Workspaces Module - Fully Typed
+ */
+import { parseSSE } from "../sse/client.js";
+export class WorkspacesModule {
+    client;
+    getTenantId;
+    headers;
+    constructor(client, getTenantId, headers) {
+        this.client = client;
+        this.getTenantId = getTenantId;
+        this.headers = headers;
+    }
+    /**
+     * List all workspaces.
+     */
+    async list(params) {
+        return this.client.GET("/v1/api/workspaces", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a workspace by ID.
+     */
+    async get(workspaceId) {
+        return this.client.GET("/v1/api/workspaces/{id}", {
+            params: { path: { id: workspaceId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create a new workspace.
+     */
+    async create(body) {
+        return this.client.POST("/v1/api/workspaces", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Update a workspace.
+     */
+    async update(workspaceId, body) {
+        return this.client.PUT("/v1/api/workspaces/{id}", {
+            params: { path: { id: workspaceId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Delete a workspace.
+     */
+    async delete(workspaceId) {
+        return this.client.DELETE("/v1/api/workspaces/{id}", {
+            params: { path: { id: workspaceId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get workspace quotas.
+     */
+    async getQuotas(workspaceId) {
+        return this.client.GET("/v1/api/workspaces/{workspaceId}/quotas", {
+            params: { path: { workspaceId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get workspace usage.
+     */
+    async getUsage(workspaceId, params) {
+        return this.client.GET("/v1/api/workspaces/{workspaceId}/usage", {
+            params: { path: { workspaceId }, query: params },
+            headers: this.headers(),
+        });
+    }
+    // ======================== FOLLOW (Workspace SSE) ========================
+    /**
+     * Stream workspace events via SSE.
+     * Workspace identity flows via X-Workspace-Id header (same as all SDK methods).
+     *
+     * @param options - AbortSignal for cleanup (MUST be used to avoid leaking connections)
+     *
+     * @example
+     * ```ts
+     * const controller = new AbortController();
+     * for await (const event of client.workspaces.followEvents({ signal: controller.signal })) {
+     *   if (event.type === 'run_status_changed') {
+     *     console.log(`Run ${event.run_id} → ${event.new_status}`);
+     *   }
+     * }
+     * // On cleanup:
+     * controller.abort();
+     * ```
+     */
+    async *followEvents(options) {
+        // Workspace identity flows via X-Workspace-Id header (set by this.headers()),
+        // consistent with all other SDK endpoints. No path param needed.
+        const response = await this.client.streamGet("/v1/api/workspaces/events/stream", {
+            headers: this.headers(),
+            signal: options?.signal,
+        });
+        try {
+            for await (const rawEvent of parseSSE(response)) {
+                if (rawEvent.data != null) {
+                    yield rawEvent.data;
+                }
+            }
+        }
+        catch (err) {
+            // Abort is normal cleanup — not an error worth surfacing.
+            // Check both signal state and error name (covers proxy/wrapper edge cases).
+            if (options?.signal?.aborted)
+                return;
+            if (err instanceof Error && err.name === "AbortError")
+                return;
+            throw err;
+        }
+    }
+}