@agimon-ai/po-notification 0.0.0-alpha.1 → 0.0.0-stage

package/README.md

@@ -1,96 +1,3 @@
-# @agimon-ai/po-notification
+# Temporary Holding Version
 
-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,
-routes each request for the active session, and announces when the agent needs attention.
-
-## What it does
-
-| 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                |
-| 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
-failure stays silent and never falls back to a host notifier. Hosts without a supported notifier also
-stay silent.
-
-## Service usage
-
-Callers should discover the optional service through Cordis and request delivery without depending on
-a particular host:
-
-```ts
-import { DOOM_NOTIFICATION_SERVICE, readDoomNotificationService } from '@agimon-ai/po-core/notification';
-
-ctx.inject([DOOM_NOTIFICATION_SERVICE], (notificationContext) => {
-  void readDoomNotificationService(notificationContext)?.request({
-    body: 'Deployment needs approval',
-    level: 'warning',
-  });
-});
-```
-
-`body` is required. `title`, `subtitle`, and `level` are optional, and `level` accepts `info`,
-`warning`, or `error`. The router defaults the title to `Pi`, the subtitle to the session name or
-working-directory basename, and the level to `info`. Invalid requests, missing active sessions,
-unavailable providers, and delivery failures are silent so notifications cannot fail an agent turn.
-
-The package also wraps Pi's broad `ui.notify(message, level)` API while active, so existing extensions
-use the same route without changing their calls. If this package is muted or the process is a detached
-subagent child, it does not install that wrapper and Pi's original `ui.notify` behavior remains.
-
-## Browser delivery
-
-`po-web` shows full notification text only for entries received by a currently open page. Every connected
-page receives live notification entries for every attached session, not only the focused session. Permission
-is requested only from an explicit settings action.
-
-A paired installed PWA may also opt into live Web Push while closed. That payload is fixed generic copy with
-`TTL: 0`; it contains no session, prompt, response, or file data. The host keeps subscriptions only in memory,
-so there is no durable database, outbox, replay, or delivery of historical entries. The open app re-registers
-a browser-held subscription after a host restart. Device revocation or expiry, remote shutdown, browser
-disable, and expired provider endpoints remove the live subscription.
-
-## The shell title
-
-The title is animated from a worker thread, so a busy agent turn never stalls the spinner. The
-worker is unreferenced, so a pending frame cannot hold the process open. If worker threads are
-unavailable, or the worker fails or exits, the last command replays on the main thread.
-
-Titles are only written to an attached terminal: `rpc` sessions and headless ones get none, so
-escape sequences never end up in machine-read output.
-
-## Quiet by design
-
-- A detached subagent (`PI_SUBAGENT_CHILD`) does not register this package's service or wrappers. It
-  shares its parent's terminal and desktop, and a second voice reporting the same run is noise.
-- Dialogs only notify while the agent holds the turn. A dialog the user opened is already in front
-  of them.
-- An `ask_user_question` prompt notifies from its own event, and the dialog it then opens stays
-  silent, so one question is announced once.
-- A settled run with pending follow-up messages notifies nothing: the agent is about to keep going.
-
-## Installation
-
-Po depends on this package and activates it as fixed host core, so a Po install already has
-it. It is not selectable from `.po/modes.yaml`.
-
-The Pi and server loaders use `/extensions/pi` and `/extensions/server`, built directly from
-`src/extensions`. The root export contains reusable notification helpers and types.
-Controllers own delivery and UI integration; policy and text services live in named service folders.
-
-The Pi declaration installs its router and optional session binding before handling events.
-`onStop` restores the original UI methods and shell title before service registrations are removed.
-`onDispose` provides the same cleanup after partial startup. Detached children return before
-acquiring a Cordis connection, leaving notification ownership with the parent.
-
-## License
-
-MIT
+This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/package.json

@@ -1,105 +1,6 @@
 {
   "name": "@agimon-ai/po-notification",
-  "version": "0.0.0-alpha.1",
-  "description": "Desktop notifications and an animated shell-tab title for Po sessions.",
-  "keywords": [
-    "ai",
-    "coding-agent",
-    "desktop-notifications",
-    "developer-tools",
-    "notifications",
-    "pi-coding-agent",
-    "pi-extension",
-    "pi-package",
-    "po",
-    "shell-title",
-    "terminal-title"
-  ],
-  "homepage": "https://agimon.ai",
-  "bugs": {
-    "url": "https://github.com/AgiFlow/po/issues"
-  },
-  "license": "MIT",
-  "author": "Vuong Ngo",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/AgiFlow/po.git",
-    "directory": "packages/foundations/po-notification"
-  },
-  "files": [
-    "dist",
-    "llms.txt",
-    "README.md",
-    "LICENSE",
-    "package.json"
-  ],
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
-  "jsnext:main": "./dist/index.mjs",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.mts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
-    },
-    "./apiContracts": {
-      "types": "./dist/apiContracts.d.mts",
-      "import": "./dist/apiContracts.mjs",
-      "require": "./dist/apiContracts.cjs"
-    },
-    "./extensions/server": {
-      "types": "./dist/extensions/server.d.mts",
-      "import": "./dist/extensions/server.mjs",
-      "require": "./dist/extensions/server.cjs"
-    },
-    "./package.json": "./package.json"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@agimon-ai/po-core": "0.0.0-alpha.1",
-    "@deepseek-ai/cordis": "4.0.4"
-  },
-  "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.1",
-    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.0-alpha.1",
-    "@earendil-works/pi-coding-agent": "1.0.2",
-    "@types/node": "26.6.4",
-    "@vitest/coverage-v8": "5.0.3",
-    "tsdown": "0.23.0",
-    "typescript": "7.0.2",
-    "vitest": "5.0.3"
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "1.0.2"
-  },
-  "peerDependenciesMeta": {
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    }
-  },
-  "engines": {
-    "node": ">=24"
-  },
-  "poServer": {
-    "entry": "./generated/server.ts",
-    "dist": "./dist/extensions/server.mjs",
-    "scopes": [
-      "session"
-    ],
-    "contracts": {
-      "entry": "./src/exports/apiContracts.ts",
-      "dist": "./dist/apiContracts.mjs"
-    }
-  },
-  "scripts": {
-    "build": "tsdown",
-    "test": "vitest --run",
-    "typecheck": "tsc --noEmit",
-    "lint": "oxlint . && oxfmt . --check",
-    "fixcode": "oxlint . --fix && oxfmt ."
-  }
+  "version": "0.0.0-stage",
+  "stub": true,
+  "description": "Temporary package placeholder for staged publishing"
 }

package/LICENSE

@@ -1,21 +0,0 @@
-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.

package/dist/apiContracts.cjs

@@ -1,17 +0,0 @@
-Object.defineProperties(exports, {
-	__esModule: { value: true },
-	[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. */
-const apiContracts = (0, require("@agimon-ai/po-core/apiContracts").defineApiContract)({
-	version: 1,
-	http: [],
-	sockets: [],
-	dynamic: []
-});
-//#endregion
-exports.apiContracts = apiContracts;
-exports.default = apiContracts;
-
-//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -1 +0,0 @@
-{"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"}

package/dist/apiContracts.d.mts

@@ -1,53 +0,0 @@
-//#region src/schemas/apiContracts.d.ts
-/** This facet 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;
-  schemas?: Record<string, boolean | object> | undefined;
-  http: {
-    id: string;
-    scope: "global" | "session" | "workspace";
-    basePath?: string | undefined;
-    path: string;
-    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
-    description: string;
-    availability?: string | undefined;
-    authentication: "device" | "none" | "owner";
-    parameters?: {
-      name: string;
-      in: "header" | "path" | "query";
-      required: boolean;
-      schema: boolean | object;
-    }[] | undefined;
-    body?: {
-      contentType: string;
-      contentTypes?: string[] | undefined;
-      required: boolean;
-      schema: boolean | object;
-    } | undefined;
-    responses: Record<string, {
-      description: string;
-      contentType?: string | undefined;
-      schema?: boolean | object | undefined;
-      events?: Record<string, boolean | object> | undefined;
-    }>;
-  }[];
-  sockets: {
-    id: string;
-    scope: "global" | "session" | "workspace";
-    description: string;
-    availability?: string | undefined;
-    service: string;
-    member: string;
-    direction: "client-to-server" | "server-to-client";
-    kind: "channel" | "method" | "state";
-    input: boolean | object;
-    output?: boolean | object | undefined;
-    errors?: boolean | object | undefined;
-  }[];
-  dynamic: string[];
-  gaps?: string[] | undefined;
-};
-//#endregion
-export { apiContracts as default };
-//# sourceMappingURL=apiContracts.d.mts.map

package/dist/apiContracts.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBAGa"}

package/dist/apiContracts.mjs

@@ -1,13 +0,0 @@
-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. */
-const apiContracts = defineApiContract({
-	version: 1,
-	http: [],
-	sockets: [],
-	dynamic: []
-});
-//#endregion
-export { apiContracts, apiContracts as default };
-
-//# sourceMappingURL=apiContracts.mjs.map

package/dist/apiContracts.mjs.map

@@ -1 +0,0 @@
-{"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"}

package/dist/extensions/server.cjs

@@ -1,39 +0,0 @@
-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_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)({
-	name: "notify",
-	description: "Send a notification through the active headless client.",
-	async execute(args, execution) {
-		const body = args.trim();
-		if (body) await execution.notify({
-			body,
-			level: "info"
-		});
-	}
-});
-//#endregion
-//#region src/extensions/workspaces/sessions/(backend)/command/notify.server.ts
-var notify_server_default = (0, _agimon_ai_po_core_extensionFile.defineServerCommand)(notificationCommand);
-//#endregion
-//#region generated/server.ts
-const at = (value, context) => typeof value === "function" ? value(context) : value;
-const via = (identity, value) => value === void 0 ? void 0 : {
-	...identity,
-	...value
-};
-const facet = (0, _agimon_ai_po_core_serverFacet.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;
-
-//# sourceMappingURL=server.cjs.map

package/dist/extensions/server.cjs.map

@@ -1 +0,0 @@
-{"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"}

package/dist/extensions/server.d.mts

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

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

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

package/dist/extensions/server.mjs

@@ -1,34 +0,0 @@
-import { defineCommand, defineServerPlugin } from "@agimon-ai/po-core/serverFacet";
-import { defineServerCommand } from "@agimon-ai/po-core/extensionFile";
-//#region src/extensions/workspaces/sessions/(backend)/_lib/notificationCommand.ts
-const notificationCommand = defineCommand({
-	name: "notify",
-	description: "Send a notification through the active headless client.",
-	async execute(args, execution) {
-		const body = args.trim();
-		if (body) await execution.notify({
-			body,
-			level: "info"
-		});
-	}
-});
-//#endregion
-//#region src/extensions/workspaces/sessions/(backend)/command/notify.server.ts
-var notify_server_default = defineServerCommand(notificationCommand);
-//#endregion
-//#region generated/server.ts
-const at = (value, context) => typeof value === "function" ? value(context) : value;
-const via = (identity, value) => value === void 0 ? void 0 : {
-	...identity,
-	...value
-};
-const facet = 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 };
-
-//# sourceMappingURL=server.mjs.map

package/dist/extensions/server.mjs.map

@@ -1 +0,0 @@
-{"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"}

package/dist/index.cjs

@@ -1,307 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-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
-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;
-	let timer;
-	const stopAnimation = () => {
-		if (timer) clearInterval(timer);
-		timer = void 0;
-		frameIndex = 0;
-	};
-	return {
-		set(title, write) {
-			stopAnimation();
-			write(title);
-		},
-		start(title, write) {
-			stopAnimation();
-			const render = () => {
-				write(`${BRAILLE_FRAMES[frameIndex % BRAILLE_FRAMES.length]} ${title}`);
-				frameIndex += 1;
-			};
-			render();
-			timer = setInterval(render, TITLE_FRAME_INTERVAL_MS);
-		},
-		stop(title, write) {
-			stopAnimation();
-			write(title);
-		},
-		dispose(title, write) {
-			stopAnimation();
-			write(title);
-		}
-	};
-}
-/**
-* 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
-* unreferenced so a pending frame never holds the process open.
-*/
-function createWorkerTitleController() {
-	const fallback = createMainThreadTitleController();
-	let lastCommand;
-	let lastWrite;
-	let worker;
-	const fallBack = () => {
-		worker = void 0;
-		if (!lastCommand || !lastWrite) return;
-		fallback[lastCommand.action](lastCommand.title, lastWrite);
-	};
-	try {
-		const titleWorker = new node_worker_threads.Worker(TITLE_WORKER_SOURCE, {
-			eval: true,
-			workerData: {
-				frames: BRAILLE_FRAMES,
-				intervalMs: TITLE_FRAME_INTERVAL_MS
-			}
-		});
-		titleWorker.unref();
-		titleWorker.once("error", fallBack);
-		titleWorker.once("exit", (code) => {
-			if (code !== 0 && worker === titleWorker) fallBack();
-		});
-		worker = titleWorker;
-	} catch {
-		worker = void 0;
-	}
-	const dispatch = (command, write) => {
-		lastCommand = command;
-		lastWrite = write;
-		if (!worker) {
-			fallback[command.action](command.title, write);
-			return;
-		}
-		try {
-			worker.postMessage(command);
-		} catch {
-			fallBack();
-		}
-	};
-	return {
-		set: (title, write) => dispatch({
-			action: "set",
-			title
-		}, write),
-		start: (title, write) => dispatch({
-			action: "start",
-			title
-		}, write),
-		stop: (title, write) => dispatch({
-			action: "stop",
-			title
-		}, write),
-		dispose: (title, write) => dispatch({
-			action: "dispose",
-			title
-		}, write)
-	};
-}
-//#endregion
-//#region src/services/notificationText/index.ts
-const ATTENTION_SUBTITLE = "Approval or feedback required";
-const ATTENTION_TITLE = "Pi needs your input";
-const ELLIPSIS = "…";
-const MAX_BODY_LENGTH = 240;
-const MAX_PROMPT_TITLE_LENGTH = 36;
-const SETTLED_BODY = "The agent finished its work and is waiting for you.";
-const SETTLED_TITLE = "Pi finished";
-const SHELL_TITLE_SEPARATOR = " - ";
-const SHELL_TITLE_PREFIX = "π";
-function collapseWhitespace(value) {
-	return value.replace(/\s+/g, " ").trim();
-}
-function truncate(value, maxLength) {
-	return value.length > maxLength ? `${value.slice(0, maxLength - 1)}${ELLIPSIS}` : value;
-}
-/** The first user prompt, shortened to fit a shell tab. A blank prompt names nothing. */
-function promptTitle(prompt) {
-	const normalized = collapseWhitespace(prompt);
-	return normalized ? truncate(normalized, MAX_PROMPT_TITLE_LENGTH) : void 0;
-}
-/**
-* The idle shell-tab title: `π - <label> - <repository>`.
-*
-* The session name wins over the first prompt because the user chose it. With
-* neither, the repository alone still tells two tabs apart.
-*/
-function shellTabTitle({ cwd, sessionName, prompt }) {
-	const repository = node_path.default.basename(cwd);
-	const label = sessionName ?? prompt;
-	return label ? `${SHELL_TITLE_PREFIX}${SHELL_TITLE_SEPARATOR}${label}${SHELL_TITLE_SEPARATOR}${repository}` : `${SHELL_TITLE_PREFIX}${SHELL_TITLE_SEPARATOR}${repository}`;
-}
-/** Notification bodies are one line in a system panel, so they collapse and truncate. */
-function notificationBody(body) {
-	return truncate(collapseWhitespace(body), MAX_BODY_LENGTH);
-}
-/** Sent while the agent holds the turn and something is blocking on the user. */
-function attentionNotification(body) {
-	return {
-		title: ATTENTION_TITLE,
-		subtitle: ATTENTION_SUBTITLE,
-		body
-	};
-}
-/** Sent once a run has stopped, subtitled with whichever name the user recognises. */
-function settledNotification({ cwd, sessionName }) {
-	return {
-		title: SETTLED_TITLE,
-		subtitle: sessionName ?? node_path.default.basename(cwd),
-		body: SETTLED_BODY
-	};
-}
-//#endregion
-//#region src/services/systemNotification/index.ts
-const CMUX_COMMAND = "cmux";
-const COMMAND_TIMEOUT_MS = 3e3;
-const DARWIN_PLATFORM = "darwin";
-const OSASCRIPT_COMMAND = "osascript";
-const OSASCRIPT_EXPRESSION_FLAG = "-e";
-async function execute(pi, command, args) {
-	try {
-		return (await pi.exec(command, args, { timeout: COMMAND_TIMEOUT_MS })).code === 0;
-	} catch {
-		return false;
-	}
-}
-/**
-* Delivers one desktop notification on a best-effort basis.
-*
-* cmux is tried first because it routes the notification to the window the
-* session actually lives in. Only macOS has a second option worth attempting,
-* and a host with neither stays silent rather than failing the turn.
-*/
-async function sendSystemNotification(pi, notification, platform = process.platform) {
-	const body = notificationBody(notification.body);
-	if (await execute(pi, CMUX_COMMAND, [
-		"notify",
-		"--title",
-		notification.title,
-		"--subtitle",
-		notification.subtitle,
-		"--body",
-		body
-	]) || platform !== DARWIN_PLATFORM) return;
-	await execute(pi, OSASCRIPT_COMMAND, [
-		OSASCRIPT_EXPRESSION_FLAG,
-		"on run argv",
-		OSASCRIPT_EXPRESSION_FLAG,
-		"display notification (item 3 of argv) with title (item 1 of argv) subtitle (item 2 of argv)",
-		OSASCRIPT_EXPRESSION_FLAG,
-		"end run",
-		notification.title,
-		notification.subtitle,
-		body
-	]);
-}
-//#endregion
-//#region src/services/notificationPolicy/index.ts
-const DEFAULT_ASK_USER_BODY = "The agent is waiting for your feedback.";
-const RPC_MODE = "rpc";
-/**
-* A dialog is worth interrupting the user for only while the agent holds the turn.
-*
-* Outside a run the user opened the dialog themselves and is already looking at
-* it. An ask-user prompt is announced by its own event, so the dialog it then
-* opens must stay silent or the same question notifies twice.
-*/
-function warrantsAttentionNotification({ agentRunning, askUserBlocked }) {
-	return agentRunning && !askUserBlocked;
-}
-/** A queued follow-up means the agent keeps working, so the run has not stopped for the user. */
-function warrantsSettledNotification(hasPendingMessages) {
-	return !hasPendingMessages;
-}
-/** Terminal title escapes only mean something on an attached terminal; RPC output stays clean. */
-function supportsShellTitle({ hasUI, mode }) {
-	return hasUI && mode !== RPC_MODE;
-}
-/** The question an ask-user prompt is blocking on, or a stand-in when it asked none. */
-function askUserPromptBody(questions) {
-	return questions[0]?.question ?? DEFAULT_ASK_USER_BODY;
-}
-//#endregion
-exports.askUserPromptBody = askUserPromptBody;
-exports.attentionNotification = attentionNotification;
-exports.createMainThreadTitleController = createMainThreadTitleController;
-exports.createWorkerTitleController = createWorkerTitleController;
-exports.notificationBody = notificationBody;
-exports.promptTitle = promptTitle;
-exports.sendSystemNotification = sendSystemNotification;
-exports.settledNotification = settledNotification;
-exports.shellTabTitle = shellTabTitle;
-exports.supportsShellTitle = supportsShellTitle;
-exports.warrantsAttentionNotification = warrantsAttentionNotification;
-exports.warrantsSettledNotification = warrantsSettledNotification;
-
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"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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"}

package/dist/index.d.mts

@@ -1,116 +0,0 @@
-//#region src/types/notifications.d.ts
-interface NotificationExtensionOptions {
-  /** Replaces the worker-thread animator, which a host without worker threads cannot start. */
-  titleController?: ShellTitleController;
-  environment?: NodeJS.ProcessEnv;
-}
-interface NotificationExecutor {
-  exec(command: string, args: string[], options: {
-    timeout: number;
-  }): Promise<{
-    code: number | null;
-  }>;
-}
-/** Writes a shell-tab title to whatever terminal surface the host owns. */
-type WriteTitle = (title: string) => void;
-/** The four things a title controller can be asked to do, and its method names. */
-type ShellTitleAction = 'dispose' | 'set' | 'start' | 'stop';
-/** One instruction for a title controller, and the message shape its worker consumes. */
-interface ShellTitleCommand {
-  action: ShellTitleAction;
-  title: string;
-}
-/**
- * Drives the shell tab title across a run.
- *
- * `start` animates a spinner in front of the title until `stop` restores the
- * idle one; `set` writes a title without animating; `dispose` writes the final
- * title and releases whatever machinery the implementation owns. Every method
- * takes the writer so the controller never has to hold a session reference.
- */
-interface ShellTitleController {
-  set(title: string, write: WriteTitle): void;
-  start(title: string, write: WriteTitle): void;
-  stop(title: string, write: WriteTitle): void;
-  dispose(title: string, write: WriteTitle): void;
-}
-/** One OS-level desktop notification. */
-interface DesktopNotification {
-  title: string;
-  subtitle: string;
-  body: string;
-}
-//#endregion
-//#region src/services/shellTitleController/index.d.ts
-/** Animates on the main thread, for hosts where a worker could not be started. */
-export declare function createMainThreadTitleController(): ShellTitleController;
-/**
- * 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
- * unreferenced so a pending frame never holds the process open.
- */
-export declare function createWorkerTitleController(): ShellTitleController;
-//#endregion
-//#region src/services/systemNotification/index.d.ts
-/**
- * Delivers one desktop notification on a best-effort basis.
- *
- * cmux is tried first because it routes the notification to the window the
- * session actually lives in. Only macOS has a second option worth attempting,
- * and a host with neither stays silent rather than failing the turn.
- */
-export declare function sendSystemNotification(pi: NotificationExecutor, notification: DesktopNotification, platform?: string): Promise<void>;
-//#endregion
-//#region src/services/notificationPolicy/index.d.ts
-interface AttentionState {
-  agentRunning: boolean;
-  askUserBlocked: boolean;
-}
-interface ShellSurface {
-  hasUI: boolean;
-  mode?: string;
-}
-/**
- * A dialog is worth interrupting the user for only while the agent holds the turn.
- *
- * Outside a run the user opened the dialog themselves and is already looking at
- * it. An ask-user prompt is announced by its own event, so the dialog it then
- * opens must stay silent or the same question notifies twice.
- */
-export declare function warrantsAttentionNotification({ agentRunning, askUserBlocked }: AttentionState): boolean;
-/** A queued follow-up means the agent keeps working, so the run has not stopped for the user. */
-export declare function warrantsSettledNotification(hasPendingMessages: boolean): boolean;
-/** Terminal title escapes only mean something on an attached terminal; RPC output stays clean. */
-export declare function supportsShellTitle({ hasUI, mode }: ShellSurface): boolean;
-/** The question an ask-user prompt is blocking on, or a stand-in when it asked none. */
-export declare function askUserPromptBody(questions: readonly {
-  question: string;
-}[]): string;
-//#endregion
-//#region src/services/notificationText/index.d.ts
-/** The first user prompt, shortened to fit a shell tab. A blank prompt names nothing. */
-export declare function promptTitle(prompt: string): string | undefined;
-interface ShellTabTitleInput {
-  cwd: string;
-  sessionName?: string;
-  prompt?: string;
-}
-/**
- * The idle shell-tab title: `π - <label> - <repository>`.
- *
- * The session name wins over the first prompt because the user chose it. With
- * neither, the repository alone still tells two tabs apart.
- */
-export declare function shellTabTitle({ cwd, sessionName, prompt }: ShellTabTitleInput): string;
-/** Notification bodies are one line in a system panel, so they collapse and truncate. */
-export declare function notificationBody(body: string): string;
-/** Sent while the agent holds the turn and something is blocking on the user. */
-export declare function attentionNotification(body: string): DesktopNotification;
-/** Sent once a run has stopped, subtitled with whichever name the user recognises. */
-export declare function settledNotification({ cwd, sessionName }: {
-  cwd: string;
-  sessionName?: string;
-}): DesktopNotification;
-//#endregion
-export type { AttentionState, DesktopNotification, NotificationExtensionOptions, ShellSurface, ShellTabTitleInput, ShellTitleAction, ShellTitleCommand, ShellTitleController, WriteTitle };
-//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +0,0 @@
-{"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"}

package/dist/index.mjs

@@ -1,272 +0,0 @@
-import { Worker } from "node:worker_threads";
-import path from "node:path";
-//#region src/services/shellTitleController/index.ts
-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;
-	let timer;
-	const stopAnimation = () => {
-		if (timer) clearInterval(timer);
-		timer = void 0;
-		frameIndex = 0;
-	};
-	return {
-		set(title, write) {
-			stopAnimation();
-			write(title);
-		},
-		start(title, write) {
-			stopAnimation();
-			const render = () => {
-				write(`${BRAILLE_FRAMES[frameIndex % BRAILLE_FRAMES.length]} ${title}`);
-				frameIndex += 1;
-			};
-			render();
-			timer = setInterval(render, TITLE_FRAME_INTERVAL_MS);
-		},
-		stop(title, write) {
-			stopAnimation();
-			write(title);
-		},
-		dispose(title, write) {
-			stopAnimation();
-			write(title);
-		}
-	};
-}
-/**
-* 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
-* unreferenced so a pending frame never holds the process open.
-*/
-function createWorkerTitleController() {
-	const fallback = createMainThreadTitleController();
-	let lastCommand;
-	let lastWrite;
-	let worker;
-	const fallBack = () => {
-		worker = void 0;
-		if (!lastCommand || !lastWrite) return;
-		fallback[lastCommand.action](lastCommand.title, lastWrite);
-	};
-	try {
-		const titleWorker = new Worker(TITLE_WORKER_SOURCE, {
-			eval: true,
-			workerData: {
-				frames: BRAILLE_FRAMES,
-				intervalMs: TITLE_FRAME_INTERVAL_MS
-			}
-		});
-		titleWorker.unref();
-		titleWorker.once("error", fallBack);
-		titleWorker.once("exit", (code) => {
-			if (code !== 0 && worker === titleWorker) fallBack();
-		});
-		worker = titleWorker;
-	} catch {
-		worker = void 0;
-	}
-	const dispatch = (command, write) => {
-		lastCommand = command;
-		lastWrite = write;
-		if (!worker) {
-			fallback[command.action](command.title, write);
-			return;
-		}
-		try {
-			worker.postMessage(command);
-		} catch {
-			fallBack();
-		}
-	};
-	return {
-		set: (title, write) => dispatch({
-			action: "set",
-			title
-		}, write),
-		start: (title, write) => dispatch({
-			action: "start",
-			title
-		}, write),
-		stop: (title, write) => dispatch({
-			action: "stop",
-			title
-		}, write),
-		dispose: (title, write) => dispatch({
-			action: "dispose",
-			title
-		}, write)
-	};
-}
-//#endregion
-//#region src/services/notificationText/index.ts
-const ATTENTION_SUBTITLE = "Approval or feedback required";
-const ATTENTION_TITLE = "Pi needs your input";
-const ELLIPSIS = "…";
-const MAX_BODY_LENGTH = 240;
-const MAX_PROMPT_TITLE_LENGTH = 36;
-const SETTLED_BODY = "The agent finished its work and is waiting for you.";
-const SETTLED_TITLE = "Pi finished";
-const SHELL_TITLE_SEPARATOR = " - ";
-const SHELL_TITLE_PREFIX = "π";
-function collapseWhitespace(value) {
-	return value.replace(/\s+/g, " ").trim();
-}
-function truncate(value, maxLength) {
-	return value.length > maxLength ? `${value.slice(0, maxLength - 1)}${ELLIPSIS}` : value;
-}
-/** The first user prompt, shortened to fit a shell tab. A blank prompt names nothing. */
-function promptTitle(prompt) {
-	const normalized = collapseWhitespace(prompt);
-	return normalized ? truncate(normalized, MAX_PROMPT_TITLE_LENGTH) : void 0;
-}
-/**
-* The idle shell-tab title: `π - <label> - <repository>`.
-*
-* The session name wins over the first prompt because the user chose it. With
-* neither, the repository alone still tells two tabs apart.
-*/
-function shellTabTitle({ cwd, sessionName, prompt }) {
-	const repository = path.basename(cwd);
-	const label = sessionName ?? prompt;
-	return label ? `${SHELL_TITLE_PREFIX}${SHELL_TITLE_SEPARATOR}${label}${SHELL_TITLE_SEPARATOR}${repository}` : `${SHELL_TITLE_PREFIX}${SHELL_TITLE_SEPARATOR}${repository}`;
-}
-/** Notification bodies are one line in a system panel, so they collapse and truncate. */
-function notificationBody(body) {
-	return truncate(collapseWhitespace(body), MAX_BODY_LENGTH);
-}
-/** Sent while the agent holds the turn and something is blocking on the user. */
-function attentionNotification(body) {
-	return {
-		title: ATTENTION_TITLE,
-		subtitle: ATTENTION_SUBTITLE,
-		body
-	};
-}
-/** Sent once a run has stopped, subtitled with whichever name the user recognises. */
-function settledNotification({ cwd, sessionName }) {
-	return {
-		title: SETTLED_TITLE,
-		subtitle: sessionName ?? path.basename(cwd),
-		body: SETTLED_BODY
-	};
-}
-//#endregion
-//#region src/services/systemNotification/index.ts
-const CMUX_COMMAND = "cmux";
-const COMMAND_TIMEOUT_MS = 3e3;
-const DARWIN_PLATFORM = "darwin";
-const OSASCRIPT_COMMAND = "osascript";
-const OSASCRIPT_EXPRESSION_FLAG = "-e";
-async function execute(pi, command, args) {
-	try {
-		return (await pi.exec(command, args, { timeout: COMMAND_TIMEOUT_MS })).code === 0;
-	} catch {
-		return false;
-	}
-}
-/**
-* Delivers one desktop notification on a best-effort basis.
-*
-* cmux is tried first because it routes the notification to the window the
-* session actually lives in. Only macOS has a second option worth attempting,
-* and a host with neither stays silent rather than failing the turn.
-*/
-async function sendSystemNotification(pi, notification, platform = process.platform) {
-	const body = notificationBody(notification.body);
-	if (await execute(pi, CMUX_COMMAND, [
-		"notify",
-		"--title",
-		notification.title,
-		"--subtitle",
-		notification.subtitle,
-		"--body",
-		body
-	]) || platform !== DARWIN_PLATFORM) return;
-	await execute(pi, OSASCRIPT_COMMAND, [
-		OSASCRIPT_EXPRESSION_FLAG,
-		"on run argv",
-		OSASCRIPT_EXPRESSION_FLAG,
-		"display notification (item 3 of argv) with title (item 1 of argv) subtitle (item 2 of argv)",
-		OSASCRIPT_EXPRESSION_FLAG,
-		"end run",
-		notification.title,
-		notification.subtitle,
-		body
-	]);
-}
-//#endregion
-//#region src/services/notificationPolicy/index.ts
-const DEFAULT_ASK_USER_BODY = "The agent is waiting for your feedback.";
-const RPC_MODE = "rpc";
-/**
-* A dialog is worth interrupting the user for only while the agent holds the turn.
-*
-* Outside a run the user opened the dialog themselves and is already looking at
-* it. An ask-user prompt is announced by its own event, so the dialog it then
-* opens must stay silent or the same question notifies twice.
-*/
-function warrantsAttentionNotification({ agentRunning, askUserBlocked }) {
-	return agentRunning && !askUserBlocked;
-}
-/** A queued follow-up means the agent keeps working, so the run has not stopped for the user. */
-function warrantsSettledNotification(hasPendingMessages) {
-	return !hasPendingMessages;
-}
-/** Terminal title escapes only mean something on an attached terminal; RPC output stays clean. */
-function supportsShellTitle({ hasUI, mode }) {
-	return hasUI && mode !== RPC_MODE;
-}
-/** The question an ask-user prompt is blocking on, or a stand-in when it asked none. */
-function askUserPromptBody(questions) {
-	return questions[0]?.question ?? DEFAULT_ASK_USER_BODY;
-}
-//#endregion
-export { askUserPromptBody, attentionNotification, createMainThreadTitleController, createWorkerTitleController, notificationBody, promptTitle, sendSystemNotification, settledNotification, shellTabTitle, supportsShellTitle, warrantsAttentionNotification, warrantsSettledNotification };
-
-//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"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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"}

package/llms.txt

@@ -1,7 +0,0 @@
-# Doom Pi Notification
-
-Shared notification routing, browser and system delivery, and an animated shell-tab title for Doom 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.