@pentoshi/clai 3.8.19 → 3.8.21

package/dist/agent/continue-orient.js

@@ -0,0 +1,152 @@
+/**
+ * Soft orientation for continue / mid-work recovery after interruptions.
+ *
+ * Professional agents (Claude Code, Cursor, etc.) re-attach to interrupted
+ * work: live jobs, open tasks, last tools — they do not skip ahead and mark
+ * plan items done. This is guidance + facts, not a hard gate.
+ */
+export const CONTINUE_ORIENT_PREFIX = "CONTINUE / RECOVER MID-WORK";
+/** User is asking to pick up after a pause, error, or short nudge. */
+export function looksLikeContinueOrResumePrompt(prompt) {
+    const t = prompt.replace(/\s+/g, " ").trim();
+    if (!t)
+        return false;
+    // Bare or short continue-family prompts
+    if (/^(?:continue|resume|proceed|keep\s+going|go\s+on|finish(?:\s+it)?|next|try\s+again|retry|pick\s+up)(?:\s+please)?[.!]?$/i.test(t)) {
+        return true;
+    }
+    // Slightly longer but clearly recovery-oriented
+    if (/^(?:continue|resume|proceed|keep\s+going|go\s+on|finish|retry|try\s+again)\b.{0,80}$/i.test(t) &&
+        t.length < 100) {
+        return true;
+    }
+    if (/\b(?:continue\s+(?:from|where|the)|resume\s+(?:from|where|the)|pick\s+up\s+where|where\s+you\s+left\s+off|after\s+(?:the\s+)?(?:error|failure|timeout|interrupt))\b/i.test(t)) {
+        return true;
+    }
+    return false;
+}
+/** Last few tool results from history (newest last), high-signal one-liners. */
+export function extractRecentToolHints(history, limit = 6) {
+    if (!history?.length)
+        return [];
+    const out = [];
+    for (let i = history.length - 1; i >= 0 && out.length < limit; i -= 1) {
+        const m = history[i];
+        if (m.role !== "tool")
+            continue;
+        const name = m.name?.trim() || guessToolName(m.content) || "tool";
+        const first = m.content
+            .split(/\r?\n/)
+            .map((l) => l.trim())
+            .find((l) => l.length > 0) ?? "";
+        out.push({
+            name,
+            ...(typeof m.ok === "boolean" ? { ok: m.ok } : {}),
+            head: oneLine(first, 140),
+        });
+    }
+    return out.reverse();
+}
+function guessToolName(content) {
+    const m = content.match(/^Tool\s+(\S+)\s+result/i);
+    return m?.[1];
+}
+function oneLine(s, max) {
+    const t = s.replace(/\s+/g, " ").trim();
+    return t.length <= max ? t : `${t.slice(0, max - 1)}…`;
+}
+function jobLine(job) {
+    const cmd = oneLine(job.commandDisplay || job.command, 70);
+    const exit = job.exitCode !== undefined && job.exitCode !== null
+        ? ` exit=${job.exitCode}`
+        : "";
+    return `[${job.id}] ${job.status}${exit} — ${cmd}`;
+}
+/**
+ * Whether this turn should receive mid-work recovery orientation.
+ * Soft: continue phrasing, or open plan work / live jobs with prior history.
+ */
+export function shouldInjectContinueOrientation(input) {
+    if (input.informationalQuery || input.idleOrSocial)
+        return false;
+    if (looksLikeContinueOrResumePrompt(input.prompt))
+        return true;
+    const hasHistory = (input.history?.length ?? 0) >= 2;
+    if (!hasHistory)
+        return false;
+    const openTask = input.plan?.tasks.some((t) => t.state === "in_progress" || t.state === "failed");
+    const liveJobs = (input.runningJobs?.length ?? 0) > 0;
+    // Recovery after provider/tool failure often looks like a short follow-up
+    // while work is still open (not necessarily the word "continue").
+    if ((openTask || liveJobs) && input.prompt.trim().length < 160) {
+        // Avoid hijacking a brand-new concrete request mid-session.
+        if (/\b(?:new\s+(?:task|plan|feature)|start\s+over|from\s+scratch|ignore\s+(?:the\s+)?(?:plan|previous)|different\s+(?:target|project))\b/i.test(input.prompt)) {
+            return false;
+        }
+        // Short nudges with open work → re-attach
+        if (/^(?:ok|okay|yes|y|go|do\s+it|keep\s+going|and\s+then|what\s+next|now\s+what)[.!]?$/i.test(input.prompt.trim()) ||
+            looksLikeContinueOrResumePrompt(input.prompt)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Factual briefing + soft procedure. Empty string if nothing useful to say.
+ */
+export function buildContinueOrientation(input) {
+    if (!shouldInjectContinueOrientation(input))
+        return "";
+    const lines = [
+        CONTINUE_ORIENT_PREFIX,
+        "The prior turn may have been interrupted (provider error, timeout, user cancel, or a long job still running).",
+        "Re-attach to real work before advancing the plan. Do not mark tasks done or skip ahead without fresh evidence from tools this turn.",
+    ];
+    const plan = input.plan;
+    if (plan) {
+        const open = plan.tasks.filter((t) => t.state === "in_progress");
+        const failed = plan.tasks.filter((t) => t.state === "failed");
+        const pending = plan.tasks.filter((t) => t.state === "pending");
+        lines.push(`Plan goal: ${oneLine(plan.goal, 120)} (status=${plan.status}, kind=${plan.kind ?? "?"})`);
+        if (open.length) {
+            lines.push(`In progress: ${open.map((t) => `[${t.id}] ${oneLine(t.title, 60)}`).join("; ")}`);
+        }
+        if (failed.length) {
+            lines.push(`Failed (retry with evidence, do not skip): ${failed.map((t) => `[${t.id}] ${oneLine(t.title, 50)}`).join("; ")}`);
+        }
+        if (pending.length) {
+            lines.push(`Pending (only after current open work is honestly finished): ${pending
+                .slice(0, 6)
+                .map((t) => `[${t.id}] ${oneLine(t.title, 40)}`)
+                .join("; ")}`);
+        }
+    }
+    const running = input.runningJobs ?? [];
+    const recent = input.recentJobs ?? [];
+    if (running.length) {
+        lines.push("Live background jobs (check before starting the same work again):");
+        for (const j of running.slice(0, 8))
+            lines.push(`  ${jobLine(j)}`);
+    }
+    else if (recent.length) {
+        const interesting = recent
+            .filter((j) => /ffuf|nmap|nuclei|gobuster|ferox|masscan|hydra|sqlmap|cargo|npm|vite|next|pytest|jest|docker|make|build/i.test(j.commandDisplay || j.command))
+            .slice(0, 6);
+        if (interesting.length) {
+            lines.push("Recent jobs (may have finished while offline — tail before re-running):");
+            for (const j of interesting)
+                lines.push(`  ${jobLine(j)}`);
+        }
+    }
+    const tools = extractRecentToolHints(input.history, 6);
+    if (tools.length) {
+        lines.push("Last tool results in context (do not invent outcomes):");
+        for (const t of tools) {
+            const ok = t.ok === true ? "ok" : t.ok === false ? "fail" : "?";
+            lines.push(`  ${t.name} [${ok}]: ${t.head}`);
+        }
+    }
+    lines.push("Suggested order (adapt to evidence):", "1) shell.jobs — see what is still running or just finished.", "2) shell.tail on relevant job ids (or read saved artifacts) — harvest results before new work.", "3) Resume the in_progress / failed task with real tools; only then task.update done with proof.", "4) Start the next pending task only after the current one is honestly complete.", "Avoid busy-wait loops (sleep/poll with no progress). Prefer background long jobs + other useful work, then tail.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=continue-orient.js.map

package/dist/agent/continue-orient.js.map

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

package/dist/agent/reliability-policy.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Reliability experiments from the architecture audit (E1–E6).
+ *
+ * Defaults are capability-preserving: they reduce unnecessary context / fragile
+ * free-tier overload without hard-truncating critical evidence or blocking free
+ * users. Every knob is config-backed and can be disabled independently.
+ */
+import type { ProviderId } from "../types.js";
+/** Hard auto-compact ceiling — never raise soft past this. */
+export declare const HARD_COMPACT_TOKEN_BUDGET = 100000;
+/** E1 default: start compact earlier than the hard ceiling. */
+export declare const DEFAULT_SOFT_COMPACT_TOKEN_BUDGET = 70000;
+/** E2 default fs passthrough (was 400k). Full body always on disk when truncated. */
+export declare const DEFAULT_FS_PASSTHROUGH_CAP_CHARS = 64000;
+/** E4: warn when free-cloud context is this large. */
+export declare const DEFAULT_FREE_TIER_WARN_TOKENS = 40000;
+/** E4: stronger notice after this many consecutive free-tier stream failures. */
+export declare const DEFAULT_FREE_TIER_FAIL_THRESHOLD = 2;
+/** E3 floors — large enough for fs.write / salvage, lower than prior 32k default. */
+export declare const ADAPTIVE_MAX_TOKENS_TOOL_STEP = 24576;
+export declare const ADAPTIVE_MAX_TOKENS_LIGHT = 12288;
+export declare const ADAPTIVE_MAX_TOKENS_FLOOR = 8192;
+export declare const LEGACY_MAX_TOKENS = 32768;
+export interface ReliabilityPolicy {
+    readonly softEarlyCompact: boolean;
+    readonly softCompactTokenBudget: number;
+    readonly hardCompactTokenBudget: number;
+    readonly fsPassthroughCapChars: number;
+    readonly adaptiveMaxTokens: boolean;
+    readonly freeTierContextGuard: boolean;
+    readonly freeTierWarnTokens: number;
+    readonly freeTierFailThreshold: number;
+    readonly toolResultDedup: boolean;
+    readonly slimNativePrompt: boolean;
+}
+/** Resolve effective policy from config + optional env overrides. */
+export declare function getReliabilityPolicy(): ReliabilityPolicy;
+/**
+ * E1: token threshold that triggers auto-compact.
+ * Soft path fires earlier; hard budget is always the ceiling used when soft is off.
+ */
+export declare function autoCompactTriggerTokens(policy?: ReliabilityPolicy): number;
+/**
+ * E3: max completion tokens for a model step.
+ * Tool-heavy steps keep room for large writes; light steps use a lower cap.
+ * Never goes below {@link ADAPTIVE_MAX_TOKENS_FLOOR}.
+ */
+export declare function resolveStepMaxTokens(input: {
+    nativeToolsActive: boolean;
+    toolsAttached: boolean;
+    recoveryNudge?: boolean | undefined;
+    policy?: ReliabilityPolicy | undefined;
+}): number;
+export declare function isFreeCloudProvider(provider: ProviderId): boolean;
+/**
+ * E4: advisory notices for free-tier + large context / repeated failures.
+ * Never blocks the request.
+ */
+export declare function freeTierGuardNotices(input: {
+    provider: ProviderId;
+    estimatedInputTokens: number;
+    consecutiveFailures: number;
+    policy?: ReliabilityPolicy | undefined;
+}): string[];
+/** Stable hash for E5 tool-result dedup (content only). */
+export declare function hashToolResultContent(content: string): string;
+/**
+ * E5: if identical tool output already appeared this turn, replace with a
+ * pointer so history does not grow with duplicate dumps. Full text remains
+ * available via artifact path when present.
+ */
+export declare function dedupeToolContextOutput(input: {
+    content: string;
+    toolName: string;
+    artifactPath?: string | undefined;
+    seenHashes: Map<string, {
+        toolName: string;
+        count: number;
+    }>;
+    policy?: ReliabilityPolicy | undefined;
+}): {
+    content: string;
+    deduped: boolean;
+    hash: string;
+};

package/dist/agent/reliability-policy.js

@@ -0,0 +1,158 @@
+/**
+ * Reliability experiments from the architecture audit (E1–E6).
+ *
+ * Defaults are capability-preserving: they reduce unnecessary context / fragile
+ * free-tier overload without hard-truncating critical evidence or blocking free
+ * users. Every knob is config-backed and can be disabled independently.
+ */
+import { createHash } from "node:crypto";
+import { getConfig, providerCategory } from "../store/config.js";
+import { AUTO_COMPACT_TOKEN_BUDGET } from "./context-manager.js";
+/** Hard auto-compact ceiling — never raise soft past this. */
+export const HARD_COMPACT_TOKEN_BUDGET = AUTO_COMPACT_TOKEN_BUDGET;
+/** E1 default: start compact earlier than the hard ceiling. */
+export const DEFAULT_SOFT_COMPACT_TOKEN_BUDGET = 70_000;
+/** E2 default fs passthrough (was 400k). Full body always on disk when truncated. */
+export const DEFAULT_FS_PASSTHROUGH_CAP_CHARS = 64_000;
+/** E4: warn when free-cloud context is this large. */
+export const DEFAULT_FREE_TIER_WARN_TOKENS = 40_000;
+/** E4: stronger notice after this many consecutive free-tier stream failures. */
+export const DEFAULT_FREE_TIER_FAIL_THRESHOLD = 2;
+/** E3 floors — large enough for fs.write / salvage, lower than prior 32k default. */
+export const ADAPTIVE_MAX_TOKENS_TOOL_STEP = 24_576;
+export const ADAPTIVE_MAX_TOKENS_LIGHT = 12_288;
+export const ADAPTIVE_MAX_TOKENS_FLOOR = 8_192;
+export const LEGACY_MAX_TOKENS = 32_768;
+function boolEnv(name) {
+    const v = process.env[name]?.trim().toLowerCase();
+    if (v === undefined || v === "")
+        return undefined;
+    if (v === "1" || v === "true" || v === "yes" || v === "on")
+        return true;
+    if (v === "0" || v === "false" || v === "no" || v === "off")
+        return false;
+    return undefined;
+}
+function intEnv(name) {
+    const v = process.env[name]?.trim();
+    if (!v)
+        return undefined;
+    const n = Number.parseInt(v, 10);
+    return Number.isFinite(n) ? n : undefined;
+}
+/** Resolve effective policy from config + optional env overrides. */
+export function getReliabilityPolicy() {
+    const cfg = getConfig();
+    const softEarly = boolEnv("CLAI_SOFT_EARLY_COMPACT") ?? cfg.softEarlyCompact ?? true;
+    let softBudget = intEnv("CLAI_SOFT_COMPACT_TOKENS") ??
+        cfg.softCompactTokenBudget ??
+        DEFAULT_SOFT_COMPACT_TOKEN_BUDGET;
+    softBudget = Math.max(20_000, Math.min(softBudget, HARD_COMPACT_TOKEN_BUDGET));
+    let fsCap = intEnv("CLAI_FS_PASSTHROUGH_CHARS") ??
+        cfg.fsPassthroughCapChars ??
+        DEFAULT_FS_PASSTHROUGH_CAP_CHARS;
+    fsCap = Math.max(8_000, Math.min(fsCap, 400_000));
+    return {
+        softEarlyCompact: softEarly,
+        softCompactTokenBudget: softBudget,
+        hardCompactTokenBudget: HARD_COMPACT_TOKEN_BUDGET,
+        fsPassthroughCapChars: fsCap,
+        adaptiveMaxTokens: boolEnv("CLAI_ADAPTIVE_MAX_TOKENS") ?? cfg.adaptiveMaxTokens ?? true,
+        freeTierContextGuard: boolEnv("CLAI_FREE_TIER_GUARD") ?? cfg.freeTierContextGuard ?? true,
+        freeTierWarnTokens: intEnv("CLAI_FREE_TIER_WARN_TOKENS") ??
+            cfg.freeTierWarnTokens ??
+            DEFAULT_FREE_TIER_WARN_TOKENS,
+        freeTierFailThreshold: intEnv("CLAI_FREE_TIER_FAIL_THRESHOLD") ??
+            cfg.freeTierFailThreshold ??
+            DEFAULT_FREE_TIER_FAIL_THRESHOLD,
+        toolResultDedup: boolEnv("CLAI_TOOL_RESULT_DEDUP") ?? cfg.toolResultDedup ?? true,
+        slimNativePrompt: boolEnv("CLAI_SLIM_NATIVE_PROMPT") ?? cfg.slimNativePrompt ?? true,
+    };
+}
+/**
+ * E1: token threshold that triggers auto-compact.
+ * Soft path fires earlier; hard budget is always the ceiling used when soft is off.
+ */
+export function autoCompactTriggerTokens(policy = getReliabilityPolicy()) {
+    if (!policy.softEarlyCompact)
+        return policy.hardCompactTokenBudget;
+    return Math.min(policy.softCompactTokenBudget, policy.hardCompactTokenBudget);
+}
+/**
+ * E3: max completion tokens for a model step.
+ * Tool-heavy steps keep room for large writes; light steps use a lower cap.
+ * Never goes below {@link ADAPTIVE_MAX_TOKENS_FLOOR}.
+ */
+export function resolveStepMaxTokens(input) {
+    const policy = input.policy ?? getReliabilityPolicy();
+    if (!policy.adaptiveMaxTokens)
+        return LEGACY_MAX_TOKENS;
+    if (input.recoveryNudge) {
+        return Math.max(ADAPTIVE_MAX_TOKENS_FLOOR, ADAPTIVE_MAX_TOKENS_LIGHT);
+    }
+    if (input.toolsAttached || input.nativeToolsActive) {
+        return ADAPTIVE_MAX_TOKENS_TOOL_STEP;
+    }
+    return ADAPTIVE_MAX_TOKENS_LIGHT;
+}
+export function isFreeCloudProvider(provider) {
+    return providerCategory[provider] === "free-cloud";
+}
+/**
+ * E4: advisory notices for free-tier + large context / repeated failures.
+ * Never blocks the request.
+ */
+export function freeTierGuardNotices(input) {
+    const policy = input.policy ?? getReliabilityPolicy();
+    if (!policy.freeTierContextGuard)
+        return [];
+    if (!isFreeCloudProvider(input.provider))
+        return [];
+    const notices = [];
+    if (input.estimatedInputTokens >= policy.freeTierWarnTokens) {
+        notices.push(`Large context (~${input.estimatedInputTokens.toLocaleString()} tokens) on free-cloud model — disconnects and empty admissions are more common. Prefer /compact, a paid/local model, or shorter turns if this fails.`);
+    }
+    if (input.consecutiveFailures >= policy.freeTierFailThreshold) {
+        notices.push(`Free-cloud model failed ${input.consecutiveFailures} time(s) this turn. Switch with /model or /provider, or enable providerFallback for automatic recovery.`);
+    }
+    return notices;
+}
+/** Stable hash for E5 tool-result dedup (content only). */
+export function hashToolResultContent(content) {
+    return createHash("sha256").update(content).digest("hex").slice(0, 16);
+}
+/**
+ * E5: if identical tool output already appeared this turn, replace with a
+ * pointer so history does not grow with duplicate dumps. Full text remains
+ * available via artifact path when present.
+ */
+export function dedupeToolContextOutput(input) {
+    const policy = input.policy ?? getReliabilityPolicy();
+    const hash = hashToolResultContent(input.content);
+    if (!policy.toolResultDedup) {
+        return { content: input.content, deduped: false, hash };
+    }
+    // Tiny results are not worth pointer indirection.
+    if (input.content.length < 400) {
+        input.seenHashes.set(hash, {
+            toolName: input.toolName,
+            count: (input.seenHashes.get(hash)?.count ?? 0) + 1,
+        });
+        return { content: input.content, deduped: false, hash };
+    }
+    const prior = input.seenHashes.get(hash);
+    if (!prior) {
+        input.seenHashes.set(hash, { toolName: input.toolName, count: 1 });
+        return { content: input.content, deduped: false, hash };
+    }
+    prior.count += 1;
+    const artifact = input.artifactPath
+        ? ` Full output: ${input.artifactPath}`
+        : "";
+    const head = input.content.slice(0, 200).replace(/\s+/g, " ").trim();
+    const content = `[duplicate tool output — identical to earlier ${prior.toolName} this turn; hash=${hash}]${artifact}\n` +
+        `Preview: ${head}${input.content.length > 200 ? "…" : ""}\n` +
+        `Re-read the prior tool result or artifact if you need the full body; do not assume it changed.`;
+    return { content, deduped: true, hash };
+}
+//# sourceMappingURL=reliability-policy.js.map

package/dist/agent/reliability-policy.js.map

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