@agent-os-sdk/client 0.1.0

package/README.md

@@ -0,0 +1,71 @@
+# Agent OS SDK
+
+Internal typed SDK for Agent OS platform. Generated from Swagger.
+
+## Setup
+
+```bash
+cd sdk/agent-os-sdk
+pnpm install
+```
+
+## Generate Types
+
+Ensure backend is running, then:
+
+```bash
+pnpm generate
+```
+
+This downloads `swagger.json` and generates TypeScript types.
+
+## Build
+
+```bash
+pnpm build
+```
+
+## Usage in Frontend
+
+```ts
+import { AgentOsClient } from "@agent-os/sdk";
+
+const api = new AgentOsClient({
+  baseUrl: import.meta.env.VITE_API_URL,
+  tenantId: auth.tenantId,
+  workspaceId: auth.workspaceId,
+  token: auth.token,
+});
+
+// Create and stream a run
+for await (const event of api.runs.createAndStream({
+  agent_id: "...",
+  input: { message: "Hello" },
+})) {
+  console.log(event.type, event.data);
+}
+
+// Thread state
+const state = await api.threads.getState(threadId);
+
+// Resume HITL
+await api.runs.resume(runId, { approved: true });
+```
+
+## Modules
+
+| Module | Description |
+|--------|-------------|
+| `agents` | Agent CRUD, versions, graph |
+| `runs` | Execution, streaming, HITL |
+| `threads` | Conversations, messages, state |
+| `tools` | Tool definitions registry |
+| `knowledge` | Vector stores, RAG |
+| `triggers` | Webhooks, crons |
+| `credentials` | BYOK secrets |
+
+## Rule
+
+> ❌ **NEVER** use `fetch`, `axios`, or `ky` in frontend.
+> 
+> ✅ **ALWAYS** use `AgentOsClient`.

package/dist/client/AgentOsClient.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Agent OS SDK - Main Client
+ *
+ * Fully typed API client for Agent OS platform.
+ * All HTTP calls must go through this client.
+ *
+ * @example
+ * ```ts
+ * const api = new AgentOsClient({
+ *   baseUrl: "http://localhost:5000",
+ *   tenantId: "...",
+ *   workspaceId: "...",
+ *   token: "...",
+ * });
+ *
+ * const run = await api.runs.create({
+ *   agent_id: "...",
+ *   input: { message: "Hello" },
+ * });
+ * ```
+ */
+import { type RawClient } from "./raw.js";
+import { AgentsModule } from "../modules/agents.js";
+import { RunsModule } from "../modules/runs.js";
+import { ThreadsModule } from "../modules/threads.js";
+import { ToolsModule } from "../modules/tools.js";
+import { KnowledgeModule } from "../modules/knowledge.js";
+import { TriggersModule } from "../modules/triggers.js";
+import { CredentialsModule } from "../modules/credentials.js";
+import { BuilderModule } from "../modules/builder.js";
+import { MembersModule } from "../modules/members.js";
+import { TenantsModule } from "../modules/tenants.js";
+import { WorkspacesModule } from "../modules/workspaces.js";
+import { PromptsModule } from "../modules/prompts.js";
+import { TracesModule } from "../modules/traces.js";
+import { FilesModule } from "../modules/files.js";
+import { VectorStoresModule } from "../modules/vectorStores.js";
+import { EvaluationModule } from "../modules/evaluation.js";
+import { CheckpointsModule } from "../modules/checkpoints.js";
+import { PlaygroundModule } from "../modules/playground.js";
+import { CronsModule } from "../modules/crons.js";
+import { DlqModule } from "../modules/dlq.js";
+import { StoreModule } from "../modules/store.js";
+import { AuditModule } from "../modules/audit.js";
+import { UsageModule } from "../modules/usage.js";
+import { McpModule } from "../modules/mcp.js";
+import { A2aModule } from "../modules/a2a.js";
+import { MeModule } from "../modules/me.js";
+import { InfoModule } from "../modules/info.js";
+import { MetricsModule } from "../modules/metrics.js";
+import { GraphsModule } from "../modules/graphs.js";
+export type AgentOsClientOptions = {
+    /** Base URL of the Agent OS API */
+    baseUrl: string;
+    /** Tenant ID (multi-tenant) */
+    tenantId: string;
+    /** Workspace ID */
+    workspaceId: string;
+    /** Optional auth token */
+    token?: string;
+    /** Optional member ID (for identity header) */
+    memberId?: string;
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** Kernel base URL (for meta-agent, different from control plane) */
+    kernelBaseUrl?: string;
+};
+export declare class AgentOsClient {
+    private readonly _client;
+    private readonly _baseUrl;
+    private readonly _tenantId;
+    private readonly _workspaceId;
+    private readonly _token?;
+    private readonly _memberId?;
+    private readonly _customHeaders;
+    private readonly _kernelBaseUrl;
+    /** Agents API: CRUD, versions, graph */
+    readonly agents: AgentsModule;
+    /** Runs API: create, stream, cancel, resume, replay */
+    readonly runs: RunsModule;
+    /** Threads API: conversations, state, messages */
+    readonly threads: ThreadsModule;
+    /** Tools API: definitions, registry */
+    readonly tools: ToolsModule;
+    /** Knowledge API: vector stores, RAG */
+    readonly knowledge: KnowledgeModule;
+    /** Triggers API: webhooks, crons */
+    readonly triggers: TriggersModule;
+    /** Credentials API: BYOK secrets */
+    readonly credentials: CredentialsModule;
+    /** Builder API: Meta-agent for AI-assisted agent creation */
+    readonly builder: BuilderModule;
+    /** Members API: Tenant member management */
+    readonly members: MembersModule;
+    /** Tenants API: Tenant settings */
+    readonly tenants: TenantsModule;
+    /** Workspaces API: Workspace management */
+    readonly workspaces: WorkspacesModule;
+    /** Prompts API: Prompt Hub CMS */
+    readonly prompts: PromptsModule;
+    /** Traces API: OTEL observability */
+    readonly traces: TracesModule;
+    /** Files API: S3 file storage */
+    readonly files: FilesModule;
+    /** VectorStores API: pgvector semantic search */
+    readonly vectorStores: VectorStoresModule;
+    /** Evaluation API: Datasets & experiments */
+    readonly evaluation: EvaluationModule;
+    /** Checkpoints API: Time-travel debugging */
+    readonly checkpoints: CheckpointsModule;
+    /** Playground API: Ephemeral sandbox */
+    readonly playground: PlaygroundModule;
+    /** Crons API: Cron job scheduling */
+    readonly crons: CronsModule;
+    /** DLQ API: Dead letter queue */
+    readonly dlq: DlqModule;
+    /** Store API: Key-value storage */
+    readonly store: StoreModule;
+    /** Audit API: Audit logs */
+    readonly audit: AuditModule;
+    /** Usage API: Quotas and usage */
+    readonly usage: UsageModule;
+    /** MCP API: Model Context Protocol */
+    readonly mcp: McpModule;
+    /** A2A API: Agent-to-Agent protocol */
+    readonly a2a: A2aModule;
+    /** Me API: Current user identity */
+    readonly me: MeModule;
+    /** Info API: Server information */
+    readonly info: InfoModule;
+    /** Metrics API: Prometheus metrics */
+    readonly metrics: MetricsModule;
+    /** Graphs API: Validation and introspection */
+    readonly graphs: GraphsModule;
+    /**
+     * Alias for evaluation.listExperiments() - provides first-level access to experiments
+     * @example client.experiments.list() // same as client.evaluation.listExperiments()
+     */
+    readonly experiments: {
+        list: EvaluationModule["listExperiments"];
+        get: EvaluationModule["getExperiment"];
+        create: EvaluationModule["createExperiment"];
+    };
+    /**
+     * Alias for agents.listVersions() - provides first-level access to agent versions
+     */
+    readonly agentVersions: {
+        list: (agentId: string) => ReturnType<AgentsModule["listVersions"]>;
+        get: (agentId: string, versionId: string) => ReturnType<AgentsModule["getVersion"]>;
+        create: (agentId: string, body: Parameters<AgentsModule["createVersion"]>[1]) => ReturnType<AgentsModule["createVersion"]>;
+    };
+    constructor(options: AgentOsClientOptions);
+    private _getHeaders;
+    /** Current tenant ID */
+    get tenantId(): string;
+    /** Current workspace ID */
+    get workspaceId(): string;
+    /** Raw HTTP client (use modules instead) */
+    get raw(): RawClient;
+}
+//# sourceMappingURL=AgentOsClient.d.ts.map

package/dist/client/AgentOsClient.d.ts.map

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

package/dist/client/AgentOsClient.js

@@ -0,0 +1,217 @@
+/**
+ * Agent OS SDK - Main Client
+ *
+ * Fully typed API client for Agent OS platform.
+ * All HTTP calls must go through this client.
+ *
+ * @example
+ * ```ts
+ * const api = new AgentOsClient({
+ *   baseUrl: "http://localhost:5000",
+ *   tenantId: "...",
+ *   workspaceId: "...",
+ *   token: "...",
+ * });
+ *
+ * const run = await api.runs.create({
+ *   agent_id: "...",
+ *   input: { message: "Hello" },
+ * });
+ * ```
+ */
+import { createRawClient } from "./raw.js";
+import { AgentsModule } from "../modules/agents.js";
+import { RunsModule } from "../modules/runs.js";
+import { ThreadsModule } from "../modules/threads.js";
+import { ToolsModule } from "../modules/tools.js";
+import { KnowledgeModule } from "../modules/knowledge.js";
+import { TriggersModule } from "../modules/triggers.js";
+import { CredentialsModule } from "../modules/credentials.js";
+import { BuilderModule } from "../modules/builder.js";
+import { MembersModule } from "../modules/members.js";
+import { TenantsModule } from "../modules/tenants.js";
+import { WorkspacesModule } from "../modules/workspaces.js";
+// New modules
+import { PromptsModule } from "../modules/prompts.js";
+import { TracesModule } from "../modules/traces.js";
+import { FilesModule } from "../modules/files.js";
+import { VectorStoresModule } from "../modules/vectorStores.js";
+import { EvaluationModule } from "../modules/evaluation.js";
+import { CheckpointsModule } from "../modules/checkpoints.js";
+import { PlaygroundModule } from "../modules/playground.js";
+import { CronsModule } from "../modules/crons.js";
+import { DlqModule } from "../modules/dlq.js";
+import { StoreModule } from "../modules/store.js";
+import { AuditModule } from "../modules/audit.js";
+import { UsageModule } from "../modules/usage.js";
+import { McpModule } from "../modules/mcp.js";
+import { A2aModule } from "../modules/a2a.js";
+import { MeModule } from "../modules/me.js";
+import { InfoModule } from "../modules/info.js";
+import { MetricsModule } from "../modules/metrics.js";
+import { GraphsModule } from "../modules/graphs.js";
+export class AgentOsClient {
+    _client;
+    _baseUrl;
+    _tenantId;
+    _workspaceId;
+    _token;
+    _memberId;
+    _customHeaders;
+    _kernelBaseUrl;
+    // Core modules
+    /** Agents API: CRUD, versions, graph */
+    agents;
+    /** Runs API: create, stream, cancel, resume, replay */
+    runs;
+    /** Threads API: conversations, state, messages */
+    threads;
+    /** Tools API: definitions, registry */
+    tools;
+    /** Knowledge API: vector stores, RAG */
+    knowledge;
+    /** Triggers API: webhooks, crons */
+    triggers;
+    /** Credentials API: BYOK secrets */
+    credentials;
+    /** Builder API: Meta-agent for AI-assisted agent creation */
+    builder;
+    /** Members API: Tenant member management */
+    members;
+    /** Tenants API: Tenant settings */
+    tenants;
+    /** Workspaces API: Workspace management */
+    workspaces;
+    // New modules
+    /** Prompts API: Prompt Hub CMS */
+    prompts;
+    /** Traces API: OTEL observability */
+    traces;
+    /** Files API: S3 file storage */
+    files;
+    /** VectorStores API: pgvector semantic search */
+    vectorStores;
+    /** Evaluation API: Datasets & experiments */
+    evaluation;
+    /** Checkpoints API: Time-travel debugging */
+    checkpoints;
+    /** Playground API: Ephemeral sandbox */
+    playground;
+    /** Crons API: Cron job scheduling */
+    crons;
+    /** DLQ API: Dead letter queue */
+    dlq;
+    /** Store API: Key-value storage */
+    store;
+    /** Audit API: Audit logs */
+    audit;
+    /** Usage API: Quotas and usage */
+    usage;
+    /** MCP API: Model Context Protocol */
+    mcp;
+    /** A2A API: Agent-to-Agent protocol */
+    a2a;
+    /** Me API: Current user identity */
+    me;
+    /** Info API: Server information */
+    info;
+    /** Metrics API: Prometheus metrics */
+    metrics;
+    /** Graphs API: Validation and introspection */
+    graphs;
+    // ======================== Convenience Aliases ========================
+    /**
+     * Alias for evaluation.listExperiments() - provides first-level access to experiments
+     * @example client.experiments.list() // same as client.evaluation.listExperiments()
+     */
+    experiments;
+    /**
+     * Alias for agents.listVersions() - provides first-level access to agent versions
+     */
+    agentVersions;
+    constructor(options) {
+        this._baseUrl = options.baseUrl;
+        this._kernelBaseUrl = options.kernelBaseUrl ?? options.baseUrl.replace(':5000', ':8001');
+        this._tenantId = options.tenantId;
+        this._workspaceId = options.workspaceId;
+        this._token = options.token;
+        this._memberId = options.memberId;
+        this._customHeaders = options.headers ?? {};
+        this._client = createRawClient({
+            baseUrl: options.baseUrl,
+            headers: this._getHeaders(),
+        });
+        const getHeaders = () => this._getHeaders();
+        const getWorkspaceId = () => this._workspaceId;
+        const getTenantId = () => this._tenantId;
+        // Initialize core modules
+        this.agents = new AgentsModule(this._client, getHeaders);
+        this.runs = new RunsModule(this._client, this._baseUrl, getHeaders);
+        this.threads = new ThreadsModule(this._client, getHeaders);
+        this.tools = new ToolsModule(this._client, getHeaders);
+        this.knowledge = new KnowledgeModule(this._client, getWorkspaceId, getHeaders);
+        this.triggers = new TriggersModule(this._client, getHeaders);
+        this.credentials = new CredentialsModule(this._client, getWorkspaceId, getHeaders);
+        this.builder = new BuilderModule(this._kernelBaseUrl, getHeaders);
+        this.members = new MembersModule(this._client, getHeaders);
+        this.tenants = new TenantsModule(this._client, getHeaders);
+        this.workspaces = new WorkspacesModule(this._client, getTenantId, getHeaders);
+        // Initialize new modules
+        this.prompts = new PromptsModule(this._client, getHeaders);
+        this.traces = new TracesModule(this._client, getHeaders);
+        this.files = new FilesModule(this._client, getHeaders);
+        this.vectorStores = new VectorStoresModule(this._client, getHeaders);
+        this.evaluation = new EvaluationModule(this._client, getHeaders);
+        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);
+        this.mcp = new McpModule(this._client, getHeaders);
+        this.a2a = new A2aModule(this._client, getHeaders);
+        this.me = new MeModule(this._client, getHeaders);
+        this.info = new InfoModule(this._client, getHeaders);
+        this.metrics = new MetricsModule(this._baseUrl, getHeaders);
+        this.graphs = new GraphsModule(this._client, getHeaders);
+        // Initialize convenience aliases
+        this.experiments = {
+            list: this.evaluation.listExperiments.bind(this.evaluation),
+            get: this.evaluation.getExperiment.bind(this.evaluation),
+            create: this.evaluation.createExperiment.bind(this.evaluation),
+        };
+        this.agentVersions = {
+            list: (agentId) => this.agents.listVersions(agentId),
+            get: (agentId, versionId) => this.agents.getVersion(agentId, versionId),
+            create: (agentId, body) => this.agents.createVersion(agentId, body),
+        };
+    }
+    _getHeaders() {
+        const headers = {
+            "Content-Type": "application/json",
+            "X-Tenant-Id": this._tenantId,
+            "X-Workspace-Id": this._workspaceId,
+            ...this._customHeaders,
+        };
+        if (this._token) {
+            headers["Authorization"] = `Bearer ${this._token}`;
+        }
+        if (this._memberId) {
+            headers["X-Member-Id"] = this._memberId;
+        }
+        return headers;
+    }
+    /** Current tenant ID */
+    get tenantId() {
+        return this._tenantId;
+    }
+    /** Current workspace ID */
+    get workspaceId() {
+        return this._workspaceId;
+    }
+    /** Raw HTTP client (use modules instead) */
+    get raw() {
+        return this._client;
+    }
+}

package/dist/client/helpers.d.ts

@@ -0,0 +1,63 @@
+/**
+ * SDK Helper Types and Functions
+ *
+ * Provides utilities for working with API responses.
+ */
+import type { APIResponse } from "./raw.js";
+/**
+ * Standard pagination parameters used across all list endpoints.
+ * Extends Record to be compatible with query parameter types.
+ */
+export interface PaginationParams extends Record<string, unknown> {
+    /** Maximum number of items to return (default: 20) */
+    limit?: number;
+    /** Number of items to skip (default: 0) */
+    offset?: number;
+}
+/**
+ * Paginated list response wrapper.
+ */
+export interface PaginatedResponse<T> {
+    items: T[];
+    total: number;
+}
+/**
+ * SDK-specific error class with structured error data.
+ */
+export declare class SDKError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly details?: unknown;
+    constructor(response: APIResponse<unknown>);
+}
+/**
+ * Unwraps an APIResponse, returning the data directly or throwing on error.
+ * Use this when you want the cleaner "throws on error" pattern.
+ *
+ * @example
+ * ```ts
+ * // Instead of:
+ * const { data, error } = await client.agents.list();
+ * if (error) throw new Error(error.message);
+ *
+ * // Use:
+ * const agents = await unwrap(client.agents.list());
+ * ```
+ */
+export declare function unwrap<T>(promise: Promise<APIResponse<T>>): Promise<T>;
+/**
+ * Type helper for unwrapped responses.
+ */
+export type Unwrapped<T> = T extends APIResponse<infer U> ? U : never;
+export type Result<T, E = SDKError> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+/**
+ * Converts an APIResponse to a Result type for pattern matching.
+ */
+export declare function toResult<T>(promise: Promise<APIResponse<T>>): Promise<Result<T>>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/client/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/client/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAM5C;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACjB;AAMD;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC;CAQ7C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAM5E;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAMtE,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,IAC5B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAEnC;;GAEG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAMtF"}

package/dist/client/helpers.js

@@ -0,0 +1,55 @@
+/**
+ * SDK Helper Types and Functions
+ *
+ * Provides utilities for working with API responses.
+ */
+// ============================================================================
+// Error Handling
+// ============================================================================
+/**
+ * SDK-specific error class with structured error data.
+ */
+export class SDKError extends Error {
+    code;
+    status;
+    details;
+    constructor(response) {
+        const message = response.error?.message || `HTTP ${response.response.status}`;
+        super(message);
+        this.name = "SDKError";
+        this.code = response.error?.code || `HTTP_${response.response.status}`;
+        this.status = response.response.status;
+        this.details = response.error?.details;
+    }
+}
+/**
+ * Unwraps an APIResponse, returning the data directly or throwing on error.
+ * Use this when you want the cleaner "throws on error" pattern.
+ *
+ * @example
+ * ```ts
+ * // Instead of:
+ * const { data, error } = await client.agents.list();
+ * if (error) throw new Error(error.message);
+ *
+ * // Use:
+ * const agents = await unwrap(client.agents.list());
+ * ```
+ */
+export async function unwrap(promise) {
+    const result = await promise;
+    if (result.error || !result.data) {
+        throw new SDKError(result);
+    }
+    return result.data;
+}
+/**
+ * Converts an APIResponse to a Result type for pattern matching.
+ */
+export async function toResult(promise) {
+    const result = await promise;
+    if (result.error || !result.data) {
+        return { success: false, error: new SDKError(result) };
+    }
+    return { success: true, data: result.data };
+}