@agent-os-sdk/client 0.9.20 → 0.9.22

package/src/modules/agents.ts

@@ -53,6 +53,48 @@ export interface GraphValidationResponse {
     warnings?: string[];
 }
 
+export interface PublishPreviewIssue {
+    code: string;
+    message: string;
+    severity: string;
+    path?: string;
+    node_id?: string;
+    hint?: string;
+}
+
+export interface PublishPreviewValidationResult {
+    valid: boolean;
+    errors: PublishPreviewIssue[];
+    warnings: PublishPreviewIssue[];
+}
+
+export interface PublishPreviewCapabilityItem {
+    node_id: string;
+    capability_ref: string;
+    capability_version: string;
+    execution_binding: string;
+    required_credentials: string[];
+}
+
+export interface PublishPreviewBindingItem {
+    binding_key: string;
+    status: "bound" | "missing" | "ambiguous";
+    required_by_capabilities: string[];
+    credential_instance_refs: string[];
+    credential_type_refs: string[];
+}
+
+export interface PublishPreviewResponse {
+    agent_id: string;
+    draft_ir_revision: string;
+    ready: boolean;
+    validation_result: PublishPreviewValidationResult;
+    capabilities: PublishPreviewCapabilityItem[];
+    bindings: PublishPreviewBindingItem[];
+    blockers: PublishPreviewIssue[];
+    warnings: PublishPreviewIssue[];
+}
+
 export interface AgentDraftIrResponse {
     id: string;
     name: string;
@@ -308,6 +350,13 @@ export class AgentsModule {
         });
     }
 
+    async getPublishPreview(agentId: string): Promise<APIResponse<PublishPreviewResponse>> {
+        return this.client.GET<PublishPreviewResponse>("/v1/api/agents/{id}/publish-preview", {
+            params: { path: { id: agentId } },
+            headers: this.headers(),
+        });
+    }
+
     // ======================== Draft IR ========================
 
     async getDraftIr(agentId: string): Promise<APIResponse<AgentDraftIrResponse>> {

package/src/modules/metaAgent.ts

@@ -33,6 +33,42 @@ export interface MetaAgentPatchProposal {
     ops: MetaAgentPatchOp[];
 }
 
+export interface MetaAgentDiffPreview {
+    added_node_ids: string[];
+    removed_node_ids: string[];
+    updated_node_ids: string[];
+    added_edge_ids: string[];
+    removed_edge_ids: string[];
+    entrypoint_changed: boolean;
+    before_entrypoint?: string | null;
+    after_entrypoint?: string | null;
+}
+
+export interface MetaAgentBlastRadiusCredentialImpact {
+    required_credential: string;
+    status: "bound" | "missing";
+    binding_key?: string | null;
+    credential_instance_ref?: string | null;
+    credential_name?: string | null;
+}
+
+export interface MetaAgentBlastRadius {
+    affected_node_ids: string[];
+    affected_edge_ids: string[];
+    added_capabilities: string[];
+    removed_capabilities: string[];
+    changed_capabilities: string[];
+    impacted_credentials: MetaAgentBlastRadiusCredentialImpact[];
+    warnings: MetaAgentPreviewValidationIssue[];
+}
+
+export interface MetaAgentValidationResult {
+    valid: boolean;
+    preview_valid: boolean;
+    errors: MetaAgentPatchValidationIssue[];
+    warnings: MetaAgentPreviewValidationIssue[];
+}
+
 export interface MetaAgentPatchProposalResponse {
     agent_id: string;
     draft_revision?: string | null;
@@ -41,11 +77,9 @@ export interface MetaAgentPatchProposalResponse {
     mode?: "chat" | "proposal";
     patch?: MetaAgentPatchProposal | null;
     preview_draft_ir?: Record<string, unknown> | null;
-    preview_valid: boolean;
-    preview_errors: MetaAgentPreviewValidationIssue[];
-    preview_warnings: MetaAgentPreviewValidationIssue[];
-    valid: boolean;
-    errors: MetaAgentPatchValidationIssue[];
+    diff_preview?: MetaAgentDiffPreview | null;
+    blast_radius?: MetaAgentBlastRadius | null;
+    validation_result: MetaAgentValidationResult;
     message: string;
 }
 

package/src/modules/runs.ts

@@ -87,6 +87,48 @@ export interface RunEventDto {
     root_operation_id: string;
 }
 
+export interface RunInspectionResponse {
+    run: Record<string, unknown>;
+    replay: Record<string, unknown>;
+    failure: Record<string, unknown>;
+    attempts: Array<Record<string, unknown>>;
+    node_executions: Array<Record<string, unknown>>;
+    events: Array<Record<string, unknown>>;
+}
+
+export interface RunObservabilitySummaryResponse {
+    workspace_id: string;
+    agent_id?: string | null;
+    from?: string | null;
+    to?: string | null;
+    runs_total: number;
+    runs_completed: number;
+    runs_failed: number;
+    node_executions_total: number;
+    node_executions_failed: number;
+    retry_count: number;
+    replay_count: number;
+    handoff_count: number;
+    avg_run_latency_ms: number;
+    p95_run_latency_ms: number;
+    avg_node_latency_ms: number;
+    failure_rate: number;
+    top_error_categories: Array<{
+        error_category: string;
+        count: number;
+    }>;
+}
+
+export interface RunObservabilityCapabilityListResponse {
+    items: Array<Record<string, unknown>>;
+    count: number;
+}
+
+export interface RunObservabilityBindingListResponse {
+    items: Array<Record<string, unknown>>;
+    count: number;
+}
+
 export class RunsModule {
     constructor(private client: RawClient) { }
 
@@ -139,6 +181,12 @@ export class RunsModule {
         });
     }
 
+    async getInspection(runId: string): Promise<APIResponse<RunInspectionResponse>> {
+        return this.client.GET<RunInspectionResponse>("/v1/api/runs/{runId}/inspection", {
+            params: { path: { runId } },
+        });
+    }
+
     /**
      * List runs with optional filters.
      */
@@ -243,6 +291,40 @@ export class RunsModule {
         });
     }
 
+    async getObservabilitySummary(params?: {
+        agent_id?: string;
+        from?: string;
+        to?: string;
+    }): Promise<APIResponse<RunObservabilitySummaryResponse>> {
+        return this.client.GET<RunObservabilitySummaryResponse>("/v1/api/runs/observability/summary", {
+            params: { query: params },
+        });
+    }
+
+    async getObservabilityCapabilities(params?: {
+        agent_id?: string;
+        from?: string;
+        to?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<RunObservabilityCapabilityListResponse>> {
+        return this.client.GET<RunObservabilityCapabilityListResponse>("/v1/api/runs/observability/capabilities", {
+            params: { query: params },
+        });
+    }
+
+    async getObservabilityBindings(params?: {
+        agent_id?: string;
+        from?: string;
+        to?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<RunObservabilityBindingListResponse>> {
+        return this.client.GET<RunObservabilityBindingListResponse>("/v1/api/runs/observability/bindings", {
+            params: { query: params },
+        });
+    }
+
     /**
      * Resume a run waiting for human input (HITL).
      * After the run reaches status 'waiting_for_human', use this to provide