wotann 0.5.39 → 0.5.41

package/dist/daemon/rpc-handlers/ports-rpc.d.ts

@@ -0,0 +1,100 @@
+/**
+ * ports-rpc — daemon JSON-RPC handlers wiring 4 zombie ports (audit
+ * finding #8 closure) into the agent's tool surface.
+ *
+ * Each handler delegates to a bridge function from
+ * `src/orchestration/ports-bridge.ts`. The bridges construct the
+ * dependency-injected primitive (ConverseFn, ResearchPipeline,
+ * GraphStore, DomAdapter) from the business-level RPC payload — JSON
+ * cannot transport callbacks, so the bridge is the seam.
+ *
+ * Methods registered:
+ *   - ports.chatdev.run     — runs a ChatDev waterfall (default 5-phase
+ *                             or a caller-supplied phase override).
+ *   - ports.research.run    — runs the deer-flow research pipeline
+ *                             (planner -> parallel researchers -> reporter).
+ *   - ports.memgraph.ingest — ingests text into a mem0-style graph
+ *                             memory; returns triples + 2-hop neighborhoods.
+ *   - ports.scrapling.locate — adaptively locates a DOM node within a
+ *                              caller-supplied snapshot.
+ *
+ * Quality bars honored:
+ *   QB #3  honest stub — every handler reports an `ok:false` envelope
+ *          when the bridge can't reach a real dependency (e.g. research
+ *          with no search provider). No silent success.
+ *   QB #5  structured failure envelopes for missing/invalid params.
+ *   QB #6  invalid-params throws `-32602` (JSON-RPC standard).
+ *   QB #7  zero module-level mutable state — each `registerPortsHandlers`
+ *          call instantiates its own handler-set; runtime ref is closed
+ *          over lazily.
+ *   QB #14 real-code-path tests in `tests/daemon/rpc-handlers/ports-rpc.test.ts`
+ *          register a fresh map and exercise every handler.
+ *
+ * The runtime ref is plumbed through `getRuntime` (same pattern as
+ * intelligence-rpc.ts). When the runtime is unreachable, handlers that
+ * benefit from LLM augmentation (chatdev runtime mode, research planner)
+ * fall back to honest envelopes — they never invent LLM output.
+ */
+import { type DomSnapshot, type RuntimeConverseRef } from "../../orchestration/ports-bridge.js";
+import type { SearchProvider } from "../../intelligence/research-loops/strategies/base-strategy.js";
+import type { WotannRuntime } from "../../core/runtime.js";
+export type Handler = (params: Record<string, unknown>) => Promise<unknown>;
+/**
+ * Narrow runtime ref the handlers need: just the streaming text-in /
+ * text-out callable. We adapt the full WotannRuntime to this shape so
+ * tests can pass a tiny mock.
+ */
+export interface PortsRuntimeRef {
+    /** Adapt the full runtime into the bridge's converse shape. */
+    toConverseRef(): RuntimeConverseRef;
+}
+export interface PortsHandlersOptions {
+    /**
+     * Resolve the live runtime. Same lazy-getter pattern as
+     * intelligence-rpc.ts so a not-yet-wired runtime returns null
+     * gracefully without throwing during registration.
+     */
+    readonly getRuntime?: () => WotannRuntime | null;
+    /**
+     * Optional explicit converse ref — used by tests to inject a stub
+     * without constructing a WotannRuntime. If supplied, this takes
+     * precedence over `getRuntime`.
+     */
+    readonly getConverseRef?: () => RuntimeConverseRef | null;
+    /**
+     * Optional explicit search provider — used by tests and by deployments
+     * that don't want to read the WOTANN_SEARCH_PROVIDER env. When absent
+     * the handlers call `createDefaultWebSearchProvider()` which reads
+     * BRAVE_API_KEY / TAVILY_API_KEY from the environment. If no keys are
+     * set, the search provider is null and the research handler returns
+     * an honest ok:false envelope.
+     */
+    readonly getSearchProvider?: () => SearchProvider | null;
+}
+/**
+ * Build a {@link RuntimeConverseRef} that drives the WotannRuntime's
+ * `query()` async generator. Streams text chunks; concatenates and
+ * returns one string. Throws on any error chunk (the bridge catches
+ * and stamps it onto the phase outcome per QB#10).
+ */
+declare function adaptRuntime(runtime: WotannRuntime): RuntimeConverseRef;
+declare function asDomSnapshot(x: unknown): DomSnapshot;
+export declare function createPortsHandlers(options?: PortsHandlersOptions): {
+    readonly handlers: Readonly<Record<string, Handler>>;
+};
+/**
+ * Register the 4 ports.* handlers onto the given handler map. Mirrors
+ * the {@link registerIntelligenceHandlers} shape — a single import +
+ * a single call from kairos-rpc.ts.
+ *
+ * Idempotent: re-registering overwrites the existing entries with the
+ * new handler-set's bound closures.
+ */
+export declare function registerPortsHandlers(handlers: Map<string, Handler>, options?: PortsHandlersOptions): void;
+export declare const _testOnly: {
+    readonly adaptRuntime: typeof adaptRuntime;
+    readonly asDomSnapshot: typeof asDomSnapshot;
+    readonly createPortsHandlers: typeof createPortsHandlers;
+};
+export {};
+//# sourceMappingURL=ports-rpc.d.ts.map

package/dist/daemon/rpc-handlers/ports-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports-rpc.d.ts","sourceRoot":"","sources":["../../../src/daemon/rpc-handlers/ports-rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAOL,KAAK,WAAW,EAEhB,KAAK,kBAAkB,EAExB,MAAM,qCAAqC,CAAC;AAI7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AACpG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAQ5E;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,aAAa,IAAI,kBAAkB,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAAC;IAC1D;;;;;;;OAOG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;CAC1D;AAwCD;;;;;GAKG;AACH,iBAAS,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,kBAAkB,CAmBhE;AAyBD,iBAAS,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,WAAW,CAe9C;AAID,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG;IACvE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD,CA4HA;AAID;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,GAAE,oBAAyB,GACjC,IAAI,CAKN;AAID,eAAO,MAAM,SAAS;;;;CAIZ,CAAC"}

package/dist/daemon/rpc-handlers/ports-rpc.js

@@ -0,0 +1,278 @@
+/**
+ * ports-rpc — daemon JSON-RPC handlers wiring 4 zombie ports (audit
+ * finding #8 closure) into the agent's tool surface.
+ *
+ * Each handler delegates to a bridge function from
+ * `src/orchestration/ports-bridge.ts`. The bridges construct the
+ * dependency-injected primitive (ConverseFn, ResearchPipeline,
+ * GraphStore, DomAdapter) from the business-level RPC payload — JSON
+ * cannot transport callbacks, so the bridge is the seam.
+ *
+ * Methods registered:
+ *   - ports.chatdev.run     — runs a ChatDev waterfall (default 5-phase
+ *                             or a caller-supplied phase override).
+ *   - ports.research.run    — runs the deer-flow research pipeline
+ *                             (planner -> parallel researchers -> reporter).
+ *   - ports.memgraph.ingest — ingests text into a mem0-style graph
+ *                             memory; returns triples + 2-hop neighborhoods.
+ *   - ports.scrapling.locate — adaptively locates a DOM node within a
+ *                              caller-supplied snapshot.
+ *
+ * Quality bars honored:
+ *   QB #3  honest stub — every handler reports an `ok:false` envelope
+ *          when the bridge can't reach a real dependency (e.g. research
+ *          with no search provider). No silent success.
+ *   QB #5  structured failure envelopes for missing/invalid params.
+ *   QB #6  invalid-params throws `-32602` (JSON-RPC standard).
+ *   QB #7  zero module-level mutable state — each `registerPortsHandlers`
+ *          call instantiates its own handler-set; runtime ref is closed
+ *          over lazily.
+ *   QB #14 real-code-path tests in `tests/daemon/rpc-handlers/ports-rpc.test.ts`
+ *          register a fresh map and exercise every handler.
+ *
+ * The runtime ref is plumbed through `getRuntime` (same pattern as
+ * intelligence-rpc.ts). When the runtime is unreachable, handlers that
+ * benefit from LLM augmentation (chatdev runtime mode, research planner)
+ * fall back to honest envelopes — they never invent LLM output.
+ */
+import { runChatDevWaterfall, runDeerFlowResearch, ingestTextToMemGraph, adaptiveLocateOnDom, } from "../../orchestration/ports-bridge.js";
+import { createDefaultWebSearchProvider } from "../../intelligence/search-providers.js";
+const RPC_INVALID_PARAMS = -32602;
+function rpcInvalidParams(message) {
+    return Object.assign(new Error(message), { code: RPC_INVALID_PARAMS });
+}
+// ── Helpers ──────────────────────────────────────────────
+function asString(x) {
+    return typeof x === "string" && x.length > 0 ? x : undefined;
+}
+function requireString(x, field, method) {
+    const v = asString(x);
+    if (v === undefined) {
+        throw rpcInvalidParams(`${method}: '${field}' is required (non-empty string)`);
+    }
+    return v;
+}
+function asObject(x) {
+    return x !== null && typeof x === "object" && !Array.isArray(x)
+        ? x
+        : {};
+}
+function asArray(x) {
+    return Array.isArray(x) ? x : [];
+}
+function asBoolean(x, fallback) {
+    return typeof x === "boolean" ? x : fallback;
+}
+function asPositiveInt(x) {
+    return typeof x === "number" && Number.isFinite(x) && Number.isInteger(x) && x > 0
+        ? x
+        : undefined;
+}
+function asNumber(x) {
+    return typeof x === "number" && Number.isFinite(x) ? x : undefined;
+}
+/**
+ * Build a {@link RuntimeConverseRef} that drives the WotannRuntime's
+ * `query()` async generator. Streams text chunks; concatenates and
+ * returns one string. Throws on any error chunk (the bridge catches
+ * and stamps it onto the phase outcome per QB#10).
+ */
+function adaptRuntime(runtime) {
+    return {
+        complete: async (prompt, systemPrompt) => {
+            let out = "";
+            let firstError = null;
+            for await (const chunk of runtime.query({ prompt, systemPrompt })) {
+                if (chunk.type === "text") {
+                    out += chunk.content;
+                }
+                else if (chunk.type === "error") {
+                    firstError = chunk.content;
+                    break;
+                }
+            }
+            if (firstError !== null) {
+                throw new Error(firstError);
+            }
+            return out;
+        },
+    };
+}
+// ── DomSnapshot validation ───────────────────────────────
+function asDomSnapshotNode(x, path) {
+    const obj = asObject(x);
+    const tag = asString(obj["tag"]);
+    if (!tag) {
+        throw rpcInvalidParams(`ports.scrapling.locate: ${path}.tag is required`);
+    }
+    const classesRaw = asArray(obj["classes"]);
+    const classes = classesRaw.filter((c) => typeof c === "string");
+    const text = asString(obj["text"]) ?? "";
+    const childrenRaw = asArray(obj["children"]);
+    const children = childrenRaw.map((c, i) => asDomSnapshotNode(c, `${path}.children[${i}]`));
+    const id = asString(obj["id"]);
+    return {
+        tag,
+        classes,
+        text,
+        children,
+        ...(id !== undefined ? { id } : {}),
+    };
+}
+function asDomSnapshot(x) {
+    const obj = asObject(x);
+    if (!obj["root"]) {
+        throw rpcInvalidParams("ports.scrapling.locate: 'domSnapshot.root' is required");
+    }
+    const root = asDomSnapshotNode(obj["root"], "domSnapshot.root");
+    const seedsRaw = asArray(obj["seeds"]);
+    const seeds = seedsRaw
+        .map((s) => asObject(s))
+        .map((s) => ({
+        label: asString(s["label"]) ?? "",
+        selector: asString(s["selector"]) ?? "",
+    }))
+        .filter((s) => s.label.length > 0 && s.selector.length > 0);
+    return seeds.length > 0 ? { root, seeds } : { root };
+}
+// ── Handler factory ──────────────────────────────────────
+export function createPortsHandlers(options = {}) {
+    // Per-instance: resolve the converse ref lazily so a not-yet-wired
+    // runtime can become available between handler-set creation and the
+    // first dispatch.
+    function resolveConverseRef() {
+        if (options.getConverseRef) {
+            const explicit = options.getConverseRef();
+            if (explicit)
+                return explicit;
+        }
+        if (options.getRuntime) {
+            const runtime = options.getRuntime();
+            if (runtime)
+                return adaptRuntime(runtime);
+        }
+        return null;
+    }
+    function resolveSearchProvider() {
+        if (options.getSearchProvider) {
+            return options.getSearchProvider();
+        }
+        const webProvider = createDefaultWebSearchProvider();
+        if (!webProvider)
+            return null;
+        // Adapt the WebSearchProvider shape (returns SearchHit[]) into the
+        // strategy SearchProvider shape (callback). Both already use the
+        // same SearchHit type re-exported from deep-research.
+        return async (query) => {
+            try {
+                return await webProvider.search(query);
+            }
+            catch (err) {
+                throw err instanceof Error ? err : new Error(String(err));
+            }
+        };
+    }
+    const handleChatDevRun = async (params) => {
+        const query = requireString(params["query"], "query", "ports.chatdev.run");
+        const specRaw = params["spec"];
+        let spec;
+        if (specRaw !== undefined) {
+            const specObj = asObject(specRaw);
+            const phasesRaw = asArray(specObj["phases"]);
+            const phases = phasesRaw
+                .map((p, i) => {
+                const o = asObject(p);
+                return {
+                    id: asString(o["id"]) ?? `phase-${i}`,
+                    description: asString(o["description"]) ?? "",
+                    initiatorId: asString(o["initiatorId"]) ?? "",
+                    responderId: asString(o["responderId"]) ?? "",
+                };
+            })
+                .filter((p) => p.initiatorId.length > 0 && p.responderId.length > 0);
+            const globalCharter = asString(specObj["globalCharter"]);
+            spec = {
+                ...(phases.length > 0 ? { phases } : {}),
+                ...(globalCharter !== undefined ? { globalCharter } : {}),
+            };
+        }
+        const forceFixture = asBoolean(params["forceFixture"], false);
+        // When forceFixture is false (default) we use the runtime if reachable;
+        // otherwise we silently fall back to fixture mode. The result envelope
+        // tells the caller WHICH mode was used so they can decide whether to
+        // re-issue with a real runtime attached.
+        const converseRef = forceFixture ? null : resolveConverseRef();
+        const result = await runChatDevWaterfall(spec, query, {
+            forceFixture,
+            ...(converseRef ? { runtime: converseRef } : {}),
+        });
+        return result;
+    };
+    const handleResearchRun = async (params) => {
+        const query = requireString(params["query"], "query", "ports.research.run");
+        const forceFixture = asBoolean(params["forceFixture"], false);
+        const maxSubQuestions = asPositiveInt(params["maxSubQuestions"]);
+        const converseRef = forceFixture ? null : resolveConverseRef();
+        const searchProvider = forceFixture ? null : resolveSearchProvider();
+        const bridgeOptions = {
+            forceFixture,
+            ...(converseRef ? { runtime: converseRef } : {}),
+            ...(searchProvider ? { searchProvider } : {}),
+            ...(maxSubQuestions !== undefined ? { maxSubQuestions } : {}),
+        };
+        return await runDeerFlowResearch(query, bridgeOptions);
+    };
+    const handleMemGraphIngest = async (params) => {
+        const text = requireString(params["text"], "text", "ports.memgraph.ingest");
+        const persist = asBoolean(params["persist"], false);
+        const turnId = asString(params["turnId"]);
+        const persistencePath = asString(params["persistencePath"]);
+        return await ingestTextToMemGraph(text, {
+            persist,
+            ...(turnId !== undefined ? { turnId } : {}),
+            ...(persistencePath !== undefined ? { persistencePath } : {}),
+        });
+    };
+    const handleScraplingLocate = async (params) => {
+        const snapshotRaw = params["domSnapshot"];
+        if (snapshotRaw === undefined || snapshotRaw === null) {
+            throw rpcInvalidParams("ports.scrapling.locate: 'domSnapshot' is required");
+        }
+        const snapshot = asDomSnapshot(snapshotRaw);
+        const queryRaw = asObject(params["query"]);
+        const label = requireString(queryRaw["label"], "query.label", "ports.scrapling.locate");
+        const selector = asString(queryRaw["selector"]);
+        const minScore = asNumber(params["minScore"]);
+        const opts = minScore !== undefined ? { minScore } : {};
+        return await adaptiveLocateOnDom(snapshot, selector !== undefined ? { label, selector } : { label }, opts);
+    };
+    const handlers = {
+        "ports.chatdev.run": handleChatDevRun,
+        "ports.research.run": handleResearchRun,
+        "ports.memgraph.ingest": handleMemGraphIngest,
+        "ports.scrapling.locate": handleScraplingLocate,
+    };
+    return { handlers };
+}
+// ── Registration ────────────────────────────────────────
+/**
+ * Register the 4 ports.* handlers onto the given handler map. Mirrors
+ * the {@link registerIntelligenceHandlers} shape — a single import +
+ * a single call from kairos-rpc.ts.
+ *
+ * Idempotent: re-registering overwrites the existing entries with the
+ * new handler-set's bound closures.
+ */
+export function registerPortsHandlers(handlers, options = {}) {
+    const { handlers: built } = createPortsHandlers(options);
+    for (const [method, handler] of Object.entries(built)) {
+        handlers.set(method, handler);
+    }
+}
+// ── Test-only exports ───────────────────────────────────
+export const _testOnly = {
+    adaptRuntime,
+    asDomSnapshot,
+    createPortsHandlers,
+};
+//# sourceMappingURL=ports-rpc.js.map

package/dist/daemon/rpc-handlers/ports-rpc.js.map

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

package/dist/hooks/agentmemory-event-taxonomy.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Agentmemory event taxonomy — ported from rohitg00/agentmemory's hook engine
+ * (plugin/hooks/hooks.json + src/hooks/*.ts).
+ *
+ * WHAT: The canonical 12-event schema that a hook engine emits to a memory
+ *   backend. Each event is a discriminated union over the `event` field, so
+ *   the receiver can fan out per-type handlers with full type safety.
+ *
+ * WHY: We're not porting the agentmemory backend (HTTP endpoints, REST
+ *   client, image-data extraction) — those are integration-specific and
+ *   live in a follow-up. What's portable today is the *taxonomy* itself:
+ *   the 12 canonical event names plus the per-event payload shape. Pinning
+ *   the schema in WOTANN now lets the hook engine, the memory backend, and
+ *   any future plugins all speak the same vocabulary.
+ *
+ * WHERE: The hook engine emits these events; consumers (memory store,
+ *   audit log, telemetry) subscribe. The TypeScript discriminated union
+ *   lets a single switch statement cover every event type with exhaustive
+ *   checking.
+ *
+ * HOW: `AGENTMEMORY_EVENT_TYPES` is a const tuple of the 12 strings,
+ *   `AgentMemoryEventType` is its string-literal union, and
+ *   `AgentMemoryEvent<T>` is the per-event payload shape keyed by `event`.
+ *   `isAgentMemoryEvent` is a structural type guard for runtime validation
+ *   (boundary use only — internal code should rely on the static union).
+ *   `serializeEvent` produces a JSON string with sorted keys so identical
+ *   events hash identically — useful for dedup and audit.
+ *
+ * NOTE: The user-spec deviates from the upstream taxonomy in one place:
+ *   we expose `diagnostics` instead of `notification`. The intent is to
+ *   reserve a generic "engine emitted a diagnostic" channel; the upstream
+ *   `notification` carried Claude Code permission prompts specifically,
+ *   which doesn't generalise. The 11 other events match the upstream 1:1.
+ */
+/** The 12 canonical event names, in the order they appear in the hook flow. */
+export declare const AGENTMEMORY_EVENT_TYPES: readonly ["pre-tool-use", "post-tool-use", "post-tool-failure", "pre-compact", "prompt-submit", "session-start", "session-end", "stop", "subagent-start", "subagent-stop", "task-completed", "diagnostics"];
+/** String-literal union over the 12 canonical event names. */
+export type AgentMemoryEventType = (typeof AGENTMEMORY_EVENT_TYPES)[number];
+interface BaseEventFields {
+    readonly sessionId: string;
+    readonly cwd?: string;
+    readonly timestamp?: number;
+}
+export interface PreToolUsePayload extends BaseEventFields {
+    readonly toolName: string;
+    readonly args: Readonly<Record<string, unknown>>;
+}
+export interface PostToolUsePayload extends BaseEventFields {
+    readonly toolName: string;
+    readonly args: Readonly<Record<string, unknown>>;
+    readonly output: unknown;
+}
+export interface PostToolFailurePayload extends BaseEventFields {
+    readonly toolName: string;
+    readonly args: Readonly<Record<string, unknown>>;
+    readonly error: string;
+}
+export interface PreCompactPayload extends BaseEventFields {
+    readonly tokensUsed?: number;
+    readonly tokensWindow?: number;
+}
+export interface PromptSubmitPayload extends BaseEventFields {
+    readonly prompt: string;
+}
+export interface SessionStartPayload extends BaseEventFields {
+    readonly entrypoint?: string;
+}
+export interface SessionEndPayload extends BaseEventFields {
+    readonly reason?: string;
+}
+export interface StopPayload extends BaseEventFields {
+    readonly lastAssistantMessage?: string;
+}
+export interface SubagentStartPayload extends BaseEventFields {
+    readonly agentId: string;
+    readonly agentType?: string;
+}
+export interface SubagentStopPayload extends BaseEventFields {
+    readonly agentId: string;
+    readonly agentType?: string;
+    readonly lastMessage?: string;
+}
+export interface TaskCompletedPayload extends BaseEventFields {
+    readonly taskId: string;
+    readonly taskSubject?: string;
+    readonly taskDescription?: string;
+    readonly teammateName?: string;
+    readonly teamName?: string;
+}
+export interface DiagnosticsPayload extends BaseEventFields {
+    /** Diagnostic level — info / warn / error. Free string to keep flexibility. */
+    readonly level: "info" | "warn" | "error";
+    readonly message: string;
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Lookup table: maps each event name to its payload shape. Used internally
+ * to derive `AgentMemoryEvent<T>`; not intended for direct consumer use.
+ */
+interface PayloadMap {
+    readonly "pre-tool-use": PreToolUsePayload;
+    readonly "post-tool-use": PostToolUsePayload;
+    readonly "post-tool-failure": PostToolFailurePayload;
+    readonly "pre-compact": PreCompactPayload;
+    readonly "prompt-submit": PromptSubmitPayload;
+    readonly "session-start": SessionStartPayload;
+    readonly "session-end": SessionEndPayload;
+    readonly stop: StopPayload;
+    readonly "subagent-start": SubagentStartPayload;
+    readonly "subagent-stop": SubagentStopPayload;
+    readonly "task-completed": TaskCompletedPayload;
+    readonly diagnostics: DiagnosticsPayload;
+}
+/**
+ * The discriminated union: an `AgentMemoryEvent<T>` is the payload for
+ * event type `T` plus an `event: T` tag. Default `T` is the full union.
+ *
+ * Use a `switch (e.event)` over `e: AgentMemoryEvent<AgentMemoryEventType>`
+ * to dispatch — TypeScript narrows the payload type per arm automatically.
+ */
+export type AgentMemoryEvent<T extends AgentMemoryEventType = AgentMemoryEventType> = T extends AgentMemoryEventType ? {
+    readonly event: T;
+} & PayloadMap[T] : never;
+/**
+ * Type guard: structurally verifies that `x` is an `AgentMemoryEvent`.
+ *
+ * The check confirms (a) it's an object, (b) `x.event` is one of the 12
+ * canonical names, and (c) `x.sessionId` is a string. Per-event field
+ * presence is NOT validated — that's the consumer's job once it knows the
+ * variant. Keeps this guard cheap for boundary checks.
+ */
+export declare function isAgentMemoryEvent(x: unknown): x is AgentMemoryEvent;
+/**
+ * Serialise an event to JSON with stable key order so identical events
+ * hash to identical strings. Useful for dedup, replay, and audit logs.
+ *
+ * Sorting is lexicographic over top-level keys; nested objects keep their
+ * insertion order (deep sorting is rarely worth the cost — most nested
+ * payloads here are tool args, which the caller already produced in some
+ * canonical form).
+ */
+export declare function serializeEvent(e: AgentMemoryEvent): string;
+export {};
+//# sourceMappingURL=agentmemory-event-taxonomy.d.ts.map

package/dist/hooks/agentmemory-event-taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentmemory-event-taxonomy.d.ts","sourceRoot":"","sources":["../../src/hooks/agentmemory-event-taxonomy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,6MAa1B,CAAC;AAEX,8DAA8D;AAC9D,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAc5E,UAAU,eAAe;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED;;;GAGG;AACH,UAAU,UAAU;IAClB,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,sBAAsB,CAAC;IACrD,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC;IAC9C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,oBAAoB,GAAG,oBAAoB,IAChF,CAAC,SAAS,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAEjF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,gBAAgB,CAMpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAO1D"}

package/dist/hooks/agentmemory-event-taxonomy.js

@@ -0,0 +1,85 @@
+/**
+ * Agentmemory event taxonomy — ported from rohitg00/agentmemory's hook engine
+ * (plugin/hooks/hooks.json + src/hooks/*.ts).
+ *
+ * WHAT: The canonical 12-event schema that a hook engine emits to a memory
+ *   backend. Each event is a discriminated union over the `event` field, so
+ *   the receiver can fan out per-type handlers with full type safety.
+ *
+ * WHY: We're not porting the agentmemory backend (HTTP endpoints, REST
+ *   client, image-data extraction) — those are integration-specific and
+ *   live in a follow-up. What's portable today is the *taxonomy* itself:
+ *   the 12 canonical event names plus the per-event payload shape. Pinning
+ *   the schema in WOTANN now lets the hook engine, the memory backend, and
+ *   any future plugins all speak the same vocabulary.
+ *
+ * WHERE: The hook engine emits these events; consumers (memory store,
+ *   audit log, telemetry) subscribe. The TypeScript discriminated union
+ *   lets a single switch statement cover every event type with exhaustive
+ *   checking.
+ *
+ * HOW: `AGENTMEMORY_EVENT_TYPES` is a const tuple of the 12 strings,
+ *   `AgentMemoryEventType` is its string-literal union, and
+ *   `AgentMemoryEvent<T>` is the per-event payload shape keyed by `event`.
+ *   `isAgentMemoryEvent` is a structural type guard for runtime validation
+ *   (boundary use only — internal code should rely on the static union).
+ *   `serializeEvent` produces a JSON string with sorted keys so identical
+ *   events hash identically — useful for dedup and audit.
+ *
+ * NOTE: The user-spec deviates from the upstream taxonomy in one place:
+ *   we expose `diagnostics` instead of `notification`. The intent is to
+ *   reserve a generic "engine emitted a diagnostic" channel; the upstream
+ *   `notification` carried Claude Code permission prompts specifically,
+ *   which doesn't generalise. The 11 other events match the upstream 1:1.
+ */
+/** The 12 canonical event names, in the order they appear in the hook flow. */
+export const AGENTMEMORY_EVENT_TYPES = [
+    "pre-tool-use",
+    "post-tool-use",
+    "post-tool-failure",
+    "pre-compact",
+    "prompt-submit",
+    "session-start",
+    "session-end",
+    "stop",
+    "subagent-start",
+    "subagent-stop",
+    "task-completed",
+    "diagnostics",
+];
+/**
+ * Type guard: structurally verifies that `x` is an `AgentMemoryEvent`.
+ *
+ * The check confirms (a) it's an object, (b) `x.event` is one of the 12
+ * canonical names, and (c) `x.sessionId` is a string. Per-event field
+ * presence is NOT validated — that's the consumer's job once it knows the
+ * variant. Keeps this guard cheap for boundary checks.
+ */
+export function isAgentMemoryEvent(x) {
+    if (typeof x !== "object" || x === null)
+        return false;
+    const obj = x;
+    if (typeof obj.event !== "string")
+        return false;
+    if (typeof obj.sessionId !== "string")
+        return false;
+    return AGENTMEMORY_EVENT_TYPES.includes(obj.event);
+}
+/**
+ * Serialise an event to JSON with stable key order so identical events
+ * hash to identical strings. Useful for dedup, replay, and audit logs.
+ *
+ * Sorting is lexicographic over top-level keys; nested objects keep their
+ * insertion order (deep sorting is rarely worth the cost — most nested
+ * payloads here are tool args, which the caller already produced in some
+ * canonical form).
+ */
+export function serializeEvent(e) {
+    const sortedKeys = Object.keys(e).sort();
+    const ordered = {};
+    for (const k of sortedKeys) {
+        ordered[k] = e[k];
+    }
+    return JSON.stringify(ordered);
+}
+//# sourceMappingURL=agentmemory-event-taxonomy.js.map

package/dist/hooks/agentmemory-event-taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentmemory-event-taxonomy.js","sourceRoot":"","sources":["../../src/hooks/agentmemory-event-taxonomy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,cAAc;IACd,eAAe;IACf,mBAAmB;IACnB,aAAa;IACb,eAAe;IACf,eAAe;IACf,aAAa;IACb,MAAM;IACN,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,aAAa;CACL,CAAC;AAoHX;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,CAAU;IAC3C,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,GAAG,GAAG,CAA6C,CAAC;IAC1D,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,OAAQ,uBAA6C,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,CAAmB;IAChD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,OAAO,CAAC,CAAC,CAAC,GAAI,CAAwC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/dist/hooks/built-in.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"built-in.d.ts","sourceRoot":"","sources":["../../src/hooks/built-in.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,aAAa,CAAC;AAexE,eAAO,MAAM,aAAa,EAAE,WAgB3B,CAAC;AAuCF,eAAO,MAAM,gBAAgB,EAAE,WAiC9B,CAAC;AAIF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAoBhE;AAID,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,MAAU,EAAE,OAAO,GAAE,MAAU,GAAG,WAAW,CA6BvF;AAID,eAAO,MAAM,mBAAmB,EAAE,WAejC,CAAC;AAqBF,eAAO,MAAM,gBAAgB,EAAE,WAiB9B,CAAC;AA8BF,eAAO,MAAM,eAAe,EAAE,WA4D7B,CAAC;AAiBF,eAAO,MAAM,cAAc,EAAE,WAuB5B,CAAC;AAIF,eAAO,MAAM,cAAc,EAAE,WA6C5B,CAAC;AAWF,eAAO,MAAM,oBAAoB,EAAE,WAiBlC,CAAC;AAcF,eAAO,MAAM,iBAAiB,EAAE,WA8C/B,CAAC;AAoCF,sFAAsF;AACtF,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEnE;AAED,eAAO,MAAM,mBAAmB,EAAE,WAyBjC,CAAC;AA2CF,eAAO,MAAM,kBAAkB,EAAE,WAgChC,CAAC;AAIF,eAAO,MAAM,cAAc,EAAE,WAyE5B,CAAC;AAmCF,eAAO,MAAM,QAAQ,EAAE,WAqBtB,CAAC;AAIF,wBAAgB,kBAAkB,IAAI,WAAW,CAmChD;AAID,eAAO,MAAM,kBAAkB,EAAE,WAyChC,CAAC;AAIF,wBAAgB,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CAkBxE;AAID,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,cAAc,CAAC,GAAG,MAAM,GACpD,WAAW,CAqCb;AAaD,wBAAgB,0BAA0B,CACxC,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,cAAc,CAAC,GAAG,MAAM,GACpD,WAAW,CAqCb;AAiBD,eAAO,MAAM,uBAAuB,EAAE,WAkBrC,CAAC;AAeF,eAAO,MAAM,sBAAsB,EAAE,WAsCpC,CAAC;AAIF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,WAAW,CAmErD;AAoBD,eAAO,MAAM,qBAAqB,EAAE,WAgCnC,CAAC;AA4BF,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,eAAO,MAAM,eAAe,EAAE,WAkB7B,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,WA0B7B,CAAC;AAIF;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,WA0C9B,CAAC;AAIF;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,IAAI,WAAW,CAsBzD;AAID;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAkBlC,CAAC;AAIF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAC9C,WAAW,CAyBb;AAID,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,EAClB,SAAS,CAAC,EAAE,YAAY,CAAC,OAAO,cAAc,CAAC,GAC9C,IAAI,CA+CN"}
+{"version":3,"file":"built-in.d.ts","sourceRoot":"","sources":["../../src/hooks/built-in.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,aAAa,CAAC;AAgBxE,eAAO,MAAM,aAAa,EAAE,WAgB3B,CAAC;AAuCF,eAAO,MAAM,gBAAgB,EAAE,WAiC9B,CAAC;AAIF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAoBhE;AAID,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,MAAU,EAAE,OAAO,GAAE,MAAU,GAAG,WAAW,CA6BvF;AAID,eAAO,MAAM,mBAAmB,EAAE,WAejC,CAAC;AAqBF,eAAO,MAAM,gBAAgB,EAAE,WAiB9B,CAAC;AA8BF,eAAO,MAAM,eAAe,EAAE,WA4D7B,CAAC;AAiBF,eAAO,MAAM,cAAc,EAAE,WAuB5B,CAAC;AAIF,eAAO,MAAM,cAAc,EAAE,WA6C5B,CAAC;AAWF,eAAO,MAAM,oBAAoB,EAAE,WAiBlC,CAAC;AAcF,eAAO,MAAM,iBAAiB,EAAE,WA8C/B,CAAC;AAoCF,sFAAsF;AACtF,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEnE;AAED,eAAO,MAAM,mBAAmB,EAAE,WAyBjC,CAAC;AA2CF,eAAO,MAAM,kBAAkB,EAAE,WAgChC,CAAC;AAIF,eAAO,MAAM,cAAc,EAAE,WAyE5B,CAAC;AAmCF,eAAO,MAAM,QAAQ,EAAE,WAqBtB,CAAC;AAIF,wBAAgB,kBAAkB,IAAI,WAAW,CAmChD;AAID,eAAO,MAAM,kBAAkB,EAAE,WAyChC,CAAC;AAIF,wBAAgB,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CAkBxE;AAID,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,cAAc,CAAC,GAAG,MAAM,GACpD,WAAW,CAqCb;AAaD,wBAAgB,0BAA0B,CACxC,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,cAAc,CAAC,GAAG,MAAM,GACpD,WAAW,CAqCb;AAiBD,eAAO,MAAM,uBAAuB,EAAE,WAkBrC,CAAC;AAeF,eAAO,MAAM,sBAAsB,EAAE,WAsCpC,CAAC;AAIF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,WAAW,CAmErD;AAoBD,eAAO,MAAM,qBAAqB,EAAE,WAgCnC,CAAC;AA4BF,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,eAAO,MAAM,eAAe,EAAE,WAkB7B,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,WA0B7B,CAAC;AAIF;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAoC9B,CAAC;AAIF;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,IAAI,WAAW,CAsBzD;AAID;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAkBlC,CAAC;AAIF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAC9C,WAAW,CAyBb;AAID,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,EAClB,SAAS,CAAC,EAAE,YAAY,CAAC,OAAO,cAAc,CAAC,GAC9C,IAAI,CA+CN"}