@phigon/observer 8.0.2 → 8.2.0

package/dist/src/user-notices.js

@@ -0,0 +1,117 @@
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+const repeatWindowMs = 60_000;
+const textLimit = 240;
+/**
+ * Tells the person at this computer what Phigon did to it: an agent stopped,
+ * a command run, the computer about to restart. Notices are best effort: a
+ * computer with no desktop session, or an observer running as a service
+ * with no access to it, shows nothing, and a notice never affects the action.
+ */
+export class UserNotices {
+    #send;
+    #now;
+    #recent = new Map();
+    constructor(options) {
+        this.#send = options.enabled ? options.send ?? platformNoticeSender() : undefined;
+        this.#now = options.now ?? Date.now;
+    }
+    /** An agent Phigon stopped, because someone asked or a rule said so. */
+    agentStopped(input) {
+        this.#show(input.key, {
+            title: `${input.agent} was ${input.forced ? "force-stopped" : "stopped"} by Phigon`,
+            body: input.reason.trim() || "Your workspace administrator's rules stopped it.",
+        });
+    }
+    /** A blocked agent Phigon stopped as soon as it started. */
+    agentBlocked(input) {
+        this.#show(input.key, {
+            title: `${input.agent} was stopped by Phigon`,
+            body: input.reason.trim() || `${input.agent} is blocked on this computer by your workspace administrator.`,
+        });
+    }
+    commandRan(input) {
+        this.#show(input.key, {
+            title: `Phigon ran ${input.program} on this computer`,
+            body: input.reason.trim() || "Your workspace administrator asked for it.",
+        });
+    }
+    powerChange(input) {
+        this.#show(input.key, {
+            title: `Phigon will ${input.restart ? "restart" : "shut down"} this computer in 1 minute`,
+            body: `Save your work now. ${input.reason.trim()}`.trim(),
+        });
+    }
+    #show(key, notice) {
+        if (this.#send === undefined)
+            return;
+        const now = this.#now();
+        for (const [seen, at] of this.#recent)
+            if (now - at > repeatWindowMs)
+                this.#recent.delete(seen);
+        // A retried action or a review that sees the same process again is
+        // announced once.
+        if (this.#recent.has(key))
+            return;
+        this.#recent.set(key, now);
+        void this.#send({ title: plainText(notice.title, 120), body: plainText(notice.body, textLimit) }).catch(() => undefined);
+    }
+}
+/** One line of plain text: no control characters, and bounded. */
+export function plainText(value, limit) {
+    const text = value.replace(/[\u0000-\u001f\u007f]+/gu, " ").replace(/\s+/gu, " ").trim();
+    return text.length <= limit ? text : `${text.slice(0, limit - 1)}…`;
+}
+/** The name people know an agent by: "Claude Code · PID 4120" is "Claude Code". */
+export function noticeAgentName(displayName) {
+    return displayName.split(" · ")[0]?.trim() || "An AI agent";
+}
+/**
+ * The operating system's own notification, shown without a shell. The text
+ * travels in environment variables, never in the command line or a script.
+ */
+export function platformNoticeSender(platform = process.platform) {
+    switch (platform) {
+        case "win32":
+            return (notice) => run(join(process.env["SystemRoot"] ?? "C:\\Windows", "System32", "WindowsPowerShell", "v1.0", "powershell.exe"), ["-NoProfile", "-NonInteractive", "-WindowStyle", "Hidden", "-Command", windowsToastScript], notice);
+        case "darwin":
+            return (notice) => run("/usr/bin/osascript", [
+                "-e", 'display notification (system attribute "PHIGON_NOTICE_BODY") with title (system attribute "PHIGON_NOTICE_TITLE")',
+            ], notice);
+        case "linux":
+            return (notice) => run("notify-send", ["--app-name=Phigon", "--", notice.title, notice.body], notice);
+        default:
+            return undefined;
+    }
+}
+// Windows PowerShell's own app id is registered on every Windows 10 and 11,
+// so its toasts show without installing anything.
+const windowsToastScript = [
+    "$ErrorActionPreference = 'Stop'",
+    "[void][Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime]",
+    "[void][Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType = WindowsRuntime]",
+    "$title = [System.Security.SecurityElement]::Escape($env:PHIGON_NOTICE_TITLE)",
+    "$body = [System.Security.SecurityElement]::Escape($env:PHIGON_NOTICE_BODY)",
+    "$xml = New-Object Windows.Data.Xml.Dom.XmlDocument",
+    "$xml.LoadXml(\"<toast><visual><binding template='ToastGeneric'><text>$title</text><text>$body</text></binding></visual></toast>\")",
+    "$app = '{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\\WindowsPowerShell\\v1.0\\powershell.exe'",
+    "[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier($app).Show([Windows.UI.Notifications.ToastNotification]::new($xml))",
+].join("; ");
+function run(executable, args, notice) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(executable, args, {
+            env: { ...process.env, PHIGON_NOTICE_TITLE: notice.title, PHIGON_NOTICE_BODY: notice.body },
+            stdio: "ignore", windowsHide: true, shell: false,
+        });
+        const timer = setTimeout(() => child.kill(), 15_000);
+        child.once("error", (error) => { clearTimeout(timer); reject(error); });
+        child.once("exit", (code) => {
+            clearTimeout(timer);
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`notice exited with ${String(code)}`));
+        });
+    });
+}
+//# sourceMappingURL=user-notices.js.map

package/dist/src/user-notices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-notices.js","sourceRoot":"","sources":["../../src/user-notices.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,78 +1,83 @@
-{
-  "name": "@phigon/observer",
-  "version": "8.0.2",
-  "description": "Connect authorized machines and AI coding agents to Phigon for live activity, conversation history, and Guardian policies.",
-  "type": "module",
-  "private": false,
-  "license": "UNLICENSED",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/imthegoodboy/Phigon.git",
-    "directory": "observer"
-  },
-  "bin": {
-    "phigon-observer": "dist/src/cli.js"
-  },
-  "files": [
-    "dist/src",
-    "dist/bin",
-    "README.md",
-    "scripts/install.mjs",
-    "scripts/managed-service.mjs",
-    "scripts/windows-app-control.mjs",
-    "scripts/verify-guardian-release.mjs"
-  ],
-  "engines": {
-    "node": ">=24.0.0"
-  },
-  "scripts": {
-    "build": "node scripts/build.mjs",
-    "build:platforms": "node scripts/build-guardian-runner.mjs --all",
-    "verify:release": "node scripts/verify-guardian-release.mjs",
-    "prepublishOnly": "npm run verify:release",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "lint": "eslint src test",
-    "test": "npm run build --silent && node --test dist/test/**/*.test.js",
-    "test:coverage": "npm run build --silent && node --experimental-test-coverage --test-coverage-include=\"dist/src/**/*.js\" --test-coverage-lines=80 --test-coverage-branches=75 --test-coverage-functions=80 --test dist/test/**/*.test.js",
-    "doctor": "npm run build --silent && node --env-file-if-exists=../.env dist/src/cli.js doctor --json",
-    "discover": "npm run build --silent && node --env-file-if-exists=../.env dist/src/cli.js discover --json",
-    "pair": "npm run build --silent && node --env-file-if-exists=../.env dist/src/cli.js pair",
-    "start": "npm run build --silent && node --env-file-if-exists=../.env dist/src/cli.js run",
-    "verify:installer": "node scripts/verify-installer.mjs",
-    "check": "npm run lint && npm run typecheck && npm run test"
-  },
-  "devDependencies": {
-    "@bufbuild/protoc-gen-es": "2.13.0",
-    "@types/node": "24.13.3",
-    "eslint": "10.8.0",
-    "tsx": "4.23.1",
-    "typescript": "5.9.3",
-    "typescript-eslint": "8.65.0"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org"
-  },
-  "dependencies": {
-    "@bufbuild/protobuf": "2.13.0",
-    "@grpc/grpc-js": "1.14.4"
-  },
-  "overrides": {
-    "minimatch@10.2.5": {
-      "brace-expansion": "5.0.9"
-    }
-  },
-  "homepage": "https://phigon.online/docs/get-started",
-  "bugs": {
-    "url": "https://github.com/imthegoodboy/Phigon/issues"
-  },
-  "keywords": [
-    "phigon",
-    "ai-agents",
-    "agent-observability",
-    "codex",
-    "claude-code",
-    "opencode",
-    "guardian"
-  ]
-}
+{
+  "name": "@phigon/observer",
+  "version": "8.2.0",
+  "description": "Open-source observer that connects computers and their AI coding agents to Phigon: agent discovery, consented activity and history, local redaction, and Guardian checks.",
+  "type": "module",
+  "private": false,
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/phigonai/observer.git"
+  },
+  "bin": {
+    "phigon-observer": "dist/src/cli.js"
+  },
+  "files": [
+    "dist/src",
+    "dist/bin",
+    "README.md",
+    "scripts/install.mjs",
+    "scripts/managed-service.mjs",
+    "scripts/windows-app-control.mjs",
+    "scripts/verify-guardian-release.mjs",
+    "NOTICE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "build:platforms": "node scripts/build-guardian-runner.mjs --all",
+    "verify:release": "node scripts/verify-guardian-release.mjs",
+    "prepublishOnly": "npm run verify:release",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint src test",
+    "test": "npm run build --silent && node --test dist/test/**/*.test.js",
+    "test:coverage": "npm run build --silent && node --experimental-test-coverage --test-coverage-include=\"dist/src/**/*.js\" --test-coverage-lines=80 --test-coverage-branches=75 --test-coverage-functions=80 --test dist/test/**/*.test.js",
+    "doctor": "npm run build --silent && node --env-file-if-exists=../.env dist/src/cli.js doctor --json",
+    "discover": "npm run build --silent && node --env-file-if-exists=../.env dist/src/cli.js discover --json",
+    "pair": "npm run build --silent && node --env-file-if-exists=../.env dist/src/cli.js pair",
+    "start": "npm run build --silent && node --env-file-if-exists=../.env dist/src/cli.js run",
+    "verify:installer": "node scripts/verify-installer.mjs",
+    "check": "npm run lint && npm run typecheck && npm run test"
+  },
+  "devDependencies": {
+    "@bufbuild/protoc-gen-es": "2.13.0",
+    "@types/node": "24.13.3",
+    "eslint": "10.8.0",
+    "tsx": "4.23.1",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.65.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "2.13.0",
+    "@grpc/grpc-js": "1.14.6"
+  },
+  "overrides": {
+    "minimatch@10.2.5": {
+      "brace-expansion": "5.0.12"
+    }
+  },
+  "homepage": "https://github.com/phigonai/observer#readme",
+  "bugs": {
+    "url": "https://github.com/phigonai/observer/issues"
+  },
+  "keywords": [
+    "phigon",
+    "ai-agents",
+    "agent-observability",
+    "codex",
+    "claude-code",
+    "opencode",
+    "guardian",
+    "open-source",
+    "gemini-cli",
+    "cursor",
+    "github-copilot"
+  ]
+}