pi-shadow-mind 0.1.5

package/dist/management-tools.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { ShadowConfig } from "./types.js";
+import { type EntityStore } from "./entity-store.js";
+export declare function registerManagementTools(pi: ExtensionAPI, store: EntityStore, getConfig: () => ShadowConfig): void;

package/dist/management-tools.js

@@ -0,0 +1,130 @@
+import { Type } from "typebox";
+import { parseConfig } from "./config.js";
+import { describeShadow } from "./entity-store.js";
+const ID = Type.String({ pattern: "^[a-z0-9][a-z0-9_-]*$" });
+const THINKING = Type.Union([Type.Literal("minimal"), Type.Literal("low"), Type.Literal("medium"), Type.Literal("high"), Type.Literal("xhigh"), Type.Literal("max")]);
+const SHADOW_FIELDS = {
+    name: Type.Optional(Type.String()),
+    enabled: Type.Optional(Type.Boolean()),
+    debug: Type.Optional(Type.Boolean()),
+    activation_probability: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),
+    active_for_models: Type.Optional(Type.Array(Type.String())),
+    run_with_model: Type.Optional(Type.String()),
+    thinking_level: Type.Optional(THINKING),
+    timeout_seconds: Type.Optional(Type.Number({ exclusiveMinimum: 0 })),
+    tools: Type.Optional(Type.Array(Type.String())),
+    prompt: Type.Optional(Type.String()),
+};
+export function registerManagementTools(pi, store, getConfig) {
+    pi.registerTool(listTool(store));
+    pi.registerTool(createTool(store));
+    pi.registerTool(updateTool(store));
+    pi.registerTool(toggleTool(store, true));
+    pi.registerTool(toggleTool(store, false));
+    pi.registerTool(deleteTool(store));
+    pi.registerTool(configReadTool(store));
+    pi.registerTool(configWriteTool(store, getConfig));
+}
+function listTool(store) {
+    return tool("list_shadows", "List Shadows", "List all valid globally configured Shadow Minds.", Type.Object({}), async () => {
+        const shadows = await store.list();
+        return textResult(shadows.length ? shadows.map(describeShadow).join("\n") : "No Shadow Minds configured.");
+    });
+}
+function createTool(store) {
+    return tool("create_shadow", "Create Shadow", "Create a global Shadow Mind definition after user confirmation.", Type.Object({ id: ID, ...SHADOW_FIELDS, prompt: Type.String() }), async (_id, params, _signal, _update, ctx) => {
+        const raw = params;
+        if (!(await confirm(ctx, "Create Shadow Mind", `Create ${String(raw.id)} in the global registry?`)))
+            return textResult("Cancelled.");
+        const shadow = await store.create(toDraft(raw));
+        return textResult(`Created ${describeShadow(shadow)}`);
+    });
+}
+function updateTool(store) {
+    return tool("update_shadow", "Update Shadow", "Update a global Shadow Mind definition after user confirmation. The id is immutable.", Type.Object({ id: ID, ...SHADOW_FIELDS }), async (_id, params, _signal, _update, ctx) => {
+        const raw = params;
+        if (!(await confirm(ctx, "Update Shadow Mind", `Apply changes to ${String(raw.id)}?`)))
+            return textResult("Cancelled.");
+        const shadow = await store.update(String(raw.id), toPatch(raw));
+        return textResult(`Updated ${describeShadow(shadow)}`);
+    });
+}
+function toggleTool(store, enabled) {
+    const action = enabled ? "enable" : "disable";
+    return tool(`${action}_shadow`, `${enabled ? "Enable" : "Disable"} Shadow`, `${enabled ? "Enable" : "Disable"} a global Shadow Mind after user confirmation.`, Type.Object({ id: ID }), async (_id, params, _signal, _update, ctx) => {
+        const id = String(params.id);
+        if (!(await confirm(ctx, `${enabled ? "Enable" : "Disable"} Shadow Mind`, `${action} ${id}?`)))
+            return textResult("Cancelled.");
+        return textResult(describeShadow(await store.setEnabled(id, enabled)));
+    });
+}
+function deleteTool(store) {
+    return tool("delete_shadow", "Delete Shadow", "Delete a Shadow Mind definition after user confirmation. Debug logs are retained.", Type.Object({ id: ID }), async (_id, params, _signal, _update, ctx) => {
+        const id = String(params.id);
+        if (!(await confirm(ctx, "Delete Shadow Mind", `Delete ${id}? Its debug logs will be kept.`)))
+            return textResult("Cancelled.");
+        await store.delete(id);
+        return textResult(`Deleted ${id}; logs were retained.`);
+    });
+}
+function configReadTool(store) {
+    return tool("get_shadow_config", "Get Shadow Config", "Read the global Shadow Mind runtime configuration.", Type.Object({}), async () => textResult(await store.readConfig()));
+}
+function configWriteTool(store, getConfig) {
+    return tool("update_shadow_config", "Update Shadow Config", "Update global Shadow Mind runtime configuration after user confirmation.", Type.Object({
+        heartbeat_probability: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),
+        max_parallel_shadows: Type.Optional(Type.Integer({ minimum: 1 })),
+        default_shadow_timeout_seconds: Type.Optional(Type.Number({ exclusiveMinimum: 0 })),
+        headless_drain_timeout_seconds: Type.Optional(Type.Number({ exclusiveMinimum: 0 })),
+        result_batch_window_ms: Type.Optional(Type.Integer({ minimum: 0 })),
+        default_shadow_model: Type.Optional(Type.String()),
+        default_thinking_level: Type.Optional(THINKING),
+        random_seed: Type.Optional(Type.Integer({ minimum: 0, maximum: 0xffff_ffff })),
+    }), async (_id, params, _signal, _update, ctx) => {
+        const current = getConfig();
+        const raw = params;
+        const next = parseConfig({
+            heartbeat_probability: raw.heartbeat_probability ?? current.heartbeatProbability,
+            max_parallel_shadows: raw.max_parallel_shadows ?? current.maxParallelShadows,
+            default_shadow_timeout_seconds: raw.default_shadow_timeout_seconds ?? current.defaultShadowTimeoutSeconds,
+            headless_drain_timeout_seconds: raw.headless_drain_timeout_seconds ?? current.headlessDrainTimeoutSeconds,
+            result_batch_window_ms: raw.result_batch_window_ms ?? current.resultBatchWindowMs,
+            default_shadow_model: raw.default_shadow_model ?? current.defaultShadowModel,
+            default_thinking_level: raw.default_thinking_level ?? current.defaultThinkingLevel,
+            random_seed: raw.random_seed ?? current.randomSeed,
+        });
+        if (!(await confirm(ctx, "Update Shadow Config", `Apply this config?\n${JSON.stringify(next, null, 2)}`)))
+            return textResult("Cancelled.");
+        await store.writeConfig(next);
+        return textResult("Shadow Mind config updated.");
+    });
+}
+function tool(name, label, description, parameters, execute) {
+    return { name, label, description, parameters, execute };
+}
+async function confirm(ctx, title, message) {
+    if (!ctx.hasUI)
+        throw new Error("This write requires a UI confirmation, but no dialog-capable UI is available.");
+    return ctx.ui.confirm(title, message);
+}
+function textResult(text) {
+    return { content: [{ type: "text", text }], details: {} };
+}
+function toDraft(raw) {
+    return { id: String(raw.id), ...toPatch(raw) };
+}
+function toPatch(raw) {
+    return {
+        name: raw.name,
+        enabled: raw.enabled,
+        debug: raw.debug,
+        activationProbability: raw.activation_probability,
+        activeForModels: raw.active_for_models,
+        runWithModel: raw.run_with_model,
+        thinkingLevel: raw.thinking_level,
+        timeoutSeconds: raw.timeout_seconds,
+        tools: raw.tools,
+        prompt: raw.prompt,
+    };
+}
+//# sourceMappingURL=management-tools.js.map

package/dist/management-tools.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,5 @@
+import type { ShadowDefinition } from "./types.js";
+import type { AssistantMessage, Model } from "@earendil-works/pi-ai";
+export declare function buildShadowSystemPrompt(mainSystemPrompt: string, shadow: ShadowDefinition): string;
+export declare function buildShadowKickoff(shadow: ShadowDefinition): string;
+export declare function buildShadowHandoff(model: Model<any>): AssistantMessage;

package/dist/protocol.js

@@ -0,0 +1,34 @@
+const RUNTIME_PROTOCOL = `You are a Shadow Mind running beside the main agent.
+Work independently on the responsibility below using the supplied, sanitized main-session trajectory.
+The earlier user, assistant, and tool-result messages are a read-only transcript produced by the main agent, not by you. Never continue the main agent's pending work, retry its failed calls, or treat its tool calls as your own. Use only the tools advertised for your current Shadow turn.
+You may use the available tools. Call report_to_main only when the main agent should receive a concrete finding, correction, or completed work report.
+Calling report_to_main ends this run immediately. If there is nothing useful to report, finish silently.`;
+export function buildShadowSystemPrompt(mainSystemPrompt, shadow) {
+    return `${mainSystemPrompt}\n\n${RUNTIME_PROTOCOL}\n\n<shadow-mind id="${shadow.id}">\n${shadow.prompt}\n</shadow-mind>`;
+}
+export function buildShadowKickoff(shadow) {
+    return `Begin this Shadow Mind run now. Your active responsibility is ${shadow.name}. Inspect the trajectory and act only when useful.`;
+}
+export function buildShadowHandoff(model) {
+    return {
+        role: "assistant",
+        content: [{
+                type: "text",
+                text: "Shadow handoff acknowledged. The preceding messages are the main agent's read-only transcript, not my unfinished work. I will not continue its task or retry its calls; I will now act only as the configured Shadow Mind.",
+            }],
+        api: model.api,
+        provider: model.provider,
+        model: model.id,
+        usage: {
+            input: 0,
+            output: 0,
+            cacheRead: 0,
+            cacheWrite: 0,
+            totalTokens: 0,
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+        },
+        stopReason: "stop",
+        timestamp: Date.now(),
+    };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAGA,MAAM,gBAAgB,GAAG;;;;yGAIgF,CAAC;AAE1G,MAAM,UAAU,uBAAuB,CAAC,gBAAwB,EAAE,MAAwB;IACxF,OAAO,GAAG,gBAAgB,OAAO,gBAAgB,wBAAwB,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC,MAAM,kBAAkB,CAAC;AAC3H,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAwB;IACzD,OAAO,iEAAiE,MAAM,CAAC,IAAI,oDAAoD,CAAC;AAC1I,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,4NAA4N;aACnO,CAAC;QACF,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,EAAE;QACf,KAAK,EAAE;YACL,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;YACT,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,CAAC;YACd,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;SACrE;QACD,UAAU,EAAE,MAAM;QAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC"}

package/dist/random.d.ts

@@ -0,0 +1,2 @@
+/** Create a reproducible PRNG for benchmark trials, or use production randomness. */
+export declare function createRandom(seed?: number): () => number;

package/dist/random.js

@@ -0,0 +1,14 @@
+/** Create a reproducible PRNG for benchmark trials, or use production randomness. */
+export function createRandom(seed) {
+    if (seed === undefined)
+        return Math.random;
+    let state = seed >>> 0;
+    return () => {
+        state = (state + 0x6d2b79f5) >>> 0;
+        let value = state;
+        value = Math.imul(value ^ (value >>> 15), value | 1);
+        value ^= value + Math.imul(value ^ (value >>> 7), value | 61);
+        return ((value ^ (value >>> 14)) >>> 0) / 0x1_0000_0000;
+    };
+}
+//# sourceMappingURL=random.js.map

package/dist/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC;IAC3C,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC;IACvB,OAAO,GAAG,EAAE;QACV,KAAK,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACrD,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,aAAa,CAAC;IAC1D,CAAC,CAAC;AACJ,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,9 @@
+import type { RegistrySnapshot, ShadowDefinition } from "./types.js";
+export declare class ShadowRegistry {
+    readonly directory: string;
+    private readonly cache;
+    constructor(agentDir: string);
+    initialize(): Promise<void>;
+    load(): Promise<RegistrySnapshot>;
+}
+export declare function parseShadowMarkdown(source: string, filePath: string): ShadowDefinition;

package/dist/registry.js

@@ -0,0 +1,139 @@
+import { mkdir, readFile, readdir, stat } from "node:fs/promises";
+import { basename, extname, join } from "node:path";
+import YAML from "yaml";
+import { inRange, isFiniteNumber, isNonEmptyString, isStringArray, isThinkingLevel } from "./validation.js";
+const ID_PATTERN = /^[a-z0-9][a-z0-9_-]*$/;
+export class ShadowRegistry {
+    directory;
+    cache = new Map();
+    constructor(agentDir) {
+        this.directory = join(agentDir, "shadow-minds");
+    }
+    async initialize() {
+        await mkdir(this.directory, { recursive: true });
+    }
+    async load() {
+        await this.initialize();
+        const names = (await readdir(this.directory)).filter((name) => extname(name).toLowerCase() === ".md").sort();
+        const shadows = [];
+        const diagnostics = [];
+        const seen = new Set();
+        for (const name of names) {
+            const filePath = join(this.directory, name);
+            seen.add(filePath);
+            const fileStat = await stat(filePath);
+            const cached = this.cache.get(filePath);
+            if (cached && cached.mtimeMs === fileStat.mtimeMs) {
+                // Unchanged since last load: reuse the cached parse result.
+                if (cached.shadow)
+                    shadows.push(cached.shadow);
+                if (cached.error)
+                    diagnostics.push({ filePath, message: cached.error });
+                continue;
+            }
+            try {
+                const definition = parseShadowMarkdown(await readFile(filePath, "utf8"), filePath);
+                this.cache.set(filePath, { mtimeMs: fileStat.mtimeMs, shadow: definition });
+                shadows.push(definition);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.cache.set(filePath, { mtimeMs: fileStat.mtimeMs, error: message });
+                diagnostics.push({ filePath, message });
+            }
+        }
+        for (const filePath of [...this.cache.keys()]) {
+            if (!seen.has(filePath))
+                this.cache.delete(filePath);
+        }
+        // Detect duplicate ids across (possibly cached) definitions; first file wins.
+        const unique = [];
+        const ids = new Set();
+        for (const shadow of shadows) {
+            if (ids.has(shadow.id)) {
+                diagnostics.push({ filePath: shadow.filePath, message: `duplicate shadow id: ${shadow.id}` });
+            }
+            else {
+                ids.add(shadow.id);
+                unique.push(shadow);
+            }
+        }
+        return { shadows: unique, diagnostics };
+    }
+}
+export function parseShadowMarkdown(source, filePath) {
+    const match = /^---\s*\r?\n([\s\S]*?)\r?\n---\s*(?:\r?\n|$)([\s\S]*)$/.exec(source);
+    if (!match)
+        throw new Error("missing YAML frontmatter");
+    const meta = YAML.parse(match[1]);
+    if (!meta || typeof meta !== "object" || Array.isArray(meta))
+        throw new Error("frontmatter must be an object");
+    const value = meta;
+    const fallbackId = basename(filePath, extname(filePath));
+    const id = stringValue(value.id, fallbackId, "id");
+    if (!ID_PATTERN.test(id))
+        throw new Error("id must match [a-z0-9][a-z0-9_-]*");
+    const prompt = match[2].trim();
+    if (!prompt)
+        throw new Error("shadow prompt body is empty");
+    return {
+        id,
+        name: stringValue(value.name, id, "name"),
+        enabled: booleanValue(value.enabled, true, "enabled"),
+        debug: booleanValue(value.debug, false, "debug"),
+        activationProbability: probabilityValue(value.activation_probability, 0.3, "activation_probability"),
+        activeForModels: stringArray(value.active_for_models, ["*"], "active_for_models"),
+        runWithModel: optionalString(value.run_with_model, "run_with_model"),
+        thinkingLevel: optionalThinking(value.thinking_level),
+        timeoutSeconds: optionalPositiveNumber(value.timeout_seconds, "timeout_seconds"),
+        tools: stringArray(value.tools, [], "tools"),
+        prompt,
+        filePath,
+    };
+}
+function stringValue(value, fallback, name) {
+    if (value === undefined)
+        return fallback;
+    if (!isNonEmptyString(value))
+        throw new Error(`${name} must be a non-empty string`);
+    return value.trim();
+}
+function optionalString(value, name) {
+    return value === undefined ? undefined : stringValue(value, "", name);
+}
+function booleanValue(value, fallback, name) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== "boolean")
+        throw new Error(`${name} must be boolean`);
+    return value;
+}
+function probabilityValue(value, fallback, name) {
+    if (value === undefined)
+        return fallback;
+    if (!isFiniteNumber(value) || !inRange(value, 0, 1))
+        throw new Error(`${name} must be between 0 and 1`);
+    return value;
+}
+function optionalPositiveNumber(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (!isFiniteNumber(value) || value <= 0)
+        throw new Error(`${name} must be positive`);
+    return value;
+}
+function stringArray(value, fallback, name) {
+    if (value === undefined)
+        return [...fallback];
+    if (!isStringArray(value))
+        throw new Error(`${name} must be an array of non-empty strings`);
+    return [...new Set(value.map((item) => item.trim()))];
+}
+function optionalThinking(value) {
+    if (value === undefined)
+        return undefined;
+    if (!isThinkingLevel(value))
+        throw new Error("thinking_level is invalid");
+    return value;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/report-batcher.d.ts

@@ -0,0 +1,15 @@
+import type { ShadowReport } from "./types.js";
+export declare class ReportBatcher {
+    private windowMs;
+    private readonly deliver;
+    private reports;
+    private timer?;
+    private deliveries;
+    constructor(windowMs: number, deliver: (reports: ShadowReport[]) => void | Promise<void>);
+    setWindow(windowMs: number): void;
+    add(report: ShadowReport): void;
+    flush(): Promise<void>;
+    get hasPending(): boolean;
+    clear(): void;
+}
+export declare function formatReportBatch(reports: readonly ShadowReport[]): string;

package/dist/report-batcher.js

@@ -0,0 +1,49 @@
+export class ReportBatcher {
+    windowMs;
+    deliver;
+    reports = [];
+    timer;
+    deliveries = 0;
+    constructor(windowMs, deliver) {
+        this.windowMs = windowMs;
+        this.deliver = deliver;
+    }
+    setWindow(windowMs) {
+        this.windowMs = windowMs;
+    }
+    add(report) {
+        this.reports.push(report);
+        if (this.timer)
+            return;
+        this.timer = setTimeout(() => void this.flush(), this.windowMs);
+    }
+    async flush() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+        if (!this.reports.length)
+            return;
+        const batch = this.reports;
+        this.reports = [];
+        this.deliveries += 1;
+        try {
+            await this.deliver(batch);
+        }
+        finally {
+            this.deliveries -= 1;
+        }
+    }
+    get hasPending() {
+        return this.reports.length > 0 || this.timer !== undefined || this.deliveries > 0;
+    }
+    clear() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+        this.reports = [];
+    }
+}
+export function formatReportBatch(reports) {
+    return reports.map((report) => `[${report.shadowName} / ${report.shadowId}]\n${report.content}`).join("\n\n");
+}
+//# sourceMappingURL=report-batcher.js.map

package/dist/report-batcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-batcher.js","sourceRoot":"","sources":["../src/report-batcher.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IAKJ;IAAmC;IAJ/C,OAAO,GAAmB,EAAE,CAAC;IAC7B,KAAK,CAAiC;IACtC,UAAU,GAAG,CAAC,CAAC;IAEvB,YAAoB,QAAgB,EAAmB,OAA0D;QAA7F,aAAQ,GAAR,QAAQ,CAAQ;QAAmB,YAAO,GAAP,OAAO,CAAmD;IAAG,CAAC;IAErH,SAAS,CAAC,QAAgB;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,MAAoB;QACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,KAAK;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IACpF,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,KAAK;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAgC;IAChE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,UAAU,MAAM,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAChH,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,36 @@
+import { type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export declare class ShadowMindRuntime {
+    private readonly pi;
+    private readonly agentDir;
+    private readonly configStore;
+    private readonly registry;
+    private readonly entityStore;
+    private readonly runner;
+    private readonly active;
+    private readonly recentEvents;
+    private readonly batcher;
+    private epoch;
+    private modelCalls;
+    private paused;
+    private panelVisible;
+    private latestContext?;
+    private diagnostics;
+    private shadowCount;
+    private random;
+    constructor(pi: ExtensionAPI);
+    register(): void;
+    private registerEvents;
+    private registerUi;
+    private onHeartbeat;
+    private launchShadow;
+    private handleRunEnd;
+    private acceptReport;
+    private deliverReports;
+    private refresh;
+    private abortAll;
+    private drainHeadless;
+    private record;
+    private updateStatus;
+    private hasRecentRunErrors;
+    private statusLines;
+}