@pentoshi/clai 4.11.7 → 4.11.8

package/dist/agent/turn/tool-execution/state.d.ts

@@ -0,0 +1,19 @@
+import type { GovernorState } from "../../evidence-governor.js";
+import type { SessionPlan } from "../../../store/plan.js";
+import type { TaskWorkLedger } from "../../task-evidence.js";
+export interface ToolExecutionState {
+    narrowNmapDispatchCount: number;
+    pendingSessionStatePlan: SessionPlan | null | undefined;
+    taskWorkLedger: TaskWorkLedger | null;
+    dispatchedTaskId: string | undefined;
+    delegation: {
+        id: string;
+        taskId?: string;
+    } | undefined;
+    retryDependenciesChanged: boolean;
+    retryEnvironmentChanged: boolean;
+    governorState: GovernorState;
+    governorReflects: number;
+    lastGovernorReason: string | undefined;
+}
+export declare const createToolExecutionState: (activePlan: SessionPlan | null | undefined, governorState: GovernorState) => ToolExecutionState;

package/dist/agent/turn/tool-execution/state.js

@@ -0,0 +1,13 @@
+export const createToolExecutionState = (activePlan, governorState) => ({
+    narrowNmapDispatchCount: 0,
+    pendingSessionStatePlan: activePlan,
+    taskWorkLedger: null,
+    dispatchedTaskId: undefined,
+    delegation: undefined,
+    retryDependenciesChanged: false,
+    retryEnvironmentChanged: false,
+    governorState,
+    governorReflects: 0,
+    lastGovernorReason: undefined,
+});
+//# sourceMappingURL=state.js.map

package/dist/agent/turn/tool-execution/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../../src/agent/turn/tool-execution/state.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,UAA0C,EAC1C,aAA4B,EACR,EAAE,CAAC,CAAC;IACxB,uBAAuB,EAAE,CAAC;IAC1B,uBAAuB,EAAE,UAAU;IACnC,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,SAAS;IAC3B,UAAU,EAAE,SAAS;IACrB,wBAAwB,EAAE,KAAK;IAC/B,uBAAuB,EAAE,KAAK;IAC9B,aAAa;IACb,gBAAgB,EAAE,CAAC;IACnB,kBAAkB,EAAE,SAAS;CAC9B,CAAC,CAAC"}

package/dist/agent/turn/tool-execution/supervision.d.ts

@@ -0,0 +1,20 @@
+import type { ToolResult } from "../../../types.js";
+import type { ToolWatchdog } from "../tool-watchdog.js";
+export interface ToolSupervisionPorts {
+    readonly watchdog: ToolWatchdog;
+    readonly parentSignal: AbortSignal;
+    readonly toolSignal: AbortSignal;
+    readonly isAbortError: (error: Error, signal: AbortSignal) => boolean;
+    readonly liveBytes: () => number;
+    readonly writeToolOutput: (chunk: string) => void;
+    readonly updateJobStatus: (status: "exited" | "failed", exitCode: number | undefined) => void;
+    readonly cleanup: () => void;
+}
+export type ToolSupervisionOutcome = {
+    readonly kind: "settled";
+    readonly result: ToolResult;
+} | {
+    readonly kind: "cancelled";
+    readonly result: ToolResult;
+};
+export declare const superviseToolExecution: (ports: ToolSupervisionPorts, startWork: () => Promise<ToolResult>) => Promise<ToolSupervisionOutcome>;

package/dist/agent/turn/tool-execution/supervision.js

@@ -0,0 +1,44 @@
+const CANCELLED_BY_USER = {
+    ok: false,
+    output: "Cancelled by user.",
+    exitCode: 130,
+};
+const cancelledByUser = (ports) => {
+    const state = ports.watchdog.state();
+    return (ports.parentSignal.aborted &&
+        !state.stalledByWatchdog &&
+        !state.hardTimedOut);
+};
+const toolErrorResult = (error) => ({
+    ok: false,
+    output: `Tool error: ${error.message}`,
+    exitCode: 1,
+});
+export const superviseToolExecution = async (ports, startWork) => {
+    try {
+        const result = await ports.watchdog.run(startWork);
+        if (cancelledByUser(ports)) {
+            return { kind: "cancelled", result: CANCELLED_BY_USER };
+        }
+        if (ports.liveBytes() > 0)
+            ports.writeToolOutput("\n");
+        ports.updateJobStatus(result.ok ? "exited" : "failed", result.exitCode);
+        return { kind: "settled", result };
+    }
+    catch (toolError) {
+        ports.updateJobStatus("failed", 1);
+        const error = toolError instanceof Error ? toolError : new Error(String(toolError));
+        const forceSettled = ports.watchdog.state().forceSettled;
+        if (!ports.isAbortError(error, ports.toolSignal) && !forceSettled) {
+            return { kind: "settled", result: toolErrorResult(error) };
+        }
+        if (cancelledByUser(ports)) {
+            return { kind: "cancelled", result: CANCELLED_BY_USER };
+        }
+        return { kind: "settled", result: ports.watchdog.abortResult() };
+    }
+    finally {
+        ports.cleanup();
+    }
+};
+//# sourceMappingURL=supervision.js.map

package/dist/agent/turn/tool-execution/supervision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervision.js","sourceRoot":"","sources":["../../../../src/agent/turn/tool-execution/supervision.ts"],"names":[],"mappings":"AAqBA,MAAM,iBAAiB,GAAe;IACpC,EAAE,EAAE,KAAK;IACT,MAAM,EAAE,oBAAoB;IAC5B,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF,MAAM,eAAe,GAAG,CACtB,KAA2B,EAClB,EAAE;IACX,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACrC,OAAO,CACL,KAAK,CAAC,YAAY,CAAC,OAAO;QAC1B,CAAC,KAAK,CAAC,iBAAiB;QACxB,CAAC,KAAK,CAAC,YAAY,CACpB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,KAAY,EAAc,EAAE,CAAC,CAAC;IACrD,EAAE,EAAE,KAAK;IACT,MAAM,EAAE,eAAe,KAAK,CAAC,OAAO,EAAE;IACtC,QAAQ,EAAE,CAAC;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EACzC,KAA2B,EAC3B,SAAoC,EACH,EAAE;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAC1D,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC;YAAE,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACvD,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,SAAS,EAAE,CAAC;QACnB,KAAK,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACnC,MAAM,KAAK,GACT,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACxE,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC;QACzD,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,CAAC;QACD,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAC1D,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;IACnE,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC,CAAC"}

package/dist/agent/turn/tool-result-recorder.d.ts

@@ -0,0 +1,26 @@
+import type { ChatMessage, ToolCall, ToolResult } from "../../types.js";
+export interface ToolResultRecorderPorts {
+    readonly messages: ChatMessage[];
+    readonly useNativeToolHistory: boolean;
+    readonly deferredPostToolMessages: ChatMessage[];
+    readonly seenHashes: Map<string, {
+        toolName: string;
+        count: number;
+    }>;
+    readonly remindedAt: Set<number>;
+    readonly writeNotice: (level: "info" | "warn", text: string) => void;
+}
+export interface ToolResultRecord {
+    readonly id: string;
+    readonly call: ToolCall;
+    readonly result: ToolResult;
+    readonly contextOutput: string;
+    readonly isPlanMode: boolean;
+    readonly planApproved: boolean;
+    readonly hasDraftPlan: boolean;
+    readonly productiveStep: number;
+    readonly kindHint: "pentest" | "coding" | "general";
+}
+export declare const createToolResultRecorder: (ports: ToolResultRecorderPorts) => {
+    record: (record: ToolResultRecord) => void;
+};

package/dist/agent/turn/tool-result-recorder.js

@@ -0,0 +1,54 @@
+import { dedupeToolContextOutput } from "../reliability-policy.js";
+import { maybeAppendPlanModeReminder, PLAN_REMINDER_TOAST, } from "../plan-mode-reminders.js";
+import { appendToolResult } from "../tool-history.js";
+const deferredImageMessage = (call, result) => {
+    if (!result.images?.length)
+        return undefined;
+    const count = result.images.length;
+    return {
+        role: "user",
+        internal: true,
+        content: `[${call.name}] The ${count === 1 ? "image" : `${count} images`} you asked to look at ` +
+            `${count === 1 ? "is" : "are"} attached to this message` +
+            `${count === 1 ? "" : ", in the order you requested them"}: ` +
+            `${result.images.map((image) => image.path ?? "(unnamed)").join(", ")}. ` +
+            "Judge them from the pixels and continue the task.",
+        images: result.images,
+    };
+};
+export const createToolResultRecorder = (ports) => ({
+    record: (record) => {
+        const deduped = dedupeToolContextOutput({
+            content: record.contextOutput,
+            toolName: record.call.name,
+            artifactPath: record.result.outputPath,
+            seenHashes: ports.seenHashes,
+        });
+        let toolContent = `Tool ${record.call.name} result ` +
+            `(exit=${record.result.exitCode ?? 0}, ok=${record.result.ok}):\n${deduped.content}`;
+        const reminded = maybeAppendPlanModeReminder(toolContent, {
+            isPlanMode: record.isPlanMode,
+            planApproved: record.planApproved,
+            hasDraftPlan: record.hasDraftPlan,
+            productiveStep: record.productiveStep,
+            alreadyRemindedAt: ports.remindedAt,
+            step: record.productiveStep,
+            kindHint: record.kindHint,
+        });
+        toolContent = reminded.content;
+        if (reminded.reminded) {
+            ports.remindedAt.add(record.productiveStep);
+            ports.writeNotice("info", PLAN_REMINDER_TOAST);
+        }
+        if (ports.useNativeToolHistory) {
+            appendToolResult(ports.messages, record.id, toolContent, record.call.name, record.result.ok);
+        }
+        else {
+            ports.messages.push({ role: "tool", content: toolContent });
+        }
+        const deferred = deferredImageMessage(record.call, record.result);
+        if (deferred)
+            ports.deferredPostToolMessages.push(deferred);
+    },
+});
+//# sourceMappingURL=tool-result-recorder.js.map

package/dist/agent/turn/tool-result-recorder.js.map

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

package/dist/agent/turn/tool-routing.d.ts

@@ -0,0 +1,23 @@
+import type { Mode, ProviderId, ToolDefinition } from "../../types.js";
+import type { ToolCallingMode } from "../../llm/tool-protocol.js";
+import { resolveToolDialect } from "../../llm/capabilities.js";
+export interface ToolRoutingInput {
+    readonly mode: Mode;
+    readonly mcpPresent: boolean;
+    readonly mcpToolNames: readonly string[];
+    readonly mcpToolDefinitions: readonly ToolDefinition[];
+    readonly imageOcrEnabled: boolean;
+    readonly skillsAvailable: boolean;
+    readonly toolCalling: ToolCallingMode | undefined;
+    readonly useCompactSystemPrompt: () => boolean;
+}
+export interface ToolRouting {
+    readonly routeToolNames: (provider: ProviderId, model: string) => string[];
+    readonly resolveNativeTools: (provider: ProviderId, model: string) => {
+        dialect: ReturnType<typeof resolveToolDialect>;
+        native: boolean;
+    };
+    readonly selectToolDefs: (native: boolean, compact: boolean, provider: ProviderId, model: string) => ToolDefinition[] | undefined;
+    readonly buildStableSystemContent: (native: boolean, provider: ProviderId, model: string) => string;
+}
+export declare const createToolRouting: (input: ToolRoutingInput) => ToolRouting;

package/dist/agent/turn/tool-routing.js

@@ -0,0 +1,58 @@
+import { modelSupportsVision, resolveToolDialect } from "../../llm/capabilities.js";
+import { availableToolNames } from "../../tools/registry.js";
+import { getCompactToolDefinitions, getToolDefinitions, mcpAgentToolNames, RUNNER_META_TOOL_NAMES, } from "../../tools/definitions.js";
+import { renderAgentSystemPrompt, renderCompactAgentSystemPrompt, } from "../../prompts/index.js";
+import { getReliabilityPolicy } from "../reliability-policy.js";
+const nameAllowed = (input, name, provider, model) => {
+    if (name === "image.ocr")
+        return input.imageOcrEnabled;
+    if (name === "image.view")
+        return modelSupportsVision(provider, model);
+    if (name === "skill.load" || name === "skill.list") {
+        return input.skillsAvailable;
+    }
+    return true;
+};
+export const createToolRouting = (input) => {
+    const routeToolNames = (provider, model) => [
+        ...availableToolNames(),
+        ...input.mcpToolNames,
+        ...(input.mcpPresent ? mcpAgentToolNames(input.mode === "ask") : []),
+    ].filter((name) => nameAllowed(input, name, provider, model));
+    const resolveNativeTools = (provider, model) => {
+        const dialect = resolveToolDialect(provider, model, input.toolCalling);
+        return { dialect, native: dialect !== "none" };
+    };
+    const selectToolDefs = (native, compact, provider, model) => {
+        if (!native)
+            return undefined;
+        const base = [
+            ...(compact ? getCompactToolDefinitions() : getToolDefinitions()),
+            ...input.mcpToolDefinitions,
+        ];
+        const allow = new Set([
+            ...routeToolNames(provider, model),
+            ...RUNNER_META_TOOL_NAMES,
+        ]);
+        return base.filter((definition) => allow.has(definition.name));
+    };
+    const buildStableSystemContent = (native, provider, model) => {
+        const reliability = getReliabilityPolicy();
+        const render = input.useCompactSystemPrompt()
+            ? renderCompactAgentSystemPrompt
+            : renderAgentSystemPrompt;
+        return render(routeToolNames(provider, model).join(", "), {
+            nativeTools: native,
+            stableEnvironment: true,
+            imageView: modelSupportsVision(provider, model),
+            ...(native ? { slimNative: reliability.slimNativePrompt } : {}),
+        });
+    };
+    return {
+        routeToolNames,
+        resolveNativeTools,
+        selectToolDefs,
+        buildStableSystemContent,
+    };
+};
+//# sourceMappingURL=tool-routing.js.map

package/dist/agent/turn/tool-routing.js.map

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

package/dist/agent/turn/tool-watchdog.d.ts

@@ -0,0 +1,22 @@
+import type { ToolResult } from "../../types.js";
+export interface ToolWatchdogInput {
+    readonly toolName: string;
+    readonly stallBudgetMs: number;
+    readonly hardBudgetMs: number;
+    readonly graceMs: number;
+    readonly controller: AbortController;
+    readonly notify: (message: string) => void;
+}
+export interface ToolWatchdogState {
+    readonly stalledByWatchdog: boolean;
+    readonly hardTimedOut: boolean;
+    readonly forceSettled: boolean;
+}
+export interface ToolWatchdog {
+    readonly resetStallTimer: () => void;
+    readonly run: (startWork: () => Promise<ToolResult>) => Promise<ToolResult>;
+    readonly state: () => ToolWatchdogState;
+    readonly abortResult: () => ToolResult;
+    readonly dispose: () => void;
+}
+export declare const createToolWatchdog: (input: ToolWatchdogInput) => ToolWatchdog;

package/dist/agent/turn/tool-watchdog.js

@@ -0,0 +1,135 @@
+const unref = (timer) => {
+    timer.unref?.();
+};
+const seconds = (ms) => Math.round(ms / 1000);
+const armStallTimer = (input, runtime) => {
+    if (runtime.stallTimer)
+        clearTimeout(runtime.stallTimer);
+    runtime.stallTimer = setTimeout(() => {
+        if (input.controller.signal.aborted)
+            return;
+        runtime.stalled = true;
+        input.notify(`${input.toolName} has been running for >${seconds(input.stallBudgetMs)}s without output — cancelling stalled tool`);
+        input.controller.abort();
+    }, input.stallBudgetMs);
+    unref(runtime.stallTimer);
+};
+const forceCancelResult = (input, runtime) => {
+    runtime.forceSettled = true;
+    if (runtime.stalled) {
+        return {
+            ok: false,
+            output: `Tool timed out after ${seconds(input.stallBudgetMs)}s without output (force-cancelled).`,
+            exitCode: 124,
+        };
+    }
+    if (runtime.hardTimedOut) {
+        return {
+            ok: false,
+            output: `Tool hard-timeout after ${seconds(input.hardBudgetMs)}s — cancelled.`,
+            exitCode: 124,
+        };
+    }
+    return {
+        ok: false,
+        output: "Tool aborted before it could complete (force-cancelled).",
+        exitCode: 130,
+    };
+};
+const armGraceForceSettle = (input, runtime) => {
+    if (runtime.settled || runtime.graceTimer)
+        return;
+    runtime.graceTimer = setTimeout(() => {
+        if (runtime.settled)
+            return;
+        input.notify(`${input.toolName} did not stop after cancel — force-settling`);
+        runtime.settled = true;
+        runtime.forceResolve?.(forceCancelResult(input, runtime));
+    }, input.graceMs);
+    unref(runtime.graceTimer);
+};
+const armHardTimer = (input, runtime) => {
+    runtime.hardTimer = setTimeout(() => {
+        if (runtime.settled)
+            return;
+        runtime.hardTimedOut = true;
+        input.notify(`${input.toolName} exceeded ${seconds(input.hardBudgetMs)}s hard budget — cancelling`);
+        if (!input.controller.signal.aborted)
+            input.controller.abort();
+        armGraceForceSettle(input, runtime);
+    }, input.hardBudgetMs);
+    unref(runtime.hardTimer);
+};
+const trackSettlement = (work, runtime) => work.then((result) => {
+    runtime.settled = true;
+    return result;
+}, (error) => {
+    runtime.settled = true;
+    return Promise.reject(error);
+});
+const abortResultFor = (input, runtime) => {
+    if (runtime.stalled) {
+        return {
+            ok: false,
+            output: `Tool timed out after ${input.stallBudgetMs / 1_000}s without output.`,
+            exitCode: 124,
+        };
+    }
+    if (runtime.hardTimedOut) {
+        return {
+            ok: false,
+            output: `Tool hard-timeout after ${seconds(input.hardBudgetMs)}s — cancelled.`,
+            exitCode: 124,
+        };
+    }
+    return {
+        ok: false,
+        output: "Tool aborted before it could complete.",
+        exitCode: 130,
+    };
+};
+export const createToolWatchdog = (input) => {
+    const runtime = {
+        stalled: false,
+        hardTimedOut: false,
+        forceSettled: false,
+        settled: false,
+        stallTimer: undefined,
+        hardTimer: undefined,
+        graceTimer: undefined,
+        forceResolve: undefined,
+    };
+    const run = (startWork) => {
+        const tracked = trackSettlement(startWork(), runtime);
+        const forced = new Promise((resolve) => {
+            runtime.forceResolve = resolve;
+        });
+        armHardTimer(input, runtime);
+        const signal = input.controller.signal;
+        if (signal.aborted)
+            armGraceForceSettle(input, runtime);
+        else {
+            signal.addEventListener("abort", () => armGraceForceSettle(input, runtime), { once: true });
+        }
+        return Promise.race([tracked, forced]);
+    };
+    return {
+        resetStallTimer: () => armStallTimer(input, runtime),
+        run,
+        state: () => ({
+            stalledByWatchdog: runtime.stalled,
+            hardTimedOut: runtime.hardTimedOut,
+            forceSettled: runtime.forceSettled,
+        }),
+        abortResult: () => abortResultFor(input, runtime),
+        dispose: () => {
+            if (runtime.stallTimer)
+                clearTimeout(runtime.stallTimer);
+            if (runtime.hardTimer)
+                clearTimeout(runtime.hardTimer);
+            if (runtime.graceTimer)
+                clearTimeout(runtime.graceTimer);
+        },
+    };
+};
+//# sourceMappingURL=tool-watchdog.js.map

package/dist/agent/turn/tool-watchdog.js.map

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

package/dist/agent/turn/turn-counters.d.ts

@@ -0,0 +1,9 @@
+export interface TurnCounters {
+    productiveSteps: number;
+    consecutiveModelOnlyRounds: number;
+    truncatedToolRetries: number;
+    malformedFenceRetries: number;
+    bareToolJsonRetries: number;
+}
+export declare const createTurnCounters: () => TurnCounters;
+export declare const resetToolRetryCounters: (counters: TurnCounters) => void;

package/dist/agent/turn/turn-counters.js

@@ -0,0 +1,13 @@
+export const createTurnCounters = () => ({
+    productiveSteps: 0,
+    consecutiveModelOnlyRounds: 0,
+    truncatedToolRetries: 0,
+    malformedFenceRetries: 0,
+    bareToolJsonRetries: 0,
+});
+export const resetToolRetryCounters = (counters) => {
+    counters.truncatedToolRetries = 0;
+    counters.malformedFenceRetries = 0;
+    counters.bareToolJsonRetries = 0;
+};
+//# sourceMappingURL=turn-counters.js.map

package/dist/agent/turn/turn-counters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-counters.js","sourceRoot":"","sources":["../../../src/agent/turn/turn-counters.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAiB,EAAE,CAAC,CAAC;IACrD,eAAe,EAAE,CAAC;IAClB,0BAA0B,EAAE,CAAC;IAC7B,oBAAoB,EAAE,CAAC;IACvB,qBAAqB,EAAE,CAAC;IACxB,mBAAmB,EAAE,CAAC;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,QAAsB,EAAQ,EAAE;IACrE,QAAQ,CAAC,oBAAoB,GAAG,CAAC,CAAC;IAClC,QAAQ,CAAC,qBAAqB,GAAG,CAAC,CAAC;IACnC,QAAQ,CAAC,mBAAmB,GAAG,CAAC,CAAC;AACnC,CAAC,CAAC"}

package/dist/agent/turn/workspace-setup.d.ts

@@ -0,0 +1,29 @@
+import type { SessionPlan } from "../../store/plan.js";
+export interface TurnOrientation {
+    readonly destinationHint: string | undefined;
+    readonly instructionScanInput: {
+        cwd: string;
+        projectRoot?: string;
+    };
+}
+export declare const orientTurnWorkspace: (input: {
+    readonly prompt: string;
+    readonly plan: SessionPlan | undefined;
+    readonly cwd: string;
+}) => TurnOrientation;
+export interface TurnInstructions {
+    readonly block: string | undefined;
+    readonly skillsBlock: string | undefined;
+    readonly selectedSkillNames: readonly string[];
+    readonly refresh: () => Promise<string | undefined>;
+}
+export declare const loadTurnInstructions: (input: {
+    readonly prompt: string;
+    readonly scanInput: {
+        cwd: string;
+        projectRoot?: string;
+    };
+    readonly scaffoldInstructionFiles: boolean;
+    readonly skillNames: ReadonlySet<string>;
+    readonly notify: (level: "info" | "warn", message: string) => void;
+}) => Promise<TurnInstructions>;

package/dist/agent/turn/workspace-setup.js

@@ -0,0 +1,74 @@
+import { join } from "node:path";
+import { discoverImmediateProjectRoots, guessProjectFolderName, isBareParentDirectory, } from "../workspace-orient.js";
+import { resolveUserDestinationHint } from "../task-evidence.js";
+import { extractProjectRootFromPlan, extractProjectRootFromText, getActiveProjectRoot, setActiveProjectRootIfValid, } from "../project-root.js";
+import { loadAgentInstructions } from "../../instructions/load.js";
+import { ensureProjectInstructionFiles } from "../../instructions/scaffold.js";
+import { loadSkill } from "../../skills/registry.js";
+import { skillMentionNames } from "../../skills/mentions.js";
+import { renderActiveSkills } from "../../skills/catalog.js";
+export const orientTurnWorkspace = (input) => {
+    const destinationHint = resolveUserDestinationHint(input.prompt);
+    const orientationSourceText = [
+        input.prompt,
+        input.plan?.goal,
+        input.plan?.detail,
+        input.plan?.tasks.map((task) => task.title).join(" "),
+    ]
+        .filter(Boolean)
+        .join("\n");
+    const fromPlan = extractProjectRootFromPlan(input.plan);
+    const fromPrompt = extractProjectRootFromText(input.prompt);
+    const guessedName = guessProjectFolderName(orientationSourceText);
+    const orientationParent = destinationHint ??
+        (isBareParentDirectory(input.cwd) ? input.cwd : undefined);
+    const guessedProject = orientationParent && guessedName
+        ? join(orientationParent, guessedName)
+        : undefined;
+    let pinnedProject = false;
+    for (const candidate of [fromPlan, fromPrompt, guessedProject]) {
+        if (setActiveProjectRootIfValid(candidate)) {
+            pinnedProject = true;
+            break;
+        }
+    }
+    if (!pinnedProject) {
+        const discovered = orientationParent
+            ? discoverImmediateProjectRoots(orientationParent)
+            : [];
+        if (discovered.length === 1)
+            setActiveProjectRootIfValid(discovered[0]);
+    }
+    const projectRoot = getActiveProjectRoot();
+    return {
+        destinationHint,
+        instructionScanInput: {
+            cwd: input.cwd,
+            ...(projectRoot ? { projectRoot } : {}),
+        },
+    };
+};
+export const loadTurnInstructions = async (input) => {
+    if (input.scaffoldInstructionFiles) {
+        const scaffold = await ensureProjectInstructionFiles(input.scanInput).catch(() => undefined);
+        if (scaffold && scaffold.created.length > 0) {
+            input.notify("info", `created ${scaffold.created.join(" and ")} — put your project rules in CLAI.md`);
+        }
+    }
+    const loaded = await loadAgentInstructions(input.scanInput).catch(() => undefined);
+    const selectedSkillNames = skillMentionNames(input.prompt, input.skillNames);
+    const activeSkills = [];
+    for (const name of selectedSkillNames) {
+        const skill = await loadSkill(name, input.scanInput).catch(() => undefined);
+        if (skill)
+            activeSkills.push(skill);
+    }
+    return {
+        block: loaded?.block,
+        skillsBlock: renderActiveSkills(activeSkills),
+        selectedSkillNames,
+        refresh: async () => (await loadAgentInstructions(input.scanInput).catch(() => undefined))
+            ?.block,
+    };
+};
+//# sourceMappingURL=workspace-setup.js.map

package/dist/agent/turn/workspace-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-setup.js","sourceRoot":"","sources":["../../../src/agent/turn/workspace-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAQ7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAInC,EAAmB,EAAE;IACpB,MAAM,eAAe,GAAG,0BAA0B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,qBAAqB,GAAG;QAC5B,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,CAAC;IACd,MAAM,QAAQ,GAAG,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,0BAA0B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;IAClE,MAAM,iBAAiB,GACrB,eAAe;QACf,CAAC,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,cAAc,GAClB,iBAAiB,IAAI,WAAW;QAC9B,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC;QACtC,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,KAAK,MAAM,SAAS,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE,CAAC;QAC/D,IAAI,2BAA2B,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3C,aAAa,GAAG,IAAI,CAAC;YACrB,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,iBAAiB;YAClC,CAAC,CAAC,6BAA6B,CAAC,iBAAiB,CAAC;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,WAAW,GAAG,oBAAoB,EAAE,CAAC;IAC3C,OAAO;QACL,eAAe;QACf,oBAAoB,EAAE;YACpB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC;KACF,CAAC;AACJ,CAAC,CAAC;AASF,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,KAM1C,EAA6B,EAAE;IAC9B,IAAI,KAAK,CAAC,wBAAwB,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,6BAA6B,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CACzE,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;QACF,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,KAAK,CAAC,MAAM,CACV,MAAM,EACN,WAAW,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,sCAAsC,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAC/D,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;IAEF,MAAM,kBAAkB,GAAG,iBAAiB,CAC1C,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,CACjB,CAAC;IACF,MAAM,YAAY,GAAkB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5E,IAAI,KAAK;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,EAAE,KAAK;QACpB,WAAW,EAAE,kBAAkB,CAAC,YAAY,CAAC;QAC7C,kBAAkB;QAClB,OAAO,EAAE,KAAK,IAAI,EAAE,CAClB,CAAC,MAAM,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACnE,EAAE,KAAK;KACZ,CAAC;AACJ,CAAC,CAAC"}