@burmese/agent-events 3.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenPets
+
+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/check-agent-events.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=check-agent-events.d.ts.map

package/dist/check-agent-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-agent-events.d.ts","sourceRoot":"","sources":["../src/check-agent-events.ts"],"names":[],"mappings":""}

package/dist/check-agent-events.js

@@ -0,0 +1,15 @@
+import assert from "node:assert/strict";
+import { hookSpeechPools, pickHookSpeech, validateHookSpeech } from "./index.js";
+assert.equal(pickHookSpeech("thinking", () => 0), "Thinking it through");
+assert.equal(pickHookSpeech("success", () => 0.99), "Nice, finished");
+for (const [category, messages] of Object.entries(hookSpeechPools)) {
+    for (const message of messages) {
+        assert.match(message, /^[A-Z]/, `${category} hook speech must start with uppercase: ${message}`);
+        assert.equal(validateHookSpeech(message), message);
+    }
+}
+for (const unsafe of ["", "a".repeat(141), "line\nbreak", "const x = 1", "https://example.com", "/Users/alvin/project", "api_key=secret"]) {
+    assert.throws(() => validateHookSpeech(unsafe));
+}
+console.error("Agent event speech validation passed.");
+//# sourceMappingURL=check-agent-events.js.map

package/dist/check-agent-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-agent-events.js","sourceRoot":"","sources":["../src/check-agent-events.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEjF,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;AACzE,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAEtE,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;IACnE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,2CAA2C,OAAO,EAAE,CAAC,CAAC;QACjG,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,KAAK,MAAM,MAAM,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,gBAAgB,CAAC,EAAE,CAAC;IAC1I,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type HookSpeechCategory = "thinking" | "success" | "error" | "permission";
+export declare const hookSpeechPools: Record<HookSpeechCategory, readonly string[]>;
+export declare function pickHookSpeech(category: HookSpeechCategory, random?: () => number): string;
+export declare function validateHookSpeech(message: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC;AAEjF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAKzE,CAAC;AAEF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,GAAE,MAAM,MAAoB,GAAG,MAAM,CAGvG;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ1D"}

package/dist/index.js

@@ -0,0 +1,26 @@
+export const hookSpeechPools = {
+    thinking: ["Thinking it through", "Let me check", "On it", "Working it out"],
+    success: ["Done", "That worked", "All set", "Nice, finished"],
+    error: ["Something failed", "Needs another look", "Hit a snag", "Not quite there"],
+    permission: ["Approval needed"],
+};
+export function pickHookSpeech(category, random = Math.random) {
+    const pool = hookSpeechPools[category];
+    return pool[Math.max(0, Math.min(pool.length - 1, Math.floor(random() * pool.length)))] ?? pool[0] ?? "Working";
+}
+export function validateHookSpeech(message) {
+    if (message.length < 1 || message.length > 140)
+        throw new Error("Hook speech length is invalid.");
+    if (/\r|\n/.test(message))
+        throw new Error("Hook speech must be single line.");
+    if (/```|\b(function|const|let|var|class|import|export)\b|[{};]/.test(message))
+        throw new Error("Hook speech looks code-like.");
+    if (/https?:\/\/|www\./i.test(message))
+        throw new Error("Hook speech must not contain URLs.");
+    if (/(^|\s)(?:~|\.{1,2}|[A-Za-z]:)?[\\/][^\s]+/.test(message))
+        throw new Error("Hook speech must not contain paths.");
+    if (/\b(api[_-]?key|secret|password|token)\s*[:=]/i.test(message))
+        throw new Error("Hook speech must not contain secrets.");
+    return message;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAkD;IAC5E,QAAQ,EAAE,CAAC,qBAAqB,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,CAAC;IAC5E,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,CAAC;IAC7D,KAAK,EAAE,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,YAAY,EAAE,iBAAiB,CAAC;IAClF,UAAU,EAAE,CAAC,iBAAiB,CAAC;CAChC,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,QAA4B,EAAE,SAAuB,IAAI,CAAC,MAAM;IAC7F,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AAClH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAClG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC/E,IAAI,4DAA4D,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAChI,IAAI,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC9F,IAAI,2CAA2C,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACtH,IAAI,+CAA+C,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC5H,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@burmese/agent-events",
+  "version": "3.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wannabeepolymath/pet-assistant.git",
+    "directory": "packages/agent-events"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "test": "node dist/check-agent-events.js",
+    "check": "pnpm typecheck && pnpm build && pnpm test",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc"
+  }
+}