@agent-os-sdk/client 0.9.26 → 0.9.28

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(),
-        });
-    }
-}

package/src/modules/approvals.ts

@@ -1,151 +0,0 @@
-/**
- * Approvals Module - Human-in-the-Loop Native
- * 
- * Wave 2.x: Real implementation for HITL workflow.
- * Endpoints: /v1/api/workspaces/{workspaceId}/approvals
- */
-
-import type { RawClient, APIResponse } from "../client/raw.js";
-
-// ============================================================================
-// Types
-// ============================================================================
-
-export type ApprovalStatus = "pending" | "approved" | "denied" | "expired";
-
-export interface Approval {
-    id: string;
-    run_id: string;
-    attempt_id: string;
-    policy_name: string;
-    reason: string;
-    status: ApprovalStatus;
-    created_at: string;
-    decided_at?: string;
-    decided_by_actor?: string;
-    payload?: Record<string, unknown>;
-}
-
-export interface ApprovalDecision {
-    decision: "approve" | "deny";
-    comment?: string;
-}
-
-export interface ApprovalListResponse {
-    items: Approval[];
-    total: number;
-}
-
-export interface ApprovalStatusResponse {
-    id: string;
-    status: ApprovalStatus;
-    decided_at?: string;
-    decided_by_actor?: string;
-    decision_comment?: string;
-}
-
-// ============================================================================
-// Module
-// ============================================================================
-
-export class ApprovalsModule {
-    constructor(
-        private client: RawClient,
-        private headers: () => Record<string, string>
-    ) { }
-
-    /**
-     * List approvals for a workspace.
-     * @param workspaceId - Workspace ID
-     * @param params - Filter options
-     */
-    async list(workspaceId: string, params?: {
-        status?: ApprovalStatus;
-        limit?: number;
-    }): Promise<APIResponse<ApprovalListResponse>> {
-        return this.client.GET<ApprovalListResponse>(
-            "/v1/api/workspaces/{workspaceId}/approvals",
-            {
-                params: {
-                    path: { workspaceId },
-                    query: {
-                        status: params?.status,
-                        limit: params?.limit ?? 50
-                    }
-                },
-                headers: this.headers(),
-            }
-        );
-    }
-
-    /**
-     * Get a specific approval by ID.
-     * @param workspaceId - Workspace ID
-     * @param approvalId - Approval ID
-     */
-    async get(workspaceId: string, approvalId: string): Promise<APIResponse<Approval>> {
-        return this.client.GET<Approval>(
-            "/v1/api/workspaces/{workspaceId}/approvals/{approvalId}",
-            {
-                params: {
-                    path: { workspaceId, approvalId }
-                },
-                headers: this.headers(),
-            }
-        );
-    }
-
-    /**
-     * Approve an approval request.
-     * @param workspaceId - Workspace ID
-     * @param approvalId - Approval ID
-     * @param comment - Optional reason for approval
-     */
-    async approve(workspaceId: string, approvalId: string, comment?: string): Promise<APIResponse<ApprovalStatusResponse>> {
-        return this.client.POST<ApprovalStatusResponse>(
-            "/v1/api/workspaces/{workspaceId}/approvals/{approvalId}/decision",
-            {
-                params: {
-                    path: { workspaceId, approvalId }
-                },
-                body: {
-                    decision: "approve",
-                    comment
-                },
-                headers: this.headers(),
-            }
-        );
-    }
-
-    /**
-     * Deny an approval request.
-     * @param workspaceId - Workspace ID
-     * @param approvalId - Approval ID
-     * @param comment - Optional reason for denial
-     */
-    async deny(workspaceId: string, approvalId: string, comment?: string): Promise<APIResponse<ApprovalStatusResponse>> {
-        return this.client.POST<ApprovalStatusResponse>(
-            "/v1/api/workspaces/{workspaceId}/approvals/{approvalId}/decision",
-            {
-                params: {
-                    path: { workspaceId, approvalId }
-                },
-                body: {
-                    decision: "deny",
-                    comment
-                },
-                headers: this.headers(),
-            }
-        );
-    }
-
-    /**
-     * Shorthand: List pending approvals for a workspace.
-     */
-    async listPending(workspaceId: string, limit = 50): Promise<APIResponse<ApprovalListResponse>> {
-        return this.list(workspaceId, { status: "pending", limit });
-    }
-
-    // Convenience aliases
-    reject = this.deny;
-}

package/src/modules/catalog.ts

@@ -1,241 +0,0 @@
-/**
- * Catalog Module - Canonical Catalog Access
- * 
- * Provides access to versioned catalogs:
- * - Node Catalog (node types, config schemas)
- * - Tool Catalog (tool definitions) 
- * - Trigger Templates (trigger configurations)
- * 
- * All responses include:
- * - ETag header for caching
- * - X-Content-Hash header for integrity verification
- * 
- * @example
- * ```ts
- * const client = new AgentOsClient({ ... })
- * 
- * // Get all catalogs
- * const nodes = await unwrap(client.catalog.getNodes())
- * const tools = await unwrap(client.catalog.getTools())
- * const triggers = await unwrap(client.catalog.getTriggers())
- * 
- * // Use returned metadata for caching
- * console.log(nodes.etag, nodes.contentHash)
- * ```
- */
-
-import type { RawClient, APIResponse } from "../client/raw.js";
-
-export interface CatalogVersions {
-    nodes: string;
-    tools: string;
-    triggers: string;
-}
-
-export interface CatalogMetadata {
-    version: string;
-    etag?: string;
-    contentHash?: string;
-}
-
-export interface PaletteCatalogResponse extends CatalogMetadata {
-    nodes: NodeDefinition[];
-    tools: ToolDefinition[];
-    triggers: TriggerTemplate[];
-    presets: PresetDefinition[];
-}
-
-export interface NodeCatalogResponse extends CatalogMetadata {
-    nodes: NodeDefinition[];
-}
-
-export interface NodeDefinition {
-    capability_ref: string;
-    capability_version: string;
-    execution_binding: string;
-    required_credentials: string[];
-    kind: string; // visual hint only
-    title: string;
-    category: string;
-    description?: string;
-    inputs?: string[];
-    outputs?: string[];
-    config_schema?: Record<string, unknown>;
-    default_config?: Record<string, unknown>;
-}
-
-export interface ToolCatalogResponse extends CatalogMetadata {
-    tools: ToolDefinition[];
-}
-
-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 TriggerCatalogResponse extends CatalogMetadata {
-    templates: TriggerTemplate[];
-}
-
-export interface TriggerTemplate {
-    capability_ref: string;
-    capability_version: string;
-    slug?: string; // compatibility/display only
-    kind: string; // visual hint only
-    description?: string;
-    run_input_schema?: Record<string, unknown>;
-}
-
-export interface PresetCatalogResponse extends CatalogMetadata {
-    presets: PresetDefinition[];
-}
-
-export interface PresetDefinition {
-    preset_slug: string;
-    base_capability_ref: string;
-    title: string;
-    description?: string;
-    default_config?: Record<string, unknown>;
-    locked_fields?: string[];
-    ui_variant?: string;
-}
-
-export class CatalogModule {
-    constructor(private client: RawClient) { }
-
-    async getPalette(version: string = "1"): Promise<APIResponse<PaletteCatalogResponse>> {
-        const [nodesRes, toolsRes, triggersRes, presetsRes] = await Promise.all([
-            this.getNodes(version),
-            this.getTools(version),
-            this.getTriggers(version),
-            this.getPresets(version),
-        ]);
-
-        const fallbackResponse =
-            nodesRes.response || toolsRes.response || triggersRes.response || presetsRes.response;
-
-        if (nodesRes.error || toolsRes.error || triggersRes.error || presetsRes.error) {
-            return {
-                data: undefined,
-                error:
-                    nodesRes.error ||
-                    toolsRes.error ||
-                    triggersRes.error ||
-                    presetsRes.error || { code: "NOT_FOUND", message: "Palette catalog is unavailable" },
-                response: fallbackResponse,
-            };
-        }
-
-        return {
-            data: {
-                version,
-                nodes: nodesRes.data?.nodes || [],
-                tools: toolsRes.data?.tools || [],
-                triggers: triggersRes.data?.templates || [],
-                presets: presetsRes.data?.presets || [],
-            },
-            error: undefined,
-            response: fallbackResponse,
-        };
-    }
-
-    /**
-     * Get the Node Catalog.
-     * Returns node types with their configuration schemas.
-     */
-    async getNodes(version: string = "1"): Promise<APIResponse<NodeCatalogResponse>> {
-        const response = await this.client.GET<NodeCatalogResponse>("/v1/api/catalog/nodes", {
-            params: { query: { version } },
-        });
-
-        // Extract headers for metadata (if available from raw response)
-        return response;
-    }
-
-    /**
-     * Get the Tool Catalog.
-     * Returns tool definitions with input/output schemas.
-     */
-    async getTools(version: string = "1"): Promise<APIResponse<ToolCatalogResponse>> {
-        const response = await this.client.GET<ToolCatalogResponse>("/v1/api/tools/definitions", {
-            params: { query: { version } },
-        });
-
-        return response;
-    }
-
-    /**
-     * Get the Trigger Templates Catalog.
-     * Returns trigger configurations and input schemas.
-     */
-    async getTriggers(version: string = "1"): Promise<APIResponse<TriggerCatalogResponse>> {
-        const response = await this.client.GET<TriggerCatalogResponse>("/v1/api/triggers/templates", {
-            params: { query: { version } },
-        });
-
-        return response;
-    }
-
-    /**
-     * Get the Node Presets Catalog.
-     * Returns pre-configured node variants with locked fields.
-     */
-    async getPresets(version: string = "1"): Promise<APIResponse<PresetCatalogResponse>> {
-        const response = await this.client.GET<PresetCatalogResponse>("/v1/api/catalog/presets", {
-            params: { query: { version } },
-        });
-
-        return response;
-    }
-
-    /**
-     * Get all catalogs at once for convenience.
-     * Returns combined catalog data with versions.
-     */
-    async getAll(version: string = "1"): Promise<{
-        data?: {
-            nodes: NodeCatalogResponse;
-            tools: ToolCatalogResponse;
-            triggers: TriggerCatalogResponse;
-            presets: PresetCatalogResponse;
-            catalog_versions: CatalogVersions;
-        };
-        error?: { code: string; message: string; details?: unknown };
-    }> {
-        const [nodesRes, toolsRes, triggersRes, presetsRes] = await Promise.all([
-            this.getNodes(version),
-            this.getTools(version),
-            this.getTriggers(version),
-            this.getPresets(version),
-        ]);
-
-        if (nodesRes.error) return { data: undefined, error: nodesRes.error };
-        if (toolsRes.error) return { data: undefined, error: toolsRes.error };
-        if (triggersRes.error) return { data: undefined, error: triggersRes.error };
-        if (presetsRes.error) return { data: undefined, error: presetsRes.error };
-
-        return {
-            data: {
-                nodes: nodesRes.data!,
-                tools: toolsRes.data!,
-                triggers: triggersRes.data!,
-                presets: presetsRes.data!,
-                catalog_versions: {
-                    nodes: version,
-                    tools: version,
-                    triggers: version,
-                },
-            },
-            error: undefined,
-        };
-    }
-}