fix(superagent): fix superagent tools and checkpoints

Author: Sg312

apps/sim/lib/copilot/chat/payload.ts

@@ -57,6 +57,14 @@ export interface ToolSchema {
   params?: Record<string, unknown>
   /** Canonical integration service/folder (e.g. "slack"), for server-side grouping. */
   service?: string
+  /**
+   * Operation stem within the service — the VFS doc filename without `.json`
+   * (e.g. "list_users" for id "slack_list_users"). Stamped so the server can
+   * hand agents the exact `components/integrations/{service}/{operation}.json`
+   * path instead of making them derive it from the id (deriving is how the id
+   * gets guessed as the filename).
+   */
+  operation?: string
   oauth?: { required: boolean; provider: string }
 }
 
@@ -201,7 +209,7 @@ async function buildIntegrationToolSchemasUncached(
     }
 
     const exposedTools = filterExposedIntegrationTools(getExposedIntegrationTools(), vis)
-    for (const { toolId, config: toolConfig, service } of exposedTools) {
+    for (const { toolId, config: toolConfig, service, operation } of exposedTools) {
       try {
         if (allowedIntegrations && toolIdToBlockType) {
           const owningBlock = toolIdToBlockType.get(stripVersionSuffix(toolId))
@@ -216,6 +224,7 @@ async function buildIntegrationToolSchemasUncached(
         integrationTools.push({
           name: toolId,
           service,
+          operation,
           description: getCopilotToolDescription(toolConfig, {
             isHosted,
             fallbackName: toolId,

apps/sim/lib/copilot/tools/handlers/integration-tools.ts

@@ -34,10 +34,11 @@ export async function executeListIntegrationTools(
     success: true,
     output: {
       integration: service,
-      note: 'Call load_integration_tool({tool_ids: ["<id>"]}) with the exact id before invoking an operation.',
+      note: 'Read the entry\'s "path" verbatim for exact params, then load_integration_tool({tool_ids: ["<id>"]}) and call the tool by that exact id.',
       tools: matches.map((tool) => ({
         id: tool.toolId,
         operation: tool.operation,
+        path: `components/integrations/${tool.service}/${tool.operation}.json`,
         name: tool.config.name,
         description: tool.config.description,
       })),