@agent-os-sdk/client 0.9.25 → 0.9.27

package/src/modules/agents.ts

@@ -1,604 +0,0 @@
-/**
- * Agents Module - Fully Typed
- * 
- * Naming conventions:
- * - get* for singular items: getAgent(id)
- * - list* for collections: listAgents()
- * - create*, update*, delete* for mutations
- */
-
-import type { PaginatedResponse, PaginationParams } from "../client/helpers.js";
-import type { APIResponse, components, RawClient } from "../client/raw.js";
-
-// Type aliases for this module
-
-type AgentSchema = components["schemas"]["AgentExportAgent"];
-// Bundle types from schema
-type AgentBundleSchema = components["schemas"]["AgentExportBundle"];
-
-// Response types
-export interface Agent {
-    id: string;
-    name: string;
-    workspace_id: string;
-    tenant_id: string;
-    created_at: string;
-    updated_at: string;
-    live_bundle_id?: string | null;
-    // Dashboard fields (P1 fix)
-    status?: "live" | "draft";
-    has_draft?: boolean;
-    last_run_id?: string | null;
-    last_run_status?: string | null;
-    last_run_at?: string | null;
-    metadata?: any | null;
-}
-
-export interface AgentBundle extends AgentBundleSchema { }
-
-export interface ImportAgentResponse {
-    agent_id: string;
-    message: string;
-    versions_imported: number;
-}
-
-export interface AgentGraphResponse {
-    mermaid?: string;
-    json?: unknown;
-}
-
-export interface GraphValidationResponse {
-    valid: boolean;
-    errors?: string[];
-    warnings?: string[];
-}
-
-export interface PublishPreviewIssue {
-    code: string;
-    message: string;
-    severity: string;
-    path?: string;
-    node_id?: string;
-    hint?: string;
-}
-
-export interface PublishPreviewValidationResult {
-    valid: boolean;
-    errors: PublishPreviewIssue[];
-    warnings: PublishPreviewIssue[];
-}
-
-export interface PublishPreviewCapabilityItem {
-    node_id: string;
-    capability_ref: string;
-    capability_version: string;
-    execution_binding: string;
-    required_credentials: string[];
-}
-
-export interface PublishPreviewBindingItem {
-    binding_key: string;
-    status: "bound" | "missing" | "ambiguous";
-    required_by_capabilities: string[];
-    credential_instance_refs: string[];
-    credential_type_refs: string[];
-}
-
-export interface PublishPreviewDraftDiff {
-    added_node_ids: string[];
-    removed_node_ids: string[];
-    modified_node_ids: string[];
-    added_capability_refs: string[];
-    removed_capability_refs: string[];
-    binding_keys_impacted: string[];
-}
-
-export interface PublishPreviewResponse {
-    agent_id: string;
-    draft_ir_revision: string;
-    ready: boolean;
-    validation_result: PublishPreviewValidationResult;
-    capabilities: PublishPreviewCapabilityItem[];
-    bindings: PublishPreviewBindingItem[];
-    draft_diff: PublishPreviewDraftDiff;
-    blockers: PublishPreviewIssue[];
-    warnings: PublishPreviewIssue[];
-}
-
-export interface AgentPublishHistoryChangeSummary {
-    added_capability_refs: string[];
-    removed_capability_refs: string[];
-}
-
-export interface AgentPublishHistoryItem {
-    release_id: string;
-    agent_id: string;
-    bundle_id: string;
-    previous_bundle_id?: string | null;
-    graph_version?: string | null;
-    runtime_package_hash: string;
-    content_hash: string;
-    action: "publish" | "rollback";
-    activated: boolean;
-    is_live: boolean;
-    status: "live" | "historical";
-    actor: string;
-    published_at: string;
-    reason?: string | null;
-    label?: string | null;
-    summary: string;
-    change_summary: AgentPublishHistoryChangeSummary;
-}
-
-export interface AgentPublishHistoryResponse {
-    agent_id: string;
-    live_bundle_id?: string | null;
-    items: AgentPublishHistoryItem[];
-    count: number;
-}
-
-export interface RollbackAgentRequest {
-    target_bundle_id: string;
-    reason?: string;
-}
-
-export interface AgentRollbackResponse {
-    agent_id: string;
-    live_bundle_id: string;
-    rollback_release: AgentPublishHistoryItem;
-}
-
-export interface AgentDraftIrResponse {
-    id: string;
-    name: string;
-    draft_ir_revision?: string | null;
-    draftIrRevision?: string | null;
-    draft_updated_at?: string | null;
-    draftUpdatedAt?: string | null;
-    live_bundle_id?: string | null;
-    liveBundleId?: string | null;
-    etag?: string;
-    e_tag?: string;
-    eTag?: string;
-    ir_json?: Record<string, unknown> | null;
-    irJson?: Record<string, unknown> | null;
-}
-
-export interface UpsertAgentCredentialBindingRequest {
-    credential_instance_ref: string;
-    binding_key: string;
-    priority?: number;
-}
-
-export interface AgentCredentialBindingUpsertResponse {
-    id: string;
-    updated: boolean;
-    agent_id: string;
-    binding_key: string;
-    priority: number;
-    credential_instance_ref: string;
-    credential_type_ref: string;
-    credential_type_key: string;
-}
-
-export interface AgentCredentialBinding {
-    id: string;
-    agent_id: string;
-    binding_key: string;
-    priority: number;
-    credential_instance_ref: string;
-    credential_type_ref: string;
-    credential_type_key: string;
-    credential_name: string;
-}
-
-export interface AgentCredentialBindingListResponse {
-    items: AgentCredentialBinding[];
-    count: number;
-}
-
-export type AgentListResponse = PaginatedResponse<Agent>;
-
-export interface AgentRuntimeContext {
-    agent_id: string;
-    context_key: string;
-    version_key: string;
-    version_number: number;
-    content_sha256: string;
-    content_length: number;
-    content: string;
-    updated_at: string;
-    source?: string | null;
-}
-
-export interface AgentRuntimeContextListResponse {
-    items: AgentRuntimeContext[];
-}
-
-export interface UpsertAgentRuntimeContextRequest {
-    content: string;
-    source?: string | null;
-}
-
-export class AgentsModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    // ======================== CRUD ========================
-
-    /**
-     * List all agents in the workspace.
-     * @example
-     * ```ts
-     * const { data } = await client.agents.list({ limit: 10 });
-     * data?.items.forEach(agent => console.log(agent.name));
-     * ```
-     */
-    async list(params?: PaginationParams & {
-        workspace_id?: string;
-    }): Promise<APIResponse<AgentListResponse>> {
-        return this.client.GET<AgentListResponse>("/v1/api/agents", {
-            params: { query: params },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get a single agent by ID.
-     * @example
-     * ```ts
-     * const { data: agent } = await client.agents.get("agent-uuid");
-     * ```
-     */
-    async get(agentId: string): Promise<APIResponse<Agent>> {
-        return this.client.GET<Agent>("/v1/api/agents/{agentId}", {
-            params: { path: { agentId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Create a new agent.
-     * Backend only accepts `name` per CreateAgentRequest DTO.
-     * @example
-     * ```ts
-     * const { data: agent } = await client.agents.create({ name: "My Agent" });
-     * 
-     * // With idempotency (safe to retry)
-     * const { data: agent } = await client.agents.create({ 
-     *   name: "My Agent", 
-     *   idempotency_key: "unique-key" 
-     * });
-     * ```
-     */
-    async create(body: {
-        name: string;
-        metadata?: any | null;
-        /** Idempotency key for safe retries. When set, duplicate requests with the same key return 409 Conflict. */
-        idempotency_key?: string;
-    }): Promise<APIResponse<Agent>> {
-        const headers: Record<string, string> = { ...this.headers() };
-        if (body.idempotency_key) {
-            headers["X-Idempotency-Key"] = body.idempotency_key;
-        }
-
-        return this.client.POST<Agent>("/v1/api/agents", {
-            body: {
-                name: body.name,
-                metadata: body.metadata
-            },
-            headers,
-        });
-    }
-
-    /**
-     * Update an existing agent.
-     * Uses PATCH per backend AgentsController.
-     */
-    async update(agentId: string, body: {
-        name?: string;
-        live_bundle_id?: string;
-        metadata?: any | null;
-    }): Promise<APIResponse<Agent>> {
-        return this.client.PATCH<Agent>("/v1/api/agents/{id}", {
-            params: { path: { id: agentId } },
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Delete an agent.
-     */
-    async delete(agentId: string): Promise<APIResponse<void>> {
-        return this.client.DELETE<void>("/v1/api/agents/{agentId}", {
-            params: { path: { agentId } },
-            headers: this.headers(),
-        });
-    }
-
-    // ======================== Runtime Contexts ========================
-
-    /**
-     * List current runtime contexts for an agent.
-     */
-    async listRuntimeContexts(agentId: string): Promise<APIResponse<AgentRuntimeContextListResponse>> {
-        return this.client.GET<AgentRuntimeContextListResponse>("/v1/api/agents/{agentId}/runtime-contexts", {
-            params: { path: { agentId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get the current runtime context for a given key.
-     */
-    async getRuntimeContext(agentId: string, contextKey: string): Promise<APIResponse<AgentRuntimeContext>> {
-        return this.client.GET<AgentRuntimeContext>("/v1/api/agents/{agentId}/runtime-contexts/{contextKey}", {
-            params: { path: { agentId, contextKey } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Create or update the current runtime context for a given key.
-     */
-    async upsertRuntimeContext(
-        agentId: string,
-        contextKey: string,
-        body: UpsertAgentRuntimeContextRequest
-    ): Promise<APIResponse<AgentRuntimeContext>> {
-        return this.client.PUT<AgentRuntimeContext>("/v1/api/agents/{agentId}/runtime-contexts/{contextKey}", {
-            params: { path: { agentId, contextKey } },
-            body: {
-                content: body.content,
-                source: body.source ?? null,
-            },
-            headers: this.headers(),
-        });
-    }
-
-    // ======================== Portability ========================
-
-    /**
-     * Export an agent as a JSON bundle.
-     */
-    async export(agentId: string): Promise<APIResponse<AgentBundle>> {
-        return this.client.GET<AgentBundle>("/v1/api/agents/{id}/export", {
-            params: { path: { id: agentId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Import an agent bundle.
-     */
-    async import(bundle: AgentBundle): Promise<APIResponse<ImportAgentResponse>> {
-        return this.client.POST<ImportAgentResponse>("/v1/api/agents/import", {
-            body: bundle,
-            headers: this.headers(),
-        });
-    }
-
-    // ======================== Graph ========================
-
-    /**
-     * Get the graph for an agent (Mermaid or JSON).
-     */
-    async getGraph(agentId: string, format?: "mermaid" | "json"): Promise<APIResponse<AgentGraphResponse>> {
-        return this.client.GET<AgentGraphResponse>("/v1/api/agents/{agentId}/graph", {
-            params: { path: { agentId }, query: { format } },
-            headers: this.headers(),
-        });
-    }
-
-    /** Alias for getGraph (convenience) */
-    graph = (agentId: string, format?: "mermaid" | "json") => this.getGraph(agentId, format);
-
-    /**
-     * Validate the graph configuration.
-     */
-    async validateGraph(agentId: string): Promise<APIResponse<GraphValidationResponse>> {
-        return this.client.POST<GraphValidationResponse>("/v1/api/agents/{agentId}/graph/validate", {
-            params: { path: { agentId } },
-            headers: this.headers(),
-        });
-    }
-
-    async getPublishPreview(
-        agentId: string,
-        irJson?: Record<string, unknown>
-    ): Promise<APIResponse<PublishPreviewResponse>> {
-        if (irJson) {
-            return this.client.POST<PublishPreviewResponse>("/v1/api/agents/{id}/publish-preview", {
-                params: { path: { id: agentId } },
-                body: { ir_json: irJson } as any,
-                headers: this.headers(),
-            });
-        }
-
-        return this.client.GET<PublishPreviewResponse>("/v1/api/agents/{id}/publish-preview", {
-            params: { path: { id: agentId } },
-            headers: this.headers(),
-        });
-    }
-
-    // ======================== Draft IR ========================
-
-    async getDraftIr(agentId: string): Promise<APIResponse<AgentDraftIrResponse>> {
-        return this.client.GET<AgentDraftIrResponse>("/v1/api/agents/{id}/draft/ir", {
-            params: { path: { id: agentId } },
-            headers: this.headers(),
-        });
-    }
-
-    async updateDraftIr(
-        agentId: string,
-        irJson: Record<string, unknown>,
-        options?: { if_match?: string }
-    ): Promise<APIResponse<AgentDraftIrResponse>> {
-        const headers: Record<string, string> = { ...this.headers() };
-        if (options?.if_match) {
-            headers["If-Match"] = options.if_match;
-        }
-
-        const response = await this.client.PUT<AgentDraftIrResponse | { data?: AgentDraftIrResponse }>("/v1/api/agents/{id}/draft/ir", {
-            params: { path: { id: agentId } },
-            body: {
-                ir_json: irJson,
-            } as any,
-            headers,
-        });
-
-        const unwrapped =
-            response.data &&
-                typeof response.data === "object" &&
-                "data" in response.data &&
-                typeof (response.data as { data?: unknown }).data === "object"
-                ? ((response.data as { data?: AgentDraftIrResponse }).data ?? undefined)
-                : (response.data as AgentDraftIrResponse | undefined);
-
-        return {
-            ...response,
-            data: unwrapped,
-        };
-    }
-
-    // ======================== Publishing ========================
-
-    /**
-     * Publish the committed agent artifact pointed to by the current authoring revision.
-     * The client does not send authoring JSON anymore.
-     * @param agentId The agent UUID
-     * @param options Optional settings: version_label for tagging, set_as_live to make this the active version, idempotency_key for safe retries
-     * @returns Bundle response with version details
-     * @example
-     * ```ts
-     * const { data: bundle } = await client.agents.publish(agentId, {
-     *   idempotency_key: "publish-unique-key"
-     * });
-     * ```
-     */
-    async publish(
-        agentId: string,
-        options?: {
-            version_label?: string | null;
-            set_as_live?: boolean;
-            required_tools?: string[];
-            /** Idempotency key for safe retries */
-            idempotency_key?: string;
-        }
-    ): Promise<APIResponse<components["schemas"]["BundleResponse"]>> {
-        const headers: Record<string, string> = { ...this.headers() };
-        if (options?.idempotency_key) {
-            headers["X-Idempotency-Key"] = options.idempotency_key;
-        }
-
-        return this.client.POST<components["schemas"]["BundleResponse"]>("/v1/api/agents/{id}/publish", {
-            params: { path: { id: agentId } },
-            body: {
-                version_label: options?.version_label ?? null,
-                set_as_live: options?.set_as_live ?? true,
-                required_tools: options?.required_tools ?? []
-            } as any,
-            headers
-        });
-    }
-
-    async listPublishes(agentId: string): Promise<APIResponse<AgentPublishHistoryResponse>> {
-        return this.client.GET<AgentPublishHistoryResponse>("/v1/api/agents/{id}/publishes", {
-            params: { path: { id: agentId } },
-            headers: this.headers(),
-        });
-    }
-
-    async rollback(
-        agentId: string,
-        body: RollbackAgentRequest
-    ): Promise<APIResponse<AgentRollbackResponse>> {
-        return this.client.POST<AgentRollbackResponse>("/v1/api/agents/{id}/rollback", {
-            params: { path: { id: agentId } },
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    // ======================== Bundles ========================
-
-    /**
-     * Get the manifest for a specific bundle.
-     * Returns artifact metadata only.
-     * @example
-     * ```ts
-     * const { data } = await client.agents.getBundleManifest(agentId, bundleId);
-     * console.log(data?.artifact_hash);
-     * ```
-     */
-    async getBundleManifest(agentId: string, bundleId: string): Promise<APIResponse<BundleManifestResponse>> {
-        return this.client.GET<BundleManifestResponse>("/v1/api/agents/{agentId}/bundles/{bundleId}/manifest", {
-            params: { path: { agentId, bundleId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get Mermaid diagram for a specific bundle graph.
-     */
-    async getBundleMermaid(agentId: string, bundleId: string): Promise<APIResponse<BundleMermaidResponse>> {
-        return this.client.GET<BundleMermaidResponse>("/v1/api/agents/{agentId}/bundles/{bundleId}/graph/mermaid", {
-            params: { path: { agentId, bundleId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Creates or updates an agent credential binding by binding key.
-     */
-    async upsertCredentialBinding(
-        agentId: string,
-        body: UpsertAgentCredentialBindingRequest
-    ): Promise<APIResponse<AgentCredentialBindingUpsertResponse>> {
-        return this.client.POST<AgentCredentialBindingUpsertResponse>("/v1/api/agents/{id}/credential-bindings", {
-            params: { path: { id: agentId } },
-            body: {
-                credential_instance_ref: body.credential_instance_ref,
-                binding_key: body.binding_key,
-                priority: body.priority ?? 0,
-            },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Lists credential bindings for an agent.
-     */
-    async listCredentialBindings(
-        agentId: string
-    ): Promise<APIResponse<AgentCredentialBindingListResponse>> {
-        return this.client.GET<AgentCredentialBindingListResponse>("/v1/api/agents/{id}/credential-bindings", {
-            params: { path: { id: agentId } },
-            headers: this.headers(),
-        });
-    }
-
-}
-
-// Bundle manifest response type
-export interface BundleManifestResponse {
-    agent_id: string;
-    bundle_id: string;
-    agent_name: string;
-    artifact_uri?: string;
-    artifact_hash?: string;
-    content_hash?: string;
-    format?: string;
-    schema_version?: string;
-    created_at?: string;
-}
-
-export interface BundleMermaidResponse {
-    bundle_id: string;
-    agent_id: string;
-    mermaid: string;
-    format?: string;
-    node_count?: number;
-    edge_count?: number;
-}

package/src/modules/apiTokens.ts

@@ -1,101 +0,0 @@
-
-import type { APIResponse, RawClient } from "../client/raw.js";
-
-export interface ApiToken {
-    id: string;
-    name: string;
-    token_prefix: string;
-    scopes: string[];
-    created_at: string;
-    expires_at?: string | null;
-    last_used_at?: string | null;
-}
-
-export interface ApiTokenSecret extends ApiToken {
-    token: string; // The full secret, only returned once
-    workspace_id: string;
-}
-
-export interface CreateTokenRequest {
-    name: string;
-    scopes?: string[];
-    expires_at?: string | null;
-    environment?: "live" | "test";
-}
-
-export interface RotateTokenResponse extends ApiTokenSecret {
-    rotated_from: string;
-}
-
-export interface ScopeInfo {
-    key: string;
-    description: string;
-}
-
-export interface ScopeListResponse {
-    scopes: ScopeInfo[];
-}
-
-export class ApiTokensModule {
-    private client: RawClient;
-
-    constructor(client: RawClient) {
-        this.client = client;
-    }
-
-    private headers() {
-        return {
-            "Content-Type": "application/json",
-        };
-    }
-
-    /**
-     * List all API tokens for the current workspace.
-     */
-    async list(): Promise<APIResponse<{ tokens: ApiToken[] }>> {
-        return this.client.GET<{ tokens: ApiToken[] }>("/v1/api/tokens", {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Create a new API token.
-     * The full token secret is only returned in this response.
-     */
-    async create(body: CreateTokenRequest): Promise<APIResponse<ApiTokenSecret>> {
-        return this.client.POST<ApiTokenSecret>("/v1/api/tokens", {
-            body,
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * List all available scopes.
-     */
-    async listScopes(): Promise<APIResponse<ScopeListResponse>> {
-        return this.client.GET<ScopeListResponse>("/v1/api/tokens/available-scopes", {
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Revoke an API token immediately.
-     */
-    async revoke(id: string): Promise<APIResponse<{ message: string }>> {
-        return this.client.DELETE<{ message: string }>("/v1/api/tokens/{id}", {
-            params: { path: { id } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Rotate a token (revoke old, create new).
-     * Returns the new token secret.
-     */
-    async rotate(id: string): Promise<APIResponse<RotateTokenResponse>> {
-        return this.client.POST<RotateTokenResponse>("/v1/api/tokens/{id}/rotate", {
-            params: { path: { id } },
-            headers: this.headers(),
-        });
-    }
-}