sandbox connected and streaming

gateway/src/tools/platform/research-agent.tool.ts

@@ -0,0 +1,53 @@
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { z } from 'zod';
+import type { FastifyBaseLogger } from 'fastify';
+import type { ResearchSubagent } from '../../harness/subagents/research/index.js';
+import type { SubagentContext } from '../../harness/subagents/base-subagent.js';
+
+export interface ResearchAgentToolConfig {
+  researchSubagent: ResearchSubagent;
+  context: SubagentContext;
+  logger: FastifyBaseLogger;
+}
+
+/**
+ * Creates a LangChain tool that delegates to the research subagent.
+ * This is the standard LangChain pattern for exposing a subagent as a tool
+ * to a parent agent.
+ */
+export function createResearchAgentTool(config: ResearchAgentToolConfig): DynamicStructuredTool {
+  const { researchSubagent, context, logger } = config;
+
+  return new DynamicStructuredTool({
+    name: 'research',
+    description: `Delegate to the research subagent for data analysis, charting, statistics, and Python script execution.
+
+Use this tool for:
+- Plotting charts with technical indicators (EMA, RSI, MACD, Bollinger Bands, etc.)
+- Statistical analysis of price data
+- Custom research scripts using the DataAPI and ChartingAPI
+- Any task requiring code execution or matplotlib charts
+
+The research subagent will write and execute Python scripts, capture output and charts, and return results.`,
+    schema: z.object({
+      instruction: z.string().describe('The research task or analysis to perform. Be specific about what data, indicators, timeframes, and output you want.'),
+    }),
+    func: async ({ instruction }: { instruction: string }): Promise<string> => {
+      logger.info({ instruction: instruction.substring(0, 100) }, 'Delegating to research subagent');
+
+      try {
+        const result = await researchSubagent.executeWithImages(context, instruction);
+
+        // Return in the format that AgentHarness.processToolResult() knows how to handle
+        // (extracts images and passes them to channelAdapter)
+        return JSON.stringify({
+          text: result.text,
+          images: result.images,
+        });
+      } catch (error) {
+        logger.error({ error, errorMessage: (error as Error)?.message }, 'Research subagent failed');
+        throw error;
+      }
+    },
+  });
+}