@truefoundry/trueforge-core 0.0.0 → 0.1.0

package/dist/core/capabilities/AgentContextProcessor.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/AgentContextProcessor.ts
+var AgentContextProcessor_exports = {};
+module.exports = __toCommonJS(AgentContextProcessor_exports);
+//# sourceMappingURL=AgentContextProcessor.js.map

package/dist/core/capabilities/AgentContextProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/capabilities/AgentContextProcessor.ts"],"sourcesContent":["import type { ChatCompletionMessageParam } from 'openai/resources/chat';\nimport type { ThreadOverwriteContextEvent } from '../events/schema';\nimport type {\n  AgentThreadAppendContext,\n  ContextMessage,\n  InternalCapabilityStateEvent,\n  InternalPassthroughEvent,\n} from '../runtime/AgentThread.types';\nimport type { CurrentContextUsage } from '../runtime/contextUsage';\nimport type { Sandbox } from '../sandbox/Sandbox';\n\n/** Ambient thread snapshot passed Readonly to every capability processor hook. */\nexport interface AgentThreadExecutionContext {\n  threadId: string;\n  sandbox?: Sandbox | undefined;\n  currentContextUsage: CurrentContextUsage;\n  context: ContextMessage[];\n}\n\nexport type AgentContextProcessorOverwriteContext = Omit<ThreadOverwriteContextEvent, 'thread_id'>;\n\nexport type AgentContextProcessorAppendContext = Omit<AgentThreadAppendContext, 'thread_id'>;\n\n/** Processors omit thread_id — AgentThread stamps it (same as append/overwrite). */\nexport type AgentContextProcessorCapabilityState = Omit<InternalCapabilityStateEvent, 'thread_id'>;\n\nexport type AgentContextProcessorOutput =\n  | AgentContextProcessorOverwriteContext\n  | AgentContextProcessorAppendContext\n  | InternalPassthroughEvent\n  | AgentContextProcessorCapabilityState;\n\nexport interface PreSendContextProcessor {\n  processPreSend(execution: Readonly<AgentThreadExecutionContext>): AsyncIterable<AgentContextProcessorAppendContext>;\n}\n\n// NOTE: Saved in Redis, Saved in AgentThread in memory. Persisted accross Agent Loop.\nexport interface PreLLMAgentContextProcessor {\n  processPreLLM(execution: Readonly<AgentThreadExecutionContext>): AsyncIterable<AgentContextProcessorOutput>;\n}\n\nexport interface PostToolCallAgentContextProcessor {\n  processPostToolCall(execution: Readonly<AgentThreadExecutionContext>): AsyncIterable<AgentContextProcessorOutput>;\n}\n\n// NOTE: Not saved in Redis, Not saved in AgentThread in memory. Not persisted accross Agent Loop.\nexport interface PreLLMEphemeralAgentContextProcessor {\n  processPreLLMEphemeral(input: ChatCompletionMessageParam[]): ChatCompletionMessageParam[] | undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/core/capabilities/AgentContextProcessor.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=AgentContextProcessor.mjs.map

package/dist/core/capabilities/AgentContextProcessor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/core/capabilities/ToolResponseProcessor.d.ts

@@ -0,0 +1,12 @@
+import type { RegisteredPassthroughEvent } from '../events/PassthroughEvents';
+import type { ToolCallResult } from '../mcp/executeToolCalls';
+import type { SandboxInfo } from '../sandbox/Sandbox';
+import type { AgentThreadExecutionContext } from './AgentContextProcessor';
+export interface ToolResponseProcessorResult {
+    sandboxCreated?: SandboxInfo | undefined;
+    events?: readonly RegisteredPassthroughEvent[] | undefined;
+}
+export interface ToolResponseProcessor {
+    process(result: ToolCallResult[], execution: Readonly<AgentThreadExecutionContext>): Promise<ToolResponseProcessorResult>;
+}
+//# sourceMappingURL=ToolResponseProcessor.d.ts.map

package/dist/core/capabilities/ToolResponseProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolResponseProcessor.d.ts","sourceRoot":"","sources":["../../../src/core/capabilities/ToolResponseProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,MAAM,WAAW,2BAA2B;IAC1C,cAAc,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACzC,MAAM,CAAC,EAAE,SAAS,0BAA0B,EAAE,GAAG,SAAS,CAAC;CAC5D;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CACL,MAAM,EAAE,cAAc,EAAE,EACxB,SAAS,EAAE,QAAQ,CAAC,2BAA2B,CAAC,GAC/C,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACzC"}

package/dist/core/capabilities/ToolResponseProcessor.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/ToolResponseProcessor.ts
+var ToolResponseProcessor_exports = {};
+module.exports = __toCommonJS(ToolResponseProcessor_exports);
+//# sourceMappingURL=ToolResponseProcessor.js.map

package/dist/core/capabilities/ToolResponseProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/capabilities/ToolResponseProcessor.ts"],"sourcesContent":["import type { RegisteredPassthroughEvent } from '../events/PassthroughEvents';\nimport type { ToolCallResult } from '../mcp/executeToolCalls';\nimport type { SandboxInfo } from '../sandbox/Sandbox';\nimport type { AgentThreadExecutionContext } from './AgentContextProcessor';\n\nexport interface ToolResponseProcessorResult {\n  sandboxCreated?: SandboxInfo | undefined;\n  events?: readonly RegisteredPassthroughEvent[] | undefined;\n}\n\nexport interface ToolResponseProcessor {\n  process(\n    result: ToolCallResult[],\n    execution: Readonly<AgentThreadExecutionContext>,\n  ): Promise<ToolResponseProcessorResult>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/core/capabilities/ToolResponseProcessor.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=ToolResponseProcessor.mjs.map

package/dist/core/capabilities/ToolResponseProcessor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,11 @@
+import { ClientSideTool } from '../../mcp/ClientSideTool';
+import { type ToolDefinition } from '../../mcp/LocalToolMCP';
+import type { AgentCapability } from '../AgentCapability';
+export declare class AskUserQuestion extends ClientSideTool {
+    readonly name = "ask-user-question";
+    readonly displayName = "AskUserQuestion";
+    readonly tracingEnabled = false;
+    protected getTools(): ToolDefinition[];
+}
+export declare function askUserQuestion(): AgentCapability;
+//# sourceMappingURL=AskUserQuestion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AskUserQuestion.d.ts","sourceRoot":"","sources":["../../../../src/core/capabilities/builtins/AskUserQuestion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAiB1D,qBAAa,eAAgB,SAAQ,cAAc;IACjD,QAAQ,CAAC,IAAI,uBAA+B;IAC5C,QAAQ,CAAC,WAAW,qBAAqB;IACzC,SAAkB,cAAc,SAAS;IAEzC,SAAS,CAAC,QAAQ,IAAI,cAAc,EAAE,CAmCrC;CACF;AAED,wBAAgB,eAAe,IAAI,eAAe,CAIjD"}

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

@@ -0,0 +1,90 @@
+"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/AskUserQuestion.ts
+var AskUserQuestion_exports = {};
+__export(AskUserQuestion_exports, {
+  AskUserQuestion: () => AskUserQuestion,
+  askUserQuestion: () => askUserQuestion
+});
+module.exports = __toCommonJS(AskUserQuestion_exports);
+var import_zod = require("zod");
+var import_ClientSideTool = require("../../mcp/ClientSideTool.js");
+var import_IMCPServer = require("../../mcp/IMCPServer.js");
+var import_LocalToolMCP = require("../../mcp/LocalToolMCP.js");
+var import_OpenUI = require("./OpenUI.js");
+var ASK_USER_QUESTION_SERVER_ID = "ask-user-question";
+var ASK_USER_QUESTION_TOOL_NAME = "ask_user_question";
+var askUserQuestionInputSchema = import_zod.z.object({
+  question: import_zod.z.string().describe("The question to ask the user."),
+  options: import_zod.z.array(import_zod.z.string()).min(0).max(5).describe(
+    "0-5 mutually exclusive choices, each mapping to a distinct outcome. A free-text input is always rendered alongside."
+  )
+});
+var AskUserQuestion = class extends import_ClientSideTool.ClientSideTool {
+  name = ASK_USER_QUESTION_SERVER_ID;
+  displayName = "AskUserQuestion";
+  tracingEnabled = false;
+  getTools() {
+    return [
+      (0, import_LocalToolMCP.defineTool)({
+        name: ASK_USER_QUESTION_TOOL_NAME,
+        description: [
+          "Ask the user a question when clarification or a decision is needed before proceeding. Only ask when the answer meaningfully changes what you do next.",
+          "",
+          "Rules:",
+          "- Provide as many options as the question needs (0-5). When you include options, each must be a genuinely distinct, mutually exclusive outcome that meaningfully changes what you do next.",
+          `- MUST NOT use <${import_OpenUI.OPENUI_SECTION_TAG}> for asking the user a question.`,
+          "- The user picks exactly one option \u2014 multi-select is not available.",
+          "- Options must be mutually exclusive. If a valid choice is a combination of other options, include it as a separate option with the combined data.",
+          '- Every option must commit the user to a specific outcome. Do not add an option whose purpose is to let the user describe, specify, or type their own answer. Do not add an option like "Other" or "Something else".',
+          "",
+          "Example (distinct options):",
+          'question: "<your question>"',
+          'options: ["<Option A>", "<Option B>", "<Option C>"]',
+          "",
+          "Example (combined options):",
+          'question: "<your question>"',
+          'options: ["<Option A>", "<Option B>", "<Option A and B \u2014 combined details>"]',
+          "",
+          "Avoid:",
+          'options: ["<Option A>", "<Option B>", "Other"]'
+        ].join("\n"),
+        schema: askUserQuestionInputSchema,
+        handler: () => Promise.resolve(
+          (0, import_IMCPServer.toolResultResponse)({
+            text: "This tool requires client-side execution and cannot be run server-side.",
+            isError: true
+          })
+        )
+      })
+    ];
+  }
+};
+function askUserQuestion() {
+  return {
+    systemToolSets: [new AskUserQuestion()]
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AskUserQuestion,
+  askUserQuestion
+});
+//# sourceMappingURL=AskUserQuestion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/capabilities/builtins/AskUserQuestion.ts"],"sourcesContent":["import { z } from 'zod';\nimport { ClientSideTool } from '../../mcp/ClientSideTool';\nimport { toolResultResponse } from '../../mcp/IMCPServer';\nimport { defineTool, type ToolDefinition } from '../../mcp/LocalToolMCP';\nimport type { AgentCapability } from '../AgentCapability';\nimport { OPENUI_SECTION_TAG } from './OpenUI';\n\nconst ASK_USER_QUESTION_SERVER_ID = 'ask-user-question';\nconst ASK_USER_QUESTION_TOOL_NAME = 'ask_user_question';\n\nconst askUserQuestionInputSchema = z.object({\n  question: z.string().describe('The question to ask the user.'),\n  options: z\n    .array(z.string())\n    .min(0)\n    .max(5)\n    .describe(\n      '0-5 mutually exclusive choices, each mapping to a distinct outcome. A free-text input is always rendered alongside.',\n    ),\n});\n\nexport class AskUserQuestion extends ClientSideTool {\n  readonly name = ASK_USER_QUESTION_SERVER_ID;\n  readonly displayName = 'AskUserQuestion';\n  override readonly tracingEnabled = false;\n\n  protected getTools(): ToolDefinition[] {\n    return [\n      defineTool({\n        name: ASK_USER_QUESTION_TOOL_NAME,\n        description: [\n          'Ask the user a question when clarification or a decision is needed before proceeding. Only ask when the answer meaningfully changes what you do next.',\n          '',\n          'Rules:',\n          '- Provide as many options as the question needs (0-5). When you include options, each must be a genuinely distinct, mutually exclusive outcome that meaningfully changes what you do next.',\n          `- MUST NOT use <${OPENUI_SECTION_TAG}> for asking the user a question.`,\n          '- The user picks exactly one option — multi-select is not available.',\n          '- Options must be mutually exclusive. If a valid choice is a combination of other options, include it as a separate option with the combined data.',\n          '- Every option must commit the user to a specific outcome. Do not add an option whose purpose is to let the user describe, specify, or type their own answer. Do not add an option like \"Other\" or \"Something else\".',\n          '',\n          'Example (distinct options):',\n          'question: \"<your question>\"',\n          'options: [\"<Option A>\", \"<Option B>\", \"<Option C>\"]',\n          '',\n          'Example (combined options):',\n          'question: \"<your question>\"',\n          'options: [\"<Option A>\", \"<Option B>\", \"<Option A and B — combined details>\"]',\n          '',\n          'Avoid:',\n          'options: [\"<Option A>\", \"<Option B>\", \"Other\"]',\n        ].join('\\n'),\n        schema: askUserQuestionInputSchema,\n        handler: () =>\n          Promise.resolve(\n            toolResultResponse({\n              text: 'This tool requires client-side execution and cannot be run server-side.',\n              isError: true,\n            }),\n          ),\n      }),\n    ];\n  }\n}\n\nexport function askUserQuestion(): AgentCapability {\n  return {\n    systemToolSets: [new AskUserQuestion()],\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAkB;AAClB,4BAA+B;AAC/B,wBAAmC;AACnC,0BAAgD;AAEhD,oBAAmC;AAEnC,IAAM,8BAA8B;AACpC,IAAM,8BAA8B;AAEpC,IAAM,6BAA6B,aAAE,OAAO;AAAA,EAC1C,UAAU,aAAE,OAAO,EAAE,SAAS,+BAA+B;AAAA,EAC7D,SAAS,aACN,MAAM,aAAE,OAAO,CAAC,EAChB,IAAI,CAAC,EACL,IAAI,CAAC,EACL;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAEM,IAAM,kBAAN,cAA8B,qCAAe;AAAA,EACzC,OAAO;AAAA,EACP,cAAc;AAAA,EACL,iBAAiB;AAAA,EAEzB,WAA6B;AACrC,WAAO;AAAA,UACL,gCAAW;AAAA,QACT,MAAM;AAAA,QACN,aAAa;AAAA,UACX;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA,mBAAmB,gCAAkB;AAAA,UACrC;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF,EAAE,KAAK,IAAI;AAAA,QACX,QAAQ;AAAA,QACR,SAAS,MACP,QAAQ;AAAA,cACN,sCAAmB;AAAA,YACjB,MAAM;AAAA,YACN,SAAS;AAAA,UACX,CAAC;AAAA,QACH;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEO,SAAS,kBAAmC;AACjD,SAAO;AAAA,IACL,gBAAgB,CAAC,IAAI,gBAAgB,CAAC;AAAA,EACxC;AACF;","names":[]}

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

@@ -0,0 +1,64 @@
+// src/core/capabilities/builtins/AskUserQuestion.ts
+import { z } from "zod";
+import { ClientSideTool } from "../../mcp/ClientSideTool.mjs";
+import { toolResultResponse } from "../../mcp/IMCPServer.mjs";
+import { defineTool } from "../../mcp/LocalToolMCP.mjs";
+import { OPENUI_SECTION_TAG } from "./OpenUI.mjs";
+var ASK_USER_QUESTION_SERVER_ID = "ask-user-question";
+var ASK_USER_QUESTION_TOOL_NAME = "ask_user_question";
+var askUserQuestionInputSchema = z.object({
+  question: z.string().describe("The question to ask the user."),
+  options: z.array(z.string()).min(0).max(5).describe(
+    "0-5 mutually exclusive choices, each mapping to a distinct outcome. A free-text input is always rendered alongside."
+  )
+});
+var AskUserQuestion = class extends ClientSideTool {
+  name = ASK_USER_QUESTION_SERVER_ID;
+  displayName = "AskUserQuestion";
+  tracingEnabled = false;
+  getTools() {
+    return [
+      defineTool({
+        name: ASK_USER_QUESTION_TOOL_NAME,
+        description: [
+          "Ask the user a question when clarification or a decision is needed before proceeding. Only ask when the answer meaningfully changes what you do next.",
+          "",
+          "Rules:",
+          "- Provide as many options as the question needs (0-5). When you include options, each must be a genuinely distinct, mutually exclusive outcome that meaningfully changes what you do next.",
+          `- MUST NOT use <${OPENUI_SECTION_TAG}> for asking the user a question.`,
+          "- The user picks exactly one option \u2014 multi-select is not available.",
+          "- Options must be mutually exclusive. If a valid choice is a combination of other options, include it as a separate option with the combined data.",
+          '- Every option must commit the user to a specific outcome. Do not add an option whose purpose is to let the user describe, specify, or type their own answer. Do not add an option like "Other" or "Something else".',
+          "",
+          "Example (distinct options):",
+          'question: "<your question>"',
+          'options: ["<Option A>", "<Option B>", "<Option C>"]',
+          "",
+          "Example (combined options):",
+          'question: "<your question>"',
+          'options: ["<Option A>", "<Option B>", "<Option A and B \u2014 combined details>"]',
+          "",
+          "Avoid:",
+          'options: ["<Option A>", "<Option B>", "Other"]'
+        ].join("\n"),
+        schema: askUserQuestionInputSchema,
+        handler: () => Promise.resolve(
+          toolResultResponse({
+            text: "This tool requires client-side execution and cannot be run server-side.",
+            isError: true
+          })
+        )
+      })
+    ];
+  }
+};
+function askUserQuestion() {
+  return {
+    systemToolSets: [new AskUserQuestion()]
+  };
+}
+export {
+  AskUserQuestion,
+  askUserQuestion
+};
+//# sourceMappingURL=AskUserQuestion.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/capabilities/builtins/AskUserQuestion.ts"],"sourcesContent":["import { z } from 'zod';\nimport { ClientSideTool } from '../../mcp/ClientSideTool';\nimport { toolResultResponse } from '../../mcp/IMCPServer';\nimport { defineTool, type ToolDefinition } from '../../mcp/LocalToolMCP';\nimport type { AgentCapability } from '../AgentCapability';\nimport { OPENUI_SECTION_TAG } from './OpenUI';\n\nconst ASK_USER_QUESTION_SERVER_ID = 'ask-user-question';\nconst ASK_USER_QUESTION_TOOL_NAME = 'ask_user_question';\n\nconst askUserQuestionInputSchema = z.object({\n  question: z.string().describe('The question to ask the user.'),\n  options: z\n    .array(z.string())\n    .min(0)\n    .max(5)\n    .describe(\n      '0-5 mutually exclusive choices, each mapping to a distinct outcome. A free-text input is always rendered alongside.',\n    ),\n});\n\nexport class AskUserQuestion extends ClientSideTool {\n  readonly name = ASK_USER_QUESTION_SERVER_ID;\n  readonly displayName = 'AskUserQuestion';\n  override readonly tracingEnabled = false;\n\n  protected getTools(): ToolDefinition[] {\n    return [\n      defineTool({\n        name: ASK_USER_QUESTION_TOOL_NAME,\n        description: [\n          'Ask the user a question when clarification or a decision is needed before proceeding. Only ask when the answer meaningfully changes what you do next.',\n          '',\n          'Rules:',\n          '- Provide as many options as the question needs (0-5). When you include options, each must be a genuinely distinct, mutually exclusive outcome that meaningfully changes what you do next.',\n          `- MUST NOT use <${OPENUI_SECTION_TAG}> for asking the user a question.`,\n          '- The user picks exactly one option — multi-select is not available.',\n          '- Options must be mutually exclusive. If a valid choice is a combination of other options, include it as a separate option with the combined data.',\n          '- Every option must commit the user to a specific outcome. Do not add an option whose purpose is to let the user describe, specify, or type their own answer. Do not add an option like \"Other\" or \"Something else\".',\n          '',\n          'Example (distinct options):',\n          'question: \"<your question>\"',\n          'options: [\"<Option A>\", \"<Option B>\", \"<Option C>\"]',\n          '',\n          'Example (combined options):',\n          'question: \"<your question>\"',\n          'options: [\"<Option A>\", \"<Option B>\", \"<Option A and B — combined details>\"]',\n          '',\n          'Avoid:',\n          'options: [\"<Option A>\", \"<Option B>\", \"Other\"]',\n        ].join('\\n'),\n        schema: askUserQuestionInputSchema,\n        handler: () =>\n          Promise.resolve(\n            toolResultResponse({\n              text: 'This tool requires client-side execution and cannot be run server-side.',\n              isError: true,\n            }),\n          ),\n      }),\n    ];\n  }\n}\n\nexport function askUserQuestion(): AgentCapability {\n  return {\n    systemToolSets: [new AskUserQuestion()],\n  };\n}\n"],"mappings":";AAAA,SAAS,SAAS;AAClB,SAAS,sBAAsB;AAC/B,SAAS,0BAA0B;AACnC,SAAS,kBAAuC;AAEhD,SAAS,0BAA0B;AAEnC,IAAM,8BAA8B;AACpC,IAAM,8BAA8B;AAEpC,IAAM,6BAA6B,EAAE,OAAO;AAAA,EAC1C,UAAU,EAAE,OAAO,EAAE,SAAS,+BAA+B;AAAA,EAC7D,SAAS,EACN,MAAM,EAAE,OAAO,CAAC,EAChB,IAAI,CAAC,EACL,IAAI,CAAC,EACL;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAEM,IAAM,kBAAN,cAA8B,eAAe;AAAA,EACzC,OAAO;AAAA,EACP,cAAc;AAAA,EACL,iBAAiB;AAAA,EAEzB,WAA6B;AACrC,WAAO;AAAA,MACL,WAAW;AAAA,QACT,MAAM;AAAA,QACN,aAAa;AAAA,UACX;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA,mBAAmB,kBAAkB;AAAA,UACrC;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF,EAAE,KAAK,IAAI;AAAA,QACX,QAAQ;AAAA,QACR,SAAS,MACP,QAAQ;AAAA,UACN,mBAAmB;AAAA,YACjB,MAAM;AAAA,YACN,SAAS;AAAA,UACX,CAAC;AAAA,QACH;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEO,SAAS,kBAAmC;AACjD,SAAO;AAAA,IACL,gBAAgB,CAAC,IAAI,gBAAgB,CAAC;AAAA,EACxC;AACF;","names":[]}

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

@@ -0,0 +1,23 @@
+import type { ILLM } from '../../llm/ILLM';
+import type { AgentDefinition } from '../../runtime/AgentDefinition';
+import type { AgentCapability } from '../AgentCapability';
+import type { AgentContextProcessorOutput, AgentThreadExecutionContext, PreLLMAgentContextProcessor } from '../AgentContextProcessor';
+export declare const DEFAULT_CONTEXT_COMPACTION_THRESHOLD_TOKENS: number;
+export declare class ContextCompaction implements PreLLMAgentContextProcessor {
+    private modelClient;
+    private compactionThresholdTokens;
+    constructor(input: {
+        modelClient: ILLM;
+        compactionThresholdTokens: number;
+    });
+    processPreLLM(execution: Readonly<AgentThreadExecutionContext>): AsyncGenerator<AgentContextProcessorOutput, void, unknown>;
+}
+export interface ContextCompactionSettings {
+    compactionThresholdTokens?: number | undefined;
+}
+export declare function contextCompaction(options: {
+    definition: AgentDefinition;
+    settings?: ContextCompactionSettings | undefined;
+    compactionThresholdTokens?: number | undefined;
+}): AgentCapability;
+//# sourceMappingURL=ContextCompaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextCompaction.d.ts","sourceRoot":"","sources":["../../../../src/core/capabilities/builtins/ContextCompaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAmB,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,0BAA0B,CAAC;AAElC,eAAO,MAAM,2CAA2C,QAAY,CAAC;AA8JrE,qBAAa,iBAAkB,YAAW,2BAA2B;IACnE,OAAO,CAAC,WAAW,CAAO;IAC1B,OAAO,CAAC,yBAAyB,CAAS;IAE1C,YAAY,KAAK,EAAE;QAAE,WAAW,EAAE,IAAI,CAAC;QAAC,yBAAyB,EAAE,MAAM,CAAA;KAAE,EAG1E;IAEM,aAAa,CAClB,SAAS,EAAE,QAAQ,CAAC,2BAA2B,CAAC,GAC/C,cAAc,CAAC,2BAA2B,EAAE,IAAI,EAAE,OAAO,CAAC,CAkC5D;CACF;AAED,MAAM,WAAW,yBAAyB;IACxC,yBAAyB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACjD,yBAAyB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD,GAAG,eAAe,CAalB"}

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

@@ -0,0 +1,235 @@
+"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/ContextCompaction.ts
+var ContextCompaction_exports = {};
+__export(ContextCompaction_exports, {
+  ContextCompaction: () => ContextCompaction,
+  DEFAULT_CONTEXT_COMPACTION_THRESHOLD_TOKENS: () => DEFAULT_CONTEXT_COMPACTION_THRESHOLD_TOKENS,
+  contextCompaction: () => contextCompaction
+});
+module.exports = __toCommonJS(ContextCompaction_exports);
+var import_schema = require("../../events/schema.js");
+var import_contextUtils = require("../../runtime/contextUtils.js");
+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 = (0, import_contextUtils.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 ((0, import_contextUtils.isInternalSystemMessage)(m)) {
+      continue;
+    }
+    if (!(0, import_contextUtils.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: import_schema.EventType.AGENT_CONTEXT_OVERWRITE,
+      id: (0, import_schema.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
+      })
+    ]
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ContextCompaction,
+  DEFAULT_CONTEXT_COMPACTION_THRESHOLD_TOKENS,
+  contextCompaction
+});
+//# sourceMappingURL=ContextCompaction.js.map

package/dist/core/capabilities/builtins/ContextCompaction.js.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":[]}