@pentoshi/clai 4.11.5 → 4.11.8

package/dist/agent/turn/system-sections.js

@@ -0,0 +1,157 @@
+import { join } from "node:path";
+import { renderRequestEnvironmentContext } from "../../prompts/index.js";
+import { agentModeDirective, planModeDirective, } from "../../prompts/index.js";
+import { renderSkillCatalog } from "../../skills/catalog.js";
+import { loadScopeForSession } from "../../store/scope.js";
+import { safeCwd } from "../../os/cwd.js";
+import { analyzeTask, formatTaskAnalysisHint } from "../task-analyzer.js";
+import { buildContinueOrientation, } from "../continue-orient.js";
+import { buildWorkflowDirective, narrowNmapOperationDirective, pentestNoLocalServerDirective, pentestWorkflowDirective, } from "../tool-call-parser.js";
+import { extractProjectRootFromPlan, extractProjectRootFromText, } from "../project-root.js";
+import { buildWorkspaceOrientation, guessProjectFolderName, } from "../workspace-orient.js";
+import { scopeContextMessage } from "../scope-context.js";
+const PROJECT_ROOT_RULES = "All relative paths (./src/…, manifests, configs) resolve under this directory — NOT the agent process cwd. " +
+    "Prefer absolute paths under this root. shell cwd for install / run / build must be this root " +
+    "(or its parent when creating a NEW named subfolder with a scaffolder). " +
+    "Never write user app source into the agent package tree.";
+const DESTINATION_RULES = "Pick or detect a project subfolder; do not scaffold into the agent working tree unless the user asked for that.";
+const locationSection = (input, projectRoot) => {
+    if (projectRoot) {
+        return `ACTIVE PROJECT ROOT: ${projectRoot}\n${PROJECT_ROOT_RULES}`;
+    }
+    if (input.destinationHint) {
+        return `USER DESTINATION: create or continue work under "${input.destinationHint}" (parent folder). ${DESTINATION_RULES}`;
+    }
+    return undefined;
+};
+const workspaceSection = (input) => {
+    const guessedName = guessProjectFolderName([
+        input.prompt,
+        input.plan?.goal,
+        input.plan?.detail,
+        input.plan?.tasks.map((task) => task.title).join(" "),
+    ]
+        .filter(Boolean)
+        .join("\n"));
+    const extraPaths = [];
+    if (input.destinationHint && guessedName) {
+        extraPaths.push(join(input.destinationHint, guessedName));
+    }
+    const fromText = extractProjectRootFromPlan(input.plan) ??
+        extractProjectRootFromText(input.prompt);
+    if (fromText)
+        extraPaths.push(fromText);
+    const orientInput = { cwd: safeCwd(), extraPaths };
+    if (input.destinationHint)
+        orientInput.destinationHint = input.destinationHint;
+    const candidate = input.getProjectRoot() ?? fromText;
+    if (candidate)
+        orientInput.candidateProject = candidate;
+    return buildWorkspaceOrientation(orientInput);
+};
+const continuationSection = (input) => buildContinueOrientation({
+    prompt: input.prompt,
+    history: input.history,
+    plan: input.plan,
+    runningJobs: input.getRunningJobs(),
+    recentJobs: input.getRecentJobs(),
+    informationalQuery: input.informationalQuery,
+    idleOrSocial: input.idleOrSocialPrompt,
+    ...(input.previousTurn ? { previousTurn: input.previousTurn } : {}),
+});
+const isPentestSession = (input) => input.pentestLikeTurn ||
+    input.plan?.kind === "pentest" ||
+    (input.plan?.kind !== "coding" &&
+        Boolean(input.plan?.goal &&
+            /pentest|vulnerab|recon|security assess|attack surface|red team/i.test(input.plan.goal)));
+const workflowSections = (input) => {
+    const sections = [];
+    const workNotIdle = input.buildLikeTurn && !input.informationalQuery && !input.idleOrSocialPrompt;
+    if (input.isPlanMode) {
+        sections.push(planModeDirective());
+    }
+    else if (input.mode === "agent") {
+        sections.push(agentModeDirective());
+    }
+    if (workNotIdle && !input.isPlanMode)
+        sections.push(buildWorkflowDirective());
+    if (input.isPlanMode && workNotIdle)
+        sections.push(buildWorkflowDirective());
+    if (input.narrowNmapOperation &&
+        !input.informationalQuery &&
+        !input.idleOrSocialPrompt &&
+        !input.isPlanMode) {
+        sections.push(narrowNmapOperationDirective());
+    }
+    if (input.pentestLikeTurn &&
+        !input.narrowNmapOperation &&
+        !input.plan &&
+        !input.informationalQuery &&
+        !input.idleOrSocialPrompt) {
+        sections.push(pentestWorkflowDirective());
+    }
+    return sections;
+};
+const scopeSection = async (input, pentestSession) => {
+    const engagementScope = await loadScopeForSession(input.sessionId).catch(() => undefined);
+    const scopeBlock = scopeContextMessage(engagementScope);
+    return scopeBlock &&
+        (pentestSession || input.pentestLikeTurn) &&
+        !input.idleOrSocialPrompt
+        ? scopeBlock
+        : undefined;
+};
+const taskAnalysisSection = (input) => {
+    const analysis = analyzeTask(input.prompt);
+    const wanted = analysis.shouldPlan ||
+        analysis.complexity === "complex" ||
+        input.buildLikeTurn ||
+        input.pentestLikeTurn;
+    return !input.idleOrSocialPrompt &&
+        !input.informationalQuery &&
+        !input.narrowNmapOperation &&
+        wanted
+        ? formatTaskAnalysisHint(analysis)
+        : undefined;
+};
+const skillCatalogSection = (input) => input.skillsAvailable && !input.idleOrSocialPrompt
+    ? renderSkillCatalog({
+        skills: input.skillIndex.skills,
+        prompt: input.prompt,
+        pinned: input.selectedSkillNames,
+        truncatedScan: input.skillIndex.truncated,
+        ...(input.inputTokenBudget ? { maxTokens: 260 } : {}),
+    })
+    : undefined;
+export const buildSystemSections = async (input) => {
+    const sections = [
+        renderRequestEnvironmentContext({ plan: input.plan }),
+    ];
+    const push = (section) => {
+        if (section)
+            sections.push(section);
+    };
+    push(input.getMcpContext());
+    if (input.projectContext) {
+        push(`Project context from .clai/context.md:\n${input.projectContext}`);
+    }
+    push(locationSection(input, input.getProjectRoot()));
+    if (input.buildLikeTurn &&
+        !input.informationalQuery &&
+        !input.idleOrSocialPrompt) {
+        sections.push(workspaceSection(input));
+    }
+    if (!input.informationalQuery && !input.idleOrSocialPrompt) {
+        push(continuationSection(input));
+    }
+    sections.push(...workflowSections(input));
+    const pentestSession = isPentestSession(input);
+    if (pentestSession && !input.idleOrSocialPrompt) {
+        sections.push(pentestNoLocalServerDirective());
+    }
+    push(await scopeSection(input, pentestSession));
+    push(taskAnalysisSection(input));
+    push(skillCatalogSection(input));
+    return { sections, pentestSession };
+};
+//# sourceMappingURL=system-sections.js.map

package/dist/agent/turn/system-sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-sections.js","sourceRoot":"","sources":["../../../src/agent/turn/system-sections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACL,wBAAwB,GAEzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA8B1D,MAAM,kBAAkB,GACtB,6GAA6G;IAC7G,+FAA+F;IAC/F,yEAAyE;IACzE,0DAA0D,CAAC;AAE7D,MAAM,iBAAiB,GACrB,iHAAiH,CAAC;AAEpH,MAAM,eAAe,GAAG,CACtB,KAAyB,EACzB,WAA+B,EACX,EAAE;IACtB,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,wBAAwB,WAAW,KAAK,kBAAkB,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,OAAO,oDAAoD,KAAK,CAAC,eAAe,sBAAsB,iBAAiB,EAAE,CAAC;IAC5H,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,KAAyB,EAAU,EAAE;IAC7D,MAAM,WAAW,GAAG,sBAAsB,CACxC;QACE,KAAK,CAAC,MAAM;QACZ,KAAK,CAAC,IAAI,EAAE,IAAI;QAChB,KAAK,CAAC,IAAI,EAAE,MAAM;QAClB,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;KACtD;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;IACF,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,eAAe,IAAI,WAAW,EAAE,CAAC;QACzC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,QAAQ,GACZ,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC;QACtC,0BAA0B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,QAAQ;QAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,WAAW,GAKb,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC;IACnC,IAAI,KAAK,CAAC,eAAe;QAAE,WAAW,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC/E,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,EAAE,IAAI,QAAQ,CAAC;IACrD,IAAI,SAAS;QAAE,WAAW,CAAC,gBAAgB,GAAG,SAAS,CAAC;IACxD,OAAO,yBAAyB,CAAC,WAAW,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,KAAyB,EAAU,EAAE,CAChE,wBAAwB,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC,MAAM;IACpB,OAAO,EAAE,KAAK,CAAC,OAAO;IACtB,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,WAAW,EAAE,KAAK,CAAC,cAAc,EAAE;IACnC,UAAU,EAAE,KAAK,CAAC,aAAa,EAAE;IACjC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;IAC5C,YAAY,EAAE,KAAK,CAAC,kBAAkB;IACtC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACpE,CAAC,CAAC;AAEL,MAAM,gBAAgB,GAAG,CAAC,KAAyB,EAAW,EAAE,CAC9D,KAAK,CAAC,eAAe;IACrB,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,SAAS;IAC9B,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ;QAC5B,OAAO,CACL,KAAK,CAAC,IAAI,EAAE,IAAI;YACd,iEAAiE,CAAC,IAAI,CACpE,KAAK,CAAC,IAAI,CAAC,IAAI,CAChB,CACJ,CAAC,CAAC;AAEP,MAAM,gBAAgB,GAAG,CAAC,KAAyB,EAAY,EAAE;IAC/D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,WAAW,GACf,KAAK,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAChF,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACrC,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,WAAW,IAAI,CAAC,KAAK,CAAC,UAAU;QAAE,QAAQ,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,UAAU,IAAI,WAAW;QAAE,QAAQ,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC7E,IACE,KAAK,CAAC,mBAAmB;QACzB,CAAC,KAAK,CAAC,kBAAkB;QACzB,CAAC,KAAK,CAAC,kBAAkB;QACzB,CAAC,KAAK,CAAC,UAAU,EACjB,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,4BAA4B,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,IACE,KAAK,CAAC,eAAe;QACrB,CAAC,KAAK,CAAC,mBAAmB;QAC1B,CAAC,KAAK,CAAC,IAAI;QACX,CAAC,KAAK,CAAC,kBAAkB;QACzB,CAAC,KAAK,CAAC,kBAAkB,EACzB,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,KAAK,EACxB,KAAyB,EACzB,cAAuB,EACM,EAAE;IAC/B,MAAM,eAAe,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CACtE,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;IACF,MAAM,UAAU,GAAG,mBAAmB,CAAC,eAAe,CAAC,CAAC;IACxD,OAAO,UAAU;QACf,CAAC,cAAc,IAAI,KAAK,CAAC,eAAe,CAAC;QACzC,CAAC,KAAK,CAAC,kBAAkB;QACzB,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,KAAyB,EAAsB,EAAE;IAC5E,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GACV,QAAQ,CAAC,UAAU;QACnB,QAAQ,CAAC,UAAU,KAAK,SAAS;QACjC,KAAK,CAAC,aAAa;QACnB,KAAK,CAAC,eAAe,CAAC;IACxB,OAAO,CAAC,KAAK,CAAC,kBAAkB;QAC9B,CAAC,KAAK,CAAC,kBAAkB;QACzB,CAAC,KAAK,CAAC,mBAAmB;QAC1B,MAAM;QACN,CAAC,CAAC,sBAAsB,CAAC,QAAQ,CAAC;QAClC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAC1B,KAAyB,EACL,EAAE,CACtB,KAAK,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,kBAAkB;IAChD,CAAC,CAAC,kBAAkB,CAAC;QACjB,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM;QAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,kBAAkB;QAChC,aAAa,EAAE,KAAK,CAAC,UAAU,CAAC,SAAS;QACzC,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC;IACJ,CAAC,CAAC,SAAS,CAAC;AAEhB,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,KAAyB,EAIxB,EAAE;IACH,MAAM,QAAQ,GAAa;QACzB,+BAA+B,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;KACtD,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,OAA2B,EAAQ,EAAE;QACjD,IAAI,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;IAC5B,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,IAAI,CAAC,2CAA2C,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IACrD,IACE,KAAK,CAAC,aAAa;QACnB,CAAC,KAAK,CAAC,kBAAkB;QACzB,CAAC,KAAK,CAAC,kBAAkB,EACzB,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC3D,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,MAAM,cAAc,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,cAAc,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAChD,QAAQ,CAAC,IAAI,CAAC,6BAA6B,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,MAAM,YAAY,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;AACtC,CAAC,CAAC"}

package/dist/agent/turn/task-autostart.d.ts

@@ -0,0 +1,12 @@
+import type { ToolCall } from "../../types.js";
+import type { PlanTask, SessionPlan } from "../../store/plan.js";
+import { type TaskWorkLedger } from "../task-evidence.js";
+export interface TaskAutostartPorts {
+    readonly openTask: (taskId: string) => Promise<void>;
+    readonly renderPlan: (plan: SessionPlan) => void;
+    readonly notify: (message: string) => void;
+    readonly getLedger: () => TaskWorkLedger | null;
+    readonly setLedger: (ledger: TaskWorkLedger | null) => void;
+}
+export declare const selectAutostartTask: (plan: SessionPlan, call: ToolCall) => PlanTask | undefined;
+export declare const autostartPlanTask: (plan: SessionPlan, call: ToolCall, ports: TaskAutostartPorts) => Promise<void>;

package/dist/agent/turn/task-autostart.js

@@ -0,0 +1,35 @@
+import { markTask, readyPlanTasks } from "../../store/plan.js";
+import { isPlanPreflightTool, isReadOnlyReconTool, ledgerFromTaskEvidence, pickPendingTaskForToolCall, } from "../task-evidence.js";
+const needsAutostart = (plan) => {
+    const unfinished = plan.tasks.some((task) => !task.responderOwned &&
+        (task.state === "pending" || task.state === "in_progress"));
+    const inProgress = plan.tasks.find((task) => task.state === "in_progress" && !task.responderOwned);
+    return unfinished && !inProgress;
+};
+const gateIsSkipped = (plan, call) => isPlanPreflightTool(call.name) ||
+    (plan.kind === "pentest" && isReadOnlyReconTool(call.name));
+export const selectAutostartTask = (plan, call) => {
+    if (!needsAutostart(plan))
+        return undefined;
+    if (gateIsSkipped(plan, call))
+        return undefined;
+    const pending = readyPlanTasks(plan);
+    return (pickPendingTaskForToolCall(pending, call, plan.tasks.map((task) => task.title)) ?? pending[0]);
+};
+export const autostartPlanTask = async (plan, call, ports) => {
+    const next = selectAutostartTask(plan, call);
+    if (!next)
+        return;
+    markTask(plan, next.id, "in_progress");
+    if (plan.status === "draft" || plan.status === "approved") {
+        plan.status = "in_progress";
+    }
+    await ports.openTask(next.id);
+    const ledger = ports.getLedger();
+    if (!ledger || ledger.taskId !== next.id) {
+        ports.setLedger(ledgerFromTaskEvidence(next.id, next.evidence));
+    }
+    ports.renderPlan(plan);
+    ports.notify(`auto-started [${next.id}] so work can continue`);
+};
+//# sourceMappingURL=task-autostart.js.map

package/dist/agent/turn/task-autostart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-autostart.js","sourceRoot":"","sources":["../../../src/agent/turn/task-autostart.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,qBAAqB,CAAC;AAU7B,MAAM,cAAc,GAAG,CAAC,IAAiB,EAAW,EAAE;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAChC,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,IAAI,CAAC,cAAc;QACpB,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,aAAa,CAAC,CAC7D,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAChC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,aAAa,IAAI,CAAC,IAAI,CAAC,cAAc,CAC/D,CAAC;IACF,OAAO,UAAU,IAAI,CAAC,UAAU,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,IAAiB,EAAE,IAAc,EAAW,EAAE,CACnE,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9B,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,IAAiB,EACjB,IAAc,EACQ,EAAE;IACxB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,CACL,0BAA0B,CACxB,OAAO,EACP,IAAI,EACJ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CACrC,IAAI,OAAO,CAAC,CAAC,CAAC,CAChB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,IAAiB,EACjB,IAAc,EACd,KAAyB,EACV,EAAE;IACjB,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IACvC,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1D,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC;IAC9B,CAAC;IACD,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IACjC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;QACzC,KAAK,CAAC,SAAS,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,CAAC,MAAM,CAAC,iBAAiB,IAAI,CAAC,EAAE,wBAAwB,CAAC,CAAC;AACjE,CAAC,CAAC"}

package/dist/agent/turn/task-batch-guard.d.ts

@@ -0,0 +1,18 @@
+import type { ToolCall } from "../../types.js";
+import type { SessionPlan } from "../../store/plan.js";
+export interface TaskBatchGuardInput {
+    readonly calls: readonly ToolCall[];
+    readonly plan: SessionPlan | undefined;
+    readonly pendingSignature: string | undefined;
+}
+export interface TaskBatchNotice {
+    readonly level: "info" | "warn";
+    readonly message: string;
+}
+export interface TaskBatchGuardOutcome {
+    readonly remindCalls: ReadonlySet<ToolCall>;
+    readonly reminderNote: string;
+    readonly pendingSignature: string | undefined;
+    readonly notices: readonly TaskBatchNotice[];
+}
+export declare const evaluateTaskBatchGuard: (input: TaskBatchGuardInput) => TaskBatchGuardOutcome;

package/dist/agent/turn/task-batch-guard.js

@@ -0,0 +1,83 @@
+import { resolvePlanTaskId } from "../plan-tool.js";
+import { batchUpdateSignature, buildMultiOpenRejection, buildMultiUpdateReminder, distinctAdvancingTaskIds, isSimultaneousTaskAdvance, multiOpenToast, multiUpdateToast, openingTaskIds, readTaskUpdateArgs, } from "../task-sync.js";
+const readIntents = (input) => {
+    const intents = [];
+    for (const call of input.calls) {
+        const parsed = readTaskUpdateArgs(call);
+        if (!parsed)
+            continue;
+        const taskId = input.plan
+            ? (resolvePlanTaskId(input.plan, parsed.taskId) ?? parsed.taskId)
+            : parsed.taskId;
+        intents.push({ call, taskId, state: parsed.state });
+    }
+    return intents;
+};
+const titleFor = (plan, taskId) => plan?.tasks.find((task) => task.id === taskId)?.title ?? "";
+const rejectMultiOpen = (input, intents, openIds) => {
+    const descriptors = openIds.map((taskId) => ({
+        taskId,
+        title: titleFor(input.plan, taskId),
+        targetState: "in_progress",
+    }));
+    const remindCalls = new Set();
+    for (const intent of intents) {
+        if (intent.state === "in_progress")
+            remindCalls.add(intent.call);
+    }
+    return {
+        remindCalls,
+        reminderNote: buildMultiOpenRejection(descriptors),
+        pendingSignature: undefined,
+        notices: [{ level: "warn", message: multiOpenToast(openIds.length) }],
+    };
+};
+const holdSimultaneousAdvance = (input, intents) => {
+    const descriptors = intents.map((intent) => ({
+        taskId: intent.taskId,
+        title: titleFor(input.plan, intent.taskId),
+        targetState: intent.state,
+    }));
+    const remindCalls = new Set();
+    for (const intent of intents)
+        remindCalls.add(intent.call);
+    return {
+        remindCalls,
+        reminderNote: buildMultiUpdateReminder(descriptors),
+        pendingSignature: batchUpdateSignature(intents),
+        notices: [
+            {
+                level: "warn",
+                message: multiUpdateToast(distinctAdvancingTaskIds(intents).length),
+            },
+        ],
+    };
+};
+export const evaluateTaskBatchGuard = (input) => {
+    const intents = readIntents(input);
+    const openIds = openingTaskIds(intents);
+    if (openIds.length > 1) {
+        return rejectMultiOpen(input, intents, openIds);
+    }
+    if (!isSimultaneousTaskAdvance(intents)) {
+        return {
+            remindCalls: new Set(),
+            reminderNote: "",
+            pendingSignature: undefined,
+            notices: [],
+        };
+    }
+    const signature = batchUpdateSignature(intents);
+    if (input.pendingSignature === signature) {
+        return {
+            remindCalls: new Set(),
+            reminderNote: "",
+            pendingSignature: undefined,
+            notices: [
+                { level: "info", message: "confirmed batch task update — applying" },
+            ],
+        };
+    }
+    return holdSimultaneousAdvance(input, intents);
+};
+//# sourceMappingURL=task-batch-guard.js.map

package/dist/agent/turn/task-batch-guard.js.map

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

package/dist/agent/turn/task-credit.d.ts

@@ -0,0 +1,15 @@
+import type { ToolCall } from "../../types.js";
+import type { SessionPlan, TaskEvidence } from "../../store/plan.js";
+import { type LooseWorkReceipt, type TaskWorkLedger, type TaskWorkSignals } from "../task-evidence.js";
+export interface TaskCreditPorts {
+    readonly getLedger: () => TaskWorkLedger | null;
+    readonly setLedger: (ledger: TaskWorkLedger | null) => void;
+    readonly bankLooseWork: (receipt: LooseWorkReceipt) => void;
+    readonly persistTaskEvidence: (taskId: string, evidence: TaskEvidence) => Promise<void>;
+}
+export declare const creditSuccessfulWork: (ports: TaskCreditPorts, input: {
+    readonly call: ToolCall;
+    readonly signals: TaskWorkSignals;
+    readonly creditId: string | undefined;
+    readonly plan: SessionPlan | undefined;
+}) => Promise<void>;

package/dist/agent/turn/task-credit.js

@@ -0,0 +1,49 @@
+import { readyPlanTasks } from "../../store/plan.js";
+import { absorbLooseWorkIntoLedger, ledgerFromTaskEvidence, recordTaskWorkSuccess, taskEvidenceFromLedger, } from "../task-evidence.js";
+const absorbIntoReadyTask = async (ports, plan, call, signals) => {
+    const ready = readyPlanTasks(plan)[0];
+    if (!ready)
+        return;
+    const absorbed = absorbLooseWorkIntoLedger(ledgerFromTaskEvidence(ready.id, ready.evidence), ready.id, ready.title, [{ toolName: call.name, signals }], { planKind: plan.kind });
+    if (!absorbed || absorbed.successWorkCount === 0)
+        return;
+    const task = plan.tasks.find((candidate) => candidate.id === ready.id);
+    if (!task)
+        return;
+    task.evidence = taskEvidenceFromLedger(absorbed);
+    const live = ports.getLedger();
+    if (!live ||
+        live.taskId !== ready.id ||
+        live.successWorkCount < absorbed.successWorkCount) {
+        ports.setLedger(absorbed);
+    }
+    await ports.persistTaskEvidence(task.id, task.evidence);
+};
+const persistCreditedTask = async (ports, plan, creditId) => {
+    const ledger = ports.getLedger();
+    if (ledger?.taskId !== creditId)
+        return;
+    const task = plan.tasks.find((candidate) => candidate.id === creditId);
+    if (!task)
+        return;
+    task.evidence = taskEvidenceFromLedger(ledger);
+    await ports.persistTaskEvidence(task.id, task.evidence);
+};
+export const creditSuccessfulWork = async (ports, input) => {
+    ports.bankLooseWork({
+        toolName: input.call.name,
+        ...(Object.keys(input.signals).length > 0 ? { signals: input.signals } : {}),
+    });
+    ports.setLedger(recordTaskWorkSuccess(ports.getLedger(), input.creditId, input.call.name, input.signals));
+    if (!input.plan)
+        return;
+    const ledger = ports.getLedger();
+    const creditedElsewhere = !input.creditId || !ledger || ledger.taskId !== input.creditId;
+    if (creditedElsewhere) {
+        await absorbIntoReadyTask(ports, input.plan, input.call, input.signals);
+    }
+    if (input.creditId) {
+        await persistCreditedTask(ports, input.plan, input.creditId);
+    }
+};
+//# sourceMappingURL=task-credit.js.map

package/dist/agent/turn/task-credit.js.map

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

package/dist/agent/turn/task-gate.d.ts

@@ -0,0 +1,13 @@
+import type { SessionPlan } from "../../store/plan.js";
+import { canMarkTaskDone, type LooseWorkReceipt, type TaskWorkLedger } from "../task-evidence.js";
+export interface TaskGatePorts {
+    readonly getLiveLedger: () => TaskWorkLedger | null;
+    readonly setLiveLedger: (ledger: TaskWorkLedger) => void;
+    readonly getLooseWork: () => readonly LooseWorkReceipt[];
+    readonly featureAppRequired: boolean;
+    readonly existingProject: () => boolean;
+}
+export declare const planHasVerifiedRuntime: (plan: SessionPlan) => boolean;
+export declare const planHasVerifiedRemoteWork: (plan: SessionPlan) => boolean;
+export declare const resolveLedgerForTaskGate: (ports: TaskGatePorts, plan: SessionPlan, taskId: string) => TaskWorkLedger | null;
+export declare const evaluateTaskCompletionGate: (ports: TaskGatePorts, plan: SessionPlan, taskId: string) => ReturnType<typeof canMarkTaskDone>;

package/dist/agent/turn/task-gate.js

@@ -0,0 +1,34 @@
+import { absorbLooseWorkIntoLedger, canMarkTaskDone, hasLocalRuntimeProof, hasRemoteWorkProof, ledgerFromTaskEvidence, } from "../task-evidence.js";
+export const planHasVerifiedRuntime = (plan) => plan.tasks.some((task) => hasLocalRuntimeProof(task.evidence));
+export const planHasVerifiedRemoteWork = (plan) => plan.tasks.some((task) => hasRemoteWorkProof(task.evidence));
+const preferLiveLedger = (live, durable, taskId) => live?.taskId === taskId && live.successWorkCount >= durable.successWorkCount
+    ? live
+    : durable;
+const shouldAdoptLedger = (live, candidate, taskId) => !live ||
+    live.taskId !== taskId ||
+    live.successWorkCount < candidate.successWorkCount;
+export const resolveLedgerForTaskGate = (ports, plan, taskId) => {
+    const task = plan.tasks.find((candidate) => candidate.id === taskId);
+    const durable = ledgerFromTaskEvidence(taskId, task?.evidence);
+    const live = ports.getLiveLedger();
+    const ledger = absorbLooseWorkIntoLedger(preferLiveLedger(live, durable, taskId), taskId, task?.title ?? "", ports.getLooseWork(), { planKind: plan.kind });
+    if (ledger &&
+        ledger.successWorkCount > 0 &&
+        shouldAdoptLedger(live, ledger, taskId)) {
+        ports.setLiveLedger(ledger);
+    }
+    return ledger;
+};
+export const evaluateTaskCompletionGate = (ports, plan, taskId) => {
+    const task = plan.tasks.find((candidate) => candidate.id === taskId);
+    const ledger = resolveLedgerForTaskGate(ports, plan, taskId);
+    return canMarkTaskDone(ledger, taskId, {
+        taskTitle: task?.title,
+        featureAppRequired: ports.featureAppRequired,
+        existingProject: ports.existingProject(),
+        runtimeVerified: planHasVerifiedRuntime(plan),
+        planKind: plan.kind,
+        remoteWorkVerified: planHasVerifiedRemoteWork(plan),
+    });
+};
+//# sourceMappingURL=task-gate.js.map

package/dist/agent/turn/task-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-gate.js","sourceRoot":"","sources":["../../../src/agent/turn/task-gate.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EACzB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GAGvB,MAAM,qBAAqB,CAAC;AAU7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAAiB,EAAW,EAAE,CACnE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,IAAiB,EAAW,EAAE,CACtE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE/D,MAAM,gBAAgB,GAAG,CACvB,IAA2B,EAC3B,OAAuB,EACvB,MAAc,EACE,EAAE,CAClB,IAAI,EAAE,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,gBAAgB,IAAI,OAAO,CAAC,gBAAgB;IAC1E,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,OAAO,CAAC;AAEd,MAAM,iBAAiB,GAAG,CACxB,IAA2B,EAC3B,SAAyB,EACzB,MAAc,EACL,EAAE,CACX,CAAC,IAAI;IACL,IAAI,CAAC,MAAM,KAAK,MAAM;IACtB,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC,gBAAgB,CAAC;AAErD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,KAAoB,EACpB,IAAiB,EACjB,MAAc,EACS,EAAE;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,yBAAyB,CACtC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EACvC,MAAM,EACN,IAAI,EAAE,KAAK,IAAI,EAAE,EACjB,KAAK,CAAC,YAAY,EAAE,EACpB,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CACxB,CAAC;IACF,IACE,MAAM;QACN,MAAM,CAAC,gBAAgB,GAAG,CAAC;QAC3B,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EACvC,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,KAAoB,EACpB,IAAiB,EACjB,MAAc,EACsB,EAAE;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7D,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE;QACrC,SAAS,EAAE,IAAI,EAAE,KAAK;QACtB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE;QACxC,eAAe,EAAE,sBAAsB,CAAC,IAAI,CAAC;QAC7C,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,kBAAkB,EAAE,yBAAyB,CAAC,IAAI,CAAC;KACpD,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/agent/turn/task-update-gate.d.ts

@@ -0,0 +1,13 @@
+import type { SessionPlan } from "../../store/plan.js";
+export interface TaskUpdateRequest {
+    readonly state: string;
+    readonly taskId: string;
+}
+export type TaskUpdateGateResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+export declare const parseTaskUpdateRequest: (args: Record<string, unknown>) => TaskUpdateRequest;
+export declare const decideTaskUpdateDoneGate: (plan: SessionPlan | undefined, taskId: string, completionGate: (plan: SessionPlan, taskId: string) => TaskUpdateGateResult) => TaskUpdateGateResult;

package/dist/agent/turn/task-update-gate.js

@@ -0,0 +1,40 @@
+export const parseTaskUpdateRequest = (args) => ({
+    state: typeof args.state === "string" ? args.state : "",
+    taskId: typeof args.taskId === "string"
+        ? args.taskId
+        : typeof args.id === "string"
+            ? args.id
+            : "",
+});
+const dependenciesIncomplete = (plan, taskId) => {
+    const task = plan.tasks.find((candidate) => candidate.id === taskId);
+    return (task?.dependencies?.some((dependency) => {
+        const dependencyTask = plan.tasks.find((candidate) => candidate.id === dependency);
+        return (!dependencyTask ||
+            (dependencyTask.state !== "done" && dependencyTask.state !== "skipped"));
+    }) ?? false);
+};
+export const decideTaskUpdateDoneGate = (plan, taskId, completionGate) => {
+    if (!plan) {
+        return {
+            ok: false,
+            reason: `Task ${taskId} cannot be marked done because its active plan is unavailable.`,
+        };
+    }
+    const target = plan.tasks.find((candidate) => candidate.id === taskId);
+    const canSoftComplete = target?.state === "pending" && !dependenciesIncomplete(plan, taskId);
+    if (target?.state === "in_progress" || canSoftComplete) {
+        return completionGate(plan, taskId);
+    }
+    if (target?.state === "failed") {
+        return {
+            ok: false,
+            reason: `Task ${taskId} is failed — retry with in_progress first, then mark done after recovery work.`,
+        };
+    }
+    return {
+        ok: false,
+        reason: `Task ${taskId} must be in_progress before it can be marked done. Start or retry the task, perform fresh work, then complete it.`,
+    };
+};
+//# sourceMappingURL=task-update-gate.js.map

package/dist/agent/turn/task-update-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-update-gate.js","sourceRoot":"","sources":["../../../src/agent/turn/task-update-gate.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,IAA6B,EACV,EAAE,CAAC,CAAC;IACvB,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACvD,MAAM,EACJ,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAC7B,CAAC,CAAC,IAAI,CAAC,MAAM;QACb,CAAC,CAAC,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;YAC3B,CAAC,CAAC,IAAI,CAAC,EAAE;YACT,CAAC,CAAC,EAAE;CACX,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,CAC7B,IAAiB,EACjB,MAAc,EACL,EAAE;IACX,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACrE,OAAO,CACL,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;QACtC,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CACpC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,UAAU,CAC3C,CAAC;QACF,OAAO,CACL,CAAC,cAAc;YACf,CAAC,cAAc,CAAC,KAAK,KAAK,MAAM,IAAI,cAAc,CAAC,KAAK,KAAK,SAAS,CAAC,CACxE,CAAC;IACJ,CAAC,CAAC,IAAI,KAAK,CACZ,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,IAA6B,EAC7B,MAAc,EACd,cAA2E,EACrD,EAAE;IACxB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,QAAQ,MAAM,gEAAgE;SACvF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACvE,MAAM,eAAe,GACnB,MAAM,EAAE,KAAK,KAAK,SAAS,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvE,IAAI,MAAM,EAAE,KAAK,KAAK,aAAa,IAAI,eAAe,EAAE,CAAC;QACvD,OAAO,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,MAAM,EAAE,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,QAAQ,MAAM,gFAAgF;SACvG,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,QAAQ,MAAM,mHAAmH;KAC1I,CAAC;AACJ,CAAC,CAAC"}

package/dist/agent/turn/task-work-signals.d.ts

@@ -0,0 +1,3 @@
+import type { ToolCall } from "../../types.js";
+import type { TaskWorkSignals } from "../task-evidence.js";
+export declare const readTaskWorkSignals: (call: ToolCall, output: string) => TaskWorkSignals;

package/dist/agent/turn/task-work-signals.js

@@ -0,0 +1,44 @@
+import { isDevServerCall, isFeatureImplementationCall, isPackageInstallCommand, isPortListeningOutput, isRemoteActiveTestCall, isRemoteReconToolCall, isScaffoldCreateCommand, isServerReadyOutput, } from "../task-evidence.js";
+import { localHttpProbeIsSuccess } from "../tool-call-parser.js";
+const SOURCE_WRITE_TOOLS = new Set([
+    "fs.write",
+    "fs.writeMany",
+    "fs.edit",
+    "fs.replaceLines",
+    "fs.append",
+]);
+const isShellLaunch = (name) => name === "shell.exec" || name === "shell.start";
+const mentionsLoopback = (call, command) => /\b(localhost|127\.0\.0\.1)\b/i.test(`${call.name} ${command} ${JSON.stringify(call.args)}`);
+export const readTaskWorkSignals = (call, output) => {
+    const command = typeof call.args.command === "string" ? call.args.command : "";
+    const signals = {};
+    if (isFeatureImplementationCall(call))
+        signals.featureWrite = true;
+    if (SOURCE_WRITE_TOOLS.has(call.name))
+        signals.sourceWrite = true;
+    if (isShellLaunch(call.name) && isPackageInstallCommand(command)) {
+        signals.installOk = true;
+    }
+    if (isShellLaunch(call.name) && isScaffoldCreateCommand(command)) {
+        signals.scaffoldOk = true;
+    }
+    if (isDevServerCall(call))
+        signals.devServerStart = true;
+    if ((call.name === "shell.tail" || call.name === "shell.start") &&
+        isServerReadyOutput(output)) {
+        signals.serverReady = true;
+    }
+    if (call.name === "shell.exec" && isPortListeningOutput(command, output)) {
+        signals.portListening = true;
+    }
+    if (localHttpProbeIsSuccess(output) &&
+        mentionsLoopback(call, command)) {
+        signals.localHttpProbeOk = true;
+    }
+    if (isRemoteReconToolCall(call))
+        signals.remoteReconOk = true;
+    if (isRemoteActiveTestCall(call))
+        signals.remoteActiveTestOk = true;
+    return signals;
+};
+//# sourceMappingURL=task-work-signals.js.map

package/dist/agent/turn/task-work-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-work-signals.js","sourceRoot":"","sources":["../../../src/agent/turn/task-work-signals.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC;IACtD,UAAU;IACV,cAAc;IACd,SAAS;IACT,iBAAiB;IACjB,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,IAAY,EAAW,EAAE,CAC9C,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,aAAa,CAAC;AAElD,MAAM,gBAAgB,GAAG,CAAC,IAAc,EAAE,OAAe,EAAW,EAAE,CACpE,+BAA+B,CAAC,IAAI,CAClC,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvD,CAAC;AAEJ,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,IAAc,EACd,MAAc,EACG,EAAE;IACnB,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,IAAI,2BAA2B,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IACnE,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAClE,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,uBAAuB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAC3B,CAAC;IACD,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,uBAAuB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAC5B,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IACzD,IACE,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC;QAC3D,mBAAmB,CAAC,MAAM,CAAC,EAC3B,CAAC;QACD,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAC7B,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;QACzE,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAC/B,CAAC;IACD,IACE,uBAAuB,CAAC,MAAM,CAAC;QAC/B,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,EAC/B,CAAC;QACD,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAClC,CAAC;IACD,IAAI,qBAAqB,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAC9D,IAAI,sBAAsB,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IACpE,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/agent/turn/tool-call-preparation.d.ts

@@ -0,0 +1,20 @@
+import type { ToolCall, ToolResult } from "../../types.js";
+import type { SalvagedWrite } from "../tool-call-parser.js";
+import type { SingleToolResult } from "./contracts.js";
+export interface InvalidToolCall {
+    readonly reason: string;
+    readonly result: ToolResult;
+}
+export declare const invalidToolCall: (call: ToolCall) => InvalidToolCall | undefined;
+export interface PromptMutex {
+    readonly acquire: () => Promise<() => void>;
+}
+export declare const createPromptMutex: () => PromptMutex;
+export declare const salvagedWriteCall: (salvaged: SalvagedWrite) => ToolCall;
+export interface SalvagedWriteReceipt {
+    readonly ok: boolean;
+    readonly cancelled: boolean;
+    readonly output: string;
+    readonly bytesOnDisk: number;
+}
+export declare const readSalvagedWriteReceipt: (salvaged: SalvagedWrite, executed: SingleToolResult) => Promise<SalvagedWriteReceipt>;