6697 lines
165 KiB
TypeScript
6697 lines
165 KiB
TypeScript
// Generated by `pnpm contract:write`. Do not edit by hand.
|
|
// These are compile-time wire types, not runtime decoders or authorization.
|
|
|
|
export type WorkflowOperationName =
|
|
| "workflow.admin.auth.delete"
|
|
| "workflow.admin.auth.inspect"
|
|
| "workflow.admin.auth.list"
|
|
| "workflow.admin.auth.save"
|
|
| "workflow.admin.connection_statuses.list"
|
|
| "workflow.admin.connections.list"
|
|
| "workflow.admin.events.list"
|
|
| "workflow.admin.source_registry.add"
|
|
| "workflow.admin.source_registry.apply"
|
|
| "workflow.admin.source_registry.disable"
|
|
| "workflow.admin.source_registry.enable"
|
|
| "workflow.admin.source_registry.inspect"
|
|
| "workflow.admin.source_registry.list"
|
|
| "workflow.admin.source_registry.remove"
|
|
| "workflow.admin.source_registry.update"
|
|
| "workflow.artifacts.create_from_plan"
|
|
| "workflow.artifacts.delete"
|
|
| "workflow.artifacts.inspect"
|
|
| "workflow.artifacts.list"
|
|
| "workflow.artifacts.save"
|
|
| "workflow.artifacts.validate_plan"
|
|
| "workflow.capabilities.call"
|
|
| "workflow.capabilities.inspect"
|
|
| "workflow.capabilities.list"
|
|
| "workflow.deployments.delete"
|
|
| "workflow.deployments.inspect"
|
|
| "workflow.deployments.list"
|
|
| "workflow.deployments.save"
|
|
| "workflow.deployments.validate"
|
|
| "workflow.draft_workspaces.add_step"
|
|
| "workflow.draft_workspaces.add_step_from_capability"
|
|
| "workflow.draft_workspaces.bind"
|
|
| "workflow.draft_workspaces.branch"
|
|
| "workflow.draft_workspaces.compile"
|
|
| "workflow.draft_workspaces.create_artifact"
|
|
| "workflow.draft_workspaces.create_empty"
|
|
| "workflow.draft_workspaces.create_from_capability"
|
|
| "workflow.draft_workspaces.create_wrapper"
|
|
| "workflow.draft_workspaces.delete"
|
|
| "workflow.draft_workspaces.get"
|
|
| "workflow.draft_workspaces.handle"
|
|
| "workflow.draft_workspaces.inspect_authoring_contract"
|
|
| "workflow.draft_workspaces.list"
|
|
| "workflow.draft_workspaces.patch"
|
|
| "workflow.draft_workspaces.remove_binding"
|
|
| "workflow.draft_workspaces.remove_route"
|
|
| "workflow.draft_workspaces.remove_step"
|
|
| "workflow.draft_workspaces.replace_document"
|
|
| "workflow.draft_workspaces.set_contract"
|
|
| "workflow.draft_workspaces.set_name"
|
|
| "workflow.draft_workspaces.set_route"
|
|
| "workflow.draft_workspaces.set_start"
|
|
| "workflow.draft_workspaces.set_step_input_bindings"
|
|
| "workflow.draft_workspaces.set_step_input_map"
|
|
| "workflow.draft_workspaces.set_step_output_bindings"
|
|
| "workflow.draft_workspaces.set_step_output_map"
|
|
| "workflow.draft_workspaces.set_workflow_output_bindings"
|
|
| "workflow.draft_workspaces.set_workflow_output_map"
|
|
| "workflow.draft_workspaces.update_capability_step"
|
|
| "workflow.draft_workspaces.validate"
|
|
| "workflow.drafts.create_from_capability"
|
|
| "workflow.drafts.patch"
|
|
| "workflow.drafts.validate"
|
|
| "workflow.health"
|
|
| "workflow.runs.inspect"
|
|
| "workflow.runs.list"
|
|
| "workflow.runs.resume"
|
|
| "workflow.runs.start"
|
|
| "workflow.runs.trace"
|
|
| "workflow.sources.diagnose"
|
|
| "workflow.sources.inspect"
|
|
| "workflow.sources.list";
|
|
|
|
export const workflowOperationNames: readonly WorkflowOperationName[] = [
|
|
"workflow.admin.auth.delete",
|
|
"workflow.admin.auth.inspect",
|
|
"workflow.admin.auth.list",
|
|
"workflow.admin.auth.save",
|
|
"workflow.admin.connection_statuses.list",
|
|
"workflow.admin.connections.list",
|
|
"workflow.admin.events.list",
|
|
"workflow.admin.source_registry.add",
|
|
"workflow.admin.source_registry.apply",
|
|
"workflow.admin.source_registry.disable",
|
|
"workflow.admin.source_registry.enable",
|
|
"workflow.admin.source_registry.inspect",
|
|
"workflow.admin.source_registry.list",
|
|
"workflow.admin.source_registry.remove",
|
|
"workflow.admin.source_registry.update",
|
|
"workflow.artifacts.create_from_plan",
|
|
"workflow.artifacts.delete",
|
|
"workflow.artifacts.inspect",
|
|
"workflow.artifacts.list",
|
|
"workflow.artifacts.save",
|
|
"workflow.artifacts.validate_plan",
|
|
"workflow.capabilities.call",
|
|
"workflow.capabilities.inspect",
|
|
"workflow.capabilities.list",
|
|
"workflow.deployments.delete",
|
|
"workflow.deployments.inspect",
|
|
"workflow.deployments.list",
|
|
"workflow.deployments.save",
|
|
"workflow.deployments.validate",
|
|
"workflow.draft_workspaces.add_step",
|
|
"workflow.draft_workspaces.add_step_from_capability",
|
|
"workflow.draft_workspaces.bind",
|
|
"workflow.draft_workspaces.branch",
|
|
"workflow.draft_workspaces.compile",
|
|
"workflow.draft_workspaces.create_artifact",
|
|
"workflow.draft_workspaces.create_empty",
|
|
"workflow.draft_workspaces.create_from_capability",
|
|
"workflow.draft_workspaces.create_wrapper",
|
|
"workflow.draft_workspaces.delete",
|
|
"workflow.draft_workspaces.get",
|
|
"workflow.draft_workspaces.handle",
|
|
"workflow.draft_workspaces.inspect_authoring_contract",
|
|
"workflow.draft_workspaces.list",
|
|
"workflow.draft_workspaces.patch",
|
|
"workflow.draft_workspaces.remove_binding",
|
|
"workflow.draft_workspaces.remove_route",
|
|
"workflow.draft_workspaces.remove_step",
|
|
"workflow.draft_workspaces.replace_document",
|
|
"workflow.draft_workspaces.set_contract",
|
|
"workflow.draft_workspaces.set_name",
|
|
"workflow.draft_workspaces.set_route",
|
|
"workflow.draft_workspaces.set_start",
|
|
"workflow.draft_workspaces.set_step_input_bindings",
|
|
"workflow.draft_workspaces.set_step_input_map",
|
|
"workflow.draft_workspaces.set_step_output_bindings",
|
|
"workflow.draft_workspaces.set_step_output_map",
|
|
"workflow.draft_workspaces.set_workflow_output_bindings",
|
|
"workflow.draft_workspaces.set_workflow_output_map",
|
|
"workflow.draft_workspaces.update_capability_step",
|
|
"workflow.draft_workspaces.validate",
|
|
"workflow.drafts.create_from_capability",
|
|
"workflow.drafts.patch",
|
|
"workflow.drafts.validate",
|
|
"workflow.health",
|
|
"workflow.runs.inspect",
|
|
"workflow.runs.list",
|
|
"workflow.runs.resume",
|
|
"workflow.runs.start",
|
|
"workflow.runs.trace",
|
|
"workflow.sources.diagnose",
|
|
"workflow.sources.inspect",
|
|
"workflow.sources.list",
|
|
];
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ArtifactKindPayload".
|
|
*/
|
|
export type ArtifactKindPayload = "workflow" | "wrapper";
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "CapabilityKindPayload".
|
|
*/
|
|
export type CapabilityKindPayload = "tool" | "resource" | "prompt" | "node_spec" | "reducer" | "workflow";
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "InspectCapabilityResult".
|
|
*/
|
|
export type InspectCapabilityResult = NodeSpecCapabilityDetail | WrapperArtifactCapabilityDetail;
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "StepInputBinding".
|
|
*/
|
|
export type StepInputBinding = InputPathBinding | InputValueBinding | InputExpressionBinding;
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "JsonValue".
|
|
*/
|
|
export type JsonValue =
|
|
| boolean
|
|
| number
|
|
| string
|
|
| JsonValue[]
|
|
| {
|
|
[k: string]: JsonValue;
|
|
}
|
|
| null;
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "InputExpression".
|
|
*/
|
|
export type InputExpression = LiteralExpression | PathExpression | ArrayExpression | ObjectExpression;
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "CompileDraftWorkspaceResult".
|
|
*/
|
|
export type CompileDraftWorkspaceResult = CompileDraftWorkspaceSuccess | InvalidDraftResult;
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "CreateArtifactFromWorkspaceResult".
|
|
*/
|
|
export type CreateArtifactFromWorkspaceResult = SavedDraftArtifactResult | UnsavedDraftArtifactResult;
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "AuthoringPathAvailability".
|
|
*/
|
|
export type AuthoringPathAvailability = "available" | "conditional";
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "AuthoringPathOrigin".
|
|
*/
|
|
export type AuthoringPathOrigin =
|
|
"workflow_input" | "workflow_state" | "runtime_context" | "step_input" | "step_output" | "workflow_output";
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "AuthoringPathUse".
|
|
*/
|
|
export type AuthoringPathUse = "step_input" | "step_output_source" | "state_target" | "workflow_output";
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "PatchDraftResult".
|
|
*/
|
|
export type PatchDraftResult = PatchedDraftValidResult | PatchedDraftInvalidResult;
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ValidateDraftResult".
|
|
*/
|
|
export type ValidateDraftResult = ValidDraftResult | InvalidDraftResult;
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ResumeReadiness".
|
|
*/
|
|
export type ResumeReadiness = string;
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "RunStatus".
|
|
*/
|
|
export type RunStatus = string;
|
|
|
|
export interface WorkflowContractMap {
|
|
"workflow.admin.auth.delete": {
|
|
params: {
|
|
auth_ref: string;
|
|
};
|
|
result: DeleteAuthRecordResult;
|
|
};
|
|
"workflow.admin.auth.inspect": {
|
|
params: {
|
|
auth_ref: string;
|
|
};
|
|
result: AuthRecordSummaryPayload;
|
|
};
|
|
"workflow.admin.auth.list": {
|
|
params: Record<string, never>;
|
|
result: ListAuthRecordsResult;
|
|
};
|
|
"workflow.admin.auth.save": {
|
|
params: {
|
|
auth_ref: string;
|
|
scheme: string;
|
|
payload?: {
|
|
[k: string]: unknown;
|
|
};
|
|
metadata?: {
|
|
[k: string]: unknown;
|
|
};
|
|
};
|
|
result: AuthRecordSummaryPayload;
|
|
};
|
|
"workflow.admin.connection_statuses.list": {
|
|
params: Record<string, never>;
|
|
result: ListConnectionStatusesResult;
|
|
};
|
|
"workflow.admin.connections.list": {
|
|
params: Record<string, never>;
|
|
result: ListConnectionsResult;
|
|
};
|
|
"workflow.admin.events.list": {
|
|
params: Record<string, never>;
|
|
result: ListAdminEventsResult;
|
|
};
|
|
"workflow.admin.source_registry.add": {
|
|
params: {
|
|
entry: {
|
|
[k: string]: unknown;
|
|
};
|
|
};
|
|
result: RegistryEntryMutationResult;
|
|
};
|
|
"workflow.admin.source_registry.apply": {
|
|
params: Record<string, never>;
|
|
result: ApplyRegistryChangesResult;
|
|
};
|
|
"workflow.admin.source_registry.disable": {
|
|
params: {
|
|
source_id: string;
|
|
};
|
|
result: RegistryEntryMutationResult;
|
|
};
|
|
"workflow.admin.source_registry.enable": {
|
|
params: {
|
|
source_id: string;
|
|
};
|
|
result: RegistryEntryMutationResult;
|
|
};
|
|
"workflow.admin.source_registry.inspect": {
|
|
params: {
|
|
source_id: string;
|
|
};
|
|
result: InspectRegistryEntryResult;
|
|
};
|
|
"workflow.admin.source_registry.list": {
|
|
params: {
|
|
cursor?: string | null;
|
|
limit?: number;
|
|
};
|
|
result: ListRegistryEntriesResult;
|
|
};
|
|
"workflow.admin.source_registry.remove": {
|
|
params: {
|
|
source_id: string;
|
|
};
|
|
result: RemoveRegistryEntryResult;
|
|
};
|
|
"workflow.admin.source_registry.update": {
|
|
params: {
|
|
source_id: string;
|
|
patch: {
|
|
[k: string]: unknown;
|
|
};
|
|
};
|
|
result: RegistryEntryMutationResult;
|
|
};
|
|
"workflow.artifacts.create_from_plan": {
|
|
params: {
|
|
artifact_id: string;
|
|
version: number;
|
|
title: string;
|
|
plan: {
|
|
[k: string]: unknown;
|
|
};
|
|
outcomes: string[];
|
|
kind?: "workflow" | "wrapper";
|
|
description?: string | null;
|
|
required_capabilities?: {
|
|
[k: string]: {
|
|
[k: string]: unknown;
|
|
};
|
|
} | null;
|
|
source_bindings?: {
|
|
[k: string]: string;
|
|
} | null;
|
|
created_from_catalog_version?: string | null;
|
|
};
|
|
result: SaveArtifactResult;
|
|
};
|
|
"workflow.artifacts.delete": {
|
|
params: {
|
|
artifact_id: string;
|
|
version: number;
|
|
};
|
|
result: DeleteArtifactResult;
|
|
};
|
|
"workflow.artifacts.inspect": {
|
|
params: {
|
|
artifact_id: string;
|
|
version: number;
|
|
};
|
|
result: WorkflowArtifactPayload;
|
|
};
|
|
"workflow.artifacts.list": {
|
|
params: {
|
|
query?: string | null;
|
|
kind?: ("workflow" | "wrapper") | null;
|
|
cursor?: string | null;
|
|
limit?: number;
|
|
};
|
|
result: ListArtifactsResult;
|
|
};
|
|
"workflow.artifacts.save": {
|
|
params: {
|
|
artifact: {
|
|
[k: string]: unknown;
|
|
};
|
|
};
|
|
result: SaveArtifactResult;
|
|
};
|
|
"workflow.artifacts.validate_plan": {
|
|
params: {
|
|
plan: {
|
|
[k: string]: unknown;
|
|
};
|
|
outcomes: string[];
|
|
required_capabilities?: {
|
|
[k: string]: {
|
|
[k: string]: unknown;
|
|
};
|
|
} | null;
|
|
source_bindings?: {
|
|
[k: string]: string;
|
|
} | null;
|
|
};
|
|
result: ValidateArtifactPlanResult;
|
|
};
|
|
"workflow.capabilities.call": {
|
|
params: {
|
|
qualified_name: string;
|
|
payload?: {
|
|
[k: string]: unknown;
|
|
};
|
|
deployment_id?: string | null;
|
|
};
|
|
result: CapabilityCallResult;
|
|
};
|
|
"workflow.capabilities.inspect": {
|
|
params: {
|
|
qualified_name: string;
|
|
};
|
|
result: InspectCapabilityResult;
|
|
};
|
|
"workflow.capabilities.list": {
|
|
params: {
|
|
query?: string | null;
|
|
source_id?: string | null;
|
|
cursor?: string | null;
|
|
limit?: number;
|
|
};
|
|
result: ListCapabilitiesResult;
|
|
};
|
|
"workflow.deployments.delete": {
|
|
params: {
|
|
deployment_id: string;
|
|
};
|
|
result: DeleteDeploymentResult;
|
|
};
|
|
"workflow.deployments.inspect": {
|
|
params: {
|
|
deployment_id: string;
|
|
};
|
|
result: WorkflowDeploymentPayload;
|
|
};
|
|
"workflow.deployments.list": {
|
|
params: Record<string, never>;
|
|
result: ListDeploymentsResult;
|
|
};
|
|
"workflow.deployments.save": {
|
|
params: {
|
|
deployment: {
|
|
[k: string]: unknown;
|
|
};
|
|
};
|
|
result: SaveDeploymentResult;
|
|
};
|
|
"workflow.deployments.validate": {
|
|
params: {
|
|
deployment_id: string;
|
|
live_check?: boolean;
|
|
};
|
|
result: ValidateDeploymentResult;
|
|
};
|
|
"workflow.draft_workspaces.add_step": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
step:
|
|
| DraftUseStep
|
|
| DraftForeachStep
|
|
| DraftInterruptStep
|
|
| DraftEndStep
|
|
| DraftWhenStep
|
|
| DraftChooseStep
|
|
| DraftMatchStep
|
|
| DraftSubgraphStep;
|
|
incoming?: RouteSourceParams | null;
|
|
routes?: {
|
|
[k: string]: string;
|
|
} | null;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.add_step_from_capability": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
capability_name: string;
|
|
route_from_step?: string | null;
|
|
route_from_outcome?: string;
|
|
routes?: {
|
|
[k: string]: string;
|
|
} | null;
|
|
input_map?: {
|
|
[k: string]: string;
|
|
} | null;
|
|
input_bindings?: StepInputBinding[] | null;
|
|
bind_outputs?: {
|
|
[k: string]: string;
|
|
};
|
|
desc?: string | null;
|
|
retry?: number | null;
|
|
timeout_seconds?: number | null;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.bind": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
source_path: string;
|
|
target_path: string;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.branch": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
routes: {
|
|
[k: string]: string;
|
|
};
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.compile": {
|
|
params: {
|
|
workspace_id: string;
|
|
};
|
|
result: CompileDraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.create_artifact": {
|
|
params: {
|
|
workspace_id: string;
|
|
artifact_id: string;
|
|
version: number;
|
|
title: string;
|
|
outcomes: string[];
|
|
kind?: "workflow" | "wrapper";
|
|
description?: string | null;
|
|
required_capabilities?: {
|
|
[k: string]: {
|
|
[k: string]: unknown;
|
|
};
|
|
} | null;
|
|
source_bindings?: {
|
|
[k: string]: string;
|
|
} | null;
|
|
created_from_catalog_version?: string | null;
|
|
};
|
|
result: CreateArtifactFromWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.create_empty": {
|
|
params: {
|
|
workspace_id: string;
|
|
name: string;
|
|
title?: string | null;
|
|
input_schema?: {
|
|
[k: string]: unknown;
|
|
} | null;
|
|
state_schema?: {
|
|
[k: string]: unknown;
|
|
} | null;
|
|
output_schema?: {
|
|
[k: string]: unknown;
|
|
} | null;
|
|
outcomes?: string[];
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.create_from_capability": {
|
|
params: {
|
|
workspace_id: string;
|
|
capability_name: string;
|
|
name?: string | null;
|
|
title?: string | null;
|
|
input_schema?: {
|
|
[k: string]: unknown;
|
|
} | null;
|
|
state_schema?: {
|
|
[k: string]: unknown;
|
|
} | null;
|
|
output_schema?: {
|
|
[k: string]: unknown;
|
|
} | null;
|
|
input?: StepInputBinding[] | null;
|
|
output?: OutputBinding[] | null;
|
|
input_map?: {
|
|
[k: string]: string;
|
|
} | null;
|
|
output_map?: {
|
|
[k: string]: string;
|
|
} | null;
|
|
error_message_source?: unknown;
|
|
};
|
|
result: CreateDraftWorkspaceFromCapabilityResult;
|
|
};
|
|
"workflow.draft_workspaces.create_wrapper": {
|
|
params: {
|
|
workspace_id: string;
|
|
artifact_id: string;
|
|
version: number;
|
|
title: string;
|
|
outcomes: string[];
|
|
description?: string | null;
|
|
required_capabilities?: {
|
|
[k: string]: {
|
|
[k: string]: unknown;
|
|
};
|
|
} | null;
|
|
source_bindings?: {
|
|
[k: string]: string;
|
|
} | null;
|
|
created_from_catalog_version?: string | null;
|
|
};
|
|
result: CreateArtifactFromWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.delete": {
|
|
params: {
|
|
workspace_id: string;
|
|
};
|
|
result: DeleteDraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.get": {
|
|
params: {
|
|
workspace_id: string;
|
|
include_draft?: boolean;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.handle": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
branches: HandleDraftBranch[];
|
|
target: string;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.inspect_authoring_contract": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
selected_step_id?: string | null;
|
|
};
|
|
result: AuthoringContractInventoryPayload | DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.list": {
|
|
params: Record<string, never>;
|
|
result: ListDraftWorkspacesResult;
|
|
};
|
|
"workflow.draft_workspaces.patch": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
patch: {
|
|
[k: string]: unknown;
|
|
}[];
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.remove_binding": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
inputs?: string[];
|
|
outputs?: string[];
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.remove_route": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
outcome: string;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.remove_step": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.replace_document": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
draft: {
|
|
[k: string]: unknown;
|
|
};
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.set_contract": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
input_schema?: {
|
|
[k: string]: unknown;
|
|
} | null;
|
|
state_schema?: {
|
|
[k: string]: unknown;
|
|
} | null;
|
|
output_schema?: {
|
|
[k: string]: unknown;
|
|
} | null;
|
|
outcomes?: string[] | null;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.set_name": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
name: string;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.set_route": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
outcome: string;
|
|
target: string;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.set_start": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.set_step_input_bindings": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
bindings: StepInputBinding[];
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.set_step_input_map": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
input_map: {
|
|
[k: string]: string;
|
|
};
|
|
merge?: boolean;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.set_step_output_bindings": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
bindings: OutputBinding[];
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.set_step_output_map": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
output_map: {
|
|
[k: string]: string;
|
|
};
|
|
merge?: boolean;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.set_workflow_output_bindings": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
bindings: (InputPathBinding | InputValueBinding)[];
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.set_workflow_output_map": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
output_map: {
|
|
[k: string]: string;
|
|
};
|
|
merge?: boolean;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.update_capability_step": {
|
|
params: {
|
|
workspace_id: string;
|
|
revision: number;
|
|
step_id: string;
|
|
update: CapabilityStepUpdate;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.draft_workspaces.validate": {
|
|
params: {
|
|
workspace_id: string;
|
|
};
|
|
result: DraftWorkspaceResult;
|
|
};
|
|
"workflow.drafts.create_from_capability": {
|
|
params: {
|
|
workspace_id: string;
|
|
capability_name: string;
|
|
name?: string | null;
|
|
title?: string | null;
|
|
input_schema?: {
|
|
[k: string]: unknown;
|
|
} | null;
|
|
state_schema?: {
|
|
[k: string]: unknown;
|
|
} | null;
|
|
output_schema?: {
|
|
[k: string]: unknown;
|
|
} | null;
|
|
input?: StepInputBinding[] | null;
|
|
output?: OutputBinding[] | null;
|
|
input_map?: {
|
|
[k: string]: string;
|
|
} | null;
|
|
output_map?: {
|
|
[k: string]: string;
|
|
} | null;
|
|
error_message_source?: unknown;
|
|
};
|
|
result: CreateDraftWorkspaceFromCapabilityResult;
|
|
};
|
|
"workflow.drafts.patch": {
|
|
params: {
|
|
draft: {
|
|
[k: string]: unknown;
|
|
};
|
|
patch: {
|
|
[k: string]: unknown;
|
|
}[];
|
|
};
|
|
result: PatchDraftResult;
|
|
};
|
|
"workflow.drafts.validate": {
|
|
params: {
|
|
draft: {
|
|
[k: string]: unknown;
|
|
};
|
|
};
|
|
result: ValidateDraftResult;
|
|
};
|
|
"workflow.health": {
|
|
params: Record<string, never>;
|
|
result: HealthResult;
|
|
};
|
|
"workflow.runs.inspect": {
|
|
params: {
|
|
run_id: string;
|
|
};
|
|
result: RunResult;
|
|
};
|
|
"workflow.runs.list": {
|
|
params: {
|
|
status?: ("completed" | "failed" | "interrupted") | null;
|
|
cursor?: string | null;
|
|
limit?: number;
|
|
};
|
|
result: ListRunsResult;
|
|
};
|
|
"workflow.runs.resume": {
|
|
params: {
|
|
run_id: string;
|
|
resume_payload?: {
|
|
[k: string]: unknown;
|
|
};
|
|
resume_outcome?: string;
|
|
trace_range?: TraceRangeParams | null;
|
|
};
|
|
result: RunResult;
|
|
};
|
|
"workflow.runs.start": {
|
|
params: {
|
|
deployment_id: string;
|
|
workflow_input?: {
|
|
[k: string]: unknown;
|
|
};
|
|
trace_range?: TraceRangeParams | null;
|
|
/**
|
|
* Optional run step budget. The server default applies when omitted; resume never accepts a replacement.
|
|
*/
|
|
max_steps?: number | null;
|
|
};
|
|
result: RunResult;
|
|
};
|
|
"workflow.runs.trace": {
|
|
params: {
|
|
run_id: string;
|
|
trace_range: TraceRangeParams;
|
|
};
|
|
result: RunTraceResult;
|
|
};
|
|
"workflow.sources.diagnose": {
|
|
params: {
|
|
source_id: string;
|
|
};
|
|
result: SourceDiagnosisResult;
|
|
};
|
|
"workflow.sources.inspect": {
|
|
params: {
|
|
source_id: string;
|
|
};
|
|
result: InspectSourceResult;
|
|
};
|
|
"workflow.sources.list": {
|
|
params: {
|
|
cursor?: string | null;
|
|
limit?: number;
|
|
};
|
|
result: ListSourcesResult;
|
|
};
|
|
}
|
|
/**
|
|
* Outcome of deleting one auth record.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DeleteAuthRecordResult".
|
|
*/
|
|
export interface DeleteAuthRecordResult {
|
|
deleted: boolean;
|
|
id: string;
|
|
}
|
|
/**
|
|
* Auth record summary without credential payload values.
|
|
*
|
|
* ``metadata`` is explicitly non-secret display data. Credential material
|
|
* belongs in the omitted auth payload and is represented only by key names.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "AuthRecordSummaryPayload".
|
|
*/
|
|
export interface AuthRecordSummaryPayload {
|
|
id: string;
|
|
metadata: JsonObject;
|
|
payload_keys: string[];
|
|
scheme: string;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "JsonObject".
|
|
*/
|
|
export interface JsonObject {
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Sorted secret-safe auth record inventory.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ListAuthRecordsResult".
|
|
*/
|
|
export interface ListAuthRecordsResult {
|
|
auth_records: AuthRecordSummaryPayload[];
|
|
total: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Sorted connection readiness inventory.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ListConnectionStatusesResult".
|
|
*/
|
|
export interface ListConnectionStatusesResult {
|
|
statuses: ConnectionStatusPayload[];
|
|
total: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Connection readiness row with optional catalog snapshot facts.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ConnectionStatusPayload".
|
|
*/
|
|
export interface ConnectionStatusPayload {
|
|
account?: string;
|
|
connection_id: string;
|
|
enabled: boolean;
|
|
fetched_at_epoch_ms?: number | null;
|
|
has_snapshot?: boolean;
|
|
max_age_seconds?: number | null;
|
|
node_count?: number;
|
|
prompt_count?: number;
|
|
resource_count?: number;
|
|
server?: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Sorted configured connection inventory.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ListConnectionsResult".
|
|
*/
|
|
export interface ListConnectionsResult {
|
|
connections: ConnectionPayload[];
|
|
total: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Configured connection inventory row with provider extensions preserved.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ConnectionPayload".
|
|
*/
|
|
export interface ConnectionPayload {
|
|
account: string;
|
|
enabled: boolean;
|
|
id: string;
|
|
metadata: JsonObject;
|
|
server: string;
|
|
source_config_ownership?: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Chronological platform event history.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ListAdminEventsResult".
|
|
*/
|
|
export interface ListAdminEventsResult {
|
|
events: AdminEventPayload[];
|
|
total: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Chronological platform event with provider-specific payload preserved.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "AdminEventPayload".
|
|
*/
|
|
export interface AdminEventPayload {
|
|
capability_id?: string | null;
|
|
connection_id?: string | null;
|
|
kind: string;
|
|
payload: JsonObject;
|
|
timestamp_epoch_ms: number;
|
|
workflow_name?: string | null;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Desired source entry returned after add, update, or enablement changes.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "RegistryEntryMutationResult".
|
|
*/
|
|
export interface RegistryEntryMutationResult {
|
|
entry: RegistryEntryPayload;
|
|
shadowed_by_config: boolean;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Desired source entry with provider-specific configuration preserved.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "RegistryEntryPayload".
|
|
*/
|
|
export interface RegistryEntryPayload {
|
|
account?: string | null;
|
|
auth_ref?: string | null;
|
|
enabled: boolean;
|
|
id: string;
|
|
kind: string;
|
|
metadata?: JsonObject;
|
|
profile?: string | null;
|
|
provider?: string | null;
|
|
transport?: JsonObject | null;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Summary of reconciling desired registry state into the live service.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ApplyRegistryChangesResult".
|
|
*/
|
|
export interface ApplyRegistryChangesResult {
|
|
applied: boolean;
|
|
auth_diagnostics?: DependencyDiagnosticPayload[];
|
|
connection_count: number;
|
|
registered: string[];
|
|
registry_entry_count: number;
|
|
removed: string[];
|
|
updated: string[];
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* JSON projection of one deployment dependency diagnostic.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DependencyDiagnosticPayload".
|
|
*/
|
|
export interface DependencyDiagnosticPayload {
|
|
bound_source: string | null;
|
|
code: string;
|
|
logical_ref: string;
|
|
message: string;
|
|
repair_hint: string | null;
|
|
severity: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Full desired source entry with config precedence facts.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "InspectRegistryEntryResult".
|
|
*/
|
|
export interface InspectRegistryEntryResult {
|
|
config_ownership: string | null;
|
|
entry: RegistryEntryPayload;
|
|
mutable: boolean;
|
|
shadowed_by_config: boolean;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Cursor-paged desired source registry entries.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ListRegistryEntriesResult".
|
|
*/
|
|
export interface ListRegistryEntriesResult {
|
|
entries: RegistryEntrySummaryPayload[];
|
|
next_cursor: string | null;
|
|
total: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Compact desired-source row including config precedence facts.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "RegistryEntrySummaryPayload".
|
|
*/
|
|
export interface RegistryEntrySummaryPayload {
|
|
account: string | null;
|
|
auth_ref: string | null;
|
|
config_ownership: string | null;
|
|
enabled: boolean;
|
|
id: string;
|
|
kind: string;
|
|
mutable: boolean;
|
|
profile: string | null;
|
|
provider: string | null;
|
|
shadowed_by_config: boolean;
|
|
transport_kind: string | null;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Outcome of removing one desired source registry entry.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "RemoveRegistryEntryResult".
|
|
*/
|
|
export interface RemoveRegistryEntryResult {
|
|
removed: boolean;
|
|
source_id: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SaveArtifactResult".
|
|
*/
|
|
export interface SaveArtifactResult {
|
|
artifact_id: string;
|
|
saved: boolean;
|
|
version: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DeleteArtifactResult".
|
|
*/
|
|
export interface DeleteArtifactResult {
|
|
artifact_id: string;
|
|
blocked_by_deployments: string[];
|
|
deleted: boolean;
|
|
version: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Normalized immutable artifact returned by inspect operations.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "WorkflowArtifactPayload".
|
|
*/
|
|
export interface WorkflowArtifactPayload {
|
|
created_from_catalog_version: string | null;
|
|
description: string | null;
|
|
id: string;
|
|
input_schema: JsonObject;
|
|
kind: ArtifactKindPayload;
|
|
outcomes: string[];
|
|
output_schema: JsonObject;
|
|
plan: JsonObject;
|
|
required_capabilities: RequiredCapabilityPayload[];
|
|
title: string;
|
|
version: number;
|
|
workflow_dependencies: {
|
|
[k: string]: number;
|
|
};
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Saved dependency contract for one artifact capability reference.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "RequiredCapabilityPayload".
|
|
*/
|
|
export interface RequiredCapabilityPayload {
|
|
input_schema_hash: string | null;
|
|
input_schema_snapshot: JsonObject | null;
|
|
kind: CapabilityKindPayload;
|
|
observed_at_epoch_ms: number | null;
|
|
observed_concrete_source: string | null;
|
|
output_schema_hash: string | null;
|
|
output_schema_snapshot: JsonObject | null;
|
|
ref: CapabilityRefPayload;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "CapabilityRefPayload".
|
|
*/
|
|
export interface CapabilityRefPayload {
|
|
capability_key: string;
|
|
source: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ListArtifactsResult".
|
|
*/
|
|
export interface ListArtifactsResult {
|
|
next_cursor: string | null;
|
|
nodes: ArtifactCatalogEntryPayload[];
|
|
total: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Compact artifact row returned by discovery operations.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ArtifactCatalogEntryPayload".
|
|
*/
|
|
export interface ArtifactCatalogEntryPayload {
|
|
artifact_id: string;
|
|
description: string | null;
|
|
diagnostics: DependencyDiagnosticPayload[];
|
|
display_name: string;
|
|
input_schema: JsonObject;
|
|
kind: string;
|
|
name: string;
|
|
outcomes: string[];
|
|
output_schema: JsonObject;
|
|
required_sources: string[];
|
|
version: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Non-persisting artifact-plan validation and dependency inventory.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ValidateArtifactPlanResult".
|
|
*/
|
|
export interface ValidateArtifactPlanResult {
|
|
diagnostics: ArtifactPlanDiagnosticPayload[];
|
|
required_capabilities: RequiredCapabilityPayload[];
|
|
status: "valid" | "invalid";
|
|
workflow_dependencies: {
|
|
[k: string]: number;
|
|
};
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Stable diagnostic projected when an artifact plan is invalid.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ArtifactPlanDiagnosticPayload".
|
|
*/
|
|
export interface ArtifactPlanDiagnosticPayload {
|
|
code: string;
|
|
message: string;
|
|
path: string;
|
|
repair_hint: string | null;
|
|
severity: "error" | "warning";
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Outcome returned by a direct node-spec or wrapper capability call.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "CapabilityCallResult".
|
|
*/
|
|
export interface CapabilityCallResult {
|
|
deployment_id: string | null;
|
|
diagnostics: DependencyDiagnosticPayload[];
|
|
kind: "node_spec" | "wrapper_artifact";
|
|
outcome: string;
|
|
output: JsonObject | null;
|
|
qualified_name: string;
|
|
source_id: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Full executable contract for one source node spec.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "NodeSpecCapabilityDetail".
|
|
*/
|
|
export interface NodeSpecCapabilityDetail {
|
|
accepts_context: boolean;
|
|
description: string | null;
|
|
input_schema: JsonObject;
|
|
is_async: boolean;
|
|
kind: "node_spec";
|
|
name: string;
|
|
outcomes: string[];
|
|
output_schema: JsonObject;
|
|
source_id: string;
|
|
wrapper_hints: WrapperAuthoringHintsPayload;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Transport-neutral projection of conservative wrapper scaffolding hints.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "WrapperAuthoringHintsPayload".
|
|
*/
|
|
export interface WrapperAuthoringHintsPayload {
|
|
capability_name: string;
|
|
confidence: "high" | "medium" | "low";
|
|
declared_outcomes: string[];
|
|
input_map: {
|
|
[k: string]: string;
|
|
};
|
|
input_schema: JsonObject;
|
|
missing_decisions: WrapperMissingDecisionPayload[];
|
|
notes: string[];
|
|
outcome_candidates: WrapperOutcomeCandidatePayload[];
|
|
outcome_policy: "preserve_declared" | "manual_mapping_required";
|
|
output_map: {
|
|
[k: string]: string;
|
|
};
|
|
output_schema: JsonObject;
|
|
state_schema: JsonObject;
|
|
suggested_wrapper_outcomes: string[];
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* One unresolved wrapper-authoring decision.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "WrapperMissingDecisionPayload".
|
|
*/
|
|
export interface WrapperMissingDecisionPayload {
|
|
kind: "choose_output_fields" | "review_nested_output" | "confirm_boolean_outcomes" | "choose_error_mapping";
|
|
message: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Possible wrapper outcome mapping that still requires caller judgment.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "WrapperOutcomeCandidatePayload".
|
|
*/
|
|
export interface WrapperOutcomeCandidatePayload {
|
|
automatic: boolean;
|
|
candidate_outcomes: string[];
|
|
confidence: "high" | "medium" | "low";
|
|
kind: "boolean_control_field";
|
|
reason: string;
|
|
source: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Full callable contract for one saved wrapper artifact.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "WrapperArtifactCapabilityDetail".
|
|
*/
|
|
export interface WrapperArtifactCapabilityDetail {
|
|
artifact_id: string;
|
|
description: string | null;
|
|
input_schema: JsonObject;
|
|
is_async: boolean;
|
|
kind: "wrapper_artifact";
|
|
name: string;
|
|
outcomes: string[];
|
|
output_schema: JsonObject;
|
|
required_capabilities: {
|
|
[k: string]: RequiredCapabilityPayload;
|
|
};
|
|
source_id: string;
|
|
title: string;
|
|
version: number;
|
|
wrapper_hints: WrapperAuthoringHintsPayload;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Cursor-paged planner-visible capability discovery result.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ListCapabilitiesResult".
|
|
*/
|
|
export interface ListCapabilitiesResult {
|
|
capabilities: (NodeSpecCapabilitySummary | WrapperArtifactCapabilitySummary)[];
|
|
next_cursor: string | null;
|
|
total: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Compact discovery row for one executable source node spec.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "NodeSpecCapabilitySummary".
|
|
*/
|
|
export interface NodeSpecCapabilitySummary {
|
|
description: string | null;
|
|
input_fields: string[];
|
|
is_async: boolean;
|
|
kind: "node_spec";
|
|
name: string;
|
|
outcomes: string[];
|
|
output_fields: string[];
|
|
source_id: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Compact discovery row for one saved wrapper artifact.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "WrapperArtifactCapabilitySummary".
|
|
*/
|
|
export interface WrapperArtifactCapabilitySummary {
|
|
artifact_id: string;
|
|
description: string | null;
|
|
input_fields: string[];
|
|
is_async: boolean;
|
|
kind: "wrapper_artifact";
|
|
name: string;
|
|
outcomes: string[];
|
|
output_fields: string[];
|
|
source_id: string;
|
|
title: string;
|
|
version: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DeleteDeploymentResult".
|
|
*/
|
|
export interface DeleteDeploymentResult {
|
|
deleted: boolean;
|
|
deployment_id: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Serialized deployment accepted and returned by workflow API surfaces.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "WorkflowDeploymentPayload".
|
|
*/
|
|
export interface WorkflowDeploymentPayload {
|
|
artifact_id: string;
|
|
artifact_version: number;
|
|
bindings: SourceBindingPayload[];
|
|
drift_policy: string;
|
|
id: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* JSON projection of a logical-to-concrete deployment source binding.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourceBindingPayload".
|
|
*/
|
|
export interface SourceBindingPayload {
|
|
concrete_source: string;
|
|
logical_source: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ListDeploymentsResult".
|
|
*/
|
|
export interface ListDeploymentsResult {
|
|
deployments: DeploymentSummary[];
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Compact deployment row used by list operations.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DeploymentSummary".
|
|
*/
|
|
export interface DeploymentSummary {
|
|
artifact_id: string;
|
|
artifact_version: number;
|
|
binding_count: number;
|
|
drift_policy: string;
|
|
id: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SaveDeploymentResult".
|
|
*/
|
|
export interface SaveDeploymentResult {
|
|
artifact_id: string;
|
|
artifact_version: number;
|
|
deployment_id: string;
|
|
saved: boolean;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ValidateDeploymentResult".
|
|
*/
|
|
export interface ValidateDeploymentResult {
|
|
artifact_id: string;
|
|
artifact_version: number;
|
|
deployment_id: string;
|
|
diagnostics: DependencyDiagnosticPayload[];
|
|
next_actions: NextActionsPayload;
|
|
status: "runnable" | "unrunnable";
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* JSON projection of advisory workflow continuation guidance.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "NextActionsPayload".
|
|
*/
|
|
export interface NextActionsPayload {
|
|
can_continue: boolean;
|
|
can_save_now: boolean | null;
|
|
patch_examples: NextActionPatchExamplePayload[];
|
|
reason: string;
|
|
recommended_next_tool: string | null;
|
|
warnings: string[];
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Concrete follow-up operation suggested to an API caller.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "NextActionPatchExamplePayload".
|
|
*/
|
|
export interface NextActionPatchExamplePayload {
|
|
description: string;
|
|
request: JsonObject;
|
|
tool: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Draft step that calls one externally resolvable workflow capability.
|
|
*
|
|
* `output` writes node-local output fields into workflow state. Root
|
|
* workflow output bindings live on `WorkflowDraft.output`.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftUseStep".
|
|
*/
|
|
export interface DraftUseStep {
|
|
desc?: string | null;
|
|
/**
|
|
* Canonical input bindings for this capability. Use path bindings for graph-to-local input and value bindings for literals.
|
|
*/
|
|
input?: StepInputBinding[];
|
|
/**
|
|
* Canonical output bindings from node-local output paths to workflow state destinations.
|
|
*/
|
|
output?: OutputBinding[];
|
|
retry?: number | null;
|
|
timeout_seconds?: number | null;
|
|
use: string;
|
|
}
|
|
/**
|
|
* Map one workflow graph source path into one node-local input path.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "InputPathBinding".
|
|
*/
|
|
export interface InputPathBinding {
|
|
/**
|
|
* Workflow source path to read from input, state, or context. Prefer canonical strings such as `input.text` or `state.report`. Structural objects such as {'root': 'input', 'parts': ['text']} are also accepted as input.
|
|
*/
|
|
path:
|
|
| string
|
|
| {
|
|
/**
|
|
* @minItems 0
|
|
*/
|
|
parts: string[];
|
|
root: "input" | "state" | "context";
|
|
};
|
|
/**
|
|
* Node-local input path to populate. Prefer canonical strings such as `field` or `.` for the whole node input payload. Structural objects such as {'root': 'local', 'parts': ['field']} are also accepted as input.
|
|
*/
|
|
target:
|
|
| string
|
|
| {
|
|
/**
|
|
* @minItems 0
|
|
*/
|
|
parts: string[];
|
|
root: "local";
|
|
};
|
|
}
|
|
/**
|
|
* Map one static value into one node-local input path.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "InputValueBinding".
|
|
*/
|
|
export interface InputValueBinding {
|
|
/**
|
|
* Node-local input path that receives this literal JSON value.
|
|
*/
|
|
target:
|
|
| string
|
|
| {
|
|
/**
|
|
* @minItems 0
|
|
*/
|
|
parts: string[];
|
|
root: "local";
|
|
};
|
|
/**
|
|
* Literal JSON-compatible value to pass to the node. Use this for constants, not for values read from workflow input or state.
|
|
*/
|
|
value:
|
|
| boolean
|
|
| number
|
|
| string
|
|
| JsonValue[]
|
|
| {
|
|
[k: string]: JsonValue;
|
|
}
|
|
| null;
|
|
}
|
|
/**
|
|
* Assign one recursively composed expression to a node-local target.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "InputExpressionBinding".
|
|
*/
|
|
export interface InputExpressionBinding {
|
|
expression: InputExpression;
|
|
/**
|
|
* Node-local path. Use the root marker `.` for the whole payload.
|
|
*/
|
|
target:
|
|
| string
|
|
| {
|
|
/**
|
|
* @minItems 0
|
|
*/
|
|
parts: string[];
|
|
root: "local";
|
|
};
|
|
}
|
|
/**
|
|
* A strict JSON literal embedded in a node-local input expression.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "LiteralExpression".
|
|
*/
|
|
export interface LiteralExpression {
|
|
kind: "literal";
|
|
value: JsonValue;
|
|
}
|
|
/**
|
|
* Read one graph source path while resolving a composite input.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "PathExpression".
|
|
*/
|
|
export interface PathExpression {
|
|
kind: "path";
|
|
/**
|
|
* Readable graph path rooted at input, state, or context.
|
|
*/
|
|
path:
|
|
| string
|
|
| {
|
|
/**
|
|
* @minItems 0
|
|
*/
|
|
parts: string[];
|
|
root: "input" | "state" | "context";
|
|
};
|
|
}
|
|
/**
|
|
* Resolve ordered child expressions into one JSON array.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ArrayExpression".
|
|
*/
|
|
export interface ArrayExpression {
|
|
items: InputExpression[];
|
|
kind: "array";
|
|
}
|
|
/**
|
|
* Resolve named child expressions into one JSON object.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ObjectExpression".
|
|
*/
|
|
export interface ObjectExpression {
|
|
fields: {
|
|
[k: string]: InputExpression;
|
|
};
|
|
kind: "object";
|
|
}
|
|
/**
|
|
* Map one node-local output path into one workflow state path.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "OutputBinding".
|
|
*/
|
|
export interface OutputBinding {
|
|
/**
|
|
* Node-local output path to read. Prefer canonical strings such as `result` or `.` for the whole node output payload. Structural objects such as {'root': 'local', 'parts': []} are also accepted as input.
|
|
*/
|
|
source:
|
|
| string
|
|
| {
|
|
/**
|
|
* @minItems 0
|
|
*/
|
|
parts: string[];
|
|
root: "local";
|
|
};
|
|
/**
|
|
* Writable workflow state path. Bare state is invalid; use a field path such as `state.echoed`. Structural objects such as {'root': 'state', 'parts': ['echoed']} are also accepted as input.
|
|
*/
|
|
target:
|
|
| string
|
|
| {
|
|
/**
|
|
* @minItems 1
|
|
*/
|
|
parts: [string, ...string[]];
|
|
root: "state";
|
|
};
|
|
}
|
|
/**
|
|
* Draft step that delegates foreach construction to `WorkflowBuilder`.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftForeachStep".
|
|
*/
|
|
export interface DraftForeachStep {
|
|
foreach: DraftForeachPayload;
|
|
}
|
|
/**
|
|
* Payload for one draft foreach step.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftForeachPayload".
|
|
*/
|
|
export interface DraftForeachPayload {
|
|
as: string;
|
|
concurrent?: ForeachConcurrentPolicy | null;
|
|
item_error?: ForeachItemErrorPolicy;
|
|
mode?: "serial" | "concurrent";
|
|
/**
|
|
* Deprecated parse-only shorthand; use item_error.
|
|
*/
|
|
on_item_error?: ("fail" | "collect" | "skip") | null;
|
|
/**
|
|
* Readable graph path rooted at input, state, or context.
|
|
*/
|
|
over:
|
|
| string
|
|
| {
|
|
/**
|
|
* @minItems 0
|
|
*/
|
|
parts: string[];
|
|
root: "input" | "state" | "context";
|
|
};
|
|
}
|
|
/**
|
|
* Concurrency policy for foreach frame admission.
|
|
*
|
|
* This controls workflow-level child frame admission. It does not imply
|
|
* thread/process execution for sync node handlers; async runtime can use the
|
|
* same policy to admit simultaneous async handler calls later.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ForeachConcurrentPolicy".
|
|
*/
|
|
export interface ForeachConcurrentPolicy {
|
|
interrupt?: "quiesce";
|
|
max_active?: number;
|
|
max_outstanding?: number;
|
|
}
|
|
/**
|
|
* Policy for runtime failures inside one foreach item lineage.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ForeachItemErrorPolicy".
|
|
*/
|
|
export interface ForeachItemErrorPolicy {
|
|
action?: "fail" | "skip" | "collect";
|
|
collect_to?:
|
|
| (
|
|
| string
|
|
| {
|
|
/**
|
|
* @minItems 1
|
|
*/
|
|
parts: [string, ...string[]];
|
|
root: "state";
|
|
}
|
|
)
|
|
| null;
|
|
}
|
|
/**
|
|
* Draft step that pauses execution and waits for resume input.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftInterruptStep".
|
|
*/
|
|
export interface DraftInterruptStep {
|
|
interrupt: DraftInterruptPayload;
|
|
}
|
|
/**
|
|
* Payload for one draft interrupt step.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftInterruptPayload".
|
|
*/
|
|
export interface DraftInterruptPayload {
|
|
kind: string;
|
|
outcomes?: string[];
|
|
request?: StepInputBinding[];
|
|
request_schema?: SchemaRef | null;
|
|
resume?: OutputBinding[];
|
|
resume_schema?: SchemaRef | null;
|
|
}
|
|
/**
|
|
* JSON Schema object used at workflow and node boundaries.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SchemaRef".
|
|
*/
|
|
export interface SchemaRef {
|
|
properties?: {
|
|
[k: string]: unknown;
|
|
};
|
|
required?: string[];
|
|
title?: string | null;
|
|
type?: string | string[] | null;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Draft step that lowers to core `EndNode`.
|
|
*
|
|
* Route to this step when the workflow should finish with a non-`ok` public
|
|
* outcome. Routing directly to `__end__` remains the shorthand for `ok`.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftEndStep".
|
|
*/
|
|
export interface DraftEndStep {
|
|
end?: DraftEndPayload;
|
|
}
|
|
/**
|
|
* Payload for one explicit workflow terminal outcome.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftEndPayload".
|
|
*/
|
|
export interface DraftEndPayload {
|
|
outcome?: string;
|
|
}
|
|
/**
|
|
* Draft step that delegates one boolean decision to `WorkflowBuilder.when`.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftWhenStep".
|
|
*/
|
|
export interface DraftWhenStep {
|
|
when: DraftWhenPayload;
|
|
}
|
|
/**
|
|
* Payload for one boolean draft decision.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftWhenPayload".
|
|
*/
|
|
export interface DraftWhenPayload {
|
|
if: ExistsCondition | NotCondition | VariadicCondition | BinaryCondition;
|
|
otherwise?: string;
|
|
then: string;
|
|
}
|
|
/**
|
|
* Condition that is true when a graph path resolves to a present value.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ExistsCondition".
|
|
*/
|
|
export interface ExistsCondition {
|
|
op: "exists";
|
|
/**
|
|
* Readable graph path rooted at input, state, or context.
|
|
*/
|
|
path:
|
|
| string
|
|
| {
|
|
/**
|
|
* @minItems 0
|
|
*/
|
|
parts: string[];
|
|
root: "input" | "state" | "context";
|
|
};
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Condition that negates another condition expression.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "NotCondition".
|
|
*/
|
|
export interface NotCondition {
|
|
arg: ExistsCondition | NotCondition | VariadicCondition | BinaryCondition;
|
|
op: "not";
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Condition that combines one or more child conditions.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "VariadicCondition".
|
|
*/
|
|
export interface VariadicCondition {
|
|
/**
|
|
* @minItems 1
|
|
*/
|
|
args: [
|
|
ExistsCondition | NotCondition | VariadicCondition | BinaryCondition,
|
|
...(ExistsCondition | NotCondition | VariadicCondition | BinaryCondition)[]
|
|
];
|
|
op: "and" | "or";
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Condition that compares two operands.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "BinaryCondition".
|
|
*/
|
|
export interface BinaryCondition {
|
|
left: PathOperand | LiteralOperand;
|
|
op: "eq" | "ne" | "gt" | "ge" | "lt" | "le";
|
|
right: PathOperand | LiteralOperand;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Condition operand resolved from a workflow graph path.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "PathOperand".
|
|
*/
|
|
export interface PathOperand {
|
|
/**
|
|
* Readable graph path rooted at input, state, or context.
|
|
*/
|
|
path:
|
|
| string
|
|
| {
|
|
/**
|
|
* @minItems 0
|
|
*/
|
|
parts: string[];
|
|
root: "input" | "state" | "context";
|
|
};
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Condition operand that carries a literal value.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "LiteralOperand".
|
|
*/
|
|
export interface LiteralOperand {
|
|
value: unknown;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Draft step that delegates ordered decisions to `WorkflowBuilder.choose`.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftChooseStep".
|
|
*/
|
|
export interface DraftChooseStep {
|
|
choose: DraftChoosePayload;
|
|
}
|
|
/**
|
|
* Payload for an ordered first-true draft decision.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftChoosePayload".
|
|
*/
|
|
export interface DraftChoosePayload {
|
|
/**
|
|
* @minItems 1
|
|
*/
|
|
clauses: [DraftChooseClause, ...DraftChooseClause[]];
|
|
default?: string;
|
|
}
|
|
/**
|
|
* One ordered boolean clause in a draft choose decision.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftChooseClause".
|
|
*/
|
|
export interface DraftChooseClause {
|
|
if: ExistsCondition | NotCondition | VariadicCondition | BinaryCondition;
|
|
then: string;
|
|
}
|
|
/**
|
|
* Draft step that delegates equality decisions to `WorkflowBuilder.match`.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftMatchStep".
|
|
*/
|
|
export interface DraftMatchStep {
|
|
match: DraftMatchPayload;
|
|
}
|
|
/**
|
|
* Payload for matching one graph value against ordered equality cases.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftMatchPayload".
|
|
*/
|
|
export interface DraftMatchPayload {
|
|
/**
|
|
* @minItems 1
|
|
*/
|
|
cases: [DraftMatchCase, ...DraftMatchCase[]];
|
|
default?: string;
|
|
value: string;
|
|
}
|
|
/**
|
|
* One ordered equality case in a draft match decision.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftMatchCase".
|
|
*/
|
|
export interface DraftMatchCase {
|
|
equals: unknown;
|
|
then: string;
|
|
}
|
|
/**
|
|
* Draft step that lowers to a native `SubgraphNode` boundary.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftSubgraphStep".
|
|
*/
|
|
export interface DraftSubgraphStep {
|
|
subgraph: DraftSubgraphPayload;
|
|
}
|
|
/**
|
|
* Declarative boundary contract for a referenced child workflow.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftSubgraphPayload".
|
|
*/
|
|
export interface DraftSubgraphPayload {
|
|
desc?: string | null;
|
|
input?: StepInputBinding[];
|
|
input_schema?: SchemaRef;
|
|
/**
|
|
* @minItems 1
|
|
*/
|
|
outcomes?: [string, ...string[]];
|
|
output?: OutputBinding[];
|
|
output_schema?: SchemaRef;
|
|
workflow: WorkflowRef;
|
|
}
|
|
/**
|
|
* Structural reference to a child workflow contract.
|
|
*
|
|
* Core needs a workflow reference for graph shape and validation, but it must
|
|
* not depend on artifact stores or MCP capability naming. Saved workflow
|
|
* artifacts can use ``artifact_id`` plus ``version``; local compiled workflows
|
|
* can use ``name``. Legacy strings parse as ``name`` unless they use the old
|
|
* ``workflow.<artifact>.v<version>`` display format.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "WorkflowRef".
|
|
*/
|
|
export interface WorkflowRef {
|
|
/**
|
|
* Saved workflow artifact id, when referencing an immutable artifact.
|
|
*/
|
|
artifact_id?: string | null;
|
|
/**
|
|
* Local workflow registry name.
|
|
*/
|
|
name?: string | null;
|
|
/**
|
|
* Saved workflow artifact version. Requires artifact_id.
|
|
*/
|
|
version?: number | null;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "RouteSourceParams".
|
|
*/
|
|
export interface RouteSourceParams {
|
|
outcome?: string;
|
|
step_id: string;
|
|
}
|
|
/**
|
|
* Canonical persisted workspace envelope returned after reads and edits.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftWorkspaceResult".
|
|
*/
|
|
export interface DraftWorkspaceResult {
|
|
diagnostics: DraftDiagnosticPayload[];
|
|
draft?: JsonObject;
|
|
revision: number;
|
|
status: "valid" | "invalid" | "conflict";
|
|
summary: DraftWorkspaceSummary;
|
|
title: string | null;
|
|
workspace_id: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* One validation or revision diagnostic attached to a draft workspace.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftDiagnosticPayload".
|
|
*/
|
|
export interface DraftDiagnosticPayload {
|
|
code: string;
|
|
details?: JsonObject;
|
|
message: string;
|
|
path: string;
|
|
repair_hint?: string | null;
|
|
step_id?: string | null;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Compact graph facts included with every persisted workspace result.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DraftWorkspaceSummary".
|
|
*/
|
|
export interface DraftWorkspaceSummary {
|
|
name: unknown;
|
|
route_count: number;
|
|
start: unknown;
|
|
step_count: number;
|
|
steps: string[];
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Compiled raw plan and dependencies for one valid draft workspace.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "CompileDraftWorkspaceSuccess".
|
|
*/
|
|
export interface CompileDraftWorkspaceSuccess {
|
|
compiled_plan: JsonObject;
|
|
required_capabilities: {
|
|
[k: string]: RequiredCapabilityPayload;
|
|
};
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Validation-only result returned when a draft cannot be compiled.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "InvalidDraftResult".
|
|
*/
|
|
export interface InvalidDraftResult {
|
|
diagnostics: DraftDiagnosticPayload[];
|
|
status: "invalid";
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Saved artifact result with source-binding guidance derived from a draft.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SavedDraftArtifactResult".
|
|
*/
|
|
export interface SavedDraftArtifactResult {
|
|
artifact_id: string;
|
|
required_logical_sources: string[];
|
|
saved: true;
|
|
suggested_bindings: {
|
|
[k: string]: string;
|
|
};
|
|
version: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Validation result when an invalid workspace is not saved as an artifact.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "UnsavedDraftArtifactResult".
|
|
*/
|
|
export interface UnsavedDraftArtifactResult {
|
|
diagnostics: DraftDiagnosticPayload[];
|
|
revision: number;
|
|
saved: false;
|
|
status: "invalid";
|
|
workspace_id: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Bootstrapped workspace plus the hints and next actions that shaped it.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "CreateDraftWorkspaceFromCapabilityResult".
|
|
*/
|
|
export interface CreateDraftWorkspaceFromCapabilityResult {
|
|
diagnostics: DraftDiagnosticPayload[];
|
|
draft?: JsonObject;
|
|
next_actions: NextActionsPayload;
|
|
revision: number;
|
|
status: "valid" | "invalid" | "conflict";
|
|
summary: DraftWorkspaceSummary;
|
|
title: string | null;
|
|
workspace_id: string;
|
|
wrapper_hints: WrapperAuthoringHintsPayload;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Outcome of deleting one persisted draft workspace.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "DeleteDraftWorkspaceResult".
|
|
*/
|
|
export interface DeleteDraftWorkspaceResult {
|
|
deleted: boolean;
|
|
status: "deleted" | "not_found";
|
|
workspace_id: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "HandleDraftBranch".
|
|
*/
|
|
export interface HandleDraftBranch {
|
|
outcome: string;
|
|
step_id: string;
|
|
}
|
|
/**
|
|
* Revision-scoped readable sources and writable authoring targets.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "AuthoringContractInventoryPayload".
|
|
*/
|
|
export interface AuthoringContractInventoryPayload {
|
|
entry_steps: AuthoringStepContractPayload[];
|
|
readable_sources: AuthoringPathOptionPayload[];
|
|
revision: number;
|
|
selected_step_id: string | null;
|
|
state_targets: AuthoringPathOptionPayload[];
|
|
step_input_targets: AuthoringPathOptionPayload[];
|
|
step_output_sources: AuthoringPathOptionPayload[];
|
|
warnings: string[];
|
|
workflow_outcomes: string[];
|
|
workflow_output_targets: AuthoringPathOptionPayload[];
|
|
workspace_id: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Compact executable-step choice used by authoring inventories.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "AuthoringStepContractPayload".
|
|
*/
|
|
export interface AuthoringStepContractPayload {
|
|
description?: string;
|
|
input_targets?: AuthoringPathOptionPayload[];
|
|
label: string;
|
|
outcomes?: string[];
|
|
output_sources?: AuthoringPathOptionPayload[];
|
|
step_id: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* One schema-derived source or target available to an author.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "AuthoringPathOptionPayload".
|
|
*/
|
|
export interface AuthoringPathOptionPayload {
|
|
availability: AuthoringPathAvailability;
|
|
description?: string;
|
|
label: string;
|
|
origin: AuthoringPathOrigin;
|
|
path: string;
|
|
reason?: string;
|
|
required: boolean;
|
|
schema: JsonObject;
|
|
uses: AuthoringPathUse[];
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* All persisted draft-workspace summaries.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ListDraftWorkspacesResult".
|
|
*/
|
|
export interface ListDraftWorkspacesResult {
|
|
workspaces: DraftWorkspaceResult[];
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Presence-aware patch for one existing capability-backed draft step.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "CapabilityStepUpdate".
|
|
*/
|
|
export interface CapabilityStepUpdate {
|
|
desc?: string | null;
|
|
input?: StepInputBinding[] | null;
|
|
retry?: number | null;
|
|
timeout_seconds?: number | null;
|
|
}
|
|
/**
|
|
* Valid draft document produced after applying a JSON Patch.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "PatchedDraftValidResult".
|
|
*/
|
|
export interface PatchedDraftValidResult {
|
|
compiled_plan: JsonObject;
|
|
diagnostics: DraftDiagnosticPayload[];
|
|
draft: JsonObject;
|
|
status: "valid";
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Invalid patch result, optionally retaining the applied draft document.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "PatchedDraftInvalidResult".
|
|
*/
|
|
export interface PatchedDraftInvalidResult {
|
|
diagnostics: DraftDiagnosticPayload[];
|
|
draft?: JsonObject;
|
|
status: "invalid";
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Successful validation of one stateless draft document.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ValidDraftResult".
|
|
*/
|
|
export interface ValidDraftResult {
|
|
compiled_plan: JsonObject;
|
|
diagnostics: DraftDiagnosticPayload[];
|
|
status: "valid";
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Health response shared by self-describing workflow transports.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "HealthResult".
|
|
*/
|
|
export interface HealthResult {
|
|
status: "ok";
|
|
store_root: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Run operation result with an optional caller-requested trace slice.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "RunResult".
|
|
*/
|
|
export interface RunResult {
|
|
artifact_id: string;
|
|
artifact_version: number;
|
|
deployment_id: string;
|
|
diagnostics: DependencyDiagnosticPayload[];
|
|
error: string | null;
|
|
interrupt: InterruptPayload | null;
|
|
max_steps: number;
|
|
next_actions: NextActionsPayload;
|
|
outcome: string | null;
|
|
output: JsonObject | null;
|
|
resume_readiness: ResumeReadiness | null;
|
|
run_id: string | null;
|
|
status: RunStatus;
|
|
steps_executed: number;
|
|
steps_remaining: number;
|
|
trace?: TraceEntryPayload[];
|
|
trace_count: number;
|
|
trace_limit?: number;
|
|
trace_start?: number;
|
|
trace_truncated?: boolean;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Persisted typed interrupt contract exposed to API clients.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "InterruptPayload".
|
|
*/
|
|
export interface InterruptPayload {
|
|
frame_id: string;
|
|
id: string;
|
|
kind: string;
|
|
node_id: string;
|
|
outcomes: string[];
|
|
payload: JsonObject;
|
|
request_schema: JsonSchema;
|
|
resumable: boolean;
|
|
resume_schema: JsonSchema;
|
|
route: InterruptRoutePayload | null;
|
|
typed: boolean;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "JsonSchema".
|
|
*/
|
|
export interface JsonSchema {
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "InterruptRoutePayload".
|
|
*/
|
|
export interface InterruptRoutePayload {
|
|
frame_id: string;
|
|
lineage_id: string;
|
|
node_id: string;
|
|
parent_frame_id: string;
|
|
scope_id: string;
|
|
workflow_ref: WorkflowRefPayload;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "WorkflowRefPayload".
|
|
*/
|
|
export interface WorkflowRefPayload {
|
|
artifact_id?: string;
|
|
name?: string;
|
|
version?: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "TraceEntryPayload".
|
|
*/
|
|
export interface TraceEntryPayload {
|
|
frame_id: string;
|
|
next_node_id: string;
|
|
node_id: string;
|
|
outcome: string;
|
|
output: JsonObject;
|
|
resolved_input: JsonObject;
|
|
state_changes: JsonObject;
|
|
step_number: number | null;
|
|
step_type: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ListRunsResult".
|
|
*/
|
|
export interface ListRunsResult {
|
|
cursor: string | null;
|
|
limit: number;
|
|
next_cursor: string | null;
|
|
runs: RunSummary[];
|
|
total: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "RunSummary".
|
|
*/
|
|
export interface RunSummary {
|
|
artifact_id: string;
|
|
artifact_version: number;
|
|
created_at: string;
|
|
deployment_id: string;
|
|
diagnostic_count: number;
|
|
resume_readiness: ResumeReadiness;
|
|
run_id: string;
|
|
status: RunStatus;
|
|
updated_at: string;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "TraceRangeParams".
|
|
*/
|
|
export interface TraceRangeParams {
|
|
/**
|
|
* Maximum trace entries to return; full traces are never implicit.
|
|
*/
|
|
limit?: number;
|
|
/**
|
|
* Zero-based trace offset.
|
|
*/
|
|
start?: number;
|
|
}
|
|
/**
|
|
* Run result where a bounded trace slice is always present.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "RunTraceResult".
|
|
*/
|
|
export interface RunTraceResult {
|
|
artifact_id: string;
|
|
artifact_version: number;
|
|
deployment_id: string;
|
|
diagnostics: DependencyDiagnosticPayload[];
|
|
error: string | null;
|
|
interrupt: InterruptPayload | null;
|
|
max_steps: number;
|
|
next_actions: NextActionsPayload;
|
|
outcome: string | null;
|
|
output: JsonObject | null;
|
|
resume_readiness: ResumeReadiness | null;
|
|
run_id: string | null;
|
|
status: RunStatus;
|
|
steps_executed: number;
|
|
steps_remaining: number;
|
|
trace: TraceEntryPayload[];
|
|
trace_count: number;
|
|
trace_limit: number;
|
|
trace_start: number;
|
|
trace_truncated: boolean;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Stable source-diagnostics envelope with provider-specific extensions.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourceDiagnosisResult".
|
|
*/
|
|
export interface SourceDiagnosisResult {
|
|
auth?: SourceAuthDiagnosisPayload;
|
|
catalog?: SourceCatalogDiagnosisPayload;
|
|
diagnostics: DependencyDiagnosticPayload[];
|
|
enabled?: boolean;
|
|
message?: string;
|
|
source_id: string;
|
|
status: string;
|
|
transport?: SourceTransportDiagnosisPayload;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Known auth-health fields reported by a diagnostics provider.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourceAuthDiagnosisPayload".
|
|
*/
|
|
export interface SourceAuthDiagnosisPayload {
|
|
auth_ref?: string | null;
|
|
record_present?: boolean | null;
|
|
scheme?: string | null;
|
|
transport_supported?: boolean;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Known catalog-health fields reported by a diagnostics provider.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourceCatalogDiagnosisPayload".
|
|
*/
|
|
export interface SourceCatalogDiagnosisPayload {
|
|
fetched_at_epoch_ms?: number | null;
|
|
has_snapshot?: boolean;
|
|
max_age_seconds?: number | null;
|
|
node_count?: number;
|
|
prompt_count?: number;
|
|
resource_count?: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Known transport-health fields reported by a diagnostics provider.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourceTransportDiagnosisPayload".
|
|
*/
|
|
export interface SourceTransportDiagnosisPayload {
|
|
configured?: boolean;
|
|
kind?: string | null;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Full source inventory with optional diagnostics supplied by the runtime.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "InspectSourceResult".
|
|
*/
|
|
export interface InspectSourceResult {
|
|
capabilities: SourceCapabilityInventoryPayload;
|
|
description: string | null;
|
|
diagnostics?: SourceDiagnosisResult | SourceDiagnosticsUnavailablePayload;
|
|
enabled: boolean;
|
|
has_more: SourceCapabilityHasMorePayload;
|
|
id: string;
|
|
kind: "system" | "connection" | "python";
|
|
node_spec_count: number;
|
|
permissions: SourcePermissionsPayload;
|
|
policy: SourcePolicyPayload;
|
|
preview: SourceCapabilityPreviewPayload;
|
|
prompt_count: number;
|
|
reducer_count: number;
|
|
resource_count: number;
|
|
tool_count: number;
|
|
visibility: SourceVisibilityPayload;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Capability names and detailed executable contracts owned by a source.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourceCapabilityInventoryPayload".
|
|
*/
|
|
export interface SourceCapabilityInventoryPayload {
|
|
node_spec_details: NodeSpecInventoryPayload[];
|
|
node_specs: string[];
|
|
prompts: string[];
|
|
reducer_details: ReducerInventoryPayload[];
|
|
reducers: string[];
|
|
resources: string[];
|
|
tools: string[];
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Serializable executable contract owned by one capability source.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "NodeSpecInventoryPayload".
|
|
*/
|
|
export interface NodeSpecInventoryPayload {
|
|
accepts_context: boolean;
|
|
description: string | null;
|
|
input_schema: JsonObject;
|
|
is_async: boolean;
|
|
name: string;
|
|
outcomes: string[];
|
|
output_schema: JsonObject;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Serializable pure-reducer contract owned by one capability source.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ReducerInventoryPayload".
|
|
*/
|
|
export interface ReducerInventoryPayload {
|
|
config_schema: JsonObject;
|
|
description: string | null;
|
|
name: string;
|
|
ref: CapabilityRefPayload;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Fallback embedded in inspect results when diagnostics collection fails.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourceDiagnosticsUnavailablePayload".
|
|
*/
|
|
export interface SourceDiagnosticsUnavailablePayload {
|
|
message: string;
|
|
status: "error";
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Whether each compact capability preview omitted owned names.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourceCapabilityHasMorePayload".
|
|
*/
|
|
export interface SourceCapabilityHasMorePayload {
|
|
node_specs: boolean;
|
|
prompts: boolean;
|
|
reducers: boolean;
|
|
resources: boolean;
|
|
tools: boolean;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* JSON projection of source permission flags.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourcePermissionsPayload".
|
|
*/
|
|
export interface SourcePermissionsPayload {
|
|
calls_upstream: boolean;
|
|
mutates_auth: boolean;
|
|
mutates_config: boolean;
|
|
safe_for_workflow: boolean;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* JSON projection of deployment-binding policy for one source.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourcePolicyPayload".
|
|
*/
|
|
export interface SourcePolicyPayload {
|
|
binding_required: boolean;
|
|
platform: boolean;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Small sorted capability-name sample used by compact source rows.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourceCapabilityPreviewPayload".
|
|
*/
|
|
export interface SourceCapabilityPreviewPayload {
|
|
node_specs: string[];
|
|
prompts: string[];
|
|
reducers: string[];
|
|
resources: string[];
|
|
tools: string[];
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* JSON projection of source visibility flags.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourceVisibilityPayload".
|
|
*/
|
|
export interface SourceVisibilityPayload {
|
|
admin_dashboard: boolean;
|
|
client: boolean;
|
|
planner: boolean;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Cursor-paged compact source discovery result.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "ListSourcesResult".
|
|
*/
|
|
export interface ListSourcesResult {
|
|
next_cursor: string | null;
|
|
sources: SourceStatusPayload[];
|
|
total: number;
|
|
[k: string]: unknown;
|
|
}
|
|
/**
|
|
* Compact source metadata returned by source discovery.
|
|
*
|
|
* This interface was referenced by `WorkflowContractMap`'s JSON-Schema
|
|
* via the `definition` "SourceStatusPayload".
|
|
*/
|
|
export interface SourceStatusPayload {
|
|
description: string | null;
|
|
enabled: boolean;
|
|
has_more: SourceCapabilityHasMorePayload;
|
|
id: string;
|
|
kind: "system" | "connection" | "python";
|
|
node_spec_count: number;
|
|
permissions: SourcePermissionsPayload;
|
|
policy: SourcePolicyPayload;
|
|
preview: SourceCapabilityPreviewPayload;
|
|
prompt_count: number;
|
|
reducer_count: number;
|
|
resource_count: number;
|
|
tool_count: number;
|
|
visibility: SourceVisibilityPayload;
|
|
[k: string]: unknown;
|
|
}
|
|
|
|
export type WorkflowOperationParams<Name extends WorkflowOperationName> =
|
|
WorkflowContractMap[Name]["params"];
|
|
|
|
export type WorkflowOperationResult<Name extends WorkflowOperationName> =
|
|
WorkflowContractMap[Name]["result"];
|
|
|
|
// Runtime JSON Schema is limited to parity-verified authored RPCs.
|
|
export const workflowRuntimeContract = {
|
|
"components": {
|
|
"ArrayExpression": {
|
|
"additionalProperties": false,
|
|
"description": "Resolve ordered child expressions into one JSON array.",
|
|
"properties": {
|
|
"items": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/InputExpression"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"kind": {
|
|
"const": "array",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"kind",
|
|
"items"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"ArtifactCatalogEntryPayload": {
|
|
"description": "Compact artifact row returned by discovery operations.",
|
|
"properties": {
|
|
"artifact_id": {
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"diagnostics": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/DependencyDiagnosticPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"display_name": {
|
|
"type": "string"
|
|
},
|
|
"input_schema": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"kind": {
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"type": "string"
|
|
},
|
|
"outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"output_schema": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"required_sources": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"version": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"name",
|
|
"artifact_id",
|
|
"version",
|
|
"kind",
|
|
"display_name",
|
|
"description",
|
|
"outcomes",
|
|
"input_schema",
|
|
"output_schema",
|
|
"required_sources",
|
|
"diagnostics"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"ArtifactKindPayload": {
|
|
"enum": [
|
|
"workflow",
|
|
"wrapper"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"AuthoringContractInventoryPayload": {
|
|
"description": "Revision-scoped readable sources and writable authoring targets.",
|
|
"properties": {
|
|
"entry_steps": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/AuthoringStepContractPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"readable_sources": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"revision": {
|
|
"type": "integer"
|
|
},
|
|
"selected_step_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"state_targets": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"step_input_targets": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"step_output_sources": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"warnings": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"workflow_outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"workflow_output_targets": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"workspace_id": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"revision",
|
|
"selected_step_id",
|
|
"readable_sources",
|
|
"step_input_targets",
|
|
"step_output_sources",
|
|
"state_targets",
|
|
"workflow_output_targets",
|
|
"entry_steps",
|
|
"workflow_outcomes",
|
|
"warnings"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"AuthoringPathAvailability": {
|
|
"enum": [
|
|
"available",
|
|
"conditional"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"AuthoringPathOptionPayload": {
|
|
"description": "One schema-derived source or target available to an author.",
|
|
"properties": {
|
|
"availability": {
|
|
"$ref": "#/components/schemas/AuthoringPathAvailability"
|
|
},
|
|
"description": {
|
|
"type": "string"
|
|
},
|
|
"label": {
|
|
"type": "string"
|
|
},
|
|
"origin": {
|
|
"$ref": "#/components/schemas/AuthoringPathOrigin"
|
|
},
|
|
"path": {
|
|
"type": "string"
|
|
},
|
|
"reason": {
|
|
"type": "string"
|
|
},
|
|
"required": {
|
|
"type": "boolean"
|
|
},
|
|
"schema": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"uses": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/AuthoringPathUse"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"path",
|
|
"label",
|
|
"origin",
|
|
"schema",
|
|
"required",
|
|
"availability",
|
|
"uses"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"AuthoringPathOrigin": {
|
|
"enum": [
|
|
"workflow_input",
|
|
"workflow_state",
|
|
"runtime_context",
|
|
"step_input",
|
|
"step_output",
|
|
"workflow_output"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"AuthoringPathUse": {
|
|
"enum": [
|
|
"step_input",
|
|
"step_output_source",
|
|
"state_target",
|
|
"workflow_output"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"AuthoringStepContractPayload": {
|
|
"description": "Compact executable-step choice used by authoring inventories.",
|
|
"properties": {
|
|
"description": {
|
|
"type": "string"
|
|
},
|
|
"input_targets": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"label": {
|
|
"type": "string"
|
|
},
|
|
"outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"output_sources": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/AuthoringPathOptionPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"step_id": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"step_id",
|
|
"label"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"CapabilityCallResult": {
|
|
"description": "Outcome returned by a direct node-spec or wrapper capability call.",
|
|
"properties": {
|
|
"deployment_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"diagnostics": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/DependencyDiagnosticPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"kind": {
|
|
"enum": [
|
|
"node_spec",
|
|
"wrapper_artifact"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"outcome": {
|
|
"type": "string"
|
|
},
|
|
"output": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"qualified_name": {
|
|
"type": "string"
|
|
},
|
|
"source_id": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"qualified_name",
|
|
"source_id",
|
|
"kind",
|
|
"deployment_id",
|
|
"outcome",
|
|
"output",
|
|
"diagnostics"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"CapabilityKindPayload": {
|
|
"enum": [
|
|
"tool",
|
|
"resource",
|
|
"prompt",
|
|
"node_spec",
|
|
"reducer",
|
|
"workflow"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"CapabilityRefPayload": {
|
|
"properties": {
|
|
"capability_key": {
|
|
"type": "string"
|
|
},
|
|
"source": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"source",
|
|
"capability_key"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"CapabilityStepUpdate": {
|
|
"additionalProperties": false,
|
|
"description": "Presence-aware patch for one existing capability-backed draft step.",
|
|
"properties": {
|
|
"desc": {
|
|
"anyOf": [
|
|
{
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"input": {
|
|
"anyOf": [
|
|
{
|
|
"items": {
|
|
"$ref": "#/components/schemas/StepInputBinding"
|
|
},
|
|
"type": "array"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"retry": {
|
|
"anyOf": [
|
|
{
|
|
"minimum": 0,
|
|
"type": "integer"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"timeout_seconds": {
|
|
"anyOf": [
|
|
{
|
|
"exclusiveMinimum": 0,
|
|
"type": "integer"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"CreateDraftWorkspaceFromCapabilityResult": {
|
|
"description": "Bootstrapped workspace plus the hints and next actions that shaped it.",
|
|
"properties": {
|
|
"diagnostics": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/DraftDiagnosticPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"draft": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"next_actions": {
|
|
"$ref": "#/components/schemas/NextActionsPayload"
|
|
},
|
|
"revision": {
|
|
"type": "integer"
|
|
},
|
|
"status": {
|
|
"enum": [
|
|
"valid",
|
|
"invalid",
|
|
"conflict"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"summary": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceSummary"
|
|
},
|
|
"title": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"workspace_id": {
|
|
"type": "string"
|
|
},
|
|
"wrapper_hints": {
|
|
"$ref": "#/components/schemas/WrapperAuthoringHintsPayload"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"revision",
|
|
"title",
|
|
"status",
|
|
"diagnostics",
|
|
"summary",
|
|
"wrapper_hints",
|
|
"next_actions"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"DependencyDiagnosticPayload": {
|
|
"additionalProperties": true,
|
|
"description": "JSON projection of one deployment dependency diagnostic.",
|
|
"properties": {
|
|
"bound_source": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"code": {
|
|
"type": "string"
|
|
},
|
|
"logical_ref": {
|
|
"type": "string"
|
|
},
|
|
"message": {
|
|
"type": "string"
|
|
},
|
|
"repair_hint": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"severity": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"severity",
|
|
"code",
|
|
"logical_ref",
|
|
"bound_source",
|
|
"message",
|
|
"repair_hint"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"DeploymentSummary": {
|
|
"description": "Compact deployment row used by list operations.",
|
|
"properties": {
|
|
"artifact_id": {
|
|
"type": "string"
|
|
},
|
|
"artifact_version": {
|
|
"type": "integer"
|
|
},
|
|
"binding_count": {
|
|
"type": "integer"
|
|
},
|
|
"drift_policy": {
|
|
"type": "string"
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"artifact_id",
|
|
"artifact_version",
|
|
"id",
|
|
"binding_count",
|
|
"drift_policy"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"DraftDiagnosticPayload": {
|
|
"description": "One validation or revision diagnostic attached to a draft workspace.",
|
|
"properties": {
|
|
"code": {
|
|
"type": "string"
|
|
},
|
|
"details": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"message": {
|
|
"type": "string"
|
|
},
|
|
"path": {
|
|
"type": "string"
|
|
},
|
|
"repair_hint": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"step_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"code",
|
|
"path",
|
|
"message"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"DraftWorkspaceResult": {
|
|
"description": "Canonical persisted workspace envelope returned after reads and edits.",
|
|
"properties": {
|
|
"diagnostics": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/DraftDiagnosticPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"draft": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"revision": {
|
|
"type": "integer"
|
|
},
|
|
"status": {
|
|
"enum": [
|
|
"valid",
|
|
"invalid",
|
|
"conflict"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"summary": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceSummary"
|
|
},
|
|
"title": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"workspace_id": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"revision",
|
|
"title",
|
|
"status",
|
|
"diagnostics",
|
|
"summary"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"DraftWorkspaceSummary": {
|
|
"description": "Compact graph facts included with every persisted workspace result.",
|
|
"properties": {
|
|
"name": {},
|
|
"route_count": {
|
|
"type": "integer"
|
|
},
|
|
"start": {},
|
|
"step_count": {
|
|
"type": "integer"
|
|
},
|
|
"steps": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"name",
|
|
"start",
|
|
"step_count",
|
|
"route_count",
|
|
"steps"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"HealthResult": {
|
|
"description": "Health response shared by self-describing workflow transports.",
|
|
"properties": {
|
|
"status": {
|
|
"const": "ok",
|
|
"type": "string"
|
|
},
|
|
"store_root": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"status",
|
|
"store_root"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"InputExpression": {
|
|
"discriminator": {
|
|
"mapping": {
|
|
"array": "#/components/schemas/ArrayExpression",
|
|
"literal": "#/components/schemas/LiteralExpression",
|
|
"object": "#/components/schemas/ObjectExpression",
|
|
"path": "#/components/schemas/PathExpression"
|
|
},
|
|
"propertyName": "kind"
|
|
},
|
|
"oneOf": [
|
|
{
|
|
"$ref": "#/components/schemas/LiteralExpression"
|
|
},
|
|
{
|
|
"$ref": "#/components/schemas/PathExpression"
|
|
},
|
|
{
|
|
"$ref": "#/components/schemas/ArrayExpression"
|
|
},
|
|
{
|
|
"$ref": "#/components/schemas/ObjectExpression"
|
|
}
|
|
]
|
|
},
|
|
"InputExpressionBinding": {
|
|
"additionalProperties": false,
|
|
"description": "Assign one recursively composed expression to a node-local target.",
|
|
"properties": {
|
|
"expression": {
|
|
"$ref": "#/components/schemas/InputExpression"
|
|
},
|
|
"target": {
|
|
"description": "Node-local path. Use the root marker `.` for the whole payload.",
|
|
"anyOf": [
|
|
{
|
|
"description": "Canonical TOML-key path string.",
|
|
"type": "string"
|
|
},
|
|
{
|
|
"additionalProperties": false,
|
|
"description": "Structural path object accepted as input.",
|
|
"properties": {
|
|
"parts": {
|
|
"items": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"minItems": 0,
|
|
"type": "array"
|
|
},
|
|
"root": {
|
|
"const": "local",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"root",
|
|
"parts"
|
|
],
|
|
"type": "object"
|
|
}
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"target",
|
|
"expression"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"InputPathBinding": {
|
|
"additionalProperties": false,
|
|
"description": "Map one workflow graph source path into one node-local input path.",
|
|
"properties": {
|
|
"path": {
|
|
"description": "Workflow source path to read from input, state, or context. Prefer canonical strings such as `input.text` or `state.report`. Structural objects such as {'root': 'input', 'parts': ['text']} are also accepted as input.",
|
|
"anyOf": [
|
|
{
|
|
"description": "Canonical TOML-key path string.",
|
|
"type": "string"
|
|
},
|
|
{
|
|
"additionalProperties": false,
|
|
"description": "Structural path object accepted as input.",
|
|
"properties": {
|
|
"parts": {
|
|
"items": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"minItems": 0,
|
|
"type": "array"
|
|
},
|
|
"root": {
|
|
"enum": [
|
|
"input",
|
|
"state",
|
|
"context"
|
|
],
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"root",
|
|
"parts"
|
|
],
|
|
"type": "object"
|
|
}
|
|
]
|
|
},
|
|
"target": {
|
|
"description": "Node-local input path to populate. Prefer canonical strings such as `field` or `.` for the whole node input payload. Structural objects such as {'root': 'local', 'parts': ['field']} are also accepted as input.",
|
|
"anyOf": [
|
|
{
|
|
"description": "Canonical TOML-key path string.",
|
|
"type": "string"
|
|
},
|
|
{
|
|
"additionalProperties": false,
|
|
"description": "Structural path object accepted as input.",
|
|
"properties": {
|
|
"parts": {
|
|
"items": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"minItems": 0,
|
|
"type": "array"
|
|
},
|
|
"root": {
|
|
"const": "local",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"root",
|
|
"parts"
|
|
],
|
|
"type": "object"
|
|
}
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"target",
|
|
"path"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"InputValueBinding": {
|
|
"additionalProperties": false,
|
|
"description": "Map one static value into one node-local input path.",
|
|
"properties": {
|
|
"target": {
|
|
"description": "Node-local input path that receives this literal JSON value.",
|
|
"anyOf": [
|
|
{
|
|
"description": "Canonical TOML-key path string.",
|
|
"type": "string"
|
|
},
|
|
{
|
|
"additionalProperties": false,
|
|
"description": "Structural path object accepted as input.",
|
|
"properties": {
|
|
"parts": {
|
|
"items": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"minItems": 0,
|
|
"type": "array"
|
|
},
|
|
"root": {
|
|
"const": "local",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"root",
|
|
"parts"
|
|
],
|
|
"type": "object"
|
|
}
|
|
]
|
|
},
|
|
"value": {
|
|
"$ref": "#/components/schemas/JsonValue",
|
|
"description": "Literal JSON-compatible value to pass to the node. Use this for constants, not for values read from workflow input or state."
|
|
}
|
|
},
|
|
"required": [
|
|
"target",
|
|
"value"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"InspectCapabilityResult": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/NodeSpecCapabilityDetail"
|
|
},
|
|
{
|
|
"$ref": "#/components/schemas/WrapperArtifactCapabilityDetail"
|
|
}
|
|
]
|
|
},
|
|
"InterruptPayload": {
|
|
"description": "Persisted typed interrupt contract exposed to API clients.",
|
|
"properties": {
|
|
"frame_id": {
|
|
"type": "string"
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"kind": {
|
|
"type": "string"
|
|
},
|
|
"node_id": {
|
|
"type": "string"
|
|
},
|
|
"outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"payload": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"request_schema": {
|
|
"$ref": "#/components/schemas/JsonSchema"
|
|
},
|
|
"resumable": {
|
|
"type": "boolean"
|
|
},
|
|
"resume_schema": {
|
|
"$ref": "#/components/schemas/JsonSchema"
|
|
},
|
|
"route": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/InterruptRoutePayload"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"typed": {
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"frame_id",
|
|
"node_id",
|
|
"kind",
|
|
"payload",
|
|
"resumable",
|
|
"route",
|
|
"outcomes",
|
|
"request_schema",
|
|
"resume_schema",
|
|
"typed"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"InterruptRoutePayload": {
|
|
"properties": {
|
|
"frame_id": {
|
|
"type": "string"
|
|
},
|
|
"lineage_id": {
|
|
"type": "string"
|
|
},
|
|
"node_id": {
|
|
"type": "string"
|
|
},
|
|
"parent_frame_id": {
|
|
"type": "string"
|
|
},
|
|
"scope_id": {
|
|
"type": "string"
|
|
},
|
|
"workflow_ref": {
|
|
"$ref": "#/components/schemas/WorkflowRefPayload"
|
|
}
|
|
},
|
|
"required": [
|
|
"frame_id",
|
|
"node_id",
|
|
"scope_id",
|
|
"lineage_id",
|
|
"parent_frame_id",
|
|
"workflow_ref"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"JsonObject": {
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
"JsonSchema": {
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
"JsonValue": {
|
|
"anyOf": [
|
|
{
|
|
"type": "boolean"
|
|
},
|
|
{
|
|
"type": "integer"
|
|
},
|
|
{
|
|
"type": "number"
|
|
},
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"items": {
|
|
"$ref": "#/components/schemas/JsonValue"
|
|
},
|
|
"type": "array"
|
|
},
|
|
{
|
|
"additionalProperties": {
|
|
"$ref": "#/components/schemas/JsonValue"
|
|
},
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"ListArtifactsResult": {
|
|
"properties": {
|
|
"next_cursor": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"nodes": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/ArtifactCatalogEntryPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"total": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"next_cursor",
|
|
"total",
|
|
"nodes"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"ListCapabilitiesResult": {
|
|
"description": "Cursor-paged planner-visible capability discovery result.",
|
|
"properties": {
|
|
"capabilities": {
|
|
"items": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/NodeSpecCapabilitySummary"
|
|
},
|
|
{
|
|
"$ref": "#/components/schemas/WrapperArtifactCapabilitySummary"
|
|
}
|
|
]
|
|
},
|
|
"type": "array"
|
|
},
|
|
"next_cursor": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"total": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"next_cursor",
|
|
"total",
|
|
"capabilities"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"ListDeploymentsResult": {
|
|
"properties": {
|
|
"deployments": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/DeploymentSummary"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"deployments"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"ListDraftWorkspacesResult": {
|
|
"description": "All persisted draft-workspace summaries.",
|
|
"properties": {
|
|
"workspaces": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspaces"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"ListRunsResult": {
|
|
"properties": {
|
|
"cursor": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"limit": {
|
|
"type": "integer"
|
|
},
|
|
"next_cursor": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"runs": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/RunSummary"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"total": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"runs",
|
|
"total",
|
|
"cursor",
|
|
"next_cursor",
|
|
"limit"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"ListSourcesResult": {
|
|
"description": "Cursor-paged compact source discovery result.",
|
|
"properties": {
|
|
"next_cursor": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"sources": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/SourceStatusPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"total": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"next_cursor",
|
|
"total",
|
|
"sources"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"LiteralExpression": {
|
|
"additionalProperties": false,
|
|
"description": "A strict JSON literal embedded in a node-local input expression.",
|
|
"properties": {
|
|
"kind": {
|
|
"const": "literal",
|
|
"type": "string"
|
|
},
|
|
"value": {
|
|
"$ref": "#/components/schemas/JsonValue"
|
|
}
|
|
},
|
|
"required": [
|
|
"kind",
|
|
"value"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"NextActionPatchExamplePayload": {
|
|
"description": "Concrete follow-up operation suggested to an API caller.",
|
|
"properties": {
|
|
"description": {
|
|
"type": "string"
|
|
},
|
|
"request": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"tool": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"description",
|
|
"tool",
|
|
"request"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"NextActionsPayload": {
|
|
"description": "JSON projection of advisory workflow continuation guidance.",
|
|
"properties": {
|
|
"can_continue": {
|
|
"type": "boolean"
|
|
},
|
|
"can_save_now": {
|
|
"anyOf": [
|
|
{
|
|
"type": "boolean"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"patch_examples": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/NextActionPatchExamplePayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"reason": {
|
|
"type": "string"
|
|
},
|
|
"recommended_next_tool": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"warnings": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"can_continue",
|
|
"can_save_now",
|
|
"recommended_next_tool",
|
|
"reason",
|
|
"patch_examples",
|
|
"warnings"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"NodeSpecCapabilityDetail": {
|
|
"description": "Full executable contract for one source node spec.",
|
|
"properties": {
|
|
"accepts_context": {
|
|
"type": "boolean"
|
|
},
|
|
"description": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"input_schema": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"is_async": {
|
|
"type": "boolean"
|
|
},
|
|
"kind": {
|
|
"const": "node_spec",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"type": "string"
|
|
},
|
|
"outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"output_schema": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"source_id": {
|
|
"type": "string"
|
|
},
|
|
"wrapper_hints": {
|
|
"$ref": "#/components/schemas/WrapperAuthoringHintsPayload"
|
|
}
|
|
},
|
|
"required": [
|
|
"name",
|
|
"source_id",
|
|
"description",
|
|
"outcomes",
|
|
"is_async",
|
|
"input_schema",
|
|
"output_schema",
|
|
"wrapper_hints",
|
|
"kind",
|
|
"accepts_context"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"NodeSpecCapabilitySummary": {
|
|
"description": "Compact discovery row for one executable source node spec.",
|
|
"properties": {
|
|
"description": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"input_fields": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"is_async": {
|
|
"type": "boolean"
|
|
},
|
|
"kind": {
|
|
"const": "node_spec",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"type": "string"
|
|
},
|
|
"outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"output_fields": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"source_id": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"name",
|
|
"source_id",
|
|
"description",
|
|
"outcomes",
|
|
"is_async",
|
|
"input_fields",
|
|
"output_fields",
|
|
"kind"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"ObjectExpression": {
|
|
"additionalProperties": false,
|
|
"description": "Resolve named child expressions into one JSON object.",
|
|
"properties": {
|
|
"fields": {
|
|
"additionalProperties": {
|
|
"$ref": "#/components/schemas/InputExpression"
|
|
},
|
|
"type": "object"
|
|
},
|
|
"kind": {
|
|
"const": "object",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"kind",
|
|
"fields"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"OutputBinding": {
|
|
"additionalProperties": false,
|
|
"description": "Map one node-local output path into one workflow state path.",
|
|
"properties": {
|
|
"source": {
|
|
"description": "Node-local output path to read. Prefer canonical strings such as `result` or `.` for the whole node output payload. Structural objects such as {'root': 'local', 'parts': []} are also accepted as input.",
|
|
"anyOf": [
|
|
{
|
|
"description": "Canonical TOML-key path string.",
|
|
"type": "string"
|
|
},
|
|
{
|
|
"additionalProperties": false,
|
|
"description": "Structural path object accepted as input.",
|
|
"properties": {
|
|
"parts": {
|
|
"items": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"minItems": 0,
|
|
"type": "array"
|
|
},
|
|
"root": {
|
|
"const": "local",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"root",
|
|
"parts"
|
|
],
|
|
"type": "object"
|
|
}
|
|
]
|
|
},
|
|
"target": {
|
|
"description": "Writable workflow state path. Bare state is invalid; use a field path such as `state.echoed`. Structural objects such as {'root': 'state', 'parts': ['echoed']} are also accepted as input.",
|
|
"anyOf": [
|
|
{
|
|
"description": "Canonical TOML-key path string.",
|
|
"type": "string"
|
|
},
|
|
{
|
|
"additionalProperties": false,
|
|
"description": "Structural path object accepted as input.",
|
|
"properties": {
|
|
"parts": {
|
|
"items": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"minItems": 1,
|
|
"type": "array"
|
|
},
|
|
"root": {
|
|
"const": "state",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"root",
|
|
"parts"
|
|
],
|
|
"type": "object"
|
|
}
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"source",
|
|
"target"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"PathExpression": {
|
|
"additionalProperties": false,
|
|
"description": "Read one graph source path while resolving a composite input.",
|
|
"properties": {
|
|
"kind": {
|
|
"const": "path",
|
|
"type": "string"
|
|
},
|
|
"path": {
|
|
"description": "Readable graph path rooted at input, state, or context.",
|
|
"anyOf": [
|
|
{
|
|
"description": "Canonical TOML-key path string.",
|
|
"type": "string"
|
|
},
|
|
{
|
|
"additionalProperties": false,
|
|
"description": "Structural path object accepted as input.",
|
|
"properties": {
|
|
"parts": {
|
|
"items": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"minItems": 0,
|
|
"type": "array"
|
|
},
|
|
"root": {
|
|
"enum": [
|
|
"input",
|
|
"state",
|
|
"context"
|
|
],
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"root",
|
|
"parts"
|
|
],
|
|
"type": "object"
|
|
}
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"kind",
|
|
"path"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"RequiredCapabilityPayload": {
|
|
"description": "Saved dependency contract for one artifact capability reference.",
|
|
"properties": {
|
|
"input_schema_hash": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"input_schema_snapshot": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"kind": {
|
|
"$ref": "#/components/schemas/CapabilityKindPayload"
|
|
},
|
|
"observed_at_epoch_ms": {
|
|
"anyOf": [
|
|
{
|
|
"type": "integer"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"observed_concrete_source": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"output_schema_hash": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"output_schema_snapshot": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"ref": {
|
|
"$ref": "#/components/schemas/CapabilityRefPayload"
|
|
}
|
|
},
|
|
"required": [
|
|
"ref",
|
|
"kind",
|
|
"input_schema_hash",
|
|
"input_schema_snapshot",
|
|
"output_schema_hash",
|
|
"output_schema_snapshot",
|
|
"observed_concrete_source",
|
|
"observed_at_epoch_ms"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"ResumeReadiness": {
|
|
"type": "string"
|
|
},
|
|
"RunResult": {
|
|
"description": "Run operation result with an optional caller-requested trace slice.",
|
|
"properties": {
|
|
"artifact_id": {
|
|
"type": "string"
|
|
},
|
|
"artifact_version": {
|
|
"type": "integer"
|
|
},
|
|
"deployment_id": {
|
|
"type": "string"
|
|
},
|
|
"diagnostics": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/DependencyDiagnosticPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"error": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"interrupt": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/InterruptPayload"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"max_steps": {
|
|
"type": "integer"
|
|
},
|
|
"next_actions": {
|
|
"$ref": "#/components/schemas/NextActionsPayload"
|
|
},
|
|
"outcome": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"output": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"resume_readiness": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/ResumeReadiness"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"run_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"status": {
|
|
"$ref": "#/components/schemas/RunStatus"
|
|
},
|
|
"steps_executed": {
|
|
"type": "integer"
|
|
},
|
|
"steps_remaining": {
|
|
"type": "integer"
|
|
},
|
|
"trace": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/TraceEntryPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"trace_count": {
|
|
"type": "integer"
|
|
},
|
|
"trace_limit": {
|
|
"type": "integer"
|
|
},
|
|
"trace_start": {
|
|
"type": "integer"
|
|
},
|
|
"trace_truncated": {
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"required": [
|
|
"artifact_id",
|
|
"artifact_version",
|
|
"diagnostics",
|
|
"next_actions",
|
|
"deployment_id",
|
|
"status",
|
|
"run_id",
|
|
"resume_readiness",
|
|
"interrupt",
|
|
"outcome",
|
|
"error",
|
|
"output",
|
|
"trace_count",
|
|
"max_steps",
|
|
"steps_executed",
|
|
"steps_remaining"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"RunStatus": {
|
|
"type": "string"
|
|
},
|
|
"RunSummary": {
|
|
"properties": {
|
|
"artifact_id": {
|
|
"type": "string"
|
|
},
|
|
"artifact_version": {
|
|
"type": "integer"
|
|
},
|
|
"created_at": {
|
|
"type": "string"
|
|
},
|
|
"deployment_id": {
|
|
"type": "string"
|
|
},
|
|
"diagnostic_count": {
|
|
"type": "integer"
|
|
},
|
|
"resume_readiness": {
|
|
"$ref": "#/components/schemas/ResumeReadiness"
|
|
},
|
|
"run_id": {
|
|
"type": "string"
|
|
},
|
|
"status": {
|
|
"$ref": "#/components/schemas/RunStatus"
|
|
},
|
|
"updated_at": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"artifact_id",
|
|
"artifact_version",
|
|
"run_id",
|
|
"deployment_id",
|
|
"status",
|
|
"resume_readiness",
|
|
"diagnostic_count",
|
|
"created_at",
|
|
"updated_at"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"RunTraceResult": {
|
|
"description": "Run result where a bounded trace slice is always present.",
|
|
"properties": {
|
|
"artifact_id": {
|
|
"type": "string"
|
|
},
|
|
"artifact_version": {
|
|
"type": "integer"
|
|
},
|
|
"deployment_id": {
|
|
"type": "string"
|
|
},
|
|
"diagnostics": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/DependencyDiagnosticPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"error": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"interrupt": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/InterruptPayload"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"max_steps": {
|
|
"type": "integer"
|
|
},
|
|
"next_actions": {
|
|
"$ref": "#/components/schemas/NextActionsPayload"
|
|
},
|
|
"outcome": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"output": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"resume_readiness": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/ResumeReadiness"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"run_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"status": {
|
|
"$ref": "#/components/schemas/RunStatus"
|
|
},
|
|
"steps_executed": {
|
|
"type": "integer"
|
|
},
|
|
"steps_remaining": {
|
|
"type": "integer"
|
|
},
|
|
"trace": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/TraceEntryPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"trace_count": {
|
|
"type": "integer"
|
|
},
|
|
"trace_limit": {
|
|
"type": "integer"
|
|
},
|
|
"trace_start": {
|
|
"type": "integer"
|
|
},
|
|
"trace_truncated": {
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"required": [
|
|
"artifact_id",
|
|
"artifact_version",
|
|
"diagnostics",
|
|
"next_actions",
|
|
"deployment_id",
|
|
"status",
|
|
"run_id",
|
|
"resume_readiness",
|
|
"interrupt",
|
|
"outcome",
|
|
"error",
|
|
"output",
|
|
"trace_count",
|
|
"max_steps",
|
|
"steps_executed",
|
|
"steps_remaining",
|
|
"trace",
|
|
"trace_start",
|
|
"trace_limit",
|
|
"trace_truncated"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"SourceBindingPayload": {
|
|
"description": "JSON projection of a logical-to-concrete deployment source binding.",
|
|
"properties": {
|
|
"concrete_source": {
|
|
"type": "string"
|
|
},
|
|
"logical_source": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"logical_source",
|
|
"concrete_source"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"SourceCapabilityHasMorePayload": {
|
|
"description": "Whether each compact capability preview omitted owned names.",
|
|
"properties": {
|
|
"node_specs": {
|
|
"type": "boolean"
|
|
},
|
|
"prompts": {
|
|
"type": "boolean"
|
|
},
|
|
"reducers": {
|
|
"type": "boolean"
|
|
},
|
|
"resources": {
|
|
"type": "boolean"
|
|
},
|
|
"tools": {
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"required": [
|
|
"tools",
|
|
"node_specs",
|
|
"reducers",
|
|
"prompts",
|
|
"resources"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"SourceCapabilityPreviewPayload": {
|
|
"description": "Small sorted capability-name sample used by compact source rows.",
|
|
"properties": {
|
|
"node_specs": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"prompts": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"reducers": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"resources": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"tools": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"tools",
|
|
"node_specs",
|
|
"reducers",
|
|
"prompts",
|
|
"resources"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"SourcePermissionsPayload": {
|
|
"description": "JSON projection of source permission flags.",
|
|
"properties": {
|
|
"calls_upstream": {
|
|
"type": "boolean"
|
|
},
|
|
"mutates_auth": {
|
|
"type": "boolean"
|
|
},
|
|
"mutates_config": {
|
|
"type": "boolean"
|
|
},
|
|
"safe_for_workflow": {
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"required": [
|
|
"safe_for_workflow",
|
|
"calls_upstream",
|
|
"mutates_config",
|
|
"mutates_auth"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"SourcePolicyPayload": {
|
|
"description": "JSON projection of deployment-binding policy for one source.",
|
|
"properties": {
|
|
"binding_required": {
|
|
"type": "boolean"
|
|
},
|
|
"platform": {
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"required": [
|
|
"platform",
|
|
"binding_required"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"SourceStatusPayload": {
|
|
"description": "Compact source metadata returned by source discovery.",
|
|
"properties": {
|
|
"description": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"enabled": {
|
|
"type": "boolean"
|
|
},
|
|
"has_more": {
|
|
"$ref": "#/components/schemas/SourceCapabilityHasMorePayload"
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"kind": {
|
|
"enum": [
|
|
"system",
|
|
"connection",
|
|
"python"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"node_spec_count": {
|
|
"type": "integer"
|
|
},
|
|
"permissions": {
|
|
"$ref": "#/components/schemas/SourcePermissionsPayload"
|
|
},
|
|
"policy": {
|
|
"$ref": "#/components/schemas/SourcePolicyPayload"
|
|
},
|
|
"preview": {
|
|
"$ref": "#/components/schemas/SourceCapabilityPreviewPayload"
|
|
},
|
|
"prompt_count": {
|
|
"type": "integer"
|
|
},
|
|
"reducer_count": {
|
|
"type": "integer"
|
|
},
|
|
"resource_count": {
|
|
"type": "integer"
|
|
},
|
|
"tool_count": {
|
|
"type": "integer"
|
|
},
|
|
"visibility": {
|
|
"$ref": "#/components/schemas/SourceVisibilityPayload"
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"kind",
|
|
"enabled",
|
|
"visibility",
|
|
"permissions",
|
|
"policy",
|
|
"description",
|
|
"tool_count",
|
|
"node_spec_count",
|
|
"reducer_count",
|
|
"prompt_count",
|
|
"resource_count",
|
|
"preview",
|
|
"has_more"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"SourceVisibilityPayload": {
|
|
"description": "JSON projection of source visibility flags.",
|
|
"properties": {
|
|
"admin_dashboard": {
|
|
"type": "boolean"
|
|
},
|
|
"client": {
|
|
"type": "boolean"
|
|
},
|
|
"planner": {
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"required": [
|
|
"planner",
|
|
"client",
|
|
"admin_dashboard"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"StepInputBinding": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/InputPathBinding"
|
|
},
|
|
{
|
|
"$ref": "#/components/schemas/InputValueBinding"
|
|
},
|
|
{
|
|
"$ref": "#/components/schemas/InputExpressionBinding"
|
|
}
|
|
]
|
|
},
|
|
"TraceEntryPayload": {
|
|
"properties": {
|
|
"frame_id": {
|
|
"type": "string"
|
|
},
|
|
"next_node_id": {
|
|
"type": "string"
|
|
},
|
|
"node_id": {
|
|
"type": "string"
|
|
},
|
|
"outcome": {
|
|
"type": "string"
|
|
},
|
|
"output": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"resolved_input": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"state_changes": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"step_number": {
|
|
"anyOf": [
|
|
{
|
|
"type": "integer"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"step_type": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"frame_id",
|
|
"node_id",
|
|
"step_type",
|
|
"step_number",
|
|
"resolved_input",
|
|
"outcome",
|
|
"next_node_id",
|
|
"output",
|
|
"state_changes"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"TraceRangeParams": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"limit": {
|
|
"default": 20,
|
|
"description": "Maximum trace entries to return; full traces are never implicit.",
|
|
"maximum": 100,
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"start": {
|
|
"default": 0,
|
|
"description": "Zero-based trace offset.",
|
|
"minimum": 0,
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"ValidateDeploymentResult": {
|
|
"properties": {
|
|
"artifact_id": {
|
|
"type": "string"
|
|
},
|
|
"artifact_version": {
|
|
"type": "integer"
|
|
},
|
|
"deployment_id": {
|
|
"type": "string"
|
|
},
|
|
"diagnostics": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/DependencyDiagnosticPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"next_actions": {
|
|
"$ref": "#/components/schemas/NextActionsPayload"
|
|
},
|
|
"status": {
|
|
"enum": [
|
|
"runnable",
|
|
"unrunnable"
|
|
],
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"artifact_id",
|
|
"artifact_version",
|
|
"diagnostics",
|
|
"next_actions",
|
|
"deployment_id",
|
|
"status"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"WorkflowArtifactPayload": {
|
|
"description": "Normalized immutable artifact returned by inspect operations.",
|
|
"properties": {
|
|
"created_from_catalog_version": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"description": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"input_schema": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"kind": {
|
|
"$ref": "#/components/schemas/ArtifactKindPayload"
|
|
},
|
|
"outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"output_schema": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"plan": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"required_capabilities": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/RequiredCapabilityPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"title": {
|
|
"type": "string"
|
|
},
|
|
"version": {
|
|
"type": "integer"
|
|
},
|
|
"workflow_dependencies": {
|
|
"additionalProperties": {
|
|
"type": "integer"
|
|
},
|
|
"type": "object"
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"version",
|
|
"title",
|
|
"kind",
|
|
"description",
|
|
"input_schema",
|
|
"output_schema",
|
|
"outcomes",
|
|
"plan",
|
|
"required_capabilities",
|
|
"workflow_dependencies",
|
|
"created_from_catalog_version"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"WorkflowDeploymentPayload": {
|
|
"description": "Serialized deployment accepted and returned by workflow API surfaces.",
|
|
"properties": {
|
|
"artifact_id": {
|
|
"type": "string"
|
|
},
|
|
"artifact_version": {
|
|
"type": "integer"
|
|
},
|
|
"bindings": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/SourceBindingPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"drift_policy": {
|
|
"type": "string"
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"artifact_id",
|
|
"artifact_version",
|
|
"id",
|
|
"bindings",
|
|
"drift_policy"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"WorkflowRefPayload": {
|
|
"properties": {
|
|
"artifact_id": {
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"type": "string"
|
|
},
|
|
"version": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"WrapperArtifactCapabilityDetail": {
|
|
"description": "Full callable contract for one saved wrapper artifact.",
|
|
"properties": {
|
|
"artifact_id": {
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"input_schema": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"is_async": {
|
|
"type": "boolean"
|
|
},
|
|
"kind": {
|
|
"const": "wrapper_artifact",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"type": "string"
|
|
},
|
|
"outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"output_schema": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"required_capabilities": {
|
|
"additionalProperties": {
|
|
"$ref": "#/components/schemas/RequiredCapabilityPayload"
|
|
},
|
|
"type": "object"
|
|
},
|
|
"source_id": {
|
|
"type": "string"
|
|
},
|
|
"title": {
|
|
"type": "string"
|
|
},
|
|
"version": {
|
|
"type": "integer"
|
|
},
|
|
"wrapper_hints": {
|
|
"$ref": "#/components/schemas/WrapperAuthoringHintsPayload"
|
|
}
|
|
},
|
|
"required": [
|
|
"name",
|
|
"source_id",
|
|
"description",
|
|
"outcomes",
|
|
"is_async",
|
|
"input_schema",
|
|
"output_schema",
|
|
"wrapper_hints",
|
|
"kind",
|
|
"artifact_id",
|
|
"version",
|
|
"title",
|
|
"required_capabilities"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"WrapperArtifactCapabilitySummary": {
|
|
"description": "Compact discovery row for one saved wrapper artifact.",
|
|
"properties": {
|
|
"artifact_id": {
|
|
"type": "string"
|
|
},
|
|
"description": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
},
|
|
"input_fields": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"is_async": {
|
|
"type": "boolean"
|
|
},
|
|
"kind": {
|
|
"const": "wrapper_artifact",
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"type": "string"
|
|
},
|
|
"outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"output_fields": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"source_id": {
|
|
"type": "string"
|
|
},
|
|
"title": {
|
|
"type": "string"
|
|
},
|
|
"version": {
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"name",
|
|
"source_id",
|
|
"description",
|
|
"outcomes",
|
|
"is_async",
|
|
"input_fields",
|
|
"output_fields",
|
|
"kind",
|
|
"artifact_id",
|
|
"version",
|
|
"title"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"WrapperAuthoringHintsPayload": {
|
|
"description": "Transport-neutral projection of conservative wrapper scaffolding hints.",
|
|
"properties": {
|
|
"capability_name": {
|
|
"type": "string"
|
|
},
|
|
"confidence": {
|
|
"enum": [
|
|
"high",
|
|
"medium",
|
|
"low"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"declared_outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"input_map": {
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
},
|
|
"type": "object"
|
|
},
|
|
"input_schema": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"missing_decisions": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/WrapperMissingDecisionPayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"notes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"outcome_candidates": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/WrapperOutcomeCandidatePayload"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"outcome_policy": {
|
|
"enum": [
|
|
"preserve_declared",
|
|
"manual_mapping_required"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"output_map": {
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
},
|
|
"type": "object"
|
|
},
|
|
"output_schema": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"state_schema": {
|
|
"$ref": "#/components/schemas/JsonObject"
|
|
},
|
|
"suggested_wrapper_outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"capability_name",
|
|
"confidence",
|
|
"declared_outcomes",
|
|
"suggested_wrapper_outcomes",
|
|
"outcome_policy",
|
|
"input_schema",
|
|
"state_schema",
|
|
"output_schema",
|
|
"input_map",
|
|
"output_map",
|
|
"outcome_candidates",
|
|
"missing_decisions",
|
|
"notes"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"WrapperMissingDecisionPayload": {
|
|
"description": "One unresolved wrapper-authoring decision.",
|
|
"properties": {
|
|
"kind": {
|
|
"enum": [
|
|
"choose_output_fields",
|
|
"review_nested_output",
|
|
"confirm_boolean_outcomes",
|
|
"choose_error_mapping"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"message": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"kind",
|
|
"message"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"WrapperOutcomeCandidatePayload": {
|
|
"description": "Possible wrapper outcome mapping that still requires caller judgment.",
|
|
"properties": {
|
|
"automatic": {
|
|
"type": "boolean"
|
|
},
|
|
"candidate_outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"confidence": {
|
|
"enum": [
|
|
"high",
|
|
"medium",
|
|
"low"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"kind": {
|
|
"const": "boolean_control_field",
|
|
"type": "string"
|
|
},
|
|
"reason": {
|
|
"type": "string"
|
|
},
|
|
"source": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"kind",
|
|
"source",
|
|
"candidate_outcomes",
|
|
"confidence",
|
|
"reason",
|
|
"automatic"
|
|
],
|
|
"type": "object"
|
|
}
|
|
},
|
|
"operations": {
|
|
"workflow.artifacts.inspect": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"artifact_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"version": {
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"artifact_id",
|
|
"version"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/WorkflowArtifactPayload"
|
|
}
|
|
},
|
|
"workflow.artifacts.list": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"query": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"kind": {
|
|
"anyOf": [
|
|
{
|
|
"enum": [
|
|
"workflow",
|
|
"wrapper"
|
|
],
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"cursor": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"limit": {
|
|
"default": 50,
|
|
"maximum": 100,
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/ListArtifactsResult"
|
|
}
|
|
},
|
|
"workflow.capabilities.call": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"qualified_name": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"payload": {
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
"deployment_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
}
|
|
},
|
|
"required": [
|
|
"qualified_name"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/CapabilityCallResult"
|
|
}
|
|
},
|
|
"workflow.capabilities.inspect": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"qualified_name": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"qualified_name"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/InspectCapabilityResult"
|
|
}
|
|
},
|
|
"workflow.capabilities.list": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"query": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"source_id": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"cursor": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"limit": {
|
|
"default": 50,
|
|
"maximum": 200,
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/ListCapabilitiesResult"
|
|
}
|
|
},
|
|
"workflow.deployments.inspect": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"deployment_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"deployment_id"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/WorkflowDeploymentPayload"
|
|
}
|
|
},
|
|
"workflow.deployments.list": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {},
|
|
"required": [],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/ListDeploymentsResult"
|
|
}
|
|
},
|
|
"workflow.deployments.validate": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"deployment_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"live_check": {
|
|
"default": false,
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"required": [
|
|
"deployment_id"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/ValidateDeploymentResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.add_step_from_capability": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"revision": {
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"step_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"capability_name": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"route_from_step": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"route_from_outcome": {
|
|
"default": "ok",
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"routes": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
},
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"input_map": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
},
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"input_bindings": {
|
|
"anyOf": [
|
|
{
|
|
"items": {
|
|
"$ref": "#/components/schemas/StepInputBinding"
|
|
},
|
|
"type": "array"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"bind_outputs": {
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
},
|
|
"type": "object"
|
|
},
|
|
"desc": {
|
|
"anyOf": [
|
|
{
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"retry": {
|
|
"anyOf": [
|
|
{
|
|
"minimum": 0,
|
|
"type": "integer"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"timeout_seconds": {
|
|
"anyOf": [
|
|
{
|
|
"exclusiveMinimum": 0,
|
|
"type": "integer"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"revision",
|
|
"step_id",
|
|
"capability_name"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.create_empty": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"title": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"input_schema": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"state_schema": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"output_schema": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"outcomes": {
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"name"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.create_from_capability": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"capability_name": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"title": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"input_schema": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"state_schema": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"output_schema": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"input": {
|
|
"anyOf": [
|
|
{
|
|
"items": {
|
|
"$ref": "#/components/schemas/StepInputBinding"
|
|
},
|
|
"type": "array"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"output": {
|
|
"anyOf": [
|
|
{
|
|
"items": {
|
|
"$ref": "#/components/schemas/OutputBinding"
|
|
},
|
|
"type": "array"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"input_map": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
},
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"output_map": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
},
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"error_message_source": {
|
|
"anyOf": [
|
|
{},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"capability_name"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/CreateDraftWorkspaceFromCapabilityResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.get": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"include_draft": {
|
|
"default": false,
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.inspect_authoring_contract": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"revision": {
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"selected_step_id": {
|
|
"anyOf": [
|
|
{
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"revision"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/AuthoringContractInventoryPayload"
|
|
},
|
|
{
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
}
|
|
]
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.list": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {},
|
|
"required": [],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/ListDraftWorkspacesResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.set_contract": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"revision": {
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"input_schema": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"state_schema": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"output_schema": {
|
|
"anyOf": [
|
|
{
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"outcomes": {
|
|
"anyOf": [
|
|
{
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"revision"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.set_route": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"revision": {
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"step_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"outcome": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"target": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"revision",
|
|
"step_id",
|
|
"outcome",
|
|
"target"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.set_start": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"revision": {
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"step_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"revision",
|
|
"step_id"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.set_step_input_bindings": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"revision": {
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"step_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"bindings": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/StepInputBinding"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"revision",
|
|
"step_id",
|
|
"bindings"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.set_step_output_bindings": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"revision": {
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"step_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"bindings": {
|
|
"items": {
|
|
"$ref": "#/components/schemas/OutputBinding"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"revision",
|
|
"step_id",
|
|
"bindings"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.set_workflow_output_bindings": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"revision": {
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"bindings": {
|
|
"items": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/InputPathBinding"
|
|
},
|
|
{
|
|
"$ref": "#/components/schemas/InputValueBinding"
|
|
}
|
|
],
|
|
"description": "Simple canonical binding for node inputs or workflow outputs. Use either a path binding with `path`, or a literal binding with `value`; composite `expression` bindings are node-local only."
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"revision",
|
|
"bindings"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.update_capability_step": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"revision": {
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"step_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"update": {
|
|
"$ref": "#/components/schemas/CapabilityStepUpdate"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id",
|
|
"revision",
|
|
"step_id",
|
|
"update"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
}
|
|
},
|
|
"workflow.draft_workspaces.validate": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"workspace_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"workspace_id"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/DraftWorkspaceResult"
|
|
}
|
|
},
|
|
"workflow.health": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {},
|
|
"required": [],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/HealthResult"
|
|
}
|
|
},
|
|
"workflow.runs.inspect": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"run_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"run_id"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/RunResult"
|
|
}
|
|
},
|
|
"workflow.runs.list": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"status": {
|
|
"anyOf": [
|
|
{
|
|
"enum": [
|
|
"completed",
|
|
"failed",
|
|
"interrupted"
|
|
],
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"cursor": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"limit": {
|
|
"default": 50,
|
|
"maximum": 100,
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/ListRunsResult"
|
|
}
|
|
},
|
|
"workflow.runs.resume": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"run_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"resume_payload": {
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
"resume_outcome": {
|
|
"default": "submitted",
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"trace_range": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/TraceRangeParams"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
}
|
|
},
|
|
"required": [
|
|
"run_id"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/RunResult"
|
|
}
|
|
},
|
|
"workflow.runs.start": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"deployment_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"workflow_input": {
|
|
"additionalProperties": true,
|
|
"type": "object"
|
|
},
|
|
"trace_range": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/components/schemas/TraceRangeParams"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"max_steps": {
|
|
"anyOf": [
|
|
{
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null,
|
|
"description": "Optional run step budget. The server default applies when omitted; resume never accepts a replacement."
|
|
}
|
|
},
|
|
"required": [
|
|
"deployment_id"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/RunResult"
|
|
}
|
|
},
|
|
"workflow.runs.trace": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"run_id": {
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"trace_range": {
|
|
"$ref": "#/components/schemas/TraceRangeParams"
|
|
}
|
|
},
|
|
"required": [
|
|
"run_id",
|
|
"trace_range"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/RunTraceResult"
|
|
}
|
|
},
|
|
"workflow.sources.list": {
|
|
"payload": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"cursor": {
|
|
"anyOf": [
|
|
{
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
],
|
|
"default": null
|
|
},
|
|
"limit": {
|
|
"default": 50,
|
|
"maximum": 100,
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [],
|
|
"type": "object"
|
|
},
|
|
"success": {
|
|
"$ref": "#/components/schemas/ListSourcesResult"
|
|
}
|
|
}
|
|
}
|
|
};
|