@agent-os-sdk/client 0.9.25 → 0.9.27

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/audit.ts

@@ -1,145 +0,0 @@
-/**
- * Audit Module - Fully Typed
- */
-
-import type { RawClient, APIResponse } from "../client/raw.js";
-
-export interface AuditLogEntry {
-    id: string;
-    tenant_id: string;
-    workspace_id?: string;
-    actor: string;
-    actor_type: "user" | "system" | "api_token";
-    action: string;
-    resource: string;
-    resource_id?: string;
-    metadata?: Record<string, unknown>;
-    ip_address?: string;
-    user_agent?: string;
-    created_at: string;
-}
-
-export interface AuditListResponse {
-    items: AuditLogEntry[];
-    total: number;
-}
-
-export class AuditModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    /**
-     * List audit log entries.
-     */
-    async list(params?: {
-        actor?: string;
-        action?: string;
-        resource?: string;
-        workspace_id?: string;
-        from?: string;
-        to?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<APIResponse<AuditListResponse>> {
-        const queryParams: any = { ...params };
-        if (params?.limit !== undefined) {
-            queryParams.take = params.limit;
-            delete queryParams.limit;
-        }
-        if (params?.offset !== undefined) {
-            queryParams.skip = params.offset;
-            delete queryParams.offset;
-        }
-
-        return this.client.GET<AuditListResponse>("/v1/api/audit", {
-            params: { query: queryParams },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Get a specific audit log entry.
-     */
-    async get(auditId: string): Promise<APIResponse<AuditLogEntry>> {
-        return this.client.GET<AuditLogEntry>("/v1/api/audit/{id}", {
-            params: { path: { id: auditId } },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Search audit logs by action pattern.
-     */
-    async search(params?: {
-        query?: string;
-        from?: string;
-        to?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<APIResponse<AuditListResponse>> {
-        const queryParams: any = { ...params };
-        if (params?.limit !== undefined) {
-            queryParams.take = params.limit;
-            delete queryParams.limit;
-        }
-        if (params?.offset !== undefined) {
-            queryParams.skip = params.offset;
-            delete queryParams.offset;
-        }
-
-        return this.client.GET<AuditListResponse>("/v1/api/audit/search", {
-            params: { query: queryParams },
-            headers: this.headers(),
-        });
-    }
-
-    /**
-     * Iterate through all audit logs with automatic pagination.
-     * 
-     * @example
-     * ```ts
-     * // Get all audit logs for a specific action
-     * for await (const entry of client.audit.iterate({ action: "agent.created" })) {
-     *     console.log(entry.actor, entry.action);
-     * }
-     * ```
-     */
-    async *iterate(
-        filters?: {
-            actor?: string;
-            action?: string;
-            resource?: string;
-            workspace_id?: string;
-            from?: string;
-            to?: string;
-        },
-        options?: { pageSize?: number; maxItems?: number; signal?: AbortSignal }
-    ): AsyncGenerator<AuditLogEntry, void, unknown> {
-        const pageSize = options?.pageSize ?? 100;
-        const maxItems = options?.maxItems ?? Infinity;
-        let offset = 0;
-        let yielded = 0;
-        let hasMore = true;
-
-        while (hasMore && yielded < maxItems) {
-            if (options?.signal?.aborted) return;
-
-            const response = await this.list({
-                ...filters,
-                limit: Math.min(pageSize, maxItems - yielded),
-                offset,
-            });
-
-            if (response.error) throw response.error;
-            const data = response.data!;
-
-            for (const entry of data.items) {
-                if (yielded >= maxItems) return;
-                yield entry;
-                yielded++;
-            }
-
-            offset += data.items.length;
-            hasMore = offset < data.total && data.items.length > 0;
-        }
-    }
-}

package/src/modules/auth.ts

@@ -1,33 +0,0 @@
-/**
- * Auth Module - Bootstrap & Identity
- */
-
-import type { RawClient, APIResponse } from "../client/raw.js";
-
-export interface BootstrapResponse {
-    status: "existing" | "created";
-    tenant_id: string;
-    tenant_name?: string;
-    tenant_slug?: string;
-    workspace_id?: string;
-    workspace_name?: string;
-    workspace_slug?: string;
-    member_id: string;
-    role_name?: string;
-}
-
-export class AuthModule {
-    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
-
-    /**
-     * Bootstrap the authenticated user with a default tenant, workspace, and roles.
-     * Idempotent: returns existing resources if already provisioned.
-     *
-     * @returns 200 if already bootstrapped, 201 if newly created.
-     */
-    async bootstrap(): Promise<APIResponse<BootstrapResponse>> {
-        return this.client.POST<BootstrapResponse>("/v1/api/auth/bootstrap", {
-            headers: this.headers(),
-        });
-    }
-}

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