@agent-os-sdk/client 0.9.20 → 0.9.21

package/dist/generated/openapi.d.ts

@@ -6059,6 +6059,276 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/api/runs/{runId}/inspection": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Returns the official runtime inspection surface for a run.
+         * @description This endpoint is the supported read model for operational inspection over the canonical runtime ledger.
+         *     It explains a run through:
+         *     - run summary
+         *     - replay metadata
+         *     - failure summary
+         *     - attempts
+         *     - node execution timeline
+         *     - event timeline
+         *
+         *     Consumers should prefer this endpoint over raw table archaeology.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    runId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RunInspectionResponse"];
+                    };
+                };
+                /** @description Not Found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api/runs/failures": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: {
+            parameters: {
+                query?: {
+                    agentId?: string;
+                    capabilityRef?: string;
+                    errorCategory?: string;
+                    retryable?: boolean;
+                    from?: string;
+                    to?: string;
+                    limit?: number;
+                    offset?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RunFailureRetentionListResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api/runs/failures/{failureId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    failureId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RunFailureRetentionDetailResponse"];
+                    };
+                };
+                /** @description Not Found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ProblemDetails"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api/runs/observability/summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: {
+            parameters: {
+                query?: {
+                    agentId?: string;
+                    from?: string;
+                    to?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RunObservabilitySummaryResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api/runs/observability/capabilities": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: {
+            parameters: {
+                query?: {
+                    agentId?: string;
+                    from?: string;
+                    to?: string;
+                    limit?: number;
+                    offset?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RunObservabilityCapabilityListResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api/runs/observability/bindings": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: {
+            parameters: {
+                query?: {
+                    agentId?: string;
+                    from?: string;
+                    to?: string;
+                    limit?: number;
+                    offset?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RunObservabilityBindingListResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/api/runs/{runId}/operations/transitions": {
         parameters: {
             query?: never;
@@ -10431,9 +10701,35 @@ export interface components {
             applied_by?: string | null;
             draft_ir?: unknown;
         };
+        MetaAgentBlastRadius: {
+            affected_node_ids?: string[] | null;
+            affected_edge_ids?: string[] | null;
+            added_capabilities?: string[] | null;
+            removed_capabilities?: string[] | null;
+            changed_capabilities?: string[] | null;
+            impacted_credentials?: components["schemas"]["MetaAgentBlastRadiusCredentialImpact"][] | null;
+            warnings?: components["schemas"]["MetaAgentPreviewValidationIssue"][] | null;
+        };
+        MetaAgentBlastRadiusCredentialImpact: {
+            required_credential?: string | null;
+            status?: string | null;
+            binding_key?: string | null;
+            credential_instance_ref?: string | null;
+            credential_name?: string | null;
+        };
         MetaAgentChatRequest: {
             message?: string | null;
         };
+        MetaAgentDiffPreview: {
+            added_node_ids?: string[] | null;
+            removed_node_ids?: string[] | null;
+            updated_node_ids?: string[] | null;
+            added_edge_ids?: string[] | null;
+            removed_edge_ids?: string[] | null;
+            entrypoint_changed?: boolean;
+            before_entrypoint?: string | null;
+            after_entrypoint?: string | null;
+        };
         MetaAgentPatchOpResponse: {
             op?: string | null;
             node_id?: string | null;
@@ -10455,11 +10751,9 @@ export interface components {
             mode?: string | null;
             patch?: components["schemas"]["MetaAgentPatchProposalResponse"];
             preview_draft_ir?: unknown;
-            preview_valid?: boolean;
-            preview_errors?: components["schemas"]["MetaAgentPreviewValidationIssue"][] | null;
-            preview_warnings?: components["schemas"]["MetaAgentPreviewValidationIssue"][] | null;
-            valid?: boolean;
-            errors?: components["schemas"]["MetaAgentPatchValidationIssue"][] | null;
+            diff_preview?: components["schemas"]["MetaAgentDiffPreview"];
+            blast_radius?: components["schemas"]["MetaAgentBlastRadius"];
+            validation_result?: components["schemas"]["MetaAgentValidationResult"];
             message?: string | null;
         };
         MetaAgentPatchProposalResponse: {
@@ -10482,6 +10776,12 @@ export interface components {
         MetaAgentProposePatchRequest: {
             instruction?: string | null;
         };
+        MetaAgentValidationResult: {
+            valid?: boolean;
+            preview_valid?: boolean;
+            errors?: components["schemas"]["MetaAgentPatchValidationIssue"][] | null;
+            warnings?: components["schemas"]["MetaAgentPreviewValidationIssue"][] | null;
+        };
         NodeCatalogResponse: {
             version: string;
             nodes: components["schemas"]["NodeTypeDto"][];
@@ -10745,6 +11045,235 @@ export interface components {
             next_after_seq?: number | null;
             has_more?: boolean;
         };
+        RunFailureRetentionDetailResponse: {
+            failure?: components["schemas"]["RunFailureRetentionItem"];
+            payload?: unknown;
+        };
+        RunFailureRetentionItem: {
+            /** Format: uuid */
+            failure_id?: string;
+            failure_scope?: string | null;
+            /** Format: uuid */
+            run_id?: string;
+            /** Format: uuid */
+            attempt_id?: string;
+            /** Format: int32 */
+            attempt_no?: number;
+            /** Format: uuid */
+            agent_id?: string | null;
+            /** Format: uuid */
+            thread_id?: string;
+            /** Format: uuid */
+            node_execution_id?: string | null;
+            /** Format: uuid */
+            operation_id?: string | null;
+            capability_ref?: string | null;
+            capability_version?: string | null;
+            execution_binding?: string | null;
+            source_kind?: string | null;
+            ancestry_kind?: string | null;
+            status?: string | null;
+            error_code?: string | null;
+            error_category?: string | null;
+            is_retryable?: boolean;
+            error_source?: string | null;
+            provider_error_code?: string | null;
+            error_summary?: string | null;
+            /** Format: uuid */
+            retried_from_node_execution_id?: string | null;
+            /** Format: uuid */
+            replayed_from_node_execution_id?: string | null;
+            can_retry?: boolean;
+            /** Format: uuid */
+            retry_from_node_execution_id?: string | null;
+            can_replay?: boolean;
+            /** Format: uuid */
+            replay_from_node_execution_id?: string | null;
+            /** Format: date-time */
+            failed_at?: string;
+            /** Format: date-time */
+            created_at?: string;
+        };
+        RunFailureRetentionListResponse: {
+            items?: components["schemas"]["RunFailureRetentionItem"][] | null;
+            /** Format: int32 */
+            count?: number;
+        };
+        RunInspectionAttemptItem: {
+            /** Format: uuid */
+            attempt_id?: string;
+            /** Format: int32 */
+            attempt_no?: number;
+            cause?: string | null;
+            status?: string | null;
+            /** Format: int64 */
+            latest_seq?: number;
+            /** Format: int64 */
+            lease_epoch?: number;
+            /** Format: uuid */
+            replayed_from_attempt_id?: string | null;
+            error_code?: string | null;
+            error_category?: string | null;
+            is_retryable?: boolean | null;
+            error_source?: string | null;
+            provider_error_code?: string | null;
+            error_summary?: string | null;
+            error?: unknown;
+            /** Format: date-time */
+            started_at?: string | null;
+            /** Format: date-time */
+            finished_at?: string | null;
+            /** Format: date-time */
+            created_at?: string;
+        };
+        RunInspectionEventItem: {
+            /** Format: uuid */
+            event_id?: string;
+            /** Format: uuid */
+            attempt_id?: string;
+            /** Format: int32 */
+            attempt_no?: number;
+            /** Format: int64 */
+            seq?: number;
+            /** Format: int64 */
+            run_attempt_transition_seq?: number;
+            event_type_code?: string | null;
+            source_kind?: string | null;
+            /** Format: date-time */
+            timestamp?: string;
+            /** Format: uuid */
+            operation_id?: string;
+            /** Format: uuid */
+            parent_operation_id?: string | null;
+            /** Format: uuid */
+            root_operation_id?: string;
+            node_id?: string | null;
+            capability_ref?: string | null;
+            capability_version?: string | null;
+            execution_binding?: string | null;
+            error_code?: string | null;
+            error_category?: string | null;
+            is_retryable?: boolean | null;
+            error_source?: string | null;
+            provider_error_code?: string | null;
+            error_summary?: string | null;
+            payload?: unknown;
+        };
+        RunInspectionFailureSummary: {
+            has_failures?: boolean;
+            run_error_code?: string | null;
+            run_error_category?: string | null;
+            run_is_retryable?: boolean | null;
+            run_error_source?: string | null;
+            run_provider_error_code?: string | null;
+            run_error_summary?: string | null;
+            run_error?: unknown;
+            /** Format: int32 */
+            failed_attempt_count?: number;
+            /** Format: int32 */
+            failed_node_execution_count?: number;
+        };
+        RunInspectionNodeExecutionItem: {
+            /** Format: uuid */
+            node_execution_id?: string;
+            /** Format: uuid */
+            attempt_id?: string;
+            /** Format: int32 */
+            attempt_no?: number;
+            /** Format: uuid */
+            operation_id?: string;
+            /** Format: uuid */
+            parent_operation_id?: string | null;
+            /** Format: uuid */
+            root_operation_id?: string;
+            node_id?: string | null;
+            capability_ref?: string | null;
+            capability_version?: string | null;
+            execution_binding?: string | null;
+            source_kind?: string | null;
+            is_root_execution?: boolean;
+            ancestry_kind?: string | null;
+            event_type_code?: string | null;
+            /** Format: int64 */
+            first_seq?: number;
+            /** Format: int64 */
+            last_seq?: number;
+            /** Format: int64 */
+            first_run_attempt_transition_seq?: number;
+            /** Format: int64 */
+            last_run_attempt_transition_seq?: number;
+            latest_transition_reason?: string | null;
+            latest_transition_actor_type?: string | null;
+            status?: string | null;
+            error_code?: string | null;
+            error_category?: string | null;
+            is_retryable?: boolean | null;
+            error_source?: string | null;
+            provider_error_code?: string | null;
+            error_summary?: string | null;
+            /** Format: date-time */
+            started_at?: string;
+            /** Format: date-time */
+            finished_at?: string | null;
+            /** Format: uuid */
+            replayed_from_node_execution_id?: string | null;
+            /** Format: uuid */
+            retried_from_node_execution_id?: string | null;
+            /** Format: int32 */
+            event_count?: number;
+        };
+        RunInspectionReplayMetadata: {
+            replay_mode?: string | null;
+            replay_reason?: string | null;
+            /** Format: uuid */
+            replayed_from_run_id?: string | null;
+            /** Format: uuid */
+            replayed_from_checkpoint_id?: string | null;
+            runtime_contract_snapshot?: unknown;
+        };
+        RunInspectionResponse: {
+            run?: components["schemas"]["RunInspectionRunSummary"];
+            replay?: components["schemas"]["RunInspectionReplayMetadata"];
+            failure?: components["schemas"]["RunInspectionFailureSummary"];
+            attempts?: components["schemas"]["RunInspectionAttemptItem"][] | null;
+            node_executions?: components["schemas"]["RunInspectionNodeExecutionItem"][] | null;
+            events?: components["schemas"]["RunInspectionEventItem"][] | null;
+        };
+        RunInspectionRunSummary: {
+            /** Format: uuid */
+            run_id?: string;
+            /** Format: uuid */
+            tenant_id?: string;
+            /** Format: uuid */
+            workspace_id?: string;
+            /** Format: uuid */
+            agent_id?: string | null;
+            /** Format: uuid */
+            bundle_id?: string | null;
+            bundle_sha256?: string | null;
+            /** Format: uuid */
+            thread_id?: string;
+            status?: string | null;
+            /** Format: uuid */
+            current_attempt_id?: string | null;
+            /** Format: int32 */
+            current_attempt_no?: number | null;
+            /** Format: int64 */
+            latest_seq?: number | null;
+            prompt_hash?: string | null;
+            toolset_hash?: string | null;
+            /** Format: date-time */
+            started_at?: string | null;
+            /** Format: date-time */
+            completed_at?: string | null;
+            /** Format: date-time */
+            created_at?: string;
+            /** Format: double */
+            duration_ms?: number | null;
+            input?: unknown;
+            output?: unknown;
+            metrics?: unknown;
+        };
         RunKpiResultDetailItem: {
             /** Format: uuid */
             kpi_result_id?: string;
@@ -10791,6 +11320,96 @@ export interface components {
             limit?: number;
             has_more?: boolean;
         };
+        RunObservabilityBindingItem: {
+            execution_binding?: string | null;
+            /** Format: int32 */
+            capability_count?: number;
+            /** Format: int32 */
+            node_executions_total?: number;
+            /** Format: int32 */
+            node_executions_failed?: number;
+            /** Format: double */
+            failure_rate?: number;
+            /** Format: double */
+            avg_latency_ms?: number;
+            /** Format: int32 */
+            retry_count?: number;
+            /** Format: int32 */
+            replay_count?: number;
+            top_error_category?: string | null;
+            /** Format: date-time */
+            last_seen_at?: string | null;
+        };
+        RunObservabilityBindingListResponse: {
+            items?: components["schemas"]["RunObservabilityBindingItem"][] | null;
+            /** Format: int32 */
+            count?: number;
+        };
+        RunObservabilityCapabilityItem: {
+            capability_ref?: string | null;
+            capability_version?: string | null;
+            execution_binding?: string | null;
+            /** Format: int32 */
+            node_executions_total?: number;
+            /** Format: int32 */
+            node_executions_failed?: number;
+            /** Format: double */
+            failure_rate?: number;
+            /** Format: double */
+            avg_latency_ms?: number;
+            /** Format: int32 */
+            retry_count?: number;
+            /** Format: int32 */
+            replay_count?: number;
+            top_error_category?: string | null;
+            /** Format: date-time */
+            last_seen_at?: string | null;
+        };
+        RunObservabilityCapabilityListResponse: {
+            items?: components["schemas"]["RunObservabilityCapabilityItem"][] | null;
+            /** Format: int32 */
+            count?: number;
+        };
+        RunObservabilityErrorCategoryItem: {
+            error_category?: string | null;
+            /** Format: int32 */
+            count?: number;
+        };
+        RunObservabilitySummaryResponse: {
+            /** Format: uuid */
+            workspace_id?: string;
+            /** Format: uuid */
+            agent_id?: string | null;
+            /** Format: date-time */
+            from?: string | null;
+            /** Format: date-time */
+            to?: string | null;
+            /** Format: int32 */
+            runs_total?: number;
+            /** Format: int32 */
+            runs_completed?: number;
+            /** Format: int32 */
+            runs_failed?: number;
+            /** Format: int32 */
+            node_executions_total?: number;
+            /** Format: int32 */
+            node_executions_failed?: number;
+            /** Format: int32 */
+            retry_count?: number;
+            /** Format: int32 */
+            replay_count?: number;
+            /** Format: int32 */
+            handoff_count?: number;
+            /** Format: double */
+            avg_run_latency_ms?: number;
+            /** Format: double */
+            p95_run_latency_ms?: number;
+            /** Format: double */
+            avg_node_latency_ms?: number;
+            /** Format: double */
+            failure_rate?: number;
+            top_error_categories?: components["schemas"]["RunObservabilityErrorCategoryItem"][] | null;
+        };
         RunOutcomeDetailItem: {
             /** Format: uuid */
             outcome_id?: string;
@@ -11080,11 +11699,13 @@ export interface components {
             created_at?: string;
         };
         TriggerTemplateDto: {
-            capability_ref?: string | null;
-            capability_version?: string | null;
-            slug: string | null;
-            kind: string | null;
-            title: string | null;
+            capability_ref: string;
+            capability_version: string;
+            execution_binding: string;
+            required_credentials: string[];
+            slug: string;
+            kind: string;
+            title: string;
             description?: string | null;
             run_input_schema?: unknown;
             example_payload?: unknown;