@agent-os-sdk/client 0.9.26 → 0.9.28

package/dist/modules/evaluation.js

@@ -0,0 +1,108 @@
+/**
+ * Evaluation Module - Fully Typed
+ */
+export class EvaluationModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    // ======================== Datasets ========================
+    /**
+     * List all evaluation datasets.
+     */
+    async listDatasets(params) {
+        return this.client.GET("/v1/api/evaluations/datasets", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a dataset by ID.
+     */
+    async getDataset(datasetId) {
+        return this.client.GET("/v1/api/evaluations/datasets/{id}", {
+            params: { path: { id: datasetId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create a new dataset.
+     */
+    async createDataset(body) {
+        return this.client.POST("/v1/api/evaluations/datasets", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Delete a dataset.
+     */
+    async deleteDataset(datasetId) {
+        return this.client.DELETE("/v1/api/evaluations/datasets/{id}", {
+            params: { path: { id: datasetId } },
+            headers: this.headers(),
+        });
+    }
+    // ======================== Examples ========================
+    /**
+     * List examples in a dataset.
+     */
+    async listExamples(datasetId, params) {
+        return this.client.GET("/v1/api/evaluations/datasets/{id}/examples", {
+            params: { path: { id: datasetId }, query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Add examples to a dataset.
+     */
+    async addExamples(datasetId, examples) {
+        return this.client.POST("/v1/api/evaluations/datasets/{id}/examples", {
+            params: { path: { id: datasetId } },
+            body: { examples },
+            headers: this.headers(),
+        });
+    }
+    // ======================== Experiments ========================
+    /**
+     * List all experiments.
+     */
+    async listExperiments(params) {
+        return this.client.GET("/v1/api/evaluations/experiments", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get an experiment by ID.
+     */
+    async getExperiment(experimentId) {
+        return this.client.GET("/v1/api/evaluations/experiments/{id}", {
+            params: { path: { id: experimentId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create a new experiment.
+     */
+    async createExperiment(body) {
+        return this.client.POST("/v1/api/evaluations/experiments", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    async listKpiAggregates(params) {
+        return this.client.GET("/v1/api/evaluations/kpi-results/aggregates", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    async listKpiAlerts(params) {
+        return this.client.GET("/v1/api/evaluations/kpi-results/alerts", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/files.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Files Module - Fully Typed
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface StoredFile {
+    id: string;
+    filename: string;
+    content_type: string;
+    size_bytes: number;
+    sha256?: string;
+    status: "pending" | "confirmed" | "deleted";
+    created_at: string;
+    updated_at?: string;
+}
+export interface FileListResponse {
+    items: StoredFile[];
+    total: number;
+}
+export interface PresignedUpload {
+    file_id: string;
+    upload_url: string;
+    expires_in: number;
+    object_key: string;
+}
+export interface ConfirmedUpload {
+    file_id: string;
+    status: string;
+    size_bytes: number;
+    sha256?: string;
+}
+export interface PresignedDownload {
+    file_id: string;
+    download_url: string;
+    filename: string;
+    content_type: string;
+    size_bytes: number;
+    expires_in: number;
+}
+export declare class FilesModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    private resolveWorkspaceId;
+    private static toStoredFile;
+    /**
+     * List files in a workspace.
+     */
+    list(params?: {
+        workspace_id?: string;
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<FileListResponse>>;
+    /**
+     * Get a file by ID.
+     */
+    get(fileId: string, workspaceId?: string): Promise<APIResponse<StoredFile>>;
+    /**
+     * Create a presigned upload URL.
+     */
+    createUpload(body: {
+        filename: string;
+        content_type?: string;
+        size_bytes?: number;
+        expected_sha256?: string;
+    }, workspaceId?: string): Promise<APIResponse<PresignedUpload>>;
+    /**
+     * Confirm an upload.
+     */
+    confirmUpload(fileId: string, sha256?: string, workspaceId?: string): Promise<APIResponse<ConfirmedUpload>>;
+    /**
+     * Get a presigned download URL.
+     */
+    getDownloadUrl(fileId: string, workspaceId?: string): Promise<APIResponse<PresignedDownload>>;
+    /**
+     * Delete a file.
+     */
+    delete(fileId: string, workspaceId?: string): Promise<APIResponse<void>>;
+    /**
+     * Alias for createUpload with explicit semantic name.
+     */
+    createPresignedUpload(body: {
+        filename: string;
+        content_type?: string;
+        size_bytes?: number;
+        expected_sha256?: string;
+    }, workspaceId?: string): Promise<APIResponse<PresignedUpload>>;
+}
+//# sourceMappingURL=files.d.ts.map

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

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

package/dist/modules/files.js

@@ -0,0 +1,133 @@
+/**
+ * Files Module - Fully Typed
+ */
+export class FilesModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    resolveWorkspaceId(workspaceId) {
+        if (workspaceId && workspaceId.trim().length > 0) {
+            return workspaceId.trim();
+        }
+        const headers = this.headers();
+        const fromHeader = headers["X-Workspace-Id"] ?? headers["x-workspace-id"];
+        if (fromHeader && fromHeader.trim().length > 0) {
+            return fromHeader.trim();
+        }
+        throw new Error("workspace_id is required (pass workspaceId or set X-Workspace-Id in client headers)");
+    }
+    static toStoredFile(item) {
+        return {
+            id: item.id ?? "",
+            filename: item.filename ?? "",
+            content_type: item.content_type ?? "application/octet-stream",
+            size_bytes: item.size_bytes ?? 0,
+            sha256: "sha256" in item ? item.sha256 ?? undefined : undefined,
+            status: (item.status ?? "pending"),
+            created_at: item.created_at ?? "",
+            updated_at: "updated_at" in item ? item.updated_at ?? undefined : undefined,
+        };
+    }
+    /**
+     * List files in a workspace.
+     */
+    async list(params) {
+        const workspaceId = this.resolveWorkspaceId(params?.workspace_id);
+        const response = await this.client.GET("/v1/api/workspaces/{workspaceId}/files", {
+            params: {
+                path: { workspaceId },
+                query: {
+                    status: params?.status,
+                    limit: params?.limit,
+                    offset: params?.offset,
+                },
+            },
+            headers: this.headers(),
+        });
+        const items = Array.isArray(response.data)
+            ? response.data.map((item) => FilesModule.toStoredFile(item))
+            : [];
+        return {
+            ...response,
+            data: {
+                items,
+                total: items.length,
+            },
+        };
+    }
+    /**
+     * Get a file by ID.
+     */
+    async get(fileId, workspaceId) {
+        const resolvedWorkspaceId = this.resolveWorkspaceId(workspaceId);
+        const response = await this.client.GET("/v1/api/workspaces/{workspaceId}/files/{fileId}", {
+            params: { path: { workspaceId: resolvedWorkspaceId, fileId } },
+            headers: this.headers(),
+        });
+        if (!response.data) {
+            return response;
+        }
+        return {
+            ...response,
+            data: FilesModule.toStoredFile(response.data),
+        };
+    }
+    /**
+     * Create a presigned upload URL.
+     */
+    async createUpload(body, workspaceId) {
+        const resolvedWorkspaceId = this.resolveWorkspaceId(workspaceId);
+        const requestBody = {
+            filename: body.filename,
+            content_type: body.content_type,
+            size_bytes: body.size_bytes,
+            expected_sha256: body.expected_sha256,
+        };
+        return this.client.POST("/v1/api/workspaces/{workspaceId}/files/presign", {
+            params: { path: { workspaceId: resolvedWorkspaceId } },
+            body: requestBody,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Confirm an upload.
+     */
+    async confirmUpload(fileId, sha256, workspaceId) {
+        const resolvedWorkspaceId = this.resolveWorkspaceId(workspaceId);
+        const requestBody = { sha256 };
+        return this.client.POST("/v1/api/workspaces/{workspaceId}/files/{fileId}/confirm", {
+            params: { path: { workspaceId: resolvedWorkspaceId, fileId } },
+            body: requestBody,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a presigned download URL.
+     */
+    async getDownloadUrl(fileId, workspaceId) {
+        const resolvedWorkspaceId = this.resolveWorkspaceId(workspaceId);
+        return this.client.GET("/v1/api/workspaces/{workspaceId}/files/{fileId}/download", {
+            params: { path: { workspaceId: resolvedWorkspaceId, fileId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Delete a file.
+     */
+    async delete(fileId, workspaceId) {
+        const resolvedWorkspaceId = this.resolveWorkspaceId(workspaceId);
+        return this.client.DELETE("/v1/api/workspaces/{workspaceId}/files/{fileId}", {
+            params: { path: { workspaceId: resolvedWorkspaceId, fileId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Alias for createUpload with explicit semantic name.
+     */
+    async createPresignedUpload(body, workspaceId) {
+        return this.createUpload(body, workspaceId);
+    }
+}

package/dist/modules/graphs.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Graphs Module - V2 Graph Specification Management
+ *
+ * Pure V2 contract - no legacy. All types namespaced with "Graphs" prefix.
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface GraphsValidationMessage {
+    code: string;
+    message: string;
+    path?: string;
+    node_id?: string;
+    severity?: "error" | "warning";
+}
+export interface GraphsValidationResult {
+    valid: boolean;
+    errors?: GraphsValidationMessage[];
+}
+export interface GraphsGetResponse {
+    agent_id: string;
+    revision: string;
+    canonical_spec: unknown;
+    committed_at: string;
+    warnings?: GraphsValidationMessage[];
+    validation?: GraphsValidationResult;
+}
+export interface GraphsCommitRequest {
+    agent_id: string;
+    graph_spec: unknown;
+    expected_revision?: string;
+    source?: string;
+}
+export type GraphsCommitStatus = "committed" | "no_change";
+export interface GraphsCommitResponse {
+    status: GraphsCommitStatus;
+    agent_id: string;
+    revision: string;
+    canonical_spec: unknown;
+    committed_at: string;
+    warnings?: GraphsValidationMessage[];
+    validation?: GraphsValidationResult;
+}
+export interface GraphsConflictPayload {
+    hint: "reload_and_retry";
+    expected_revision: string;
+    current: GraphsGetResponse;
+}
+export interface GraphsRevisionSummary {
+    revision: string;
+    created_at: string;
+    source?: string;
+}
+export interface GraphsRevisionsListResponse {
+    agent_id: string;
+    revisions: GraphsRevisionSummary[];
+}
+export interface GraphsRevisionResponse {
+    revision: string;
+    canonical_spec: unknown;
+    created_at: string;
+    source?: string;
+    warnings?: GraphsValidationMessage[];
+    validation?: GraphsValidationResult;
+}
+export interface GraphsValidateRequest {
+    graph_spec: unknown;
+    normalize?: boolean;
+    catalog_versions?: Record<string, string>;
+}
+export interface GraphsValidateResponse {
+    valid: boolean;
+    canonical_spec_json?: string;
+    mermaid?: string;
+    nodes?: string[];
+    edges?: [string, string][];
+    errors?: GraphsValidationMessage[];
+    warnings?: GraphsValidationMessage[];
+}
+export interface GraphsIntrospectRequest {
+    agent_id?: string;
+    graph_spec?: unknown;
+    catalog_versions?: Record<string, string>;
+}
+export interface GraphsIntrospectResponse {
+    mermaid: string;
+    nodes: string[];
+    edges: [string, string][];
+    type?: string;
+}
+export declare class GraphsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * Get current graph spec by revision.
+     * @returns 200 with graph spec, or 404 if not initialized
+     */
+    get(agentId: string): Promise<APIResponse<GraphsGetResponse>>;
+    /**
+     * Commit graph spec atomically.
+     * @returns 200 (committed/no_change), or 409 on conflict
+     */
+    commit(request: GraphsCommitRequest): Promise<APIResponse<GraphsCommitResponse>>;
+    /**
+     * List revision history for an agent.
+     */
+    listRevisions(agentId: string): Promise<APIResponse<GraphsRevisionsListResponse>>;
+    /**
+     * Get a specific revision.
+     */
+    getRevision(agentId: string, revision: string): Promise<APIResponse<GraphsRevisionResponse>>;
+    /**
+     * Validate a graph specification.
+     */
+    validate(body: GraphsValidateRequest): Promise<APIResponse<GraphsValidateResponse>>;
+    /**
+     * Introspect a graph structure.
+     */
+    introspect(body: GraphsIntrospectRequest): Promise<APIResponse<GraphsIntrospectResponse>>;
+}
+//# sourceMappingURL=graphs.d.ts.map

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

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

package/dist/modules/graphs.js

@@ -0,0 +1,69 @@
+/**
+ * Graphs Module - V2 Graph Specification Management
+ *
+ * Pure V2 contract - no legacy. All types namespaced with "Graphs" prefix.
+ */
+// ============ Module ============
+export class GraphsModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    // ============ V2 Graph Spec (CP) ============
+    /**
+     * Get current graph spec by revision.
+     * @returns 200 with graph spec, or 404 if not initialized
+     */
+    async get(agentId) {
+        return this.client.GET(`/v1/api/graph/${agentId}`, {
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Commit graph spec atomically.
+     * @returns 200 (committed/no_change), or 409 on conflict
+     */
+    async commit(request) {
+        return this.client.POST("/v1/api/graph/commit", {
+            body: request,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * List revision history for an agent.
+     */
+    async listRevisions(agentId) {
+        return this.client.GET(`/v1/api/graph/${agentId}/revisions`, {
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a specific revision.
+     */
+    async getRevision(agentId, revision) {
+        return this.client.GET(`/v1/api/graph/${agentId}/revisions/${revision}`, {
+            headers: this.headers(),
+        });
+    }
+    // ============ Validation (DP proxy) ============
+    /**
+     * Validate a graph specification.
+     */
+    async validate(body) {
+        return this.client.POST("/v1/api/graphs/validate", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Introspect a graph structure.
+     */
+    async introspect(body) {
+        return this.client.POST("/v1/api/graphs/introspect", {
+            body,
+            headers: this.headers(),
+        });
+    }
+}

package/{src/modules/improvements.ts → dist/modules/improvements.d.ts}

@@ -1,5 +1,4 @@
 import type { APIResponse, RawClient } from "../client/raw.js";
-
 export interface ImprovementCase {
     id: string;
     tenant_id: string;
@@ -32,40 +31,22 @@ export interface ImprovementCase {
     rejected_at?: string | null;
     rolled_back_at?: string | null;
 }
-
 export interface ImprovementCaseListResponse {
     items: ImprovementCase[];
     total: number;
     skip: number;
     take: number;
 }
-
-export class ImprovementsModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) {}
-
-    async list(params?: {
+export declare class ImprovementsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    list(params?: {
         agentId?: string;
         status?: string;
         skip?: number;
         take?: number;
-    }): Promise<APIResponse<ImprovementCaseListResponse>> {
-        return this.client.GET<ImprovementCaseListResponse>("/v1/api/improvements/cases", {
-            params: {
-                query: {
-                    agentId: params?.agentId,
-                    status: params?.status,
-                    skip: params?.skip,
-                    take: params?.take,
-                },
-            },
-            headers: this.headers(),
-        });
-    }
-
-    async get(caseId: string): Promise<APIResponse<ImprovementCase>> {
-        return this.client.GET<ImprovementCase>("/v1/api/improvements/cases/{caseId}", {
-            params: { path: { caseId } },
-            headers: this.headers(),
-        });
-    }
+    }): Promise<APIResponse<ImprovementCaseListResponse>>;
+    get(caseId: string): Promise<APIResponse<ImprovementCase>>;
 }
+//# sourceMappingURL=improvements.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"improvements.d.ts","sourceRoot":"","sources":["../../src/modules/improvements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,yBAAyB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,+BAA+B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,yBAAyB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,yBAAyB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,2BAA2B;IACxC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,kBAAkB;IACf,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAE9E,IAAI,CAAC,MAAM,CAAC,EAAE;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAc/C,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;CAMnE"}

package/dist/modules/improvements.js

@@ -0,0 +1,27 @@
+export class ImprovementsModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    async list(params) {
+        return this.client.GET("/v1/api/improvements/cases", {
+            params: {
+                query: {
+                    agentId: params?.agentId,
+                    status: params?.status,
+                    skip: params?.skip,
+                    take: params?.take,
+                },
+            },
+            headers: this.headers(),
+        });
+    }
+    async get(caseId) {
+        return this.client.GET("/v1/api/improvements/cases/{caseId}", {
+            params: { path: { caseId } },
+            headers: this.headers(),
+        });
+    }
+}