@agent-os-sdk/client 0.1.1 → 0.1.2

package/dist/modules/budgets.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Budgets Module - Cost Control
+ *
+ * // MOCK - This module contains mock implementations for future features
+ *
+ * Provides budget management, cost estimation, and spending limits.
+ * Critical for CFO happiness and auto-protection.
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export type BudgetPeriod = "hourly" | "daily" | "weekly" | "monthly" | "total";
+export type BudgetScope = "tenant" | "workspace" | "agent" | "environment";
+export interface Budget {
+    id: string;
+    name: string;
+    scope: BudgetScope;
+    scope_id: string;
+    period: BudgetPeriod;
+    limit_amount: number;
+    currency: string;
+    current_usage: number;
+    usage_percentage: number;
+    alert_thresholds: number[];
+    hard_limit: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface BudgetUsage {
+    budget_id: string;
+    period_start: string;
+    period_end: string;
+    total_cost: number;
+    breakdown: BudgetBreakdown[];
+}
+export interface BudgetBreakdown {
+    category: string;
+    amount: number;
+    percentage: number;
+    run_count: number;
+}
+export interface CostEstimate {
+    estimated_min: number;
+    estimated_max: number;
+    estimated_avg: number;
+    currency: string;
+    breakdown: {
+        input_tokens: number;
+        output_tokens: number;
+        tool_calls: number;
+        model_cost: number;
+    };
+    warnings: string[];
+}
+export interface BudgetListResponse {
+    items: Budget[];
+    total: number;
+}
+export declare class BudgetsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List all budgets.
+     */
+    list(params?: {
+        scope?: BudgetScope;
+    }): Promise<APIResponse<BudgetListResponse>>;
+    /**
+     * Get a budget by ID.
+     */
+    get(budgetId: string): Promise<APIResponse<Budget>>;
+    /**
+     * Create or update a budget.
+     */
+    set(body: {
+        name: string;
+        scope: BudgetScope;
+        scope_id: string;
+        period: BudgetPeriod;
+        limit_amount: number;
+        currency?: string;
+        alert_thresholds?: number[];
+        hard_limit?: boolean;
+    }): Promise<APIResponse<Budget>>;
+    /**
+     * Get budget usage details.
+     */
+    getUsage(budgetId: string): Promise<APIResponse<BudgetUsage>>;
+    /**
+     * Estimate cost for a run before execution.
+     */
+    estimateCost(params: {
+        agent_id: string;
+        input?: Record<string, unknown>;
+        max_iterations?: number;
+    }): Promise<APIResponse<CostEstimate>>;
+    /**
+     * Set a hard budget cap for a specific run.
+     */
+    setBudgetForRun(runId: string, limit: number): Promise<APIResponse<{
+        run_id: string;
+        limit: number;
+    }>>;
+}
+//# sourceMappingURL=budgets.d.ts.map

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

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

package/dist/modules/budgets.js

@@ -0,0 +1,161 @@
+/**
+ * Budgets Module - Cost Control
+ *
+ * // MOCK - This module contains mock implementations for future features
+ *
+ * Provides budget management, cost estimation, and spending limits.
+ * Critical for CFO happiness and auto-protection.
+ */
+// ============================================================================
+// Module
+// ============================================================================
+export class BudgetsModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    // MOCK - Simulated list
+    /**
+     * List all budgets.
+     */
+    async list(params) {
+        // MOCK - Returns simulated data
+        const mockBudgets = {
+            items: [
+                {
+                    id: "budget_tenant",
+                    name: "Monthly Tenant Budget",
+                    scope: "tenant",
+                    scope_id: "tenant_123",
+                    period: "monthly",
+                    limit_amount: 5000,
+                    currency: "USD",
+                    current_usage: 1250.50,
+                    usage_percentage: 25.01,
+                    alert_thresholds: [50, 80, 90],
+                    hard_limit: false,
+                    created_at: new Date(Date.now() - 2592000000).toISOString(),
+                    updated_at: new Date().toISOString(),
+                },
+                {
+                    id: "budget_agent_1",
+                    name: "Agent Daily Budget",
+                    scope: "agent",
+                    scope_id: "agent_support",
+                    period: "daily",
+                    limit_amount: 50,
+                    currency: "USD",
+                    current_usage: 12.30,
+                    usage_percentage: 24.6,
+                    alert_thresholds: [80, 95],
+                    hard_limit: true,
+                    created_at: new Date(Date.now() - 86400000).toISOString(),
+                    updated_at: new Date().toISOString(),
+                },
+            ],
+            total: 2,
+        };
+        return { data: mockBudgets, error: undefined, response: new Response() };
+    }
+    // MOCK - Simulated get
+    /**
+     * Get a budget by ID.
+     */
+    async get(budgetId) {
+        // MOCK - Returns simulated data
+        const mockBudget = {
+            id: budgetId,
+            name: "Monthly Tenant Budget",
+            scope: "tenant",
+            scope_id: "tenant_123",
+            period: "monthly",
+            limit_amount: 5000,
+            currency: "USD",
+            current_usage: 1250.50,
+            usage_percentage: 25.01,
+            alert_thresholds: [50, 80, 90],
+            hard_limit: false,
+            created_at: new Date(Date.now() - 2592000000).toISOString(),
+            updated_at: new Date().toISOString(),
+        };
+        return { data: mockBudget, error: undefined, response: new Response() };
+    }
+    // MOCK - Simulated set
+    /**
+     * Create or update a budget.
+     */
+    async set(body) {
+        // MOCK - Returns simulated data
+        const mockBudget = {
+            id: `budget_${Date.now()}`,
+            name: body.name,
+            scope: body.scope,
+            scope_id: body.scope_id,
+            period: body.period,
+            limit_amount: body.limit_amount,
+            currency: body.currency || "USD",
+            current_usage: 0,
+            usage_percentage: 0,
+            alert_thresholds: body.alert_thresholds || [80, 90],
+            hard_limit: body.hard_limit ?? false,
+            created_at: new Date().toISOString(),
+            updated_at: new Date().toISOString(),
+        };
+        return { data: mockBudget, error: undefined, response: new Response() };
+    }
+    // MOCK - Simulated getUsage
+    /**
+     * Get budget usage details.
+     */
+    async getUsage(budgetId) {
+        // MOCK - Returns simulated data
+        const mockUsage = {
+            budget_id: budgetId,
+            period_start: new Date(Date.now() - 2592000000).toISOString(),
+            period_end: new Date().toISOString(),
+            total_cost: 1250.50,
+            breakdown: [
+                { category: "GPT-4", amount: 800.00, percentage: 63.97, run_count: 450 },
+                { category: "Claude", amount: 300.50, percentage: 24.03, run_count: 200 },
+                { category: "Embeddings", amount: 100.00, percentage: 8.00, run_count: 1000 },
+                { category: "Tools", amount: 50.00, percentage: 4.00, run_count: 300 },
+            ],
+        };
+        return { data: mockUsage, error: undefined, response: new Response() };
+    }
+    // MOCK - Simulated estimateCost
+    /**
+     * Estimate cost for a run before execution.
+     */
+    async estimateCost(params) {
+        // MOCK - Returns simulated estimate
+        const mockEstimate = {
+            estimated_min: 0.05,
+            estimated_max: 0.25,
+            estimated_avg: 0.12,
+            currency: "USD",
+            breakdown: {
+                input_tokens: 2000,
+                output_tokens: 3000,
+                tool_calls: 5,
+                model_cost: 0.10,
+            },
+            warnings: [],
+        };
+        return { data: mockEstimate, error: undefined, response: new Response() };
+    }
+    // MOCK - Simulated setBudgetForRun
+    /**
+     * Set a hard budget cap for a specific run.
+     */
+    async setBudgetForRun(runId, limit) {
+        // MOCK - Returns simulated data
+        return {
+            data: { run_id: runId, limit },
+            error: undefined,
+            response: new Response()
+        };
+    }
+}

package/dist/modules/builder.d.ts

@@ -45,9 +45,9 @@ export type BuilderChatResponse = {
     thread_id: string;
 };
 export declare class BuilderModule {
-    private kernelBaseUrl;
+    private baseUrl;
     private headers;
-    constructor(kernelBaseUrl: string, headers: () => Record<string, string>);
+    constructor(baseUrl: string, headers: () => Record<string, string>);
     /**
      * Stream chat with meta-agent (SSE).
      * Returns async generator of events.

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

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/modules/builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE7E,MAAM,MAAM,kBAAkB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GACxB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,aAAa;IAElB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,OAAO;gBADP,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAGjD;;;OAGG;IACI,IAAI,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,UAAU,GACrB,cAAc,CAAC,kBAAkB,CAAC;IA8DrC;;OAEG;IACG,QAAQ,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAoB/B;;OAEG;IACG,WAAW,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;CAqBlC"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/modules/builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE7E,MAAM,MAAM,kBAAkB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GACxB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,aAAa;IAElB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;gBADP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAGjD;;;OAGG;IACI,IAAI,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,UAAU,GACrB,cAAc,CAAC,kBAAkB,CAAC;IA8DrC;;OAEG;IACG,QAAQ,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAoB/B;;OAEG;IACG,WAAW,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;CAqBlC"}

package/dist/modules/builder.js

@@ -6,10 +6,10 @@
  */
 import { streamSSE } from "../sse/client.js";
 export class BuilderModule {
-    kernelBaseUrl;
+    baseUrl;
     headers;
-    constructor(kernelBaseUrl, headers) {
-        this.kernelBaseUrl = kernelBaseUrl;
+    constructor(baseUrl, headers) {
+        this.baseUrl = baseUrl;
         this.headers = headers;
     }
     /**
@@ -17,7 +17,7 @@ export class BuilderModule {
      * Returns async generator of events.
      */
     async *chat(agentId, request, options) {
-        const url = `${this.kernelBaseUrl}/v1/internal/builder/${agentId}/chat`;
+        const url = `${this.baseUrl}/v1/internal/builder/${agentId}/chat`;
         const response = await fetch(url, {
             method: "POST",
             headers: {
@@ -77,7 +77,7 @@ export class BuilderModule {
      * Sync chat with meta-agent (no streaming).
      */
     async chatSync(agentId, request) {
-        const url = `${this.kernelBaseUrl}/v1/internal/builder/${agentId}/chat/sync`;
+        const url = `${this.baseUrl}/v1/internal/builder/${agentId}/chat/sync`;
         const response = await fetch(url, {
             method: "POST",
             headers: {

package/dist/modules/capabilities.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 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";
+export interface Capability {
+    id: string;
+    name: string;
+    description?: string;
+    type: "tool" | "network" | "file" | "mcp" | "token" | "custom";
+    config: CapabilityConfig;
+}
+export interface CapabilityConfig {
+    tool_allowlist?: string[];
+    tool_denylist?: string[];
+    max_tool_calls?: number;
+    allowed_domains?: string[];
+    blocked_domains?: string[];
+    allow_egress?: boolean;
+    file_read?: boolean;
+    file_write?: boolean;
+    allowed_paths?: string[];
+    mcp_server_allowlist?: string[];
+    max_tokens?: number;
+    max_input_tokens?: number;
+    max_output_tokens?: number;
+    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;
+}
+export declare class CapabilitiesModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * Get capabilities for an agent.
+     */
+    getForAgent(agentId: string): Promise<APIResponse<CapabilitySet>>;
+    /**
+     * Set capabilities for an agent.
+     */
+    setForAgent(agentId: string, capabilities: Capability[]): Promise<APIResponse<CapabilitySet>>;
+    /**
+     * Get effective capabilities for a run.
+     */
+    getForRun(runId: string): Promise<APIResponse<CapabilitySet>>;
+    /**
+     * Override capabilities for a specific run.
+     */
+    overrideForRun(runId: string, overrides: Partial<CapabilityConfig>, reason?: string): Promise<APIResponse<CapabilityOverride>>;
+}
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/modules/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/D,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC/D,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAE7B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAGzB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAGhC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAMD,qBAAa,kBAAkB;IACf,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAGpF;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAwCvE;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAWnG;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAsBnE;;OAEG;IACG,cAAc,CAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC,EACpC,MAAM,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;CAW9C"}

package/dist/modules/capabilities.js

@@ -0,0 +1,113 @@
+/**
+ * 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.
+ */
+// ============================================================================
+// Module
+// ============================================================================
+export class CapabilitiesModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    // MOCK - Simulated get for agent
+    /**
+     * Get capabilities for an agent.
+     */
+    async getForAgent(agentId) {
+        // MOCK - Returns simulated data
+        const mockCaps = {
+            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, capabilities) {
+        // MOCK - Returns simulated data
+        const mockCaps = {
+            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) {
+        // MOCK - Returns simulated data
+        const mockCaps = {
+            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, overrides, reason) {
+        // MOCK - Returns simulated data
+        const mockOverride = {
+            run_id: runId,
+            overrides,
+            reason,
+            applied_at: new Date().toISOString(),
+            applied_by: "user_123",
+        };
+        return { data: mockOverride, error: undefined, response: new Response() };
+    }
+}

package/dist/modules/deployments.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 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";
+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;
+}
+export declare class DeploymentsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List all environments.
+     */
+    listEnvironments(): Promise<APIResponse<EnvironmentListResponse>>;
+    /**
+     * Create a new environment.
+     */
+    createEnvironment(body: {
+        name: string;
+        type: EnvironmentType;
+        description?: string;
+        config?: Record<string, unknown>;
+    }): Promise<APIResponse<Environment>>;
+    /**
+     * Get deployment history for an environment.
+     */
+    history(environmentId: string): Promise<APIResponse<DeploymentListResponse>>;
+    /**
+     * Promote an agent version to an environment.
+     */
+    promote(agentVersionId: string, environmentId: string, options?: {
+        notes?: string;
+    }): Promise<APIResponse<Deployment>>;
+    /**
+     * Rollback an environment to a previous version.
+     */
+    rollback(environmentId: string, toVersionId?: string): Promise<APIResponse<Deployment>>;
+    /**
+     * Start a canary deployment.
+     */
+    canary(environmentId: string, agentVersionId: string, percent: number): Promise<APIResponse<Deployment>>;
+    /**
+     * Freeze an environment (change freeze).
+     */
+    freeze(environmentId: string, options?: {
+        until?: string;
+        reason?: string;
+    }): Promise<APIResponse<Environment>>;
+    /**
+     * Unfreeze an environment.
+     */
+    unfreeze(environmentId: string): Promise<APIResponse<Environment>>;
+    /**
+     * Get diff between two versions.
+     */
+    diff(fromVersionId: string, toVersionId: string): Promise<APIResponse<DeploymentDiff>>;
+}
+//# sourceMappingURL=deployments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../../src/modules/deployments.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,cAAc,GAAG,aAAa,GAAG,QAAQ,CAAC;AAC9G,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;AAElF,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;KACtB,EAAE,CAAC;IACJ,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACjB;AAMD,qBAAa,iBAAiB;IACd,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAKpF;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;IAyCvE;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,eAAe,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAkBrC;;OAEG;IACG,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAkClF;;OAEG;IACG,OAAO,CACT,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAiBnC;;OAEG;IACG,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAiB7F;;OAEG;IACG,MAAM,CACR,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAiBnC;;OAEG;IACG,MAAM,CACR,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAiBpC;;OAEG;IACG,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAexE;;OAEG;IACG,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;CAe/F"}