pi-shadow-mind 0.1.5

package/dist/shadow-runner.js

@@ -0,0 +1,251 @@
+import { mkdir } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { basename, dirname, join, normalize, resolve } from "node:path";
+import { Type } from "typebox";
+import { DefaultResourceLoader, SessionManager, SettingsManager, createAgentSession, } from "@earendil-works/pi-coding-agent";
+import { DEFAULT_READ_TOOLS } from "./types.js";
+/**
+ * Resolve the final tool allowlist for a Shadow run against the main session's
+ * tool registry, per the design contract:
+ *
+ * - the final set is `readOnlyTools defaults + whitelist + report_to_main`;
+ * - names that do not exist in the main session are dropped (ignored) and
+ *   returned as `missing`, while the rest are provided normally;
+ * - the built-in `report_to_main` is always kept.
+ */
+export function resolveShadowTools(whitelist, available, defaults = DEFAULT_READ_TOOLS) {
+    const builtin = new Set(["report_to_main"]);
+    const requested = [...new Set([...defaults, ...whitelist, ...builtin])];
+    const tools = [];
+    const missing = [];
+    for (const name of requested) {
+        (builtin.has(name) || available.has(name) ? tools : missing).push(name);
+    }
+    return { tools, missing };
+}
+import { buildShadowHandoff, buildShadowKickoff, buildShadowSystemPrompt } from "./protocol.js";
+import { sanitizeTrajectory } from "./trajectory.js";
+const SELF_PATH = normalize(resolve(fileURLToPath(import.meta.url)));
+function runReason(timedOut, reported, aborted, failed = false) {
+    if (timedOut)
+        return "timeout";
+    if (reported)
+        return "report";
+    if (aborted)
+        return "aborted";
+    return failed ? "error" : "silent";
+}
+/** Unify the three run() return paths so result shape changes touch one place. */
+export function buildRunResult(options) {
+    const { reason, error, durationMs, session, baseMessageCount, missingTools, thinkingLevel } = options;
+    const ownMessages = session ? session.messages.slice(baseMessageCount) : [];
+    const metrics = toolMetrics(ownMessages);
+    return {
+        reason,
+        ...(error !== undefined ? { error } : {}),
+        durationMs,
+        toolNames: session?.getActiveToolNames() ?? [],
+        missingTools,
+        ...metrics,
+        ...(thinkingLevel !== undefined ? { thinkingLevel } : {}),
+        sessionFile: session?.sessionFile,
+    };
+}
+export class ShadowRunner {
+    controllers = new Map();
+    async run(request) {
+        const started = Date.now();
+        const controller = new AbortController();
+        this.controllers.set(request.runId, { controller });
+        const state = { reported: false, timedOut: false };
+        let finalReason = "error";
+        let sessionManager;
+        let timeout;
+        let missingTools = [];
+        let baseMessageCount = 0;
+        let thinkingLevel;
+        try {
+            const model = resolveRunModel(request);
+            assertShadowModelAuth(model, request);
+            const trajectory = sanitizeTrajectory(request.messages);
+            assertTrajectoryFits(model, trajectory);
+            sessionManager = await createShadowSessionManager(request);
+            for (const message of trajectory)
+                sessionManager.appendMessage(message);
+            sessionManager.appendMessage(buildShadowHandoff(model));
+            const boot = await this.bootstrapSession(request, model, controller, state, sessionManager);
+            state.session = boot.session;
+            missingTools = boot.missingTools;
+            thinkingLevel = boot.thinkingLevel;
+            baseMessageCount = boot.session.messages.length;
+            this.controllers.set(request.runId, { controller, session: boot.session });
+            if (controller.signal.aborted) {
+                finalReason = "aborted";
+                return buildRunResult({ reason: finalReason, durationMs: Date.now() - started, session: boot.session, baseMessageCount, missingTools, thinkingLevel });
+            }
+            const timeoutMs = (request.shadow.timeoutSeconds ?? request.config.defaultShadowTimeoutSeconds) * 1000;
+            timeout = setTimeout(() => {
+                state.timedOut = true;
+                controller.abort();
+                void boot.session?.abort();
+            }, timeoutMs);
+            controller.signal.addEventListener("abort", () => void boot.session?.abort(), { once: true });
+            await boot.session.prompt(buildShadowKickoff(request.shadow));
+            await boot.session.waitForIdle();
+            finalReason = runReason(state.timedOut, state.reported, controller.signal.aborted);
+            return buildRunResult({ reason: finalReason, durationMs: Date.now() - started, session: boot.session, baseMessageCount, missingTools, thinkingLevel });
+        }
+        catch (error) {
+            finalReason = runReason(state.timedOut, state.reported, controller.signal.aborted, true);
+            return buildRunResult({ reason: finalReason, error: error instanceof Error ? error.message : String(error), durationMs: Date.now() - started, session: state.session, baseMessageCount, missingTools, thinkingLevel });
+        }
+        finally {
+            if (timeout)
+                clearTimeout(timeout);
+            sessionManager?.appendCustomEntry("shadow-mind-run-end", { runId: request.runId, reason: finalReason, durationMs: Date.now() - started });
+            state.session?.dispose();
+            this.controllers.delete(request.runId);
+        }
+    }
+    /** Build the shadow AgentSession (loader, report tool, allowlist) and validate it. */
+    async bootstrapSession(request, model, controller, state, sessionManager) {
+        const thinkingLevel = resolveRunThinkingLevel(model, request);
+        const settingsManager = SettingsManager.create(request.cwd, request.agentDir);
+        const resourceLoader = new DefaultResourceLoader({
+            cwd: request.cwd,
+            agentDir: request.agentDir,
+            settingsManager,
+            systemPrompt: buildShadowSystemPrompt(request.mainSystemPrompt, request.shadow),
+            // The inherited main system prompt already embeds APPEND_SYSTEM.md,
+            // AGENTS.md and skills; keep the loader from re-discovering them so the
+            // shadow context stays a strict subset (no duplication).
+            appendSystemPrompt: [],
+            agentsFilesOverride: () => ({ agentsFiles: [] }),
+            skillsOverride: (base) => ({ skills: [], diagnostics: base.diagnostics }),
+            extensionsOverride: (base) => ({
+                ...base,
+                extensions: base.extensions.filter((extension) => !isSelfExtension(extension.resolvedPath)),
+            }),
+        });
+        const reportTool = createReportTool((content) => {
+            if (state.reported || controller.signal.aborted)
+                return;
+            state.reported = true;
+            request.onReport({
+                shadowId: request.shadow.id,
+                shadowName: request.shadow.name,
+                content,
+                epoch: request.epoch,
+                runId: request.runId,
+            });
+            queueMicrotask(() => void state.session?.abort());
+        });
+        const tools = [...new Set(request.tools)];
+        const created = await createAgentSession({
+            cwd: request.cwd,
+            agentDir: request.agentDir,
+            model,
+            thinkingLevel,
+            tools,
+            customTools: [reportTool],
+            resourceLoader,
+            sessionManager,
+            settingsManager,
+        });
+        const missingTools = tools.filter((name) => !created.session.getActiveToolNames().includes(name));
+        return { session: created.session, missingTools, thinkingLevel };
+    }
+    abort(runId) {
+        this.controllers.get(runId)?.controller.abort();
+    }
+    abortAll() {
+        for (const { controller } of this.controllers.values())
+            controller.abort();
+    }
+}
+export function toolMetrics(messages) {
+    const stats = new Map();
+    for (const message of messages) {
+        if (message.role !== "toolResult")
+            continue;
+        const tool = message.toolName ?? "unknown";
+        const entry = stats.get(tool) ?? { tool, calls: 0, failures: 0 };
+        entry.calls += 1;
+        if (message.isError)
+            entry.failures += 1;
+        stats.set(tool, entry);
+    }
+    const toolStats = [...stats.values()].sort((a, b) => b.calls - a.calls);
+    return {
+        toolCalls: toolStats.reduce((sum, stat) => sum + stat.calls, 0),
+        toolFailures: toolStats.reduce((sum, stat) => sum + stat.failures, 0),
+        toolStats,
+    };
+}
+function createReportTool(onReport) {
+    return {
+        name: "report_to_main",
+        label: "Report to Main",
+        description: "Report a concrete finding or completed result to the main agent and immediately end this Shadow Mind run.",
+        promptSnippet: "Report a useful result to the main agent and end this run",
+        parameters: Type.Object({ content: Type.String({ description: "The complete report for the main agent" }) }),
+        async execute(_toolCallId, params) {
+            const content = params.content;
+            onReport(content);
+            return { content: [{ type: "text", text: "Report delivered." }], details: {}, terminate: true };
+        },
+    };
+}
+async function createShadowSessionManager(request) {
+    if (!request.shadow.debug)
+        return SessionManager.inMemory(request.cwd);
+    const directory = join(request.agentDir, "shadow-minds", "logs", request.shadow.id);
+    await mkdir(directory, { recursive: true });
+    const manager = SessionManager.create(request.cwd, directory);
+    manager.appendCustomEntry("shadow-mind-run", { runId: request.runId, epoch: request.epoch, shadowId: request.shadow.id });
+    return manager;
+}
+function resolveRunModel(request) {
+    const fullId = request.shadow.runWithModel ?? request.config.defaultShadowModel;
+    if (!fullId)
+        return request.mainModel;
+    const model = request.resolveModel(fullId);
+    if (!model)
+        throw new Error(`shadow model not found: ${fullId}`);
+    return model;
+}
+function assertShadowModelAuth(model, request) {
+    if (request.modelAuthOk && !request.modelAuthOk(model)) {
+        throw new Error(`shadow model ${model.provider}/${model.id} has no configured auth`);
+    }
+}
+/**
+ * Resolve the thinking level for this run: shadow config → plugin default →
+ * the main session's effective level. The first candidate the model supports
+ * (per its thinkingLevelMap; null marks unsupported, a missing key or map means
+ * provider default, i.e. supported) wins. Fails only when none are supported.
+ */
+export function resolveRunThinkingLevel(model, request) {
+    const candidates = [request.shadow.thinkingLevel, request.config.defaultThinkingLevel, request.mainThinkingLevel]
+        .filter((level) => level !== undefined);
+    for (const level of candidates) {
+        if (model.thinkingLevelMap?.[level] !== null)
+            return level;
+    }
+    throw new Error(`no supported thinking level for ${model.provider}/${model.id} (tried: ${candidates.join(", ") || "none"})`);
+}
+function assertTrajectoryFits(model, messages) {
+    const chars = messages.reduce((sum, message) => sum + (JSON.stringify(message)?.length ?? 0), 0);
+    const estimated = Math.ceil(chars / 2);
+    if (estimated > model.contextWindow) {
+        throw new Error(`trajectory ~${estimated} tokens exceeds ${model.provider}/${model.id} context window (${model.contextWindow})`);
+    }
+}
+function isSelfExtension(candidate) {
+    const normalized = normalize(resolve(candidate));
+    if (normalized === SELF_PATH)
+        return true;
+    const sourceDirectory = normalize(resolve(dirname(SELF_PATH)));
+    return dirname(normalized) === sourceDirectory && (basename(normalized) === "index.ts" || basename(normalized) === "index.js");
+}
+//# sourceMappingURL=shadow-runner.js.map

package/dist/shadow-runner.js.map

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

package/dist/shutdown-drain.d.ts

@@ -0,0 +1,12 @@
+export interface DrainResult {
+    settled: boolean;
+    durationMs: number;
+}
+export declare function waitForSettled(options: {
+    timeoutMs: number;
+    isSettled: () => boolean;
+    pollMs?: number;
+    quietMs?: number;
+    now?: () => number;
+    delay?: (ms: number) => Promise<void>;
+}): Promise<DrainResult>;

package/dist/shutdown-drain.js

@@ -0,0 +1,22 @@
+export async function waitForSettled(options) {
+    const pollMs = options.pollMs ?? 25;
+    const quietMs = options.quietMs ?? 50;
+    const now = options.now ?? Date.now;
+    const delay = options.delay ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const started = now();
+    let settledSince;
+    while (now() - started < options.timeoutMs) {
+        if (options.isSettled()) {
+            settledSince ??= now();
+            if (now() - settledSince >= quietMs)
+                return { settled: true, durationMs: now() - started };
+        }
+        else {
+            settledSince = undefined;
+        }
+        const remaining = options.timeoutMs - (now() - started);
+        await delay(Math.min(pollMs, Math.max(1, remaining)));
+    }
+    return { settled: false, durationMs: now() - started };
+}
+//# sourceMappingURL=shutdown-drain.js.map

package/dist/shutdown-drain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-drain.js","sourceRoot":"","sources":["../src/shutdown-drain.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAOpC;IACC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACzG,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;IACtB,IAAI,YAAgC,CAAC;IAErC,OAAO,GAAG,EAAE,GAAG,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;YACxB,YAAY,KAAK,GAAG,EAAE,CAAC;YACvB,IAAI,GAAG,EAAE,GAAG,YAAY,IAAI,OAAO;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QAC7F,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,SAAS,CAAC;QAC3B,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;QACxD,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;AACzD,CAAC"}

package/dist/summaries.d.ts

@@ -0,0 +1,9 @@
+interface ToolResultLike {
+    toolName?: string;
+    content?: unknown;
+    isError?: boolean;
+}
+type Summarizer = (result: ToolResultLike) => string;
+export declare function summarizeToolResult(result: ToolResultLike): string;
+export declare function registerToolResultSummarizer(toolName: string, summarizer: Summarizer): void;
+export {};

package/dist/summaries.js

@@ -0,0 +1,56 @@
+const summarizers = new Map([
+    ["read", (result) => summarizeLines(result, "read")],
+    ["grep", (result) => summarizeLines(result, "matches")],
+    ["find", (result) => summarizeLines(result, "paths")],
+    ["ls", (result) => summarizeLines(result, "entries")],
+]);
+export function summarizeToolResult(result) {
+    const summary = summarizers.get(result.toolName ?? "")?.(result) ?? summarizeGeneric(result);
+    return result.isError ? `error · ${summary}` : summary;
+}
+export function registerToolResultSummarizer(toolName, summarizer) {
+    summarizers.set(toolName, summarizer);
+}
+function summarizeLines(result, noun) {
+    const text = textContent(result.content);
+    if (!text)
+        return `0 ${noun}`;
+    const lines = text.split(/\r?\n/).filter(Boolean);
+    const preview = compact(lines[0] ?? "");
+    return `${lines.length} ${noun}${preview ? ` · ${preview}` : ""}`;
+}
+function summarizeGeneric(result) {
+    return describeContent(result.content) ?? "no output";
+}
+function describeContent(content) {
+    if (Array.isArray(content)) {
+        const blocks = content.filter((block) => Boolean(block) && typeof block === "object");
+        if (!blocks.length)
+            return "empty result";
+        const counts = new Map();
+        for (const block of blocks) {
+            const type = block.type ?? "object";
+            counts.set(type, (counts.get(type) ?? 0) + 1);
+        }
+        return [...counts.entries()].map(([type, count]) => `${count} ${type}${count > 1 ? "s" : ""}`).join(" · ");
+    }
+    if (content === null)
+        return "null";
+    if (typeof content === "string")
+        return `text · ${content.length} chars`;
+    if (typeof content === "number" || typeof content === "boolean")
+        return `${typeof content} · ${String(content)}`;
+    if (typeof content === "object")
+        return `object · ${Object.keys(content).length} keys`;
+    return undefined;
+}
+function textContent(content) {
+    if (!Array.isArray(content))
+        return "";
+    return content.filter((part) => Boolean(part) && typeof part === "object" && part.type === "text")
+        .map((part) => part.text ?? "").join("\n");
+}
+function compact(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=summaries.js.map

package/dist/summaries.js.map

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

package/dist/trajectory.d.ts

@@ -0,0 +1,7 @@
+type MessageLike = {
+    role?: string;
+    content?: unknown;
+    [key: string]: unknown;
+};
+export declare function sanitizeTrajectory(messages: readonly MessageLike[]): MessageLike[];
+export {};

package/dist/trajectory.js

@@ -0,0 +1,33 @@
+import { summarizeToolResult } from "./summaries.js";
+export function sanitizeTrajectory(messages) {
+    return messages.flatMap((message) => {
+        if (message.role === "assistant") {
+            const content = Array.isArray(message.content)
+                ? message.content.filter((block) => !isThinkingBlock(block)).map(clone)
+                : message.content;
+            return [{ ...clone(message), content }];
+        }
+        if (message.role === "toolResult") {
+            return [{
+                    ...clone(message),
+                    content: [{ type: "text", text: summarizeToolResult(message) }],
+                    details: undefined,
+                    usage: undefined,
+                }];
+        }
+        if (message.role === "custom") {
+            return message.customType === "shadow-report" ? [clone(message)] : [];
+        }
+        if (message.role === "user" || message.role === "compactionSummary" || message.role === "branchSummary") {
+            return [clone(message)];
+        }
+        return [];
+    });
+}
+function isThinkingBlock(value) {
+    return Boolean(value) && typeof value === "object" && value.type === "thinking";
+}
+function clone(value) {
+    return structuredClone(value);
+}
+//# sourceMappingURL=trajectory.js.map

package/dist/trajectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.js","sourceRoot":"","sources":["../src/trajectory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD,MAAM,UAAU,kBAAkB,CAAC,QAAgC;IACjE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAClC,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC5C,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;gBACvE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;YACpB,OAAO,CAAC,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAClC,OAAO,CAAC;oBACN,GAAG,KAAK,CAAC,OAAO,CAAC;oBACjB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC/D,OAAO,EAAE,SAAS;oBAClB,KAAK,EAAE,SAAS;iBACjB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC,UAAU,KAAK,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,mBAAmB,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACxG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,KAA2B,CAAC,IAAI,KAAK,UAAU,CAAC;AACzG,CAAC;AAED,SAAS,KAAK,CAAI,KAAQ;IACxB,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,64 @@
+import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
+export declare const DEFAULT_READ_TOOLS: readonly ["read", "grep", "find", "ls"];
+export interface ShadowConfig {
+    heartbeatProbability: number;
+    maxParallelShadows: number;
+    defaultShadowTimeoutSeconds: number;
+    headlessDrainTimeoutSeconds: number;
+    resultBatchWindowMs: number;
+    defaultShadowModel?: string;
+    defaultThinkingLevel: ThinkingLevel;
+    randomSeed?: number;
+}
+export interface ShadowDefinition {
+    id: string;
+    name: string;
+    enabled: boolean;
+    debug: boolean;
+    activationProbability: number;
+    activeForModels: string[];
+    runWithModel?: string;
+    thinkingLevel?: ThinkingLevel;
+    timeoutSeconds?: number;
+    tools: string[];
+    prompt: string;
+    filePath: string;
+}
+export interface RegistryDiagnostic {
+    filePath: string;
+    message: string;
+}
+export interface RegistrySnapshot {
+    shadows: ShadowDefinition[];
+    diagnostics: RegistryDiagnostic[];
+}
+export type RunEndReason = "report" | "silent" | "timeout" | "aborted" | "error";
+export interface ShadowReport {
+    shadowId: string;
+    shadowName: string;
+    content: string;
+    epoch: number;
+    runId: string;
+}
+export interface RuntimeEvent {
+    at: string;
+    kind: string;
+    epoch: number;
+    data?: Record<string, unknown>;
+}
+export interface HeartbeatDecision {
+    heartbeatRoll: number;
+    activated: Array<{
+        shadow: ShadowDefinition;
+        roll: number;
+    }>;
+    candidates: Array<{
+        shadowId: string;
+        roll: number;
+        selected: boolean;
+    }>;
+    /** Shadow ids excluded because active_for_models did not match the main model. */
+    modelFiltered: string[];
+    /** Shadow ids excluded because the same shadow is already running. */
+    runningExcluded: string[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export const DEFAULT_READ_TOOLS = ["read", "grep", "find", "ls"];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAU,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,8 @@
+import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
+/** Canonical set of valid pi thinking levels, shared by config and registry. */
+export declare const THINKING_LEVELS: ReadonlySet<ThinkingLevel>;
+export declare function isFiniteNumber(value: unknown): value is number;
+export declare function inRange(value: number, min: number, max: number): boolean;
+export declare function isNonEmptyString(value: unknown): value is string;
+export declare function isStringArray(value: unknown): value is string[];
+export declare function isThinkingLevel(value: unknown): value is ThinkingLevel;

package/dist/validation.js

@@ -0,0 +1,18 @@
+/** Canonical set of valid pi thinking levels, shared by config and registry. */
+export const THINKING_LEVELS = new Set(["off", "minimal", "low", "medium", "high", "xhigh", "max"]);
+export function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+export function inRange(value, min, max) {
+    return value >= min && value <= max;
+}
+export function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim() !== "";
+}
+export function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => isNonEmptyString(item));
+}
+export function isThinkingLevel(value) {
+    return typeof value === "string" && THINKING_LEVELS.has(value);
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAA+B,IAAI,GAAG,CAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAE/I,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC7D,OAAO,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,KAAsB,CAAC,CAAC;AAClF,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "pi-shadow-mind",
+  "version": "0.1.5",
+  "description": "Parallel cognitive runtime for Pi",
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "agent",
+    "multi-agent"
+  ],
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md",
+    "DESIGN.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json && esbuild src/index.ts --bundle --platform=node --format=esm --target=node20 --outfile=dist/index.js --sourcemap --external:@earendil-works/* --external:typebox",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "verify": "npm run typecheck && npm test",
+    "prepack": "npm run verify && npm run build"
+  },
+  "dependencies": {
+    "yaml": "^2.8.1"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-agent-core": "^0.84.1",
+    "@earendil-works/pi-ai": "^0.84.1",
+    "@earendil-works/pi-coding-agent": "^0.84.1",
+    "@earendil-works/pi-tui": "^0.84.1",
+    "@types/node": "^24.0.0",
+    "esbuild": "^0.25.0",
+    "typebox": "^1.3.13",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  }
+}