scai 0.1.178 → 1.0.0

package/dist/agent/runtime/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../src/agent/runtime/progress.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Maps new-agent loop phases into transient spinner text and durable milestone lines.\n *\n * Why this file exists:\n * - spinner text should stay human-facing instead of exposing raw event names\n * - durable console messages should stay curated and separate from runtime records\n * - the state machine should validate status, not choose console wording\n * - one formatter keeps `/agent` progress consistent across success and failure paths\n * - stop actions still need readable normal-mode labels\n */\nimport path from \"path\";\nimport chalk from \"chalk\";\nimport type { AgentActionName, AgentFailureDetails, AgentStep, AgentTransformLoopProgress } from \"../types.js\";\n\ntype ProgressContext = {\n  turnCount: number;\n  maxTurns: number;\n};\n\nfunction withTurnCount(message: string, context: ProgressContext, includeTurn = true): string {\n  if (!includeTurn) return message;\n  return `${message} (turn ${context.turnCount}/${context.maxTurns})`;\n}\n\nfunction describeAction(action: AgentActionName): string {\n  switch (action) {\n    case \"plan\":\n      return \"Planning next steps\";\n    case \"search-db\":\n      return \"Searching indexed files\";\n    case \"search-regex\":\n      return \"Running regex search\";\n    case \"search-list-directory\":\n      return \"Listing directory\";\n    case \"triage-file\":\n      return \"Triaging file\";\n    case \"read-file\":\n      return \"Reading file\";\n    case \"codeTransform\":\n      return \"Transforming file\";\n    case \"cannot-answer\":\n      return \"Reporting inability to answer\";\n    case \"request-user-input\":\n      return \"Requesting user input\";\n    case \"final-answer\":\n      return \"Producing final answer\";\n  }\n}\n\nfunction describeChosenAction(action: AgentActionName): string {\n  switch (action) {\n    case \"plan\":\n      return \"Chose planning.\";\n    case \"search-db\":\n      return \"Chose indexed search.\";\n    case \"search-regex\":\n      return \"Chose regex search.\";\n    case \"search-list-directory\":\n      return \"Chose directory listing.\";\n    case \"triage-file\":\n      return \"Chose file triage.\";\n    case \"read-file\":\n      return \"Chose direct file read.\";\n    case \"codeTransform\":\n      return \"Chose file transform.\";\n    case \"cannot-answer\":\n      return \"Chose inability report.\";\n    case \"request-user-input\":\n      return \"Chose user input request.\";\n    case \"final-answer\":\n      return \"Chose final answer.\";\n  }\n}\n\nexport function formatUnderstandProgress(context: ProgressContext): string {\n  return withTurnCount(\"Understanding request\", context, false);\n}\n\nexport function formatActionChoiceProgress(context: ProgressContext): string {\n  return withTurnCount(\"Choosing next action\", context);\n}\n\nexport function formatStepProgress(step: AgentStep, context: ProgressContext): string {\n  return withTurnCount(describeAction(step.action), context);\n}\n\nexport function formatReplanProgress(context: ProgressContext): string {\n  return withTurnCount(\"Planning next steps\", context);\n}\n\nexport function formatFinalizingProgress(context: ProgressContext): string {\n  return withTurnCount(\"Producing final answer\", context);\n}\n\nexport function formatFailureProgress(details: AgentFailureDetails): string {\n  const parts = [\n    \"Simple agent failed\",\n    details.action ? `action=${details.action}` : \"\",\n    details.stepId ? `step=${details.stepId}` : \"\",\n    `stage=${details.stage}`,\n  ].filter(Boolean);\n  return parts.join(\" | \");\n}\n\nexport function formatUnderstandMilestone(): string {\n  return \"Understanding request.\";\n}\n\nexport function formatChosenActionMilestone(action: AgentActionName): string {\n  return describeChosenAction(action);\n}\n\nexport function formatStepMilestone(step: AgentStep): string {\n  return `${describeAction(step.action)}.`;\n}\n\nexport function formatReplanMilestone(): string {\n  return \"Planning next steps.\";\n}\n\nexport function formatFinalizingMilestone(): string {\n  return \"Producing final answer.\";\n}\n\nfunction formatTransformEditWindow(editIds: string[] | undefined): string {\n  if (!Array.isArray(editIds) || editIds.length === 0) {\n    return \"edits ?\";\n  }\n  const numericIds = editIds\n    .map((editId) => editId.match(/(\\d+)$/)?.[1])\n    .filter((value): value is string => Boolean(value))\n    .map((value) => Number(value));\n  if (numericIds.length === editIds.length) {\n    const sorted = [...numericIds].sort((left, right) => left - right);\n    return sorted[0] === sorted[sorted.length - 1]\n      ? `edit ${sorted[0]}`\n      : `edits ${sorted[0]}-${sorted[sorted.length - 1]}`;\n  }\n  return editIds.length === 1 ? `edit ${editIds[0]}` : `edits ${editIds.join(\",\")}`;\n}\n\nfunction describeTransformLoopStage(stage: AgentTransformLoopProgress[\"stage\"]): string {\n  switch (stage) {\n    case \"started\":\n      return \"starting\";\n    case \"planning\":\n      return \"planning\";\n    case \"applying\":\n      return \"applying\";\n    case \"validating\":\n      return \"validating\";\n    case \"retrying\":\n      return \"retrying\";\n    case \"failed\":\n      return \"failed\";\n    case \"completed\":\n      return \"completed\";\n  }\n}\n\nexport function formatTransformLoopProgress(progress: AgentTransformLoopProgress): string {\n  const fileName = path.basename(progress.filePath);\n  const batchText = typeof progress.batchNumber === \"number\" && typeof progress.batchCount === \"number\"\n    ? `batch ${progress.batchNumber}/${progress.batchCount}`\n    : \"batch ?\";\n  const retryText = typeof progress.retryCount === \"number\" && progress.retryCount > 0\n    ? ` | retry ${progress.retryCount}`\n    : \"\";\n  return [\n    fileName,\n    batchText,\n    formatTransformEditWindow(progress.editIds),\n    describeTransformLoopStage(progress.stage),\n  ].join(\" | \") + retryText;\n}\n\nexport function formatTransformStartMilestone(filePath: string): string {\n  return `Transform file: ${path.basename(filePath)}`;\n}\n\nexport function formatTransformWarningMilestone(warning: string): string {\n  return chalk.yellow(warning);\n}\n\nexport function formatTransformRetryMilestone(progress: AgentTransformLoopProgress): string {\n  const fileName = path.basename(progress.filePath);\n  const batchText = typeof progress.batchNumber === \"number\" && typeof progress.batchCount === \"number\"\n    ? `batch ${progress.batchNumber}/${progress.batchCount}`\n    : \"current batch\";\n  return `Retry ${batchText} for ${fileName}.`;\n}\n\nexport function formatTransformFailureMilestone(progress: AgentTransformLoopProgress): string {\n  const fileName = path.basename(progress.filePath);\n  const batchText = typeof progress.batchNumber === \"number\" && typeof progress.batchCount === \"number\"\n    ? ` at batch ${progress.batchNumber}/${progress.batchCount}`\n    : \"\";\n  const reason = progress.reason ? ` Reason: ${progress.reason}` : \"\";\n  return `Transform failed for ${fileName}${batchText}.${reason}`;\n}\n\nexport function formatTransformCompletionMilestone(progress: AgentTransformLoopProgress): string {\n  return `Transform completed for ${path.basename(progress.filePath)}.`;\n}\n"]}

package/dist/agent/runtime/runAgentLoop.js

@@ -0,0 +1,402 @@
+import { generate } from "../../lib/generate.js";
+import { buildActions, sanitizeDecision } from "../actions/index.js";
+import { resolvePolicyState } from "../policy/index.js";
+import { buildTools } from "../tools/index.js";
+import { getErrorMessage, getErrorTrace, logAgentError, logAgentLlmFailure, logAgentLlmInput, logAgentLlmOutput, logAgentStepInput, logAgentStepOutput, logAgentValidationFailure, recordAgentEvent, } from "../logging/index.js";
+import { buildActionChoicePacket, renderActionChoicePrompt } from "../prompting/index.js";
+import { formatActionChoiceProgress, formatChosenActionMilestone, formatFailureProgress, formatReplanProgress, formatReplanMilestone, formatStepProgress, formatStepMilestone, formatUnderstandProgress, formatUnderstandMilestone, } from "./progress.js";
+import { validateActionArgs } from "../actions/schemas.js";
+import { createRuntimeStep, finishStep, finalizeTask, requestReplan, startStep } from "../state/index.js";
+import { runUnderstand } from "./understand.js";
+import { refreshAgentTargetClassification } from "../policy/targetClassification.js";
+import { applyFinalTaskStatus, resolveForcedEndDecision } from "../finalization/index.js";
+import { AgentRuntimeError } from "../types.js";
+import { applyUnderstandResult, recordStepCreated, recordStepFailure, recordStepFinished, recordStepStarted, recordTaskFinalized, } from "./lifecycle.js";
+import { emitAgentLlmTimingMessage, emitAgentStepStateMessage, emitAgentTaskStateMessage, emitConsoleMessage, shouldShowConsoleTiming, } from "../../utils/consolePresentation.js";
+import { nowLocalIso } from "../../utils/time.js";
+import { parseStructuredJson } from "../structuredOutput/index.js";
+function shouldContinue(memory) {
+    return memory.task.status === "active" && memory.task.turnCount < memory.task.maxTurns;
+}
+function emitSimpleAgentMilestone(ui, message) {
+    if (shouldShowConsoleTiming()) {
+        return;
+    }
+    emitConsoleMessage(ui, message);
+}
+function emitStepCreatedState(ui, step) {
+    emitAgentStepStateMessage(ui, {
+        stepId: step.id,
+        action: step.action,
+        from: "created",
+        to: step.status,
+    });
+}
+function emitStepTransitionState(ui, step, from, durationMs) {
+    emitAgentStepStateMessage(ui, {
+        stepId: step.id,
+        action: step.action,
+        from,
+        to: step.status,
+        ...(typeof durationMs === "number" ? { durationMs } : {}),
+    });
+}
+function emitTaskTransitionState(ui, from, to, reason) {
+    emitAgentTaskStateMessage(ui, {
+        from,
+        to,
+        ...(reason ? { reason } : {}),
+    });
+}
+function computeStepDurationMs(step) {
+    if (!step.startedAt || !step.completedAt) {
+        return undefined;
+    }
+    const startedAtMs = Date.parse(step.startedAt);
+    const completedAtMs = Date.parse(step.completedAt);
+    if (!Number.isFinite(startedAtMs) || !Number.isFinite(completedAtMs)) {
+        return undefined;
+    }
+    return Math.max(0, completedAtMs - startedAtMs);
+}
+async function chooseNextAction(memory, policy, ui) {
+    const legalActions = policy.allowedActions;
+    if (legalActions.length === 1) {
+        return sanitizeDecision({
+            action: legalActions[0],
+            args: policy.decision.args ?? {},
+            reason: "Only one legal action was available.",
+        }, legalActions, memory);
+    }
+    const packet = buildActionChoicePacket(memory, policy);
+    const defaultDecision = policy.decision.stop && legalActions.includes(policy.decision.stop)
+        ? { action: policy.decision.stop, args: {}, reason: policy.decision.reason }
+        : policy.decision.nextAction && legalActions.includes(policy.decision.nextAction)
+            ? (() => {
+                return {
+                    action: policy.decision.nextAction,
+                    args: policy.decision.args ?? {},
+                    reason: policy.decision.reason,
+                };
+            })()
+            : policy.shouldAskUser && legalActions.includes("request-user-input")
+                ? { action: "request-user-input", args: {}, reason: "The user needs to choose one ambiguous in-repo target before reading further." }
+                : { action: legalActions[0], args: {}, reason: "Take the first legal action." };
+    logAgentLlmInput(memory, "agent.action-choice", packet, undefined, nowLocalIso());
+    try {
+        const response = await generate({ query: memory.task.initialQuery, content: renderActionChoicePrompt(packet) }, {
+            caller: "agent.action-choice",
+            inputContext: packet,
+        });
+        const parsed = parseStructuredJson(String(response?.data ?? ""), { fallback: defaultDecision });
+        const decision = sanitizeDecision(parsed, legalActions, memory);
+        const forcedDecision = policy.decision.stop
+            ? sanitizeDecision({ action: policy.decision.stop, args: {}, reason: policy.decision.reason }, legalActions, memory)
+            : policy.decision.nextAction && decision.action !== policy.decision.nextAction
+                ? sanitizeDecision(defaultDecision, legalActions, memory)
+                : null;
+        const finalDecision = forcedDecision ?? decision;
+        logAgentLlmOutput(memory, "agent.action-choice", {
+            decision: finalDecision,
+            review: parsed.review,
+            legalActions,
+        }, undefined, response?.trace);
+        if (ui) {
+            emitAgentLlmTimingMessage(ui, "agent.action-choice", response?.trace);
+        }
+        return finalDecision;
+    }
+    catch (error) {
+        const details = {
+            stage: "action-choice",
+            message: getErrorMessage(error),
+        };
+        logAgentLlmFailure(memory, "agent.action-choice", details, getErrorTrace(error));
+        throw new AgentRuntimeError(details, error);
+    }
+}
+function evaluateStep(step, result) {
+    if (!result.ok) {
+        if (step.action === "codeTransform") {
+            return {
+                stepStatus: "blocked",
+                summary: result.summary,
+                needsReplan: false,
+                taskStatus: "blocked",
+                stopReason: "transform-failed",
+            };
+        }
+        return {
+            stepStatus: "failed",
+            summary: result.summary,
+            needsReplan: false,
+        };
+    }
+    if (step.action === "final-answer") {
+        return {
+            stepStatus: "done",
+            summary: "Task completed with a final answer.",
+            needsReplan: false,
+            taskStatus: "done",
+            stopReason: "completed",
+        };
+    }
+    if (step.action === "plan") {
+        return {
+            stepStatus: "done",
+            summary: result.summary,
+            needsReplan: false,
+        };
+    }
+    if (step.action === "request-user-input") {
+        return {
+            stepStatus: "done",
+            summary: result.summary,
+            needsReplan: false,
+            taskStatus: "waiting",
+            stopReason: "need-user-input",
+        };
+    }
+    if (step.action === "codeTransform") {
+        return {
+            stepStatus: "done",
+            summary: result.summary,
+            needsReplan: false,
+            taskStatus: "done",
+            stopReason: "completed",
+        };
+    }
+    return {
+        stepStatus: "done",
+        summary: result.summary,
+        needsReplan: false,
+    };
+}
+function runUnderstandPhase(memory, ui) {
+    ui.update(formatUnderstandProgress(memory.task));
+    emitSimpleAgentMilestone(ui, formatUnderstandMilestone());
+    return runUnderstand(memory, ui).then((understand) => {
+        applyUnderstandResult(memory, understand);
+        refreshAgentTargetClassification(memory);
+    });
+}
+async function getOrCreateNextStep(memory, ui) {
+    const existingStep = memory.steps.find((candidate) => candidate.status === "pending");
+    if (existingStep) {
+        return existingStep;
+    }
+    ui.update(formatActionChoiceProgress(memory.task));
+    const policy = resolvePolicyState(memory);
+    const decision = await chooseNextAction(memory, policy, ui);
+    emitSimpleAgentMilestone(ui, formatChosenActionMilestone(decision.action));
+    const step = createRuntimeStep(memory, decision.action, decision.reason, decision.args);
+    recordStepCreated(memory, step);
+    emitStepCreatedState(ui, step);
+    return step;
+}
+function requestReplanIfNeeded(memory, reason, ui) {
+    const replanStep = requestReplan(memory);
+    if (!replanStep) {
+        return false;
+    }
+    recordAgentEvent(memory, "replan-requested", { reason });
+    recordStepCreated(memory, replanStep);
+    if (ui) {
+        emitStepCreatedState(ui, replanStep);
+    }
+    if (ui) {
+        ui.update(formatReplanProgress(memory.task));
+        emitSimpleAgentMilestone(ui, formatReplanMilestone());
+    }
+    return true;
+}
+function validateOrReplanStep(memory, step, ui, actions) {
+    ui.update(formatStepProgress(step, memory.task));
+    emitSimpleAgentMilestone(ui, formatStepMilestone(step));
+    const spec = actions[step.action];
+    logAgentStepInput(memory, step);
+    const errors = validateActionArgs(spec, step.args);
+    if (errors.length === 0) {
+        return { kind: "run-step", spec };
+    }
+    finishStep(memory, step, "blocked", `Invalid args for ${step.action}: ${errors.join(", ")}`);
+    logAgentValidationFailure(memory, step, errors);
+    logAgentStepOutput(memory, step, `Validation failed for ${step.action}.`, {
+        action: step.action,
+        args: step.args,
+        errors,
+    });
+    requestReplanIfNeeded(memory, step.resultSummary ?? `Invalid args for ${step.action}.`, ui);
+    return { kind: "continue" };
+}
+async function executeStepWithUi(memory, step, spec, ui) {
+    const fromStatus = step.status;
+    startStep(memory, step);
+    emitStepTransitionState(ui, step, fromStatus);
+    recordStepStarted(memory, step);
+    const result = await spec.run(memory, step.args);
+    memory.artifacts.actionResults[step.id] = result.output ?? null;
+    return result;
+}
+function applyEvaluation(memory, step, evaluation) {
+    finishStep(memory, step, evaluation.stepStatus, evaluation.summary);
+    if (evaluation.taskStatus) {
+        return {
+            kind: "stop",
+            decision: {
+                kind: "finalize",
+                taskStatus: evaluation.taskStatus,
+                stopReason: evaluation.stopReason ?? "completed",
+            },
+        };
+    }
+    return { kind: "continue" };
+}
+function applyStepOutcome(memory, step, result, ui) {
+    const evaluation = evaluateStep(step, result);
+    const fromStatus = step.status;
+    const outcome = applyEvaluation(memory, step, evaluation);
+    emitStepTransitionState(ui, step, fromStatus, computeStepDurationMs(step));
+    recordStepFinished(memory, step, evaluation.summary, {
+        action: step.action,
+        result: {
+            ok: result.ok,
+            summary: result.summary,
+            output: result.output ?? null,
+        },
+        evaluation,
+    });
+    return outcome;
+}
+function resolveEndDecision(memory) {
+    return resolveForcedEndDecision(memory);
+}
+function resolvePendingEndStep(memory, decision, ui) {
+    if (decision.kind !== "run-action") {
+        throw new Error("resolvePendingEndStep only supports run-action decisions.");
+    }
+    const pendingStep = memory.steps.find((step) => step.status === "pending" && step.action === decision.action);
+    if (pendingStep) {
+        return pendingStep;
+    }
+    const step = createRuntimeStep(memory, decision.action, decision.purpose, {}, decision.expectedEvidence);
+    recordStepCreated(memory, step);
+    emitStepCreatedState(ui, step);
+    return step;
+}
+function finalizeAfterEndAction(memory, result, decision) {
+    applyFinalTaskStatus(memory, result, decision);
+}
+async function finishRun(memory, ui, actions, decision) {
+    if (memory.task.status !== "active") {
+        recordTaskFinalized(memory);
+        return;
+    }
+    if (decision.kind === "finalize") {
+        const fromStatus = memory.task.status;
+        finalizeTask(memory, decision.taskStatus, decision.stopReason);
+        emitTaskTransitionState(ui, fromStatus, memory.task.status, decision.stopReason);
+        recordTaskFinalized(memory);
+        return;
+    }
+    const step = resolvePendingEndStep(memory, decision, ui);
+    const gate = validateOrReplanStep(memory, step, ui, actions);
+    if (gate.kind === "continue") {
+        const fromStatus = memory.task.status;
+        finalizeTask(memory, "blocked", decision.stopReason);
+        emitTaskTransitionState(ui, fromStatus, memory.task.status, decision.stopReason);
+    }
+    else {
+        const result = await executeStepWithUi(memory, step, gate.spec, ui);
+        const fromStatus = step.status;
+        finishStep(memory, step, result.ok ? "done" : "blocked", result.summary);
+        emitStepTransitionState(ui, step, fromStatus, computeStepDurationMs(step));
+        recordStepFinished(memory, step, result.summary, {
+            action: step.action,
+            result: {
+                ok: result.ok,
+                summary: result.summary,
+                output: result.output ?? null,
+            },
+            endDecision: decision,
+        });
+        const taskStatusBefore = memory.task.status;
+        finalizeAfterEndAction(memory, result, decision);
+        emitTaskTransitionState(ui, taskStatusBefore, memory.task.status, memory.task.stopReason);
+    }
+    recordTaskFinalized(memory);
+}
+function buildFailureDetails(memory, activeStep, failureStage, error, ui) {
+    const details = error instanceof AgentRuntimeError
+        ? error.details
+        : {
+            stage: failureStage,
+            message: error instanceof Error ? error.message : String(error),
+            stepId: activeStep?.id,
+            action: activeStep?.action,
+        };
+    if (activeStep && activeStep.status === "running") {
+        const fromStatus = activeStep.status;
+        finishStep(memory, activeStep, "failed", details.message);
+        emitStepTransitionState(ui, activeStep, fromStatus, computeStepDurationMs(activeStep));
+        recordStepFailure(memory, activeStep, details.message, details.stage);
+    }
+    if (memory.task.status === "active" || memory.task.status === "waiting") {
+        const fromStatus = memory.task.status;
+        finalizeTask(memory, "failed", details.stage);
+        emitTaskTransitionState(ui, fromStatus, memory.task.status, details.stage);
+    }
+    recordAgentEvent(memory, "task-failed", {
+        stage: details.stage,
+        message: details.message,
+        action: details.action ?? null,
+        stepId: details.stepId ?? null,
+        status: "failed",
+    }, details.stepId);
+    logAgentError(memory, details, {
+        currentStepId: memory.task.currentStepId ?? null,
+        turnCount: memory.task.turnCount,
+    });
+    recordTaskFinalized(memory);
+    return error instanceof AgentRuntimeError ? error : new AgentRuntimeError(details, error);
+}
+export async function runAgentLoop(memory, ui) {
+    const tools = buildTools();
+    const actions = buildActions(tools, ui);
+    let activeStep;
+    let failureStage = "understand";
+    try {
+        await runUnderstandPhase(memory, ui);
+        while (shouldContinue(memory)) {
+            memory.task.turnCount += 1;
+            failureStage = "action-choice";
+            const step = await getOrCreateNextStep(memory, ui);
+            activeStep = step;
+            const gate = validateOrReplanStep(memory, step, ui, actions);
+            if (gate.kind === "continue") {
+                activeStep = undefined;
+                continue;
+            }
+            failureStage = "step-execution";
+            const result = await executeStepWithUi(memory, step, gate.spec, ui);
+            refreshAgentTargetClassification(memory);
+            const outcome = applyStepOutcome(memory, step, result, ui);
+            activeStep = undefined;
+            if (outcome.kind === "stop") {
+                await finishRun(memory, ui, actions, outcome.decision);
+                return;
+            }
+        }
+        if (memory.task.status === "active") {
+            await finishRun(memory, ui, actions, resolveEndDecision(memory));
+            return;
+        }
+        recordTaskFinalized(memory);
+    }
+    catch (error) {
+        const runtimeError = buildFailureDetails(memory, activeStep, failureStage, error, ui);
+        ui.update(formatFailureProgress(runtimeError.details));
+        throw runtimeError;
+    }
+}
+//# sourceMappingURL=runAgentLoop.js.map

package/dist/agent/runtime/runAgentLoop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runAgentLoop.js","sourceRoot":"","sources":["../../../src/agent/runtime/runAgentLoop.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Runs the new simple agent loop on top of `memory`.\n *\n * Why this file exists:\n * - the new runtime should keep one small explicit loop\n * - loop control and evaluation should stay easy to trace\n * - prompts, tools, and state creation should live elsewhere\n * - live shell progress should stay readable without exposing raw log records\n * - end-of-run work should go through the same explicit state flow as normal steps\n * - dev-mode state lines should describe the real state machine transitions\n * - transform stays one outer runtime action even though the owner batches internally\n */\nimport type { AgentUI } from \"../../types.js\";\nimport { generate } from \"../../lib/generate.js\";\nimport { buildActions, sanitizeDecision } from \"../actions/index.js\";\nimport { resolveNextReadTarget, resolveNextTriageTarget, resolvePolicyState, resolvePreferredReadAction, type AgentPolicyState } from \"../policy/index.js\";\nimport { buildTools } from \"../tools/index.js\";\nimport {\n  getErrorMessage,\n  getErrorTrace,\n  logAgentError,\n  logAgentLlmFailure,\n  logAgentLlmInput,\n  logAgentLlmOutput,\n  logAgentStepInput,\n  logAgentStepOutput,\n  logAgentValidationFailure,\n  recordAgentArtifact,\n  recordAgentEvent,\n} from \"../logging/index.js\";\nimport { buildActionChoicePacket, renderActionChoicePrompt } from \"../prompting/index.js\";\nimport {\n  formatActionChoiceProgress,\n  formatChosenActionMilestone,\n  formatFailureProgress,\n  formatReplanProgress,\n  formatReplanMilestone,\n  formatStepProgress,\n  formatStepMilestone,\n  formatUnderstandProgress,\n  formatUnderstandMilestone,\n} from \"./progress.js\";\nimport { validateActionArgs } from \"../actions/schemas.js\";\nimport { createRuntimeStep, finishStep, finalizeTask, requestReplan, startStep } from \"../state/index.js\";\nimport { runUnderstand } from \"./understand.js\";\nimport { refreshAgentTargetClassification } from \"../policy/targetClassification.js\";\nimport { applyFinalTaskStatus, resolveForcedEndDecision, type RuntimeEndDecision } from \"../finalization/index.js\";\nimport { AgentRuntimeError, type ActionResult, type AgentActionName, type AgentActionSpec, type AgentDecision, type AgentEvaluation, type AgentMemory, type AgentStep, type AgentTaskStatus } from \"../types.js\";\nimport {\n  applyUnderstandResult,\n  recordStepCreated,\n  recordStepFailure,\n  recordStepFinished,\n  recordStepStarted,\n  recordTaskFinalized,\n} from \"./lifecycle.js\";\nimport {\n  emitAgentLlmTimingMessage,\n  emitAgentStepStateMessage,\n  emitAgentTaskStateMessage,\n  emitConsoleMessage,\n  shouldShowConsoleTiming,\n} from \"../../utils/consolePresentation.js\";\nimport { nowLocalIso } from \"../../utils/time.js\";\nimport { parseStructuredJson } from \"../structuredOutput/index.js\";\n\ntype AgentActions = Record<AgentActionName, AgentActionSpec>;\n\ntype StepGateDecision =\n  | { kind: \"continue\" }\n  | { kind: \"run-step\"; spec: AgentActionSpec };\n\ntype EndDecision = RuntimeEndDecision;\n\ntype StepOutcomeDecision =\n  | { kind: \"continue\" }\n  | { kind: \"stop\"; decision: EndDecision };\n\nfunction shouldContinue(memory: AgentMemory): boolean {\n  return memory.task.status === \"active\" && memory.task.turnCount < memory.task.maxTurns;\n}\n\nfunction emitSimpleAgentMilestone(ui: AgentUI, message: string): void {\n  if (shouldShowConsoleTiming()) {\n    return;\n  }\n  emitConsoleMessage(ui, message);\n}\n\nfunction emitStepCreatedState(ui: AgentUI, step: AgentStep): void {\n  emitAgentStepStateMessage(ui, {\n    stepId: step.id,\n    action: step.action,\n    from: \"created\",\n    to: step.status,\n  });\n}\n\nfunction emitStepTransitionState(ui: AgentUI, step: AgentStep, from: string, durationMs?: number): void {\n  emitAgentStepStateMessage(ui, {\n    stepId: step.id,\n    action: step.action,\n    from,\n    to: step.status,\n    ...(typeof durationMs === \"number\" ? { durationMs } : {}),\n  });\n}\n\nfunction emitTaskTransitionState(\n  ui: AgentUI,\n  from: AgentTaskStatus,\n  to: AgentTaskStatus,\n  reason?: string\n): void {\n  emitAgentTaskStateMessage(ui, {\n    from,\n    to,\n    ...(reason ? { reason } : {}),\n  });\n}\n\nfunction computeStepDurationMs(step: AgentStep): number | undefined {\n  if (!step.startedAt || !step.completedAt) {\n    return undefined;\n  }\n  const startedAtMs = Date.parse(step.startedAt);\n  const completedAtMs = Date.parse(step.completedAt);\n  if (!Number.isFinite(startedAtMs) || !Number.isFinite(completedAtMs)) {\n    return undefined;\n  }\n  return Math.max(0, completedAtMs - startedAtMs);\n}\n\nasync function chooseNextAction(memory: AgentMemory, policy: AgentPolicyState, ui?: AgentUI): Promise<AgentDecision> {\n  const legalActions = policy.allowedActions;\n  if (legalActions.length === 1) {\n    return sanitizeDecision({\n      action: legalActions[0],\n      args: policy.decision.args ?? {},\n      reason: \"Only one legal action was available.\",\n    }, legalActions, memory);\n  }\n\n  const packet = buildActionChoicePacket(memory, policy);\n  const defaultDecision: AgentDecision = policy.decision.stop && legalActions.includes(policy.decision.stop)\n    ? { action: policy.decision.stop, args: {}, reason: policy.decision.reason }\n    : policy.decision.nextAction && legalActions.includes(policy.decision.nextAction)\n      ? (() => {\n          return {\n            action: policy.decision.nextAction,\n            args: policy.decision.args ?? {},\n            reason: policy.decision.reason,\n          };\n        })()\n      : policy.shouldAskUser && legalActions.includes(\"request-user-input\")\n      ? { action: \"request-user-input\", args: {}, reason: \"The user needs to choose one ambiguous in-repo target before reading further.\" }\n      : { action: legalActions[0], args: {}, reason: \"Take the first legal action.\" };\n  logAgentLlmInput(memory, \"agent.action-choice\", packet, undefined, nowLocalIso());\n  try {\n    const response = await generate({ query: memory.task.initialQuery, content: renderActionChoicePrompt(packet) }, {\n      caller: \"agent.action-choice\",\n      inputContext: packet,\n    });\n    const parsed = parseStructuredJson<Partial<AgentDecision> & { review?: Record<string, unknown> }>(\n      String(response?.data ?? \"\"),\n      { fallback: defaultDecision }\n    );\n    const decision = sanitizeDecision(parsed, legalActions, memory);\n    const forcedDecision = policy.decision.stop\n      ? sanitizeDecision({ action: policy.decision.stop, args: {}, reason: policy.decision.reason }, legalActions, memory)\n      : policy.decision.nextAction && decision.action !== policy.decision.nextAction\n        ? sanitizeDecision(defaultDecision, legalActions, memory)\n        : null;\n    const finalDecision = forcedDecision ?? decision;\n    logAgentLlmOutput(memory, \"agent.action-choice\", {\n      decision: finalDecision,\n      review: parsed.review,\n      legalActions,\n    }, undefined, response?.trace);\n    if (ui) {\n      emitAgentLlmTimingMessage(ui, \"agent.action-choice\", response?.trace);\n    }\n    return finalDecision;\n  } catch (error) {\n    const details = {\n      stage: \"action-choice\",\n      message: getErrorMessage(error),\n    };\n    logAgentLlmFailure(memory, \"agent.action-choice\", details, getErrorTrace(error));\n    throw new AgentRuntimeError(details, error);\n  }\n}\n\nfunction evaluateStep(step: AgentStep, result: ActionResult): AgentEvaluation {\n  if (!result.ok) {\n    if (step.action === \"codeTransform\") {\n      return {\n        stepStatus: \"blocked\",\n        summary: result.summary,\n        needsReplan: false,\n        taskStatus: \"blocked\",\n        stopReason: \"transform-failed\",\n      };\n    }\n    return {\n      stepStatus: \"failed\",\n      summary: result.summary,\n      needsReplan: false,\n    };\n  }\n\n  if (step.action === \"final-answer\") {\n    return {\n      stepStatus: \"done\",\n      summary: \"Task completed with a final answer.\",\n      needsReplan: false,\n      taskStatus: \"done\",\n      stopReason: \"completed\",\n    };\n  }\n\n  if (step.action === \"plan\") {\n    return {\n      stepStatus: \"done\",\n      summary: result.summary,\n      needsReplan: false,\n    };\n  }\n\n  if (step.action === \"request-user-input\") {\n    return {\n      stepStatus: \"done\",\n      summary: result.summary,\n      needsReplan: false,\n      taskStatus: \"waiting\",\n      stopReason: \"need-user-input\",\n    };\n  }\n\n  if (step.action === \"codeTransform\") {\n    return {\n      stepStatus: \"done\",\n      summary: result.summary,\n      needsReplan: false,\n      taskStatus: \"done\",\n      stopReason: \"completed\",\n    };\n  }\n\n  return {\n    stepStatus: \"done\",\n    summary: result.summary,\n    needsReplan: false,\n  };\n}\n\nfunction runUnderstandPhase(memory: AgentMemory, ui: AgentUI): Promise<void> {\n  ui.update(formatUnderstandProgress(memory.task));\n  emitSimpleAgentMilestone(ui, formatUnderstandMilestone());\n  return runUnderstand(memory, ui).then((understand) => {\n    applyUnderstandResult(memory, understand);\n    refreshAgentTargetClassification(memory);\n  });\n}\n\nasync function getOrCreateNextStep(memory: AgentMemory, ui: AgentUI): Promise<AgentStep> {\n  const existingStep = memory.steps.find((candidate) => candidate.status === \"pending\");\n  if (existingStep) {\n    return existingStep;\n  }\n\n  ui.update(formatActionChoiceProgress(memory.task));\n  const policy = resolvePolicyState(memory);\n  const decision = await chooseNextAction(memory, policy, ui);\n  emitSimpleAgentMilestone(ui, formatChosenActionMilestone(decision.action));\n  const step = createRuntimeStep(memory, decision.action, decision.reason, decision.args);\n  recordStepCreated(memory, step);\n  emitStepCreatedState(ui, step);\n  return step;\n}\n\nfunction requestReplanIfNeeded(memory: AgentMemory, reason: string, ui?: AgentUI): boolean {\n  const replanStep = requestReplan(memory);\n  if (!replanStep) {\n    return false;\n  }\n  recordAgentEvent(memory, \"replan-requested\", { reason });\n  recordStepCreated(memory, replanStep);\n  if (ui) {\n    emitStepCreatedState(ui, replanStep);\n  }\n  if (ui) {\n    ui.update(formatReplanProgress(memory.task));\n    emitSimpleAgentMilestone(ui, formatReplanMilestone());\n  }\n  return true;\n}\n\nfunction validateOrReplanStep(\n  memory: AgentMemory,\n  step: AgentStep,\n  ui: AgentUI,\n  actions: AgentActions\n): StepGateDecision {\n  ui.update(formatStepProgress(step, memory.task));\n  emitSimpleAgentMilestone(ui, formatStepMilestone(step));\n\n  const spec = actions[step.action];\n  logAgentStepInput(memory, step);\n  const errors = validateActionArgs(spec, step.args);\n  if (errors.length === 0) {\n    return { kind: \"run-step\", spec };\n  }\n\n  finishStep(memory, step, \"blocked\", `Invalid args for ${step.action}: ${errors.join(\", \")}`);\n  logAgentValidationFailure(memory, step, errors);\n  logAgentStepOutput(memory, step, `Validation failed for ${step.action}.`, {\n    action: step.action,\n    args: step.args,\n    errors,\n  });\n  requestReplanIfNeeded(memory, step.resultSummary ?? `Invalid args for ${step.action}.`, ui);\n  return { kind: \"continue\" };\n}\n\nasync function executeStepWithUi(\n  memory: AgentMemory,\n  step: AgentStep,\n  spec: AgentActionSpec,\n  ui: AgentUI\n): Promise<ActionResult> {\n  const fromStatus = step.status;\n  startStep(memory, step);\n  emitStepTransitionState(ui, step, fromStatus);\n  recordStepStarted(memory, step);\n\n  const result = await spec.run(memory, step.args);\n  memory.artifacts.actionResults[step.id] = result.output ?? null;\n  return result;\n}\n\nfunction applyEvaluation(memory: AgentMemory, step: AgentStep, evaluation: AgentEvaluation): StepOutcomeDecision {\n  finishStep(memory, step, evaluation.stepStatus, evaluation.summary);\n\n  if (evaluation.taskStatus) {\n    return {\n      kind: \"stop\",\n      decision: {\n        kind: \"finalize\",\n        taskStatus: evaluation.taskStatus,\n        stopReason: evaluation.stopReason ?? \"completed\",\n      },\n    };\n  }\n\n  return { kind: \"continue\" };\n}\n\nfunction applyStepOutcome(memory: AgentMemory, step: AgentStep, result: ActionResult, ui: AgentUI): StepOutcomeDecision {\n  const evaluation = evaluateStep(step, result);\n  const fromStatus = step.status;\n  const outcome = applyEvaluation(memory, step, evaluation);\n  emitStepTransitionState(ui, step, fromStatus, computeStepDurationMs(step));\n  recordStepFinished(memory, step, evaluation.summary, {\n    action: step.action,\n    result: {\n      ok: result.ok,\n      summary: result.summary,\n      output: result.output ?? null,\n    },\n    evaluation,\n  });\n  return outcome;\n}\n\nfunction resolveEndDecision(memory: AgentMemory): EndDecision {\n  return resolveForcedEndDecision(memory);\n}\n\nfunction resolvePendingEndStep(memory: AgentMemory, decision: EndDecision, ui: AgentUI): AgentStep {\n  if (decision.kind !== \"run-action\") {\n    throw new Error(\"resolvePendingEndStep only supports run-action decisions.\");\n  }\n  const pendingStep = memory.steps.find((step) => step.status === \"pending\" && step.action === decision.action);\n  if (pendingStep) {\n    return pendingStep;\n  }\n  const step = createRuntimeStep(memory, decision.action, decision.purpose, {}, decision.expectedEvidence);\n  recordStepCreated(memory, step);\n  emitStepCreatedState(ui, step);\n  return step;\n}\n\nfunction finalizeAfterEndAction(memory: AgentMemory, result: ActionResult, decision: EndDecision): void {\n  applyFinalTaskStatus(memory, result, decision);\n}\n\nasync function finishRun(memory: AgentMemory, ui: AgentUI, actions: AgentActions, decision: EndDecision): Promise<void> {\n  if (memory.task.status !== \"active\") {\n    recordTaskFinalized(memory);\n    return;\n  }\n\n  if (decision.kind === \"finalize\") {\n    const fromStatus = memory.task.status;\n    finalizeTask(memory, decision.taskStatus, decision.stopReason);\n    emitTaskTransitionState(ui, fromStatus, memory.task.status, decision.stopReason);\n    recordTaskFinalized(memory);\n    return;\n  }\n\n  const step = resolvePendingEndStep(memory, decision, ui);\n\n  const gate = validateOrReplanStep(memory, step, ui, actions);\n  if (gate.kind === \"continue\") {\n    const fromStatus = memory.task.status;\n    finalizeTask(memory, \"blocked\", decision.stopReason);\n    emitTaskTransitionState(ui, fromStatus, memory.task.status, decision.stopReason);\n  } else {\n    const result = await executeStepWithUi(memory, step, gate.spec, ui);\n    const fromStatus = step.status;\n    finishStep(memory, step, result.ok ? \"done\" : \"blocked\", result.summary);\n    emitStepTransitionState(ui, step, fromStatus, computeStepDurationMs(step));\n    recordStepFinished(memory, step, result.summary, {\n      action: step.action,\n      result: {\n        ok: result.ok,\n        summary: result.summary,\n        output: result.output ?? null,\n      },\n      endDecision: decision,\n    });\n    const taskStatusBefore = memory.task.status;\n    finalizeAfterEndAction(memory, result, decision);\n    emitTaskTransitionState(ui, taskStatusBefore, memory.task.status, memory.task.stopReason);\n  }\n\n  recordTaskFinalized(memory);\n}\n\nfunction buildFailureDetails(\n  memory: AgentMemory,\n  activeStep: AgentStep | undefined,\n  failureStage: string,\n  error: unknown,\n  ui: AgentUI\n) {\n  const details = error instanceof AgentRuntimeError\n    ? error.details\n    : {\n        stage: failureStage,\n        message: error instanceof Error ? error.message : String(error),\n        stepId: activeStep?.id,\n        action: activeStep?.action,\n      };\n\n  if (activeStep && activeStep.status === \"running\") {\n    const fromStatus = activeStep.status;\n    finishStep(memory, activeStep, \"failed\", details.message);\n    emitStepTransitionState(ui, activeStep, fromStatus, computeStepDurationMs(activeStep));\n    recordStepFailure(memory, activeStep, details.message, details.stage);\n  }\n\n  if (memory.task.status === \"active\" || memory.task.status === \"waiting\") {\n    const fromStatus = memory.task.status;\n    finalizeTask(memory, \"failed\", details.stage);\n    emitTaskTransitionState(ui, fromStatus, memory.task.status, details.stage);\n  }\n  recordAgentEvent(memory, \"task-failed\", {\n    stage: details.stage,\n    message: details.message,\n    action: details.action ?? null,\n    stepId: details.stepId ?? null,\n    status: \"failed\",\n  }, details.stepId);\n  logAgentError(memory, details, {\n    currentStepId: memory.task.currentStepId ?? null,\n    turnCount: memory.task.turnCount,\n  });\n  recordTaskFinalized(memory);\n  return error instanceof AgentRuntimeError ? error : new AgentRuntimeError(details, error);\n}\n\nexport async function runAgentLoop(memory: AgentMemory, ui: AgentUI): Promise<void> {\n  const tools = buildTools();\n  const actions = buildActions(tools, ui);\n  let activeStep: AgentStep | undefined;\n  let failureStage = \"understand\";\n  try {\n    await runUnderstandPhase(memory, ui);\n\n    while (shouldContinue(memory)) {\n      memory.task.turnCount += 1;\n      failureStage = \"action-choice\";\n      const step = await getOrCreateNextStep(memory, ui);\n\n      activeStep = step;\n      const gate = validateOrReplanStep(memory, step, ui, actions);\n      if (gate.kind === \"continue\") {\n        activeStep = undefined;\n        continue;\n      }\n\n      failureStage = \"step-execution\";\n      const result = await executeStepWithUi(memory, step, gate.spec, ui);\n      refreshAgentTargetClassification(memory);\n      const outcome = applyStepOutcome(memory, step, result, ui);\n      activeStep = undefined;\n      if (outcome.kind === \"stop\") {\n        await finishRun(memory, ui, actions, outcome.decision);\n        return;\n      }\n    }\n\n    if (memory.task.status === \"active\") {\n      await finishRun(memory, ui, actions, resolveEndDecision(memory));\n      return;\n    }\n\n    recordTaskFinalized(memory);\n  } catch (error) {\n    const runtimeError = buildFailureDetails(memory, activeStep, failureStage, error, ui);\n    ui.update(formatFailureProgress(runtimeError.details));\n    throw runtimeError;\n  }\n}\n"]}

package/dist/agent/runtime/runAgentPlanOnly.js

@@ -0,0 +1,127 @@
+import { emitAgentStepStateMessage, emitAgentTaskStateMessage, emitConsoleMessage, shouldShowConsoleTiming, } from "../../utils/consolePresentation.js";
+import { buildActions } from "../actions/index.js";
+import { getErrorMessage, getErrorTrace, logAgentError, logAgentStepInput, recordAgentArtifact, recordAgentEvent, } from "../logging/index.js";
+import { formatStepMilestone, formatStepProgress, formatUnderstandMilestone, formatUnderstandProgress, } from "./progress.js";
+import { createRuntimeStep, finalizeTask, finishStep, startStep } from "../state/index.js";
+import { buildTools } from "../tools/index.js";
+import { runUnderstand } from "./understand.js";
+import { AgentRuntimeError } from "../types.js";
+import { applyUnderstandResult, recordStepFailure, recordStepFinished, recordStepStarted, recordTaskFinalized, } from "./lifecycle.js";
+function emitMilestone(ui, message) {
+    if (!shouldShowConsoleTiming()) {
+        emitConsoleMessage(ui, message);
+    }
+}
+function emitStepState(ui, step, from, to) {
+    emitAgentStepStateMessage(ui, {
+        stepId: step.id,
+        action: step.action,
+        from,
+        to,
+    });
+}
+function renderPlanOnlyAnswer(plan) {
+    const lines = [
+        `Plan goal: ${plan.goal}`,
+        "",
+        `Why: ${plan.why}`,
+        "",
+        "Steps:",
+    ];
+    for (const [index, step] of plan.steps.entries()) {
+        lines.push(`${index + 1}. ${step.purpose} (${step.action})`);
+    }
+    return lines.join("\n");
+}
+export async function runAgentPlanOnly(memory, ui) {
+    const tools = buildTools();
+    const actions = buildActions(tools, ui);
+    let activeStep;
+    try {
+        ui.update(formatUnderstandProgress(memory.task));
+        emitMilestone(ui, formatUnderstandMilestone());
+        const understand = await runUnderstand(memory, ui);
+        applyUnderstandResult(memory, understand);
+        activeStep = createRuntimeStep(memory, "plan", "Create a short implementation plan without entering execution.", {}, ["ordered plan steps"]);
+        recordAgentEvent(memory, "step-created", {
+            action: activeStep.action,
+            args: activeStep.args,
+            purpose: activeStep.purpose,
+        }, activeStep.id);
+        emitStepState(ui, activeStep, "created", activeStep.status);
+        ui.update(formatStepProgress(activeStep, memory.task));
+        emitMilestone(ui, formatStepMilestone(activeStep));
+        logAgentStepInput(memory, activeStep);
+        const fromStatus = activeStep.status;
+        startStep(memory, activeStep);
+        emitStepState(ui, activeStep, fromStatus, activeStep.status);
+        recordStepStarted(memory, activeStep);
+        const result = await actions.plan.run(memory, {});
+        finishStep(memory, activeStep, result.ok ? "done" : "failed", result.summary);
+        emitStepState(ui, activeStep, "running", activeStep.status);
+        recordStepFinished(memory, activeStep, result.summary, {
+            action: activeStep.action,
+            result: {
+                ok: result.ok,
+                summary: result.summary,
+                output: result.output ?? null,
+            },
+        });
+        const latestPlan = memory.artifacts.plans[memory.artifacts.plans.length - 1];
+        if (!latestPlan) {
+            throw new AgentRuntimeError({
+                stage: "plan-only",
+                message: "Plan-only run finished without a plan artifact.",
+                stepId: activeStep.id,
+                action: "plan",
+            });
+        }
+        const answer = renderPlanOnlyAnswer(latestPlan);
+        memory.artifacts.finalAnswer = answer;
+        recordAgentArtifact(memory.artifacts, "final-answer", answer);
+        finalizeTask(memory, "done", "plan-only-completed");
+        emitAgentTaskStateMessage(ui, {
+            from: "active",
+            to: "done",
+            reason: "plan-only-completed",
+        });
+        recordTaskFinalized(memory);
+    }
+    catch (error) {
+        const details = error instanceof AgentRuntimeError
+            ? error.details
+            : {
+                stage: "plan-only",
+                message: getErrorMessage(error),
+                stepId: activeStep?.id,
+                action: activeStep?.action,
+            };
+        if (activeStep?.status === "running") {
+            finishStep(memory, activeStep, "failed", details.message);
+            emitStepState(ui, activeStep, "running", activeStep.status);
+            recordStepFailure(memory, activeStep, details.message, details.stage);
+        }
+        finalizeTask(memory, "failed", details.stage);
+        emitAgentTaskStateMessage(ui, {
+            from: "active",
+            to: "failed",
+            reason: details.stage,
+        });
+        recordAgentEvent(memory, "task-failed", {
+            stage: details.stage,
+            message: details.message,
+            action: details.action ?? null,
+            stepId: details.stepId ?? null,
+            status: "failed",
+            mode: memory.task.mode,
+        }, details.stepId);
+        logAgentError(memory, details, {
+            currentStepId: memory.task.currentStepId ?? null,
+            turnCount: memory.task.turnCount,
+            trace: getErrorTrace(error) ?? null,
+        });
+        recordTaskFinalized(memory);
+        throw (error instanceof AgentRuntimeError ? error : new AgentRuntimeError(details, error));
+    }
+}
+//# sourceMappingURL=runAgentPlanOnly.js.map