scai 0.1.178 → 1.0.0

package/dist/agent/finalization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/finalization/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAiBjE,MAAM,UAAU,wBAAwB,CAAC,MAAmB;IAC1D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC;IAC7E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,sBAAsB;SACnC,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAmB,EAAE,MAAoB,EAAE,QAA4B;IAC1G,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAoB,QAAQ,CAAC,MAAM,KAAK,cAAc;QACrE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC5E,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;IACxB,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5C,OAAO;IACT,CAAC;IACD,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAChG,CAAC","sourcesContent":["/**\n * Owns end-of-run finalization for the modular agent runtime.\n *\n * Why this file exists:\n * - terminal task status should be applied in one place\n * - runtime loop code should not own stop-message or end-state policy\n */\nimport type { ActionResult, AgentMemory, AgentTaskStatus } from \"../types.js\";\nimport { resolvePolicyState } from \"../policy/index.js\";\nimport { finalizeTask, setWaitingTask } from \"../state/index.js\";\n\nexport type RuntimeEndDecision =\n  | {\n      kind: \"finalize\";\n      taskStatus: Extract<AgentTaskStatus, \"waiting\" | \"done\" | \"blocked\" | \"failed\">;\n      stopReason: string;\n    }\n  | {\n      kind: \"run-action\";\n      action: \"final-answer\" | \"cannot-answer\" | \"request-user-input\";\n      taskStatus: \"done\" | \"blocked\" | \"waiting\";\n      stopReason: string;\n      purpose: string;\n      expectedEvidence: string[];\n    };\n\nexport function resolveForcedEndDecision(memory: AgentMemory): RuntimeEndDecision {\n  const decision = resolvePolicyState(memory, { forcedEnd: true }).endDecision;\n  if (!decision) {\n    return {\n      kind: \"finalize\",\n      taskStatus: \"blocked\",\n      stopReason: \"missing-end-decision\",\n    };\n  }\n  return {\n    kind: \"run-action\",\n    action: decision.action,\n    taskStatus: decision.taskStatus,\n    stopReason: decision.stopReason,\n    purpose: decision.purpose,\n    expectedEvidence: decision.expectedEvidence,\n  };\n}\n\nexport function applyFinalTaskStatus(memory: AgentMemory, result: ActionResult, decision: RuntimeEndDecision): void {\n  if (decision.kind !== \"run-action\") {\n    throw new Error(\"applyFinalTaskStatus only supports run-action decisions.\");\n  }\n  const policy = resolvePolicyState(memory);\n  const finalStatus: AgentTaskStatus = decision.action === \"final-answer\"\n    ? ((result.ok || policy.hasGroundedEvidence) ? \"done\" : decision.taskStatus)\n    : decision.taskStatus;\n  if (finalStatus === \"waiting\") {\n    setWaitingTask(memory, decision.stopReason);\n    return;\n  }\n  finalizeTask(memory, finalStatus, finalStatus === \"done\" ? \"completed\" : decision.stopReason);\n}\n"]}

package/dist/agent/index.js

@@ -0,0 +1,126 @@
+import { continueAgentTaskFromFeedback } from "./feedback/index.js";
+import { recordAgentEvent } from "./logging/index.js";
+import { refreshResumeCheckpoint } from "./resume/checkpoint.js";
+import { beginAgentTurn, bootAgentTask, finishAgentTurn, loadAgentTask, persistAgentSteps, persistAgentTask, } from "./persistence/index.js";
+import { runAgentLoop } from "./runtime/runAgentLoop.js";
+import { runAgentPlanOnly } from "./runtime/runAgentPlanOnly.js";
+export class Agent {
+    constructor(query, ui, existingMemory, options) {
+        this.query = query;
+        this.ui = ui;
+        this.existingMemory = existingMemory;
+        this.planOnly = options?.planOnly === true;
+        this.resumeTaskId = options?.resumeTaskId;
+        this.bindAsCurrentTask = options?.bindAsCurrentTask !== false;
+    }
+    async run() {
+        const { memory, queryKind } = this.existingMemory
+            ? preparePersistedContinuation(this.existingMemory, this.query, this.planOnly)
+            : this.resumeTaskId
+                ? resumePersistedMemory(this.resumeTaskId, this.query, this.planOnly, this.bindAsCurrentTask)
+                : createFreshPersistedMemory(this.query, this.planOnly, this.bindAsCurrentTask);
+        beginAgentTurn(memory, this.query, queryKind);
+        try {
+            if (this.planOnly) {
+                await runAgentPlanOnly(memory, this.ui);
+            }
+            else {
+                await runAgentLoop(memory, this.ui);
+            }
+            persistAgentTask(memory);
+            persistAgentSteps(memory);
+            finishAgentTurn(memory);
+            return memory;
+        }
+        catch (error) {
+            persistAgentTask(memory);
+            persistAgentSteps(memory);
+            finishAgentTurn(memory);
+            throw error;
+        }
+        finally {
+            this.ui.stop();
+        }
+    }
+}
+function recordTaskCreated(memory, query) {
+    recordAgentEvent(memory, "task-created", {
+        runtime: "agent",
+        query,
+        mode: memory.task.mode,
+        repoRootPath: memory.session.repoRootPath,
+        executionPath: memory.session.executionPath,
+    });
+}
+function createFreshPersistedMemory(query, planOnly, bindAsCurrentTask) {
+    const memory = bootAgentTask(query, { planOnly, bindAsCurrentTask });
+    recordTaskCreated(memory, query);
+    return {
+        memory,
+        queryKind: planOnly ? "plan-only" : "fresh-ask",
+    };
+}
+function resumePersistedMemory(resumeTaskId, query, planOnly, bindAsCurrentTask) {
+    const resumed = loadAgentTask(resumeTaskId, query, { planOnly, bindAsCurrentTask });
+    const prepared = prepareMemoryForContinuation(resumed, query, planOnly);
+    recordTaskCreated(prepared.memory, query);
+    return {
+        memory: prepared.memory,
+        queryKind: planOnly ? "plan-only" : "resume-query",
+    };
+}
+function preparePersistedContinuation(memory, query, planOnly) {
+    const prepared = prepareMemoryForContinuation(memory, query, planOnly);
+    recordTaskCreated(prepared.memory, query);
+    return {
+        memory: prepared.memory,
+        queryKind: planOnly ? "plan-only" : prepared.continuedFromFeedback ? "feedback-reply" : "resume-query",
+    };
+}
+function prepareMemoryForContinuation(memory, query, planOnly) {
+    const continuedFromFeedback = !planOnly && continueAgentTaskFromFeedback(memory, query);
+    refreshResumeCheckpoint(memory);
+    if (!continuedFromFeedback) {
+        memory.session.initialQuery = query;
+        memory.task.initialQuery = query;
+        memory.task.normalizedQuery = query;
+        memory.task.explicitTargetOverrides = {};
+    }
+    memory.task.mode = planOnly ? "plan" : "ask";
+    if (!continuedFromFeedback && memory.task.status !== "active") {
+        memory.task.status = "active";
+        memory.task.stopReason = undefined;
+    }
+    memory.task.primaryIntent = "Understand and answer the user's request.";
+    memory.task.alternativeIntents = [];
+    memory.task.searchTermGroups = [];
+    memory.task.ambiguityFlags = [];
+    memory.task.queryScope = "general";
+    memory.task.explicitTargets = [];
+    memory.task.hardFileTargets = [];
+    memory.task.softHints = [];
+    memory.task.constraints = [];
+    memory.task.currentStepId = undefined;
+    memory.task.turnCount = 0;
+    memory.task.replanCount = 0;
+    memory.task.currentTurnId = undefined;
+    memory.task.currentTurnIndex = undefined;
+    memory.artifacts.finalAnswer = undefined;
+    memory.artifacts.latestFinalAnswerPacket = undefined;
+    memory.artifacts.stopMessage = undefined;
+    memory.steps = memory.steps.map((step) => {
+        if (step.status === "pending" || step.status === "running") {
+            return {
+                ...step,
+                status: "skipped",
+                resultSummary: step.resultSummary ?? "Superseded by a follow-up agent query.",
+            };
+        }
+        return step;
+    });
+    return {
+        memory,
+        continuedFromFeedback,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Runs the new simple agent runtime for one query.\n *\n * Why this file exists:\n * - the runtime needs one clean entrypoint for fresh asks and resumed turns\n * - boot, loop execution, and final structured memory should stay small and explicit\n * - explicit plan-only runs should stay on the same runtime\n * - persistence handoff should stay outside the loop body\n */\nimport type { AgentUI } from \"../types.js\";\nimport { continueAgentTaskFromFeedback } from \"./feedback/index.js\";\nimport { recordAgentEvent } from \"./logging/index.js\";\nimport { refreshResumeCheckpoint } from \"./resume/checkpoint.js\";\nimport {\n  beginAgentTurn,\n  bootAgentTask,\n  finishAgentTurn,\n  loadAgentTask,\n  persistAgentSteps,\n  persistAgentTask,\n} from \"./persistence/index.js\";\nimport { runAgentLoop } from \"./runtime/runAgentLoop.js\";\nimport { runAgentPlanOnly } from \"./runtime/runAgentPlanOnly.js\";\nimport type { AgentMemory } from \"./types.js\";\n\nexport class Agent {\n  private readonly query: string;\n  private readonly ui: AgentUI;\n  private readonly existingMemory?: AgentMemory;\n  private readonly planOnly: boolean;\n  private readonly resumeTaskId?: number;\n  private readonly bindAsCurrentTask: boolean;\n\n  constructor(\n    query: string,\n    ui: AgentUI,\n    existingMemory?: AgentMemory,\n    options?: { planOnly?: boolean; resumeTaskId?: number; bindAsCurrentTask?: boolean }\n  ) {\n    this.query = query;\n    this.ui = ui;\n    this.existingMemory = existingMemory;\n    this.planOnly = options?.planOnly === true;\n    this.resumeTaskId = options?.resumeTaskId;\n    this.bindAsCurrentTask = options?.bindAsCurrentTask !== false;\n  }\n\n  async run(): Promise<AgentMemory> {\n    const { memory, queryKind } = this.existingMemory\n      ? preparePersistedContinuation(this.existingMemory, this.query, this.planOnly)\n      : this.resumeTaskId\n        ? resumePersistedMemory(this.resumeTaskId, this.query, this.planOnly, this.bindAsCurrentTask)\n        : createFreshPersistedMemory(this.query, this.planOnly, this.bindAsCurrentTask);\n    beginAgentTurn(memory, this.query, queryKind);\n    try {\n      if (this.planOnly) {\n        await runAgentPlanOnly(memory, this.ui);\n      } else {\n        await runAgentLoop(memory, this.ui);\n      }\n      persistAgentTask(memory);\n      persistAgentSteps(memory);\n      finishAgentTurn(memory);\n      return memory;\n    } catch (error) {\n      persistAgentTask(memory);\n      persistAgentSteps(memory);\n      finishAgentTurn(memory);\n      throw error;\n    } finally {\n      this.ui.stop();\n    }\n  }\n}\n\nfunction recordTaskCreated(memory: AgentMemory, query: string): void {\n  recordAgentEvent(memory, \"task-created\", {\n    runtime: \"agent\",\n    query,\n    mode: memory.task.mode,\n    repoRootPath: memory.session.repoRootPath,\n    executionPath: memory.session.executionPath,\n  });\n}\n\nfunction createFreshPersistedMemory(query: string, planOnly: boolean, bindAsCurrentTask: boolean): {\n  memory: AgentMemory;\n  queryKind: \"fresh-ask\" | \"plan-only\";\n} {\n  const memory = bootAgentTask(query, { planOnly, bindAsCurrentTask });\n  recordTaskCreated(memory, query);\n  return {\n    memory,\n    queryKind: planOnly ? \"plan-only\" : \"fresh-ask\",\n  };\n}\n\nfunction resumePersistedMemory(\n  resumeTaskId: number,\n  query: string,\n  planOnly: boolean,\n  bindAsCurrentTask: boolean\n): {\n  memory: AgentMemory;\n  queryKind: \"resume-query\" | \"plan-only\";\n} {\n  const resumed = loadAgentTask(resumeTaskId, query, { planOnly, bindAsCurrentTask });\n  const prepared = prepareMemoryForContinuation(resumed, query, planOnly);\n  recordTaskCreated(prepared.memory, query);\n  return {\n    memory: prepared.memory,\n    queryKind: planOnly ? \"plan-only\" : \"resume-query\",\n  };\n}\n\nfunction preparePersistedContinuation(\n  memory: AgentMemory,\n  query: string,\n  planOnly: boolean\n): {\n  memory: AgentMemory;\n  queryKind: \"resume-query\" | \"feedback-reply\" | \"plan-only\";\n} {\n  const prepared = prepareMemoryForContinuation(memory, query, planOnly);\n  recordTaskCreated(prepared.memory, query);\n  return {\n    memory: prepared.memory,\n    queryKind: planOnly ? \"plan-only\" : prepared.continuedFromFeedback ? \"feedback-reply\" : \"resume-query\",\n  };\n}\n\nfunction prepareMemoryForContinuation(\n  memory: AgentMemory,\n  query: string,\n  planOnly: boolean\n): {\n  memory: AgentMemory;\n  continuedFromFeedback: boolean;\n} {\n  const continuedFromFeedback = !planOnly && continueAgentTaskFromFeedback(memory, query);\n  refreshResumeCheckpoint(memory);\n  if (!continuedFromFeedback) {\n    memory.session.initialQuery = query;\n    memory.task.initialQuery = query;\n    memory.task.normalizedQuery = query;\n    memory.task.explicitTargetOverrides = {};\n  }\n  memory.task.mode = planOnly ? \"plan\" : \"ask\";\n  if (!continuedFromFeedback && memory.task.status !== \"active\") {\n    memory.task.status = \"active\";\n    memory.task.stopReason = undefined;\n  }\n  memory.task.primaryIntent = \"Understand and answer the user's request.\";\n  memory.task.alternativeIntents = [];\n  memory.task.searchTermGroups = [];\n  memory.task.ambiguityFlags = [];\n  memory.task.queryScope = \"general\";\n  memory.task.explicitTargets = [];\n  memory.task.hardFileTargets = [];\n  memory.task.softHints = [];\n  memory.task.constraints = [];\n  memory.task.currentStepId = undefined;\n  memory.task.turnCount = 0;\n  memory.task.replanCount = 0;\n  memory.task.currentTurnId = undefined;\n  memory.task.currentTurnIndex = undefined;\n  memory.artifacts.finalAnswer = undefined;\n  memory.artifacts.latestFinalAnswerPacket = undefined;\n  memory.artifacts.stopMessage = undefined;\n  memory.steps = memory.steps.map((step) => {\n    if (step.status === \"pending\" || step.status === \"running\") {\n      return {\n        ...step,\n        status: \"skipped\",\n        resultSummary: step.resultSummary ?? \"Superseded by a follow-up agent query.\",\n      };\n    }\n    return step;\n  });\n  return {\n    memory,\n    continuedFromFeedback,\n  };\n}\n"]}

package/dist/agent/logging/index.js

@@ -0,0 +1,350 @@
+/**
+ * Records structured events and artifacts for the new simple agent runtime.
+ *
+ * Why this file exists:
+ * - event logging should stay append-only and machine-readable from day one
+ * - artifacts should be separate from the event stream so later prompt/debug work stays cleaner
+ * - Stage 1 needs explicit step, llm, tool, and error records for debugging
+ */
+import { logRuntimeRecord } from "../../utils/runtimeLogger.js";
+import { nowLocalIso } from "../../utils/time.js";
+function nowIso() {
+    return nowLocalIso();
+}
+function baseIds(memory, stepId) {
+    return {
+        runtime: "agent",
+        sessionId: String(memory.session.id),
+        taskId: String(memory.task.id),
+        ...(stepId ? { stepId } : {}),
+    };
+}
+export function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function getErrorTrace(error) {
+    return error instanceof Error ? error.trace : undefined;
+}
+export function recordAgentEvent(memory, type, payload, stepId) {
+    const event = {
+        version: 1,
+        type,
+        at: nowIso(),
+        sessionId: memory.session.id,
+        taskId: memory.task.id,
+        ...(stepId ? { stepId } : {}),
+        payload,
+    };
+    memory.events.push(event);
+    logRuntimeRecord({
+        ...baseIds(memory, stepId),
+        kind: type.startsWith("tool-")
+            ? "tool"
+            : type.startsWith("llm-")
+                ? "llm"
+                : type === "task-failed"
+                    ? "error"
+                    : type.startsWith("task-")
+                        ? "task"
+                        : "step",
+        phase: mapEventTypeToPhase(type),
+        status: inferEventStatus(type, payload.status),
+        summary: type,
+        payload: event,
+    });
+    return event;
+}
+export function recordAgentArtifact(store, name, payload) {
+    logRuntimeRecord({
+        runtime: "agent",
+        kind: "step",
+        phase: "output",
+        summary: `artifact ${name}`,
+        payload,
+    });
+    if (name === "final-answer" && typeof payload === "string") {
+        store.finalAnswer = payload;
+    }
+}
+function mapEventTypeToPhase(type) {
+    switch (type) {
+        case "task-created":
+        case "step-created":
+            return "created";
+        case "understand-started":
+        case "step-started":
+        case "llm-call-started":
+        case "tool-started":
+            return "started";
+        case "understand-completed":
+        case "llm-call-finished":
+        case "tool-finished":
+            return "finished";
+        case "step-succeeded":
+            return "succeeded";
+        case "step-failed":
+        case "validation-failed":
+        case "llm-call-failed":
+        case "tool-failed":
+        case "task-failed":
+            return "failed";
+        case "task-finalized":
+            return "finalized";
+        case "replan-requested":
+            return "requested";
+    }
+}
+function inferEventStatus(type, payloadStatus) {
+    if (typeof payloadStatus === "string") {
+        return payloadStatus;
+    }
+    if (type.endsWith("failed")) {
+        return "error";
+    }
+    if (type.endsWith("finished") || type.endsWith("completed") || type.endsWith("succeeded")) {
+        return "ok";
+    }
+    return undefined;
+}
+export function logAgentStepInput(memory, step) {
+    logRuntimeRecord({
+        ...baseIds(memory, step.id),
+        kind: "step",
+        phase: "input",
+        status: step.status,
+        summary: `${step.action} input`,
+        payload: {
+            action: step.action,
+            args: step.args,
+            purpose: step.purpose,
+            expectedEvidence: step.expectedEvidence,
+            memorySummary: {
+                candidateFiles: memory.evidence.candidateFiles.slice(0, 5),
+                readFiles: Object.keys(memory.evidence.fileReads),
+                searchCount: memory.evidence.searches.length,
+            },
+        },
+    });
+}
+export function logAgentStepOutput(memory, step, summary, payload) {
+    logRuntimeRecord({
+        ...baseIds(memory, step.id),
+        kind: "step",
+        phase: "output",
+        status: step.status,
+        summary,
+        payload,
+    });
+}
+/**
+ * Logs one search-module input record under the active step.
+ * Example: one `search-db` action can choose any lane, but the human log should show one clear search input boundary.
+ */
+export function logAgentSearchInput(memory, payload, stepId) {
+    logRuntimeRecord({
+        ...baseIds(memory, stepId),
+        kind: "step",
+        phase: "input",
+        status: "running",
+        summary: "search-module input",
+        payload,
+    });
+}
+/**
+ * Logs one search-module output record under the active step.
+ * Example: the result should show the chosen lane and final candidate set, not every internal fallback query.
+ */
+export function logAgentSearchOutput(memory, payload, stepId) {
+    logRuntimeRecord({
+        ...baseIds(memory, stepId),
+        kind: "step",
+        phase: "output",
+        status: payload.failure ? "failed" : "ok",
+        summary: "search-module output",
+        payload,
+    });
+}
+export function logAgentValidationFailure(memory, step, errors) {
+    recordAgentEvent(memory, "validation-failed", {
+        action: step.action,
+        args: step.args,
+        errors,
+        status: "blocked",
+    }, step.id);
+}
+export function logAgentLlmInput(memory, label, payload, stepId, startedAt) {
+    recordAgentEvent(memory, "llm-call-started", {
+        label,
+        status: "active",
+        ...(startedAt ? { startedAt } : {}),
+    }, stepId);
+    logRuntimeRecord({
+        ...baseIds(memory, stepId),
+        kind: "llm",
+        phase: "input",
+        status: "active",
+        summary: label,
+        payload: {
+            ...payload,
+            ...(startedAt ? { startedAt } : {}),
+        },
+    });
+}
+export function logAgentLlmOutput(memory, label, payload, stepId, trace) {
+    recordAgentEvent(memory, "llm-call-finished", {
+        label,
+        status: "ok",
+        ...(trace ? trace : {}),
+    }, stepId);
+    logRuntimeRecord({
+        ...baseIds(memory, stepId),
+        kind: "llm",
+        phase: "output",
+        status: "ok",
+        summary: label,
+        payload: {
+            ...payload,
+            ...(trace ? trace : {}),
+        },
+    });
+}
+export function logAgentLlmFailure(memory, label, details, trace) {
+    recordAgentEvent(memory, "llm-call-failed", {
+        label,
+        stage: details.stage,
+        action: details.action,
+        message: details.message,
+        status: "error",
+        ...(trace ? trace : {}),
+    }, details.stepId);
+    logRuntimeRecord({
+        ...baseIds(memory, details.stepId),
+        kind: "llm",
+        phase: "failed",
+        status: "error",
+        summary: label,
+        payload: {
+            stage: details.stage,
+            action: details.action,
+            message: details.message,
+            ...(trace ? trace : {}),
+        },
+    });
+}
+export function logAgentToolInput(memory, stepId, action, args) {
+    recordAgentEvent(memory, "tool-started", {
+        action,
+        args,
+        status: "active",
+    }, stepId);
+    logRuntimeRecord({
+        ...baseIds(memory, stepId),
+        kind: "tool",
+        phase: "input",
+        status: "active",
+        summary: action,
+        payload: { args },
+    });
+}
+export function logAgentToolOutput(memory, stepId, action, payload) {
+    recordAgentEvent(memory, "tool-finished", {
+        action,
+        status: "ok",
+    }, stepId);
+    logRuntimeRecord({
+        ...baseIds(memory, stepId),
+        kind: "tool",
+        phase: "output",
+        status: "ok",
+        summary: action,
+        payload,
+    });
+}
+export function logAgentToolFailure(memory, details, payload) {
+    recordAgentEvent(memory, "tool-failed", {
+        action: details.action,
+        stage: details.stage,
+        message: details.message,
+        status: "error",
+    }, details.stepId);
+    logRuntimeRecord({
+        ...baseIds(memory, details.stepId),
+        kind: "tool",
+        phase: "failed",
+        status: "error",
+        summary: details.message,
+        payload,
+    });
+}
+export function logAgentError(memory, details, payload) {
+    logRuntimeRecord({
+        ...baseIds(memory, details.stepId),
+        kind: "error",
+        phase: "failed",
+        status: "error",
+        summary: details.message,
+        payload: {
+            stage: details.stage,
+            action: details.action,
+            ...(payload !== undefined ? { details: payload } : {}),
+        },
+    });
+}
+/**
+ * Logs one transform-owner progress record under the active transform step.
+ * Example: one batch retry should show file, batch, and retry details in `runtime.log`.
+ */
+export function logAgentTransformProgress(memory, progress, payload = {}) {
+    const step = typeof payload.step === "string" ? payload.step : undefined;
+    const phase = progress.stage === "started"
+        ? "started"
+        : progress.stage === "retrying"
+            ? "requested"
+            : progress.stage === "failed"
+                ? "failed"
+                : progress.stage === "completed"
+                    ? "finalized"
+                    : "output";
+    const status = progress.stage === "failed"
+        ? "error"
+        : progress.stage === "completed"
+            ? "done"
+            : progress.stage === "retrying"
+                ? "active"
+                : "ok";
+    const summary = progress.stage === "started"
+        ? "transform started"
+        : progress.stage === "planning"
+            ? (step === "plan-created" ? "transform plan created" : "transform planning started")
+            : progress.stage === "applying"
+                ? (step === "batch-selected"
+                    ? "transform batch selected"
+                    : step === "apply-finished"
+                        ? "transform apply finished"
+                        : "transform apply started")
+                : progress.stage === "validating"
+                    ? (payload.validationStatus ? "transform validation result" : "transform validation started")
+                    : progress.stage === "retrying"
+                        ? "transform retry requested"
+                        : progress.stage === "failed"
+                            ? "transform failed"
+                            : "transform completed";
+    logRuntimeRecord({
+        ...baseIds(memory, memory.task.currentStepId),
+        kind: "step",
+        phase,
+        status,
+        summary,
+        payload: {
+            action: "codeTransform",
+            filePath: progress.filePath,
+            batchNumber: progress.batchNumber,
+            batchCount: progress.batchCount,
+            editIds: progress.editIds,
+            retryCount: progress.retryCount,
+            reason: progress.reason,
+            ...payload,
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/agent/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/logging/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Records structured events and artifacts for the new simple agent runtime.\n *\n * Why this file exists:\n * - event logging should stay append-only and machine-readable from day one\n * - artifacts should be separate from the event stream so later prompt/debug work stays cleaner\n * - Stage 1 needs explicit step, llm, tool, and error records for debugging\n */\nimport { logRuntimeRecord } from \"../../utils/runtimeLogger.js\";\nimport type { ModuleIO } from \"../../types.js\";\nimport type {\n  AgentActionName,\n  AgentArtifactStore,\n  AgentEvent,\n  AgentFailureDetails,\n  AgentTransformLoopProgress,\n  AgentMemory,\n  AgentSearchTraceInput,\n  AgentSearchTraceOutput,\n  AgentStep,\n  AgentStepStatus,\n  AgentTaskStatus,\n} from \"../types.js\";\nimport { nowLocalIso } from \"../../utils/time.js\";\n\nfunction nowIso(): string {\n  return nowLocalIso();\n}\n\nfunction baseIds(memory: AgentMemory, stepId?: string) {\n  return {\n    runtime: \"agent\" as const,\n    sessionId: String(memory.session.id),\n    taskId: String(memory.task.id),\n    ...(stepId ? { stepId } : {}),\n  };\n}\n\ntype TraceError = Error & {\n  trace?: ModuleIO[\"trace\"];\n};\n\nexport function getErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nexport function getErrorTrace(error: unknown): ModuleIO[\"trace\"] | undefined {\n  return error instanceof Error ? (error as TraceError).trace : undefined;\n}\n\nexport function recordAgentEvent(\n  memory: AgentMemory,\n  type: AgentEvent[\"type\"],\n  payload: Record<string, unknown>,\n  stepId?: string\n): AgentEvent {\n  const event: AgentEvent = {\n    version: 1,\n    type,\n    at: nowIso(),\n    sessionId: memory.session.id,\n    taskId: memory.task.id,\n    ...(stepId ? { stepId } : {}),\n    payload,\n  };\n  memory.events.push(event);\n  logRuntimeRecord({\n    ...baseIds(memory, stepId),\n    kind: type.startsWith(\"tool-\")\n      ? \"tool\"\n      : type.startsWith(\"llm-\")\n        ? \"llm\"\n        : type === \"task-failed\"\n          ? \"error\"\n          : type.startsWith(\"task-\")\n            ? \"task\"\n            : \"step\",\n    phase: mapEventTypeToPhase(type),\n    status: inferEventStatus(type, payload.status),\n    summary: type,\n    payload: event,\n  });\n  return event;\n}\n\nexport function recordAgentArtifact(store: AgentArtifactStore, name: string, payload: unknown): void {\n  logRuntimeRecord({\n    runtime: \"agent\",\n    kind: \"step\",\n    phase: \"output\",\n    summary: `artifact ${name}`,\n    payload,\n  });\n  if (name === \"final-answer\" && typeof payload === \"string\") {\n    store.finalAnswer = payload;\n  }\n}\n\nfunction mapEventTypeToPhase(type: AgentEvent[\"type\"]) {\n  switch (type) {\n    case \"task-created\":\n    case \"step-created\":\n      return \"created\";\n    case \"understand-started\":\n    case \"step-started\":\n    case \"llm-call-started\":\n    case \"tool-started\":\n      return \"started\";\n    case \"understand-completed\":\n    case \"llm-call-finished\":\n    case \"tool-finished\":\n      return \"finished\";\n    case \"step-succeeded\":\n      return \"succeeded\";\n    case \"step-failed\":\n    case \"validation-failed\":\n    case \"llm-call-failed\":\n    case \"tool-failed\":\n    case \"task-failed\":\n      return \"failed\";\n    case \"task-finalized\":\n      return \"finalized\";\n    case \"replan-requested\":\n      return \"requested\";\n  }\n}\n\nfunction inferEventStatus(type: AgentEvent[\"type\"], payloadStatus: unknown): AgentStepStatus | AgentTaskStatus | \"ok\" | \"error\" | undefined {\n  if (typeof payloadStatus === \"string\") {\n    return payloadStatus as AgentStepStatus | AgentTaskStatus;\n  }\n  if (type.endsWith(\"failed\")) {\n    return \"error\";\n  }\n  if (type.endsWith(\"finished\") || type.endsWith(\"completed\") || type.endsWith(\"succeeded\")) {\n    return \"ok\";\n  }\n  return undefined;\n}\n\nexport function logAgentStepInput(memory: AgentMemory, step: AgentStep): void {\n  logRuntimeRecord({\n    ...baseIds(memory, step.id),\n    kind: \"step\",\n    phase: \"input\",\n    status: step.status,\n    summary: `${step.action} input`,\n    payload: {\n      action: step.action,\n      args: step.args,\n      purpose: step.purpose,\n      expectedEvidence: step.expectedEvidence,\n      memorySummary: {\n        candidateFiles: memory.evidence.candidateFiles.slice(0, 5),\n        readFiles: Object.keys(memory.evidence.fileReads),\n        searchCount: memory.evidence.searches.length,\n      },\n    },\n  });\n}\n\nexport function logAgentStepOutput(\n  memory: AgentMemory,\n  step: AgentStep,\n  summary: string,\n  payload: Record<string, unknown>\n): void {\n  logRuntimeRecord({\n    ...baseIds(memory, step.id),\n    kind: \"step\",\n    phase: \"output\",\n    status: step.status,\n    summary,\n    payload,\n  });\n}\n\n/**\n * Logs one search-module input record under the active step.\n * Example: one `search-db` action can choose any lane, but the human log should show one clear search input boundary.\n */\nexport function logAgentSearchInput(\n  memory: AgentMemory,\n  payload: AgentSearchTraceInput,\n  stepId?: string\n): void {\n  logRuntimeRecord({\n    ...baseIds(memory, stepId),\n    kind: \"step\",\n    phase: \"input\",\n    status: \"running\",\n    summary: \"search-module input\",\n    payload,\n  });\n}\n\n/**\n * Logs one search-module output record under the active step.\n * Example: the result should show the chosen lane and final candidate set, not every internal fallback query.\n */\nexport function logAgentSearchOutput(\n  memory: AgentMemory,\n  payload: AgentSearchTraceOutput,\n  stepId?: string\n): void {\n  logRuntimeRecord({\n    ...baseIds(memory, stepId),\n    kind: \"step\",\n    phase: \"output\",\n    status: payload.failure ? \"failed\" : \"ok\",\n    summary: \"search-module output\",\n    payload,\n  });\n}\n\nexport function logAgentValidationFailure(memory: AgentMemory, step: AgentStep, errors: string[]): void {\n  recordAgentEvent(memory, \"validation-failed\", {\n    action: step.action,\n    args: step.args,\n    errors,\n    status: \"blocked\",\n  }, step.id);\n}\n\nexport function logAgentLlmInput(\n  memory: AgentMemory,\n  label: string,\n  payload: Record<string, unknown>,\n  stepId?: string,\n  startedAt?: string\n): void {\n  recordAgentEvent(memory, \"llm-call-started\", {\n    label,\n    status: \"active\",\n    ...(startedAt ? { startedAt } : {}),\n  }, stepId);\n  logRuntimeRecord({\n    ...baseIds(memory, stepId),\n    kind: \"llm\",\n    phase: \"input\",\n    status: \"active\",\n    summary: label,\n    payload: {\n      ...payload,\n      ...(startedAt ? { startedAt } : {}),\n    },\n  });\n}\n\nexport function logAgentLlmOutput(\n  memory: AgentMemory,\n  label: string,\n  payload: Record<string, unknown>,\n  stepId?: string,\n  trace?: ModuleIO[\"trace\"]\n): void {\n  recordAgentEvent(memory, \"llm-call-finished\", {\n    label,\n    status: \"ok\",\n    ...(trace ? trace : {}),\n  }, stepId);\n  logRuntimeRecord({\n    ...baseIds(memory, stepId),\n    kind: \"llm\",\n    phase: \"output\",\n    status: \"ok\",\n    summary: label,\n    payload: {\n      ...payload,\n      ...(trace ? trace : {}),\n    },\n  });\n}\n\nexport function logAgentLlmFailure(\n  memory: AgentMemory,\n  label: string,\n  details: AgentFailureDetails,\n  trace?: ModuleIO[\"trace\"]\n): void {\n  recordAgentEvent(memory, \"llm-call-failed\", {\n    label,\n    stage: details.stage,\n    action: details.action,\n    message: details.message,\n    status: \"error\",\n    ...(trace ? trace : {}),\n  }, details.stepId);\n  logRuntimeRecord({\n    ...baseIds(memory, details.stepId),\n    kind: \"llm\",\n    phase: \"failed\",\n    status: \"error\",\n    summary: label,\n    payload: {\n      stage: details.stage,\n      action: details.action,\n      message: details.message,\n      ...(trace ? trace : {}),\n    },\n  });\n}\n\nexport function logAgentToolInput(\n  memory: AgentMemory,\n  stepId: string,\n  action: AgentActionName,\n  args: Record<string, unknown>\n): void {\n  recordAgentEvent(memory, \"tool-started\", {\n    action,\n    args,\n    status: \"active\",\n  }, stepId);\n  logRuntimeRecord({\n    ...baseIds(memory, stepId),\n    kind: \"tool\",\n    phase: \"input\",\n    status: \"active\",\n    summary: action,\n    payload: { args },\n  });\n}\n\nexport function logAgentToolOutput(\n  memory: AgentMemory,\n  stepId: string,\n  action: AgentActionName,\n  payload: unknown\n): void {\n  recordAgentEvent(memory, \"tool-finished\", {\n    action,\n    status: \"ok\",\n  }, stepId);\n  logRuntimeRecord({\n    ...baseIds(memory, stepId),\n    kind: \"tool\",\n    phase: \"output\",\n    status: \"ok\",\n    summary: action,\n    payload,\n  });\n}\n\nexport function logAgentToolFailure(memory: AgentMemory, details: AgentFailureDetails, payload?: unknown): void {\n  recordAgentEvent(memory, \"tool-failed\", {\n    action: details.action,\n    stage: details.stage,\n    message: details.message,\n    status: \"error\",\n  }, details.stepId);\n  logRuntimeRecord({\n    ...baseIds(memory, details.stepId),\n    kind: \"tool\",\n    phase: \"failed\",\n    status: \"error\",\n    summary: details.message,\n    payload,\n  });\n}\n\nexport function logAgentError(memory: AgentMemory, details: AgentFailureDetails, payload?: unknown): void {\n  logRuntimeRecord({\n    ...baseIds(memory, details.stepId),\n    kind: \"error\",\n    phase: \"failed\",\n    status: \"error\",\n    summary: details.message,\n    payload: {\n      stage: details.stage,\n      action: details.action,\n      ...(payload !== undefined ? { details: payload } : {}),\n    },\n  });\n}\n\n/**\n * Logs one transform-owner progress record under the active transform step.\n * Example: one batch retry should show file, batch, and retry details in `runtime.log`.\n */\nexport function logAgentTransformProgress(\n  memory: AgentMemory,\n  progress: AgentTransformLoopProgress,\n  payload: Record<string, unknown> = {}\n): void {\n  const step = typeof payload.step === \"string\" ? payload.step : undefined;\n  const phase = progress.stage === \"started\"\n    ? \"started\"\n    : progress.stage === \"retrying\"\n      ? \"requested\"\n      : progress.stage === \"failed\"\n        ? \"failed\"\n        : progress.stage === \"completed\"\n          ? \"finalized\"\n          : \"output\";\n  const status = progress.stage === \"failed\"\n    ? \"error\"\n    : progress.stage === \"completed\"\n      ? \"done\"\n      : progress.stage === \"retrying\"\n        ? \"active\"\n        : \"ok\";\n  const summary = progress.stage === \"started\"\n    ? \"transform started\"\n    : progress.stage === \"planning\"\n      ? (step === \"plan-created\" ? \"transform plan created\" : \"transform planning started\")\n      : progress.stage === \"applying\"\n        ? (step === \"batch-selected\"\n          ? \"transform batch selected\"\n          : step === \"apply-finished\"\n            ? \"transform apply finished\"\n            : \"transform apply started\")\n        : progress.stage === \"validating\"\n          ? (payload.validationStatus ? \"transform validation result\" : \"transform validation started\")\n          : progress.stage === \"retrying\"\n            ? \"transform retry requested\"\n            : progress.stage === \"failed\"\n              ? \"transform failed\"\n              : \"transform completed\";\n\n  logRuntimeRecord({\n    ...baseIds(memory, memory.task.currentStepId),\n    kind: \"step\",\n    phase,\n    status,\n    summary,\n    payload: {\n      action: \"codeTransform\",\n      filePath: progress.filePath,\n      batchNumber: progress.batchNumber,\n      batchCount: progress.batchCount,\n      editIds: progress.editIds,\n      retryCount: progress.retryCount,\n      reason: progress.reason,\n      ...payload,\n    },\n  });\n}\n"]}

package/dist/agent/persistence/boot.js

@@ -0,0 +1,58 @@
+/**
+ * Boots fresh and resumed modular-agent tasks through the persistence layer.
+ *
+ * Why this file exists:
+ * - fresh asks, explicit resume, and in-memory continuation need one task boot owner
+ * - runtime code should not coordinate project/session/task row creation directly
+ * - current-task binding and turn start should stay aligned during boot
+ */
+import { getDbForRepo } from "../../db/client.js";
+import { resolveCanonicalRepoIdentity } from "../../utils/repoIdentity.js";
+import { createAgentMemory } from "../state/memory.js";
+import { getCurrentAgentTaskId, setCurrentAgentTask } from "./currentTask.js";
+import { hydrateAgentMemory } from "./hydrate.js";
+import { createAgentSession, createAgentTask, loadPersistedAgentSession, loadPersistedAgentTask } from "./tasks.js";
+import { startAgentTurn } from "./turns.js";
+function assignMode(memory, planOnly) {
+    memory.task.mode = planOnly ? "plan" : "ask";
+}
+export function bootAgentTask(userQuery, options = {}, db = getDbForRepo()) {
+    const identity = resolveCanonicalRepoIdentity();
+    const memory = createAgentMemory(userQuery, identity.repoRootPath, identity.executionPath);
+    assignMode(memory, options.planOnly === true);
+    const projectId = createAgentSession(memory, db);
+    createAgentTask(memory, projectId, db);
+    if (options.bindAsCurrentTask !== false) {
+        setCurrentAgentTask(memory.task.id, memory.session.id, db);
+    }
+    return memory;
+}
+export function loadAgentTask(taskId, userQuery, options = {}, db = getDbForRepo()) {
+    const taskRow = loadPersistedAgentTask(taskId, db);
+    if (!taskRow) {
+        throw new Error(`Task ${taskId} not found.`);
+    }
+    const sessionRow = loadPersistedAgentSession(taskRow.session_id, db);
+    if (!sessionRow) {
+        throw new Error(`Session ${taskRow.session_id} not found for task ${taskId}.`);
+    }
+    const memory = hydrateAgentMemory(sessionRow, taskRow, userQuery);
+    assignMode(memory, options.planOnly === true);
+    if (options.bindAsCurrentTask !== false) {
+        setCurrentAgentTask(memory.task.id, memory.session.id, db);
+    }
+    return memory;
+}
+export function resolveAgentResumeTaskId(explicitResumeTaskId, continueCurrentTask, db = getDbForRepo()) {
+    if (typeof explicitResumeTaskId === "number") {
+        return explicitResumeTaskId;
+    }
+    if (continueCurrentTask === false) {
+        return undefined;
+    }
+    return getCurrentAgentTaskId(db);
+}
+export function beginAgentTurn(memory, userQuery, queryKind, db = getDbForRepo()) {
+    startAgentTurn(memory, userQuery, queryKind, db);
+}
+//# sourceMappingURL=boot.js.map

package/dist/agent/persistence/boot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.js","sourceRoot":"","sources":["../../../src/agent/persistence/boot.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Boots fresh and resumed modular-agent tasks through the persistence layer.\n *\n * Why this file exists:\n * - fresh asks, explicit resume, and in-memory continuation need one task boot owner\n * - runtime code should not coordinate project/session/task row creation directly\n * - current-task binding and turn start should stay aligned during boot\n */\nimport { getDbForRepo } from \"../../db/client.js\";\nimport { resolveCanonicalRepoIdentity } from \"../../utils/repoIdentity.js\";\nimport { createAgentMemory } from \"../state/memory.js\";\nimport type { AgentMemory } from \"../types.js\";\nimport { getCurrentAgentTaskId, setCurrentAgentTask } from \"./currentTask.js\";\nimport { hydrateAgentMemory } from \"./hydrate.js\";\nimport { createAgentSession, createAgentTask, loadPersistedAgentSession, loadPersistedAgentTask } from \"./tasks.js\";\nimport { startAgentTurn, type AgentTurnQueryKind } from \"./turns.js\";\n\nexport type AgentBootOptions = {\n  bindAsCurrentTask?: boolean;\n  planOnly?: boolean;\n};\n\nfunction assignMode(memory: AgentMemory, planOnly: boolean): void {\n  memory.task.mode = planOnly ? \"plan\" : \"ask\";\n}\n\nexport function bootAgentTask(\n  userQuery: string,\n  options: AgentBootOptions = {},\n  db = getDbForRepo()\n): AgentMemory {\n  const identity = resolveCanonicalRepoIdentity();\n  const memory = createAgentMemory(userQuery, identity.repoRootPath, identity.executionPath);\n  assignMode(memory, options.planOnly === true);\n  const projectId = createAgentSession(memory, db);\n  createAgentTask(memory, projectId, db);\n  if (options.bindAsCurrentTask !== false) {\n    setCurrentAgentTask(memory.task.id, memory.session.id, db);\n  }\n  return memory;\n}\n\nexport function loadAgentTask(\n  taskId: number,\n  userQuery: string,\n  options: AgentBootOptions = {},\n  db = getDbForRepo()\n): AgentMemory {\n  const taskRow = loadPersistedAgentTask(taskId, db);\n  if (!taskRow) {\n    throw new Error(`Task ${taskId} not found.`);\n  }\n  const sessionRow = loadPersistedAgentSession(taskRow.session_id, db);\n  if (!sessionRow) {\n    throw new Error(`Session ${taskRow.session_id} not found for task ${taskId}.`);\n  }\n  const memory = hydrateAgentMemory(sessionRow, taskRow, userQuery);\n  assignMode(memory, options.planOnly === true);\n  if (options.bindAsCurrentTask !== false) {\n    setCurrentAgentTask(memory.task.id, memory.session.id, db);\n  }\n  return memory;\n}\n\nexport function resolveAgentResumeTaskId(\n  explicitResumeTaskId: number | undefined,\n  continueCurrentTask: boolean | undefined,\n  db = getDbForRepo()\n): number | undefined {\n  if (typeof explicitResumeTaskId === \"number\") {\n    return explicitResumeTaskId;\n  }\n  if (continueCurrentTask === false) {\n    return undefined;\n  }\n  return getCurrentAgentTaskId(db);\n}\n\nexport function beginAgentTurn(memory: AgentMemory, userQuery: string, queryKind: AgentTurnQueryKind, db = getDbForRepo()): void {\n  startAgentTurn(memory, userQuery, queryKind, db);\n}\n"]}