@adhd/agent-mcp 1.1.3 → 1.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhd/agent-mcp",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Stateful MCP-native agent runtime with provider abstraction and recursive delegation",
   "type": "module",
   "publishConfig": {

package/src/engine/hooks.d.ts

@@ -1,9 +1,24 @@
+import type { HookEvent, HookEventMap, HookHandler, IHookRegistry, EnforcementEvent, EnforcementHandler } from "@adhd/agent-mcp-types";
 /**
- * Re-exports HookRegistry from @adhd/agent-mcp-types so the server can
- * import it via the local path "./engine/hooks.js" without the implementation
- * living in this package. This keeps @adhd/agent-mcp-budget's test suite able
- * to instantiate HookRegistry from @adhd/agent-mcp-types without creating a
- * circular Nx dependency with @adhd/agent-mcp.
+ * Concrete implementation of IHookRegistry used by the agent-mcp server.
+ *
+ * NOTE: A copy of this class also lives in @adhd/agent-mcp-types so plugin
+ * authors can instantiate it in their own tests without taking a runtime
+ * dependency on the full server package. Keep the two in sync until DEBT-009
+ * is resolved (extraction to @adhd/agent-mcp-hooks).
+ *
+ * Observational handlers registered via register() have their throws swallowed
+ * and logged — a buggy plugin never kills a task.
+ *
+ * Enforcement handlers registered via registerEnforcement() propagate throws
+ * so the orchestrator can fail the task with BUDGET_EXCEEDED.
  */
-export { HookRegistry } from "@adhd/agent-mcp-types";
+export declare class HookRegistry implements IHookRegistry {
+    private readonly handlers;
+    private readonly enforcementHandlers;
+    register<E extends HookEvent>(event: E, handler: HookHandler<E>): void;
+    emit<E extends HookEvent>(event: E, payload: HookEventMap[E]): Promise<void>;
+    registerEnforcement<E extends EnforcementEvent>(event: E, handler: EnforcementHandler<E>): void;
+    enforce<E extends EnforcementEvent>(event: E, payload: HookEventMap[E]): Promise<void>;
+}
 //# sourceMappingURL=hooks.d.ts.map

package/src/engine/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/engine/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/engine/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EACrB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,YAAW,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6D;IACtF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAuE;IAE3G,QAAQ,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAMhE,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlF,mBAAmB,CAAC,CAAC,SAAS,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI;IAMzF,OAAO,CAAC,CAAC,SAAS,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAO/F"}

package/src/engine/hooks.js

@@ -1,9 +1,50 @@
 /**
- * Re-exports HookRegistry from @adhd/agent-mcp-types so the server can
- * import it via the local path "./engine/hooks.js" without the implementation
- * living in this package. This keeps @adhd/agent-mcp-budget's test suite able
- * to instantiate HookRegistry from @adhd/agent-mcp-types without creating a
- * circular Nx dependency with @adhd/agent-mcp.
+ * Concrete implementation of IHookRegistry used by the agent-mcp server.
+ *
+ * NOTE: A copy of this class also lives in @adhd/agent-mcp-types so plugin
+ * authors can instantiate it in their own tests without taking a runtime
+ * dependency on the full server package. Keep the two in sync until DEBT-009
+ * is resolved (extraction to @adhd/agent-mcp-hooks).
+ *
+ * Observational handlers registered via register() have their throws swallowed
+ * and logged — a buggy plugin never kills a task.
+ *
+ * Enforcement handlers registered via registerEnforcement() propagate throws
+ * so the orchestrator can fail the task with BUDGET_EXCEEDED.
  */
-export { HookRegistry } from "@adhd/agent-mcp-types";
+export class HookRegistry {
+    handlers = new Map();
+    enforcementHandlers = new Map();
+    register(event, handler) {
+        const list = this.handlers.get(event) ?? [];
+        list.push(handler);
+        this.handlers.set(event, list);
+    }
+    async emit(event, payload) {
+        const list = this.handlers.get(event);
+        if (!list?.length)
+            return;
+        for (const handler of list) {
+            try {
+                await handler(payload);
+            }
+            catch (err) {
+                console.warn("[HookRegistry] hook handler error (swallowed)", { event, err });
+            }
+        }
+    }
+    registerEnforcement(event, handler) {
+        const list = this.enforcementHandlers.get(event) ?? [];
+        list.push(handler);
+        this.enforcementHandlers.set(event, list);
+    }
+    async enforce(event, payload) {
+        const list = this.enforcementHandlers.get(event);
+        if (!list?.length)
+            return;
+        for (const handler of list) {
+            await handler(payload);
+        }
+    }
+}
 //# sourceMappingURL=hooks.js.map

package/src/engine/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/engine/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/engine/hooks.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,YAAY;IACJ,QAAQ,GAAc,IAAI,GAAG,EAAuC,CAAC;IACrE,mBAAmB,GAAG,IAAI,GAAG,EAA4D,CAAC;IAE3G,QAAQ,CAAsB,KAAQ,EAAE,OAAuB;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,OAAiC,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,IAAI,CAAsB,KAAQ,EAAE,OAAwB;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,MAAM;YAAE,OAAO;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC;gBACD,MAAO,OAA0B,CAAC,OAAO,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,+CAA+C,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAClF,CAAC;QACL,CAAC;IACL,CAAC;IAED,mBAAmB,CAA6B,KAAQ,EAAE,OAA8B;QACpF,MAAM,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,OAA+C,CAAC,CAAC;QAC3D,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,OAAO,CAA6B,KAAQ,EAAE,OAAwB;QACxE,MAAM,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,EAAE,MAAM;YAAE,OAAO;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;YACzB,MAAO,OAAiC,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;CACJ"}