@truefoundry/trueforge-core 0.0.0 → 0.1.0

package/dist/core/capabilities/builtins/ContextCompaction.mjs

@@ -0,0 +1,208 @@
+// src/core/capabilities/builtins/ContextCompaction.ts
+import { EventType, newEventId } from "../../events/schema.mjs";
+import { internalSystemMessage, isInternalSystemMessage, isLLMContextMessage } from "../../runtime/contextUtils.mjs";
+var DEFAULT_CONTEXT_COMPACTION_THRESHOLD_TOKENS = 50 * 1e3;
+var PROMPT_TOKENS = 931;
+var PROMPT = `
+Your task is to create a detailed summary of the conversation so far, paying close attention to the user's explicit requests and your previous actions.
+This summary should be thorough in capturing technical details, code patterns, and architectural decisions that would be essential for continuing development work without losing context.
+
+Before providing your final summary, wrap your analysis in <analysis> tags to organize your thoughts and ensure you've covered all necessary points. In your analysis process:
+
+1. Chronologically analyze each message and section of the conversation. For each section thoroughly identify:
+   - The user's explicit requests and intents
+   - Your approach to addressing the user's requests
+   - Key decisions, technical concepts and code patterns
+   - Specific details like:
+     - file names
+     - full code snippets
+     - function signatures
+     - file edits
+  - Errors that you ran into and how you fixed them
+  - Pay special attention to specific user feedback that you received, especially if the user told you to do something differently.
+2. Double-check for technical accuracy and completeness, addressing each required element thoroughly.
+
+Your summary should include the following sections:
+
+1. Primary Request and Intent: Capture all of the user's explicit requests and intents in detail
+2. Key Technical Concepts: List all important technical concepts, technologies, and frameworks discussed.
+3. Files and Code Sections: Enumerate specific files and code sections examined, modified, or created. Pay special attention to the most recent messages and include full code snippets where applicable and include a summary of why this file read or edit is important.
+4. Errors and fixes: List all errors that you ran into, and how you fixed them. Pay special attention to specific user feedback that you received, especially if the user told you to do something differently.
+5. Problem Solving: Document problems solved and any ongoing troubleshooting efforts.
+6. All user messages: List ALL user messages that are not tool results. These are critical for understanding the users' feedback and changing intent.
+6. Pending Tasks: Outline any pending tasks that you have explicitly been asked to work on.
+7. Current Work: Describe in detail precisely what was being worked on immediately before this summary request, paying special attention to the most recent messages from both user and assistant. Include file names and code snippets where applicable.
+8. Optional Next Step: List the next step that you will take that is related to the most recent work you were doing. IMPORTANT: ensure that this step is DIRECTLY in line with the user's most recent explicit requests, and the task you were working on immediately before this summary request. If your last task was concluded, then only list next steps if they are explicitly in line with the users request. Do not start on tangential requests or really old requests that were already completed without confirming with the user first.
+                       If there is a next step, include direct quotes from the most recent conversation showing exactly what task you were working on and where you left off. This should be verbatim to ensure there's no drift in task interpretation.
+
+Here's an example of how your output should be structured:
+
+<example>
+<analysis>
+[Your thought process, ensuring all points are covered thoroughly and accurately]
+</analysis>
+
+<summary>
+1. Primary Request and Intent:
+   [Detailed description]
+
+2. Key Technical Concepts:
+   - [Concept 1]
+   - [Concept 2]
+   - [...]
+
+
+3. Errors and fixes:
+    - [Detailed description of error 1]:
+      - [How you fixed the error]
+      - [User feedback on the error if any]
+    - [...]
+
+4. Problem Solving:
+   [Description of solved problems and ongoing troubleshooting]
+
+5. All user messages: 
+    - [Detailed non tool use user message]
+    - [...]
+
+6. Pending Tasks:
+   - [Task 1]
+   - [Task 2]
+   - [...]
+
+7. Current Work:
+   [Precise description of current work]
+
+8. Optional Next Step:
+   [Optional Next step to take]
+
+</summary>
+</example>
+
+Please provide your summary based on the conversation so far, following this structure and ensuring precision and thoroughness in your response. 
+
+There may be additional summarization instructions provided in the included context. If so, remember to follow these instructions when creating the above summary. Examples of instructions include:
+<example>
+## Compact Instructions
+When summarizing the conversation focus on typescript code changes and also remember the mistakes you made and how you fixed them.
+</example>
+
+<example>
+# Summary instructions
+When you are using compact - please focus on test output and code changes. Include file reads verbatim.
+</example>
+`;
+var CONTINUATION_MESSAGE = internalSystemMessage(
+  "The above is the summarised context of the work so far. The Agent must not repeat or re-run any work that was already completed. If results were already obtained, the Agent should present them directly."
+);
+Object.freeze(CONTINUATION_MESSAGE);
+var CONTINUATION_MESSAGE_TOKENS = 42;
+function formatAssistantContent(content) {
+  if (typeof content === "string") {
+    return content;
+  }
+  if (!content) {
+    return "";
+  }
+  return content.map((part) => part.type === "text" ? part.text : part.refusal).join("\n");
+}
+function createSummarizationCandidate(context) {
+  let candidate = "";
+  let index = -1;
+  for (const m of context) {
+    index += 1;
+    if (isInternalSystemMessage(m)) {
+      continue;
+    }
+    if (!isLLMContextMessage(m)) {
+      continue;
+    }
+    switch (m.role) {
+      case "user":
+        if (typeof m.content === "string") {
+          candidate += `<${String(index)}><user>:` + m.content;
+        } else {
+          const parts = [];
+          for (const p of m.content) {
+            if (p.type === "text") {
+              parts.push(p.text);
+            } else {
+              parts.push(`[user attached a ${p.type} here, no longer available after summarization]`);
+            }
+          }
+          candidate += `<${String(index)}><user>:` + parts.join("\n");
+        }
+        break;
+      case "tool":
+        candidate += `<${String(index)}><tool-response id=${m.tool_call_id}>:` + m.content;
+        break;
+      case "assistant":
+        for (const block of m.thinking_blocks ?? []) {
+          if (block.type === "thinking") {
+            candidate += `<${String(index)}><assistant-thinking>:` + block.thinking;
+          }
+        }
+        candidate += `<${String(index)}><assistant>:` + formatAssistantContent(m.content);
+        for (const t of m.tool_calls ?? []) {
+          candidate += `<tool-call id=${t.id} name=${t.function.name}>:` + t.function.arguments;
+        }
+    }
+  }
+  return candidate;
+}
+var ContextCompaction = class {
+  modelClient;
+  compactionThresholdTokens;
+  constructor(input) {
+    this.modelClient = input.modelClient;
+    this.compactionThresholdTokens = input.compactionThresholdTokens;
+  }
+  async *processPreLLM(execution) {
+    const contextTokens = execution.currentContextUsage.prompt_tokens + execution.currentContextUsage.completion_tokens;
+    if (contextTokens + PROMPT_TOKENS < this.compactionThresholdTokens) {
+      return;
+    }
+    const body = {
+      messages: [
+        { role: "user", content: createSummarizationCandidate(execution.context) },
+        { role: "user", content: PROMPT }
+      ],
+      stream: false
+    };
+    const response = await this.modelClient.createNonStream(body);
+    const context = [{ role: "assistant", content: response.output.content }, CONTINUATION_MESSAGE];
+    yield {
+      type: EventType.AGENT_CONTEXT_OVERWRITE,
+      id: newEventId(),
+      created_at: (/* @__PURE__ */ new Date()).toISOString(),
+      reason: "compaction",
+      context,
+      current_context_usage: {
+        // NOTE(agent): This is not really correct.
+        // This is not taking into account that the original request had
+        // tool definition in them.
+        // This will get refreshed in the next LLM call.
+        prompt_tokens: response.usage.input_tokens + CONTINUATION_MESSAGE_TOKENS,
+        completion_tokens: 0
+      },
+      usage: response.usage
+    };
+  }
+};
+function contextCompaction(options) {
+  const threshold = options.compactionThresholdTokens ?? options.settings?.compactionThresholdTokens ?? DEFAULT_CONTEXT_COMPACTION_THRESHOLD_TOKENS;
+  return {
+    preLLMProcessors: [
+      new ContextCompaction({
+        modelClient: options.definition.modelClient,
+        compactionThresholdTokens: threshold
+      })
+    ]
+  };
+}
+export {
+  ContextCompaction,
+  DEFAULT_CONTEXT_COMPACTION_THRESHOLD_TOKENS,
+  contextCompaction
+};
+//# sourceMappingURL=ContextCompaction.mjs.map

package/dist/core/capabilities/builtins/ContextCompaction.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/capabilities/builtins/ContextCompaction.ts"],"sourcesContent":["import { EventType, newEventId } from '../../events/schema';\nimport type { ILLM, LLMCreateParams } from '../../llm/ILLM';\nimport type { AgentDefinition } from '../../runtime/AgentDefinition';\nimport type { ContextMessage } from '../../runtime/AgentThread.types';\nimport { internalSystemMessage, isInternalSystemMessage, isLLMContextMessage } from '../../runtime/contextUtils';\nimport type { AgentCapability } from '../AgentCapability';\nimport type {\n  AgentContextProcessorOutput,\n  AgentThreadExecutionContext,\n  PreLLMAgentContextProcessor,\n} from '../AgentContextProcessor';\n\nexport const DEFAULT_CONTEXT_COMPACTION_THRESHOLD_TOKENS = 50 * 1000;\n\n// https://platform.openai.com/tokenizer\nconst PROMPT_TOKENS = 931;\nconst PROMPT = `\nYour task is to create a detailed summary of the conversation so far, paying close attention to the user's explicit requests and your previous actions.\nThis summary should be thorough in capturing technical details, code patterns, and architectural decisions that would be essential for continuing development work without losing context.\n\nBefore providing your final summary, wrap your analysis in <analysis> tags to organize your thoughts and ensure you've covered all necessary points. In your analysis process:\n\n1. Chronologically analyze each message and section of the conversation. For each section thoroughly identify:\n   - The user's explicit requests and intents\n   - Your approach to addressing the user's requests\n   - Key decisions, technical concepts and code patterns\n   - Specific details like:\n     - file names\n     - full code snippets\n     - function signatures\n     - file edits\n  - Errors that you ran into and how you fixed them\n  - Pay special attention to specific user feedback that you received, especially if the user told you to do something differently.\n2. Double-check for technical accuracy and completeness, addressing each required element thoroughly.\n\nYour summary should include the following sections:\n\n1. Primary Request and Intent: Capture all of the user's explicit requests and intents in detail\n2. Key Technical Concepts: List all important technical concepts, technologies, and frameworks discussed.\n3. Files and Code Sections: Enumerate specific files and code sections examined, modified, or created. Pay special attention to the most recent messages and include full code snippets where applicable and include a summary of why this file read or edit is important.\n4. Errors and fixes: List all errors that you ran into, and how you fixed them. Pay special attention to specific user feedback that you received, especially if the user told you to do something differently.\n5. Problem Solving: Document problems solved and any ongoing troubleshooting efforts.\n6. All user messages: List ALL user messages that are not tool results. These are critical for understanding the users' feedback and changing intent.\n6. Pending Tasks: Outline any pending tasks that you have explicitly been asked to work on.\n7. Current Work: Describe in detail precisely what was being worked on immediately before this summary request, paying special attention to the most recent messages from both user and assistant. Include file names and code snippets where applicable.\n8. Optional Next Step: List the next step that you will take that is related to the most recent work you were doing. IMPORTANT: ensure that this step is DIRECTLY in line with the user's most recent explicit requests, and the task you were working on immediately before this summary request. If your last task was concluded, then only list next steps if they are explicitly in line with the users request. Do not start on tangential requests or really old requests that were already completed without confirming with the user first.\n                       If there is a next step, include direct quotes from the most recent conversation showing exactly what task you were working on and where you left off. This should be verbatim to ensure there's no drift in task interpretation.\n\nHere's an example of how your output should be structured:\n\n<example>\n<analysis>\n[Your thought process, ensuring all points are covered thoroughly and accurately]\n</analysis>\n\n<summary>\n1. Primary Request and Intent:\n   [Detailed description]\n\n2. Key Technical Concepts:\n   - [Concept 1]\n   - [Concept 2]\n   - [...]\n\n\n3. Errors and fixes:\n    - [Detailed description of error 1]:\n      - [How you fixed the error]\n      - [User feedback on the error if any]\n    - [...]\n\n4. Problem Solving:\n   [Description of solved problems and ongoing troubleshooting]\n\n5. All user messages: \n    - [Detailed non tool use user message]\n    - [...]\n\n6. Pending Tasks:\n   - [Task 1]\n   - [Task 2]\n   - [...]\n\n7. Current Work:\n   [Precise description of current work]\n\n8. Optional Next Step:\n   [Optional Next step to take]\n\n</summary>\n</example>\n\nPlease provide your summary based on the conversation so far, following this structure and ensuring precision and thoroughness in your response. \n\nThere may be additional summarization instructions provided in the included context. If so, remember to follow these instructions when creating the above summary. Examples of instructions include:\n<example>\n## Compact Instructions\nWhen summarizing the conversation focus on typescript code changes and also remember the mistakes you made and how you fixed them.\n</example>\n\n<example>\n# Summary instructions\nWhen you are using compact - please focus on test output and code changes. Include file reads verbatim.\n</example>\n`;\n\nconst CONTINUATION_MESSAGE = internalSystemMessage(\n  'The above is the summarised context of the work so far. The Agent must not repeat or re-run any work that was already completed. If results were already obtained, the Agent should present them directly.',\n);\nObject.freeze(CONTINUATION_MESSAGE);\n// https://platform.openai.com/tokenizer\nconst CONTINUATION_MESSAGE_TOKENS = 42;\n\nfunction formatAssistantContent(\n  content: string | ({ type: 'text'; text: string } | { type: 'refusal'; refusal: string })[] | null | undefined,\n): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!content) {\n    return '';\n  }\n  return content.map(part => (part.type === 'text' ? part.text : part.refusal)).join('\\n');\n}\n\nfunction createSummarizationCandidate(context: ContextMessage[]) {\n  let candidate = '';\n  let index = -1;\n  for (const m of context) {\n    index += 1;\n    if (isInternalSystemMessage(m)) {\n      continue;\n    }\n    if (!isLLMContextMessage(m)) {\n      continue;\n    }\n    switch (m.role) {\n      case 'user':\n        if (typeof m.content === 'string') {\n          candidate += `<${String(index)}><user>:` + m.content;\n        } else {\n          const parts: string[] = [];\n          for (const p of m.content) {\n            if (p.type === 'text') {\n              parts.push(p.text);\n            } else {\n              parts.push(`[user attached a ${p.type} here, no longer available after summarization]`);\n            }\n          }\n          candidate += `<${String(index)}><user>:` + parts.join('\\n');\n        }\n        break;\n      case 'tool':\n        candidate += `<${String(index)}><tool-response id=${m.tool_call_id}>:` + m.content;\n        break;\n      case 'assistant':\n        for (const block of m.thinking_blocks ?? []) {\n          if (block.type === 'thinking') {\n            candidate += `<${String(index)}><assistant-thinking>:` + block.thinking;\n          }\n        }\n        candidate += `<${String(index)}><assistant>:` + formatAssistantContent(m.content);\n        for (const t of m.tool_calls ?? []) {\n          candidate += `<tool-call id=${t.id} name=${t.function.name}>:` + t.function.arguments;\n        }\n    }\n  }\n  return candidate;\n}\n\nexport class ContextCompaction implements PreLLMAgentContextProcessor {\n  private modelClient: ILLM;\n  private compactionThresholdTokens: number;\n\n  constructor(input: { modelClient: ILLM; compactionThresholdTokens: number }) {\n    this.modelClient = input.modelClient;\n    this.compactionThresholdTokens = input.compactionThresholdTokens;\n  }\n\n  async *processPreLLM(\n    execution: Readonly<AgentThreadExecutionContext>,\n  ): AsyncGenerator<AgentContextProcessorOutput, void, unknown> {\n    const contextTokens = execution.currentContextUsage.prompt_tokens + execution.currentContextUsage.completion_tokens;\n    if (contextTokens + PROMPT_TOKENS < this.compactionThresholdTokens) {\n      return;\n    }\n\n    // Model identity is owned by modelClient — omit OpenAI's required `model` field.\n    const body: LLMCreateParams = {\n      messages: [\n        { role: 'user', content: createSummarizationCandidate(execution.context) },\n        { role: 'user', content: PROMPT },\n      ],\n      stream: false,\n    };\n\n    const response = await this.modelClient.createNonStream(body);\n    const context: ContextMessage[] = [{ role: 'assistant', content: response.output.content }, CONTINUATION_MESSAGE];\n\n    yield {\n      type: EventType.AGENT_CONTEXT_OVERWRITE,\n      id: newEventId(),\n      created_at: new Date().toISOString(),\n      reason: 'compaction',\n      context: context,\n      current_context_usage: {\n        // NOTE(agent): This is not really correct.\n        // This is not taking into account that the original request had\n        // tool definition in them.\n        // This will get refreshed in the next LLM call.\n        prompt_tokens: response.usage.input_tokens + CONTINUATION_MESSAGE_TOKENS,\n        completion_tokens: 0,\n      },\n      usage: response.usage,\n    };\n  }\n}\n\nexport interface ContextCompactionSettings {\n  compactionThresholdTokens?: number | undefined;\n}\n\nexport function contextCompaction(options: {\n  definition: AgentDefinition;\n  settings?: ContextCompactionSettings | undefined;\n  compactionThresholdTokens?: number | undefined;\n}): AgentCapability {\n  const threshold =\n    options.compactionThresholdTokens ??\n    options.settings?.compactionThresholdTokens ??\n    DEFAULT_CONTEXT_COMPACTION_THRESHOLD_TOKENS;\n  return {\n    preLLMProcessors: [\n      new ContextCompaction({\n        modelClient: options.definition.modelClient,\n        compactionThresholdTokens: threshold,\n      }),\n    ],\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/core/capabilities/builtins/CurrentDateTime.d.ts

@@ -0,0 +1,17 @@
+import { LocalToolMCP, type ToolDefinition } from '../../mcp/LocalToolMCP';
+import type { AgentTracing } from '../../tracing/AgentTracing';
+import type { AgentCapability } from '../AgentCapability';
+export declare const CURRENT_DATETIME_SERVER_ID = "current-datetime";
+export declare const GET_CURRENT_DATETIME_TOOL_NAME = "get_current_datetime";
+export declare class CurrentDateTime extends LocalToolMCP {
+    readonly name = "current-datetime";
+    readonly displayName = "CurrentDateTime";
+    constructor(tracing: AgentTracing);
+    private tools;
+    protected getTools(): ToolDefinition[];
+    private getCurrentDateTime;
+}
+export declare function currentDateTime(options: {
+    tracing: AgentTracing;
+}): AgentCapability;
+//# sourceMappingURL=CurrentDateTime.d.ts.map

package/dist/core/capabilities/builtins/CurrentDateTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CurrentDateTime.d.ts","sourceRoot":"","sources":["../../../../src/core/capabilities/builtins/CurrentDateTime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAC7D,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AAIrE,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,QAAQ,CAAC,IAAI,sBAA8B;IAC3C,QAAQ,CAAC,WAAW,qBAAqB;IAEzC,YAAY,OAAO,EAAE,YAAY,EAEhC;IAED,OAAO,CAAC,KAAK,CAOX;IAEF,SAAS,CAAC,QAAQ,IAAI,cAAc,EAAE,CAErC;IAID,OAAO,CAAC,kBAAkB;CAQ3B;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,GAAG,eAAe,CAInF"}

package/dist/core/capabilities/builtins/CurrentDateTime.js

@@ -0,0 +1,75 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/capabilities/builtins/CurrentDateTime.ts
+var CurrentDateTime_exports = {};
+__export(CurrentDateTime_exports, {
+  CURRENT_DATETIME_SERVER_ID: () => CURRENT_DATETIME_SERVER_ID,
+  CurrentDateTime: () => CurrentDateTime,
+  GET_CURRENT_DATETIME_TOOL_NAME: () => GET_CURRENT_DATETIME_TOOL_NAME,
+  currentDateTime: () => currentDateTime
+});
+module.exports = __toCommonJS(CurrentDateTime_exports);
+var import_zod = require("zod");
+var import_IMCPServer = require("../../mcp/IMCPServer.js");
+var import_LocalToolMCP = require("../../mcp/LocalToolMCP.js");
+var CURRENT_DATETIME_SERVER_ID = "current-datetime";
+var GET_CURRENT_DATETIME_TOOL_NAME = "get_current_datetime";
+var inputSchema = import_zod.z.object({}).strict();
+var CurrentDateTime = class extends import_LocalToolMCP.LocalToolMCP {
+  name = CURRENT_DATETIME_SERVER_ID;
+  displayName = "CurrentDateTime";
+  constructor(tracing) {
+    super({ tracing });
+  }
+  tools = [
+    (0, import_LocalToolMCP.defineTool)({
+      name: GET_CURRENT_DATETIME_TOOL_NAME,
+      description: "Returns the current datetime in ISO-8601 (UTC) and unix epoch MS format.",
+      schema: inputSchema,
+      handler: () => Promise.resolve(this.getCurrentDateTime())
+    })
+  ];
+  getTools() {
+    return this.tools;
+  }
+  // Date.prototype.toISOString() is spec-guaranteed to return UTC (suffix 'Z').
+  // Date.prototype.getTime() returns UTC epoch ms regardless of process timezone.
+  getCurrentDateTime() {
+    const now = /* @__PURE__ */ new Date();
+    const payload = {
+      unixEpochMS: now.getTime(),
+      iso: now.toISOString()
+    };
+    return (0, import_IMCPServer.toolResultResponse)({ text: JSON.stringify(payload) });
+  }
+};
+function currentDateTime(options) {
+  return {
+    systemToolSets: [new CurrentDateTime(options.tracing)]
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CURRENT_DATETIME_SERVER_ID,
+  CurrentDateTime,
+  GET_CURRENT_DATETIME_TOOL_NAME,
+  currentDateTime
+});
+//# sourceMappingURL=CurrentDateTime.js.map

package/dist/core/capabilities/builtins/CurrentDateTime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/capabilities/builtins/CurrentDateTime.ts"],"sourcesContent":["import { z } from 'zod';\nimport { type CallToolResponse, toolResultResponse } from '../../mcp/IMCPServer';\nimport { defineTool, LocalToolMCP, type ToolDefinition } from '../../mcp/LocalToolMCP';\nimport type { AgentTracing } from '../../tracing/AgentTracing';\nimport type { AgentCapability } from '../AgentCapability';\n\nexport const CURRENT_DATETIME_SERVER_ID = 'current-datetime';\nexport const GET_CURRENT_DATETIME_TOOL_NAME = 'get_current_datetime';\n\nconst inputSchema = z.object({}).strict();\n\nexport class CurrentDateTime extends LocalToolMCP {\n  readonly name = CURRENT_DATETIME_SERVER_ID;\n  readonly displayName = 'CurrentDateTime';\n\n  constructor(tracing: AgentTracing) {\n    super({ tracing });\n  }\n\n  private tools: ToolDefinition[] = [\n    defineTool({\n      name: GET_CURRENT_DATETIME_TOOL_NAME,\n      description: 'Returns the current datetime in ISO-8601 (UTC) and unix epoch MS format.',\n      schema: inputSchema,\n      handler: () => Promise.resolve(this.getCurrentDateTime()),\n    }),\n  ];\n\n  protected getTools(): ToolDefinition[] {\n    return this.tools;\n  }\n\n  // Date.prototype.toISOString() is spec-guaranteed to return UTC (suffix 'Z').\n  // Date.prototype.getTime() returns UTC epoch ms regardless of process timezone.\n  private getCurrentDateTime(): CallToolResponse {\n    const now = new Date();\n    const payload = {\n      unixEpochMS: now.getTime(),\n      iso: now.toISOString(),\n    };\n    return toolResultResponse({ text: JSON.stringify(payload) });\n  }\n}\n\nexport function currentDateTime(options: { tracing: AgentTracing }): AgentCapability {\n  return {\n    systemToolSets: [new CurrentDateTime(options.tracing)],\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAkB;AAClB,wBAA0D;AAC1D,0BAA8D;AAIvD,IAAM,6BAA6B;AACnC,IAAM,iCAAiC;AAE9C,IAAM,cAAc,aAAE,OAAO,CAAC,CAAC,EAAE,OAAO;AAEjC,IAAM,kBAAN,cAA8B,iCAAa;AAAA,EACvC,OAAO;AAAA,EACP,cAAc;AAAA,EAEvB,YAAY,SAAuB;AACjC,UAAM,EAAE,QAAQ,CAAC;AAAA,EACnB;AAAA,EAEQ,QAA0B;AAAA,QAChC,gCAAW;AAAA,MACT,MAAM;AAAA,MACN,aAAa;AAAA,MACb,QAAQ;AAAA,MACR,SAAS,MAAM,QAAQ,QAAQ,KAAK,mBAAmB,CAAC;AAAA,IAC1D,CAAC;AAAA,EACH;AAAA,EAEU,WAA6B;AACrC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA,EAIQ,qBAAuC;AAC7C,UAAM,MAAM,oBAAI,KAAK;AACrB,UAAM,UAAU;AAAA,MACd,aAAa,IAAI,QAAQ;AAAA,MACzB,KAAK,IAAI,YAAY;AAAA,IACvB;AACA,eAAO,sCAAmB,EAAE,MAAM,KAAK,UAAU,OAAO,EAAE,CAAC;AAAA,EAC7D;AACF;AAEO,SAAS,gBAAgB,SAAqD;AACnF,SAAO;AAAA,IACL,gBAAgB,CAAC,IAAI,gBAAgB,QAAQ,OAAO,CAAC;AAAA,EACvD;AACF;","names":[]}

package/dist/core/capabilities/builtins/CurrentDateTime.mjs

@@ -0,0 +1,47 @@
+// src/core/capabilities/builtins/CurrentDateTime.ts
+import { z } from "zod";
+import { toolResultResponse } from "../../mcp/IMCPServer.mjs";
+import { defineTool, LocalToolMCP } from "../../mcp/LocalToolMCP.mjs";
+var CURRENT_DATETIME_SERVER_ID = "current-datetime";
+var GET_CURRENT_DATETIME_TOOL_NAME = "get_current_datetime";
+var inputSchema = z.object({}).strict();
+var CurrentDateTime = class extends LocalToolMCP {
+  name = CURRENT_DATETIME_SERVER_ID;
+  displayName = "CurrentDateTime";
+  constructor(tracing) {
+    super({ tracing });
+  }
+  tools = [
+    defineTool({
+      name: GET_CURRENT_DATETIME_TOOL_NAME,
+      description: "Returns the current datetime in ISO-8601 (UTC) and unix epoch MS format.",
+      schema: inputSchema,
+      handler: () => Promise.resolve(this.getCurrentDateTime())
+    })
+  ];
+  getTools() {
+    return this.tools;
+  }
+  // Date.prototype.toISOString() is spec-guaranteed to return UTC (suffix 'Z').
+  // Date.prototype.getTime() returns UTC epoch ms regardless of process timezone.
+  getCurrentDateTime() {
+    const now = /* @__PURE__ */ new Date();
+    const payload = {
+      unixEpochMS: now.getTime(),
+      iso: now.toISOString()
+    };
+    return toolResultResponse({ text: JSON.stringify(payload) });
+  }
+};
+function currentDateTime(options) {
+  return {
+    systemToolSets: [new CurrentDateTime(options.tracing)]
+  };
+}
+export {
+  CURRENT_DATETIME_SERVER_ID,
+  CurrentDateTime,
+  GET_CURRENT_DATETIME_TOOL_NAME,
+  currentDateTime
+};
+//# sourceMappingURL=CurrentDateTime.mjs.map

package/dist/core/capabilities/builtins/CurrentDateTime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/capabilities/builtins/CurrentDateTime.ts"],"sourcesContent":["import { z } from 'zod';\nimport { type CallToolResponse, toolResultResponse } from '../../mcp/IMCPServer';\nimport { defineTool, LocalToolMCP, type ToolDefinition } from '../../mcp/LocalToolMCP';\nimport type { AgentTracing } from '../../tracing/AgentTracing';\nimport type { AgentCapability } from '../AgentCapability';\n\nexport const CURRENT_DATETIME_SERVER_ID = 'current-datetime';\nexport const GET_CURRENT_DATETIME_TOOL_NAME = 'get_current_datetime';\n\nconst inputSchema = z.object({}).strict();\n\nexport class CurrentDateTime extends LocalToolMCP {\n  readonly name = CURRENT_DATETIME_SERVER_ID;\n  readonly displayName = 'CurrentDateTime';\n\n  constructor(tracing: AgentTracing) {\n    super({ tracing });\n  }\n\n  private tools: ToolDefinition[] = [\n    defineTool({\n      name: GET_CURRENT_DATETIME_TOOL_NAME,\n      description: 'Returns the current datetime in ISO-8601 (UTC) and unix epoch MS format.',\n      schema: inputSchema,\n      handler: () => Promise.resolve(this.getCurrentDateTime()),\n    }),\n  ];\n\n  protected getTools(): ToolDefinition[] {\n    return this.tools;\n  }\n\n  // Date.prototype.toISOString() is spec-guaranteed to return UTC (suffix 'Z').\n  // Date.prototype.getTime() returns UTC epoch ms regardless of process timezone.\n  private getCurrentDateTime(): CallToolResponse {\n    const now = new Date();\n    const payload = {\n      unixEpochMS: now.getTime(),\n      iso: now.toISOString(),\n    };\n    return toolResultResponse({ text: JSON.stringify(payload) });\n  }\n}\n\nexport function currentDateTime(options: { tracing: AgentTracing }): AgentCapability {\n  return {\n    systemToolSets: [new CurrentDateTime(options.tracing)],\n  };\n}\n"],"mappings":";AAAA,SAAS,SAAS;AAClB,SAAgC,0BAA0B;AAC1D,SAAS,YAAY,oBAAyC;AAIvD,IAAM,6BAA6B;AACnC,IAAM,iCAAiC;AAE9C,IAAM,cAAc,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO;AAEjC,IAAM,kBAAN,cAA8B,aAAa;AAAA,EACvC,OAAO;AAAA,EACP,cAAc;AAAA,EAEvB,YAAY,SAAuB;AACjC,UAAM,EAAE,QAAQ,CAAC;AAAA,EACnB;AAAA,EAEQ,QAA0B;AAAA,IAChC,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aAAa;AAAA,MACb,QAAQ;AAAA,MACR,SAAS,MAAM,QAAQ,QAAQ,KAAK,mBAAmB,CAAC;AAAA,IAC1D,CAAC;AAAA,EACH;AAAA,EAEU,WAA6B;AACrC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA,EAIQ,qBAAuC;AAC7C,UAAM,MAAM,oBAAI,KAAK;AACrB,UAAM,UAAU;AAAA,MACd,aAAa,IAAI,QAAQ;AAAA,MACzB,KAAK,IAAI,YAAY;AAAA,IACvB;AACA,WAAO,mBAAmB,EAAE,MAAM,KAAK,UAAU,OAAO,EAAE,CAAC;AAAA,EAC7D;AACF;AAEO,SAAS,gBAAgB,SAAqD;AACnF,SAAO;AAAA,IACL,gBAAgB,CAAC,IAAI,gBAAgB,QAAQ,OAAO,CAAC;AAAA,EACvD;AACF;","names":[]}

package/dist/core/capabilities/builtins/DynamicSubAgents.d.ts

@@ -0,0 +1,39 @@
+import type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+import { InstructionBuilder } from '../../InstructionBuilder';
+import type { InternalToolCallInfo } from '../../llm/LLMTypes';
+import { LocalToolMCP, type ToolDefinition } from '../../mcp/LocalToolMCP';
+import type { AgentTracing } from '../../tracing/AgentTracing';
+import type { AgentCapability } from '../AgentCapability';
+export declare const SUB_AGENT_TOOL_NAME = "create_sub_agent";
+export declare const SUB_AGENTS_SERVER_ID = "sub_agents";
+export declare const SUB_AGENTS_REMINDER_TAG = "sub-agents";
+export declare const SUB_AGENT_IDENTITY = "You are the Agent operating as a sub-agent that has been delegated a specific task. The Agent has access to the same tools as the parent agent. The Agent must focus on completing the delegated task and return a concise result. The Agent cannot ask questions to the user.";
+export interface ModelSetEntry {
+    description: string;
+    model_params?: Record<string, unknown> | undefined;
+}
+export type ModelSetConfig = Record<string, ModelSetEntry>;
+export declare function createDynamicSubAgentLargeToolResponseGuidance(): string;
+export declare function buildDynamicSubAgentsInstruction(builder: InstructionBuilder, params: {
+    sandboxAvailable: boolean;
+}): void;
+export declare class DynamicSubAgents extends LocalToolMCP {
+    readonly name = "sub_agents";
+    readonly displayName = "DynamicSubAgents";
+    readonly tracingEnabled = false;
+    private tools;
+    private getCreateSubAgentDescription;
+    private getCreateSubAgentTool;
+    constructor({ modelSetConfig, tracing }: {
+        modelSetConfig?: ModelSetConfig | undefined;
+        tracing: AgentTracing;
+    });
+    protected getTools(): ToolDefinition[];
+    toolCallInfo(params: CallToolRequest['params'], _resolveUnderlyingTool?: boolean): Promise<InternalToolCallInfo>;
+}
+export declare function dynamicSubAgents(options: {
+    modelSetConfig?: ModelSetConfig | undefined;
+    sandboxAvailable: boolean;
+    tracing: AgentTracing;
+}): AgentCapability;
+//# sourceMappingURL=DynamicSubAgents.d.ts.map

package/dist/core/capabilities/builtins/DynamicSubAgents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamicSubAgents.d.ts","sourceRoot":"","sources":["../../../../src/core/capabilities/builtins/DynamicSubAgents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAG1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAc,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AACtD,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD,eAAO,MAAM,kBAAkB,mRACmP,CAAC;AAEnR,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACpD;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE3D,wBAAgB,8CAA8C,IAAI,MAAM,CAKvE;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE;IAAE,gBAAgB,EAAE,OAAO,CAAA;CAAE,GACpC,IAAI,CAkBN;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,QAAQ,CAAC,IAAI,gBAAwB;IACrC,QAAQ,CAAC,WAAW,sBAAsB;IAC1C,SAAkB,cAAc,SAAS;IACzC,OAAO,CAAC,KAAK,CAAmB;IAEhC,OAAO,CAAC,4BAA4B;IAuBpC,OAAO,CAAC,qBAAqB;IAwC7B,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE;QAAE,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,EAG9G;IAED,SAAS,CAAC,QAAQ,IAAI,cAAc,EAAE,CAErC;IAEQ,YAAY,CACnB,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,EACjC,sBAAsB,CAAC,EAAE,OAAO,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAU/B;CACF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC5C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,YAAY,CAAC;CACvB,GAAG,eAAe,CAalB"}

package/dist/core/capabilities/builtins/DynamicSubAgents.js

@@ -0,0 +1,176 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/capabilities/builtins/DynamicSubAgents.ts
+var DynamicSubAgents_exports = {};
+__export(DynamicSubAgents_exports, {
+  DynamicSubAgents: () => DynamicSubAgents,
+  SUB_AGENTS_REMINDER_TAG: () => SUB_AGENTS_REMINDER_TAG,
+  SUB_AGENTS_SERVER_ID: () => SUB_AGENTS_SERVER_ID,
+  SUB_AGENT_IDENTITY: () => SUB_AGENT_IDENTITY,
+  SUB_AGENT_TOOL_NAME: () => SUB_AGENT_TOOL_NAME,
+  buildDynamicSubAgentsInstruction: () => buildDynamicSubAgentsInstruction,
+  createDynamicSubAgentLargeToolResponseGuidance: () => createDynamicSubAgentLargeToolResponseGuidance,
+  dynamicSubAgents: () => dynamicSubAgents
+});
+module.exports = __toCommonJS(DynamicSubAgents_exports);
+var import_dedent = __toESM(require("dedent"), 1);
+var import_zod = require("zod");
+var import_InstructionBuilder = require("../../InstructionBuilder.js");
+var import_LocalToolMCP = require("../../mcp/LocalToolMCP.js");
+var SUB_AGENT_TOOL_NAME = "create_sub_agent";
+var SUB_AGENTS_SERVER_ID = "sub_agents";
+var SUB_AGENTS_REMINDER_TAG = "sub-agents";
+var SUB_AGENT_IDENTITY = "You are the Agent operating as a sub-agent that has been delegated a specific task. The Agent has access to the same tools as the parent agent. The Agent must focus on completing the delegated task and return a concise result. The Agent cannot ask questions to the user.";
+function createDynamicSubAgentLargeToolResponseGuidance() {
+  return import_dedent.default`
+    For large unstructured output like web search, documentation lookup, or broad search results,
+    the Agent should prefer delegating to a sub-agent and ask it to return only the relevant summary, with citations
+    when they improve verification.`;
+}
+function buildDynamicSubAgentsInstruction(builder, params) {
+  const sandboxGuidance = params.sandboxAvailable ? import_dedent.default`
+      When both sub-agents and sandbox are available, the Agent should always use sandbox code for mechanical data processing.
+      The Agent should use sub-agents for tasks that return large unstructured text (e.g. web search, documentation lookup) or
+      where multi-step reasoning is needed to process and summarize the results.` : "";
+  const paragraphs = [
+    import_dedent.default`The Agent can create sub-agents using the ${SUB_AGENT_TOOL_NAME} tool. Sub-agents are best for tasks that involve one or more tool calls that would fill up the context window or are blocked due to "Large Tool Response",
+    or tasks requiring exploration and reasoning that can be clearly delegated.`,
+    createDynamicSubAgentLargeToolResponseGuidance(),
+    ...sandboxGuidance ? [sandboxGuidance] : [],
+    import_dedent.default`The Agent should ask the sub-agent to include references or citations when they would improve reliability or make
+    verification easier.`
+  ];
+  builder.addSection(SUB_AGENTS_REMINDER_TAG, paragraphs.join("\n\n").trim());
+}
+var DynamicSubAgents = class extends import_LocalToolMCP.LocalToolMCP {
+  name = SUB_AGENTS_SERVER_ID;
+  displayName = "DynamicSubAgents";
+  tracingEnabled = false;
+  tools;
+  getCreateSubAgentDescription(modelSetConfig) {
+    let modelSetGuidance = "";
+    const modelSetModels = modelSetConfig ? Object.keys(modelSetConfig) : [];
+    if (modelSetConfig && modelSetModels.length > 0) {
+      const modelList = Object.entries(modelSetConfig).map(([key, entry]) => `- [${key}]: ${entry.description}`).join("\n");
+      modelSetGuidance = import_dedent.default`
+        Pick a suitable model for the task being delegated from the following list of models and their descriptions:
+        ${modelList}
+        `;
+    }
+    const paragraphs = [
+      `Delegate a well-defined task to a sub-agent. The Agent must not delegate the whole work to the sub-agent.`,
+      `The sub-agent has access to the same tools and the same sandbox environment as the parent Agent. Files created or modified by either agent are shared and remain available to both.`,
+      ...modelSetGuidance ? [modelSetGuidance] : [],
+      `The sub-agent has NO access to the prior conversation or the user's original message. The Agent must provide a clear, self-contained instruction that includes all necessary context, the exact task to perform, any constraints, what outputs are expected, and what work has already been completed so effort is not duplicated.`
+    ];
+    return paragraphs.join("\n\n").trim();
+  }
+  getCreateSubAgentTool(modelSetConfig) {
+    const modelKeys = Object.keys(modelSetConfig ?? {});
+    if (modelKeys.length > 0) {
+      return (0, import_LocalToolMCP.defineTool)({
+        name: SUB_AGENT_TOOL_NAME,
+        description: this.getCreateSubAgentDescription(modelSetConfig),
+        schema: import_zod.z.object({
+          name: import_zod.z.string().min(1),
+          input: import_zod.z.string().min(1),
+          model: import_zod.z.enum(modelKeys)
+        }),
+        handler: (input) => Promise.resolve({
+          createSubAgent: {
+            type: "dynamic",
+            name: input.name,
+            input: input.input,
+            model: input.model
+          }
+        })
+      });
+    }
+    return (0, import_LocalToolMCP.defineTool)({
+      name: SUB_AGENT_TOOL_NAME,
+      description: this.getCreateSubAgentDescription(modelSetConfig),
+      schema: import_zod.z.object({
+        name: import_zod.z.string().min(1),
+        input: import_zod.z.string().min(1)
+      }),
+      handler: (input) => Promise.resolve({
+        createSubAgent: {
+          type: "dynamic",
+          name: input.name,
+          input: input.input
+        }
+      })
+    });
+  }
+  constructor({ modelSetConfig, tracing }) {
+    super({ tracing });
+    this.tools = [this.getCreateSubAgentTool(modelSetConfig)];
+  }
+  getTools() {
+    return this.tools;
+  }
+  toolCallInfo(params, _resolveUnderlyingTool) {
+    void _resolveUnderlyingTool;
+    return Promise.resolve({
+      type: "truefoundry-system",
+      mcp_server_id: this.mcpServerId,
+      mcp_server_name: this.name,
+      original_tool_name: params.name,
+      is_approval_required: false,
+      is_thread_creation: true
+    });
+  }
+};
+function dynamicSubAgents(options) {
+  const toolSet = new DynamicSubAgents({
+    modelSetConfig: options.modelSetConfig,
+    tracing: options.tracing
+  });
+  return {
+    systemToolSets: [toolSet],
+    instructionBuilders: [
+      (builder) => {
+        buildDynamicSubAgentsInstruction(builder, { sandboxAvailable: options.sandboxAvailable });
+      }
+    ]
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DynamicSubAgents,
+  SUB_AGENTS_REMINDER_TAG,
+  SUB_AGENTS_SERVER_ID,
+  SUB_AGENT_IDENTITY,
+  SUB_AGENT_TOOL_NAME,
+  buildDynamicSubAgentsInstruction,
+  createDynamicSubAgentLargeToolResponseGuidance,
+  dynamicSubAgents
+});
+//# sourceMappingURL=DynamicSubAgents.js.map

package/dist/core/capabilities/builtins/DynamicSubAgents.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/capabilities/builtins/DynamicSubAgents.ts"],"sourcesContent":["import type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';\nimport dedent from 'dedent';\nimport { z } from 'zod';\nimport { InstructionBuilder } from '../../InstructionBuilder';\nimport type { InternalToolCallInfo } from '../../llm/LLMTypes';\nimport { defineTool, LocalToolMCP, type ToolDefinition } from '../../mcp/LocalToolMCP';\nimport type { AgentTracing } from '../../tracing/AgentTracing';\nimport type { AgentCapability } from '../AgentCapability';\n\nexport const SUB_AGENT_TOOL_NAME = 'create_sub_agent';\nexport const SUB_AGENTS_SERVER_ID = 'sub_agents';\nexport const SUB_AGENTS_REMINDER_TAG = 'sub-agents';\n\nexport const SUB_AGENT_IDENTITY =\n  'You are the Agent operating as a sub-agent that has been delegated a specific task. The Agent has access to the same tools as the parent agent. The Agent must focus on completing the delegated task and return a concise result. The Agent cannot ask questions to the user.';\n\nexport interface ModelSetEntry {\n  description: string;\n  model_params?: Record<string, unknown> | undefined;\n}\n\nexport type ModelSetConfig = Record<string, ModelSetEntry>;\n\nexport function createDynamicSubAgentLargeToolResponseGuidance(): string {\n  return dedent`\n    For large unstructured output like web search, documentation lookup, or broad search results,\n    the Agent should prefer delegating to a sub-agent and ask it to return only the relevant summary, with citations\n    when they improve verification.`;\n}\n\nexport function buildDynamicSubAgentsInstruction(\n  builder: InstructionBuilder,\n  params: { sandboxAvailable: boolean },\n): void {\n  const sandboxGuidance = params.sandboxAvailable\n    ? dedent`\n      When both sub-agents and sandbox are available, the Agent should always use sandbox code for mechanical data processing.\n      The Agent should use sub-agents for tasks that return large unstructured text (e.g. web search, documentation lookup) or\n      where multi-step reasoning is needed to process and summarize the results.`\n    : '';\n\n  const paragraphs = [\n    dedent`The Agent can create sub-agents using the ${SUB_AGENT_TOOL_NAME} tool. Sub-agents are best for tasks that involve one or more tool calls that would fill up the context window or are blocked due to \"Large Tool Response\",\n    or tasks requiring exploration and reasoning that can be clearly delegated.`,\n    createDynamicSubAgentLargeToolResponseGuidance(),\n    ...(sandboxGuidance ? [sandboxGuidance] : []),\n    dedent`The Agent should ask the sub-agent to include references or citations when they would improve reliability or make\n    verification easier.`,\n  ];\n\n  builder.addSection(SUB_AGENTS_REMINDER_TAG, paragraphs.join('\\n\\n').trim());\n}\n\nexport class DynamicSubAgents extends LocalToolMCP {\n  readonly name = SUB_AGENTS_SERVER_ID;\n  readonly displayName = 'DynamicSubAgents';\n  override readonly tracingEnabled = false;\n  private tools: ToolDefinition[];\n\n  private getCreateSubAgentDescription(modelSetConfig?: ModelSetConfig): string {\n    let modelSetGuidance = '';\n    const modelSetModels = modelSetConfig ? Object.keys(modelSetConfig) : [];\n    if (modelSetConfig && modelSetModels.length > 0) {\n      const modelList = Object.entries(modelSetConfig)\n        .map(([key, entry]) => `- [${key}]: ${entry.description}`)\n        .join('\\n');\n      modelSetGuidance = dedent`\n        Pick a suitable model for the task being delegated from the following list of models and their descriptions:\n        ${modelList}\n        `;\n    }\n\n    const paragraphs = [\n      `Delegate a well-defined task to a sub-agent. The Agent must not delegate the whole work to the sub-agent.`,\n      `The sub-agent has access to the same tools and the same sandbox environment as the parent Agent. Files created or modified by either agent are shared and remain available to both.`,\n      ...(modelSetGuidance ? [modelSetGuidance] : []),\n      `The sub-agent has NO access to the prior conversation or the user's original message. The Agent must provide a clear, self-contained instruction that includes all necessary context, the exact task to perform, any constraints, what outputs are expected, and what work has already been completed so effort is not duplicated.`,\n    ];\n\n    return paragraphs.join('\\n\\n').trim();\n  }\n\n  private getCreateSubAgentTool(modelSetConfig?: ModelSetConfig): ToolDefinition {\n    const modelKeys = Object.keys(modelSetConfig ?? {});\n    if (modelKeys.length > 0) {\n      return defineTool({\n        name: SUB_AGENT_TOOL_NAME,\n        description: this.getCreateSubAgentDescription(modelSetConfig),\n        schema: z.object({\n          name: z.string().min(1),\n          input: z.string().min(1),\n          model: z.enum(modelKeys as [string, ...string[]]),\n        }),\n        handler: input =>\n          Promise.resolve({\n            createSubAgent: {\n              type: 'dynamic',\n              name: input.name,\n              input: input.input,\n              model: input.model,\n            },\n          }),\n      });\n    }\n    return defineTool({\n      name: SUB_AGENT_TOOL_NAME,\n      description: this.getCreateSubAgentDescription(modelSetConfig),\n      schema: z.object({\n        name: z.string().min(1),\n        input: z.string().min(1),\n      }),\n      handler: input =>\n        Promise.resolve({\n          createSubAgent: {\n            type: 'dynamic',\n            name: input.name,\n            input: input.input,\n          },\n        }),\n    });\n  }\n\n  constructor({ modelSetConfig, tracing }: { modelSetConfig?: ModelSetConfig | undefined; tracing: AgentTracing }) {\n    super({ tracing });\n    this.tools = [this.getCreateSubAgentTool(modelSetConfig)];\n  }\n\n  protected getTools(): ToolDefinition[] {\n    return this.tools;\n  }\n\n  override toolCallInfo(\n    params: CallToolRequest['params'],\n    _resolveUnderlyingTool?: boolean,\n  ): Promise<InternalToolCallInfo> {\n    void _resolveUnderlyingTool;\n    return Promise.resolve({\n      type: 'truefoundry-system',\n      mcp_server_id: this.mcpServerId,\n      mcp_server_name: this.name,\n      original_tool_name: params.name,\n      is_approval_required: false,\n      is_thread_creation: true,\n    });\n  }\n}\n\nexport function dynamicSubAgents(options: {\n  modelSetConfig?: ModelSetConfig | undefined;\n  sandboxAvailable: boolean;\n  tracing: AgentTracing;\n}): AgentCapability {\n  const toolSet = new DynamicSubAgents({\n    modelSetConfig: options.modelSetConfig,\n    tracing: options.tracing,\n  });\n  return {\n    systemToolSets: [toolSet],\n    instructionBuilders: [\n      builder => {\n        buildDynamicSubAgentsInstruction(builder, { sandboxAvailable: options.sandboxAvailable });\n      },\n    ],\n  };\n}\n"],"mappings":"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","names":["dedent"]}