@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/workflows.d.ts

@@ -0,0 +1,1218 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.workflows` (Workflows): 59 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"approve_execution_workflows_executions_approve_post">;
+ *
+ * Reference with examples: workflows.md
+ */
+/* eslint-disable */
+
+/** `g8.api.workflows.<member>` -> the operationId it calls. */
+export interface WorkflowsMembers {
+  approveExecution: "approve_execution_workflows_executions_approve_post";
+  attachSkillCollections: "attach_skill_collections_skills__action_id__collections_post";
+  bulkRestartExecutions: "bulk_restart_executions_workflows_executions_bulk_restart_post";
+  createSkillTestCase: "create_skill_test_case_skills__action_id__test_cases_post";
+  createWorkbench: "create_workbench_workflows_workbenches_post";
+  createWorkflow: "create_workflow_workflows_post";
+  deleteSkillTestCase: "delete_skill_test_case_skills__action_id__test_cases__test_case_id__delete";
+  deleteWorkflow: "delete_workflow_workflows__action_id__delete";
+  deleteWorkflowIntegration: "delete_workflow_integration_workflows_integrations__provider_name__delete";
+  describeFormFields: "describe_form_fields_workflows_forms__form_id__fields_get";
+  detachSkillCollection: "detach_skill_collection_skills__action_id__collections__collection_id__delete";
+  diffSkillVersions: "diff_skill_versions_skills__action_id__versions__version_id__diff_get";
+  executeWorkflow: "execute_workflow_workflows__action_id__execute_post";
+  getExecution: "get_execution_workflows_executions__execution_id__get";
+  getExecutionStats: "get_execution_stats_workflows_stats_executions_get";
+  getNodeTypesSchema: "get_node_types_schema_workflows_node_types_schema_get";
+  getTriggerActivity: "get_trigger_activity_workflows_stats_trigger_activity_get";
+  getTriggerStatus: "get_trigger_status_workflows__action_id__trigger_status_get";
+  getWorkflow: "get_workflow_workflows__action_id__get";
+  getWorkflowIntegration: "get_workflow_integration_workflows_integrations__provider_name__get";
+  getWorkflowNodeStats: "get_workflow_node_stats_workflows_node_stats_get";
+  getWorkflowRunSummary: "get_workflow_run_summary_workflows_run_summary_get";
+  inferSkillVariable: "infer_skill_variable_skills_infer_variable_post";
+  listDispositions: "list_dispositions_workflows_dispositions_get";
+  listInboxTags: "list_inbox_tags_workflows_inbox_tags_get";
+  listLinkedinSenders: "list_linkedin_senders_workflows_integrations_linkedin_senders_get";
+  listMcpServers: "list_mcp_servers_workflows_mcp_servers_get";
+  listRecentWorkflowRuns: "list_recent_workflow_runs_workflows__action_id__runs_recent_get";
+  listRoamGroups: "list_roam_groups_workflows_integrations_roam_groups_get";
+  listRoamUsers: "list_roam_users_workflows_integrations_roam_users_get";
+  listSkillCollections: "list_skill_collections_skills__action_id__collections_get";
+  listSkillTestCases: "list_skill_test_cases_skills__action_id__test_cases_get";
+  listSkillTestRuns: "list_skill_test_runs_skills__action_id__test_runs_get";
+  listSkillVersions: "list_skill_versions_skills__action_id__versions_get";
+  listSlackChannels: "list_slack_channels_workflows_integrations_slack_channels_get";
+  listSlackUsers: "list_slack_users_workflows_integrations_slack_users_get";
+  listWorkbenches: "list_workbenches_workflows_workbenches_get";
+  listWorkflowExecutions: "list_workflow_executions_workflows_executions_get";
+  listWorkflowIntegrations: "list_workflow_integrations_workflows_integrations_get";
+  listWorkflows: "list_workflows_workflows_get";
+  parseScriptParameters: "parse_script_parameters_skills_parse_script_parameters_post";
+  pauseExecution: "pause_execution_workflows_executions__execution_id__pause_post";
+  planInlineWorkflow: "plan_inline_workflow_workflows_plan_post";
+  planWorkflow: "plan_workflow_workflows__action_id__plan_post";
+  rejectExecution: "reject_execution_workflows_executions_reject_post";
+  requestExecutionChanges: "request_execution_changes_workflows_executions_request_changes_post";
+  resetTriggerCursor: "reset_trigger_cursor_workflows__action_id__trigger_reset_post";
+  resolveSkillTemplates: "resolve_skill_templates_skills_resolve_templates_post";
+  restartExecution: "restart_execution_workflows_executions__execution_id__restart_post";
+  restoreSkillVersion: "restore_skill_version_skills__action_id__versions__version_id__restore_post";
+  resumeExecution: "resume_execution_workflows_executions__execution_id__resume_post";
+  runSkillTestSuite: "run_skill_test_suite_skills__action_id__test_runs_post";
+  saveWorkflowIntegration: "save_workflow_integration_workflows_integrations__provider_name__post";
+  stopExecution: "stop_execution_workflows_executions__execution_id__stop_post";
+  testIntegrationCredential: "test_integration_credential_workflows_integrations__provider_name__test_post";
+  testSkillOnce: "test_skill_once_skills__action_id__test_post";
+  updateSkillTestCase: "update_skill_test_case_skills__action_id__test_cases__test_case_id__put";
+  updateWorkflow: "update_workflow_workflows__action_id__put";
+  validateWorkflow: "validate_workflow_workflows_validate_post";
+}
+
+/** Input and output of every `g8.api.workflows` operation, keyed by operationId. */
+export interface WorkflowsOperations {
+  /**
+   * POST /workflows/executions/approve
+   * Approve a run waiting on a human
+   * tier: external · scope: workflows:run
+   */
+  approve_execution_workflows_executions_approve_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ExecutionApproval;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /skills/{action_id}/collections
+   * Give a skill collections to retrieve from
+   * tier: write · scope: workflows:write
+   */
+  attach_skill_collections_skills__action_id__collections_post: {
+    input: {
+    path: {
+      /** Skill or workflow `action_id`. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_attach_skill_collections_skills__action_id__collections_post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /workflows/executions/bulk-restart
+   * Restart many workflow executions
+   * tier: external · scope: workflows:run
+   */
+  bulk_restart_executions_workflows_executions_bulk_restart_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /skills/{action_id}/test-cases
+   * Save a test case for a skill
+   * tier: write · scope: workflows:write
+   */
+  create_skill_test_case_skills__action_id__test_cases_post: {
+    input: {
+    path: {
+      /** Skill or workflow `action_id`. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_create_skill_test_case_skills__action_id__test_cases_post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /workflows/workbenches
+   * Create a workbench (so a workflow has somewhere to write)
+   * tier: external · scope: workflows:run
+   */
+  create_workbench_workflows_workbenches_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * POST /workflows
+   * Create a workflow
+   * tier: external · scope: workflows:run
+   */
+  create_workflow_workflows_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * DELETE /skills/{action_id}/test-cases/{test_case_id}
+   * Delete a test case
+   * tier: destructive · scope: workflows:delete
+   */
+  delete_skill_test_case_skills__action_id__test_cases__test_case_id__delete: {
+    input: {
+    path: {
+      /** Skill or workflow `action_id`. */
+      action_id: string;
+      /** Test case id. */
+      test_case_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * DELETE /workflows/{action_id}
+   * Delete a workflow
+   * tier: destructive · scope: workflows:delete
+   */
+  delete_workflow_workflows__action_id__delete: {
+    input: {
+    path: {
+      /** Workflow action_id. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * DELETE /workflows/integrations/{provider_name}
+   * Disconnect a workflow integration
+   * tier: destructive · scope: workflows:delete
+   */
+  delete_workflow_integration_workflows_integrations__provider_name__delete: {
+    input: {
+    path: {
+      /** Provider name. */
+      provider_name: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /workflows/forms/{form_id}/fields
+   * Discover form field names from recent submissions (resolver helper)
+   * tier: read · scope: workflows:read
+   */
+  describe_form_fields_workflows_forms__form_id__fields_get: {
+    input: {
+    path: {
+      /** HTML form id (form_tag_id) */
+      form_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * DELETE /skills/{action_id}/collections/{collection_id}
+   * Stop a skill retrieving from a collection
+   * tier: destructive · scope: workflows:delete
+   */
+  detach_skill_collection_skills__action_id__collections__collection_id__delete: {
+    input: {
+    path: {
+      /** Skill or workflow `action_id`. */
+      action_id: string;
+      /** Collection to unlink. */
+      collection_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /skills/{action_id}/versions/{version_id}/diff
+   * Diff two versions of a skill
+   * tier: read · scope: workflows:read
+   */
+  diff_skill_versions_skills__action_id__versions__version_id__diff_get: {
+    input: {
+    path: {
+      /** Skill or workflow `action_id`. */
+      action_id: string;
+      /** The version to diff. */
+      version_id: string;
+    };
+    query?: {
+      /** The version to compare with. Defaults to the one immediately before. */
+      against?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /workflows/{action_id}/execute
+   * Execute a workflow
+   * tier: external · scope: workflows:run
+   */
+  execute_workflow_workflows__action_id__execute_post: {
+    input: {
+    path: {
+      /** Workflow action_id. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: Record<string, unknown>;
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/executions/{execution_id}
+   * Get execution status / result
+   * tier: read · scope: workflows:read
+   */
+  get_execution_workflows_executions__execution_id__get: {
+    input: {
+    path: {
+      /** Execution UUID. */
+      execution_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/stats/executions
+   * Run health for the organisation or one skill
+   * tier: read · scope: workflows:read
+   */
+  get_execution_stats_workflows_stats_executions_get: {
+    input: {
+    query?: {
+      /** One skill's health; omit for the organisation. */
+      action_id?: string | null;
+      /** Window; omit for lifetime. */
+      days?: number | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /workflows/node-types/schema
+   * Catalog of all workflow node types and their config schemas
+   * tier: read · scope: workflows:read
+   */
+  get_node_types_schema_workflows_node_types_schema_get: {
+    input: {
+    query?: {
+      /** "slim" returns name+type per field; "full" includes Pydantic JSON schema. */
+      detail?: string;
+      /** If provided, return just one entry instead of the full catalog. */
+      node_type?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/stats/trigger-activity
+   * Whether workflow triggers are being evaluated
+   * tier: read · scope: workflows:read
+   */
+  get_trigger_activity_workflows_stats_trigger_activity_get: {
+    input: {
+    query: {
+      /** Comma-separated workflow ids (first 200 used). */
+      action_ids: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /workflows/{action_id}/trigger-status
+   * Trigger status (cursor + config) for a workflow
+   * tier: read · scope: workflows:read
+   */
+  get_trigger_status_workflows__action_id__trigger_status_get: {
+    input: {
+    path: {
+      /** Workflow action_id. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/{action_id}
+   * Get a workflow's full graph
+   * tier: read · scope: workflows:read
+   */
+  get_workflow_workflows__action_id__get: {
+    input: {
+    path: {
+      /** Workflow action_id. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/integrations/{provider_name}
+   * Get one workflow integration
+   * tier: read · scope: workflows:read
+   */
+  get_workflow_integration_workflows_integrations__provider_name__get: {
+    input: {
+    path: {
+      /** Provider name. */
+      provider_name: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /workflows/node-stats
+   * Per-node success and failure rates for a workflow
+   * tier: read · scope: workflows:read
+   */
+  get_workflow_node_stats_workflows_node_stats_get: {
+    input: {
+    query: {
+      /** The workflow to analyse. */
+      action_id: string;
+      /** Window, in days. */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /workflows/run-summary
+   * Has this workflow ever run?
+   * tier: read · scope: workflows:read
+   */
+  get_workflow_run_summary_workflows_run_summary_get: {
+    input: {
+    query?: {
+      /** Comma-separated workflow ids. Omit for every workflow in the org. */
+      action_ids?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /skills/infer-variable
+   * Infer one skill variable from a record
+   * tier: write · scope: workflows:write
+   */
+  infer_skill_variable_skills_infer_variable_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_infer_skill_variable_skills_infer_variable_post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /workflows/dispositions
+   * List valid call disposition values (system + this org's custom)
+   * tier: read · scope: workflows:read
+   */
+  list_dispositions_workflows_dispositions_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/inbox-tags
+   * List AI Inbox tags for the org (resolver helper)
+   * tier: read · scope: workflows:read
+   */
+  list_inbox_tags_workflows_inbox_tags_get: {
+    input: {
+    query?: {
+      /** Return only tags an AI agent is allowed to apply automatically. */
+      ai_applicable_only?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/integrations/linkedin/senders
+   * List LinkedIn sender accounts for the org (resolver helper)
+   * tier: read · scope: workflows:read
+   */
+  list_linkedin_senders_workflows_integrations_linkedin_senders_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/mcp-servers
+   * List MCP servers connected to the org (resolver helper)
+   * tier: read · scope: workflows:read
+   */
+  list_mcp_servers_workflows_mcp_servers_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/{action_id}/runs/recent
+   * Recent runs of one workflow
+   * tier: read · scope: workflows:read
+   */
+  list_recent_workflow_runs_workflows__action_id__runs_recent_get: {
+    input: {
+    path: {
+      /** Skill or workflow `action_id`. */
+      action_id: string;
+    };
+    query?: {
+      /** Rows to return, newest first. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /workflows/integrations/roam/groups
+   * List Roam groups connected to the org (resolver helper)
+   * tier: read · scope: workflows:read
+   */
+  list_roam_groups_workflows_integrations_roam_groups_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/integrations/roam/users
+   * List Roam users connected to the org (resolver helper)
+   * tier: read · scope: workflows:read
+   */
+  list_roam_users_workflows_integrations_roam_users_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /skills/{action_id}/collections
+   * Collections a skill retrieves from
+   * tier: read · scope: workflows:read
+   */
+  list_skill_collections_skills__action_id__collections_get: {
+    input: {
+    path: {
+      /** Skill or workflow `action_id`. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /skills/{action_id}/test-cases
+   * List a skill's saved test cases
+   * tier: read · scope: workflows:read
+   */
+  list_skill_test_cases_skills__action_id__test_cases_get: {
+    input: {
+    path: {
+      /** Skill or workflow `action_id`. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /skills/{action_id}/test-runs
+   * A skill's test-run history
+   * tier: read · scope: workflows:read
+   */
+  list_skill_test_runs_skills__action_id__test_runs_get: {
+    input: {
+    path: {
+      /** Skill or workflow `action_id`. */
+      action_id: string;
+    };
+    query?: {
+      /** Only runs of this case. */
+      test_case_id?: string | null;
+      /** Rows to return, newest first. */
+      limit?: number;
+      /** True adds the stored output previews. They can be large. */
+      include_output?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /skills/{action_id}/versions
+   * A skill's versions
+   * tier: read · scope: workflows:read
+   */
+  list_skill_versions_skills__action_id__versions_get: {
+    input: {
+    path: {
+      /** Skill (action) id. */
+      action_id: string;
+    };
+    query?: {
+      /** Newest first. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * GET /workflows/integrations/slack/channels
+   * List Slack channels for the org (resolver helper)
+   * tier: read · scope: workflows:read
+   */
+  list_slack_channels_workflows_integrations_slack_channels_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/integrations/slack/users
+   * List Slack users for the org (resolver helper)
+   * tier: read · scope: workflows:read
+   */
+  list_slack_users_workflows_integrations_slack_users_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/workbenches
+   * List workbenches for the org (resolver helper)
+   * tier: read · scope: workflows:read
+   */
+  list_workbenches_workflows_workbenches_get: {
+    input: {
+    query?: {
+      /** Page size. */
+      limit?: number;
+      /** 1-based page number. */
+      page?: number;
+      /** Case-insensitive name filter. */
+      filter_name?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/executions
+   * List workflow executions for the caller's org (recover a lost execution_id)
+   * tier: read · scope: workflows:read
+   */
+  list_workflow_executions_workflows_executions_get: {
+    input: {
+    query?: {
+      /** Filter to a single workflow's executions. */
+      action_id?: string | null;
+      /** Filter by execution status (equality match — one status per call). The backend writes seven values: pending|running|completed|failed|paused|pending_approval|stopped. The four terminal-or-early states are pending, running, completed, failed; paused and pending_approval are resumable, stopped is terminal. */
+      status_filter?: string | null;
+      /** Filter by the identity that started the run (user email, agent id, 'api', ...). */
+      triggered_by?: string | null;
+      /** Page size (1..200). */
+      limit?: number;
+      /** Rows to skip for pagination. */
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * GET /workflows/integrations
+   * List connected workflow integrations
+   * tier: read · scope: workflows:read
+   */
+  list_workflow_integrations_workflows_integrations_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoiceListPayload_;
+  };
+  /**
+   * GET /workflows
+   * List workflows for the caller's org
+   * tier: read · scope: workflows:read
+   */
+  list_workflows_workflows_get: {
+    input: {
+    query?: {
+      /** Filter by enabled flag. */
+      enabled?: boolean | null;
+      /** Filter by category. */
+      category?: string | null;
+      /** Templates only when true. */
+      is_template?: boolean | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * POST /skills/parse-script-parameters
+   * Detect a script's parameters from its code
+   * tier: write · scope: workflows:write
+   */
+  parse_script_parameters_skills_parse_script_parameters_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_parse_script_parameters_skills_parse_script_parameters_post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /workflows/executions/{execution_id}/pause
+   * Pause a running execution (tenant-checked)
+   * tier: external · scope: workflows:run
+   */
+  pause_execution_workflows_executions__execution_id__pause_post: {
+    input: {
+    path: {
+      /** Execution UUID. */
+      execution_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: Record<string, unknown>;
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * POST /workflows/plan
+   * Preview a normalized execution plan for an inline workflow graph
+   * tier: read · scope: workflows:read
+   */
+  plan_inline_workflow_workflows_plan_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * POST /workflows/{action_id}/plan
+   * Preview a normalized execution plan for a saved workflow
+   * tier: read · scope: workflows:read
+   */
+  plan_workflow_workflows__action_id__plan_post: {
+    input: {
+    path: {
+      /** Workflow action_id. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: Record<string, unknown>;
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * POST /workflows/executions/reject
+   * Reject a run waiting on a human
+   * tier: write · scope: workflows:write
+   */
+  reject_execution_workflows_executions_reject_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ExecutionRejection;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /workflows/executions/request-changes
+   * Answer a human-approval step with changes requested
+   * tier: external · scope: workflows:run
+   */
+  request_execution_changes_workflows_executions_request_changes_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Body_request_execution_changes_workflows_executions_request_changes_post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /workflows/{action_id}/trigger-reset
+   * Reset the trigger cursor to now
+   * tier: external · scope: workflows:run
+   */
+  reset_trigger_cursor_workflows__action_id__trigger_reset_post: {
+    input: {
+    path: {
+      /** Workflow action_id. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * POST /skills/resolve-templates
+   * Resolve skill template names to ids
+   * tier: write · scope: workflows:write
+   */
+  resolve_skill_templates_skills_resolve_templates_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /workflows/executions/{execution_id}/restart
+   * Restart one workflow execution
+   * tier: external · scope: workflows:run
+   */
+  restart_execution_workflows_executions__execution_id__restart_post: {
+    input: {
+    path: {
+      /** Execution id. */
+      execution_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /skills/{action_id}/versions/{version_id}/restore
+   * Restore an earlier version of a skill
+   * tier: write · scope: workflows:write
+   */
+  restore_skill_version_skills__action_id__versions__version_id__restore_post: {
+    input: {
+    path: {
+      /** Skill (action) id. */
+      action_id: string;
+      /** The version to bring back. */
+      version_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /workflows/executions/{execution_id}/resume
+   * Resume a paused execution (tenant-checked)
+   * tier: external · scope: workflows:run
+   */
+  resume_execution_workflows_executions__execution_id__resume_post: {
+    input: {
+    path: {
+      /** Execution UUID. */
+      execution_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: Record<string, unknown>;
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * POST /skills/{action_id}/test-runs
+   * Run every saved test case against a skill
+   * tier: external · scope: workflows:run
+   */
+  run_skill_test_suite_skills__action_id__test_runs_post: {
+    input: {
+    path: {
+      /** Skill or workflow `action_id`. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /workflows/integrations/{provider_name}
+   * Connect or update a workflow integration
+   * tier: write · scope: workflows:write
+   */
+  save_workflow_integration_workflows_integrations__provider_name__post: {
+    input: {
+    path: {
+      /** Provider name. */
+      provider_name: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: Body_save_workflow_integration_workflows_integrations__provider_name__post;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /workflows/executions/{execution_id}/stop
+   * Permanently stop an execution (tenant-checked)
+   * tier: external · scope: workflows:run
+   */
+  stop_execution_workflows_executions__execution_id__stop_post: {
+    input: {
+    path: {
+      /** Execution UUID. */
+      execution_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: Record<string, unknown>;
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * POST /workflows/integrations/{provider_name}/test
+   * Try a Roam or Slack token
+   * tier: external · scope: workflows:run
+   */
+  test_integration_credential_workflows_integrations__provider_name__test_post: {
+    input: {
+    path: {
+      /** roam or slack. */
+      provider_name: "roam" | "slack";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: IntegrationCredentialTest;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * POST /skills/{action_id}/test
+   * Dry-run a skill once
+   * tier: write · scope: workflows:write
+   */
+  test_skill_once_skills__action_id__test_post: {
+    input: {
+    path: {
+      /** Skill (action) id. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SkillTestRun;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /skills/{action_id}/test-cases/{test_case_id}
+   * Update a test case
+   * tier: write · scope: workflows:write
+   */
+  update_skill_test_case_skills__action_id__test_cases__test_case_id__put: {
+    input: {
+    path: {
+      /** Skill or workflow `action_id`. */
+      action_id: string;
+      /** Test case id. */
+      test_case_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: ApiResponse_VoicePayload_;
+  };
+  /**
+   * PUT /workflows/{action_id}
+   * Update a workflow's graph
+   * tier: external · scope: workflows:run
+   */
+  update_workflow_workflows__action_id__put: {
+    input: {
+    path: {
+      /** Workflow action_id. */
+      action_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: Record<string, unknown>;
+  };
+  /**
+   * POST /workflows/validate
+   * Validate a workflow graph (structural + reference resolution)
+   * tier: external · scope: workflows:run
+   */
+  validate_workflow_workflows_validate_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: Record<string, unknown>;
+  };
+    output: Record<string, unknown>;
+  };
+}
+
+// 15 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_VoiceListPayload_ {
+  data: VoiceListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_VoicePayload_ {
+  data: VoicePayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface Body_attach_skill_collections_skills__action_id__collections_post {
+  /** Collections to attach. Additive - existing links survive. */
+  collection_ids: Array<number>;
+}
+
+export interface Body_create_skill_test_case_skills__action_id__test_cases_post {
+  /** Extra configuration for the assertion. */
+  assertion_config?: Record<string, unknown> | null;
+  /** "exact", "contains" or "llm_judge". `llm_judge` is skipped by dry runs. */
+  assertion_type?: string;
+  /** What the assertion compares against. */
+  expected_output?: unknown | null;
+  /** The fixture, same shape as an execution's input. */
+  input_data: Record<string, unknown>;
+  /** Human label. */
+  name: string;
+}
+
+export interface Body_infer_skill_variable_skills_infer_variable_post {
+  /** The contact or company record, same shape as an execution input. */
+  entity_data: Record<string, unknown>;
+  /** "contact" or "company". */
+  entity_data_type: string;
+  /** Record id. Used for cache keying only. */
+  entity_id?: string | null;
+}
+
+export interface Body_parse_script_parameters_skills_parse_script_parameters_post {
+  /** The script source. */
+  code: string;
+  /** "python", "javascript" or "typescript". */
+  language?: string;
+}
+
+export interface Body_request_execution_changes_workflows_executions_request_changes_post {
+  /** REQUIRED and non-blank. It is the value the revise branch reads as `${<human_node>.feedback}` - an empty one sends the workflow down the revise path with nothing to revise against. */
+  feedback: string;
+  /** Who is asking for changes. */
+  requested_by: string;
+  /** The workflow the run belongs to. */
+  workflow_id: string;
+}
+
+export interface Body_save_workflow_integration_workflows_integrations__provider_name__post {
+  /** The provider credential. WRITE-ONLY: no route on this API returns it. Omitting it on an update leaves the stored key in place. */
+  api_key?: string | null;
+  /** Provider-specific settings. */
+  configuration?: Record<string, unknown> | null;
+}
+
+/** voice `ApprovalRequest`, without `org_id`. */
+export interface ExecutionApproval {
+  /** Who approved; voice checks they may. */
+  approved_by: string;
+  notes?: string | null;
+  /** The paused run's workflow id. */
+  workflow_id: string;
+}
+
+/** voice `RejectionRequest`, without `org_id`. */
+export interface ExecutionRejection {
+  reason?: string | null;
+  /** Who rejected; voice checks they may. */
+  rejected_by: string;
+  /** The paused run's workflow id. */
+  workflow_id: string;
+}
+
+/** voice `WorkflowIntegrationTestRequest`. */
+export interface IntegrationCredentialTest {
+  /** The token to try. Not stored. */
+  api_key: string;
+}
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}
+
+/** voice `SkillTestRunRequest`: one dry run, from a saved case OR ad-hoc inputs. */
+export interface SkillTestRun {
+  /** Ad-hoc only. */
+  assertion_config?: Record<string, unknown> | null;
+  /** Ad-hoc only. */
+  assertion_type?: ("exact" | "contains" | "llm_judge") | null;
+  /** Ad-hoc only: value to assert against. */
+  expected_output?: unknown | null;
+  /** Ad-hoc inputs (no saved case). */
+  input_data?: Record<string, unknown> | null;
+  /** Run this saved case. */
+  test_case_id?: string | null;
+  /** Attribution for the run history. */
+  triggered_by?: string | null;
+}
+
+/**
+ * A LIST result from voice, normalised so `items` is always present.
+ *
+ * Voice is inconsistent about whether a list comes back bare or under a named
+ * key (`collections`, `files`, `routes`, `chats`, ...). Both are preserved:
+ * the original key is kept for anyone reading voice's docs, and `items`
+ * always holds the same rows so a client can page one way.
+ */
+export interface VoiceListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/**
+ * One voice object - a collection, an agent, a route, a chat.
+ *
+ * Open-shaped: voice adds fields to these bodies on its own release cadence
+ * and a dropped-or-added key must not be a 500 in this service.
+ */
+export type VoicePayload = Record<string, unknown>;