@agent-os-sdk/client 0.1.0 → 0.1.2

package/src/generated/swagger.json

@@ -177,6 +177,7 @@
         "tags": [
           "Agents"
         ],
+        "summary": "Get agent by ID with tenant isolation (IDOR protected)",
         "parameters": [
           {
             "name": "id",
@@ -198,6 +199,7 @@
         "tags": [
           "Agents"
         ],
+        "summary": "Update agent by ID with tenant isolation (IDOR protected)",
         "parameters": [
           {
             "name": "id",
@@ -238,6 +240,7 @@
         "tags": [
           "Agents"
         ],
+        "summary": "Delete agent by ID with tenant isolation (IDOR protected)",
         "parameters": [
           {
             "name": "id",
@@ -359,6 +362,7 @@
         "tags": [
           "AgentVersions"
         ],
+        "summary": "Create agent version with tenant isolation (IDOR protected)",
         "parameters": [
           {
             "name": "agentId",
@@ -399,6 +403,7 @@
         "tags": [
           "AgentVersions"
         ],
+        "summary": "List agent versions with tenant isolation (IDOR protected)",
         "parameters": [
           {
             "name": "agentId",
@@ -422,6 +427,7 @@
         "tags": [
           "AgentVersions"
         ],
+        "summary": "Get specific version with tenant isolation (IDOR protected)",
         "parameters": [
           {
             "name": "agentId",
@@ -718,6 +724,92 @@
         }
       }
     },
+    "/v1/api/builder/{agentId}/chat": {
+      "post": {
+        "tags": [
+          "Builder"
+        ],
+        "summary": "Chat with the Meta-Agent to modify an agent's graph.\nReturns SSE stream: message, graph_update, done events.",
+        "parameters": [
+          {
+            "name": "agentId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/BuilderChatRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/BuilderChatRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/BuilderChatRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
+    "/v1/api/builder/{agentId}/chat/sync": {
+      "post": {
+        "tags": [
+          "Builder"
+        ],
+        "summary": "Synchronous version of builder chat (for testing).",
+        "parameters": [
+          {
+            "name": "agentId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/BuilderChatRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/BuilderChatRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/BuilderChatRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
     "/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints": {
       "get": {
         "tags": [
@@ -1073,14 +1165,6 @@
               "type": "string",
               "format": "uuid"
             }
-          },
-          {
-            "name": "X-Tenant-Id",
-            "in": "header",
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
           }
         ],
         "requestBody": {
@@ -3436,7 +3520,7 @@
         "tags": [
           "Runs"
         ],
-        "summary": "Retrieves the status and details of a specific run.",
+        "summary": "Retrieves the status and details of a specific run with tenant isolation (IDOR protected).",
         "parameters": [
           {
             "name": "runId",
@@ -6561,6 +6645,24 @@
         },
         "additionalProperties": false
       },
+      "BuilderChatRequest": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string",
+            "nullable": true
+          },
+          "current_graph_spec": {
+            "nullable": true
+          },
+          "thread_id": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Request DTO for builder chat."
+      },
       "CancelRequest": {
         "type": "object",
         "properties": {
@@ -7444,7 +7546,8 @@
             "nullable": true
           }
         },
-        "additionalProperties": false
+        "additionalProperties": false,
+        "description": "Playground request - note: TenantId/WorkspaceId from body are IGNORED,\nwe use IRequestContext for security."
       },
       "PresignedDownloadResponse": {
         "type": "object",
@@ -8470,6 +8573,9 @@
     {
       "name": "Audit"
     },
+    {
+      "name": "Builder"
+    },
     {
       "name": "Checkpoints"
     },

package/src/index.ts

@@ -105,6 +105,17 @@ export { InfoModule, type ServerInfo } from "./modules/info.js";
 export { MetricsModule, type MetricsResponse } from "./modules/metrics.js";
 export { GraphsModule, type GraphValidationResult, type GraphIntrospectionResult } from "./modules/graphs.js";
 
+// MOCK - Future modules (marked for replacement when backend is ready)
+export { HandoffModule, type HandoffOptions, type HandoffResult, type ForkOptions, type ForkResult, type RunChain, type RunChainNode, type HandoffMode, type HandoffConstraints } from "./modules/handoff.js";
+export { FlowsModule, type Flow, type FlowStep, type FlowRun, type FlowVisualization, type FlowSimulationResult, type FlowStatus, type FlowListResponse } from "./modules/flows.js";
+export { CapabilitiesModule, type Capability, type CapabilityConfig, type CapabilitySet, type CapabilityOverride } from "./modules/capabilities.js";
+export { PoliciesModule, type Policy, type PolicyType, type PolicyScope, type PolicyCondition, type PolicyAction, type PolicyEvaluationInput, type PolicyEvaluationResult, type PolicyListResponse } from "./modules/policies.js";
+export { ApprovalsModule, type Approval, type ApprovalStatus, type ApprovalRequest, type ApprovalListResponse } from "./modules/approvals.js";
+export { BudgetsModule, type Budget, type BudgetPeriod, type BudgetScope, type BudgetUsage, type BudgetBreakdown, type CostEstimate, type BudgetListResponse } from "./modules/budgets.js";
+export { DeploymentsModule, type Environment, type EnvironmentType, type Deployment, type DeploymentStatus, type DeploymentDiff, type EnvironmentListResponse, type DeploymentListResponse } from "./modules/deployments.js";
+export { IncidentsModule, type Incident, type IncidentSeverity, type IncidentStatus, type SLO, type Postmortem, type PostmortemEvent, type ActionItem, type IncidentListResponse, type SLOListResponse } from "./modules/incidents.js";
+export { ArtifactsModule, type Artifact, type ArtifactType, type ArtifactLineage, type LineageSource, type LineageTransformation, type ArtifactListResponse } from "./modules/artifacts.js";
+
 // ============================================================================
 // SSE Streaming
 // ============================================================================

package/src/modules/approvals.ts

@@ -0,0 +1,210 @@
+/**
+ * Approvals Module - Human-in-the-Loop Native
+ * 
+ * // MOCK - This module contains mock implementations for future features
+ * 
+ * Provides native support for approval workflows.
+ * Critical for production deployments with dangerous actions.
+ */
+
+import type { RawClient, APIResponse } from "../client/raw.js";
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type ApprovalStatus = "pending" | "approved" | "rejected" | "expired" | "auto_approved";
+
+export interface Approval {
+    id: string;
+    run_id: string;
+    thread_id?: string;
+    action: string;
+    payload: Record<string, unknown>;
+    status: ApprovalStatus;
+    reason?: string;
+    requested_at: string;
+    responded_at?: string;
+    responded_by?: string;
+    expires_at?: string;
+    auto_approve_after?: number; // seconds
+}
+
+export interface ApprovalRequest {
+    run_id: string;
+    action: string;
+    payload: Record<string, unknown>;
+    expires_in_seconds?: number;
+    auto_approve_after_seconds?: number;
+    notify_channels?: string[];
+}
+
+export interface ApprovalListResponse {
+    items: Approval[];
+    total: number;
+    pending_count: number;
+}
+
+export interface ApprovalDecision {
+    approval_id: string;
+    decision: "approve" | "reject";
+    reason?: string;
+    modified_payload?: Record<string, unknown>;
+}
+
+// ============================================================================
+// Module
+// ============================================================================
+
+export class ApprovalsModule {
+    constructor(private client: RawClient, private headers: () => Record<string, string>) { }
+
+    // MOCK - Simulated list
+    /**
+     * List all approvals.
+     */
+    async list(params?: {
+        status?: ApprovalStatus;
+        run_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<ApprovalListResponse>> {
+        // MOCK - Returns simulated data
+        const mockApprovals: ApprovalListResponse = {
+            items: [
+                {
+                    id: "approval_1",
+                    run_id: "run_123",
+                    thread_id: "thread_456",
+                    action: "send_email",
+                    payload: {
+                        to: "external@gmail.com",
+                        subject: "Important Update",
+                        body: "Hello, this is an important message...",
+                    },
+                    status: "pending",
+                    requested_at: new Date(Date.now() - 300000).toISOString(),
+                    expires_at: new Date(Date.now() + 3600000).toISOString(),
+                },
+                {
+                    id: "approval_2",
+                    run_id: "run_124",
+                    action: "execute_payment",
+                    payload: {
+                        amount: 1500.00,
+                        currency: "USD",
+                        recipient: "vendor@company.com",
+                    },
+                    status: "pending",
+                    requested_at: new Date(Date.now() - 600000).toISOString(),
+                    expires_at: new Date(Date.now() + 7200000).toISOString(),
+                },
+            ],
+            total: 2,
+            pending_count: 2,
+        };
+        return { data: mockApprovals, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated get
+    /**
+     * Get an approval by ID.
+     */
+    async get(approvalId: string): Promise<APIResponse<Approval>> {
+        // MOCK - Returns simulated data
+        const mockApproval: Approval = {
+            id: approvalId,
+            run_id: "run_123",
+            action: "send_email",
+            payload: {
+                to: "external@gmail.com",
+                subject: "Important Update",
+            },
+            status: "pending",
+            requested_at: new Date(Date.now() - 300000).toISOString(),
+            expires_at: new Date(Date.now() + 3600000).toISOString(),
+        };
+        return { data: mockApproval, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated create
+    /**
+     * Create a new approval request.
+     */
+    async create(request: ApprovalRequest): Promise<APIResponse<Approval>> {
+        // MOCK - Returns simulated data
+        const mockApproval: Approval = {
+            id: `approval_${Date.now()}`,
+            run_id: request.run_id,
+            action: request.action,
+            payload: request.payload,
+            status: "pending",
+            requested_at: new Date().toISOString(),
+            expires_at: request.expires_in_seconds
+                ? new Date(Date.now() + request.expires_in_seconds * 1000).toISOString()
+                : undefined,
+            auto_approve_after: request.auto_approve_after_seconds,
+        };
+        return { data: mockApproval, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated approve
+    /**
+     * Approve an action.
+     */
+    async approve(approvalId: string, reason?: string): Promise<APIResponse<Approval>> {
+        // MOCK - Returns simulated data
+        const mockApproval: Approval = {
+            id: approvalId,
+            run_id: "run_123",
+            action: "send_email",
+            payload: {},
+            status: "approved",
+            reason,
+            requested_at: new Date(Date.now() - 300000).toISOString(),
+            responded_at: new Date().toISOString(),
+            responded_by: "user_admin",
+        };
+        return { data: mockApproval, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated reject
+    /**
+     * Reject an action.
+     */
+    async reject(approvalId: string, reason?: string): Promise<APIResponse<Approval>> {
+        // MOCK - Returns simulated data
+        const mockApproval: Approval = {
+            id: approvalId,
+            run_id: "run_123",
+            action: "send_email",
+            payload: {},
+            status: "rejected",
+            reason: reason || "Action not permitted",
+            requested_at: new Date(Date.now() - 300000).toISOString(),
+            responded_at: new Date().toISOString(),
+            responded_by: "user_admin",
+        };
+        return { data: mockApproval, error: undefined, response: new Response() };
+    }
+
+    // MOCK - Simulated await
+    /**
+     * Wait for approval on a run (blocks until resolved or timeout).
+     */
+    async awaitApproval(runId: string, timeoutSeconds?: number): Promise<APIResponse<Approval>> {
+        // MOCK - Returns simulated pending approval
+        const mockApproval: Approval = {
+            id: `approval_await_${runId}`,
+            run_id: runId,
+            action: "awaiting_action",
+            payload: {},
+            status: "pending",
+            requested_at: new Date().toISOString(),
+            expires_at: timeoutSeconds
+                ? new Date(Date.now() + timeoutSeconds * 1000).toISOString()
+                : undefined,
+        };
+        return { data: mockApproval, error: undefined, response: new Response() };
+    }
+}