@uncaged/workflow-agent-builtin 0.5.0-alpha.5

package/dist/loop.js

@@ -0,0 +1,156 @@
+import { createLogger } from "@uncaged/workflow-util";
+import { chatCompletionWithTools, } from "./llm/index.js";
+import { appendSessionTurn } from "./session.js";
+import { builtinToolsToOpenAi, executeBuiltinTool, getBuiltinTools, } from "./tools/index.js";
+const log = createLogger({ sink: { kind: "stderr" } });
+export const BUILTIN_MAX_TURNS = 30;
+export const BUILTIN_CONTINUE_MAX_TURNS = 5;
+function mapToolCallsForPayload(calls) {
+    return calls.map((call) => ({
+        name: call.name,
+        args: call.arguments,
+    }));
+}
+async function appendTurn(storageRoot, sessionId, payload) {
+    await appendSessionTurn(storageRoot, sessionId, payload);
+}
+export async function executeTurnTools(calls, toolCtx, messages, storageRoot, sessionId) {
+    let turnCount = 0;
+    for (const call of calls) {
+        const result = await executeBuiltinTool(call.name, call.arguments, toolCtx);
+        messages.push({ role: "tool", tool_call_id: call.id, content: result });
+        await appendTurn(storageRoot, sessionId, {
+            role: "tool",
+            content: result,
+            toolCalls: null,
+            reasoning: null,
+        });
+        turnCount += 1;
+    }
+    return turnCount;
+}
+const MAX_NUDGES = 3;
+const DEADLINE_WARNING_TURNS = 3;
+export function shouldInjectDeadlineWarning(turn, maxTurns, alreadyWarned, noTools) {
+    const turnsRemaining = maxTurns - turn;
+    return (!noTools && !alreadyWarned && turnsRemaining > 0 && turnsRemaining <= DEADLINE_WARNING_TURNS);
+}
+export function shouldProcessToolCalls(toolCalls, noTools) {
+    return !noTools && toolCalls !== null && toolCalls.length > 0;
+}
+export function extractFinalText(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg !== undefined &&
+            msg.role === "assistant" &&
+            msg.content !== null &&
+            msg.content.trim() !== "") {
+            return msg.content;
+        }
+    }
+    return "";
+}
+function injectDeadlineWarning(messages, turnsRemaining) {
+    log("4NRXW6KT", `${turnsRemaining} turns remaining, injecting deadline warning`);
+    messages.push({
+        role: "user",
+        content: `⚠️ You have ${turnsRemaining} turns remaining. ` +
+            "Wrap up your work and output the YAML frontmatter starting with `---`. " +
+            "If you cannot finish in time, output frontmatter with `status: failed` and describe what remains.",
+    });
+}
+async function handleTextOnlyTurn(text, messages, storageRoot, sessionId, noTools, turn, maxTurns, currentNudgeCount) {
+    await appendTurn(storageRoot, sessionId, {
+        role: "assistant",
+        content: text,
+        toolCalls: null,
+        reasoning: null,
+    });
+    const turnCount = 1;
+    let nudgeCount = currentNudgeCount;
+    let turnAdjustment = 0;
+    if (shouldNudge({ noTools, text, turn, maxTurns })) {
+        nudgeCount += 1;
+        log("7FXQM2KN", `text-only turn without frontmatter, nudge ${nudgeCount}/${MAX_NUDGES}`);
+        const nudge = "You stopped calling tools but your response does not start with the required `---` YAML frontmatter. " +
+            "Either continue using tools to complete your work, or output your final response starting with `---`.";
+        messages.push({ role: "user", content: nudge });
+        // Nudge doesn't consume turn budget (up to MAX_NUDGES)
+        if (nudgeCount <= MAX_NUDGES) {
+            turnAdjustment = -1;
+        }
+        return { shouldBreak: false, finalText: "", turnCount, nudgeCount, turnAdjustment };
+    }
+    return { shouldBreak: true, finalText: text, turnCount, nudgeCount, turnAdjustment };
+}
+async function handleToolCallTurn(content, toolCalls, messages, storageRoot, sessionId, toolCtx) {
+    await appendTurn(storageRoot, sessionId, {
+        role: "assistant",
+        content,
+        toolCalls: mapToolCallsForPayload(toolCalls),
+        reasoning: null,
+    });
+    let turnCount = 1;
+    // Execute tools
+    turnCount += await executeTurnTools(toolCalls, toolCtx, messages, storageRoot, sessionId);
+    return turnCount;
+}
+export function shouldNudge({ noTools, text, turn, maxTurns }) {
+    return !noTools && !text.trimStart().startsWith("---") && turn < maxTurns - 1;
+}
+async function processLoopIteration(options, messages, openAiTools, turn, nudgeCount) {
+    const response = await chatCompletionWithTools(options.provider, messages, openAiTools.length > 0 ? openAiTools : null);
+    // When noTools is set, ignore any tool_calls the LLM might still return
+    const effectiveToolCalls = options.noTools ? null : (response.toolCalls ?? null);
+    const assistantMessage = {
+        role: "assistant",
+        content: response.content,
+        tool_calls: effectiveToolCalls,
+    };
+    messages.push(assistantMessage);
+    if (!shouldProcessToolCalls(effectiveToolCalls, options.noTools)) {
+        const text = response.content ?? "";
+        const result = await handleTextOnlyTurn(text, messages, options.storageRoot, options.sessionId, options.noTools, turn, options.maxTurns, nudgeCount);
+        return result;
+    }
+    // At this point, effectiveToolCalls is guaranteed to be non-null and non-empty
+    const turnCount = await handleToolCallTurn(response.content ?? "", effectiveToolCalls, messages, options.storageRoot, options.sessionId, options.toolCtx);
+    return {
+        shouldBreak: false,
+        finalText: "",
+        turnCount,
+        nudgeCount,
+        turnAdjustment: 0,
+    };
+}
+/** Agent run loop: LLM ↔ tools until no tool_calls or maxTurns. */
+export async function runBuiltinLoop(options) {
+    const messages = [...options.messages];
+    const openAiTools = options.noTools ? [] : builtinToolsToOpenAi(getBuiltinTools());
+    let finalText = "";
+    let turnCount = 0;
+    let nudgeCount = 0;
+    let deadlineWarned = false;
+    for (let turn = 0; turn < options.maxTurns; turn++) {
+        log("8K2M4N7P", `builtin loop turn ${turn + 1}/${options.maxTurns}`);
+        // Warn agent when approaching turn limit
+        if (shouldInjectDeadlineWarning(turn, options.maxTurns, deadlineWarned, options.noTools)) {
+            deadlineWarned = true;
+            const turnsRemaining = options.maxTurns - turn;
+            injectDeadlineWarning(messages, turnsRemaining);
+        }
+        const result = await processLoopIteration(options, messages, openAiTools, turn, nudgeCount);
+        turnCount += result.turnCount;
+        nudgeCount = result.nudgeCount;
+        turn += result.turnAdjustment;
+        if (result.shouldBreak) {
+            finalText = result.finalText;
+            break;
+        }
+    }
+    if (finalText === "") {
+        finalText = extractFinalText(messages);
+    }
+    return { finalText, messages, turnCount };
+}
+//# sourceMappingURL=loop.js.map

package/dist/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"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"}

package/dist/prompt.d.ts

@@ -0,0 +1,11 @@
+import { type AgentContext } from "@uncaged/workflow-util-agent";
+import type { ChatMessage } from "./llm/index.js";
+/**
+ * Reconstruct multi-turn chat messages from thread history for cache-friendly session resume.
+ *
+ * - system: role prompt + output format (stable prefix)
+ * - For each prior visit of this role: user (edgePrompt + inter-step summary) + assistant (output JSON)
+ * - Final user: current edgePrompt + summary since last visit of this role
+ */
+export declare function buildBuiltinMessages(ctx: AgentContext): ChatMessage[];
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,8BAA8B,CAAC;AAElF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA2ClD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,EAAE,CA8DrE"}

package/dist/prompt.js

@@ -0,0 +1,93 @@
+import { buildRolePrompt } from "@uncaged/workflow-util-agent";
+function formatStep(step, stepNumber) {
+    return [
+        `### Step ${stepNumber}: ${step.role}`,
+        `Output: ${JSON.stringify(step.output)}`,
+        `Agent: ${step.agent}`,
+    ].join("\n");
+}
+function buildStepsSummary(steps, fromIndex, toIndex) {
+    if (fromIndex >= toIndex) {
+        return "";
+    }
+    const lines = ["## What Happened Since Your Last Turn"];
+    for (let i = fromIndex; i < toIndex; i++) {
+        const step = steps[i];
+        if (step === undefined) {
+            continue;
+        }
+        lines.push("");
+        lines.push(formatStep(step, i + 1));
+    }
+    return lines.join("\n");
+}
+function buildUserTurnContent(edgePrompt, summary) {
+    const parts = [];
+    if (edgePrompt !== "") {
+        parts.push(edgePrompt);
+    }
+    if (summary !== "") {
+        if (parts.length > 0) {
+            parts.push("");
+        }
+        parts.push(summary);
+    }
+    return parts.join("\n");
+}
+/**
+ * Reconstruct multi-turn chat messages from thread history for cache-friendly session resume.
+ *
+ * - system: role prompt + output format (stable prefix)
+ * - For each prior visit of this role: user (edgePrompt + inter-step summary) + assistant (output JSON)
+ * - Final user: current edgePrompt + summary since last visit of this role
+ */
+export function buildBuiltinMessages(ctx) {
+    const roleDef = ctx.workflow.roles[ctx.role];
+    const rolePrompt = roleDef !== undefined ? buildRolePrompt(roleDef) : "";
+    const systemParts = [];
+    if (ctx.outputFormatInstruction !== "") {
+        systemParts.push(ctx.outputFormatInstruction, "");
+    }
+    systemParts.push(rolePrompt);
+    systemParts.push("", "## Workflow", "", `Your working directory is: ${process.cwd()}`, "", "You have tools available (read_file, write_file, run_command). " +
+        "Use them to complete your task — read files, run commands, make changes as needed. " +
+        "Your task is described in the user message below — do NOT use uwf or workflow CLI commands to discover your task. " +
+        "When you are done, output your final response with the YAML frontmatter block as specified above. " +
+        "Do NOT output the frontmatter until you have completed all necessary work. " +
+        "If you are running low on turns and cannot finish, output the frontmatter with `status: failed` and explain what remains in the body. " +
+        "CRITICAL: Your final output MUST start with the `---` fence on the very first line — " +
+        "no preamble text, no explanation before it. The parser requires `---` at position 0.");
+    const messages = [{ role: "system", content: systemParts.join("\n") }];
+    const roleVisitIndices = [];
+    for (let i = 0; i < ctx.steps.length; i++) {
+        const step = ctx.steps[i];
+        if (step !== undefined && step.role === ctx.role) {
+            roleVisitIndices.push(i);
+        }
+    }
+    let prevVisitIndex = -1;
+    for (const visitIndex of roleVisitIndices) {
+        const visitStep = ctx.steps[visitIndex];
+        if (visitStep === undefined) {
+            continue;
+        }
+        const summary = buildStepsSummary(ctx.steps, prevVisitIndex + 1, visitIndex);
+        messages.push({
+            role: "user",
+            content: buildUserTurnContent(visitStep.edgePrompt, summary),
+        });
+        messages.push({
+            role: "assistant",
+            content: JSON.stringify(visitStep.output),
+            tool_calls: null,
+        });
+        prevVisitIndex = visitIndex;
+    }
+    const finalSummary = buildStepsSummary(ctx.steps, prevVisitIndex + 1, ctx.steps.length);
+    messages.push({
+        role: "user",
+        content: buildUserTurnContent(ctx.edgePrompt, finalSummary),
+    });
+    return messages;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"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"}

package/dist/schemas.d.ts

@@ -0,0 +1,4 @@
+import type { JSONSchema } from "@uncaged/json-cas";
+export declare const BUILTIN_TURN_SCHEMA: JSONSchema;
+export declare const BUILTIN_DETAIL_SCHEMA: JSONSchema;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAYpD,eAAO,MAAM,mBAAmB,EAAE,UAejC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,UAenC,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,42 @@
+const BUILTIN_TOOL_CALL_SCHEMA = {
+    type: "object",
+    required: ["name", "args"],
+    properties: {
+        name: { type: "string" },
+        args: { type: "string" },
+    },
+    additionalProperties: false,
+};
+export const BUILTIN_TURN_SCHEMA = {
+    title: "builtin-turn",
+    type: "object",
+    required: ["role", "content"],
+    properties: {
+        role: { type: "string", enum: ["assistant", "tool"] },
+        content: { type: "string" },
+        toolCalls: {
+            anyOf: [{ type: "array", items: BUILTIN_TOOL_CALL_SCHEMA }, { type: "null" }],
+        },
+        reasoning: {
+            anyOf: [{ type: "string" }, { type: "null" }],
+        },
+    },
+    additionalProperties: false,
+};
+export const BUILTIN_DETAIL_SCHEMA = {
+    title: "builtin-detail",
+    type: "object",
+    required: ["sessionId", "model", "duration", "turnCount", "turns"],
+    properties: {
+        sessionId: { type: "string" },
+        model: { type: "string" },
+        duration: { type: "integer" },
+        turnCount: { type: "integer" },
+        turns: {
+            type: "array",
+            items: { type: "string", format: "cas_ref" },
+        },
+    },
+    additionalProperties: false,
+};
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAEA,MAAM,wBAAwB,GAAe;IAC3C,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACzB;IACD,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,KAAK,EAAE,cAAc;IACrB,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;IAC7B,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE;QACrD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,SAAS,EAAE;YACT,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,wBAAwB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SAC9E;QACD,SAAS,EAAE;YACT,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SAC9C;KACF;IACD,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAe;IAC/C,KAAK,EAAE,gBAAgB;IACvB,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC;IAClE,UAAU,EAAE;QACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC7B,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC9B,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE;SAC7C;KACF;IACD,oBAAoB,EAAE,KAAK;CAC5B,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,10 @@
+import type { BuiltinTurnPayload } from "./types.js";
+/** Ensure sessions directory exists. */
+export declare function initSessionDir(storageRoot: string): Promise<void>;
+/** Append a turn to the session jsonl file. */
+export declare function appendSessionTurn(storageRoot: string, sessionId: string, turn: BuiltinTurnPayload): Promise<void>;
+/** Read all turns from session jsonl. Returns empty array if file does not exist. */
+export declare function readSessionTurns(storageRoot: string, sessionId: string): Promise<BuiltinTurnPayload[]>;
+/** Remove session jsonl file (called after detail is persisted to step CAS). */
+export declare function removeSession(storageRoot: string, sessionId: string): Promise<void>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAYrD,wCAAwC;AACxC,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED,+CAA+C;AAC/C,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,qFAAqF;AACrF,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAW/B;AAED,gFAAgF;AAChF,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzF"}

package/dist/session.js

@@ -0,0 +1,45 @@
+import { appendFile, mkdir, readFile, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { createLogger } from "@uncaged/workflow-util";
+const log = createLogger({ sink: { kind: "stderr" } });
+function sessionsDir(storageRoot) {
+    return join(storageRoot, "sessions");
+}
+function sessionFile(storageRoot, sessionId) {
+    return join(sessionsDir(storageRoot), `${sessionId}.jsonl`);
+}
+/** Ensure sessions directory exists. */
+export async function initSessionDir(storageRoot) {
+    await mkdir(sessionsDir(storageRoot), { recursive: true });
+}
+/** Append a turn to the session jsonl file. */
+export async function appendSessionTurn(storageRoot, sessionId, turn) {
+    const line = `${JSON.stringify(turn)}\n`;
+    await appendFile(sessionFile(storageRoot, sessionId), line, "utf-8");
+    log("3XQVN8KR", `session ${sessionId} appended ${turn.role} turn`);
+}
+/** Read all turns from session jsonl. Returns empty array if file does not exist. */
+export async function readSessionTurns(storageRoot, sessionId) {
+    try {
+        const content = await readFile(sessionFile(storageRoot, sessionId), "utf-8");
+        const lines = content
+            .trim()
+            .split("\n")
+            .filter((l) => l.length > 0);
+        return lines.map((l) => JSON.parse(l));
+    }
+    catch {
+        return [];
+    }
+}
+/** Remove session jsonl file (called after detail is persisted to step CAS). */
+export async function removeSession(storageRoot, sessionId) {
+    try {
+        await rm(sessionFile(storageRoot, sessionId));
+        log("7FWDP2MJ", `session ${sessionId} removed`);
+    }
+    catch {
+        // already gone — fine
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAItD,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;AAEvD,SAAS,WAAW,CAAC,WAAmB;IACtC,OAAO,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,WAAW,CAAC,WAAmB,EAAE,SAAiB;IACzD,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,GAAG,SAAS,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,MAAM,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB,EACnB,SAAiB,EACjB,IAAwB;IAExB,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;IACzC,MAAM,UAAU,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACrE,GAAG,CAAC,UAAU,EAAE,WAAW,SAAS,aAAa,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC;AACrE,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,OAAO;aAClB,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAuB,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,SAAiB;IACxE,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;QAC9C,GAAG,CAAC,UAAU,EAAE,WAAW,SAAS,UAAU,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,8 @@
+import type { OpenAiToolDefinition } from "../llm/index.js";
+import type { BuiltinTool, ToolContext } from "./types.js";
+export { resolvePath } from "./path.js";
+export type { BuiltinTool, ToolContext } from "./types.js";
+export declare function getBuiltinTools(): readonly BuiltinTool[];
+export declare function builtinToolsToOpenAi(tools: readonly BuiltinTool[]): OpenAiToolDefinition[];
+export declare function executeBuiltinTool(name: string, argsJson: string, ctx: ToolContext): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAI5D,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI3D,wBAAgB,eAAe,IAAI,SAAS,WAAW,EAAE,CAExD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,oBAAoB,EAAE,CAS1F;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/dist/tools/index.js

@@ -0,0 +1,33 @@
+import { readFileTool } from "./read-file.js";
+import { runCommandTool } from "./run-command.js";
+import { writeFileTool } from "./write-file.js";
+export { resolvePath } from "./path.js";
+const BUILTIN_TOOLS = [readFileTool, writeFileTool, runCommandTool];
+export function getBuiltinTools() {
+    return BUILTIN_TOOLS;
+}
+export function builtinToolsToOpenAi(tools) {
+    return tools.map((tool) => ({
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+        },
+    }));
+}
+export async function executeBuiltinTool(name, argsJson, ctx) {
+    const tool = BUILTIN_TOOLS.find((t) => t.name === name);
+    if (tool === undefined) {
+        return `Error: unknown tool ${name}`;
+    }
+    let args;
+    try {
+        args = JSON.parse(argsJson);
+    }
+    catch {
+        return "Error: tool arguments must be valid JSON";
+    }
+    return tool.execute(args, ctx);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,MAAM,aAAa,GAAkB,CAAC,YAAY,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC;AAEnF,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAA6B;IAChE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAqC;SACvD;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,QAAgB,EAChB,GAAgB;IAEhB,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACxD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,uBAAuB,IAAI,EAAE,CAAC;IACvC,CAAC;IACD,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAY,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,0CAA0C,CAAC;IACpD,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC"}

package/dist/tools/path.d.ts

@@ -0,0 +1,3 @@
+/** Resolve a path relative to the working directory. */
+export declare function resolvePath(cwd: string, inputPath: string): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/tools/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/tools/path.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/tools/path.js

@@ -0,0 +1,6 @@
+import { resolve } from "node:path";
+/** Resolve a path relative to the working directory. */
+export function resolvePath(cwd, inputPath) {
+    return resolve(cwd, inputPath);
+}
+//# sourceMappingURL=path.js.map

package/dist/tools/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/tools/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,SAAiB;IACxD,OAAO,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AACjC,CAAC"}

package/dist/tools/read-file.d.ts

@@ -0,0 +1,3 @@
+import type { BuiltinTool } from "./types.js";
+export declare const readFileTool: BuiltinTool;
+//# sourceMappingURL=read-file.d.ts.map

package/dist/tools/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQ9C,eAAO,MAAM,YAAY,EAAE,WA8B1B,CAAC"}

package/dist/tools/read-file.js

@@ -0,0 +1,39 @@
+import { readFile, stat } from "node:fs/promises";
+import { resolvePath } from "./path.js";
+const MAX_READ_BYTES = 512 * 1024;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export const readFileTool = {
+    name: "read_file",
+    description: "Read a UTF-8 text file from the workspace.",
+    parameters: {
+        type: "object",
+        required: ["path"],
+        properties: {
+            path: { type: "string", description: "Relative or absolute path within the workspace." },
+        },
+        additionalProperties: false,
+    },
+    execute: async (args, ctx) => {
+        if (!isRecord(args) || typeof args.path !== "string") {
+            return "Error: path must be a string";
+        }
+        const resolved = resolvePath(ctx.cwd, args.path);
+        try {
+            const info = await stat(resolved);
+            if (!info.isFile()) {
+                return "Error: not a file";
+            }
+            if (info.size > MAX_READ_BYTES) {
+                return `Error: file exceeds ${MAX_READ_BYTES} byte limit`;
+            }
+            return await readFile(resolved, "utf8");
+        }
+        catch (cause) {
+            const message = cause instanceof Error ? cause.message : String(cause);
+            return `Error: ${message}`;
+        }
+    },
+};
+//# sourceMappingURL=read-file.js.map

package/dist/tools/read-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;AAElC,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,4CAA4C;IACzD,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;SACzF;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,8BAA8B,CAAC;QACxC,CAAC;QACD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBACnB,OAAO,mBAAmB,CAAC;YAC7B,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,GAAG,cAAc,EAAE,CAAC;gBAC/B,OAAO,uBAAuB,cAAc,aAAa,CAAC;YAC5D,CAAC;YACD,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,UAAU,OAAO,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/run-command.d.ts

@@ -0,0 +1,3 @@
+import type { BuiltinTool } from "./types.js";
+export declare const runCommandTool: BuiltinTool;
+//# sourceMappingURL=run-command.d.ts.map

package/dist/tools/run-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../../src/tools/run-command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAsD9C,eAAO,MAAM,cAAc,EAAE,WAsC5B,CAAC"}

package/dist/tools/run-command.js

@@ -0,0 +1,81 @@
+import { spawn } from "node:child_process";
+import { resolvePath } from "./path.js";
+const COMMAND_TIMEOUT_MS = 60_000;
+const MAX_OUTPUT_CHARS = 32_000;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function truncate(text, maxChars) {
+    if (text.length <= maxChars) {
+        return text;
+    }
+    return `${text.slice(0, maxChars)}\n...(truncated)`;
+}
+function runShell(command, cwd) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, {
+            cwd,
+            env: process.env,
+            shell: true,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        const timer = setTimeout(() => {
+            child.kill("SIGTERM");
+        }, COMMAND_TIMEOUT_MS);
+        child.on("error", (cause) => {
+            clearTimeout(timer);
+            const message = cause instanceof Error ? cause.message : String(cause);
+            reject(new Error(message));
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            resolve({ stdout, stderr, code: code ?? 1 });
+        });
+    });
+}
+export const runCommandTool = {
+    name: "run_command",
+    description: "Run a shell command. Output is truncated to 32KB.",
+    parameters: {
+        type: "object",
+        required: ["command"],
+        properties: {
+            command: { type: "string", description: "Shell command to execute." },
+            cwd: {
+                type: "string",
+                description: "Optional working directory relative to workspace root.",
+            },
+        },
+        additionalProperties: false,
+    },
+    execute: async (args, ctx) => {
+        if (!isRecord(args) || typeof args.command !== "string") {
+            return "Error: command must be a string";
+        }
+        let workDir = ctx.cwd;
+        if (args.cwd !== undefined && args.cwd !== null) {
+            if (typeof args.cwd !== "string") {
+                return "Error: cwd must be a string";
+            }
+            workDir = resolvePath(ctx.cwd, args.cwd);
+        }
+        try {
+            const { stdout, stderr, code } = await runShell(args.command, workDir);
+            const out = truncate(`exit_code: ${code}\n--- stdout ---\n${stdout}\n--- stderr ---\n${stderr}`, MAX_OUTPUT_CHARS);
+            return out;
+        }
+        catch (cause) {
+            const message = cause instanceof Error ? cause.message : String(cause);
+            return `Error: ${message}`;
+        }
+    },
+};
+//# sourceMappingURL=run-command.js.map

package/dist/tools/run-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../src/tools/run-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAgB;IAC9C,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC;AACtD,CAAC;AAED,SAAS,QAAQ,CACf,OAAe,EACf,GAAW;IAEX,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE;YAC3B,GAAG;YACH,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAEvB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,mDAAmD;IAChE,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YACrE,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wDAAwD;aACtE;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACxD,OAAO,iCAAiC,CAAC;QAC3C,CAAC;QACD,IAAI,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC;QACtB,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;YAChD,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACjC,OAAO,6BAA6B,CAAC;YACvC,CAAC;YACD,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvE,MAAM,GAAG,GAAG,QAAQ,CAClB,cAAc,IAAI,qBAAqB,MAAM,qBAAqB,MAAM,EAAE,EAC1E,gBAAgB,CACjB,CAAC;YACF,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,UAAU,OAAO,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;CACF,CAAC"}