@agent-os-sdk/client 0.1.0 → 0.1.2

package/src/modules/capabilities.ts

@@ -0,0 +1,176 @@
+/**
+ * Capabilities Module - Agent Permissions System
+ * 
+ * // MOCK - This module contains mock implementations for future features
+ * 
+ * Manages what agents/runs can do. Formal capability system
+ * that enables enterprise-grade governance.
+ */
+
+import type { RawClient, APIResponse } from "../client/raw.js";
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface Capability {
+    id: string;
+    name: string;
+    description?: string;
+    type: "tool" | "network" | "file" | "mcp" | "token" | "custom";
+    config: CapabilityConfig;
+}
+
+export interface CapabilityConfig {
+    // Tool capabilities
+    tool_allowlist?: string[];
+    tool_denylist?: string[];
+    max_tool_calls?: number;
+
+    // Network capabilities
+    allowed_domains?: string[];
+    blocked_domains?: string[];
+    allow_egress?: boolean;
+
+    // File capabilities
+    file_read?: boolean;
+    file_write?: boolean;
+    allowed_paths?: string[];
+
+    // MCP capabilities
+    mcp_server_allowlist?: string[];
+
+    // Token/cost capabilities
+    max_tokens?: number;
+    max_input_tokens?: number;
+    max_output_tokens?: number;
+
+    // Streaming
+    streaming_allowed?: boolean;
+}
+
+export interface CapabilitySet {
+    agent_id?: string;
+    run_id?: string;
+    capabilities: Capability[];
+    inherited_from?: string;
+    effective_at: string;
+}
+
+export interface CapabilityOverride {
+    run_id: string;
+    overrides: Partial<CapabilityConfig>;
+    reason?: string;
+    applied_at: string;
+    applied_by: string;
+}
+
+// ============================================================================
+// Module
+// ============================================================================
+
+export class CapabilitiesModule {
+    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
+
+    // MOCK - Simulated get for agent
+    /**
+     * Get capabilities for an agent.
+     */
+    async getForAgent(agentId: string): Promise<APIResponse<CapabilitySet>> {
+        // MOCK - Returns simulated data
+        const mockCaps: CapabilitySet = {
+            agent_id: agentId,
+            capabilities: [
+                {
+                    id: "cap_tools",
+                    name: "Tool Access",
+                    type: "tool",
+                    config: {
+                        tool_allowlist: ["web_search", "calculator", "file_read"],
+                        max_tool_calls: 50,
+                    },
+                },
+                {
+                    id: "cap_network",
+                    name: "Network Access",
+                    type: "network",
+                    config: {
+                        allow_egress: true,
+                        allowed_domains: ["*.google.com", "*.openai.com"],
+                    },
+                },
+                {
+                    id: "cap_tokens",
+                    name: "Token Limits",
+                    type: "token",
+                    config: {
+                        max_tokens: 100000,
+                        max_input_tokens: 50000,
+                        max_output_tokens: 50000,
+                    },
+                },
+            ],
+            effective_at: new Date().toISOString(),
+        };
+        return { data: mockCaps, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated set for agent
+    /**
+     * Set capabilities for an agent.
+     */
+    async setForAgent(agentId: string, capabilities: Capability[]): Promise<APIResponse<CapabilitySet>> {
+        // MOCK - Returns simulated data
+        const mockCaps: CapabilitySet = {
+            agent_id: agentId,
+            capabilities,
+            effective_at: new Date().toISOString(),
+        };
+        return { data: mockCaps, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated get for run
+    /**
+     * Get effective capabilities for a run.
+     */
+    async getForRun(runId: string): Promise<APIResponse<CapabilitySet>> {
+        // MOCK - Returns simulated data
+        const mockCaps: CapabilitySet = {
+            run_id: runId,
+            capabilities: [
+                {
+                    id: "cap_tools",
+                    name: "Tool Access",
+                    type: "tool",
+                    config: {
+                        tool_allowlist: ["web_search"],
+                        max_tool_calls: 10,
+                    },
+                },
+            ],
+            inherited_from: "agent_123",
+            effective_at: new Date().toISOString(),
+        };
+        return { data: mockCaps, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated override for run
+    /**
+     * Override capabilities for a specific run.
+     */
+    async overrideForRun(
+        runId: string,
+        overrides: Partial<CapabilityConfig>,
+        reason?: string
+    ): Promise<APIResponse<CapabilityOverride>> {
+        // MOCK - Returns simulated data
+        const mockOverride: CapabilityOverride = {
+            run_id: runId,
+            overrides,
+            reason,
+            applied_at: new Date().toISOString(),
+            applied_by: "user_123",
+        };
+        return { data: mockOverride, error: undefined, response: new Response() };
+    }
+}

package/src/modules/deployments.ts

@@ -0,0 +1,315 @@
+/**
+ * Deployments Module - Release Management
+ * 
+ * // MOCK - This module contains mock implementations for future features
+ * 
+ * Provides deployment management, environment promotion,
+ * rollback, canary releases, and change freezes.
+ */
+
+import type { RawClient, APIResponse } from "../client/raw.js";
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type DeploymentStatus = "pending" | "deploying" | "active" | "rolling_back" | "rolled_back" | "failed";
+export type EnvironmentType = "development" | "staging" | "production" | "custom";
+
+export interface Environment {
+    id: string;
+    name: string;
+    type: EnvironmentType;
+    description?: string;
+    is_frozen: boolean;
+    frozen_until?: string;
+    frozen_reason?: string;
+    config: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+}
+
+export interface Deployment {
+    id: string;
+    agent_id: string;
+    agent_version_id: string;
+    environment_id: string;
+    environment_name: string;
+    status: DeploymentStatus;
+    promoted_by: string;
+    promoted_at: string;
+    completed_at?: string;
+    rollback_version_id?: string;
+    canary_percent?: number;
+    notes?: string;
+}
+
+export interface DeploymentDiff {
+    from_version: string;
+    to_version: string;
+    changes: {
+        category: string;
+        field: string;
+        old_value: unknown;
+        new_value: unknown;
+    }[];
+    config_changes: number;
+    prompt_changes: number;
+    graph_changes: number;
+}
+
+export interface EnvironmentListResponse {
+    items: Environment[];
+    total: number;
+}
+
+export interface DeploymentListResponse {
+    items: Deployment[];
+    total: number;
+}
+
+// ============================================================================
+// Module
+// ============================================================================
+
+export class DeploymentsModule {
+    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
+
+    // ========== Environments ==========
+
+    // MOCK - Simulated listEnvironments
+    /**
+     * List all environments.
+     */
+    async listEnvironments(): Promise<APIResponse<EnvironmentListResponse>> {
+        // MOCK - Returns simulated data
+        const mockEnvs: EnvironmentListResponse = {
+            items: [
+                {
+                    id: "env_dev",
+                    name: "Development",
+                    type: "development",
+                    description: "Development environment for testing",
+                    is_frozen: false,
+                    config: { logging_level: "debug" },
+                    created_at: new Date(Date.now() - 86400000 * 30).toISOString(),
+                    updated_at: new Date().toISOString(),
+                },
+                {
+                    id: "env_staging",
+                    name: "Staging",
+                    type: "staging",
+                    description: "Pre-production testing",
+                    is_frozen: false,
+                    config: { logging_level: "info" },
+                    created_at: new Date(Date.now() - 86400000 * 30).toISOString(),
+                    updated_at: new Date().toISOString(),
+                },
+                {
+                    id: "env_prod",
+                    name: "Production",
+                    type: "production",
+                    description: "Live production environment",
+                    is_frozen: false,
+                    config: { logging_level: "warning" },
+                    created_at: new Date(Date.now() - 86400000 * 30).toISOString(),
+                    updated_at: new Date().toISOString(),
+                },
+            ],
+            total: 3,
+        };
+        return { data: mockEnvs, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated createEnvironment
+    /**
+     * Create a new environment.
+     */
+    async createEnvironment(body: {
+        name: string;
+        type: EnvironmentType;
+        description?: string;
+        config?: Record<string, unknown>;
+    }): Promise<APIResponse<Environment>> {
+        // MOCK - Returns simulated data
+        const mockEnv: Environment = {
+            id: `env_${Date.now()}`,
+            name: body.name,
+            type: body.type,
+            description: body.description,
+            is_frozen: false,
+            config: body.config || {},
+            created_at: new Date().toISOString(),
+            updated_at: new Date().toISOString(),
+        };
+        return { data: mockEnv, error: undefined, response: new Response() };
+    }
+
+    // ========== Deployments ==========
+
+    // MOCK - Simulated history
+    /**
+     * Get deployment history for an environment.
+     */
+    async history(environmentId: string): Promise<APIResponse<DeploymentListResponse>> {
+        // MOCK - Returns simulated data
+        const mockHistory: DeploymentListResponse = {
+            items: [
+                {
+                    id: "deploy_3",
+                    agent_id: "agent_support",
+                    agent_version_id: "v3",
+                    environment_id: environmentId,
+                    environment_name: "Production",
+                    status: "active",
+                    promoted_by: "user_admin",
+                    promoted_at: new Date(Date.now() - 3600000).toISOString(),
+                    completed_at: new Date(Date.now() - 3500000).toISOString(),
+                },
+                {
+                    id: "deploy_2",
+                    agent_id: "agent_support",
+                    agent_version_id: "v2",
+                    environment_id: environmentId,
+                    environment_name: "Production",
+                    status: "rolled_back",
+                    promoted_by: "user_admin",
+                    promoted_at: new Date(Date.now() - 86400000).toISOString(),
+                    completed_at: new Date(Date.now() - 86000000).toISOString(),
+                    rollback_version_id: "v1",
+                },
+            ],
+            total: 2,
+        };
+        return { data: mockHistory, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated promote
+    /**
+     * Promote an agent version to an environment.
+     */
+    async promote(
+        agentVersionId: string,
+        environmentId: string,
+        options?: { notes?: string }
+    ): Promise<APIResponse<Deployment>> {
+        // MOCK - Returns simulated data
+        const mockDeploy: Deployment = {
+            id: `deploy_${Date.now()}`,
+            agent_id: "agent_123",
+            agent_version_id: agentVersionId,
+            environment_id: environmentId,
+            environment_name: "Production",
+            status: "deploying",
+            promoted_by: "user_current",
+            promoted_at: new Date().toISOString(),
+            notes: options?.notes,
+        };
+        return { data: mockDeploy, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated rollback
+    /**
+     * Rollback an environment to a previous version.
+     */
+    async rollback(environmentId: string, toVersionId?: string): Promise<APIResponse<Deployment>> {
+        // MOCK - Returns simulated data
+        const mockDeploy: Deployment = {
+            id: `deploy_rollback_${Date.now()}`,
+            agent_id: "agent_123",
+            agent_version_id: toVersionId || "v2",
+            environment_id: environmentId,
+            environment_name: "Production",
+            status: "rolling_back",
+            promoted_by: "user_current",
+            promoted_at: new Date().toISOString(),
+            rollback_version_id: "v3",
+        };
+        return { data: mockDeploy, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated canary
+    /**
+     * Start a canary deployment.
+     */
+    async canary(
+        environmentId: string,
+        agentVersionId: string,
+        percent: number
+    ): Promise<APIResponse<Deployment>> {
+        // MOCK - Returns simulated data
+        const mockDeploy: Deployment = {
+            id: `deploy_canary_${Date.now()}`,
+            agent_id: "agent_123",
+            agent_version_id: agentVersionId,
+            environment_id: environmentId,
+            environment_name: "Production",
+            status: "deploying",
+            promoted_by: "user_current",
+            promoted_at: new Date().toISOString(),
+            canary_percent: percent,
+        };
+        return { data: mockDeploy, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated freeze
+    /**
+     * Freeze an environment (change freeze).
+     */
+    async freeze(
+        environmentId: string,
+        options?: { until?: string; reason?: string }
+    ): Promise<APIResponse<Environment>> {
+        // MOCK - Returns simulated data
+        const mockEnv: Environment = {
+            id: environmentId,
+            name: "Production",
+            type: "production",
+            is_frozen: true,
+            frozen_until: options?.until,
+            frozen_reason: options?.reason || "Change freeze in effect",
+            config: {},
+            created_at: new Date(Date.now() - 86400000 * 30).toISOString(),
+            updated_at: new Date().toISOString(),
+        };
+        return { data: mockEnv, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated unfreeze
+    /**
+     * Unfreeze an environment.
+     */
+    async unfreeze(environmentId: string): Promise<APIResponse<Environment>> {
+        // MOCK - Returns simulated data
+        const mockEnv: Environment = {
+            id: environmentId,
+            name: "Production",
+            type: "production",
+            is_frozen: false,
+            config: {},
+            created_at: new Date(Date.now() - 86400000 * 30).toISOString(),
+            updated_at: new Date().toISOString(),
+        };
+        return { data: mockEnv, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated diff
+    /**
+     * Get diff between two versions.
+     */
+    async diff(fromVersionId: string, toVersionId: string): Promise<APIResponse<DeploymentDiff>> {
+        // MOCK - Returns simulated diff
+        const mockDiff: DeploymentDiff = {
+            from_version: fromVersionId,
+            to_version: toVersionId,
+            changes: [
+                { category: "config", field: "max_tokens", old_value: 4000, new_value: 8000 },
+                { category: "prompt", field: "system_prompt", old_value: "You are a helpful assistant", new_value: "You are an expert assistant" },
+            ],
+            config_changes: 1,
+            prompt_changes: 1,
+            graph_changes: 0,
+        };
+        return { data: mockDiff, error: undefined, response: new Response() };
+    }
+}