@cleocode/core 2026.3.56 → 2026.3.58

package/dist/hooks/handlers/file-hooks.js

@@ -0,0 +1,80 @@
+/**
+ * File Change Hook Handlers - Wave 2 of T5237
+ *
+ * Captures file change events to BRAIN via memory.observe.
+ * Includes 5-second dedup and path-based filtering to avoid noisy writes.
+ * Auto-registers on module load.
+ *
+ * Disabled by default. Set CLEO_BRAIN_CAPTURE_FILES=true to enable.
+ */
+import { isAbsolute, relative } from 'node:path';
+import { hooks } from '../registry.js';
+function isMissingBrainSchemaError(err) {
+    if (!(err instanceof Error))
+        return false;
+    const message = String(err.message || '').toLowerCase();
+    return message.includes('no such table') && message.includes('brain_');
+}
+/** 5-second dedup map: filePath -> last dispatch timestamp */
+const recentWrites = new Map();
+const DEDUP_INTERVAL_MS = 5_000;
+/** Path patterns to exclude from brain observations (internal/noisy files). */
+const SKIP_PATTERNS = [
+    /\.cleo\//, // All .cleo internal files (sessions.json, config.json, tasks.db, etc.)
+    /\.cleo\\/, // Windows path variant
+    /\/\.temp\//, // Temp directories
+    /cleo-test-/, // Vitest test temp dirs
+    /cleo-edge-/, // Edge-case test temp dirs
+    /node_modules\//, // Dependencies
+    /\.git\//, // Git internals
+    /dist\//, // Build output
+];
+/** Check whether a relative path should be skipped. */
+function shouldSkipPath(relativePath) {
+    return SKIP_PATTERNS.some((pattern) => pattern.test(relativePath));
+}
+/**
+ * Handle onFileChange - capture file changes to BRAIN
+ *
+ * Gated behind CLEO_BRAIN_CAPTURE_FILES=true env var.
+ * Deduplicates rapid writes to the same file within a 5-second window.
+ * Filters out .cleo/ internal files and test temp directories.
+ * Converts absolute paths to project-relative paths.
+ */
+export async function handleFileChange(projectRoot, payload) {
+    // Opt-in gate: disabled by default to prevent observation noise
+    if (process.env['CLEO_BRAIN_CAPTURE_FILES'] !== 'true')
+        return;
+    // 5-second dedup
+    const now = Date.now();
+    const lastWrite = recentWrites.get(payload.filePath);
+    if (lastWrite && now - lastWrite < DEDUP_INTERVAL_MS)
+        return;
+    recentWrites.set(payload.filePath, now);
+    // Convert absolute paths to relative, normalize to forward slashes
+    const relativePath = (isAbsolute(payload.filePath) ? relative(projectRoot, payload.filePath) : payload.filePath).replaceAll('\\', '/');
+    // Skip internal/noisy files
+    if (shouldSkipPath(relativePath))
+        return;
+    const { observeBrain } = await import('../../memory/brain-retrieval.js');
+    try {
+        await observeBrain(projectRoot, {
+            text: `File ${payload.changeType}: ${relativePath}${payload.sizeBytes != null ? ` (${payload.sizeBytes} bytes)` : ''}`,
+            title: `File changed: ${relativePath}`,
+            type: 'change',
+            sourceType: 'agent',
+        });
+    }
+    catch (err) {
+        if (!isMissingBrainSchemaError(err))
+            throw err;
+    }
+}
+// Register handler on module load
+hooks.register({
+    id: 'brain-file-change',
+    event: 'onFileChange',
+    handler: handleFileChange,
+    priority: 100,
+});
+//# sourceMappingURL=file-hooks.js.map

package/dist/hooks/handlers/file-hooks.js.map

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

package/dist/hooks/handlers/index.js

@@ -0,0 +1,19 @@
+/**
+ * Hook Handlers Index - Phase 2D of T5237
+ *
+ * Barrel export for all hook handlers. Importing this module will
+ * auto-register all handlers with the hook registry.
+ */
+// Import handlers to trigger auto-registration on module load
+import './session-hooks.js';
+import './task-hooks.js';
+import './error-hooks.js';
+import './file-hooks.js';
+import './mcp-hooks.js';
+export { handleError } from './error-hooks.js';
+export { handleFileChange } from './file-hooks.js';
+export { handlePromptSubmit, handleResponseComplete } from './mcp-hooks.js';
+// Re-export handler functions for explicit use
+export { handleSessionEnd, handleSessionStart } from './session-hooks.js';
+export { handleToolComplete, handleToolStart } from './task-hooks.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8DAA8D;AAC9D,OAAO,oBAAoB,CAAC;AAC5B,OAAO,iBAAiB,CAAC;AACzB,OAAO,kBAAkB,CAAC;AAC1B,OAAO,iBAAiB,CAAC;AACzB,OAAO,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,+CAA+C;AAC/C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/hooks/handlers/mcp-hooks.js

@@ -0,0 +1,80 @@
+/**
+ * MCP Prompt/Response Hook Handlers - Wave 2 of T5237
+ *
+ * Handlers for onPromptSubmit and onResponseComplete events.
+ * By default, NO brain capture (too noisy). Brain observation is
+ * opt-in via CLEO_BRAIN_CAPTURE_MCP=true environment variable.
+ * Auto-registers on module load.
+ */
+import { hooks } from '../registry.js';
+function isMissingBrainSchemaError(err) {
+    if (!(err instanceof Error))
+        return false;
+    const message = String(err.message || '').toLowerCase();
+    return message.includes('no such table') && message.includes('brain_');
+}
+/**
+ * Check if brain capture is enabled for MCP events.
+ * Defaults to false (too noisy for normal operation).
+ */
+function isBrainCaptureEnabled() {
+    return process.env['CLEO_BRAIN_CAPTURE_MCP'] === 'true';
+}
+/**
+ * Handle onPromptSubmit - optionally capture prompt events to BRAIN
+ *
+ * No-op by default. Set CLEO_BRAIN_CAPTURE_MCP=true to enable.
+ */
+export async function handlePromptSubmit(projectRoot, payload) {
+    if (!isBrainCaptureEnabled())
+        return;
+    const { observeBrain } = await import('../../memory/brain-retrieval.js');
+    try {
+        await observeBrain(projectRoot, {
+            text: `Prompt submitted: ${payload.gateway}:${payload.domain}.${payload.operation}${payload.source ? ` from ${payload.source}` : ''}`,
+            title: `Prompt: ${payload.domain}.${payload.operation}`,
+            type: 'discovery',
+            sourceType: 'agent',
+        });
+    }
+    catch (err) {
+        if (!isMissingBrainSchemaError(err))
+            throw err;
+    }
+}
+/**
+ * Handle onResponseComplete - optionally capture response events to BRAIN
+ *
+ * No-op by default. Set CLEO_BRAIN_CAPTURE_MCP=true to enable.
+ */
+export async function handleResponseComplete(projectRoot, payload) {
+    if (!isBrainCaptureEnabled())
+        return;
+    const { observeBrain } = await import('../../memory/brain-retrieval.js');
+    try {
+        await observeBrain(projectRoot, {
+            text: `Response ${payload.success ? 'success' : 'failed'}: ${payload.gateway}:${payload.domain}.${payload.operation}${payload.durationMs != null ? ` (${payload.durationMs}ms)` : ''}${payload.errorCode ? ` error: ${payload.errorCode}` : ''}`,
+            title: `Response: ${payload.domain}.${payload.operation}`,
+            type: payload.success ? 'discovery' : 'change',
+            sourceType: 'agent',
+        });
+    }
+    catch (err) {
+        if (!isMissingBrainSchemaError(err))
+            throw err;
+    }
+}
+// Register handlers on module load
+hooks.register({
+    id: 'brain-prompt-submit',
+    event: 'onPromptSubmit',
+    handler: handlePromptSubmit,
+    priority: 100,
+});
+hooks.register({
+    id: 'brain-response-complete',
+    event: 'onResponseComplete',
+    handler: handleResponseComplete,
+    priority: 100,
+});
+//# sourceMappingURL=mcp-hooks.js.map

package/dist/hooks/handlers/mcp-hooks.js.map

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

package/dist/hooks/handlers/session-hooks.js

@@ -0,0 +1,73 @@
+/**
+ * Session Hook Handlers - Phase 2D of T5237
+ *
+ * Handlers that capture session lifecycle events to BRAIN via memory.observe.
+ * Auto-registers on module load.
+ */
+import { hooks } from '../registry.js';
+function isMissingBrainSchemaError(err) {
+    if (!(err instanceof Error))
+        return false;
+    const message = String(err.message || '').toLowerCase();
+    return message.includes('no such table') && message.includes('brain_');
+}
+/**
+ * Handle onSessionStart - capture initial session context
+ */
+export async function handleSessionStart(projectRoot, payload) {
+    const { observeBrain } = await import('../../memory/brain-retrieval.js');
+    try {
+        await observeBrain(projectRoot, {
+            text: `Session started: ${payload.name}\nScope: ${JSON.stringify(payload.scope)}\nAgent: ${payload.agent || 'unknown'}`,
+            title: `Session start: ${payload.name}`,
+            type: 'discovery',
+            sourceSessionId: payload.sessionId,
+            sourceType: 'agent',
+        });
+    }
+    catch (err) {
+        if (!isMissingBrainSchemaError(err))
+            throw err;
+    }
+}
+/**
+ * Handle onSessionEnd - capture session summary
+ */
+export async function handleSessionEnd(projectRoot, payload) {
+    const { observeBrain } = await import('../../memory/brain-retrieval.js');
+    try {
+        await observeBrain(projectRoot, {
+            text: `Session ended: ${payload.sessionId}\nDuration: ${payload.duration}s\nTasks completed: ${payload.tasksCompleted.join(', ') || 'none'}`,
+            title: `Session end: ${payload.sessionId}`,
+            type: 'change',
+            sourceSessionId: payload.sessionId,
+            sourceType: 'agent',
+        });
+    }
+    catch (err) {
+        if (!isMissingBrainSchemaError(err))
+            throw err;
+    }
+    // Auto-grade session and feed insights to brain.db (best-effort)
+    try {
+        const { gradeSession } = await import('../../sessions/session-grade.js');
+        await gradeSession(payload.sessionId, projectRoot);
+    }
+    catch {
+        // Grading must never block session end
+    }
+}
+// Register handlers on module load
+hooks.register({
+    id: 'brain-session-start',
+    event: 'onSessionStart',
+    handler: handleSessionStart,
+    priority: 100,
+});
+hooks.register({
+    id: 'brain-session-end',
+    event: 'onSessionEnd',
+    handler: handleSessionEnd,
+    priority: 100,
+});
+//# sourceMappingURL=session-hooks.js.map

package/dist/hooks/handlers/session-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-hooks.js","sourceRoot":"","sources":["../../../src/hooks/handlers/session-hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,SAAS,yBAAyB,CAAC,GAAY;IAC7C,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACxD,OAAO,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,OAA8B;IAE9B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,WAAW,EAAE;YAC9B,IAAI,EAAE,oBAAoB,OAAO,CAAC,IAAI,YAAY,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,CAAC,KAAK,IAAI,SAAS,EAAE;YACvH,KAAK,EAAE,kBAAkB,OAAO,CAAC,IAAI,EAAE;YACvC,IAAI,EAAE,WAAW;YACjB,eAAe,EAAE,OAAO,CAAC,SAAS;YAClC,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;YAAE,MAAM,GAAG,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,OAA4B;IAE5B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,WAAW,EAAE;YAC9B,IAAI,EAAE,kBAAkB,OAAO,CAAC,SAAS,eAAe,OAAO,CAAC,QAAQ,uBAAuB,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;YAC5I,KAAK,EAAE,gBAAgB,OAAO,CAAC,SAAS,EAAE;YAC1C,IAAI,EAAE,QAAQ;YACd,eAAe,EAAE,OAAO,CAAC,SAAS;YAClC,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;YAAE,MAAM,GAAG,CAAC;IACjD,CAAC;IAED,iEAAiE;IACjE,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;QACzE,MAAM,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;AACH,CAAC;AAED,mCAAmC;AACnC,KAAK,CAAC,QAAQ,CAAC;IACb,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,gBAAgB;IACvB,OAAO,EAAE,kBAAkB;IAC3B,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,KAAK,CAAC,QAAQ,CAAC;IACb,EAAE,EAAE,mBAAmB;IACvB,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,gBAAgB;IACzB,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC"}

package/dist/hooks/handlers/task-hooks.js

@@ -0,0 +1,63 @@
+/**
+ * Task Hook Handlers - Phase 2D of T5237
+ *
+ * Handlers that capture task lifecycle events to BRAIN via memory.observe.
+ * Auto-registers on module load.
+ */
+import { hooks } from '../registry.js';
+function isMissingBrainSchemaError(err) {
+    if (!(err instanceof Error))
+        return false;
+    const message = String(err.message || '').toLowerCase();
+    return message.includes('no such table') && message.includes('brain_');
+}
+/**
+ * Handle onToolStart (maps to task.start in CLEO)
+ */
+export async function handleToolStart(projectRoot, payload) {
+    const { observeBrain } = await import('../../memory/brain-retrieval.js');
+    try {
+        await observeBrain(projectRoot, {
+            text: `Started work on ${payload.taskId}: ${payload.taskTitle}`,
+            title: `Task start: ${payload.taskId}`,
+            type: 'change',
+            sourceType: 'agent',
+        });
+    }
+    catch (err) {
+        if (!isMissingBrainSchemaError(err))
+            throw err;
+    }
+}
+/**
+ * Handle onToolComplete (maps to task.complete in CLEO)
+ */
+export async function handleToolComplete(projectRoot, payload) {
+    const { observeBrain } = await import('../../memory/brain-retrieval.js');
+    try {
+        await observeBrain(projectRoot, {
+            text: `Task ${payload.taskId} completed with status: ${payload.status}`,
+            title: `Task complete: ${payload.taskId}`,
+            type: 'change',
+            sourceType: 'agent',
+        });
+    }
+    catch (err) {
+        if (!isMissingBrainSchemaError(err))
+            throw err;
+    }
+}
+// Register handlers
+hooks.register({
+    id: 'brain-tool-start',
+    event: 'onToolStart',
+    handler: handleToolStart,
+    priority: 100,
+});
+hooks.register({
+    id: 'brain-tool-complete',
+    event: 'onToolComplete',
+    handler: handleToolComplete,
+    priority: 100,
+});
+//# sourceMappingURL=task-hooks.js.map

package/dist/hooks/handlers/task-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-hooks.js","sourceRoot":"","sources":["../../../src/hooks/handlers/task-hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,SAAS,yBAAyB,CAAC,GAAY;IAC7C,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACxD,OAAO,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,OAA2B;IAE3B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,WAAW,EAAE;YAC9B,IAAI,EAAE,mBAAmB,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE;YAC/D,KAAK,EAAE,eAAe,OAAO,CAAC,MAAM,EAAE;YACtC,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;YAAE,MAAM,GAAG,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,OAA8B;IAE9B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,WAAW,EAAE;YAC9B,IAAI,EAAE,QAAQ,OAAO,CAAC,MAAM,2BAA2B,OAAO,CAAC,MAAM,EAAE;YACvE,KAAK,EAAE,kBAAkB,OAAO,CAAC,MAAM,EAAE;YACzC,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;YAAE,MAAM,GAAG,CAAC;IACjD,CAAC;AACH,CAAC;AAED,oBAAoB;AACpB,KAAK,CAAC,QAAQ,CAAC;IACb,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,aAAa;IACpB,OAAO,EAAE,eAAe;IACxB,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,KAAK,CAAC,QAAQ,CAAC;IACb,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,gBAAgB;IACvB,OAAO,EAAE,kBAAkB;IAC3B,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,13 @@
+/**
+ * Hooks System - Barrel Export
+ *
+ * Central export point for the CLEO hooks system.
+ * Import from here to access the hook registry, types, handlers, and
+ * Zod payload validation schemas.
+ *
+ * @module @cleocode/cleo/hooks
+ */
+export * from './handlers/index.js';
+export { HookPayloadSchema, OnAgentCompletePayloadSchema, OnAgentSpawnPayloadSchema, OnCascadeStartPayloadSchema, OnErrorPayloadSchema, OnFileChangePayloadSchema, OnPatrolPayloadSchema, OnPromptSubmitPayloadSchema, OnResponseCompletePayloadSchema, OnSessionEndPayloadSchema, OnSessionStartPayloadSchema, OnToolCompletePayloadSchema, OnToolStartPayloadSchema, OnWorkAvailablePayloadSchema, validatePayload, } from './payload-schemas.js';
+export { HookRegistry, hooks } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,qBAAqB,CAAC;AAEpC,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,+BAA+B,EAC/B,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,wBAAwB,EACxB,4BAA4B,EAC5B,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC"}

package/dist/hooks/payload-schemas.js

@@ -0,0 +1,163 @@
+/**
+ * Zod validation schemas for hook event payloads.
+ *
+ * Provides runtime validation for all hook payload types defined in
+ * ./types.ts. Each schema mirrors its corresponding TypeScript interface
+ * and can be used to validate payloads at dispatch time.
+ *
+ * @module @cleocode/cleo/hooks/payload-schemas
+ */
+import { z } from 'zod/v4';
+// ============================================================================
+// Base Payload Schema
+// ============================================================================
+/** Zod schema for {@link HookPayload}. */
+export const HookPayloadSchema = z.object({
+    timestamp: z.iso.datetime(),
+    sessionId: z.string().optional(),
+    taskId: z.string().optional(),
+    providerId: z.string().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+// ============================================================================
+// CAAMP-mapped Event Payload Schemas
+// ============================================================================
+/** Zod schema for {@link OnSessionStartPayload}. */
+export const OnSessionStartPayloadSchema = HookPayloadSchema.extend({
+    sessionId: z.string(),
+    name: z.string(),
+    scope: z.string(),
+    agent: z.string().optional(),
+});
+/** Zod schema for {@link OnSessionEndPayload}. */
+export const OnSessionEndPayloadSchema = HookPayloadSchema.extend({
+    sessionId: z.string(),
+    duration: z.number(),
+    tasksCompleted: z.array(z.string()),
+});
+/** Zod schema for {@link OnToolStartPayload}. */
+export const OnToolStartPayloadSchema = HookPayloadSchema.extend({
+    taskId: z.string(),
+    taskTitle: z.string(),
+    previousTask: z.string().optional(),
+});
+/** Zod schema for {@link OnToolCompletePayload}. */
+export const OnToolCompletePayloadSchema = HookPayloadSchema.extend({
+    taskId: z.string(),
+    taskTitle: z.string(),
+    status: z.enum(['done', 'archived', 'cancelled']),
+});
+/** Zod schema for {@link OnFileChangePayload}. */
+export const OnFileChangePayloadSchema = HookPayloadSchema.extend({
+    filePath: z.string(),
+    changeType: z.enum(['write', 'create', 'delete']),
+    sizeBytes: z.number().optional(),
+});
+/** Zod schema for {@link OnErrorPayload}. */
+export const OnErrorPayloadSchema = HookPayloadSchema.extend({
+    errorCode: z.union([z.number(), z.string()]),
+    message: z.string(),
+    domain: z.string().optional(),
+    operation: z.string().optional(),
+    gateway: z.string().optional(),
+    stack: z.string().optional(),
+});
+/** Zod schema for {@link OnPromptSubmitPayload}. */
+export const OnPromptSubmitPayloadSchema = HookPayloadSchema.extend({
+    gateway: z.string(),
+    domain: z.string(),
+    operation: z.string(),
+    source: z.string().optional(),
+});
+/** Zod schema for {@link OnResponseCompletePayload}. */
+export const OnResponseCompletePayloadSchema = HookPayloadSchema.extend({
+    gateway: z.string(),
+    domain: z.string(),
+    operation: z.string(),
+    success: z.boolean(),
+    durationMs: z.number().optional(),
+    errorCode: z.string().optional(),
+});
+// ============================================================================
+// CLEO Internal Event Payload Schemas
+// ============================================================================
+/** Zod schema for {@link OnWorkAvailablePayload}. */
+export const OnWorkAvailablePayloadSchema = HookPayloadSchema.extend({
+    taskIds: z.array(z.string()),
+    epicId: z.string().optional(),
+    chainId: z.string().optional(),
+    reason: z.enum(['dependency-cleared', 'new-task', 'retry', 'manual', 'patrol']).optional(),
+});
+/** Zod schema for {@link OnAgentSpawnPayload}. */
+export const OnAgentSpawnPayloadSchema = HookPayloadSchema.extend({
+    agentId: z.string(),
+    role: z.string(),
+    adapterId: z.string().optional(),
+    taskId: z.string().optional(),
+});
+/** Zod schema for {@link OnAgentCompletePayload}. */
+export const OnAgentCompletePayloadSchema = HookPayloadSchema.extend({
+    agentId: z.string(),
+    role: z.string(),
+    status: z.enum(['complete', 'partial', 'blocked', 'failed']),
+    taskId: z.string().optional(),
+    summary: z.string().optional(),
+});
+/** Zod schema for {@link OnCascadeStartPayload}. */
+export const OnCascadeStartPayloadSchema = HookPayloadSchema.extend({
+    cascadeId: z.string(),
+    chainId: z.string().optional(),
+    tesseraId: z.string().optional(),
+    taskIds: z.array(z.string()).optional(),
+});
+/** Zod schema for {@link OnPatrolPayload}. */
+export const OnPatrolPayloadSchema = HookPayloadSchema.extend({
+    watcherId: z.string(),
+    patrolType: z.enum(['health', 'sweep', 'refinery', 'watcher', 'custom']),
+    scope: z.string().optional(),
+});
+// ============================================================================
+// Event -> Schema Mapping
+// ============================================================================
+/**
+ * Map from hook event name to its corresponding Zod schema.
+ *
+ * Used by {@link validatePayload} for runtime dispatch. Events not in
+ * this map fall back to the base {@link HookPayloadSchema}.
+ */
+const EVENT_SCHEMA_MAP = {
+    onSessionStart: OnSessionStartPayloadSchema,
+    onSessionEnd: OnSessionEndPayloadSchema,
+    onToolStart: OnToolStartPayloadSchema,
+    onToolComplete: OnToolCompletePayloadSchema,
+    onFileChange: OnFileChangePayloadSchema,
+    onError: OnErrorPayloadSchema,
+    onPromptSubmit: OnPromptSubmitPayloadSchema,
+    onResponseComplete: OnResponseCompletePayloadSchema,
+    onWorkAvailable: OnWorkAvailablePayloadSchema,
+    onAgentSpawn: OnAgentSpawnPayloadSchema,
+    onAgentComplete: OnAgentCompletePayloadSchema,
+    onCascadeStart: OnCascadeStartPayloadSchema,
+    onPatrol: OnPatrolPayloadSchema,
+};
+/**
+ * Validate a hook payload against its event-specific Zod schema.
+ *
+ * Falls back to the base {@link HookPayloadSchema} for events without
+ * a dedicated schema. Returns a result object rather than throwing,
+ * so callers can decide how to handle validation failures.
+ *
+ * @param event - The hook event name
+ * @param payload - The payload to validate
+ * @returns Validation result with any error messages
+ */
+export function validatePayload(event, payload) {
+    const schema = EVENT_SCHEMA_MAP[event] ?? HookPayloadSchema;
+    const result = schema.safeParse(payload);
+    if (result.success) {
+        return { valid: true, errors: [] };
+    }
+    const errors = result.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`);
+    return { valid: false, errors };
+}
+//# sourceMappingURL=payload-schemas.js.map

package/dist/hooks/payload-schemas.js.map

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

package/dist/hooks/provider-hooks.js

@@ -0,0 +1,34 @@
+/**
+ * Provider Hook Capabilities - Phase 2C of T5237
+ *
+ * Helper functions for querying which providers support which hook events.
+ * Wraps CAAMP's provider discovery functions with CLEO-specific helpers.
+ *
+ * @module @cleocode/cleo/hooks/provider-hooks
+ */
+import { getCommonHookEvents, getProvidersByHookEvent, } from '@cleocode/caamp';
+import { isProviderHookEvent } from './types.js';
+/**
+ * Get all providers that support a specific hook event
+ *
+ * @param event - The hook event to query
+ * @returns Array of provider IDs that support this event
+ */
+export function getHookCapableProviders(event) {
+    if (!isProviderHookEvent(event)) {
+        return [];
+    }
+    const providers = getProvidersByHookEvent(event);
+    return providers.map((p) => p.id);
+}
+/**
+ * Get hook events supported by all specified providers
+ *
+ * @param providerIds - Optional array of provider IDs (uses all active providers if omitted)
+ * @returns Array of hook events supported by all specified providers
+ */
+export function getSharedHookEvents(providerIds) {
+    return getCommonHookEvents(providerIds);
+}
+export { getCommonHookEvents, getProvidersByHookEvent };
+//# sourceMappingURL=provider-hooks.js.map

package/dist/hooks/provider-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-hooks.js","sourceRoot":"","sources":["../../src/hooks/provider-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAkB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAgB;IACtD,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAsB;IACxD,OAAO,mBAAmB,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAGD,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,CAAC"}