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

package/LICENSE

@@ -1,21 +1,149 @@
-MIT License
-
-Copyright (c) 2026 Vuong Ngo
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+License text copyright © 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Parameters
+
+Licensor:             Agimon Pty Ltd
+Licensed Work:        Po, the software in the Po source repository and the
+                      packages released from it, in each version released by
+                      the Licensor.
+                      The Licensed Work is (c) 2026 Agimon Pty Ltd.
+                      Material identified as third-party in the "Third-party
+                      components" section at the end of this file or in a
+                      NOTICE file, and any package or directory whose own
+                      license file grants a different license, is not part of
+                      the Licensed Work and remains under its own license.
+Additional Use Grant: You may make production use of the Licensed Work if
+  your use is Eligible Use. "Eligible Use" is production use that falls
+  within at least one of the following:
+
+  (a) Personal Use. Use by an individual for their own personal purposes,
+      and not on behalf of, or for the benefit of, an employer, client, or
+      other Organization. Use by an individual in the course of employment
+      or engagement by an Organization is use by that Organization.
+
+  (b) Small Organization Use. Use by or on behalf of an Organization whose
+      Annual Revenue is less than USD 1,000,000.
+
+  (c) Non-profit, Education and Research Use. Use, regardless of Annual
+      Revenue, by (i) an Organization registered or recognized as a
+      non-profit or charitable organization under the laws of its
+      jurisdiction, for its non-profit purposes; (ii) an accredited school,
+      college, or university, for teaching, learning, or academic research;
+      or (iii) a publicly funded research institution, for its research.
+
+  (d) Service Provider Use. Use by a consultant, contractor, agency, or other
+      service provider, regardless of its own Annual Revenue, solely to
+      build, deploy, host, operate, or support the Licensed Work for a client
+      whose own use would be Eligible Use under (a), (b), or (c). A service
+      provider's use for its own purposes is Eligible Use only if the service
+      provider itself qualifies under (b) or (c).
+
+
+  Hosted services. Offering the Licensed Work to third parties as a hosted
+  or managed service whose primary value is the Licensed Work is Eligible
+  Use only if each such third party's own use would be Eligible Use.
+
+  Definitions. "Organization" means any company, partnership, sole
+  proprietorship, trust, association, government body, or other entity, and
+  includes an individual acting in a business or professional capacity.
+  "Affiliate" means any entity that directly or indirectly controls, is
+  controlled by, or is under common control with an Organization, where
+  "control" means ownership of more than 50% of the voting interests of an
+  entity or the power to direct its management and policies by contract or
+  otherwise. "Annual Revenue" means the total gross revenue of an
+  Organization and all of its Affiliates combined, from all sources and
+  whether or not related to the Licensed Work, for its most recently
+  completed fiscal year, or, if it has not completed a fiscal year, for the
+  twelve months before the use (or since its formation, if shorter),
+  converted into US dollars at the average exchange rate for that period.
+  Proceeds of equity or debt financing are not revenue.
+
+  Threshold. If an Organization stops qualifying under (b), its existing
+  production use remains Eligible Use for 90 days after it stops
+  qualifying, after which it must obtain a commercial license or stop
+  production use. Use that was Eligible Use when it occurred never requires
+  a commercial license after the fact.
+Change Date:          Four years from the date a version of the Licensed Work
+                      is first publicly released by the Licensor.
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed
+Work, please visit: https://agimon.ai/licensing
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark “Business Source License”,
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the “Business
+Source License” name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where “compatible” means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text “None”.
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

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',
   });
@@ -93,4 +93,4 @@ acquiring a Cordis connection, leaving notification ownership with the parent.
 
 ## License
 
-MIT
+Business Source License 1.1: free for personal use, organisations under USD 1M revenue, non-profits and education. See [LICENSE](LICENSE) and https://agimon.ai/licensing.

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":"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"}

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.21",
   "description": "Desktop notifications and an animated shell-tab title for Po sessions.",
   "keywords": [
     "ai",
@@ -19,7 +19,7 @@
   "bugs": {
     "url": "https://github.com/AgiFlow/po/issues"
   },
-  "license": "MIT",
+  "license": "BUSL-1.1",
   "author": "Vuong Ngo",
   "repository": {
     "type": "git",
@@ -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.21",
+    "@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.21",
+    "@agimon-ai/vibe-lint-plugin-po-extension": "0.0.0-alpha.21",
+    "@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": {