@astralyn/pi 1.0.5 → 1.2.0

package/dist/modes/interactive/program-status-reporter.d.ts

@@ -0,0 +1,34 @@
+import type { ProgramStatus, Terminal } from "@earendil-works/pi-tui";
+import type { AgentSessionEvent } from "../../core/agent-session.ts";
+export type BlockedStatus = {
+    kind: NonNullable<ProgramStatus["kind"]>;
+    message: string;
+};
+/**
+ * Reports interactive-mode state to the terminal (OSC 7501): `working` during agent runs and
+ * compaction, `blocked` while a dialog waits for the user, then `done`, `error`, or `idle` once the run
+ * settles. Messages are limited to the session name, dialog titles, and the first line of errors; prompts
+ * and assistant output are never reported.
+ */
+export declare class ProgramStatusReporter {
+    private readonly getTerminal;
+    private readonly getSessionName;
+    private runActive;
+    private compacting;
+    /** Outcome of the current run, reported once it settles. */
+    private runResult;
+    /** Status while no run is active. */
+    private restingStatus;
+    /** Open dialogs by source, in the order they opened. The most recent one is reported. */
+    private readonly blocked;
+    private lastReport;
+    constructor(getTerminal: () => Terminal, getSessionName: () => string | undefined);
+    handleEvent(event: AgentSessionEvent): void;
+    /** Report `blocked` for a dialog until it is cleared with `undefined`. Reopening a source replaces it. */
+    setBlocked(source: string, status: BlockedStatus | undefined): void;
+    /** Forget the previous session's run, for example after switching sessions. */
+    reset(): void;
+    report(): void;
+    private currentStatus;
+}
+//# sourceMappingURL=program-status-reporter.d.ts.map

package/dist/modes/interactive/program-status-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-status-reporter.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/program-status-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAM1F;;;;;GAKG;AACH,qBAAa,qBAAqB;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAC1D,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,4DAA4D;IAC5D,OAAO,CAAC,SAAS,CAAoC;IACrD,qCAAqC;IACrC,OAAO,CAAC,aAAa,CAAoC;IACzD,yFAAyF;IACzF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,UAAU,CAAqB;gBAE3B,WAAW,EAAE,MAAM,QAAQ,EAAE,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS;IAKjF,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IA4C3C,0GAA0G;IAC1G,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI;IAMnE,+EAA+E;IAC/E,KAAK,IAAI,IAAI;IAQb,MAAM,IAAI,IAAI;IAQd,OAAO,CAAC,aAAa;CAQrB"}

package/dist/modes/interactive/program-status-reporter.js

@@ -0,0 +1,107 @@
+import { APP_NAME } from "../../config.js";
+function firstLine(text) {
+    return text?.split(/\r?\n/, 1)[0]?.trim() || "Error";
+}
+/**
+ * Reports interactive-mode state to the terminal (OSC 7501): `working` during agent runs and
+ * compaction, `blocked` while a dialog waits for the user, then `done`, `error`, or `idle` once the run
+ * settles. Messages are limited to the session name, dialog titles, and the first line of errors; prompts
+ * and assistant output are never reported.
+ */
+export class ProgramStatusReporter {
+    constructor(getTerminal, getSessionName) {
+        this.runActive = false;
+        this.compacting = false;
+        /** Outcome of the current run, reported once it settles. */
+        this.runResult = { state: "done" };
+        /** Status while no run is active. */
+        this.restingStatus = { state: "idle" };
+        /** Open dialogs by source, in the order they opened. The most recent one is reported. */
+        this.blocked = new Map();
+        this.getTerminal = getTerminal;
+        this.getSessionName = getSessionName;
+    }
+    handleEvent(event) {
+        switch (event.type) {
+            case "agent_start":
+                this.runActive = true;
+                this.runResult = { state: "done" };
+                break;
+            case "message_end":
+                // The latest response decides the outcome, so a retried error is replaced by its successful retry.
+                if (event.message.role !== "assistant")
+                    return;
+                this.runResult =
+                    event.message.stopReason === "error"
+                        ? { state: "error", message: firstLine(event.message.errorMessage) }
+                        : { state: "done" };
+                break;
+            case "compaction_start":
+                this.compacting = true;
+                break;
+            case "compaction_end":
+                this.compacting = false;
+                if (this.runActive) {
+                    // A failed recovery compaction ends the run unless a later response succeeds.
+                    if (event.aborted)
+                        this.runResult = { state: "idle" };
+                    else if (event.errorMessage)
+                        this.runResult = { state: "error", message: firstLine(event.errorMessage) };
+                }
+                else if (event.aborted) {
+                    this.restingStatus = { state: "idle" };
+                }
+                else if (event.reason === "manual") {
+                    this.restingStatus = event.errorMessage
+                        ? { state: "error", message: firstLine(event.errorMessage) }
+                        : { state: "done" };
+                }
+                break;
+            case "agent_settled":
+                this.runActive = false;
+                this.restingStatus = event.aborted ? { state: "idle" } : this.runResult;
+                break;
+            case "session_info_changed":
+                // The session name is part of working and done reports.
+                break;
+            default:
+                return;
+        }
+        this.report();
+    }
+    /** Report `blocked` for a dialog until it is cleared with `undefined`. Reopening a source replaces it. */
+    setBlocked(source, status) {
+        this.blocked.delete(source);
+        if (status)
+            this.blocked.set(source, status);
+        this.report();
+    }
+    /** Forget the previous session's run, for example after switching sessions. */
+    reset() {
+        this.runActive = false;
+        this.compacting = false;
+        this.runResult = { state: "done" };
+        this.restingStatus = { state: "idle" };
+        this.report();
+    }
+    report() {
+        const status = { ...this.currentStatus(), app: APP_NAME };
+        const key = JSON.stringify(status);
+        if (key === this.lastReport)
+            return;
+        this.lastReport = key;
+        this.getTerminal().setProgramStatus(status);
+    }
+    currentStatus() {
+        const blocked = [...this.blocked.values()].at(-1);
+        if (blocked)
+            return { state: "blocked", ...blocked };
+        if (this.compacting)
+            return { state: "working", message: "Compacting context" };
+        const status = this.runActive ? { state: "working" } : this.restingStatus;
+        if (status.state === "working" || status.state === "done")
+            return { ...status, message: this.getSessionName() };
+        return status;
+    }
+}
+//# sourceMappingURL=program-status-reporter.js.map

package/dist/modes/interactive/program-status-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-status-reporter.js","sourceRoot":"","sources":["../../../src/modes/interactive/program-status-reporter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ProgramStatus, Terminal } from \"@earendil-works/pi-tui\";\nimport { APP_NAME } from \"../../config.ts\";\nimport type { AgentSessionEvent } from \"../../core/agent-session.ts\";\n\nexport type BlockedStatus = { kind: NonNullable<ProgramStatus[\"kind\"]>; message: string };\n\nfunction firstLine(text: string | undefined): string {\n\treturn text?.split(/\\r?\\n/, 1)[0]?.trim() || \"Error\";\n}\n\n/**\n * Reports interactive-mode state to the terminal (OSC 7501): `working` during agent runs and\n * compaction, `blocked` while a dialog waits for the user, then `done`, `error`, or `idle` once the run\n * settles. Messages are limited to the session name, dialog titles, and the first line of errors; prompts\n * and assistant output are never reported.\n */\nexport class ProgramStatusReporter {\n\tprivate readonly getTerminal: () => Terminal;\n\tprivate readonly getSessionName: () => string | undefined;\n\tprivate runActive = false;\n\tprivate compacting = false;\n\t/** Outcome of the current run, reported once it settles. */\n\tprivate runResult: ProgramStatus = { state: \"done\" };\n\t/** Status while no run is active. */\n\tprivate restingStatus: ProgramStatus = { state: \"idle\" };\n\t/** Open dialogs by source, in the order they opened. The most recent one is reported. */\n\tprivate readonly blocked = new Map<string, BlockedStatus>();\n\tprivate lastReport: string | undefined;\n\n\tconstructor(getTerminal: () => Terminal, getSessionName: () => string | undefined) {\n\t\tthis.getTerminal = getTerminal;\n\t\tthis.getSessionName = getSessionName;\n\t}\n\n\thandleEvent(event: AgentSessionEvent): void {\n\t\tswitch (event.type) {\n\t\t\tcase \"agent_start\":\n\t\t\t\tthis.runActive = true;\n\t\t\t\tthis.runResult = { state: \"done\" };\n\t\t\t\tbreak;\n\t\t\tcase \"message_end\":\n\t\t\t\t// The latest response decides the outcome, so a retried error is replaced by its successful retry.\n\t\t\t\tif (event.message.role !== \"assistant\") return;\n\t\t\t\tthis.runResult =\n\t\t\t\t\tevent.message.stopReason === \"error\"\n\t\t\t\t\t\t? { state: \"error\", message: firstLine(event.message.errorMessage) }\n\t\t\t\t\t\t: { state: \"done\" };\n\t\t\t\tbreak;\n\t\t\tcase \"compaction_start\":\n\t\t\t\tthis.compacting = true;\n\t\t\t\tbreak;\n\t\t\tcase \"compaction_end\":\n\t\t\t\tthis.compacting = false;\n\t\t\t\tif (this.runActive) {\n\t\t\t\t\t// A failed recovery compaction ends the run unless a later response succeeds.\n\t\t\t\t\tif (event.aborted) this.runResult = { state: \"idle\" };\n\t\t\t\t\telse if (event.errorMessage) this.runResult = { state: \"error\", message: firstLine(event.errorMessage) };\n\t\t\t\t} else if (event.aborted) {\n\t\t\t\t\tthis.restingStatus = { state: \"idle\" };\n\t\t\t\t} else if (event.reason === \"manual\") {\n\t\t\t\t\tthis.restingStatus = event.errorMessage\n\t\t\t\t\t\t? { state: \"error\", message: firstLine(event.errorMessage) }\n\t\t\t\t\t\t: { state: \"done\" };\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\tcase \"agent_settled\":\n\t\t\t\tthis.runActive = false;\n\t\t\t\tthis.restingStatus = event.aborted ? { state: \"idle\" } : this.runResult;\n\t\t\t\tbreak;\n\t\t\tcase \"session_info_changed\":\n\t\t\t\t// The session name is part of working and done reports.\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\treturn;\n\t\t}\n\t\tthis.report();\n\t}\n\n\t/** Report `blocked` for a dialog until it is cleared with `undefined`. Reopening a source replaces it. */\n\tsetBlocked(source: string, status: BlockedStatus | undefined): void {\n\t\tthis.blocked.delete(source);\n\t\tif (status) this.blocked.set(source, status);\n\t\tthis.report();\n\t}\n\n\t/** Forget the previous session's run, for example after switching sessions. */\n\treset(): void {\n\t\tthis.runActive = false;\n\t\tthis.compacting = false;\n\t\tthis.runResult = { state: \"done\" };\n\t\tthis.restingStatus = { state: \"idle\" };\n\t\tthis.report();\n\t}\n\n\treport(): void {\n\t\tconst status: ProgramStatus = { ...this.currentStatus(), app: APP_NAME };\n\t\tconst key = JSON.stringify(status);\n\t\tif (key === this.lastReport) return;\n\t\tthis.lastReport = key;\n\t\tthis.getTerminal().setProgramStatus(status);\n\t}\n\n\tprivate currentStatus(): ProgramStatus {\n\t\tconst blocked = [...this.blocked.values()].at(-1);\n\t\tif (blocked) return { state: \"blocked\", ...blocked };\n\t\tif (this.compacting) return { state: \"working\", message: \"Compacting context\" };\n\t\tconst status = this.runActive ? { state: \"working\" as const } : this.restingStatus;\n\t\tif (status.state === \"working\" || status.state === \"done\") return { ...status, message: this.getSessionName() };\n\t\treturn status;\n\t}\n}\n"]}

package/dist/modes/interactive/tasks/host-hooks.d.ts

@@ -0,0 +1,14 @@
+import { type AppKeybinding } from "../../../core/keybindings.ts";
+import type { TaskSnapshot } from "../../../core/tasks/types.ts";
+/**
+ * Task rows for `/hotkeys`. Task keybindings act outside the editor, so they never showed up in
+ * the editor-driven sections; labels come from KEYBINDINGS so the table cannot drift from the
+ * binding registry.
+ */
+export declare function hotkeysTaskSection(display: (action: AppKeybinding) => string): string;
+/**
+ * Ask before tree navigation cancels running tasks: results are saved on their launch branch,
+ * so leaving it stops them. Resolves true when navigation may continue.
+ */
+export declare function confirmStopBranchTasks(stopped: readonly TaskSnapshot[], confirm: (title: string, message: string) => Promise<boolean>): Promise<boolean>;
+//# sourceMappingURL=host-hooks.d.ts.map

package/dist/modes/interactive/tasks/host-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-hooks.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/tasks/host-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAe,MAAM,8BAA8B,CAAC;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGjE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,GAAG,MAAM,CAUrF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC3D,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/modes/interactive/tasks/host-hooks.js

@@ -0,0 +1,31 @@
+import { KEYBINDINGS } from "../../../core/keybindings.js";
+import { cleanTaskText, firstCommandLine } from "./text.js";
+/**
+ * Task rows for `/hotkeys`. Task keybindings act outside the editor, so they never showed up in
+ * the editor-driven sections; labels come from KEYBINDINGS so the table cannot drift from the
+ * binding registry.
+ */
+export function hotkeysTaskSection(display) {
+    const detach = KEYBINDINGS["app.tasks.detach"];
+    const detachSelected = KEYBINDINGS["app.tasks.detachSelected"];
+    return `
+**Tasks**
+| Key | Action |
+|-----|--------|
+| \`${display("app.tasks.detach")}\` | ${detach.description} |
+| \`${display("app.tasks.detachSelected")}\` | ${detachSelected.description} (while /tasks is open) |
+`;
+}
+/**
+ * Ask before tree navigation cancels running tasks: results are saved on their launch branch,
+ * so leaving it stops them. Resolves true when navigation may continue.
+ */
+export async function confirmStopBranchTasks(stopped, confirm) {
+    if (stopped.length === 0)
+        return true;
+    const shown = stopped.slice(0, 5).map((task) => `  ${cleanTaskText(firstCommandLine(task.command ?? task.title))}`);
+    if (stopped.length > shown.length)
+        shown.push(`  …and ${stopped.length - shown.length} more`);
+    return confirm(`Stop ${stopped.length} running task${stopped.length === 1 ? "" : "s"}?`, `They were started on the branch you are leaving and will be cancelled:\n${shown.join("\n")}`);
+}
+//# sourceMappingURL=host-hooks.js.map

package/dist/modes/interactive/tasks/host-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-hooks.js","sourceRoot":"","sources":["../../../../src/modes/interactive/tasks/host-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE5D;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA0C;IAC5E,MAAM,MAAM,GAAG,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAC/D,OAAO;;;;MAIF,OAAO,CAAC,kBAAkB,CAAC,QAAQ,MAAM,CAAC,WAAW;MACrD,OAAO,CAAC,0BAA0B,CAAC,QAAQ,cAAc,CAAC,WAAW;CAC1E,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,OAAgC,EAChC,OAA6D;IAE7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,aAAa,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IACpH,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC;IAC9F,OAAO,OAAO,CACb,QAAQ,OAAO,CAAC,MAAM,gBAAgB,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EACxE,2EAA2E,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7F,CAAC;AACH,CAAC","sourcesContent":["import { type AppKeybinding, KEYBINDINGS } from \"../../../core/keybindings.ts\";\nimport type { TaskSnapshot } from \"../../../core/tasks/types.ts\";\nimport { cleanTaskText, firstCommandLine } from \"./text.ts\";\n\n/**\n * Task rows for `/hotkeys`. Task keybindings act outside the editor, so they never showed up in\n * the editor-driven sections; labels come from KEYBINDINGS so the table cannot drift from the\n * binding registry.\n */\nexport function hotkeysTaskSection(display: (action: AppKeybinding) => string): string {\n\tconst detach = KEYBINDINGS[\"app.tasks.detach\"];\n\tconst detachSelected = KEYBINDINGS[\"app.tasks.detachSelected\"];\n\treturn `\n**Tasks**\n| Key | Action |\n|-----|--------|\n| \\`${display(\"app.tasks.detach\")}\\` | ${detach.description} |\n| \\`${display(\"app.tasks.detachSelected\")}\\` | ${detachSelected.description} (while /tasks is open) |\n`;\n}\n\n/**\n * Ask before tree navigation cancels running tasks: results are saved on their launch branch,\n * so leaving it stops them. Resolves true when navigation may continue.\n */\nexport async function confirmStopBranchTasks(\n\tstopped: readonly TaskSnapshot[],\n\tconfirm: (title: string, message: string) => Promise<boolean>,\n): Promise<boolean> {\n\tif (stopped.length === 0) return true;\n\tconst shown = stopped.slice(0, 5).map((task) => `  ${cleanTaskText(firstCommandLine(task.command ?? task.title))}`);\n\tif (stopped.length > shown.length) shown.push(`  …and ${stopped.length - shown.length} more`);\n\treturn confirm(\n\t\t`Stop ${stopped.length} running task${stopped.length === 1 ? \"\" : \"s\"}?`,\n\t\t`They were started on the branch you are leaving and will be cancelled:\\n${shown.join(\"\\n\")}`,\n\t);\n}\n"]}

package/dist/modes/interactive/theme/dark.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"$schema": "https://pi.dev/schemas/theme.schema.json",
 	"name": "dark",
 	"appearance": "dark",
 	"vars": {

package/dist/modes/interactive/theme/light.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"$schema": "https://pi.dev/schemas/theme.schema.json",
 	"name": "light",
 	"appearance": "light",
 	"vars": {

package/dist/modes/interactive/theme/theme-schema.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Theme JSON validation, kept out of `theme.ts` on purpose.
+ *
+ * Validating user-authored theme files needs typebox, which costs ~17 MB of module graph to import.
+ * Palette lookup does not, so a presentation that only uses built-in themes should never pay for it.
+ * `main.ts` installs this validator before runtime resource loading; other consumers can opt in with
+ * `setThemeJsonValidator()`. Built-in themes do not need validation.
+ */
+import { type Static, Type } from "typebox";
+import { type ThemeColorValues } from "./theme-tokens.ts";
+export declare const ColorValueSchema: Type.TUnion<[Type.TString, Type.TInteger]>;
+export type ThemeColorValue = Static<typeof ColorValueSchema>;
+export declare const ThemeJsonSchema: Type.TObject<{
+    $schema: Type.TOptional<Type.TString>;
+    name: Type.TString;
+    appearance: Type.TOptional<Type.TUnion<[Type.TLiteral<"dark">, Type.TLiteral<"light">]>>;
+    vars: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TString, Type.TInteger]>>>;
+    colors: Type.TUnsafe<ThemeColorValues<string | number>>;
+    export: Type.TOptional<Type.TObject<{
+        pageBg: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
+        cardBg: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
+        infoBg: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
+    }>>;
+}>;
+export type ValidatedThemeJson = Static<typeof ThemeJsonSchema>;
+/** Validate one theme document, throwing a message that names the offending tokens. */
+export declare function validateThemeJson(label: string, json: unknown): ValidatedThemeJson;
+//# sourceMappingURL=theme-schema.d.ts.map

package/dist/modes/interactive/theme/theme-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-schema.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/theme/theme-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAoB,IAAI,EAAE,MAAM,SAAS,CAAC;AAE9D,OAAO,EAAgB,KAAK,gBAAgB,EAA8B,MAAM,mBAAmB,CAAC;AAmBpG,eAAO,MAAM,gBAAgB,4CAAe,CAAC;AAE7C,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAmB9D,eAAO,MAAM,eAAe;;;;;;;;;;;EAsC3B,CAAC;AAIF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAEhE,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAiDlF"}

package/dist/modes/interactive/theme/theme-schema.js

@@ -0,0 +1,105 @@
+/**
+ * Theme JSON validation, kept out of `theme.ts` on purpose.
+ *
+ * Validating user-authored theme files needs typebox, which costs ~17 MB of module graph to import.
+ * Palette lookup does not, so a presentation that only uses built-in themes should never pay for it.
+ * `main.ts` installs this validator before runtime resource loading; other consumers can opt in with
+ * `setThemeJsonValidator()`. Built-in themes do not need validation.
+ */
+import { Type } from "typebox";
+import { Compile } from "typebox/compile";
+import { THEME_TOKENS } from "./theme-tokens.js";
+function colorValue(description) {
+    return Type.Union([
+        Type.String({
+            description: "Hex color (#RGB or #RRGGBB), OKLCH or OKHSL color, variable reference, or empty string for terminal default",
+        }),
+        Type.Integer({
+            minimum: 0,
+            maximum: 255,
+            description: "256-color palette index (0-255)",
+        }),
+    ], description ? { description } : {});
+}
+export const ColorValueSchema = colorValue();
+function themeTokenProperties(tokens) {
+    const properties = {};
+    for (const [name, descriptor] of Object.entries(tokens)) {
+        const schema = colorValue(descriptor.description);
+        properties[name] = descriptor.fallback === undefined ? schema : Type.Optional(schema);
+    }
+    return properties;
+}
+const ThemeColorsSchema = Type.Unsafe(Type.Object(themeTokenProperties(THEME_TOKENS), {
+    description: "Theme color definitions (scrollbar, thinkingMax, and search highlight colors are optional and use compatible fallbacks)",
+    additionalProperties: false,
+}));
+export const ThemeJsonSchema = Type.Object({
+    $schema: Type.Optional(Type.String({ description: "JSON schema reference" })),
+    name: Type.String({
+        pattern: "^[^/]+$",
+        description: "Theme name. Must not contain '/' because it is reserved for automatic light/dark theme settings.",
+    }),
+    appearance: Type.Optional(Type.Union([Type.Literal("dark"), Type.Literal("light")], {
+        description: "Background the theme is designed for. Detected from the theme colors when omitted.",
+    })),
+    vars: Type.Optional(Type.Record(Type.String(), ColorValueSchema, {
+        description: "Reusable color variables",
+    })),
+    colors: ThemeColorsSchema,
+    export: Type.Optional(Type.Object({
+        pageBg: Type.Optional(colorValue("Page background color")),
+        cardBg: Type.Optional(colorValue("Card/container background color")),
+        infoBg: Type.Optional(colorValue("Info sections background (system prompt, notices)")),
+    }, {
+        description: "Optional colors for HTML export (defaults derived from userMessageBg if not specified)",
+        additionalProperties: false,
+    })),
+}, {
+    title: "Pi Coding Agent Theme",
+    description: "Theme schema for Pi coding agent",
+    additionalProperties: false,
+});
+const compiledThemeSchema = Compile(ThemeJsonSchema);
+/** Validate one theme document, throwing a message that names the offending tokens. */
+export function validateThemeJson(label, json) {
+    if (typeof json === "object" &&
+        json !== null &&
+        "name" in json &&
+        typeof json.name === "string" &&
+        json.name.includes("/")) {
+        throw new Error(`Invalid theme name "${json.name}": theme names cannot contain "/" because it is reserved for automatic light/dark theme settings.`);
+    }
+    if (!compiledThemeSchema.Check(json)) {
+        const errors = Array.from(compiledThemeSchema.Errors(json));
+        const missingColors = new Set();
+        const otherErrors = [];
+        for (const error of errors) {
+            if (error.keyword === "required" && error.instancePath === "/colors") {
+                const requiredProperties = error.params.requiredProperties;
+                for (const requiredProperty of requiredProperties ?? []) {
+                    missingColors.add(requiredProperty);
+                }
+                continue;
+            }
+            const path = error.instancePath || "/";
+            otherErrors.push(`  - ${path}: ${error.message}`);
+        }
+        let errorMessage = `Invalid theme "${label}":\n`;
+        if (missingColors.size > 0) {
+            errorMessage += "\nMissing required color tokens:\n";
+            errorMessage += Array.from(missingColors)
+                .sort()
+                .map((color) => `  - ${color}`)
+                .join("\n");
+            errorMessage += '\n\nPlease add these colors to your theme\'s "colors" object.';
+            errorMessage += "\nSee the built-in themes (dark.json, light.json) for reference values.";
+        }
+        if (otherErrors.length > 0) {
+            errorMessage += `\n\nOther errors:\n${otherErrors.join("\n")}`;
+        }
+        throw new Error(errorMessage);
+    }
+    return json;
+}
+//# sourceMappingURL=theme-schema.js.map

package/dist/modes/interactive/theme/theme-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-schema.js","sourceRoot":"","sources":["../../../../src/modes/interactive/theme/theme-schema.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Theme JSON validation, kept out of `theme.ts` on purpose.\n *\n * Validating user-authored theme files needs typebox, which costs ~17 MB of module graph to import.\n * Palette lookup does not, so a presentation that only uses built-in themes should never pay for it.\n * `main.ts` installs this validator before runtime resource loading; other consumers can opt in with\n * `setThemeJsonValidator()`. Built-in themes do not need validation.\n */\n\nimport { type Static, type TProperties, Type } from \"typebox\";\nimport { Compile } from \"typebox/compile\";\nimport { THEME_TOKENS, type ThemeColorValues, type ThemeTokenDescriptors } from \"./theme-tokens.ts\";\n\nfunction colorValue(description?: string) {\n\treturn Type.Union(\n\t\t[\n\t\t\tType.String({\n\t\t\t\tdescription:\n\t\t\t\t\t\"Hex color (#RGB or #RRGGBB), OKLCH or OKHSL color, variable reference, or empty string for terminal default\",\n\t\t\t}),\n\t\t\tType.Integer({\n\t\t\t\tminimum: 0,\n\t\t\t\tmaximum: 255,\n\t\t\t\tdescription: \"256-color palette index (0-255)\",\n\t\t\t}),\n\t\t],\n\t\tdescription ? { description } : {},\n\t);\n}\n\nexport const ColorValueSchema = colorValue();\n\nexport type ThemeColorValue = Static<typeof ColorValueSchema>;\n\nfunction themeTokenProperties(tokens: ThemeTokenDescriptors): TProperties {\n\tconst properties: TProperties = {};\n\tfor (const [name, descriptor] of Object.entries(tokens)) {\n\t\tconst schema = colorValue(descriptor.description);\n\t\tproperties[name] = descriptor.fallback === undefined ? schema : Type.Optional(schema);\n\t}\n\treturn properties;\n}\n\nconst ThemeColorsSchema = Type.Unsafe<ThemeColorValues<ThemeColorValue>>(\n\tType.Object(themeTokenProperties(THEME_TOKENS), {\n\t\tdescription:\n\t\t\t\"Theme color definitions (scrollbar, thinkingMax, and search highlight colors are optional and use compatible fallbacks)\",\n\t\tadditionalProperties: false,\n\t}),\n);\n\nexport const ThemeJsonSchema = Type.Object(\n\t{\n\t\t$schema: Type.Optional(Type.String({ description: \"JSON schema reference\" })),\n\t\tname: Type.String({\n\t\t\tpattern: \"^[^/]+$\",\n\t\t\tdescription:\n\t\t\t\t\"Theme name. Must not contain '/' because it is reserved for automatic light/dark theme settings.\",\n\t\t}),\n\t\tappearance: Type.Optional(\n\t\t\tType.Union([Type.Literal(\"dark\"), Type.Literal(\"light\")], {\n\t\t\t\tdescription: \"Background the theme is designed for. Detected from the theme colors when omitted.\",\n\t\t\t}),\n\t\t),\n\t\tvars: Type.Optional(\n\t\t\tType.Record(Type.String(), ColorValueSchema, {\n\t\t\t\tdescription: \"Reusable color variables\",\n\t\t\t}),\n\t\t),\n\t\tcolors: ThemeColorsSchema,\n\t\texport: Type.Optional(\n\t\t\tType.Object(\n\t\t\t\t{\n\t\t\t\t\tpageBg: Type.Optional(colorValue(\"Page background color\")),\n\t\t\t\t\tcardBg: Type.Optional(colorValue(\"Card/container background color\")),\n\t\t\t\t\tinfoBg: Type.Optional(colorValue(\"Info sections background (system prompt, notices)\")),\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tdescription: \"Optional colors for HTML export (defaults derived from userMessageBg if not specified)\",\n\t\t\t\t\tadditionalProperties: false,\n\t\t\t\t},\n\t\t\t),\n\t\t),\n\t},\n\t{\n\t\ttitle: \"Pi Coding Agent Theme\",\n\t\tdescription: \"Theme schema for Pi coding agent\",\n\t\tadditionalProperties: false,\n\t},\n);\n\nconst compiledThemeSchema = Compile(ThemeJsonSchema);\n\nexport type ValidatedThemeJson = Static<typeof ThemeJsonSchema>;\n\n/** Validate one theme document, throwing a message that names the offending tokens. */\nexport function validateThemeJson(label: string, json: unknown): ValidatedThemeJson {\n\tif (\n\t\ttypeof json === \"object\" &&\n\t\tjson !== null &&\n\t\t\"name\" in json &&\n\t\ttypeof json.name === \"string\" &&\n\t\tjson.name.includes(\"/\")\n\t) {\n\t\tthrow new Error(\n\t\t\t`Invalid theme name \"${json.name}\": theme names cannot contain \"/\" because it is reserved for automatic light/dark theme settings.`,\n\t\t);\n\t}\n\n\tif (!compiledThemeSchema.Check(json)) {\n\t\tconst errors = Array.from(compiledThemeSchema.Errors(json));\n\t\tconst missingColors = new Set<string>();\n\t\tconst otherErrors: string[] = [];\n\n\t\tfor (const error of errors) {\n\t\t\tif (error.keyword === \"required\" && error.instancePath === \"/colors\") {\n\t\t\t\tconst requiredProperties = (error.params as { requiredProperties?: string[] }).requiredProperties;\n\t\t\t\tfor (const requiredProperty of requiredProperties ?? []) {\n\t\t\t\t\tmissingColors.add(requiredProperty);\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst path = error.instancePath || \"/\";\n\t\t\totherErrors.push(`  - ${path}: ${error.message}`);\n\t\t}\n\n\t\tlet errorMessage = `Invalid theme \"${label}\":\\n`;\n\t\tif (missingColors.size > 0) {\n\t\t\terrorMessage += \"\\nMissing required color tokens:\\n\";\n\t\t\terrorMessage += Array.from(missingColors)\n\t\t\t\t.sort()\n\t\t\t\t.map((color) => `  - ${color}`)\n\t\t\t\t.join(\"\\n\");\n\t\t\terrorMessage += '\\n\\nPlease add these colors to your theme\\'s \"colors\" object.';\n\t\t\terrorMessage += \"\\nSee the built-in themes (dark.json, light.json) for reference values.\";\n\t\t}\n\t\tif (otherErrors.length > 0) {\n\t\t\terrorMessage += `\\n\\nOther errors:\\n${otherErrors.join(\"\\n\")}`;\n\t\t}\n\n\t\tthrow new Error(errorMessage);\n\t}\n\n\treturn json as ValidatedThemeJson;\n}\n"]}