@ashx-j/lunr 0.1.0

package/dist/core/cron/origin-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin-context.d.ts","sourceRoot":"","sources":["../../../src/core/cron/origin-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE1E;AAED,oFAAoF;AACpF,wBAAgB,aAAa,IAAI,iBAAiB,GAAG,SAAS,CAE7D","sourcesContent":["/**\n * lunR: cron origin context (Phase 4 of the cron/gateway roadmap).\n *\n * AsyncLocalStorage carrying the chat a gateway turn came from. The gateway\n * agent bridge wraps session.prompt() in runWithOrigin(source, ...) so any\n * tool executing during that turn (e.g. the `cron` tool's create action) can\n * stamp jobs with the chat as their delivery origin. AsyncLocalStorage\n * propagates through awaited async calls, so deeply-nested tool execution\n * still sees the origin. Outside a gateway turn currentOrigin() is undefined\n * and behavior is unchanged (jobs default to \"local\" delivery).\n */\n\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport interface CronOriginContext {\n\tplatform: string;\n\tchatId: string;\n\tthreadId?: string;\n\tchatType?: string;\n}\n\nconst storage = new AsyncLocalStorage<CronOriginContext>();\n\n/** Run fn with `origin` visible to currentOrigin() for the whole async call tree. */\nexport function runWithOrigin<T>(origin: CronOriginContext, fn: () => T): T {\n\treturn storage.run(origin, fn);\n}\n\n/** The origin of the current async context, or undefined outside a gateway turn. */\nexport function currentOrigin(): CronOriginContext | undefined {\n\treturn storage.getStore();\n}\n"]}

package/dist/core/cron/origin-context.js

@@ -0,0 +1,22 @@
+/**
+ * lunR: cron origin context (Phase 4 of the cron/gateway roadmap).
+ *
+ * AsyncLocalStorage carrying the chat a gateway turn came from. The gateway
+ * agent bridge wraps session.prompt() in runWithOrigin(source, ...) so any
+ * tool executing during that turn (e.g. the `cron` tool's create action) can
+ * stamp jobs with the chat as their delivery origin. AsyncLocalStorage
+ * propagates through awaited async calls, so deeply-nested tool execution
+ * still sees the origin. Outside a gateway turn currentOrigin() is undefined
+ * and behavior is unchanged (jobs default to "local" delivery).
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+const storage = new AsyncLocalStorage();
+/** Run fn with `origin` visible to currentOrigin() for the whole async call tree. */
+export function runWithOrigin(origin, fn) {
+    return storage.run(origin, fn);
+}
+/** The origin of the current async context, or undefined outside a gateway turn. */
+export function currentOrigin() {
+    return storage.getStore();
+}
+//# sourceMappingURL=origin-context.js.map

package/dist/core/cron/origin-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin-context.js","sourceRoot":"","sources":["../../../src/core/cron/origin-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AASrD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAqB,CAAC;AAE3D,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAI,MAAyB,EAAE,EAAW,EAAK;IAC3E,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAAA,CAC/B;AAED,oFAAoF;AACpF,MAAM,UAAU,aAAa,GAAkC;IAC9D,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAAA,CAC1B","sourcesContent":["/**\n * lunR: cron origin context (Phase 4 of the cron/gateway roadmap).\n *\n * AsyncLocalStorage carrying the chat a gateway turn came from. The gateway\n * agent bridge wraps session.prompt() in runWithOrigin(source, ...) so any\n * tool executing during that turn (e.g. the `cron` tool's create action) can\n * stamp jobs with the chat as their delivery origin. AsyncLocalStorage\n * propagates through awaited async calls, so deeply-nested tool execution\n * still sees the origin. Outside a gateway turn currentOrigin() is undefined\n * and behavior is unchanged (jobs default to \"local\" delivery).\n */\n\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport interface CronOriginContext {\n\tplatform: string;\n\tchatId: string;\n\tthreadId?: string;\n\tchatType?: string;\n}\n\nconst storage = new AsyncLocalStorage<CronOriginContext>();\n\n/** Run fn with `origin` visible to currentOrigin() for the whole async call tree. */\nexport function runWithOrigin<T>(origin: CronOriginContext, fn: () => T): T {\n\treturn storage.run(origin, fn);\n}\n\n/** The origin of the current async context, or undefined outside a gateway turn. */\nexport function currentOrigin(): CronOriginContext | undefined {\n\treturn storage.getStore();\n}\n"]}

package/dist/core/cron/scheduler.d.ts

@@ -0,0 +1,51 @@
+/**
+ * lunR: cron scheduler loop (Phase 1 of the cron/gateway roadmap).
+ *
+ * startScheduler() runs an unref'd, self-rescheduling setTimeout loop (default
+ * 60s tick). Tick errors are caught — the loop never dies. Each tick collects
+ * due jobs and runs them SEQUENTIALLY; recurring jobs are advanceNextRun()'d
+ * BEFORE execution (at-most-once: a crash mid-run never double-fires).
+ *
+ * Per due job: build the prompt (cron-hint prefix + contextFrom upstream
+ * outputs at an 8K cap each + job.prompt) → runJob → saveJobOutput →
+ * [SILENT] check (whole response, or first/last line) → deliverResult.
+ * Empty responses are soft failures; all failures attempt delivery of a
+ * compact one-line error. Delivery errors land in job.lastDeliveryError.
+ *
+ * The scheduler knows nothing about delivery channels: runJob/deliverResult
+ * are injected (the lunr-cron builtin extension wires the TUI + the
+ * @lunr/cron-delivery bridge; the Phase 4 gateway replaces that bridge).
+ */
+import type { CronJob } from "./jobs.ts";
+export interface SchedulerDeps {
+    /** Run one job turn; resolves with the final assistant text. */
+    runJob: (prompt: string, job: CronJob) => Promise<string>;
+    /** Deliver a result (or failure notice) to the job's targets. Throws on failure. */
+    deliverResult: (job: CronJob, content: string) => Promise<void>;
+    /** Tick interval; default 60s. */
+    intervalMs?: number;
+    /** Per-job wall-clock timeout; default 5 minutes. */
+    jobTimeoutMs?: number;
+}
+export declare const SILENT_TAG = "[SILENT]";
+/** Prefix telling the model it runs unattended and how to suppress delivery. */
+export declare function cronPromptPrefix(job: CronJob): string;
+/** Whole response, or the first/last line, is exactly [SILENT] → suppress delivery. */
+export declare function isSilent(text: string): boolean;
+/** cron-hint prefix + contextFrom upstream outputs (8K chars cap each) + job prompt. */
+export declare function buildJobPrompt(job: CronJob): string;
+/**
+ * Execute one due job through the full pipeline. Never throws — run errors,
+ * empty responses and delivery errors are recorded on the job.
+ */
+export declare function executeJob(job: CronJob, deps: SchedulerDeps): Promise<void>;
+/** One scheduler tick: run every due job sequentially. Exported for tests. */
+export declare function runSchedulerTick(deps: SchedulerDeps, now?: Date): Promise<void>;
+/**
+ * Start the scheduler loop. Unref'd so it never keeps the process alive;
+ * tick errors are swallowed so the loop never dies.
+ */
+export declare function startScheduler(deps: SchedulerDeps): {
+    stop(): void;
+};
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/core/cron/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/core/cron/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,MAAM,WAAW,aAAa;IAC7B,gEAAgE;IAChE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,oFAAoF;IACpF,aAAa,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,UAAU,aAAa,CAAC;AAErC,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAErD;AAED,yFAAuF;AACvF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK9C;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAUnD;AAyBD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCjF;AAED,8EAA8E;AAC9E,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBjG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG;IAAE,IAAI,IAAI,IAAI,CAAA;CAAE,CA0BpE","sourcesContent":["/**\n * lunR: cron scheduler loop (Phase 1 of the cron/gateway roadmap).\n *\n * startScheduler() runs an unref'd, self-rescheduling setTimeout loop (default\n * 60s tick). Tick errors are caught — the loop never dies. Each tick collects\n * due jobs and runs them SEQUENTIALLY; recurring jobs are advanceNextRun()'d\n * BEFORE execution (at-most-once: a crash mid-run never double-fires).\n *\n * Per due job: build the prompt (cron-hint prefix + contextFrom upstream\n * outputs at an 8K cap each + job.prompt) → runJob → saveJobOutput →\n * [SILENT] check (whole response, or first/last line) → deliverResult.\n * Empty responses are soft failures; all failures attempt delivery of a\n * compact one-line error. Delivery errors land in job.lastDeliveryError.\n *\n * The scheduler knows nothing about delivery channels: runJob/deliverResult\n * are injected (the lunr-cron builtin extension wires the TUI + the\n * @lunr/cron-delivery bridge; the Phase 4 gateway replaces that bridge).\n */\n\nimport type { CronJob } from \"./jobs.ts\";\nimport {\n\tadvanceNextRun,\n\tCONTEXT_OUTPUT_CAP,\n\tgetDueJobs,\n\tgetJob,\n\tgetLatestJobOutput,\n\tmarkJobRun,\n\tsaveJobOutput,\n\tupdateJob,\n} from \"./jobs.ts\";\n\nexport interface SchedulerDeps {\n\t/** Run one job turn; resolves with the final assistant text. */\n\trunJob: (prompt: string, job: CronJob) => Promise<string>;\n\t/** Deliver a result (or failure notice) to the job's targets. Throws on failure. */\n\tdeliverResult: (job: CronJob, content: string) => Promise<void>;\n\t/** Tick interval; default 60s. */\n\tintervalMs?: number;\n\t/** Per-job wall-clock timeout; default 5 minutes. */\n\tjobTimeoutMs?: number;\n}\n\nexport const SILENT_TAG = \"[SILENT]\";\n\n/** Prefix telling the model it runs unattended and how to suppress delivery. */\nexport function cronPromptPrefix(job: CronJob): string {\n\treturn `You are running as a scheduled cron job '${job.name}'. Delivery of your final response is automatic; respond with ${SILENT_TAG} to suppress delivery.`;\n}\n\n/** Whole response, or the first/last line, is exactly [SILENT] → suppress delivery. */\nexport function isSilent(text: string): boolean {\n\tconst trimmed = text.trim();\n\tif (trimmed === SILENT_TAG) return true;\n\tconst lines = trimmed.split(\"\\n\");\n\treturn lines[0].trim() === SILENT_TAG || lines[lines.length - 1].trim() === SILENT_TAG;\n}\n\n/** cron-hint prefix + contextFrom upstream outputs (8K chars cap each) + job prompt. */\nexport function buildJobPrompt(job: CronJob): string {\n\tconst parts = [cronPromptPrefix(job)];\n\tfor (const upstreamId of job.contextFrom ?? []) {\n\t\tconst output = getLatestJobOutput(upstreamId);\n\t\tif (output) {\n\t\t\tparts.push(`Latest output from cron job '${upstreamId}':\\n${output.slice(0, CONTEXT_OUTPUT_CAP)}`);\n\t\t}\n\t}\n\tparts.push(job.prompt);\n\treturn parts.join(\"\\n\\n\");\n}\n\nfunction errorMessage(err: unknown): string {\n\treturn err instanceof Error ? err.message : String(err);\n}\n\nfunction oneLine(text: string): string {\n\treturn text.replace(/\\s+/g, \" \").trim().slice(0, 200);\n}\n\nasync function recordDeliveryError(jobId: string, error: string | null, previous: string | null): Promise<void> {\n\tif (error === null && previous === null) return; // avoid a pointless write\n\tawait updateJob(jobId, { lastDeliveryError: error });\n}\n\n/** Failures always attempt delivery of a compact one-line error. */\nasync function deliverFailure(job: CronJob, deps: SchedulerDeps, message: string): Promise<void> {\n\ttry {\n\t\tawait deps.deliverResult(job, `Cron job '${job.name}' failed: ${oneLine(message)}`);\n\t\tawait recordDeliveryError(job.id, null, job.lastDeliveryError);\n\t} catch (err) {\n\t\tawait recordDeliveryError(job.id, errorMessage(err), job.lastDeliveryError);\n\t}\n}\n\n/**\n * Execute one due job through the full pipeline. Never throws — run errors,\n * empty responses and delivery errors are recorded on the job.\n */\nexport async function executeJob(job: CronJob, deps: SchedulerDeps): Promise<void> {\n\tlet text: string;\n\ttry {\n\t\ttext = await deps.runJob(buildJobPrompt(job), job);\n\t} catch (err) {\n\t\tconst message = errorMessage(err);\n\t\tawait markJobRun(job.id, { status: \"error\", error: message });\n\t\tawait deliverFailure(job, deps, message);\n\t\treturn;\n\t}\n\n\tif (!text.trim()) {\n\t\t// Empty response = soft failure.\n\t\tawait markJobRun(job.id, { status: \"error\", error: \"empty response\" });\n\t\tawait deliverFailure(job, deps, \"empty response\");\n\t\treturn;\n\t}\n\n\tawait saveJobOutput(job.id, text);\n\tif (isSilent(text)) {\n\t\t// Output is saved; delivery is suppressed.\n\t\tawait markJobRun(job.id, { status: \"ok\" });\n\t\treturn;\n\t}\n\n\tlet deliveryError: string | null = null;\n\ttry {\n\t\tawait deps.deliverResult(job, text);\n\t} catch (err) {\n\t\tdeliveryError = errorMessage(err);\n\t}\n\tawait markJobRun(job.id, { status: \"ok\" });\n\tawait recordDeliveryError(job.id, deliveryError, job.lastDeliveryError);\n}\n\n/** One scheduler tick: run every due job sequentially. Exported for tests. */\nexport async function runSchedulerTick(deps: SchedulerDeps, now: Date = new Date()): Promise<void> {\n\tconst due = await getDueJobs(now);\n\tconst jobTimeoutMs = deps.jobTimeoutMs ?? 5 * 60 * 1000;\n\tfor (const dueJob of due) {\n\t\tif (dueJob.schedule.kind !== \"once\") await advanceNextRun(dueJob.id);\n\t\tconst job = getJob(dueJob.id);\n\t\tlet timedOut = false;\n\t\tconst executePromise = executeJob(job, deps);\n\t\tconst timeoutPromise = new Promise<never>((_, reject) => {\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\ttimedOut = true;\n\t\t\t\treject(new Error(`timed out after ${jobTimeoutMs}ms`));\n\t\t\t}, jobTimeoutMs);\n\t\t\t// If executeJob finishes, this promise is discarded; the timer must not keep the process alive.\n\t\t\ttimer.unref?.();\n\t\t});\n\t\ttry {\n\t\t\tawait Promise.race([executePromise, timeoutPromise]);\n\t\t} catch (err) {\n\t\t\tif (!timedOut) throw err;\n\t\t\tconst message = err instanceof Error ? err.message : String(err);\n\t\t\tawait markJobRun(job.id, { status: \"error\", error: message });\n\t\t\tawait deliverFailure(job, deps, message);\n\t\t}\n\t}\n}\n\n/**\n * Start the scheduler loop. Unref'd so it never keeps the process alive;\n * tick errors are swallowed so the loop never dies.\n */\nexport function startScheduler(deps: SchedulerDeps): { stop(): void } {\n\tconst intervalMs = deps.intervalMs ?? 60_000;\n\tlet stopped = false;\n\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\n\tconst loop = async (): Promise<void> => {\n\t\tif (stopped) return;\n\t\ttry {\n\t\t\tawait runSchedulerTick(deps);\n\t\t} catch {\n\t\t\t// never kill the loop\n\t\t}\n\t\tif (stopped) return;\n\t\ttimer = setTimeout(loop, intervalMs);\n\t\ttimer.unref?.();\n\t};\n\n\ttimer = setTimeout(loop, intervalMs);\n\ttimer.unref?.();\n\n\treturn {\n\t\tstop(): void {\n\t\t\tstopped = true;\n\t\t\tif (timer) clearTimeout(timer);\n\t\t},\n\t};\n}\n"]}

package/dist/core/cron/scheduler.js

@@ -0,0 +1,165 @@
+/**
+ * lunR: cron scheduler loop (Phase 1 of the cron/gateway roadmap).
+ *
+ * startScheduler() runs an unref'd, self-rescheduling setTimeout loop (default
+ * 60s tick). Tick errors are caught — the loop never dies. Each tick collects
+ * due jobs and runs them SEQUENTIALLY; recurring jobs are advanceNextRun()'d
+ * BEFORE execution (at-most-once: a crash mid-run never double-fires).
+ *
+ * Per due job: build the prompt (cron-hint prefix + contextFrom upstream
+ * outputs at an 8K cap each + job.prompt) → runJob → saveJobOutput →
+ * [SILENT] check (whole response, or first/last line) → deliverResult.
+ * Empty responses are soft failures; all failures attempt delivery of a
+ * compact one-line error. Delivery errors land in job.lastDeliveryError.
+ *
+ * The scheduler knows nothing about delivery channels: runJob/deliverResult
+ * are injected (the lunr-cron builtin extension wires the TUI + the
+ * @lunr/cron-delivery bridge; the Phase 4 gateway replaces that bridge).
+ */
+import { advanceNextRun, CONTEXT_OUTPUT_CAP, getDueJobs, getJob, getLatestJobOutput, markJobRun, saveJobOutput, updateJob, } from "./jobs.js";
+export const SILENT_TAG = "[SILENT]";
+/** Prefix telling the model it runs unattended and how to suppress delivery. */
+export function cronPromptPrefix(job) {
+    return `You are running as a scheduled cron job '${job.name}'. Delivery of your final response is automatic; respond with ${SILENT_TAG} to suppress delivery.`;
+}
+/** Whole response, or the first/last line, is exactly [SILENT] → suppress delivery. */
+export function isSilent(text) {
+    const trimmed = text.trim();
+    if (trimmed === SILENT_TAG)
+        return true;
+    const lines = trimmed.split("\n");
+    return lines[0].trim() === SILENT_TAG || lines[lines.length - 1].trim() === SILENT_TAG;
+}
+/** cron-hint prefix + contextFrom upstream outputs (8K chars cap each) + job prompt. */
+export function buildJobPrompt(job) {
+    const parts = [cronPromptPrefix(job)];
+    for (const upstreamId of job.contextFrom ?? []) {
+        const output = getLatestJobOutput(upstreamId);
+        if (output) {
+            parts.push(`Latest output from cron job '${upstreamId}':\n${output.slice(0, CONTEXT_OUTPUT_CAP)}`);
+        }
+    }
+    parts.push(job.prompt);
+    return parts.join("\n\n");
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function oneLine(text) {
+    return text.replace(/\s+/g, " ").trim().slice(0, 200);
+}
+async function recordDeliveryError(jobId, error, previous) {
+    if (error === null && previous === null)
+        return; // avoid a pointless write
+    await updateJob(jobId, { lastDeliveryError: error });
+}
+/** Failures always attempt delivery of a compact one-line error. */
+async function deliverFailure(job, deps, message) {
+    try {
+        await deps.deliverResult(job, `Cron job '${job.name}' failed: ${oneLine(message)}`);
+        await recordDeliveryError(job.id, null, job.lastDeliveryError);
+    }
+    catch (err) {
+        await recordDeliveryError(job.id, errorMessage(err), job.lastDeliveryError);
+    }
+}
+/**
+ * Execute one due job through the full pipeline. Never throws — run errors,
+ * empty responses and delivery errors are recorded on the job.
+ */
+export async function executeJob(job, deps) {
+    let text;
+    try {
+        text = await deps.runJob(buildJobPrompt(job), job);
+    }
+    catch (err) {
+        const message = errorMessage(err);
+        await markJobRun(job.id, { status: "error", error: message });
+        await deliverFailure(job, deps, message);
+        return;
+    }
+    if (!text.trim()) {
+        // Empty response = soft failure.
+        await markJobRun(job.id, { status: "error", error: "empty response" });
+        await deliverFailure(job, deps, "empty response");
+        return;
+    }
+    await saveJobOutput(job.id, text);
+    if (isSilent(text)) {
+        // Output is saved; delivery is suppressed.
+        await markJobRun(job.id, { status: "ok" });
+        return;
+    }
+    let deliveryError = null;
+    try {
+        await deps.deliverResult(job, text);
+    }
+    catch (err) {
+        deliveryError = errorMessage(err);
+    }
+    await markJobRun(job.id, { status: "ok" });
+    await recordDeliveryError(job.id, deliveryError, job.lastDeliveryError);
+}
+/** One scheduler tick: run every due job sequentially. Exported for tests. */
+export async function runSchedulerTick(deps, now = new Date()) {
+    const due = await getDueJobs(now);
+    const jobTimeoutMs = deps.jobTimeoutMs ?? 5 * 60 * 1000;
+    for (const dueJob of due) {
+        if (dueJob.schedule.kind !== "once")
+            await advanceNextRun(dueJob.id);
+        const job = getJob(dueJob.id);
+        let timedOut = false;
+        const executePromise = executeJob(job, deps);
+        const timeoutPromise = new Promise((_, reject) => {
+            const timer = setTimeout(() => {
+                timedOut = true;
+                reject(new Error(`timed out after ${jobTimeoutMs}ms`));
+            }, jobTimeoutMs);
+            // If executeJob finishes, this promise is discarded; the timer must not keep the process alive.
+            timer.unref?.();
+        });
+        try {
+            await Promise.race([executePromise, timeoutPromise]);
+        }
+        catch (err) {
+            if (!timedOut)
+                throw err;
+            const message = err instanceof Error ? err.message : String(err);
+            await markJobRun(job.id, { status: "error", error: message });
+            await deliverFailure(job, deps, message);
+        }
+    }
+}
+/**
+ * Start the scheduler loop. Unref'd so it never keeps the process alive;
+ * tick errors are swallowed so the loop never dies.
+ */
+export function startScheduler(deps) {
+    const intervalMs = deps.intervalMs ?? 60_000;
+    let stopped = false;
+    let timer;
+    const loop = async () => {
+        if (stopped)
+            return;
+        try {
+            await runSchedulerTick(deps);
+        }
+        catch {
+            // never kill the loop
+        }
+        if (stopped)
+            return;
+        timer = setTimeout(loop, intervalMs);
+        timer.unref?.();
+    };
+    timer = setTimeout(loop, intervalMs);
+    timer.unref?.();
+    return {
+        stop() {
+            stopped = true;
+            if (timer)
+                clearTimeout(timer);
+        },
+    };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/core/cron/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../../src/core/cron/scheduler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * lunR: cron scheduler loop (Phase 1 of the cron/gateway roadmap).\n *\n * startScheduler() runs an unref'd, self-rescheduling setTimeout loop (default\n * 60s tick). Tick errors are caught — the loop never dies. Each tick collects\n * due jobs and runs them SEQUENTIALLY; recurring jobs are advanceNextRun()'d\n * BEFORE execution (at-most-once: a crash mid-run never double-fires).\n *\n * Per due job: build the prompt (cron-hint prefix + contextFrom upstream\n * outputs at an 8K cap each + job.prompt) → runJob → saveJobOutput →\n * [SILENT] check (whole response, or first/last line) → deliverResult.\n * Empty responses are soft failures; all failures attempt delivery of a\n * compact one-line error. Delivery errors land in job.lastDeliveryError.\n *\n * The scheduler knows nothing about delivery channels: runJob/deliverResult\n * are injected (the lunr-cron builtin extension wires the TUI + the\n * @lunr/cron-delivery bridge; the Phase 4 gateway replaces that bridge).\n */\n\nimport type { CronJob } from \"./jobs.ts\";\nimport {\n\tadvanceNextRun,\n\tCONTEXT_OUTPUT_CAP,\n\tgetDueJobs,\n\tgetJob,\n\tgetLatestJobOutput,\n\tmarkJobRun,\n\tsaveJobOutput,\n\tupdateJob,\n} from \"./jobs.ts\";\n\nexport interface SchedulerDeps {\n\t/** Run one job turn; resolves with the final assistant text. */\n\trunJob: (prompt: string, job: CronJob) => Promise<string>;\n\t/** Deliver a result (or failure notice) to the job's targets. Throws on failure. */\n\tdeliverResult: (job: CronJob, content: string) => Promise<void>;\n\t/** Tick interval; default 60s. */\n\tintervalMs?: number;\n\t/** Per-job wall-clock timeout; default 5 minutes. */\n\tjobTimeoutMs?: number;\n}\n\nexport const SILENT_TAG = \"[SILENT]\";\n\n/** Prefix telling the model it runs unattended and how to suppress delivery. */\nexport function cronPromptPrefix(job: CronJob): string {\n\treturn `You are running as a scheduled cron job '${job.name}'. Delivery of your final response is automatic; respond with ${SILENT_TAG} to suppress delivery.`;\n}\n\n/** Whole response, or the first/last line, is exactly [SILENT] → suppress delivery. */\nexport function isSilent(text: string): boolean {\n\tconst trimmed = text.trim();\n\tif (trimmed === SILENT_TAG) return true;\n\tconst lines = trimmed.split(\"\\n\");\n\treturn lines[0].trim() === SILENT_TAG || lines[lines.length - 1].trim() === SILENT_TAG;\n}\n\n/** cron-hint prefix + contextFrom upstream outputs (8K chars cap each) + job prompt. */\nexport function buildJobPrompt(job: CronJob): string {\n\tconst parts = [cronPromptPrefix(job)];\n\tfor (const upstreamId of job.contextFrom ?? []) {\n\t\tconst output = getLatestJobOutput(upstreamId);\n\t\tif (output) {\n\t\t\tparts.push(`Latest output from cron job '${upstreamId}':\\n${output.slice(0, CONTEXT_OUTPUT_CAP)}`);\n\t\t}\n\t}\n\tparts.push(job.prompt);\n\treturn parts.join(\"\\n\\n\");\n}\n\nfunction errorMessage(err: unknown): string {\n\treturn err instanceof Error ? err.message : String(err);\n}\n\nfunction oneLine(text: string): string {\n\treturn text.replace(/\\s+/g, \" \").trim().slice(0, 200);\n}\n\nasync function recordDeliveryError(jobId: string, error: string | null, previous: string | null): Promise<void> {\n\tif (error === null && previous === null) return; // avoid a pointless write\n\tawait updateJob(jobId, { lastDeliveryError: error });\n}\n\n/** Failures always attempt delivery of a compact one-line error. */\nasync function deliverFailure(job: CronJob, deps: SchedulerDeps, message: string): Promise<void> {\n\ttry {\n\t\tawait deps.deliverResult(job, `Cron job '${job.name}' failed: ${oneLine(message)}`);\n\t\tawait recordDeliveryError(job.id, null, job.lastDeliveryError);\n\t} catch (err) {\n\t\tawait recordDeliveryError(job.id, errorMessage(err), job.lastDeliveryError);\n\t}\n}\n\n/**\n * Execute one due job through the full pipeline. Never throws — run errors,\n * empty responses and delivery errors are recorded on the job.\n */\nexport async function executeJob(job: CronJob, deps: SchedulerDeps): Promise<void> {\n\tlet text: string;\n\ttry {\n\t\ttext = await deps.runJob(buildJobPrompt(job), job);\n\t} catch (err) {\n\t\tconst message = errorMessage(err);\n\t\tawait markJobRun(job.id, { status: \"error\", error: message });\n\t\tawait deliverFailure(job, deps, message);\n\t\treturn;\n\t}\n\n\tif (!text.trim()) {\n\t\t// Empty response = soft failure.\n\t\tawait markJobRun(job.id, { status: \"error\", error: \"empty response\" });\n\t\tawait deliverFailure(job, deps, \"empty response\");\n\t\treturn;\n\t}\n\n\tawait saveJobOutput(job.id, text);\n\tif (isSilent(text)) {\n\t\t// Output is saved; delivery is suppressed.\n\t\tawait markJobRun(job.id, { status: \"ok\" });\n\t\treturn;\n\t}\n\n\tlet deliveryError: string | null = null;\n\ttry {\n\t\tawait deps.deliverResult(job, text);\n\t} catch (err) {\n\t\tdeliveryError = errorMessage(err);\n\t}\n\tawait markJobRun(job.id, { status: \"ok\" });\n\tawait recordDeliveryError(job.id, deliveryError, job.lastDeliveryError);\n}\n\n/** One scheduler tick: run every due job sequentially. Exported for tests. */\nexport async function runSchedulerTick(deps: SchedulerDeps, now: Date = new Date()): Promise<void> {\n\tconst due = await getDueJobs(now);\n\tconst jobTimeoutMs = deps.jobTimeoutMs ?? 5 * 60 * 1000;\n\tfor (const dueJob of due) {\n\t\tif (dueJob.schedule.kind !== \"once\") await advanceNextRun(dueJob.id);\n\t\tconst job = getJob(dueJob.id);\n\t\tlet timedOut = false;\n\t\tconst executePromise = executeJob(job, deps);\n\t\tconst timeoutPromise = new Promise<never>((_, reject) => {\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\ttimedOut = true;\n\t\t\t\treject(new Error(`timed out after ${jobTimeoutMs}ms`));\n\t\t\t}, jobTimeoutMs);\n\t\t\t// If executeJob finishes, this promise is discarded; the timer must not keep the process alive.\n\t\t\ttimer.unref?.();\n\t\t});\n\t\ttry {\n\t\t\tawait Promise.race([executePromise, timeoutPromise]);\n\t\t} catch (err) {\n\t\t\tif (!timedOut) throw err;\n\t\t\tconst message = err instanceof Error ? err.message : String(err);\n\t\t\tawait markJobRun(job.id, { status: \"error\", error: message });\n\t\t\tawait deliverFailure(job, deps, message);\n\t\t}\n\t}\n}\n\n/**\n * Start the scheduler loop. Unref'd so it never keeps the process alive;\n * tick errors are swallowed so the loop never dies.\n */\nexport function startScheduler(deps: SchedulerDeps): { stop(): void } {\n\tconst intervalMs = deps.intervalMs ?? 60_000;\n\tlet stopped = false;\n\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\n\tconst loop = async (): Promise<void> => {\n\t\tif (stopped) return;\n\t\ttry {\n\t\t\tawait runSchedulerTick(deps);\n\t\t} catch {\n\t\t\t// never kill the loop\n\t\t}\n\t\tif (stopped) return;\n\t\ttimer = setTimeout(loop, intervalMs);\n\t\ttimer.unref?.();\n\t};\n\n\ttimer = setTimeout(loop, intervalMs);\n\ttimer.unref?.();\n\n\treturn {\n\t\tstop(): void {\n\t\t\tstopped = true;\n\t\t\tif (timer) clearTimeout(timer);\n\t\t},\n\t};\n}\n"]}

package/dist/core/customize.d.ts

@@ -0,0 +1,31 @@
+import type { SettingsManager } from "./settings-manager.ts";
+/**
+ * lunR TUI customize bridge.
+ *
+ * Exposed on `globalThis` under `Symbol.for("@lunr/customize")` so the baked-in
+ * ashxj-tui extension can read the customize settings (gutter rail, prompt
+ * symbol, footer element toggles) without importing core code — same pattern as
+ * the model-tiers and memory-cap bridges.
+ */
+export declare const CUSTOMIZE_BRIDGE_SYMBOL: unique symbol;
+export interface CustomizeBridge {
+    getGutterRail(): boolean;
+    getPromptSymbol(): boolean;
+    getFooterMcp(): boolean;
+    getFooterLsp(): boolean;
+    getFooterContext(): boolean;
+    getFooterTokens(): boolean;
+    getFooterStatuses(): boolean;
+    getHideThinkingBlock(): boolean;
+    setHideThinkingBlock(hide: boolean): void;
+}
+/**
+ * Register (or re-point) the global customize bridge.
+ * Safe to call multiple times — later calls only swap the settings source, so an
+ * early startup registration (before extensions load) can be replaced by the live
+ * runtime settings manager.
+ */
+export declare function registerCustomizeBridge(settingsManager: SettingsManager): void;
+/** Read the bridge from `globalThis`, or undefined when not registered (extension-safe). */
+export declare function getCustomizeBridge(): CustomizeBridge | undefined;
+//# sourceMappingURL=customize.d.ts.map

package/dist/core/customize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customize.d.ts","sourceRoot":"","sources":["../../src/core/customize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;GAOG;AAEH,eAAO,MAAM,uBAAuB,eAAgC,CAAC;AAErE,MAAM,WAAW,eAAe;IAC/B,aAAa,IAAI,OAAO,CAAC;IACzB,eAAe,IAAI,OAAO,CAAC;IAC3B,YAAY,IAAI,OAAO,CAAC;IACxB,YAAY,IAAI,OAAO,CAAC;IACxB,gBAAgB,IAAI,OAAO,CAAC;IAC5B,eAAe,IAAI,OAAO,CAAC;IAC3B,iBAAiB,IAAI,OAAO,CAAC;IAC7B,oBAAoB,IAAI,OAAO,CAAC;IAChC,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1C;AAkCD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI,CAG9E;AAED,4FAA4F;AAC5F,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,SAAS,CAEhE","sourcesContent":["import type { SettingsManager } from \"./settings-manager.ts\";\n\n/**\n * lunR TUI customize bridge.\n *\n * Exposed on `globalThis` under `Symbol.for(\"@lunr/customize\")` so the baked-in\n * ashxj-tui extension can read the customize settings (gutter rail, prompt\n * symbol, footer element toggles) without importing core code — same pattern as\n * the model-tiers and memory-cap bridges.\n */\n\nexport const CUSTOMIZE_BRIDGE_SYMBOL = Symbol.for(\"@lunr/customize\");\n\nexport interface CustomizeBridge {\n\tgetGutterRail(): boolean;\n\tgetPromptSymbol(): boolean;\n\tgetFooterMcp(): boolean;\n\tgetFooterLsp(): boolean;\n\tgetFooterContext(): boolean;\n\tgetFooterTokens(): boolean;\n\tgetFooterStatuses(): boolean;\n\tgetHideThinkingBlock(): boolean;\n\tsetHideThinkingBlock(hide: boolean): void;\n}\n\nlet activeSettingsManager: SettingsManager | undefined;\n\nconst bridge: CustomizeBridge = {\n\tgetGutterRail(): boolean {\n\t\treturn activeSettingsManager?.getGutterRail() ?? true;\n\t},\n\tgetPromptSymbol(): boolean {\n\t\treturn activeSettingsManager?.getPromptSymbol() ?? true;\n\t},\n\tgetFooterMcp(): boolean {\n\t\treturn activeSettingsManager?.getFooterMcp() ?? true;\n\t},\n\tgetFooterLsp(): boolean {\n\t\treturn activeSettingsManager?.getFooterLsp() ?? false;\n\t},\n\tgetFooterContext(): boolean {\n\t\treturn activeSettingsManager?.getFooterContext() ?? true;\n\t},\n\tgetFooterTokens(): boolean {\n\t\treturn activeSettingsManager?.getFooterTokens() ?? true;\n\t},\n\tgetFooterStatuses(): boolean {\n\t\treturn activeSettingsManager?.getFooterStatuses() ?? true;\n\t},\n\tgetHideThinkingBlock(): boolean {\n\t\treturn activeSettingsManager?.getHideThinkingBlock() ?? false;\n\t},\n\tsetHideThinkingBlock(hide: boolean): void {\n\t\tactiveSettingsManager?.setHideThinkingBlock(hide);\n\t},\n};\n\n/**\n * Register (or re-point) the global customize bridge.\n * Safe to call multiple times — later calls only swap the settings source, so an\n * early startup registration (before extensions load) can be replaced by the live\n * runtime settings manager.\n */\nexport function registerCustomizeBridge(settingsManager: SettingsManager): void {\n\tactiveSettingsManager = settingsManager;\n\t(globalThis as Record<symbol, unknown>)[CUSTOMIZE_BRIDGE_SYMBOL] = bridge;\n}\n\n/** Read the bridge from `globalThis`, or undefined when not registered (extension-safe). */\nexport function getCustomizeBridge(): CustomizeBridge | undefined {\n\treturn (globalThis as Record<symbol, unknown>)[CUSTOMIZE_BRIDGE_SYMBOL] as CustomizeBridge | undefined;\n}\n"]}

package/dist/core/customize.js

@@ -0,0 +1,54 @@
+/**
+ * lunR TUI customize bridge.
+ *
+ * Exposed on `globalThis` under `Symbol.for("@lunr/customize")` so the baked-in
+ * ashxj-tui extension can read the customize settings (gutter rail, prompt
+ * symbol, footer element toggles) without importing core code — same pattern as
+ * the model-tiers and memory-cap bridges.
+ */
+export const CUSTOMIZE_BRIDGE_SYMBOL = Symbol.for("@lunr/customize");
+let activeSettingsManager;
+const bridge = {
+    getGutterRail() {
+        return activeSettingsManager?.getGutterRail() ?? true;
+    },
+    getPromptSymbol() {
+        return activeSettingsManager?.getPromptSymbol() ?? true;
+    },
+    getFooterMcp() {
+        return activeSettingsManager?.getFooterMcp() ?? true;
+    },
+    getFooterLsp() {
+        return activeSettingsManager?.getFooterLsp() ?? false;
+    },
+    getFooterContext() {
+        return activeSettingsManager?.getFooterContext() ?? true;
+    },
+    getFooterTokens() {
+        return activeSettingsManager?.getFooterTokens() ?? true;
+    },
+    getFooterStatuses() {
+        return activeSettingsManager?.getFooterStatuses() ?? true;
+    },
+    getHideThinkingBlock() {
+        return activeSettingsManager?.getHideThinkingBlock() ?? false;
+    },
+    setHideThinkingBlock(hide) {
+        activeSettingsManager?.setHideThinkingBlock(hide);
+    },
+};
+/**
+ * Register (or re-point) the global customize bridge.
+ * Safe to call multiple times — later calls only swap the settings source, so an
+ * early startup registration (before extensions load) can be replaced by the live
+ * runtime settings manager.
+ */
+export function registerCustomizeBridge(settingsManager) {
+    activeSettingsManager = settingsManager;
+    globalThis[CUSTOMIZE_BRIDGE_SYMBOL] = bridge;
+}
+/** Read the bridge from `globalThis`, or undefined when not registered (extension-safe). */
+export function getCustomizeBridge() {
+    return globalThis[CUSTOMIZE_BRIDGE_SYMBOL];
+}
+//# sourceMappingURL=customize.js.map

package/dist/core/customize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customize.js","sourceRoot":"","sources":["../../src/core/customize.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAcrE,IAAI,qBAAkD,CAAC;AAEvD,MAAM,MAAM,GAAoB;IAC/B,aAAa,GAAY;QACxB,OAAO,qBAAqB,EAAE,aAAa,EAAE,IAAI,IAAI,CAAC;IAAA,CACtD;IACD,eAAe,GAAY;QAC1B,OAAO,qBAAqB,EAAE,eAAe,EAAE,IAAI,IAAI,CAAC;IAAA,CACxD;IACD,YAAY,GAAY;QACvB,OAAO,qBAAqB,EAAE,YAAY,EAAE,IAAI,IAAI,CAAC;IAAA,CACrD;IACD,YAAY,GAAY;QACvB,OAAO,qBAAqB,EAAE,YAAY,EAAE,IAAI,KAAK,CAAC;IAAA,CACtD;IACD,gBAAgB,GAAY;QAC3B,OAAO,qBAAqB,EAAE,gBAAgB,EAAE,IAAI,IAAI,CAAC;IAAA,CACzD;IACD,eAAe,GAAY;QAC1B,OAAO,qBAAqB,EAAE,eAAe,EAAE,IAAI,IAAI,CAAC;IAAA,CACxD;IACD,iBAAiB,GAAY;QAC5B,OAAO,qBAAqB,EAAE,iBAAiB,EAAE,IAAI,IAAI,CAAC;IAAA,CAC1D;IACD,oBAAoB,GAAY;QAC/B,OAAO,qBAAqB,EAAE,oBAAoB,EAAE,IAAI,KAAK,CAAC;IAAA,CAC9D;IACD,oBAAoB,CAAC,IAAa,EAAQ;QACzC,qBAAqB,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAAA,CAClD;CACD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,eAAgC,EAAQ;IAC/E,qBAAqB,GAAG,eAAe,CAAC;IACvC,UAAsC,CAAC,uBAAuB,CAAC,GAAG,MAAM,CAAC;AAAA,CAC1E;AAED,4FAA4F;AAC5F,MAAM,UAAU,kBAAkB,GAAgC;IACjE,OAAQ,UAAsC,CAAC,uBAAuB,CAAgC,CAAC;AAAA,CACvG","sourcesContent":["import type { SettingsManager } from \"./settings-manager.ts\";\n\n/**\n * lunR TUI customize bridge.\n *\n * Exposed on `globalThis` under `Symbol.for(\"@lunr/customize\")` so the baked-in\n * ashxj-tui extension can read the customize settings (gutter rail, prompt\n * symbol, footer element toggles) without importing core code — same pattern as\n * the model-tiers and memory-cap bridges.\n */\n\nexport const CUSTOMIZE_BRIDGE_SYMBOL = Symbol.for(\"@lunr/customize\");\n\nexport interface CustomizeBridge {\n\tgetGutterRail(): boolean;\n\tgetPromptSymbol(): boolean;\n\tgetFooterMcp(): boolean;\n\tgetFooterLsp(): boolean;\n\tgetFooterContext(): boolean;\n\tgetFooterTokens(): boolean;\n\tgetFooterStatuses(): boolean;\n\tgetHideThinkingBlock(): boolean;\n\tsetHideThinkingBlock(hide: boolean): void;\n}\n\nlet activeSettingsManager: SettingsManager | undefined;\n\nconst bridge: CustomizeBridge = {\n\tgetGutterRail(): boolean {\n\t\treturn activeSettingsManager?.getGutterRail() ?? true;\n\t},\n\tgetPromptSymbol(): boolean {\n\t\treturn activeSettingsManager?.getPromptSymbol() ?? true;\n\t},\n\tgetFooterMcp(): boolean {\n\t\treturn activeSettingsManager?.getFooterMcp() ?? true;\n\t},\n\tgetFooterLsp(): boolean {\n\t\treturn activeSettingsManager?.getFooterLsp() ?? false;\n\t},\n\tgetFooterContext(): boolean {\n\t\treturn activeSettingsManager?.getFooterContext() ?? true;\n\t},\n\tgetFooterTokens(): boolean {\n\t\treturn activeSettingsManager?.getFooterTokens() ?? true;\n\t},\n\tgetFooterStatuses(): boolean {\n\t\treturn activeSettingsManager?.getFooterStatuses() ?? true;\n\t},\n\tgetHideThinkingBlock(): boolean {\n\t\treturn activeSettingsManager?.getHideThinkingBlock() ?? false;\n\t},\n\tsetHideThinkingBlock(hide: boolean): void {\n\t\tactiveSettingsManager?.setHideThinkingBlock(hide);\n\t},\n};\n\n/**\n * Register (or re-point) the global customize bridge.\n * Safe to call multiple times — later calls only swap the settings source, so an\n * early startup registration (before extensions load) can be replaced by the live\n * runtime settings manager.\n */\nexport function registerCustomizeBridge(settingsManager: SettingsManager): void {\n\tactiveSettingsManager = settingsManager;\n\t(globalThis as Record<symbol, unknown>)[CUSTOMIZE_BRIDGE_SYMBOL] = bridge;\n}\n\n/** Read the bridge from `globalThis`, or undefined when not registered (extension-safe). */\nexport function getCustomizeBridge(): CustomizeBridge | undefined {\n\treturn (globalThis as Record<symbol, unknown>)[CUSTOMIZE_BRIDGE_SYMBOL] as CustomizeBridge | undefined;\n}\n"]}

package/dist/core/defaults.d.ts

@@ -0,0 +1,3 @@
+import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
+export declare const DEFAULT_THINKING_LEVEL: ThinkingLevel;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/core/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,eAAO,MAAM,sBAAsB,EAAE,aAAwB,CAAC","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\n\nexport const DEFAULT_THINKING_LEVEL: ThinkingLevel = \"medium\";\n"]}

package/dist/core/defaults.js

@@ -0,0 +1,2 @@
+export const DEFAULT_THINKING_LEVEL = "medium";
+//# sourceMappingURL=defaults.js.map

package/dist/core/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAkB,QAAQ,CAAC","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\n\nexport const DEFAULT_THINKING_LEVEL: ThinkingLevel = \"medium\";\n"]}

package/dist/core/diagnostics.d.ts

@@ -0,0 +1,15 @@
+export interface ResourceCollision {
+    resourceType: "extension" | "skill" | "prompt" | "theme";
+    name: string;
+    winnerPath: string;
+    loserPath: string;
+    winnerSource?: string;
+    loserSource?: string;
+}
+export interface ResourceDiagnostic {
+    type: "warning" | "error" | "collision";
+    message: string;
+    path?: string;
+    collision?: ResourceCollision;
+}
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/core/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IACjC,YAAY,EAAE,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC9B","sourcesContent":["export interface ResourceCollision {\n\tresourceType: \"extension\" | \"skill\" | \"prompt\" | \"theme\";\n\tname: string; // skill name, command/tool/flag name, prompt name, theme name\n\twinnerPath: string;\n\tloserPath: string;\n\twinnerSource?: string; // e.g., \"npm:foo\", \"git:...\", \"local\"\n\tloserSource?: string;\n}\n\nexport interface ResourceDiagnostic {\n\ttype: \"warning\" | \"error\" | \"collision\";\n\tmessage: string;\n\tpath?: string;\n\tcollision?: ResourceCollision;\n}\n"]}

package/dist/core/diagnostics.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diagnostics.js.map

package/dist/core/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":"","sourcesContent":["export interface ResourceCollision {\n\tresourceType: \"extension\" | \"skill\" | \"prompt\" | \"theme\";\n\tname: string; // skill name, command/tool/flag name, prompt name, theme name\n\twinnerPath: string;\n\tloserPath: string;\n\twinnerSource?: string; // e.g., \"npm:foo\", \"git:...\", \"local\"\n\tloserSource?: string;\n}\n\nexport interface ResourceDiagnostic {\n\ttype: \"warning\" | \"error\" | \"collision\";\n\tmessage: string;\n\tpath?: string;\n\tcollision?: ResourceCollision;\n}\n"]}

package/dist/core/event-bus.d.ts

@@ -0,0 +1,9 @@
+export interface EventBus {
+    emit(channel: string, data: unknown): void;
+    on(channel: string, handler: (data: unknown) => void): () => void;
+}
+export interface EventBusController extends EventBus {
+    clear(): void;
+}
+export declare function createEventBus(): EventBusController;
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/core/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACxB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IACnD,KAAK,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,cAAc,IAAI,kBAAkB,CAqBnD","sourcesContent":["import { EventEmitter } from \"node:events\";\n\nexport interface EventBus {\n\temit(channel: string, data: unknown): void;\n\ton(channel: string, handler: (data: unknown) => void): () => void;\n}\n\nexport interface EventBusController extends EventBus {\n\tclear(): void;\n}\n\nexport function createEventBus(): EventBusController {\n\tconst emitter = new EventEmitter();\n\treturn {\n\t\temit: (channel, data) => {\n\t\t\temitter.emit(channel, data);\n\t\t},\n\t\ton: (channel, handler) => {\n\t\t\tconst safeHandler = async (data: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tawait handler(data);\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconsole.error(`Event handler error (${channel}):`, err);\n\t\t\t\t}\n\t\t\t};\n\t\t\temitter.on(channel, safeHandler);\n\t\t\treturn () => emitter.off(channel, safeHandler);\n\t\t},\n\t\tclear: () => {\n\t\t\temitter.removeAllListeners();\n\t\t},\n\t};\n}\n"]}

package/dist/core/event-bus.js

@@ -0,0 +1,25 @@
+import { EventEmitter } from "node:events";
+export function createEventBus() {
+    const emitter = new EventEmitter();
+    return {
+        emit: (channel, data) => {
+            emitter.emit(channel, data);
+        },
+        on: (channel, handler) => {
+            const safeHandler = async (data) => {
+                try {
+                    await handler(data);
+                }
+                catch (err) {
+                    console.error(`Event handler error (${channel}):`, err);
+                }
+            };
+            emitter.on(channel, safeHandler);
+            return () => emitter.off(channel, safeHandler);
+        },
+        clear: () => {
+            emitter.removeAllListeners();
+        },
+    };
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/core/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C,MAAM,UAAU,cAAc,GAAuB;IACpD,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IACnC,OAAO;QACN,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAAA,CAC5B;QACD,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,KAAK,EAAE,IAAa,EAAE,EAAE,CAAC;gBAC5C,IAAI,CAAC;oBACJ,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACd,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,IAAI,EAAE,GAAG,CAAC,CAAC;gBACzD,CAAC;YAAA,CACD,CAAC;YACF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACjC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAAA,CAC/C;QACD,KAAK,EAAE,GAAG,EAAE,CAAC;YACZ,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAAA,CAC7B;KACD,CAAC;AAAA,CACF","sourcesContent":["import { EventEmitter } from \"node:events\";\n\nexport interface EventBus {\n\temit(channel: string, data: unknown): void;\n\ton(channel: string, handler: (data: unknown) => void): () => void;\n}\n\nexport interface EventBusController extends EventBus {\n\tclear(): void;\n}\n\nexport function createEventBus(): EventBusController {\n\tconst emitter = new EventEmitter();\n\treturn {\n\t\temit: (channel, data) => {\n\t\t\temitter.emit(channel, data);\n\t\t},\n\t\ton: (channel, handler) => {\n\t\t\tconst safeHandler = async (data: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tawait handler(data);\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconsole.error(`Event handler error (${channel}):`, err);\n\t\t\t\t}\n\t\t\t};\n\t\t\temitter.on(channel, safeHandler);\n\t\t\treturn () => emitter.off(channel, safeHandler);\n\t\t},\n\t\tclear: () => {\n\t\t\temitter.removeAllListeners();\n\t\t},\n\t};\n}\n"]}

package/dist/core/exec.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared command execution utilities for extensions and custom tools.
+ */
+/**
+ * Options for executing shell commands.
+ */
+export interface ExecOptions {
+    /** AbortSignal to cancel the command */
+    signal?: AbortSignal;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Working directory */
+    cwd?: string;
+}
+/**
+ * Result of executing a shell command.
+ */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+    killed: boolean;
+}
+/**
+ * Execute a shell command and return stdout/stderr/code.
+ * Supports timeout and abort signal.
+ */
+export declare function execCommand(command: string, args: string[], cwd: string, options?: ExecOptions): Promise<ExecResult>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/core/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/core/exec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,wCAAwC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoErB","sourcesContent":["/**\n * Shared command execution utilities for extensions and custom tools.\n */\n\nimport { spawn } from \"node:child_process\";\nimport { waitForChildProcess } from \"../utils/child-process.ts\";\n\n/**\n * Options for executing shell commands.\n */\nexport interface ExecOptions {\n\t/** AbortSignal to cancel the command */\n\tsignal?: AbortSignal;\n\t/** Timeout in milliseconds */\n\ttimeout?: number;\n\t/** Working directory */\n\tcwd?: string;\n}\n\n/**\n * Result of executing a shell command.\n */\nexport interface ExecResult {\n\tstdout: string;\n\tstderr: string;\n\tcode: number;\n\tkilled: boolean;\n}\n\n/**\n * Execute a shell command and return stdout/stderr/code.\n * Supports timeout and abort signal.\n */\nexport async function execCommand(\n\tcommand: string,\n\targs: string[],\n\tcwd: string,\n\toptions?: ExecOptions,\n): Promise<ExecResult> {\n\treturn new Promise((resolve) => {\n\t\tconst proc = spawn(command, args, {\n\t\t\tcwd,\n\t\t\tshell: false,\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t});\n\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tlet killed = false;\n\t\tlet timeoutId: NodeJS.Timeout | undefined;\n\n\t\tconst killProcess = () => {\n\t\t\tif (!killed) {\n\t\t\t\tkilled = true;\n\t\t\t\tproc.kill(\"SIGTERM\");\n\t\t\t\t// Force kill after 5 seconds if SIGTERM doesn't work\n\t\t\t\tsetTimeout(() => {\n\t\t\t\t\tif (!proc.killed) {\n\t\t\t\t\t\tproc.kill(\"SIGKILL\");\n\t\t\t\t\t}\n\t\t\t\t}, 5000);\n\t\t\t}\n\t\t};\n\n\t\t// Handle abort signal\n\t\tif (options?.signal) {\n\t\t\tif (options.signal.aborted) {\n\t\t\t\tkillProcess();\n\t\t\t} else {\n\t\t\t\toptions.signal.addEventListener(\"abort\", killProcess, { once: true });\n\t\t\t}\n\t\t}\n\n\t\t// Handle timeout\n\t\tif (options?.timeout && options.timeout > 0) {\n\t\t\ttimeoutId = setTimeout(() => {\n\t\t\t\tkillProcess();\n\t\t\t}, options.timeout);\n\t\t}\n\n\t\tproc.stdout?.on(\"data\", (data) => {\n\t\t\tstdout += data.toString();\n\t\t});\n\n\t\tproc.stderr?.on(\"data\", (data) => {\n\t\t\tstderr += data.toString();\n\t\t});\n\n\t\t// Wait for process termination without hanging on inherited stdio handles\n\t\t// held open by detached descendants.\n\t\twaitForChildProcess(proc)\n\t\t\t.then((code) => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\tif (options?.signal) {\n\t\t\t\t\toptions.signal.removeEventListener(\"abort\", killProcess);\n\t\t\t\t}\n\t\t\t\tresolve({ stdout, stderr, code: code ?? 0, killed });\n\t\t\t})\n\t\t\t.catch((_err) => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\tif (options?.signal) {\n\t\t\t\t\toptions.signal.removeEventListener(\"abort\", killProcess);\n\t\t\t\t}\n\t\t\t\tresolve({ stdout, stderr, code: 1, killed });\n\t\t\t});\n\t});\n}\n"]}

package/dist/core/exec.js

@@ -0,0 +1,75 @@
+/**
+ * Shared command execution utilities for extensions and custom tools.
+ */
+import { spawn } from "node:child_process";
+import { waitForChildProcess } from "../utils/child-process.js";
+/**
+ * Execute a shell command and return stdout/stderr/code.
+ * Supports timeout and abort signal.
+ */
+export async function execCommand(command, args, cwd, options) {
+    return new Promise((resolve) => {
+        const proc = spawn(command, args, {
+            cwd,
+            shell: false,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        let killed = false;
+        let timeoutId;
+        const killProcess = () => {
+            if (!killed) {
+                killed = true;
+                proc.kill("SIGTERM");
+                // Force kill after 5 seconds if SIGTERM doesn't work
+                setTimeout(() => {
+                    if (!proc.killed) {
+                        proc.kill("SIGKILL");
+                    }
+                }, 5000);
+            }
+        };
+        // Handle abort signal
+        if (options?.signal) {
+            if (options.signal.aborted) {
+                killProcess();
+            }
+            else {
+                options.signal.addEventListener("abort", killProcess, { once: true });
+            }
+        }
+        // Handle timeout
+        if (options?.timeout && options.timeout > 0) {
+            timeoutId = setTimeout(() => {
+                killProcess();
+            }, options.timeout);
+        }
+        proc.stdout?.on("data", (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr?.on("data", (data) => {
+            stderr += data.toString();
+        });
+        // Wait for process termination without hanging on inherited stdio handles
+        // held open by detached descendants.
+        waitForChildProcess(proc)
+            .then((code) => {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (options?.signal) {
+                options.signal.removeEventListener("abort", killProcess);
+            }
+            resolve({ stdout, stderr, code: code ?? 0, killed });
+        })
+            .catch((_err) => {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (options?.signal) {
+                options.signal.removeEventListener("abort", killProcess);
+            }
+            resolve({ stdout, stderr, code: 1, killed });
+        });
+    });
+}
+//# sourceMappingURL=exec.js.map

package/dist/core/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/core/exec.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared command execution utilities for extensions and custom tools.\n */\n\nimport { spawn } from \"node:child_process\";\nimport { waitForChildProcess } from \"../utils/child-process.ts\";\n\n/**\n * Options for executing shell commands.\n */\nexport interface ExecOptions {\n\t/** AbortSignal to cancel the command */\n\tsignal?: AbortSignal;\n\t/** Timeout in milliseconds */\n\ttimeout?: number;\n\t/** Working directory */\n\tcwd?: string;\n}\n\n/**\n * Result of executing a shell command.\n */\nexport interface ExecResult {\n\tstdout: string;\n\tstderr: string;\n\tcode: number;\n\tkilled: boolean;\n}\n\n/**\n * Execute a shell command and return stdout/stderr/code.\n * Supports timeout and abort signal.\n */\nexport async function execCommand(\n\tcommand: string,\n\targs: string[],\n\tcwd: string,\n\toptions?: ExecOptions,\n): Promise<ExecResult> {\n\treturn new Promise((resolve) => {\n\t\tconst proc = spawn(command, args, {\n\t\t\tcwd,\n\t\t\tshell: false,\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t});\n\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tlet killed = false;\n\t\tlet timeoutId: NodeJS.Timeout | undefined;\n\n\t\tconst killProcess = () => {\n\t\t\tif (!killed) {\n\t\t\t\tkilled = true;\n\t\t\t\tproc.kill(\"SIGTERM\");\n\t\t\t\t// Force kill after 5 seconds if SIGTERM doesn't work\n\t\t\t\tsetTimeout(() => {\n\t\t\t\t\tif (!proc.killed) {\n\t\t\t\t\t\tproc.kill(\"SIGKILL\");\n\t\t\t\t\t}\n\t\t\t\t}, 5000);\n\t\t\t}\n\t\t};\n\n\t\t// Handle abort signal\n\t\tif (options?.signal) {\n\t\t\tif (options.signal.aborted) {\n\t\t\t\tkillProcess();\n\t\t\t} else {\n\t\t\t\toptions.signal.addEventListener(\"abort\", killProcess, { once: true });\n\t\t\t}\n\t\t}\n\n\t\t// Handle timeout\n\t\tif (options?.timeout && options.timeout > 0) {\n\t\t\ttimeoutId = setTimeout(() => {\n\t\t\t\tkillProcess();\n\t\t\t}, options.timeout);\n\t\t}\n\n\t\tproc.stdout?.on(\"data\", (data) => {\n\t\t\tstdout += data.toString();\n\t\t});\n\n\t\tproc.stderr?.on(\"data\", (data) => {\n\t\t\tstderr += data.toString();\n\t\t});\n\n\t\t// Wait for process termination without hanging on inherited stdio handles\n\t\t// held open by detached descendants.\n\t\twaitForChildProcess(proc)\n\t\t\t.then((code) => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\tif (options?.signal) {\n\t\t\t\t\toptions.signal.removeEventListener(\"abort\", killProcess);\n\t\t\t\t}\n\t\t\t\tresolve({ stdout, stderr, code: code ?? 0, killed });\n\t\t\t})\n\t\t\t.catch((_err) => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\tif (options?.signal) {\n\t\t\t\t\toptions.signal.removeEventListener(\"abort\", killProcess);\n\t\t\t\t}\n\t\t\t\tresolve({ stdout, stderr, code: 1, killed });\n\t\t\t});\n\t});\n}\n"]}