@hydraharness/harness-notifications 0.0.0-stage → 0.1.1-rc.11

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+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/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# Live notifications
 
-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.
+The `notifications` settings namespace controls live turn completion, pending questions, display-permission prompts, and sound. Completion defaults to Background. API proxy emits `notifications/requested` only when a new turn ends or a new question is requested; transcript reload does not emit it. Connected Web windows use browser permission. Desktop windows share native delivery and deduplicate stable notification ids. Clicking a question opens its chat.
+
+## Model Experience
+
+None, as live notification delivery adds no model input or transcript content.
+
+#### KV Cache effect
+
+None; notification policies do not alter model requests.
+
+## Known Limitations and Deferred Work
+
+- Web delivery requires a connected page and browser display permission. Desktop delivery remains subject to OS notification settings.

package/lib/index.js

@@ -0,0 +1,22 @@
+import z from "@hydraharness/schemastery";
+import { settingsNamespace } from "@hydraharness/harness-settings";
+//#region lib/types/index.js
+/** Registers global live-notification policy.
+* @param ctx - Host settings owner.
+*/
+function apply(ctx) {
+	ctx.inject(["settings"], (sctx) => {
+		sctx.settings.register(settingsNamespace("notifications"), z.object({
+			completion: z.union([
+				"never",
+				"background",
+				"always"
+			]).default("background"),
+			permissionPrompts: z.boolean().default(true),
+			questions: z.boolean().default(true),
+			sound: z.union(["default", "off"]).default("default")
+		}));
+	});
+}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,17 @@
+//#region lib/types/invariant.js
+/** Cordis companion plugin name. */
+const name = "notifications-invariant";
+/** Service required before reserving package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: this plugin registers settings while browser and OS providers own notification delivery; it owns
+* no mutable delivery projection.
+*/
+const install = () => {};
+/** Registers this package's invariant ownership.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns registration disposer.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register("@hydraharness/harness-notifications", install));
+//#endregion
+export { apply, inject, name };

package/lib/types/index.d.ts

@@ -0,0 +1,8 @@
+/** User policy for live notifications, delivered by connected Web or Desktop providers. */
+import type { Context } from '@hydraharness/cordis';
+export type { NotificationId, NotificationRequest, NotificationSettings } from './types.ts';
+/** Registers global live-notification policy.
+ * @param ctx - Host settings owner.
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.js

@@ -0,0 +1,15 @@
+import z from '@hydraharness/schemastery';
+import { settingsNamespace } from '@hydraharness/harness-settings';
+/** Registers global live-notification policy.
+ * @param ctx - Host settings owner.
+ */
+export function apply(ctx) {
+    ctx.inject(['settings'], (sctx) => {
+        sctx.settings.register(settingsNamespace('notifications'), z.object({
+            completion: z.union(['never', 'background', 'always']).default('background'),
+            permissionPrompts: z.boolean().default(true), questions: z.boolean().default(true),
+            sound: z.union(['default', 'off']).default('default'),
+        }));
+    });
+}
+//# sourceMappingURL=index.js.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,12 @@
+/** Package-owned invariant companion for `@hydraharness/harness-notifications`. */
+import type { Context } from '@hydraharness/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "notifications-invariant";
+/** Service required before reserving package ownership. */
+export declare const inject: string[];
+/** Registers this package's invariant ownership.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns registration disposer.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/types/invariant.js

@@ -0,0 +1,16 @@
+/** Cordis companion plugin name. */
+export const name = 'notifications-invariant';
+/** Service required before reserving package ownership. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: this plugin registers settings while browser and OS providers own notification delivery; it owns
+ * no mutable delivery projection.
+ */
+const install = () => { };
+/** Registers this package's invariant ownership.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns registration disposer.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register('@hydraharness/harness-notifications', install));
+/* jscpd:ignore-end */
+//# sourceMappingURL=invariant.js.map

package/lib/types/types.d.ts

@@ -0,0 +1,31 @@
+/** Client-safe live notification facts and accepted user choices. */
+import type { SessionId } from '@hydraharness/harness-session/types';
+import type { Branded } from '@hydraharness/harness-brand';
+/** Stable identity for one live delivery fact across connected windows. */
+export type NotificationId = Branded<'NotificationId'>;
+/** Stable identity and chat destination; emitted for live events rather than transcript replay. */
+export interface NotificationRequest {
+    id: NotificationId;
+    sessionId: SessionId;
+    kind: 'completion' | 'question';
+    title: string;
+    body: string;
+}
+/** Notification choices are independent of browser and OS display permission. */
+export interface NotificationSettings {
+    completion: 'never' | 'background' | 'always';
+    permissionPrompts: boolean;
+    questions: boolean;
+    sound: 'default' | 'off';
+}
+declare module '@hydraharness/cordis' {
+    interface Events {
+        /**
+         * A live turn ended or a new question awaits an answer; connected providers may deliver it.
+         * @mode parallel
+         * @param request - stable delivery identity and destination chat.
+         */
+        'notifications/requested'(request: NotificationRequest): void;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/types.js

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

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@hydraharness/harness-notifications",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1-rc.11",
+  "description": "Live turn and question notification facts and user policy",
+  "type": "module",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MaiHongPhong2010/Hydra-Harness.git",
+    "directory": "packages/interaction/notifications"
+  },
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./types": {
+      "types": "./lib/types/types.d.ts",
+      "default": "./lib/types/types.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "hydra": {
+    "plugin": {
+      "application": "Choose live turn and question notification policy."
+    }
+  },
+  "peerDependencies": {
+    "@hydraharness/cordis": "^4.0.2",
+    "@hydraharness/harness-session": "^0.1.1-rc.11",
+    "@hydraharness/harness-settings": "^0.1.1-rc.11",
+    "@hydraharness/harness-brand": "^0.1.1-rc.11",
+    "@hydraharness/harness-invariants": "^0.1.1-rc.11"
+  },
+  "dependencies": {
+    "@hydraharness/schemastery": "^3.18.2"
+  },
+  "devDependencies": {
+    "@hydraharness/cordis": "^4.0.2",
+    "@hydraharness/harness-session": "^0.1.1-rc.11",
+    "@hydraharness/harness-brand": "^0.1.1-rc.11",
+    "@hydraharness/harness-settings": "^0.1.1-rc.11",
+    "@hydraharness/harness-invariants": "^0.1.1-rc.11"
+  }
 }