feat(mothership): inspect configured workflow tool bindings

Author: Sg312

apps/sim/lib/mothership/agent-cli/engines/index.ts

@@ -8,6 +8,7 @@ import { logsQueryCommand } from '@/lib/mothership/agent-cli/engines/query'
 import { universalGrepCommand } from '@/lib/mothership/agent-cli/engines/universal-grep'
 import { workflowApiCommand } from '@/lib/mothership/agent-cli/engines/workflow-api'
 import { workflowInputsCommand } from '@/lib/mothership/agent-cli/engines/workflow-inputs'
+import { workflowToolsCommand } from '@/lib/mothership/agent-cli/engines/workflow-tools'
 import {
   type AgentCliEngine,
   type AgentCliFlags,
@@ -32,6 +33,7 @@ export const AUGMENTATION_ENGINES: Readonly<Record<string, AgentCliEngine>> = {
   'workflows lint': workflowLintCommand,
   'workflows api': workflowApiCommand,
   'workflows inputs': workflowInputsCommand,
+  'workflows tools': workflowToolsCommand,
 }
 
 /** Runs one engine by the worker's name; an engine that throws yields a failed result, never a throw. */

apps/sim/lib/mothership/agent-cli/engines/workflow-tools.ts

@@ -0,0 +1,35 @@
+import { enginePrincipal } from '@/lib/mothership/agent-cli/engine-principal'
+import { type AgentCliEngine, agentCliFail, agentCliOk } from '@/lib/mothership/agent-cli/types'
+import { messageForCopilotApplicationError } from '@/lib/mothership/application/error'
+import { inspectWorkflowTools } from '@/lib/workflows/application/inspect-workflow-tools'
+
+export const workflowToolsCommand: AgentCliEngine = {
+  async execute([workflowId], runtime, flags) {
+    if (!workflowId || typeof flags.block !== 'string' || !flags.block.trim())
+      return agentCliFail('Usage: sim workflows tools <workflowId> --block <blockId>')
+    const principal = enginePrincipal(runtime, inspectWorkflowTools)
+    if (!principal) return agentCliFail('Workspace authentication is unavailable.')
+    try {
+      const report = await inspectWorkflowTools.execute({
+        principal,
+        input: {
+          workflowId,
+          blockId: flags.block,
+          assertedWorkspaceId: runtime.workspaceId,
+          ...(typeof flags.query === 'string' ? { query: flags.query } : {}),
+          ...(typeof flags.limit === 'string' ? { limit: Number(flags.limit) } : {}),
+          signal: runtime.signal,
+        },
+      })
+      return agentCliOk(JSON.stringify(report, null, 2))
+    } catch (error) {
+      if (runtime.signal?.aborted) return agentCliFail('Tool inspection was cancelled.')
+      return agentCliFail(
+        messageForCopilotApplicationError(
+          error,
+          'Tool inspection could not complete. Retry before relying on this report.'
+        )
+      )
+    }
+  },
+}

apps/sim/lib/mothership/agent-cli/tool-binding-hints.ts

@@ -19,6 +19,7 @@ export function withToolBindingHints(detail: MothershipBlockDetail): MothershipB
             toolBinding: {
               selectionMode: isMothership ? 'additive' : 'explicit',
               discovery: [
+                'workflows tools <workflowId> --block <blockId>',
                 ...(!isMothership
                   ? [
                       'blocks get <type> --operation <operation>',

apps/sim/lib/mothership/tools/cli-tool-display.ts

@@ -243,6 +243,7 @@ export const CLI_TOOL_TITLES: Record<string, string> = {
   cli_workflows_deps: 'Tracing workflow inputs',
   cli_workflows_api: 'Reading workflow API details',
   cli_workflows_lint: 'Validating workflow',
+  cli_workflows_tools: 'Inspecting workflow tools',
   // Non-CLI copilot worker tools
   cli_help: 'Checking CLI reference',
   sim_cli: 'Running CLI command',