@agimon-ai/po-notification 0.0.0-alpha.2 → 0.0.0-alpha.20

package/README.md

@@ -3,7 +3,7 @@
 System and browser notifications, plus an animated shell-tab title, for
 [Po](https://www.npmjs.com/package/@agimon-ai/po) sessions.
 
-Long agent runs are worth walking away from. This package owns the shared `doom/notification` service,
+Long agent runs are worth walking away from. This package owns the shared `po/notification` service,
 routes each request for the active session, and announces when the agent needs attention.
 
 ## What it does
@@ -11,13 +11,13 @@ routes each request for the active session, and announces when the agent needs a
 | Surface          | Behavior                                                                                     |
 | ---------------- | -------------------------------------------------------------------------------------------- |
 | Shell tab title  | `π - <session or first prompt> - <repository>`, with a braille spinner while the agent works |
-| Notification API | caller-authored notices through the shared `doom/notification` Cordis service                |
+| Notification API | caller-authored notices through the shared `po/notification` Cordis service                  |
 | Mid-run          | one notification for each agent-initiated dialog and each `ask_user_question` prompt         |
 | At rest          | one notification when a run settles with nothing queued behind it                            |
 
 In an interactive terminal session, requests use `cmux notify` first because it routes them back to
 the session window. On macOS, a missing `cmux` falls back to `osascript`. In RPC mode, requests become
-versioned `doom-notification` session entries for a live client such as `po-web`. An RPC append
+versioned `po-notification` session entries for a live client such as `po-web`. An RPC append
 failure stays silent and never falls back to a host notifier. Hosts without a supported notifier also
 stay silent.
 
@@ -27,10 +27,10 @@ Callers should discover the optional service through Cordis and request delivery
 a particular host:
 
 ```ts
-import { DOOM_NOTIFICATION_SERVICE, readDoomNotificationService } from '@agimon-ai/po-core/notification';
+import { PO_NOTIFICATION_SERVICE, readPoNotificationService } from '@agimon-ai/po-core/notification';
 
-ctx.inject([DOOM_NOTIFICATION_SERVICE], (notificationContext) => {
-  void readDoomNotificationService(notificationContext)?.request({
+ctx.inject([PO_NOTIFICATION_SERVICE], (notificationContext) => {
+  void readPoNotificationService(notificationContext)?.request({
     body: 'Deployment needs approval',
     level: 'warning',
   });

package/dist/apiContracts.cjs

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 //#region src/schemas/apiContracts.ts
-/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+/** This server plugin contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
 const apiContracts = (0, require("@agimon-ai/po-core/apiContracts").defineApiContract)({
 	version: 1,
 	http: [],

package/dist/apiContracts.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"apiContracts.cjs","names":["defineApiContract"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;;;;AAGA,MAAa,gBAAA,4CAAeA,CAAAA,CAAAA,kBAAAA,CAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}
+{"version":3,"file":"apiContracts.cjs","names":["defineApiContract"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This server plugin contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;;;;AAGA,MAAa,gBAAA,4CAAeA,CAAAA,CAAAA,kBAAAA,CAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/apiContracts.d.mts

@@ -1,5 +1,5 @@
 //#region src/schemas/apiContracts.d.ts
-/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+/** This server plugin contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
 export declare const apiContracts: {
   version: 1;
   protocols?: Record<string, string> | undefined;

package/dist/apiContracts.mjs

@@ -1,6 +1,6 @@
 import { defineApiContract } from "@agimon-ai/po-core/apiContracts";
 //#region src/schemas/apiContracts.ts
-/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+/** This server plugin contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
 const apiContracts = defineApiContract({
 	version: 1,
 	http: [],

package/dist/apiContracts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAa,eAAe,kBAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This server plugin contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAa,eAAe,kBAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/extensions/server.cjs

@@ -2,10 +2,10 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+let _agimon_ai_po_core_serverPlugin = require("@agimon-ai/po-core/serverPlugin");
 let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile");
 //#region src/extensions/workspaces/sessions/(backend)/_lib/notificationCommand.ts
-const notificationCommand = (0, _agimon_ai_po_core_serverFacet.defineCommand)({
+const notificationCommand = (0, _agimon_ai_po_core_serverPlugin.defineCommand)({
 	name: "notify",
 	description: "Send a notification through the active headless client.",
 	async execute(args, execution) {
@@ -26,14 +26,14 @@ const via = (identity, value) => value === void 0 ? void 0 : {
 	...identity,
 	...value
 };
-const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
+const serverPlugin = (0, _agimon_ai_po_core_serverPlugin.defineServerPlugin)({
 	name: "@agimon-ai/po-notification",
 	session: (context) => ({ get commands() {
 		return [via({ name: "notify" }, at(notify_server_default, context))];
 	} })
 });
 //#endregion
-exports.default = facet;
-exports.facet = facet;
+exports.default = serverPlugin;
+exports.serverPlugin = serverPlugin;
 
 //# sourceMappingURL=server.cjs.map

package/dist/extensions/server.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.cjs","names":["defineCommand","defineServerCommand","defineServerPlugin","commandNotify"],"sources":["../../src/extensions/workspaces/sessions/(backend)/_lib/notificationCommand.ts","../../src/extensions/workspaces/sessions/(backend)/command/notify.server.ts","../../generated/server.ts"],"sourcesContent":["import { defineCommand } from '@agimon-ai/po-core/serverFacet';\n\nexport const notificationCommand = defineCommand({\n  name: 'notify',\n  description: 'Send a notification through the active headless client.',\n  async execute(args, execution) {\n    const body = args.trim();\n    if (body) await execution.notify({ body, level: 'info' });\n  },\n});\n","import { defineServerCommand } from '@agimon-ai/po-core/extensionFile';\n\nimport { notificationCommand } from '../_lib/notificationCommand';\n\nexport default defineServerCommand(notificationCommand);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport commandNotify from '../src/extensions/workspaces/sessions/(backend)/command/notify.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/po-notification',\n  session: (context) => ({\n    get commands(): DoomServerSessionPlugin['commands'] { return [via({ name: 'notify' }, at(commandNotify, context))]; },\n  }),\n});\n\nexport default facet;\n"],"mappings":";;;;;;;AAEA,MAAa,uBAAA,GAAsBA,+BAAAA,cAAAA,CAAc;CAC/C,MAAM;CACN,aAAa;CACb,MAAM,QAAQ,MAAM,WAAW;EAC7B,MAAM,OAAO,KAAK,KAAK;EACvB,IAAI,MAAM,MAAM,UAAU,OAAO;GAAE;GAAM,OAAO;EAAO,CAAC;CAC1D;AACF,CAAC;;;ACLD,IAAA,yBAAA,GAAeC,iCAAAA,oBAAAA,CAAoB,mBAAmB;;;ACEtD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,SAAA,GAAQC,+BAAAA,mBAAAA,CAAmB;CACtC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,WAAgD;EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,SAAS,GAAG,GAAGC,uBAAe,OAAO,CAAC,CAAC;CAAG,EACtH;AACF,CAAC"}
+{"version":3,"file":"server.cjs","names":["defineCommand","defineServerCommand","defineServerPlugin","commandNotify"],"sources":["../../src/extensions/workspaces/sessions/(backend)/_lib/notificationCommand.ts","../../src/extensions/workspaces/sessions/(backend)/command/notify.server.ts","../../generated/server.ts"],"sourcesContent":["import { defineCommand } from '@agimon-ai/po-core/serverPlugin';\n\nexport const notificationCommand = defineCommand({\n  name: 'notify',\n  description: 'Send a notification through the active headless client.',\n  async execute(args, execution) {\n    const body = args.trim();\n    if (body) await execution.notify({ body, level: 'info' });\n  },\n});\n","import { defineServerCommand } from '@agimon-ai/po-core/extensionFile';\n\nimport { notificationCommand } from '../_lib/notificationCommand';\n\nexport default defineServerCommand(notificationCommand);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nimport commandNotify from '../src/extensions/workspaces/sessions/(backend)/command/notify.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const serverPlugin = defineServerPlugin({\n  name: '@agimon-ai/po-notification',\n  session: (context) => ({\n    get commands(): PoServerSessionPlugin['commands'] { return [via({ name: 'notify' }, at(commandNotify, context))]; },\n  }),\n});\n\nexport default serverPlugin;\n"],"mappings":";;;;;;;AAEA,MAAa,uBAAA,GAAsBA,gCAAAA,cAAAA,CAAc;CAC/C,MAAM;CACN,aAAa;CACb,MAAM,QAAQ,MAAM,WAAW;EAC7B,MAAM,OAAO,KAAK,KAAK;EACvB,IAAI,MAAM,MAAM,UAAU,OAAO;GAAE;GAAM,OAAO;EAAO,CAAC;CAC1D;AACF,CAAC;;;ACLD,IAAA,yBAAA,GAAeC,iCAAAA,oBAAAA,CAAoB,mBAAmB;;;ACEtD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,gBAAA,GAAeC,gCAAAA,mBAAAA,CAAmB;CAC7C,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,WAA8C;EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,SAAS,GAAG,GAAGC,uBAAe,OAAO,CAAC,CAAC;CAAG,EACpH;AACF,CAAC"}

package/dist/extensions/server.d.mts

@@ -1,5 +1,5 @@
 //#region generated/server.d.ts
-export declare const facet: import("@agimon-ai/po-core/serverFacet").DoomServerFacet;
+export declare const serverPlugin: import("@agimon-ai/po-core/serverPlugin").PoServerPlugin;
 //#endregion
-export { facet as default };
+export { serverPlugin as default };
 //# sourceMappingURL=server.d.mts.map

package/dist/extensions/server.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.mts","names":[],"sources":["../../generated/server.ts"],"mappings":";qBAWa,gDAAK"}
+{"version":3,"file":"server.d.mts","names":[],"sources":["../../generated/server.ts"],"mappings":";qBAWa,wDAAY"}

package/dist/extensions/server.mjs

@@ -1,4 +1,4 @@
-import { defineCommand, defineServerPlugin } from "@agimon-ai/po-core/serverFacet";
+import { defineCommand, defineServerPlugin } from "@agimon-ai/po-core/serverPlugin";
 import { defineServerCommand } from "@agimon-ai/po-core/extensionFile";
 //#region src/extensions/workspaces/sessions/(backend)/_lib/notificationCommand.ts
 const notificationCommand = defineCommand({
@@ -22,13 +22,13 @@ const via = (identity, value) => value === void 0 ? void 0 : {
 	...identity,
 	...value
 };
-const facet = defineServerPlugin({
+const serverPlugin = defineServerPlugin({
 	name: "@agimon-ai/po-notification",
 	session: (context) => ({ get commands() {
 		return [via({ name: "notify" }, at(notify_server_default, context))];
 	} })
 });
 //#endregion
-export { facet as default, facet };
+export { serverPlugin as default, serverPlugin };
 
 //# sourceMappingURL=server.mjs.map

package/dist/extensions/server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.mjs","names":["commandNotify"],"sources":["../../src/extensions/workspaces/sessions/(backend)/_lib/notificationCommand.ts","../../src/extensions/workspaces/sessions/(backend)/command/notify.server.ts","../../generated/server.ts"],"sourcesContent":["import { defineCommand } from '@agimon-ai/po-core/serverFacet';\n\nexport const notificationCommand = defineCommand({\n  name: 'notify',\n  description: 'Send a notification through the active headless client.',\n  async execute(args, execution) {\n    const body = args.trim();\n    if (body) await execution.notify({ body, level: 'info' });\n  },\n});\n","import { defineServerCommand } from '@agimon-ai/po-core/extensionFile';\n\nimport { notificationCommand } from '../_lib/notificationCommand';\n\nexport default defineServerCommand(notificationCommand);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport commandNotify from '../src/extensions/workspaces/sessions/(backend)/command/notify.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/po-notification',\n  session: (context) => ({\n    get commands(): DoomServerSessionPlugin['commands'] { return [via({ name: 'notify' }, at(commandNotify, context))]; },\n  }),\n});\n\nexport default facet;\n"],"mappings":";;;AAEA,MAAa,sBAAsB,cAAc;CAC/C,MAAM;CACN,aAAa;CACb,MAAM,QAAQ,MAAM,WAAW;EAC7B,MAAM,OAAO,KAAK,KAAK;EACvB,IAAI,MAAM,MAAM,UAAU,OAAO;GAAE;GAAM,OAAO;EAAO,CAAC;CAC1D;AACF,CAAC;;;ACLD,IAAA,wBAAe,oBAAoB,mBAAmB;;;ACEtD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,QAAQ,mBAAmB;CACtC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,WAAgD;EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,SAAS,GAAG,GAAGA,uBAAe,OAAO,CAAC,CAAC;CAAG,EACtH;AACF,CAAC"}
+{"version":3,"file":"server.mjs","names":["commandNotify"],"sources":["../../src/extensions/workspaces/sessions/(backend)/_lib/notificationCommand.ts","../../src/extensions/workspaces/sessions/(backend)/command/notify.server.ts","../../generated/server.ts"],"sourcesContent":["import { defineCommand } from '@agimon-ai/po-core/serverPlugin';\n\nexport const notificationCommand = defineCommand({\n  name: 'notify',\n  description: 'Send a notification through the active headless client.',\n  async execute(args, execution) {\n    const body = args.trim();\n    if (body) await execution.notify({ body, level: 'info' });\n  },\n});\n","import { defineServerCommand } from '@agimon-ai/po-core/extensionFile';\n\nimport { notificationCommand } from '../_lib/notificationCommand';\n\nexport default defineServerCommand(notificationCommand);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type PoServerSessionPlugin } from '@agimon-ai/po-core/serverPlugin';\n\nimport commandNotify from '../src/extensions/workspaces/sessions/(backend)/command/notify.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const serverPlugin = defineServerPlugin({\n  name: '@agimon-ai/po-notification',\n  session: (context) => ({\n    get commands(): PoServerSessionPlugin['commands'] { return [via({ name: 'notify' }, at(commandNotify, context))]; },\n  }),\n});\n\nexport default serverPlugin;\n"],"mappings":";;;AAEA,MAAa,sBAAsB,cAAc;CAC/C,MAAM;CACN,aAAa;CACb,MAAM,QAAQ,MAAM,WAAW;EAC7B,MAAM,OAAO,KAAK,KAAK;EACvB,IAAI,MAAM,MAAM,UAAU,OAAO;GAAE;GAAM,OAAO;EAAO,CAAC;CAC1D;AACF,CAAC;;;ACLD,IAAA,wBAAe,oBAAoB,mBAAmB;;;ACEtD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,eAAe,mBAAmB;CAC7C,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,WAA8C;EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,SAAS,GAAG,GAAGA,uBAAe,OAAO,CAAC,CAAC;CAAG,EACpH;AACF,CAAC"}

package/dist/index.cjs

@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 let node_worker_threads = require("node:worker_threads");
 let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
-//#region src/services/shellTitleController/index.ts
+//#region src/services/shellTitleController/mainThread.ts
 const BRAILLE_FRAMES = [
 	"⠋",
 	"⠙",
@@ -37,39 +37,6 @@ const BRAILLE_FRAMES = [
 	"⠇",
 	"⠏"
 ];
-const TITLE_FRAME_INTERVAL_MS = 80;
-/**
-* The animator runs off the main thread so a busy agent turn cannot stall the
-* spinner. It is an inline eval source rather than a shipped file because the
-* package is bundled per entry, and a separate worker module would have to be
-* located on disk at runtime.
-*/
-const TITLE_WORKER_SOURCE = `
-const { writeSync } = require('node:fs');
-const { parentPort, workerData } = require('node:worker_threads');
-let frameIndex = 0;
-let timer;
-const writeTitle = (title) => writeSync(1, '\\u001b]0;' + title + '\\u0007');
-const stop = () => {
-  if (timer) clearInterval(timer);
-  timer = undefined;
-  frameIndex = 0;
-};
-parentPort.on('message', (command) => {
-  stop();
-  if (command.action === 'start') {
-    const render = () => {
-      writeTitle(workerData.frames[frameIndex % workerData.frames.length] + ' ' + command.title);
-      frameIndex += 1;
-    };
-    render();
-    timer = setInterval(render, workerData.intervalMs);
-    return;
-  }
-  writeTitle(command.title);
-  if (command.action === 'dispose') parentPort.close();
-});
-`;
 /** Animates on the main thread, for hosts where a worker could not be started. */
 function createMainThreadTitleController() {
 	let frameIndex = 0;
@@ -91,7 +58,7 @@ function createMainThreadTitleController() {
 				frameIndex += 1;
 			};
 			render();
-			timer = setInterval(render, TITLE_FRAME_INTERVAL_MS);
+			timer = setInterval(render, 80);
 		},
 		stop(title, write) {
 			stopAnimation();
@@ -103,6 +70,40 @@ function createMainThreadTitleController() {
 		}
 	};
 }
+//#endregion
+//#region src/services/shellTitleController/index.ts
+/**
+* The animator runs off the main thread so a busy agent turn cannot stall the
+* spinner. It is an inline eval source rather than a shipped file because the
+* package is bundled per entry, and a separate worker module would have to be
+* located on disk at runtime.
+*/
+const TITLE_WORKER_SOURCE = `
+const { writeSync } = require('node:fs');
+const { parentPort, workerData } = require('node:worker_threads');
+let frameIndex = 0;
+let timer;
+const writeTitle = (title) => writeSync(1, '\\u001b]0;' + title + '\\u0007');
+const stop = () => {
+  if (timer) clearInterval(timer);
+  timer = undefined;
+  frameIndex = 0;
+};
+parentPort.on('message', (command) => {
+  stop();
+  if (command.action === 'start') {
+    const render = () => {
+      writeTitle(workerData.frames[frameIndex % workerData.frames.length] + ' ' + command.title);
+      frameIndex += 1;
+    };
+    render();
+    timer = setInterval(render, workerData.intervalMs);
+    return;
+  }
+  writeTitle(command.title);
+  if (command.action === 'dispose') parentPort.close();
+});
+`;
 /**
 * Animates from a worker thread, replaying the last command on the main thread
 * if the worker never started, failed, or exited under us. The worker is
@@ -123,7 +124,7 @@ function createWorkerTitleController() {
 			eval: true,
 			workerData: {
 				frames: BRAILLE_FRAMES,
-				intervalMs: TITLE_FRAME_INTERVAL_MS
+				intervalMs: 80
 			}
 		});
 		titleWorker.unref();

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["Worker","path"],"sources":["../src/services/shellTitleController/index.ts","../src/services/notificationText/index.ts","../src/services/systemNotification/index.ts","../src/services/notificationPolicy/index.ts"],"sourcesContent":["import { Worker } from 'node:worker_threads';\n\nimport type { ShellTitleCommand, ShellTitleController, WriteTitle } from '../../types/notifications';\n\nconst BRAILLE_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];\nconst TITLE_FRAME_INTERVAL_MS = 80;\n/**\n * The animator runs off the main thread so a busy agent turn cannot stall the\n * spinner. It is an inline eval source rather than a shipped file because the\n * package is bundled per entry, and a separate worker module would have to be\n * located on disk at runtime.\n */\nconst TITLE_WORKER_SOURCE = `\nconst { writeSync } = require('node:fs');\nconst { parentPort, workerData } = require('node:worker_threads');\nlet frameIndex = 0;\nlet timer;\nconst writeTitle = (title) => writeSync(1, '\\\\u001b]0;' + title + '\\\\u0007');\nconst stop = () => {\n  if (timer) clearInterval(timer);\n  timer = undefined;\n  frameIndex = 0;\n};\nparentPort.on('message', (command) => {\n  stop();\n  if (command.action === 'start') {\n    const render = () => {\n      writeTitle(workerData.frames[frameIndex % workerData.frames.length] + ' ' + command.title);\n      frameIndex += 1;\n    };\n    render();\n    timer = setInterval(render, workerData.intervalMs);\n    return;\n  }\n  writeTitle(command.title);\n  if (command.action === 'dispose') parentPort.close();\n});\n`;\n\n/** Animates on the main thread, for hosts where a worker could not be started. */\nexport function createMainThreadTitleController(): ShellTitleController {\n  let frameIndex = 0;\n  let timer: ReturnType<typeof setInterval> | undefined;\n  const stopAnimation = () => {\n    if (timer) clearInterval(timer);\n    timer = undefined;\n    frameIndex = 0;\n  };\n\n  return {\n    set(title, write) {\n      stopAnimation();\n      write(title);\n    },\n    start(title, write) {\n      stopAnimation();\n      const render = () => {\n        write(`${BRAILLE_FRAMES[frameIndex % BRAILLE_FRAMES.length]} ${title}`);\n        frameIndex += 1;\n      };\n      render();\n      timer = setInterval(render, TITLE_FRAME_INTERVAL_MS);\n    },\n    stop(title, write) {\n      stopAnimation();\n      write(title);\n    },\n    dispose(title, write) {\n      stopAnimation();\n      write(title);\n    },\n  };\n}\n\n/**\n * Animates from a worker thread, replaying the last command on the main thread\n * if the worker never started, failed, or exited under us. The worker is\n * unreferenced so a pending frame never holds the process open.\n */\nexport function createWorkerTitleController(): ShellTitleController {\n  const fallback = createMainThreadTitleController();\n  let lastCommand: ShellTitleCommand | undefined;\n  let lastWrite: WriteTitle | undefined;\n  let worker: Worker | undefined;\n\n  const fallBack = () => {\n    worker = undefined;\n    if (!lastCommand || !lastWrite) return;\n    fallback[lastCommand.action](lastCommand.title, lastWrite);\n  };\n\n  try {\n    const titleWorker = new Worker(TITLE_WORKER_SOURCE, {\n      eval: true,\n      workerData: { frames: BRAILLE_FRAMES, intervalMs: TITLE_FRAME_INTERVAL_MS },\n    });\n    titleWorker.unref();\n    titleWorker.once('error', fallBack);\n    titleWorker.once('exit', (code) => {\n      if (code !== 0 && worker === titleWorker) fallBack();\n    });\n    worker = titleWorker;\n  } catch {\n    // Workers are unavailable on this host, which the main-thread animator covers.\n    worker = undefined;\n  }\n\n  const dispatch = (command: ShellTitleCommand, write: WriteTitle) => {\n    lastCommand = command;\n    lastWrite = write;\n    if (!worker) {\n      fallback[command.action](command.title, write);\n      return;\n    }\n    try {\n      worker.postMessage(command);\n    } catch {\n      // The worker closed between the last frame and this command.\n      fallBack();\n    }\n  };\n\n  return {\n    set: (title, write) => dispatch({ action: 'set', title }, write),\n    start: (title, write) => dispatch({ action: 'start', title }, write),\n    stop: (title, write) => dispatch({ action: 'stop', title }, write),\n    dispose: (title, write) => dispatch({ action: 'dispose', title }, write),\n  };\n}\n","import path from 'node:path';\n\nimport type { DesktopNotification } from '../../types/notifications';\n\nconst ATTENTION_SUBTITLE = 'Approval or feedback required';\nconst ATTENTION_TITLE = 'Pi needs your input';\nconst ELLIPSIS = '…';\nconst MAX_BODY_LENGTH = 240;\nconst MAX_PROMPT_TITLE_LENGTH = 36;\nconst SETTLED_BODY = 'The agent finished its work and is waiting for you.';\nconst SETTLED_TITLE = 'Pi finished';\nconst SHELL_TITLE_SEPARATOR = ' - ';\nconst SHELL_TITLE_PREFIX = 'π';\n\nfunction collapseWhitespace(value: string): string {\n  return value.replace(/\\s+/g, ' ').trim();\n}\n\nfunction truncate(value: string, maxLength: number): string {\n  return value.length > maxLength ? `${value.slice(0, maxLength - 1)}${ELLIPSIS}` : value;\n}\n\n/** The first user prompt, shortened to fit a shell tab. A blank prompt names nothing. */\nexport function promptTitle(prompt: string): string | undefined {\n  const normalized = collapseWhitespace(prompt);\n  return normalized ? truncate(normalized, MAX_PROMPT_TITLE_LENGTH) : undefined;\n}\n\nexport interface ShellTabTitleInput {\n  cwd: string;\n  sessionName?: string;\n  prompt?: string;\n}\n\n/**\n * The idle shell-tab title: `π - <label> - <repository>`.\n *\n * The session name wins over the first prompt because the user chose it. With\n * neither, the repository alone still tells two tabs apart.\n */\nexport function shellTabTitle({ cwd, sessionName, prompt }: ShellTabTitleInput): string {\n  const repository = path.basename(cwd);\n  const label = sessionName ?? prompt;\n  return label\n    ? `${SHELL_TITLE_PREFIX}${SHELL_TITLE_SEPARATOR}${label}${SHELL_TITLE_SEPARATOR}${repository}`\n    : `${SHELL_TITLE_PREFIX}${SHELL_TITLE_SEPARATOR}${repository}`;\n}\n\n/** Notification bodies are one line in a system panel, so they collapse and truncate. */\nexport function notificationBody(body: string): string {\n  return truncate(collapseWhitespace(body), MAX_BODY_LENGTH);\n}\n\n/** Sent while the agent holds the turn and something is blocking on the user. */\nexport function attentionNotification(body: string): DesktopNotification {\n  return { title: ATTENTION_TITLE, subtitle: ATTENTION_SUBTITLE, body };\n}\n\n/** Sent once a run has stopped, subtitled with whichever name the user recognises. */\nexport function settledNotification({ cwd, sessionName }: { cwd: string; sessionName?: string }): DesktopNotification {\n  return { title: SETTLED_TITLE, subtitle: sessionName ?? path.basename(cwd), body: SETTLED_BODY };\n}\n","import type { DesktopNotification, NotificationExecutor } from '../../types/notifications';\nimport { notificationBody } from '../notificationText';\n\nconst CMUX_COMMAND = 'cmux';\nconst COMMAND_TIMEOUT_MS = 3_000;\nconst DARWIN_PLATFORM = 'darwin';\nconst OSASCRIPT_COMMAND = 'osascript';\nconst OSASCRIPT_EXPRESSION_FLAG = '-e';\n\nasync function execute(pi: NotificationExecutor, command: string, args: string[]): Promise<boolean> {\n  try {\n    const result = await pi.exec(command, args, { timeout: COMMAND_TIMEOUT_MS });\n    return result.code === 0;\n  } catch {\n    // A notifier that is not installed is the ordinary case, not a fault: report\n    // \"not delivered\" and let the caller decide whether another one exists.\n    return false;\n  }\n}\n\n/**\n * Delivers one desktop notification on a best-effort basis.\n *\n * cmux is tried first because it routes the notification to the window the\n * session actually lives in. Only macOS has a second option worth attempting,\n * and a host with neither stays silent rather than failing the turn.\n */\nexport async function sendSystemNotification(\n  pi: NotificationExecutor,\n  notification: DesktopNotification,\n  platform: string = process.platform,\n): Promise<void> {\n  const body = notificationBody(notification.body);\n  const sentToCmux = await execute(pi, CMUX_COMMAND, [\n    'notify',\n    '--title',\n    notification.title,\n    '--subtitle',\n    notification.subtitle,\n    '--body',\n    body,\n  ]);\n  if (sentToCmux || platform !== DARWIN_PLATFORM) return;\n\n  await execute(pi, OSASCRIPT_COMMAND, [\n    OSASCRIPT_EXPRESSION_FLAG,\n    'on run argv',\n    OSASCRIPT_EXPRESSION_FLAG,\n    'display notification (item 3 of argv) with title (item 1 of argv) subtitle (item 2 of argv)',\n    OSASCRIPT_EXPRESSION_FLAG,\n    'end run',\n    notification.title,\n    notification.subtitle,\n    body,\n  ]);\n}\n","const DEFAULT_ASK_USER_BODY = 'The agent is waiting for your feedback.';\nconst RPC_MODE = 'rpc';\n\nexport interface AttentionState {\n  agentRunning: boolean;\n  askUserBlocked: boolean;\n}\n\nexport interface ShellSurface {\n  hasUI: boolean;\n  mode?: string;\n}\n\n/**\n * A dialog is worth interrupting the user for only while the agent holds the turn.\n *\n * Outside a run the user opened the dialog themselves and is already looking at\n * it. An ask-user prompt is announced by its own event, so the dialog it then\n * opens must stay silent or the same question notifies twice.\n */\nexport function warrantsAttentionNotification({ agentRunning, askUserBlocked }: AttentionState): boolean {\n  return agentRunning && !askUserBlocked;\n}\n\n/** A queued follow-up means the agent keeps working, so the run has not stopped for the user. */\nexport function warrantsSettledNotification(hasPendingMessages: boolean): boolean {\n  return !hasPendingMessages;\n}\n\n/** Terminal title escapes only mean something on an attached terminal; RPC output stays clean. */\nexport function supportsShellTitle({ hasUI, mode }: ShellSurface): boolean {\n  return hasUI && mode !== RPC_MODE;\n}\n\n/** The question an ask-user prompt is blocking on, or a stand-in when it asked none. */\nexport function askUserPromptBody(questions: readonly { question: string }[]): string {\n  return questions[0]?.question ?? DEFAULT_ASK_USER_BODY;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["Worker","path"],"sources":["../src/services/shellTitleController/mainThread.ts","../src/services/shellTitleController/index.ts","../src/services/notificationText/index.ts","../src/services/systemNotification/index.ts","../src/services/notificationPolicy/index.ts"],"sourcesContent":["import type { ShellTitleController } from '../../types/notifications';\n\nexport const BRAILLE_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];\nexport const TITLE_FRAME_INTERVAL_MS = 80;\n\n/** Animates on the main thread, for hosts where a worker could not be started. */\nexport function createMainThreadTitleController(): ShellTitleController {\n  let frameIndex = 0;\n  let timer: ReturnType<typeof setInterval> | undefined;\n  const stopAnimation = () => {\n    if (timer) clearInterval(timer);\n    timer = undefined;\n    frameIndex = 0;\n  };\n\n  return {\n    set(title, write) {\n      stopAnimation();\n      write(title);\n    },\n    start(title, write) {\n      stopAnimation();\n      const render = () => {\n        write(`${BRAILLE_FRAMES[frameIndex % BRAILLE_FRAMES.length]} ${title}`);\n        frameIndex += 1;\n      };\n      render();\n      timer = setInterval(render, TITLE_FRAME_INTERVAL_MS);\n    },\n    stop(title, write) {\n      stopAnimation();\n      write(title);\n    },\n    dispose(title, write) {\n      stopAnimation();\n      write(title);\n    },\n  };\n}\n","import { Worker } from 'node:worker_threads';\n\nimport type { ShellTitleCommand, ShellTitleController, WriteTitle } from '../../types/notifications';\nimport { BRAILLE_FRAMES, TITLE_FRAME_INTERVAL_MS, createMainThreadTitleController } from './mainThread';\n\nexport { createMainThreadTitleController } from './mainThread';\n/**\n * The animator runs off the main thread so a busy agent turn cannot stall the\n * spinner. It is an inline eval source rather than a shipped file because the\n * package is bundled per entry, and a separate worker module would have to be\n * located on disk at runtime.\n */\nconst TITLE_WORKER_SOURCE = `\nconst { writeSync } = require('node:fs');\nconst { parentPort, workerData } = require('node:worker_threads');\nlet frameIndex = 0;\nlet timer;\nconst writeTitle = (title) => writeSync(1, '\\\\u001b]0;' + title + '\\\\u0007');\nconst stop = () => {\n  if (timer) clearInterval(timer);\n  timer = undefined;\n  frameIndex = 0;\n};\nparentPort.on('message', (command) => {\n  stop();\n  if (command.action === 'start') {\n    const render = () => {\n      writeTitle(workerData.frames[frameIndex % workerData.frames.length] + ' ' + command.title);\n      frameIndex += 1;\n    };\n    render();\n    timer = setInterval(render, workerData.intervalMs);\n    return;\n  }\n  writeTitle(command.title);\n  if (command.action === 'dispose') parentPort.close();\n});\n`;\n\n/**\n * Animates from a worker thread, replaying the last command on the main thread\n * if the worker never started, failed, or exited under us. The worker is\n * unreferenced so a pending frame never holds the process open.\n */\nexport function createWorkerTitleController(): ShellTitleController {\n  const fallback = createMainThreadTitleController();\n  let lastCommand: ShellTitleCommand | undefined;\n  let lastWrite: WriteTitle | undefined;\n  let worker: Worker | undefined;\n\n  const fallBack = () => {\n    worker = undefined;\n    if (!lastCommand || !lastWrite) return;\n    fallback[lastCommand.action](lastCommand.title, lastWrite);\n  };\n\n  try {\n    const titleWorker = new Worker(TITLE_WORKER_SOURCE, {\n      eval: true,\n      workerData: { frames: BRAILLE_FRAMES, intervalMs: TITLE_FRAME_INTERVAL_MS },\n    });\n    titleWorker.unref();\n    titleWorker.once('error', fallBack);\n    titleWorker.once('exit', (code) => {\n      if (code !== 0 && worker === titleWorker) fallBack();\n    });\n    worker = titleWorker;\n  } catch {\n    // Workers are unavailable on this host, which the main-thread animator covers.\n    worker = undefined;\n  }\n\n  const dispatch = (command: ShellTitleCommand, write: WriteTitle) => {\n    lastCommand = command;\n    lastWrite = write;\n    if (!worker) {\n      fallback[command.action](command.title, write);\n      return;\n    }\n    try {\n      worker.postMessage(command);\n    } catch {\n      // The worker closed between the last frame and this command.\n      fallBack();\n    }\n  };\n\n  return {\n    set: (title, write) => dispatch({ action: 'set', title }, write),\n    start: (title, write) => dispatch({ action: 'start', title }, write),\n    stop: (title, write) => dispatch({ action: 'stop', title }, write),\n    dispose: (title, write) => dispatch({ action: 'dispose', title }, write),\n  };\n}\n","import path from 'node:path';\n\nimport type { DesktopNotification } from '../../types/notifications';\n\nconst ATTENTION_SUBTITLE = 'Approval or feedback required';\nconst ATTENTION_TITLE = 'Pi needs your input';\nconst ELLIPSIS = '…';\nconst MAX_BODY_LENGTH = 240;\nconst MAX_PROMPT_TITLE_LENGTH = 36;\nconst SETTLED_BODY = 'The agent finished its work and is waiting for you.';\nconst SETTLED_TITLE = 'Pi finished';\nconst SHELL_TITLE_SEPARATOR = ' - ';\nconst SHELL_TITLE_PREFIX = 'π';\n\nfunction collapseWhitespace(value: string): string {\n  return value.replace(/\\s+/g, ' ').trim();\n}\n\nfunction truncate(value: string, maxLength: number): string {\n  return value.length > maxLength ? `${value.slice(0, maxLength - 1)}${ELLIPSIS}` : value;\n}\n\n/** The first user prompt, shortened to fit a shell tab. A blank prompt names nothing. */\nexport function promptTitle(prompt: string): string | undefined {\n  const normalized = collapseWhitespace(prompt);\n  return normalized ? truncate(normalized, MAX_PROMPT_TITLE_LENGTH) : undefined;\n}\n\nexport interface ShellTabTitleInput {\n  cwd: string;\n  sessionName?: string;\n  prompt?: string;\n}\n\n/**\n * The idle shell-tab title: `π - <label> - <repository>`.\n *\n * The session name wins over the first prompt because the user chose it. With\n * neither, the repository alone still tells two tabs apart.\n */\nexport function shellTabTitle({ cwd, sessionName, prompt }: ShellTabTitleInput): string {\n  const repository = path.basename(cwd);\n  const label = sessionName ?? prompt;\n  return label\n    ? `${SHELL_TITLE_PREFIX}${SHELL_TITLE_SEPARATOR}${label}${SHELL_TITLE_SEPARATOR}${repository}`\n    : `${SHELL_TITLE_PREFIX}${SHELL_TITLE_SEPARATOR}${repository}`;\n}\n\n/** Notification bodies are one line in a system panel, so they collapse and truncate. */\nexport function notificationBody(body: string): string {\n  return truncate(collapseWhitespace(body), MAX_BODY_LENGTH);\n}\n\n/** Sent while the agent holds the turn and something is blocking on the user. */\nexport function attentionNotification(body: string): DesktopNotification {\n  return { title: ATTENTION_TITLE, subtitle: ATTENTION_SUBTITLE, body };\n}\n\n/** Sent once a run has stopped, subtitled with whichever name the user recognises. */\nexport function settledNotification({ cwd, sessionName }: { cwd: string; sessionName?: string }): DesktopNotification {\n  return { title: SETTLED_TITLE, subtitle: sessionName ?? path.basename(cwd), body: SETTLED_BODY };\n}\n","import type { DesktopNotification, NotificationExecutor } from '../../types/notifications';\nimport { notificationBody } from '../notificationText';\n\nconst CMUX_COMMAND = 'cmux';\nconst COMMAND_TIMEOUT_MS = 3_000;\nconst DARWIN_PLATFORM = 'darwin';\nconst OSASCRIPT_COMMAND = 'osascript';\nconst OSASCRIPT_EXPRESSION_FLAG = '-e';\n\nasync function execute(pi: NotificationExecutor, command: string, args: string[]): Promise<boolean> {\n  try {\n    const result = await pi.exec(command, args, { timeout: COMMAND_TIMEOUT_MS });\n    return result.code === 0;\n  } catch {\n    // A notifier that is not installed is the ordinary case, not a fault: report\n    // \"not delivered\" and let the caller decide whether another one exists.\n    return false;\n  }\n}\n\n/**\n * Delivers one desktop notification on a best-effort basis.\n *\n * cmux is tried first because it routes the notification to the window the\n * session actually lives in. Only macOS has a second option worth attempting,\n * and a host with neither stays silent rather than failing the turn.\n */\nexport async function sendSystemNotification(\n  pi: NotificationExecutor,\n  notification: DesktopNotification,\n  platform: string = process.platform,\n): Promise<void> {\n  const body = notificationBody(notification.body);\n  const sentToCmux = await execute(pi, CMUX_COMMAND, [\n    'notify',\n    '--title',\n    notification.title,\n    '--subtitle',\n    notification.subtitle,\n    '--body',\n    body,\n  ]);\n  if (sentToCmux || platform !== DARWIN_PLATFORM) return;\n\n  await execute(pi, OSASCRIPT_COMMAND, [\n    OSASCRIPT_EXPRESSION_FLAG,\n    'on run argv',\n    OSASCRIPT_EXPRESSION_FLAG,\n    'display notification (item 3 of argv) with title (item 1 of argv) subtitle (item 2 of argv)',\n    OSASCRIPT_EXPRESSION_FLAG,\n    'end run',\n    notification.title,\n    notification.subtitle,\n    body,\n  ]);\n}\n","const DEFAULT_ASK_USER_BODY = 'The agent is waiting for your feedback.';\nconst RPC_MODE = 'rpc';\n\nexport interface AttentionState {\n  agentRunning: boolean;\n  askUserBlocked: boolean;\n}\n\nexport interface ShellSurface {\n  hasUI: boolean;\n  mode?: string;\n}\n\n/**\n * A dialog is worth interrupting the user for only while the agent holds the turn.\n *\n * Outside a run the user opened the dialog themselves and is already looking at\n * it. An ask-user prompt is announced by its own event, so the dialog it then\n * opens must stay silent or the same question notifies twice.\n */\nexport function warrantsAttentionNotification({ agentRunning, askUserBlocked }: AttentionState): boolean {\n  return agentRunning && !askUserBlocked;\n}\n\n/** A queued follow-up means the agent keeps working, so the run has not stopped for the user. */\nexport function warrantsSettledNotification(hasPendingMessages: boolean): boolean {\n  return !hasPendingMessages;\n}\n\n/** Terminal title escapes only mean something on an attached terminal; RPC output stays clean. */\nexport function supportsShellTitle({ hasUI, mode }: ShellSurface): boolean {\n  return hasUI && mode !== RPC_MODE;\n}\n\n/** The question an ask-user prompt is blocking on, or a stand-in when it asked none. */\nexport function askUserPromptBody(questions: readonly { question: string }[]): string {\n  return questions[0]?.question ?? DEFAULT_ASK_USER_BODY;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,MAAa,iBAAiB;CAAC;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;AAAG;;AAI/E,SAAgB,kCAAwD;CACtE,IAAI,aAAa;CACjB,IAAI;CACJ,MAAM,sBAAsB;EAC1B,IAAI,OAAO,cAAc,KAAK;EAC9B,QAAQ,KAAA;EACR,aAAa;CACf;CAEA,OAAO;EACL,IAAI,OAAO,OAAO;GAChB,cAAc;GACd,MAAM,KAAK;EACb;EACA,MAAM,OAAO,OAAO;GAClB,cAAc;GACd,MAAM,eAAe;IACnB,MAAM,GAAG,eAAe,aAAa,eAAe,QAAQ,GAAG,OAAO;IACtE,cAAc;GAChB;GACA,OAAO;GACP,QAAQ,YAAY,QAAA,EAA+B;EACrD;EACA,KAAK,OAAO,OAAO;GACjB,cAAc;GACd,MAAM,KAAK;EACb;EACA,QAAQ,OAAO,OAAO;GACpB,cAAc;GACd,MAAM,KAAK;EACb;CACF;AACF;;;;;;;;;AC1BA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgC5B,SAAgB,8BAAoD;CAClE,MAAM,WAAW,gCAAgC;CACjD,IAAI;CACJ,IAAI;CACJ,IAAI;CAEJ,MAAM,iBAAiB;EACrB,SAAS,KAAA;EACT,IAAI,CAAC,eAAe,CAAC,WAAW;EAChC,SAAS,YAAY,OAAO,CAAC,YAAY,OAAO,SAAS;CAC3D;CAEA,IAAI;EACF,MAAM,cAAc,IAAIA,oBAAAA,OAAO,qBAAqB;GAClD,MAAM;GACN,YAAY;IAAE,QAAQ;IAAgB,YAAA;GAAoC;EAC5E,CAAC;EACD,YAAY,MAAM;EAClB,YAAY,KAAK,SAAS,QAAQ;EAClC,YAAY,KAAK,SAAS,SAAS;GACjC,IAAI,SAAS,KAAK,WAAW,aAAa,SAAS;EACrD,CAAC;EACD,SAAS;CACX,QAAQ;EAEN,SAAS,KAAA;CACX;CAEA,MAAM,YAAY,SAA4B,UAAsB;EAClE,cAAc;EACd,YAAY;EACZ,IAAI,CAAC,QAAQ;GACX,SAAS,QAAQ,OAAO,CAAC,QAAQ,OAAO,KAAK;GAC7C;EACF;EACA,IAAI;GACF,OAAO,YAAY,OAAO;EAC5B,QAAQ;GAEN,SAAS;EACX;CACF;CAEA,OAAO;EACL,MAAM,OAAO,UAAU,SAAS;GAAE,QAAQ;GAAO;EAAM,GAAG,KAAK;EAC/D,QAAQ,OAAO,UAAU,SAAS;GAAE,QAAQ;GAAS;EAAM,GAAG,KAAK;EACnE,OAAO,OAAO,UAAU,SAAS;GAAE,QAAQ;GAAQ;EAAM,GAAG,KAAK;EACjE,UAAU,OAAO,UAAU,SAAS;GAAE,QAAQ;GAAW;EAAM,GAAG,KAAK;CACzE;AACF;;;ACzFA,MAAM,qBAAqB;AAC3B,MAAM,kBAAkB;AACxB,MAAM,WAAW;AACjB,MAAM,kBAAkB;AACxB,MAAM,0BAA0B;AAChC,MAAM,eAAe;AACrB,MAAM,gBAAgB;AACtB,MAAM,wBAAwB;AAC9B,MAAM,qBAAqB;AAE3B,SAAS,mBAAmB,OAAuB;CACjD,OAAO,MAAM,QAAQ,QAAQ,GAAG,CAAC,CAAC,KAAK;AACzC;AAEA,SAAS,SAAS,OAAe,WAA2B;CAC1D,OAAO,MAAM,SAAS,YAAY,GAAG,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,aAAa;AACpF;;AAGA,SAAgB,YAAY,QAAoC;CAC9D,MAAM,aAAa,mBAAmB,MAAM;CAC5C,OAAO,aAAa,SAAS,YAAY,uBAAuB,IAAI,KAAA;AACtE;;;;;;;AAcA,SAAgB,cAAc,EAAE,KAAK,aAAa,UAAsC;CACtF,MAAM,aAAaC,UAAAA,QAAK,SAAS,GAAG;CACpC,MAAM,QAAQ,eAAe;CAC7B,OAAO,QACH,GAAG,qBAAqB,wBAAwB,QAAQ,wBAAwB,eAChF,GAAG,qBAAqB,wBAAwB;AACtD;;AAGA,SAAgB,iBAAiB,MAAsB;CACrD,OAAO,SAAS,mBAAmB,IAAI,GAAG,eAAe;AAC3D;;AAGA,SAAgB,sBAAsB,MAAmC;CACvE,OAAO;EAAE,OAAO;EAAiB,UAAU;EAAoB;CAAK;AACtE;;AAGA,SAAgB,oBAAoB,EAAE,KAAK,eAA2E;CACpH,OAAO;EAAE,OAAO;EAAe,UAAU,eAAeA,UAAAA,QAAK,SAAS,GAAG;EAAG,MAAM;CAAa;AACjG;;;AC1DA,MAAM,eAAe;AACrB,MAAM,qBAAqB;AAC3B,MAAM,kBAAkB;AACxB,MAAM,oBAAoB;AAC1B,MAAM,4BAA4B;AAElC,eAAe,QAAQ,IAA0B,SAAiB,MAAkC;CAClG,IAAI;EAEF,QAAO,MADc,GAAG,KAAK,SAAS,MAAM,EAAE,SAAS,mBAAmB,CAAC,EAAA,CAC7D,SAAS;CACzB,QAAQ;EAGN,OAAO;CACT;AACF;;;;;;;;AASA,eAAsB,uBACpB,IACA,cACA,WAAmB,QAAQ,UACZ;CACf,MAAM,OAAO,iBAAiB,aAAa,IAAI;CAU/C,IAAI,MATqB,QAAQ,IAAI,cAAc;EACjD;EACA;EACA,aAAa;EACb;EACA,aAAa;EACb;EACA;CACF,CAAC,KACiB,aAAa,iBAAiB;CAEhD,MAAM,QAAQ,IAAI,mBAAmB;EACnC;EACA;EACA;EACA;EACA;EACA;EACA,aAAa;EACb,aAAa;EACb;CACF,CAAC;AACH;;;ACvDA,MAAM,wBAAwB;AAC9B,MAAM,WAAW;;;;;;;;AAmBjB,SAAgB,8BAA8B,EAAE,cAAc,kBAA2C;CACvG,OAAO,gBAAgB,CAAC;AAC1B;;AAGA,SAAgB,4BAA4B,oBAAsC;CAChF,OAAO,CAAC;AACV;;AAGA,SAAgB,mBAAmB,EAAE,OAAO,QAA+B;CACzE,OAAO,SAAS,SAAS;AAC3B;;AAGA,SAAgB,kBAAkB,WAAoD;CACpF,OAAO,UAAU,EAAE,EAAE,YAAY;AACnC"}

package/dist/index.d.mts

@@ -41,9 +41,11 @@ interface DesktopNotification {
   body: string;
 }
 //#endregion
-//#region src/services/shellTitleController/index.d.ts
+//#region src/services/shellTitleController/mainThread.d.ts
 /** Animates on the main thread, for hosts where a worker could not be started. */
 export declare function createMainThreadTitleController(): ShellTitleController;
+//#endregion
+//#region src/services/shellTitleController/index.d.ts
 /**
  * Animates from a worker thread, replaying the last command on the main thread
  * if the worker never started, failed, or exited under us. The worker is

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/notifications.ts","../src/services/shellTitleController/index.ts","../src/services/systemNotification/index.ts","../src/services/notificationPolicy/index.ts","../src/services/notificationText/index.ts"],"mappings":";UAAiB;;EAEf,kBAAkB;EAClB,cAAc,OAAO;;UAGN;EACf,KAAK,iBAAiB,gBAAgB;IAAW;MAAoB;IAAU;;;;KAIrE,cAAc;;KAGd;;UAGK;EACf,QAAQ;EACR;;;;;;;;;;UAWe;EACf,IAAI,eAAe,OAAO;EAC1B,MAAM,eAAe,OAAO;EAC5B,KAAK,eAAe,OAAO;EAC3B,QAAQ,eAAe,OAAO;;;UAIf;EACf;EACA;EACA;;;;;wBCDc,mCAAmC;;;;;;wBAuCnC,+BAA+B;;;;;;;;;;wBCpDzB,uBACpB,IAAI,sBACJ,cAAc,qBACd,oBACC;;;UC5Bc;EACf;EACA;;UAGe;EACf;EACA;;;;;;;;;wBAUc,gCAAgC,cAAc,kBAAkB;;wBAKhE,4BAA4B;;wBAK5B,qBAAqB,OAAO,QAAQ;;wBAKpC,kBAAkB;EAAsB;;;;;wBCZxC,YAAY;UAKX;EACf;EACA;EACA;;;;;;;;wBASc,gBAAgB,KAAK,aAAa,UAAU;;wBAS5C,iBAAiB;;wBAKjB,sBAAsB,eAAe;;wBAKrC,sBAAsB,KAAK;EAAiB;EAAa;IAAyB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/notifications.ts","../src/services/shellTitleController/mainThread.ts","../src/services/shellTitleController/index.ts","../src/services/systemNotification/index.ts","../src/services/notificationPolicy/index.ts","../src/services/notificationText/index.ts"],"mappings":";UAAiB;;EAEf,kBAAkB;EAClB,cAAc,OAAO;;UAGN;EACf,KAAK,iBAAiB,gBAAgB;IAAW;MAAoB;IAAU;;;;KAIrE,cAAc;;KAGd;;UAGK;EACf,QAAQ;EACR;;;;;;;;;;UAWe;EACf,IAAI,eAAe,OAAO;EAC1B,MAAM,eAAe,OAAO;EAC5B,KAAK,eAAe,OAAO;EAC3B,QAAQ,eAAe,OAAO;;;UAIf;EACf;EACA;EACA;;;;;wBCnCc,mCAAmC;;;;;;;;wBCsCnC,+BAA+B;;;;;;;;;;wBCjBzB,uBACpB,IAAI,sBACJ,cAAc,qBACd,oBACC;;;UC5Bc;EACf;EACA;;UAGe;EACf;EACA;;;;;;;;;wBAUc,gCAAgC,cAAc,kBAAkB;;wBAKhE,4BAA4B;;wBAK5B,qBAAqB,OAAO,QAAQ;;wBAKpC,kBAAkB;EAAsB;;;;;wBCZxC,YAAY;UAKX;EACf;EACA;EACA;;;;;;;;wBASc,gBAAgB,KAAK,aAAa,UAAU;;wBAS5C,iBAAiB;;wBAKjB,sBAAsB,eAAe;;wBAKrC,sBAAsB,KAAK;EAAiB;EAAa;IAAyB"}

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { Worker } from "node:worker_threads";
 import path from "node:path";
-//#region src/services/shellTitleController/index.ts
+//#region src/services/shellTitleController/mainThread.ts
 const BRAILLE_FRAMES = [
 	"⠋",
 	"⠙",
@@ -13,39 +13,6 @@ const BRAILLE_FRAMES = [
 	"⠇",
 	"⠏"
 ];
-const TITLE_FRAME_INTERVAL_MS = 80;
-/**
-* The animator runs off the main thread so a busy agent turn cannot stall the
-* spinner. It is an inline eval source rather than a shipped file because the
-* package is bundled per entry, and a separate worker module would have to be
-* located on disk at runtime.
-*/
-const TITLE_WORKER_SOURCE = `
-const { writeSync } = require('node:fs');
-const { parentPort, workerData } = require('node:worker_threads');
-let frameIndex = 0;
-let timer;
-const writeTitle = (title) => writeSync(1, '\\u001b]0;' + title + '\\u0007');
-const stop = () => {
-  if (timer) clearInterval(timer);
-  timer = undefined;
-  frameIndex = 0;
-};
-parentPort.on('message', (command) => {
-  stop();
-  if (command.action === 'start') {
-    const render = () => {
-      writeTitle(workerData.frames[frameIndex % workerData.frames.length] + ' ' + command.title);
-      frameIndex += 1;
-    };
-    render();
-    timer = setInterval(render, workerData.intervalMs);
-    return;
-  }
-  writeTitle(command.title);
-  if (command.action === 'dispose') parentPort.close();
-});
-`;
 /** Animates on the main thread, for hosts where a worker could not be started. */
 function createMainThreadTitleController() {
 	let frameIndex = 0;
@@ -67,7 +34,7 @@ function createMainThreadTitleController() {
 				frameIndex += 1;
 			};
 			render();
-			timer = setInterval(render, TITLE_FRAME_INTERVAL_MS);
+			timer = setInterval(render, 80);
 		},
 		stop(title, write) {
 			stopAnimation();
@@ -79,6 +46,40 @@ function createMainThreadTitleController() {
 		}
 	};
 }
+//#endregion
+//#region src/services/shellTitleController/index.ts
+/**
+* The animator runs off the main thread so a busy agent turn cannot stall the
+* spinner. It is an inline eval source rather than a shipped file because the
+* package is bundled per entry, and a separate worker module would have to be
+* located on disk at runtime.
+*/
+const TITLE_WORKER_SOURCE = `
+const { writeSync } = require('node:fs');
+const { parentPort, workerData } = require('node:worker_threads');
+let frameIndex = 0;
+let timer;
+const writeTitle = (title) => writeSync(1, '\\u001b]0;' + title + '\\u0007');
+const stop = () => {
+  if (timer) clearInterval(timer);
+  timer = undefined;
+  frameIndex = 0;
+};
+parentPort.on('message', (command) => {
+  stop();
+  if (command.action === 'start') {
+    const render = () => {
+      writeTitle(workerData.frames[frameIndex % workerData.frames.length] + ' ' + command.title);
+      frameIndex += 1;
+    };
+    render();
+    timer = setInterval(render, workerData.intervalMs);
+    return;
+  }
+  writeTitle(command.title);
+  if (command.action === 'dispose') parentPort.close();
+});
+`;
 /**
 * Animates from a worker thread, replaying the last command on the main thread
 * if the worker never started, failed, or exited under us. The worker is
@@ -99,7 +100,7 @@ function createWorkerTitleController() {
 			eval: true,
 			workerData: {
 				frames: BRAILLE_FRAMES,
-				intervalMs: TITLE_FRAME_INTERVAL_MS
+				intervalMs: 80
 			}
 		});
 		titleWorker.unref();

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/services/shellTitleController/index.ts","../src/services/notificationText/index.ts","../src/services/systemNotification/index.ts","../src/services/notificationPolicy/index.ts"],"sourcesContent":["import { Worker } from 'node:worker_threads';\n\nimport type { ShellTitleCommand, ShellTitleController, WriteTitle } from '../../types/notifications';\n\nconst BRAILLE_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];\nconst TITLE_FRAME_INTERVAL_MS = 80;\n/**\n * The animator runs off the main thread so a busy agent turn cannot stall the\n * spinner. It is an inline eval source rather than a shipped file because the\n * package is bundled per entry, and a separate worker module would have to be\n * located on disk at runtime.\n */\nconst TITLE_WORKER_SOURCE = `\nconst { writeSync } = require('node:fs');\nconst { parentPort, workerData } = require('node:worker_threads');\nlet frameIndex = 0;\nlet timer;\nconst writeTitle = (title) => writeSync(1, '\\\\u001b]0;' + title + '\\\\u0007');\nconst stop = () => {\n  if (timer) clearInterval(timer);\n  timer = undefined;\n  frameIndex = 0;\n};\nparentPort.on('message', (command) => {\n  stop();\n  if (command.action === 'start') {\n    const render = () => {\n      writeTitle(workerData.frames[frameIndex % workerData.frames.length] + ' ' + command.title);\n      frameIndex += 1;\n    };\n    render();\n    timer = setInterval(render, workerData.intervalMs);\n    return;\n  }\n  writeTitle(command.title);\n  if (command.action === 'dispose') parentPort.close();\n});\n`;\n\n/** Animates on the main thread, for hosts where a worker could not be started. */\nexport function createMainThreadTitleController(): ShellTitleController {\n  let frameIndex = 0;\n  let timer: ReturnType<typeof setInterval> | undefined;\n  const stopAnimation = () => {\n    if (timer) clearInterval(timer);\n    timer = undefined;\n    frameIndex = 0;\n  };\n\n  return {\n    set(title, write) {\n      stopAnimation();\n      write(title);\n    },\n    start(title, write) {\n      stopAnimation();\n      const render = () => {\n        write(`${BRAILLE_FRAMES[frameIndex % BRAILLE_FRAMES.length]} ${title}`);\n        frameIndex += 1;\n      };\n      render();\n      timer = setInterval(render, TITLE_FRAME_INTERVAL_MS);\n    },\n    stop(title, write) {\n      stopAnimation();\n      write(title);\n    },\n    dispose(title, write) {\n      stopAnimation();\n      write(title);\n    },\n  };\n}\n\n/**\n * Animates from a worker thread, replaying the last command on the main thread\n * if the worker never started, failed, or exited under us. The worker is\n * unreferenced so a pending frame never holds the process open.\n */\nexport function createWorkerTitleController(): ShellTitleController {\n  const fallback = createMainThreadTitleController();\n  let lastCommand: ShellTitleCommand | undefined;\n  let lastWrite: WriteTitle | undefined;\n  let worker: Worker | undefined;\n\n  const fallBack = () => {\n    worker = undefined;\n    if (!lastCommand || !lastWrite) return;\n    fallback[lastCommand.action](lastCommand.title, lastWrite);\n  };\n\n  try {\n    const titleWorker = new Worker(TITLE_WORKER_SOURCE, {\n      eval: true,\n      workerData: { frames: BRAILLE_FRAMES, intervalMs: TITLE_FRAME_INTERVAL_MS },\n    });\n    titleWorker.unref();\n    titleWorker.once('error', fallBack);\n    titleWorker.once('exit', (code) => {\n      if (code !== 0 && worker === titleWorker) fallBack();\n    });\n    worker = titleWorker;\n  } catch {\n    // Workers are unavailable on this host, which the main-thread animator covers.\n    worker = undefined;\n  }\n\n  const dispatch = (command: ShellTitleCommand, write: WriteTitle) => {\n    lastCommand = command;\n    lastWrite = write;\n    if (!worker) {\n      fallback[command.action](command.title, write);\n      return;\n    }\n    try {\n      worker.postMessage(command);\n    } catch {\n      // The worker closed between the last frame and this command.\n      fallBack();\n    }\n  };\n\n  return {\n    set: (title, write) => dispatch({ action: 'set', title }, write),\n    start: (title, write) => dispatch({ action: 'start', title }, write),\n    stop: (title, write) => dispatch({ action: 'stop', title }, write),\n    dispose: (title, write) => dispatch({ action: 'dispose', title }, write),\n  };\n}\n","import path from 'node:path';\n\nimport type { DesktopNotification } from '../../types/notifications';\n\nconst ATTENTION_SUBTITLE = 'Approval or feedback required';\nconst ATTENTION_TITLE = 'Pi needs your input';\nconst ELLIPSIS = '…';\nconst MAX_BODY_LENGTH = 240;\nconst MAX_PROMPT_TITLE_LENGTH = 36;\nconst SETTLED_BODY = 'The agent finished its work and is waiting for you.';\nconst SETTLED_TITLE = 'Pi finished';\nconst SHELL_TITLE_SEPARATOR = ' - ';\nconst SHELL_TITLE_PREFIX = 'π';\n\nfunction collapseWhitespace(value: string): string {\n  return value.replace(/\\s+/g, ' ').trim();\n}\n\nfunction truncate(value: string, maxLength: number): string {\n  return value.length > maxLength ? `${value.slice(0, maxLength - 1)}${ELLIPSIS}` : value;\n}\n\n/** The first user prompt, shortened to fit a shell tab. A blank prompt names nothing. */\nexport function promptTitle(prompt: string): string | undefined {\n  const normalized = collapseWhitespace(prompt);\n  return normalized ? truncate(normalized, MAX_PROMPT_TITLE_LENGTH) : undefined;\n}\n\nexport interface ShellTabTitleInput {\n  cwd: string;\n  sessionName?: string;\n  prompt?: string;\n}\n\n/**\n * The idle shell-tab title: `π - <label> - <repository>`.\n *\n * The session name wins over the first prompt because the user chose it. With\n * neither, the repository alone still tells two tabs apart.\n */\nexport function shellTabTitle({ cwd, sessionName, prompt }: ShellTabTitleInput): string {\n  const repository = path.basename(cwd);\n  const label = sessionName ?? prompt;\n  return label\n    ? `${SHELL_TITLE_PREFIX}${SHELL_TITLE_SEPARATOR}${label}${SHELL_TITLE_SEPARATOR}${repository}`\n    : `${SHELL_TITLE_PREFIX}${SHELL_TITLE_SEPARATOR}${repository}`;\n}\n\n/** Notification bodies are one line in a system panel, so they collapse and truncate. */\nexport function notificationBody(body: string): string {\n  return truncate(collapseWhitespace(body), MAX_BODY_LENGTH);\n}\n\n/** Sent while the agent holds the turn and something is blocking on the user. */\nexport function attentionNotification(body: string): DesktopNotification {\n  return { title: ATTENTION_TITLE, subtitle: ATTENTION_SUBTITLE, body };\n}\n\n/** Sent once a run has stopped, subtitled with whichever name the user recognises. */\nexport function settledNotification({ cwd, sessionName }: { cwd: string; sessionName?: string }): DesktopNotification {\n  return { title: SETTLED_TITLE, subtitle: sessionName ?? path.basename(cwd), body: SETTLED_BODY };\n}\n","import type { DesktopNotification, NotificationExecutor } from '../../types/notifications';\nimport { notificationBody } from '../notificationText';\n\nconst CMUX_COMMAND = 'cmux';\nconst COMMAND_TIMEOUT_MS = 3_000;\nconst DARWIN_PLATFORM = 'darwin';\nconst OSASCRIPT_COMMAND = 'osascript';\nconst OSASCRIPT_EXPRESSION_FLAG = '-e';\n\nasync function execute(pi: NotificationExecutor, command: string, args: string[]): Promise<boolean> {\n  try {\n    const result = await pi.exec(command, args, { timeout: COMMAND_TIMEOUT_MS });\n    return result.code === 0;\n  } catch {\n    // A notifier that is not installed is the ordinary case, not a fault: report\n    // \"not delivered\" and let the caller decide whether another one exists.\n    return false;\n  }\n}\n\n/**\n * Delivers one desktop notification on a best-effort basis.\n *\n * cmux is tried first because it routes the notification to the window the\n * session actually lives in. Only macOS has a second option worth attempting,\n * and a host with neither stays silent rather than failing the turn.\n */\nexport async function sendSystemNotification(\n  pi: NotificationExecutor,\n  notification: DesktopNotification,\n  platform: string = process.platform,\n): Promise<void> {\n  const body = notificationBody(notification.body);\n  const sentToCmux = await execute(pi, CMUX_COMMAND, [\n    'notify',\n    '--title',\n    notification.title,\n    '--subtitle',\n    notification.subtitle,\n    '--body',\n    body,\n  ]);\n  if (sentToCmux || platform !== DARWIN_PLATFORM) return;\n\n  await execute(pi, OSASCRIPT_COMMAND, [\n    OSASCRIPT_EXPRESSION_FLAG,\n    'on run argv',\n    OSASCRIPT_EXPRESSION_FLAG,\n    'display notification (item 3 of argv) with title (item 1 of argv) subtitle (item 2 of argv)',\n    OSASCRIPT_EXPRESSION_FLAG,\n    'end run',\n    notification.title,\n    notification.subtitle,\n    body,\n  ]);\n}\n","const DEFAULT_ASK_USER_BODY = 'The agent is waiting for your feedback.';\nconst RPC_MODE = 'rpc';\n\nexport interface AttentionState {\n  agentRunning: boolean;\n  askUserBlocked: boolean;\n}\n\nexport interface ShellSurface {\n  hasUI: boolean;\n  mode?: string;\n}\n\n/**\n * A dialog is worth interrupting the user for only while the agent holds the turn.\n *\n * Outside a run the user opened the dialog themselves and is already looking at\n * it. An ask-user prompt is announced by its own event, so the dialog it then\n * opens must stay silent or the same question notifies twice.\n */\nexport function warrantsAttentionNotification({ agentRunning, askUserBlocked }: AttentionState): boolean {\n  return agentRunning && !askUserBlocked;\n}\n\n/** A queued follow-up means the agent keeps working, so the run has not stopped for the user. */\nexport function warrantsSettledNotification(hasPendingMessages: boolean): boolean {\n  return !hasPendingMessages;\n}\n\n/** Terminal title escapes only mean something on an attached terminal; RPC output stays clean. */\nexport function supportsShellTitle({ hasUI, mode }: ShellSurface): boolean {\n  return hasUI && mode !== RPC_MODE;\n}\n\n/** The question an ask-user prompt is blocking on, or a stand-in when it asked none. */\nexport function askUserPromptBody(questions: readonly { question: string }[]): string {\n  return questions[0]?.question ?? DEFAULT_ASK_USER_BODY;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/services/shellTitleController/mainThread.ts","../src/services/shellTitleController/index.ts","../src/services/notificationText/index.ts","../src/services/systemNotification/index.ts","../src/services/notificationPolicy/index.ts"],"sourcesContent":["import type { ShellTitleController } from '../../types/notifications';\n\nexport const BRAILLE_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];\nexport const TITLE_FRAME_INTERVAL_MS = 80;\n\n/** Animates on the main thread, for hosts where a worker could not be started. */\nexport function createMainThreadTitleController(): ShellTitleController {\n  let frameIndex = 0;\n  let timer: ReturnType<typeof setInterval> | undefined;\n  const stopAnimation = () => {\n    if (timer) clearInterval(timer);\n    timer = undefined;\n    frameIndex = 0;\n  };\n\n  return {\n    set(title, write) {\n      stopAnimation();\n      write(title);\n    },\n    start(title, write) {\n      stopAnimation();\n      const render = () => {\n        write(`${BRAILLE_FRAMES[frameIndex % BRAILLE_FRAMES.length]} ${title}`);\n        frameIndex += 1;\n      };\n      render();\n      timer = setInterval(render, TITLE_FRAME_INTERVAL_MS);\n    },\n    stop(title, write) {\n      stopAnimation();\n      write(title);\n    },\n    dispose(title, write) {\n      stopAnimation();\n      write(title);\n    },\n  };\n}\n","import { Worker } from 'node:worker_threads';\n\nimport type { ShellTitleCommand, ShellTitleController, WriteTitle } from '../../types/notifications';\nimport { BRAILLE_FRAMES, TITLE_FRAME_INTERVAL_MS, createMainThreadTitleController } from './mainThread';\n\nexport { createMainThreadTitleController } from './mainThread';\n/**\n * The animator runs off the main thread so a busy agent turn cannot stall the\n * spinner. It is an inline eval source rather than a shipped file because the\n * package is bundled per entry, and a separate worker module would have to be\n * located on disk at runtime.\n */\nconst TITLE_WORKER_SOURCE = `\nconst { writeSync } = require('node:fs');\nconst { parentPort, workerData } = require('node:worker_threads');\nlet frameIndex = 0;\nlet timer;\nconst writeTitle = (title) => writeSync(1, '\\\\u001b]0;' + title + '\\\\u0007');\nconst stop = () => {\n  if (timer) clearInterval(timer);\n  timer = undefined;\n  frameIndex = 0;\n};\nparentPort.on('message', (command) => {\n  stop();\n  if (command.action === 'start') {\n    const render = () => {\n      writeTitle(workerData.frames[frameIndex % workerData.frames.length] + ' ' + command.title);\n      frameIndex += 1;\n    };\n    render();\n    timer = setInterval(render, workerData.intervalMs);\n    return;\n  }\n  writeTitle(command.title);\n  if (command.action === 'dispose') parentPort.close();\n});\n`;\n\n/**\n * Animates from a worker thread, replaying the last command on the main thread\n * if the worker never started, failed, or exited under us. The worker is\n * unreferenced so a pending frame never holds the process open.\n */\nexport function createWorkerTitleController(): ShellTitleController {\n  const fallback = createMainThreadTitleController();\n  let lastCommand: ShellTitleCommand | undefined;\n  let lastWrite: WriteTitle | undefined;\n  let worker: Worker | undefined;\n\n  const fallBack = () => {\n    worker = undefined;\n    if (!lastCommand || !lastWrite) return;\n    fallback[lastCommand.action](lastCommand.title, lastWrite);\n  };\n\n  try {\n    const titleWorker = new Worker(TITLE_WORKER_SOURCE, {\n      eval: true,\n      workerData: { frames: BRAILLE_FRAMES, intervalMs: TITLE_FRAME_INTERVAL_MS },\n    });\n    titleWorker.unref();\n    titleWorker.once('error', fallBack);\n    titleWorker.once('exit', (code) => {\n      if (code !== 0 && worker === titleWorker) fallBack();\n    });\n    worker = titleWorker;\n  } catch {\n    // Workers are unavailable on this host, which the main-thread animator covers.\n    worker = undefined;\n  }\n\n  const dispatch = (command: ShellTitleCommand, write: WriteTitle) => {\n    lastCommand = command;\n    lastWrite = write;\n    if (!worker) {\n      fallback[command.action](command.title, write);\n      return;\n    }\n    try {\n      worker.postMessage(command);\n    } catch {\n      // The worker closed between the last frame and this command.\n      fallBack();\n    }\n  };\n\n  return {\n    set: (title, write) => dispatch({ action: 'set', title }, write),\n    start: (title, write) => dispatch({ action: 'start', title }, write),\n    stop: (title, write) => dispatch({ action: 'stop', title }, write),\n    dispose: (title, write) => dispatch({ action: 'dispose', title }, write),\n  };\n}\n","import path from 'node:path';\n\nimport type { DesktopNotification } from '../../types/notifications';\n\nconst ATTENTION_SUBTITLE = 'Approval or feedback required';\nconst ATTENTION_TITLE = 'Pi needs your input';\nconst ELLIPSIS = '…';\nconst MAX_BODY_LENGTH = 240;\nconst MAX_PROMPT_TITLE_LENGTH = 36;\nconst SETTLED_BODY = 'The agent finished its work and is waiting for you.';\nconst SETTLED_TITLE = 'Pi finished';\nconst SHELL_TITLE_SEPARATOR = ' - ';\nconst SHELL_TITLE_PREFIX = 'π';\n\nfunction collapseWhitespace(value: string): string {\n  return value.replace(/\\s+/g, ' ').trim();\n}\n\nfunction truncate(value: string, maxLength: number): string {\n  return value.length > maxLength ? `${value.slice(0, maxLength - 1)}${ELLIPSIS}` : value;\n}\n\n/** The first user prompt, shortened to fit a shell tab. A blank prompt names nothing. */\nexport function promptTitle(prompt: string): string | undefined {\n  const normalized = collapseWhitespace(prompt);\n  return normalized ? truncate(normalized, MAX_PROMPT_TITLE_LENGTH) : undefined;\n}\n\nexport interface ShellTabTitleInput {\n  cwd: string;\n  sessionName?: string;\n  prompt?: string;\n}\n\n/**\n * The idle shell-tab title: `π - <label> - <repository>`.\n *\n * The session name wins over the first prompt because the user chose it. With\n * neither, the repository alone still tells two tabs apart.\n */\nexport function shellTabTitle({ cwd, sessionName, prompt }: ShellTabTitleInput): string {\n  const repository = path.basename(cwd);\n  const label = sessionName ?? prompt;\n  return label\n    ? `${SHELL_TITLE_PREFIX}${SHELL_TITLE_SEPARATOR}${label}${SHELL_TITLE_SEPARATOR}${repository}`\n    : `${SHELL_TITLE_PREFIX}${SHELL_TITLE_SEPARATOR}${repository}`;\n}\n\n/** Notification bodies are one line in a system panel, so they collapse and truncate. */\nexport function notificationBody(body: string): string {\n  return truncate(collapseWhitespace(body), MAX_BODY_LENGTH);\n}\n\n/** Sent while the agent holds the turn and something is blocking on the user. */\nexport function attentionNotification(body: string): DesktopNotification {\n  return { title: ATTENTION_TITLE, subtitle: ATTENTION_SUBTITLE, body };\n}\n\n/** Sent once a run has stopped, subtitled with whichever name the user recognises. */\nexport function settledNotification({ cwd, sessionName }: { cwd: string; sessionName?: string }): DesktopNotification {\n  return { title: SETTLED_TITLE, subtitle: sessionName ?? path.basename(cwd), body: SETTLED_BODY };\n}\n","import type { DesktopNotification, NotificationExecutor } from '../../types/notifications';\nimport { notificationBody } from '../notificationText';\n\nconst CMUX_COMMAND = 'cmux';\nconst COMMAND_TIMEOUT_MS = 3_000;\nconst DARWIN_PLATFORM = 'darwin';\nconst OSASCRIPT_COMMAND = 'osascript';\nconst OSASCRIPT_EXPRESSION_FLAG = '-e';\n\nasync function execute(pi: NotificationExecutor, command: string, args: string[]): Promise<boolean> {\n  try {\n    const result = await pi.exec(command, args, { timeout: COMMAND_TIMEOUT_MS });\n    return result.code === 0;\n  } catch {\n    // A notifier that is not installed is the ordinary case, not a fault: report\n    // \"not delivered\" and let the caller decide whether another one exists.\n    return false;\n  }\n}\n\n/**\n * Delivers one desktop notification on a best-effort basis.\n *\n * cmux is tried first because it routes the notification to the window the\n * session actually lives in. Only macOS has a second option worth attempting,\n * and a host with neither stays silent rather than failing the turn.\n */\nexport async function sendSystemNotification(\n  pi: NotificationExecutor,\n  notification: DesktopNotification,\n  platform: string = process.platform,\n): Promise<void> {\n  const body = notificationBody(notification.body);\n  const sentToCmux = await execute(pi, CMUX_COMMAND, [\n    'notify',\n    '--title',\n    notification.title,\n    '--subtitle',\n    notification.subtitle,\n    '--body',\n    body,\n  ]);\n  if (sentToCmux || platform !== DARWIN_PLATFORM) return;\n\n  await execute(pi, OSASCRIPT_COMMAND, [\n    OSASCRIPT_EXPRESSION_FLAG,\n    'on run argv',\n    OSASCRIPT_EXPRESSION_FLAG,\n    'display notification (item 3 of argv) with title (item 1 of argv) subtitle (item 2 of argv)',\n    OSASCRIPT_EXPRESSION_FLAG,\n    'end run',\n    notification.title,\n    notification.subtitle,\n    body,\n  ]);\n}\n","const DEFAULT_ASK_USER_BODY = 'The agent is waiting for your feedback.';\nconst RPC_MODE = 'rpc';\n\nexport interface AttentionState {\n  agentRunning: boolean;\n  askUserBlocked: boolean;\n}\n\nexport interface ShellSurface {\n  hasUI: boolean;\n  mode?: string;\n}\n\n/**\n * A dialog is worth interrupting the user for only while the agent holds the turn.\n *\n * Outside a run the user opened the dialog themselves and is already looking at\n * it. An ask-user prompt is announced by its own event, so the dialog it then\n * opens must stay silent or the same question notifies twice.\n */\nexport function warrantsAttentionNotification({ agentRunning, askUserBlocked }: AttentionState): boolean {\n  return agentRunning && !askUserBlocked;\n}\n\n/** A queued follow-up means the agent keeps working, so the run has not stopped for the user. */\nexport function warrantsSettledNotification(hasPendingMessages: boolean): boolean {\n  return !hasPendingMessages;\n}\n\n/** Terminal title escapes only mean something on an attached terminal; RPC output stays clean. */\nexport function supportsShellTitle({ hasUI, mode }: ShellSurface): boolean {\n  return hasUI && mode !== RPC_MODE;\n}\n\n/** The question an ask-user prompt is blocking on, or a stand-in when it asked none. */\nexport function askUserPromptBody(questions: readonly { question: string }[]): string {\n  return questions[0]?.question ?? DEFAULT_ASK_USER_BODY;\n}\n"],"mappings":"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"}

package/llms.txt

@@ -1,7 +1,7 @@
-# Doom Pi Notification
+# Po Pi Notification
 
-Shared notification routing, browser and system delivery, and an animated shell-tab title for Doom Pi sessions.
+Shared notification routing, browser and system delivery, and an animated shell-tab title for Po Pi sessions.
 
 ## Resources
 
-- [Package README](./README.md): public `doom/notification` service usage, request defaults, RPC and interactive delivery, live-page browser permission behavior, shell-title animation, and silent fallback rules.
+- [Package README](./README.md): public `po/notification` service usage, request defaults, RPC and interactive delivery, live-page browser permission behavior, shell-title animation, and silent fallback rules.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/po-notification",
-  "version": "0.0.0-alpha.2",
+  "version": "0.0.0-alpha.20",
   "description": "Desktop notifications and an animated shell-tab title for Po sessions.",
   "keywords": [
     "ai",
@@ -60,21 +60,21 @@
     "access": "public"
   },
   "dependencies": {
-    "@agimon-ai/po-core": "0.0.0-alpha.2",
-    "@deepseek-ai/cordis": "4.0.4"
+    "@agimon-ai/po-core": "0.0.0-alpha.20",
+    "@deepseek-ai/cordis": "4.0.5"
   },
   "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.2",
-    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.0-alpha.2",
-    "@earendil-works/pi-coding-agent": "1.2.0",
-    "@types/node": "26.6.4",
-    "@vitest/coverage-v8": "5.0.3",
-    "tsdown": "0.23.0",
+    "@agimon-ai/po-build": "0.0.0-alpha.20",
+    "@agimon-ai/vibe-lint-plugin-po-extension": "0.0.0-alpha.20",
+    "@earendil-works/pi-coding-agent": "1.3.0",
+    "@types/node": "26.6.5",
+    "@vitest/coverage-v8": "5.0.4",
+    "tsdown": "0.23.1",
     "typescript": "7.0.2",
-    "vitest": "5.0.3"
+    "vitest": "5.0.4"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "1.2.0"
+    "@earendil-works/pi-coding-agent": "1.3.0"
   },
   "peerDependenciesMeta": {
     "@earendil-works/pi-coding-agent": {