@pentoshi/clai 4.11.7 → 4.11.9

package/dist/agent/turn/outcome-accounting.d.ts

@@ -0,0 +1,27 @@
+import type { ChatMessage, ToolCall, ToolResult } from "../../types.js";
+import type { OutcomeEnvelope } from "../outcomes.js";
+import { type GovernorState } from "../evidence-governor.js";
+export interface OutcomeAccountingState {
+    retryDependenciesChanged: boolean;
+    retryEnvironmentChanged: boolean;
+    governorState: GovernorState;
+    governorReflects: number;
+    lastGovernorReason: string | undefined;
+}
+export interface OutcomeAccountingPorts {
+    readonly outcomeState: OutcomeEnvelope;
+    readonly maxSteps: number;
+    readonly codingSession: boolean;
+    readonly attemptCount: (call: ToolCall) => number;
+    readonly moveTurn: (to: "exploring", reason: string) => void;
+    readonly deferMessage: (message: ChatMessage) => void;
+}
+export interface OutcomeAccountingInput {
+    readonly call: ToolCall;
+    readonly result: ToolResult;
+    readonly toolEventId: string;
+    readonly artifactPath: string | undefined;
+    readonly dispatchedTaskId: string | undefined;
+    readonly probeStateKey: string | undefined;
+}
+export declare const accountToolOutcome: (ports: OutcomeAccountingPorts, state: OutcomeAccountingState, input: OutcomeAccountingInput) => void;

package/dist/agent/turn/outcome-accounting.js

@@ -0,0 +1,91 @@
+import { recordFailedHypothesis, recordToolEvidence, } from "../outcomes.js";
+import { governProgress } from "../evidence-governor.js";
+import { isPackageInstallCommand } from "../task-evidence.js";
+import { isProtocolPlaceholderOutput } from "../progress-pause-policy.js";
+const DEPENDENCY_MUTATING_TOOL = /^(?:fs\.(?:write|writeMany|edit|replaceLines|append|delete)|pkg\.install)$/;
+const DEPENDENCY_MUTATING_COMMAND = /\b(?:install|mkdir|create|generate|build)\b/i;
+const isShellLaunch = (name) => name === "shell.exec" || name === "shell.start";
+const applyFailure = (ports, state, input) => {
+    const before = ports.outcomeState.failedHypotheses.length;
+    recordFailedHypothesis(ports.outcomeState, {
+        signature: `${input.call.name}:${input.result.exitCode ?? 1}`,
+        premise: `${input.call.name} with ${JSON.stringify(input.call.args).slice(0, 1_000)}`,
+    });
+    state.retryDependenciesChanged = false;
+    state.retryEnvironmentChanged = false;
+    ports.moveTurn("exploring", `${input.call.name} failed; revise the premise`);
+    return ports.outcomeState.failedHypotheses.length - before;
+};
+const applySuccess = (state, input) => {
+    const command = String(input.call.args.command ?? "");
+    const mutatesDependencies = DEPENDENCY_MUTATING_TOOL.test(input.call.name) ||
+        (isShellLaunch(input.call.name) &&
+            DEPENDENCY_MUTATING_COMMAND.test(command));
+    state.retryDependenciesChanged ||= mutatesDependencies;
+    state.retryEnvironmentChanged ||=
+        input.call.name === "pkg.install" ||
+            (isShellLaunch(input.call.name) && isPackageInstallCommand(command));
+};
+const governorMessage = (reason, reflects) => {
+    if (reflects <= 1) {
+        return `PROGRESS GOVERNOR: ${reason}. Reassess the current premise and choose the next action that can produce criterion-linked evidence.`;
+    }
+    if (reflects === 2) {
+        return (`PROGRESS GOVERNOR: ${reason}. Update the plan to match what you now know — ` +
+            "task.update the current task, task.add the discovery, or task.update done what the evidence already settles — before running more tools.");
+    }
+    return ("PROGRESS GOVERNOR: this line of work has stopped producing new evidence. " +
+        "Either take a materially different approach with a concrete new premise, or stop and report what is done, what is blocked, and what remains — honestly. " +
+        "If the user asked you to stop or only to report, finish now with the accurate status; do not keep calling tools past that request.");
+};
+const governActivity = (ports, state, input, evidenceDelta, hypothesisDelta) => {
+    const governed = governProgress(state.governorState, "activity", {
+        evidenceDelta,
+        hypothesisDelta,
+        repetitionScore: ports.attemptCount(input.call) > 1 ? 1 : 0,
+        policy: {
+            resourceEnvelope: Math.max(12, ports.maxSteps),
+            emergencyCeiling: ports.codingSession
+                ? Math.max(200, ports.maxSteps * 5)
+                : Math.max(70, ports.maxSteps * 3),
+            reflectionAfterNoDelta: ports.codingSession ? 5 : 3,
+            pauseAfterNoDelta: ports.codingSession ? 24 : 6,
+            repetitionThreshold: 0.8,
+        },
+    });
+    state.governorState = governed.state;
+    if (governed.recommendation !== "reflect")
+        return;
+    if (governed.reason === state.lastGovernorReason)
+        return;
+    state.lastGovernorReason = governed.reason;
+    state.governorReflects += 1;
+    ports.deferMessage({
+        role: "system",
+        content: governorMessage(governed.reason, state.governorReflects),
+    });
+};
+export const accountToolOutcome = (ports, state, input) => {
+    const newEvidence = recordToolEvidence(ports.outcomeState, {
+        tool: input.call.name,
+        callId: input.toolEventId,
+        ok: input.result.ok,
+        ...(input.result.exitCode !== undefined
+            ? { exitCode: input.result.exitCode }
+            : {}),
+        output: input.result.output,
+        ...(input.artifactPath ? { artifact: input.artifactPath } : {}),
+        ...(input.dispatchedTaskId ? { taskId: input.dispatchedTaskId } : {}),
+        ...(input.probeStateKey ? { stateKey: input.probeStateKey } : {}),
+        args: input.call.args,
+    });
+    const hypothesisDelta = input.result.ok
+        ? 0
+        : applyFailure(ports, state, input);
+    if (input.result.ok)
+        applySuccess(state, input);
+    if (isProtocolPlaceholderOutput(input.result.output))
+        return;
+    governActivity(ports, state, input, newEvidence.length, hypothesisDelta);
+};
+//# sourceMappingURL=outcome-accounting.js.map

package/dist/agent/turn/outcome-accounting.js.map

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

package/dist/agent/turn/plan-mode-gate.d.ts

@@ -0,0 +1,16 @@
+import type { ToolCall } from "../../types.js";
+export interface PlanModeGateInput {
+    readonly call: ToolCall;
+    readonly isPlanMode: boolean;
+    readonly planApproved: boolean;
+    readonly scratchDir: string;
+    readonly mcpSafe: boolean;
+}
+export type PlanModeGateDecision = {
+    readonly blocked: false;
+} | {
+    readonly blocked: true;
+    readonly reason: string;
+};
+export declare const PLAN_MODE_BLOCK_SUFFIX: string;
+export declare const decidePlanModeGate: (input: PlanModeGateInput) => PlanModeGateDecision;

package/dist/agent/turn/plan-mode-gate.js

@@ -0,0 +1,36 @@
+import { isPlanModeAllowedShellCommand, isPlanModeAllowedTool, } from "../session-policy.js";
+import { isScratchOnlyWrite } from "../scratch-write.js";
+const commandUnderReview = (call) => {
+    if (call.name === "terminal.send") {
+        return typeof call.args.text === "string" ? call.args.text : "";
+    }
+    return typeof call.args.command === "string" ? call.args.command : "";
+};
+const shellIsBlocked = (call) => {
+    if (call.name === "terminal.start" || call.name === "terminal.send") {
+        return true;
+    }
+    if (call.name !== "shell.exec" && call.name !== "shell.start")
+        return false;
+    return !isPlanModeAllowedShellCommand(commandUnderReview(call));
+};
+export const PLAN_MODE_BLOCK_SUFFIX = "is blocked (gather-only). " +
+    "Use any recon/enum/scan/research tool; do not write project files or run active exploits. " +
+    "Put exploit/implement steps in plan.create tasks for after accept. " +
+    "Accept the plan (y/i or /implement) to switch to agent and execute.";
+export const decidePlanModeGate = (input) => {
+    if (!input.isPlanMode || input.planApproved)
+        return { blocked: false };
+    if (isScratchOnlyWrite(input.call, input.scratchDir)) {
+        return { blocked: false };
+    }
+    const allowed = (isPlanModeAllowedTool(input.call.name) || input.mcpSafe) &&
+        !shellIsBlocked(input.call);
+    if (allowed)
+        return { blocked: false };
+    return {
+        blocked: true,
+        reason: `plan mode — ${input.call.name} ${PLAN_MODE_BLOCK_SUFFIX}`,
+    };
+};
+//# sourceMappingURL=plan-mode-gate.js.map

package/dist/agent/turn/plan-mode-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode-gate.js","sourceRoot":"","sources":["../../../src/agent/turn/plan-mode-gate.ts"],"names":[],"mappings":"AACA,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAczD,MAAM,kBAAkB,GAAG,CAAC,IAAc,EAAU,EAAE;IACpD,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QAClC,OAAO,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACxE,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,IAAc,EAAW,EAAE;IACjD,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,KAAK,CAAC;IAC5E,OAAO,CAAC,6BAA6B,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GACjC,4BAA4B;IAC5B,4FAA4F;IAC5F,qEAAqE;IACrE,qEAAqE,CAAC;AAExE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAwB,EACF,EAAE;IACxB,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACvE,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IACD,MAAM,OAAO,GACX,CAAC,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC;QACzD,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACvC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,eAAe,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,sBAAsB,EAAE;KACnE,CAAC;AACJ,CAAC,CAAC"}

package/dist/agent/turn/plan-persistence.d.ts

@@ -0,0 +1,28 @@
+import type { ChatMessage } from "../../types.js";
+import type { SessionPlan } from "../../store/plan.js";
+import type { TaskEvidence } from "../../store/plan.js";
+export type PlanMutator = (mutator: (draft: SessionPlan) => boolean | void) => Promise<unknown>;
+export declare const persistProjectRootOnPlan: (mutatePlan: PlanMutator, root: string) => Promise<void>;
+export declare const persistTaskEvidence: (mutatePlan: PlanMutator, taskId: string, evidence: TaskEvidence) => Promise<void>;
+export interface SessionStateRefreshPorts {
+    readonly messages: ChatMessage[];
+    readonly prompt: string;
+    readonly requestContextMessage: string;
+    readonly refreshInjectedBlocks: () => void;
+    readonly suppressed: () => boolean;
+    readonly activePlan: () => SessionPlan | undefined;
+    readonly planApproved: () => boolean;
+    readonly runningJobs: () => readonly unknown[];
+    readonly projectRoot: () => string | undefined;
+    readonly requiresState: () => boolean;
+    readonly snapshotFlags: () => {
+        featureAppRequired: boolean;
+        featureSeen: boolean;
+        scaffoldOk: boolean;
+        serverStarted: boolean;
+        serverProbedOk: boolean;
+        lastProbeFailed: boolean;
+        pentestSession: boolean;
+    };
+}
+export declare const createSessionStateRefresher: (ports: SessionStateRefreshPorts) => (plan?: SessionPlan | null | undefined) => void;

package/dist/agent/turn/plan-persistence.js

@@ -0,0 +1,56 @@
+import { patchPlanMeta } from "../../store/plan.js";
+import { detectPackageManager } from "../workspace-orient.js";
+import { buildSessionStateBlock, upsertSessionStateMessage, } from "../session-state.js";
+import { upsertRequestContextMessage } from "../../llm/system-messages.js";
+import { planContextMessage, removePlanContextMessage, upsertPlanContextMessage, } from "../plan-tool.js";
+import { buildTurnSessionStateSnapshot } from "./session-state-projection.js";
+export const persistProjectRootOnPlan = async (mutatePlan, root) => {
+    const packageManager = detectPackageManager(root);
+    await mutatePlan((draft) => {
+        patchPlanMeta(draft, {
+            projectRoot: root,
+            ...(packageManager ? { packageManager } : {}),
+        });
+    }).catch(() => undefined);
+};
+export const persistTaskEvidence = async (mutatePlan, taskId, evidence) => {
+    await mutatePlan((draft) => {
+        const task = draft.tasks.find((candidate) => candidate.id === taskId);
+        if (!task)
+            return false;
+        task.evidence = evidence;
+    }).catch(() => undefined);
+};
+export const createSessionStateRefresher = (ports) => (plan) => {
+    ports.refreshInjectedBlocks();
+    if (ports.suppressed())
+        return;
+    const runningJobs = ports.runningJobs();
+    const live = plan === null ? undefined : (plan ?? ports.activePlan());
+    if (!ports.requiresState() && !live && runningJobs.length === 0) {
+        if (plan === null)
+            removePlanContextMessage(ports.messages);
+        return;
+    }
+    const root = ports.projectRoot() ?? live?.meta?.projectRoot;
+    const packageManager = live?.meta?.packageManager ??
+        (root ? detectPackageManager(root) : undefined);
+    const flags = ports.snapshotFlags();
+    const snapshot = buildTurnSessionStateSnapshot({
+        plan: live,
+        prompt: ports.prompt,
+        projectRoot: root,
+        packageManager,
+        runningJobs: runningJobs,
+        ...flags,
+    });
+    upsertRequestContextMessage(ports.messages, ports.requestContextMessage);
+    if (live) {
+        upsertPlanContextMessage(ports.messages, planContextMessage(live, ports.planApproved()));
+    }
+    else {
+        removePlanContextMessage(ports.messages);
+    }
+    upsertSessionStateMessage(ports.messages, buildSessionStateBlock(snapshot));
+};
+//# sourceMappingURL=plan-persistence.js.map

package/dist/agent/turn/plan-persistence.js.map

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

package/dist/agent/turn/prompt-sections.d.ts

@@ -0,0 +1,9 @@
+import type { Mode } from "../../types.js";
+import type { AgentPromptSection } from "../prompt-composer.js";
+export interface PromptSectionInput {
+    readonly systemSections: readonly string[];
+    readonly selectedSkillNames: readonly string[];
+    readonly prompt: string;
+    readonly mode: Mode;
+}
+export declare const buildPromptSections: (input: PromptSectionInput) => AgentPromptSection[];

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

@@ -0,0 +1,67 @@
+import { SKILLS_CATALOG_PREFIX } from "../../skills/catalog.js";
+const KIND_RULES = [
+    { matches: (c) => c.startsWith(SKILLS_CATALOG_PREFIX), kind: "context" },
+    { matches: (c) => c.startsWith("ACTIVE PLAN"), kind: "plan" },
+    { matches: (c) => c.startsWith("ENGAGEMENT SCOPE"), kind: "scope" },
+    { matches: (c) => c.includes("MODE"), kind: "mode" },
+    { matches: (c) => c.includes("OUTCOME"), kind: "outcome" },
+    {
+        matches: (c) => c.includes("WORKFLOW") ||
+            c.includes("FOCUS") ||
+            c.startsWith("WORK PROFILE"),
+        kind: "focus",
+    },
+];
+const sectionKind = (content) => KIND_RULES.find((rule) => rule.matches(content))?.kind ?? "context";
+const MANDATORY_PREFIXES = [
+    "ACTIVE PLAN",
+    "MCP TOOL CONTEXT",
+    "ENGAGEMENT SCOPE",
+    "REQUEST ENVIRONMENT",
+    "Project context from .clai/context.md:",
+    "ACTIVE PROJECT ROOT:",
+    "USER DESTINATION:",
+    "WORKSPACE STATUS",
+];
+const isMandatory = (content, hasSelectedSkills) => content.startsWith(SKILLS_CATALOG_PREFIX)
+    ? hasSelectedSkills
+    : MANDATORY_PREFIXES.some((prefix) => content.startsWith(prefix)) ||
+        content.includes("MODE") ||
+        content.includes("OUTCOME");
+const outcomeContract = (prompt) => ({
+    kind: "outcome",
+    content: `OUTCOME CONTRACT\nGoal: ${prompt}\nDecide first what this request actually asks for: a question or doubt is satisfied by an accurate, grounded answer, while a directive to change something is satisfied only by the verified change. Success requires evidence that whichever of those the user asked for is delivered; otherwise return partial, blocked, failed, aborted, or paused_budget with remaining criteria.`,
+    mandatory: true,
+});
+const planProtocol = {
+    kind: "plan",
+    content: "PLAN PROTOCOL\nWhen a live plan exists, the most recent ACTIVE PLAN message in this request is the only authoritative plan state; older ACTIVE PLAN copies in the transcript are history. Never rely on plan details quoted in earlier turns when they disagree with the latest task list.",
+    mandatory: true,
+};
+const emptyScope = {
+    kind: "scope",
+    content: "ENGAGEMENT SCOPE\nNo active remote-security scope applies to this turn.",
+    mandatory: true,
+};
+export const buildPromptSections = (input) => {
+    const hasSelectedSkills = input.selectedSkillNames.length > 0;
+    const sections = input.systemSections.map((content) => ({
+        kind: sectionKind(content),
+        content,
+        mandatory: isMandatory(content, hasSelectedSkills),
+    }));
+    const has = (kind) => sections.some((section) => section.kind === kind);
+    if (!has("outcome"))
+        sections.push(outcomeContract(input.prompt));
+    if (!has("plan"))
+        sections.push(planProtocol);
+    if (!has("scope"))
+        sections.push(emptyScope);
+    sections.push({
+        kind: "context",
+        content: `TASK STATE\nMode: ${input.mode}. Current request: ${input.prompt}`,
+        mandatory: true,
+    });
+    return sections;
+};
+//# sourceMappingURL=prompt-sections.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-sections.js","sourceRoot":"","sources":["../../../src/agent/turn/prompt-sections.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAShE,MAAM,UAAU,GAGX;IACH,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;IACxE,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;IAC7D,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE;IACnE,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;IACpD,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;IAC1D;QACE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CACb,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;YACtB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YACnB,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC;QAC9B,IAAI,EAAE,OAAO;KACd;CACF,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,OAAe,EAA8B,EAAE,CAClE,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,IAAI,SAAS,CAAC;AAEtE,MAAM,kBAAkB,GAAG;IACzB,aAAa;IACb,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;IACrB,wCAAwC;IACxC,sBAAsB;IACtB,mBAAmB;IACnB,kBAAkB;CACV,CAAC;AAEX,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,iBAA0B,EAAW,EAAE,CAC3E,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC;IACvC,CAAC,CAAC,iBAAiB;IACnB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AAElC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAsB,EAAE,CAAC,CAAC;IAC/D,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,2BAA2B,MAAM,wXAAwX;IACla,SAAS,EAAE,IAAI;CAChB,CAAC,CAAC;AAEH,MAAM,YAAY,GAAuB;IACvC,IAAI,EAAE,MAAM;IACZ,OAAO,EACL,4RAA4R;IAC9R,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF,MAAM,UAAU,GAAuB;IACrC,IAAI,EAAE,OAAO;IACb,OAAO,EACL,yEAAyE;IAC3E,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAAyB,EACH,EAAE;IACxB,MAAM,iBAAiB,GAAG,KAAK,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAyB,KAAK,CAAC,cAAc,CAAC,GAAG,CAC7D,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACZ,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC;QAC1B,OAAO;QACP,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE,iBAAiB,CAAC;KACnD,CAAC,CACH,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,IAAgC,EAAW,EAAE,CACxD,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,QAAQ,CAAC,IAAI,CAAC;QACZ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,qBAAqB,KAAK,CAAC,IAAI,sBAAsB,KAAK,CAAC,MAAM,EAAE;QAC5E,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/agent/turn/responder-claims.d.ts

@@ -0,0 +1,16 @@
+import type { ResponderNotification } from "../../tools/jobs.js";
+export interface ResponderClaimPorts {
+    readonly getPendingNotifications: () => readonly ResponderNotification[];
+    readonly releaseClaim: (notificationId: string) => void;
+}
+export declare class ResponderClaimLedger {
+    private readonly ports;
+    private readonly claimed;
+    constructor(ports: ResponderClaimPorts);
+    add(notificationId: string): void;
+    delete(notificationId: string): void;
+    has(notificationId: string): boolean;
+    get size(): number;
+    ids(): string[];
+    release(): void;
+}

package/dist/agent/turn/responder-claims.js

@@ -0,0 +1,37 @@
+const deliveryInFlight = (notification) => Boolean(notification?.deliveryStartedAt &&
+    !notification.readAt &&
+    !notification.analyzedAt &&
+    !notification.acknowledgedAt);
+export class ResponderClaimLedger {
+    ports;
+    claimed = new Set();
+    constructor(ports) {
+        this.ports = ports;
+    }
+    add(notificationId) {
+        this.claimed.add(notificationId);
+    }
+    delete(notificationId) {
+        this.claimed.delete(notificationId);
+    }
+    has(notificationId) {
+        return this.claimed.has(notificationId);
+    }
+    get size() {
+        return this.claimed.size;
+    }
+    ids() {
+        return [...this.claimed];
+    }
+    release() {
+        const pending = new Map(this.ports
+            .getPendingNotifications()
+            .map((notification) => [notification.id, notification]));
+        for (const notificationId of this.claimed) {
+            if (deliveryInFlight(pending.get(notificationId)))
+                continue;
+            this.ports.releaseClaim(notificationId);
+        }
+    }
+}
+//# sourceMappingURL=responder-claims.js.map

package/dist/agent/turn/responder-claims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responder-claims.js","sourceRoot":"","sources":["../../../src/agent/turn/responder-claims.ts"],"names":[],"mappings":"AAOA,MAAM,gBAAgB,GAAG,CACvB,YAA+C,EACtC,EAAE,CACX,OAAO,CACL,YAAY,EAAE,iBAAiB;IAC7B,CAAC,YAAY,CAAC,MAAM;IACpB,CAAC,YAAY,CAAC,UAAU;IACxB,CAAC,YAAY,CAAC,cAAc,CAC/B,CAAC;AAEJ,MAAM,OAAO,oBAAoB;IAGF;IAFZ,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAE7C,YAA6B,KAA0B;QAA1B,UAAK,GAAL,KAAK,CAAqB;IAAG,CAAC;IAE3D,GAAG,CAAC,cAAsB;QACxB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,cAAsB;QAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,cAAsB;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,IAAI,CAAC,KAAK;aACP,uBAAuB,EAAE;aACzB,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,CAC1D,CAAC;QACF,KAAK,MAAM,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1C,IAAI,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAAE,SAAS;YAC5D,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;CACF"}

package/dist/agent/turn/responder-dependency.d.ts

@@ -0,0 +1,3 @@
+import type { SessionPlan } from "../../store/plan.js";
+import type { BackgroundJob, ResponderNotification } from "../../tools/jobs.js";
+export declare function shouldYieldForDeclaredResponderDependency(plan: SessionPlan | undefined, runningJobs: readonly BackgroundJob[], notifications: readonly ResponderNotification[], currentNotificationId?: string | undefined): boolean;

package/dist/agent/turn/responder-dependency.js

@@ -0,0 +1,36 @@
+const hasLiveResponderJob = (child, runningJobs) => runningJobs.some((job) => job.responder &&
+    (job.taskId === child.id || (!!child.jobId && job.id === child.jobId)));
+const hasPendingResponderResult = (child, notifications, currentNotificationId) => notifications.some((notification) => notification.responder &&
+    !notification.archivedAt &&
+    !notification.readAt &&
+    !notification.analyzedAt &&
+    (!currentNotificationId || notification.id !== currentNotificationId) &&
+    (notification.taskId === child.id ||
+        (!!child.jobId && notification.jobId === child.jobId)));
+const isLiveChild = (child, runningJobs, notifications, currentNotificationId) => {
+    if (child.state === "done" ||
+        child.state === "skipped" ||
+        child.state === "failed") {
+        return false;
+    }
+    if (hasLiveResponderJob(child, runningJobs))
+        return true;
+    return hasPendingResponderResult(child, notifications, currentNotificationId);
+};
+export function shouldYieldForDeclaredResponderDependency(plan, runningJobs, notifications, currentNotificationId) {
+    if (!plan)
+        return false;
+    const unfinished = plan.tasks.filter((task) => !task.responderOwned &&
+        (task.state === "pending" || task.state === "in_progress"));
+    if (unfinished.length === 0)
+        return false;
+    const childById = new Map(plan.tasks
+        .filter((task) => task.responderOwned)
+        .map((task) => [task.id, task]));
+    return unfinished.every((task) => (task.dependencies ?? []).some((dependency) => {
+        const child = childById.get(dependency);
+        return (!!child &&
+            isLiveChild(child, runningJobs, notifications, currentNotificationId));
+    }));
+}
+//# sourceMappingURL=responder-dependency.js.map

package/dist/agent/turn/responder-dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responder-dependency.js","sourceRoot":"","sources":["../../../src/agent/turn/responder-dependency.ts"],"names":[],"mappings":"AAGA,MAAM,mBAAmB,GAAG,CAC1B,KAAe,EACf,WAAqC,EAC5B,EAAE,CACX,WAAW,CAAC,IAAI,CACd,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,SAAS;IACb,CAAC,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CACzE,CAAC;AAEJ,MAAM,yBAAyB,GAAG,CAChC,KAAe,EACf,aAA+C,EAC/C,qBAAyC,EAChC,EAAE,CACX,aAAa,CAAC,IAAI,CAChB,CAAC,YAAY,EAAE,EAAE,CACf,YAAY,CAAC,SAAS;IACtB,CAAC,YAAY,CAAC,UAAU;IACxB,CAAC,YAAY,CAAC,MAAM;IACpB,CAAC,YAAY,CAAC,UAAU;IACxB,CAAC,CAAC,qBAAqB,IAAI,YAAY,CAAC,EAAE,KAAK,qBAAqB,CAAC;IACrE,CAAC,YAAY,CAAC,MAAM,KAAK,KAAK,CAAC,EAAE;QAC/B,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAC3D,CAAC;AAEJ,MAAM,WAAW,GAAG,CAClB,KAAe,EACf,WAAqC,EACrC,aAA+C,EAC/C,qBAAyC,EAChC,EAAE;IACX,IACE,KAAK,CAAC,KAAK,KAAK,MAAM;QACtB,KAAK,CAAC,KAAK,KAAK,SAAS;QACzB,KAAK,CAAC,KAAK,KAAK,QAAQ,EACxB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO,yBAAyB,CAC9B,KAAK,EACL,aAAa,EACb,qBAAqB,CACtB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,UAAU,yCAAyC,CACvD,IAA6B,EAC7B,WAAqC,EACrC,aAA+C,EAC/C,qBAA0C;IAE1C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAClC,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,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1C,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,IAAI,CAAC,KAAK;SACP,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC;SACrC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAClC,CAAC;IAEF,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/B,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;QAC5C,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,CACL,CAAC,CAAC,KAAK;YACP,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,qBAAqB,CAAC,CACtE,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/agent/turn/responder-inbox.d.ts

@@ -0,0 +1,28 @@
+import type { ChatMessage } from "../../types.js";
+import type { BackgroundJob, ResponderNotification } from "../../tools/jobs.js";
+export interface ResponderWake {
+    readonly wakeTurn: boolean;
+    readonly notificationId: string | undefined;
+    readonly jobId: string | undefined;
+    readonly resultRevision: number | undefined;
+}
+export interface ResponderClaimView {
+    add(notificationId: string): void;
+    has(notificationId: string): boolean;
+}
+export interface ResponderInboxPorts {
+    readonly messages: ChatMessage[];
+    readonly wake: ResponderWake;
+    readonly claims: ResponderClaimView;
+    readonly getRunningJobs: () => readonly BackgroundJob[];
+    readonly getPendingNotifications: () => readonly ResponderNotification[];
+    readonly getResponderLeaseId: () => string | undefined;
+    readonly claimNextNotification: (leaseId: string) => ResponderNotification | undefined;
+}
+export declare const parseResponderWake: (input: {
+    readonly prompt: string;
+    readonly displayPrompt: string | null | undefined;
+}) => ResponderWake;
+export declare const responderWakeMatchesRevision: (wake: ResponderWake, notification: ResponderNotification) => boolean;
+export declare const findResponderWakeNotification: (wake: ResponderWake, pending: readonly ResponderNotification[]) => ResponderNotification | undefined;
+export declare const createResponderInboxRefresher: (ports: ResponderInboxPorts) => () => ResponderNotification | undefined;

package/dist/agent/turn/responder-inbox.js

@@ -0,0 +1,57 @@
+import { responderContextMessage, upsertResponderContextMessage, } from "../responder-context.js";
+const WAKE_PENDING_LIMIT = 1;
+const INBOX_PENDING_LIMIT = 12;
+export const parseResponderWake = (input) => {
+    const wakeTurn = input.displayPrompt === null &&
+        input.prompt.startsWith("Responder result arrived");
+    if (!wakeTurn) {
+        return {
+            wakeTurn: false,
+            notificationId: undefined,
+            jobId: undefined,
+            resultRevision: undefined,
+        };
+    }
+    return {
+        wakeTurn: true,
+        notificationId: /^notification=(.+)$/m.exec(input.prompt)?.[1]?.trim(),
+        jobId: /^job=(.+)$/m.exec(input.prompt)?.[1]?.trim(),
+        resultRevision: Number(/^resultRevision=(\d+)$/m.exec(input.prompt)?.[1]) || undefined,
+    };
+};
+export const responderWakeMatchesRevision = (wake, notification) => wake.resultRevision === undefined ||
+    (notification.resultRevision ?? 1) === wake.resultRevision;
+export const findResponderWakeNotification = (wake, pending) => wake.notificationId
+    ? pending.find((notification) => notification.id === wake.notificationId &&
+        (!wake.jobId || notification.jobId === wake.jobId) &&
+        responderWakeMatchesRevision(wake, notification))
+    : undefined;
+const isDeliverable = (notification) => notification.responder &&
+    !notification.readAt &&
+    !notification.analyzedAt &&
+    !notification.archivedAt;
+const refresh = (ports) => {
+    const running = ports.getRunningJobs().filter((job) => job.responder);
+    if (ports.wake.wakeTurn) {
+        const pending = ports
+            .getPendingNotifications()
+            .filter((notification) => isDeliverable(notification) &&
+            ports.claims.has(notification.id) &&
+            responderWakeMatchesRevision(ports.wake, notification))
+            .slice(0, WAKE_PENDING_LIMIT);
+        upsertResponderContextMessage(ports.messages, responderContextMessage({ running, pending }));
+        return undefined;
+    }
+    const leaseId = ports.getResponderLeaseId();
+    const delivery = leaseId ? ports.claimNextNotification(leaseId) : undefined;
+    if (delivery)
+        ports.claims.add(delivery.id);
+    const pending = ports
+        .getPendingNotifications()
+        .filter((notification) => isDeliverable(notification) && ports.claims.has(notification.id))
+        .slice(0, INBOX_PENDING_LIMIT);
+    upsertResponderContextMessage(ports.messages, responderContextMessage({ running, pending }));
+    return delivery;
+};
+export const createResponderInboxRefresher = (ports) => () => refresh(ports);
+//# sourceMappingURL=responder-inbox.js.map

package/dist/agent/turn/responder-inbox.js.map

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

package/dist/agent/turn/responder-job-linkage.d.ts

@@ -0,0 +1,30 @@
+import type { ToolCall, ToolResult } from "../../types.js";
+import type { SessionPlan } from "../../store/plan.js";
+import type { BackgroundJob } from "../../tools/jobs.js";
+export interface ResponderLinkageJobPatch {
+    readonly taskId?: string | undefined;
+    readonly parentTaskId?: string | undefined;
+    readonly wakeOnCompletion: boolean;
+    readonly responder: boolean;
+    readonly monitor: Record<string, unknown>;
+}
+export interface ResponderLinkagePorts {
+    readonly loadPlan: () => Promise<SessionPlan | undefined>;
+    readonly mutatePlan: (mutator: (draft: SessionPlan) => boolean) => Promise<{
+        ok: boolean;
+        plan?: SessionPlan | undefined;
+    } | undefined>;
+    readonly linkJob: (jobId: string, patch: ResponderLinkageJobPatch) => BackgroundJob | undefined;
+    readonly renderPlan: (plan: SessionPlan) => void;
+    readonly setPendingSessionStatePlan: (plan: SessionPlan) => void;
+    readonly notify: (level: "info" | "warn", message: string) => void;
+}
+export interface ResponderLinkageInput {
+    readonly job: BackgroundJob;
+    readonly call: ToolCall;
+    readonly toolEventId: string;
+    readonly delegationTaskId: string | undefined;
+    readonly dispatchedTaskId: string | undefined;
+}
+export declare const responderLinkageNote: (jobId: string, responderTaskId: string, parentTaskId: string | undefined) => string;
+export declare const linkResponderJobToPlan: (ports: ResponderLinkagePorts, input: ResponderLinkageInput, result: ToolResult) => Promise<ToolResult>;