@cleocode/core 2026.3.72 → 2026.3.73

package/dist/index.js

@@ -732,22 +732,42 @@ __export(registry_exports, {
   HookRegistry: () => HookRegistry,
   hooks: () => hooks
 });
-var DEFAULT_HOOK_CONFIG, HookRegistry, hooks;
+var LEGACY_EVENT_MAP, DEFAULT_HOOK_CONFIG, HookRegistry, hooks;
 var init_registry = __esm({
   "packages/core/src/hooks/registry.ts"() {
     "use strict";
     init_logger();
+    LEGACY_EVENT_MAP = {
+      onSessionStart: "SessionStart",
+      onSessionEnd: "SessionEnd",
+      onToolStart: "PreToolUse",
+      onToolComplete: "PostToolUse",
+      onFileChange: "Notification",
+      onError: "PostToolUseFailure",
+      onPromptSubmit: "PromptSubmit",
+      onResponseComplete: "ResponseComplete"
+    };
     DEFAULT_HOOK_CONFIG = {
       enabled: true,
       events: {
-        onSessionStart: true,
-        onSessionEnd: true,
-        onToolStart: true,
-        onToolComplete: true,
-        onFileChange: true,
-        onError: true,
-        onPromptSubmit: true,
-        onResponseComplete: true,
+        // CAAMP canonical events (16)
+        SessionStart: true,
+        SessionEnd: true,
+        PromptSubmit: true,
+        ResponseComplete: true,
+        PreToolUse: true,
+        PostToolUse: true,
+        PostToolUseFailure: true,
+        PermissionRequest: true,
+        SubagentStart: true,
+        SubagentStop: true,
+        PreModel: true,
+        PostModel: true,
+        PreCompact: true,
+        PostCompact: true,
+        Notification: true,
+        ConfigChange: true,
+        // CLEO internal coordination events (5)
         onWorkAvailable: true,
         onAgentSpawn: true,
         onAgentComplete: true,
@@ -758,12 +778,33 @@ var init_registry = __esm({
     HookRegistry = class {
       handlers = /* @__PURE__ */ new Map();
       config = DEFAULT_HOOK_CONFIG;
+      /**
+       * Resolve a potentially-legacy event name to its canonical equivalent.
+       *
+       * If the event name matches a known legacy `on`-prefix name, it is
+       * remapped and a deprecation warning is logged. Unknown names pass through
+       * unchanged so callers using the new canonical names are unaffected.
+       */
+      resolveEvent(event) {
+        const canonical = LEGACY_EVENT_MAP[event];
+        if (canonical) {
+          getLogger("hooks").warn(
+            { legacyEvent: event, canonicalEvent: canonical },
+            `[DEPRECATED] Hook event '${event}' has been renamed to '${canonical}'. Update your handler registration.`
+          );
+          return canonical;
+        }
+        return event;
+      }
       /**
        * Register a hook handler for a specific event.
        *
        * Handlers are sorted by priority (highest first) and executed
        * in parallel when the event is dispatched.
        *
+       * Backward compatibility: legacy `on`-prefix event names are automatically
+       * remapped to their canonical equivalents.
+       *
        * @param registration - The hook registration containing event, handler, priority, and ID
        * @returns A function to unregister the handler
        *
@@ -771,7 +812,7 @@ var init_registry = __esm({
        * ```typescript
        * const unregister = hooks.register({
        *   id: 'my-handler',
-       *   event: 'onSessionStart',
+       *   event: 'SessionStart',
        *   handler: async (root, payload) => { console.log('Session started'); },
        *   priority: 100
        * });
@@ -780,12 +821,14 @@ var init_registry = __esm({
        * ```
        */
       register(registration) {
-        const list = this.handlers.get(registration.event) || [];
-        list.push(registration);
+        const resolvedEvent = this.resolveEvent(registration.event);
+        const resolvedRegistration = { ...registration, event: resolvedEvent };
+        const list = this.handlers.get(resolvedEvent) || [];
+        list.push(resolvedRegistration);
         list.sort((a, b) => b.priority - a.priority);
-        this.handlers.set(registration.event, list);
+        this.handlers.set(resolvedEvent, list);
         return () => {
-          const handlers = this.handlers.get(registration.event);
+          const handlers = this.handlers.get(resolvedEvent);
           if (handlers) {
             const idx = handlers.findIndex((h) => h.id === registration.id);
             if (idx !== -1) handlers.splice(idx, 1);
@@ -799,14 +842,17 @@ var init_registry = __esm({
        * execution. Errors in individual handlers are logged but do not block
        * other handlers or propagate to the caller.
        *
-       * @param event - The CAAMP hook event to dispatch
+       * Backward compatibility: legacy `on`-prefix event names are automatically
+       * remapped to their canonical equivalents.
+       *
+       * @param event - The CAAMP canonical hook event to dispatch
        * @param projectRoot - The project root directory path
        * @param payload - The event payload (typed by event)
        * @returns Promise that resolves when all handlers have completed
        *
        * @example
        * ```typescript
-       * await hooks.dispatch('onSessionStart', '/project', {
+       * await hooks.dispatch('SessionStart', '/project', {
        *   timestamp: new Date().toISOString(),
        *   sessionId: 'sess-123',
        *   name: 'My Session',
@@ -816,15 +862,19 @@ var init_registry = __esm({
        */
       async dispatch(event, projectRoot, payload) {
         if (!this.config.enabled) return;
-        if (!this.config.events[event]) return;
-        const handlers = this.handlers.get(event);
+        const resolvedEvent = this.resolveEvent(event);
+        if (!this.config.events[resolvedEvent]) return;
+        const handlers = this.handlers.get(resolvedEvent);
         if (!handlers || handlers.length === 0) return;
         await Promise.allSettled(
           handlers.map(async (reg) => {
             try {
               await reg.handler(projectRoot, payload);
             } catch (error40) {
-              getLogger("hooks").warn({ err: error40, hookId: reg.id, event }, "Hook handler failed");
+              getLogger("hooks").warn(
+                { err: error40, hookId: reg.id, event: resolvedEvent },
+                "Hook handler failed"
+              );
             }
           })
         );
@@ -833,12 +883,14 @@ var init_registry = __esm({
        * Check if a specific event is currently enabled.
        *
        * Both the global enabled flag and the per-event flag must be true.
+       * Automatically resolves legacy `on`-prefix event names.
        *
        * @param event - The CAAMP hook event to check
        * @returns True if the event is enabled
        */
       isEnabled(event) {
-        return this.config.enabled && this.config.events[event];
+        const resolvedEvent = this.resolveEvent(event);
+        return this.config.enabled && this.config.events[resolvedEvent];
       }
       /**
        * Update the hook system configuration.
@@ -850,7 +902,7 @@ var init_registry = __esm({
        * @example
        * ```typescript
        * hooks.setConfig({ enabled: false }); // Disable all hooks
-       * hooks.setConfig({ events: { onError: false } }); // Disable specific event
+       * hooks.setConfig({ events: { PostToolUseFailure: false } }); // Disable specific event
        * ```
        */
       setConfig(config2) {
@@ -868,12 +920,14 @@ var init_registry = __esm({
        * List all registered handlers for a specific event.
        *
        * Returns handlers in priority order (highest first).
+       * Automatically resolves legacy `on`-prefix event names.
        *
        * @param event - The CAAMP hook event
        * @returns Array of hook registrations
        */
       listHandlers(event) {
-        return [...this.handlers.get(event) || []];
+        const resolvedEvent = this.resolveEvent(event);
+        return [...this.handlers.get(resolvedEvent) || []];
       }
     };
     hooks = new HookRegistry();
@@ -13584,7 +13638,7 @@ async function saveJson(filePath, data, options) {
     }
     await atomicWriteJson(filePath, data, { indent: options?.indent });
     Promise.resolve().then(() => (init_registry(), registry_exports)).then(
-      ({ hooks: h }) => h.dispatch("onFileChange", process.cwd(), {
+      ({ hooks: h }) => h.dispatch("Notification", process.cwd(), {
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         filePath,
         changeType: "write"
@@ -18379,13 +18433,13 @@ var init_session_hooks = __esm({
     init_memory_bridge_refresh();
     hooks.register({
       id: "brain-session-start",
-      event: "onSessionStart",
+      event: "SessionStart",
       handler: handleSessionStart,
       priority: 100
     });
     hooks.register({
       id: "brain-session-end",
-      event: "onSessionEnd",
+      event: "SessionEnd",
       handler: handleSessionEnd,
       priority: 100
     });
@@ -18432,13 +18486,13 @@ var init_task_hooks = __esm({
     init_memory_bridge_refresh();
     hooks.register({
       id: "brain-tool-start",
-      event: "onToolStart",
+      event: "PreToolUse",
       handler: handleToolStart,
       priority: 100
     });
     hooks.register({
       id: "brain-tool-complete",
-      event: "onToolComplete",
+      event: "PostToolUse",
       handler: handleToolComplete,
       priority: 100
     });
@@ -18468,7 +18522,7 @@ var init_error_hooks = __esm({
     init_registry();
     hooks.register({
       id: "brain-error",
-      event: "onError",
+      event: "PostToolUseFailure",
       handler: handleError,
       priority: 100
     });
@@ -18499,6 +18553,7 @@ async function isFileCaptureEnabled(projectRoot) {
   }
 }
 async function handleFileChange(projectRoot, payload) {
+  if (!payload.filePath || !payload.changeType) return;
   if (!await isFileCaptureEnabled(projectRoot)) return;
   const now = Date.now();
   const lastWrite = recentWrites.get(payload.filePath);
@@ -18545,7 +18600,7 @@ var init_file_hooks = __esm({
     ];
     hooks.register({
       id: "brain-file-change",
-      event: "onFileChange",
+      event: "Notification",
       handler: handleFileChange,
       priority: 100
     });
@@ -18599,22 +18654,51 @@ async function handleResponseComplete(projectRoot, payload) {
     if (!isMissingBrainSchemaError4(err)) throw err;
   }
 }
+async function handleSystemNotification(projectRoot, payload) {
+  if (payload.filePath || payload.changeType) return;
+  if (!payload.message) return;
+  try {
+    const { loadConfig: loadConfig3 } = await Promise.resolve().then(() => (init_config(), config_exports));
+    const config2 = await loadConfig3(projectRoot);
+    if (!config2.brain?.autoCapture) return;
+  } catch {
+    return;
+  }
+  const { observeBrain: observeBrain2 } = await Promise.resolve().then(() => (init_brain_retrieval(), brain_retrieval_exports));
+  try {
+    await observeBrain2(projectRoot, {
+      text: `System notification: ${payload.message}`,
+      title: `Notification: ${payload.message.slice(0, 60)}`,
+      type: "discovery",
+      sourceSessionId: payload.sessionId,
+      sourceType: "agent"
+    });
+  } catch (err) {
+    if (!isMissingBrainSchemaError4(err)) throw err;
+  }
+}
 var init_mcp_hooks = __esm({
   "packages/core/src/hooks/handlers/mcp-hooks.ts"() {
     "use strict";
     init_registry();
     hooks.register({
       id: "brain-prompt-submit",
-      event: "onPromptSubmit",
+      event: "PromptSubmit",
       handler: handlePromptSubmit,
       priority: 100
     });
     hooks.register({
       id: "brain-response-complete",
-      event: "onResponseComplete",
+      event: "ResponseComplete",
       handler: handleResponseComplete,
       priority: 100
     });
+    hooks.register({
+      id: "brain-system-notification",
+      event: "Notification",
+      handler: handleSystemNotification,
+      priority: 90
+    });
   }
 });
 
@@ -18691,19 +18775,158 @@ var init_work_capture_hooks = __esm({
     ]);
     hooks.register({
       id: "work-capture-prompt-submit",
-      event: "onPromptSubmit",
+      event: "PromptSubmit",
       handler: handleWorkPromptSubmit,
       priority: 90
     });
     hooks.register({
       id: "work-capture-response-complete",
-      event: "onResponseComplete",
+      event: "ResponseComplete",
       handler: handleWorkResponseComplete,
       priority: 90
     });
   }
 });
 
+// packages/core/src/hooks/handlers/agent-hooks.ts
+function isMissingBrainSchemaError6(err) {
+  if (!(err instanceof Error)) return false;
+  const message = String(err.message || "").toLowerCase();
+  return message.includes("no such table") && message.includes("brain_");
+}
+async function isAutoCaptureEnabled(projectRoot) {
+  try {
+    const { loadConfig: loadConfig3 } = await Promise.resolve().then(() => (init_config(), config_exports));
+    const config2 = await loadConfig3(projectRoot);
+    return config2.brain?.autoCapture ?? false;
+  } catch {
+    return false;
+  }
+}
+async function handleSubagentStart(projectRoot, payload) {
+  if (!await isAutoCaptureEnabled(projectRoot)) return;
+  const { observeBrain: observeBrain2 } = await Promise.resolve().then(() => (init_brain_retrieval(), brain_retrieval_exports));
+  const rolePart = payload.role ? ` role=${payload.role}` : "";
+  const taskPart = payload.taskId ? ` task=${payload.taskId}` : "";
+  try {
+    await observeBrain2(projectRoot, {
+      text: `Subagent spawned: ${payload.agentId}${rolePart}${taskPart}`,
+      title: `Subagent start: ${payload.agentId}`,
+      type: "discovery",
+      sourceSessionId: payload.sessionId,
+      sourceType: "agent"
+    });
+  } catch (err) {
+    if (!isMissingBrainSchemaError6(err)) throw err;
+  }
+}
+async function handleSubagentStop(projectRoot, payload) {
+  if (!await isAutoCaptureEnabled(projectRoot)) return;
+  const { observeBrain: observeBrain2 } = await Promise.resolve().then(() => (init_brain_retrieval(), brain_retrieval_exports));
+  const statusPart = payload.status ? ` status=${payload.status}` : "";
+  const taskPart = payload.taskId ? ` task=${payload.taskId}` : "";
+  const summaryPart = payload.summary ? `
+Summary: ${payload.summary}` : "";
+  try {
+    await observeBrain2(projectRoot, {
+      text: `Subagent completed: ${payload.agentId}${statusPart}${taskPart}${summaryPart}`,
+      title: `Subagent stop: ${payload.agentId}`,
+      type: "change",
+      sourceSessionId: payload.sessionId,
+      sourceType: "agent"
+    });
+  } catch (err) {
+    if (!isMissingBrainSchemaError6(err)) throw err;
+  }
+}
+var init_agent_hooks = __esm({
+  "packages/core/src/hooks/handlers/agent-hooks.ts"() {
+    "use strict";
+    init_registry();
+    hooks.register({
+      id: "brain-subagent-start",
+      event: "SubagentStart",
+      handler: handleSubagentStart,
+      priority: 100
+    });
+    hooks.register({
+      id: "brain-subagent-stop",
+      event: "SubagentStop",
+      handler: handleSubagentStop,
+      priority: 100
+    });
+  }
+});
+
+// packages/core/src/hooks/handlers/context-hooks.ts
+function isMissingBrainSchemaError7(err) {
+  if (!(err instanceof Error)) return false;
+  const message = String(err.message || "").toLowerCase();
+  return message.includes("no such table") && message.includes("brain_");
+}
+async function isAutoCaptureEnabled2(projectRoot) {
+  try {
+    const { loadConfig: loadConfig3 } = await Promise.resolve().then(() => (init_config(), config_exports));
+    const config2 = await loadConfig3(projectRoot);
+    return config2.brain?.autoCapture ?? false;
+  } catch {
+    return false;
+  }
+}
+async function handlePreCompact(projectRoot, payload) {
+  if (!await isAutoCaptureEnabled2(projectRoot)) return;
+  const { observeBrain: observeBrain2 } = await Promise.resolve().then(() => (init_brain_retrieval(), brain_retrieval_exports));
+  const tokensPart = payload.tokensBefore != null ? ` (~${payload.tokensBefore.toLocaleString()} tokens)` : "";
+  const reasonPart = payload.reason ? ` Reason: ${payload.reason}` : "";
+  try {
+    await observeBrain2(projectRoot, {
+      text: `Context compaction about to begin${tokensPart}.${reasonPart}`,
+      title: "Pre-compaction context snapshot",
+      type: "discovery",
+      sourceSessionId: payload.sessionId,
+      sourceType: "agent"
+    });
+  } catch (err) {
+    if (!isMissingBrainSchemaError7(err)) throw err;
+  }
+}
+async function handlePostCompact(projectRoot, payload) {
+  if (!await isAutoCaptureEnabled2(projectRoot)) return;
+  const { observeBrain: observeBrain2 } = await Promise.resolve().then(() => (init_brain_retrieval(), brain_retrieval_exports));
+  const statusPart = payload.success ? "succeeded" : "failed";
+  const beforePart = payload.tokensBefore != null ? ` before=${payload.tokensBefore.toLocaleString()}` : "";
+  const afterPart = payload.tokensAfter != null ? ` after=${payload.tokensAfter.toLocaleString()}` : "";
+  try {
+    await observeBrain2(projectRoot, {
+      text: `Context compaction ${statusPart}${beforePart}${afterPart}`,
+      title: "Post-compaction record",
+      type: "change",
+      sourceSessionId: payload.sessionId,
+      sourceType: "agent"
+    });
+  } catch (err) {
+    if (!isMissingBrainSchemaError7(err)) throw err;
+  }
+}
+var init_context_hooks = __esm({
+  "packages/core/src/hooks/handlers/context-hooks.ts"() {
+    "use strict";
+    init_registry();
+    hooks.register({
+      id: "brain-pre-compact",
+      event: "PreCompact",
+      handler: handlePreCompact,
+      priority: 100
+    });
+    hooks.register({
+      id: "brain-post-compact",
+      event: "PostCompact",
+      handler: handlePostCompact,
+      priority: 100
+    });
+  }
+});
+
 // packages/core/src/hooks/handlers/index.ts
 var init_handlers = __esm({
   "packages/core/src/hooks/handlers/index.ts"() {
@@ -18714,6 +18937,10 @@ var init_handlers = __esm({
     init_file_hooks();
     init_mcp_hooks();
     init_work_capture_hooks();
+    init_agent_hooks();
+    init_context_hooks();
+    init_agent_hooks();
+    init_context_hooks();
     init_error_hooks();
     init_file_hooks();
     init_mcp_hooks();
@@ -20564,7 +20791,7 @@ async function startSession(options, cwd, accessor) {
     });
   }
   const { hooks: hooks2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));
-  hooks2.dispatch("onSessionStart", cwd ?? process.cwd(), {
+  hooks2.dispatch("SessionStart", cwd ?? process.cwd(), {
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
     sessionId: session.id,
     name: options.name,
@@ -20602,7 +20829,7 @@ async function endSession(options = {}, cwd, accessor) {
   session.endedAt = (/* @__PURE__ */ new Date()).toISOString();
   const duration3 = Math.floor((Date.now() - new Date(session.startedAt).getTime()) / 1e3);
   const { hooks: hooks2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));
-  hooks2.dispatch("onSessionEnd", cwd ?? process.cwd(), {
+  hooks2.dispatch("SessionEnd", cwd ?? process.cwd(), {
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
     sessionId: session.id,
     duration: duration3,
@@ -28502,10 +28729,15 @@ __export(hooks_exports, {
   OnWorkAvailablePayloadSchema: () => OnWorkAvailablePayloadSchema,
   handleError: () => handleError,
   handleFileChange: () => handleFileChange,
+  handlePostCompact: () => handlePostCompact,
+  handlePreCompact: () => handlePreCompact,
   handlePromptSubmit: () => handlePromptSubmit,
   handleResponseComplete: () => handleResponseComplete,
   handleSessionEnd: () => handleSessionEnd,
   handleSessionStart: () => handleSessionStart,
+  handleSubagentStart: () => handleSubagentStart,
+  handleSubagentStop: () => handleSubagentStop,
+  handleSystemNotification: () => handleSystemNotification,
   handleToolComplete: () => handleToolComplete,
   handleToolStart: () => handleToolStart,
   handleWorkPromptSubmit: () => handleWorkPromptSubmit,
@@ -39662,33 +39894,42 @@ var HookPayloadSchema = external_exports.object({
   providerId: external_exports.string().optional(),
   metadata: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
 });
-var OnSessionStartPayloadSchema = HookPayloadSchema.extend({
+var SessionStartPayloadSchema = HookPayloadSchema.extend({
   sessionId: external_exports.string(),
   name: external_exports.string(),
   scope: external_exports.string(),
   agent: external_exports.string().optional()
 });
-var OnSessionEndPayloadSchema = HookPayloadSchema.extend({
+var OnSessionStartPayloadSchema = SessionStartPayloadSchema;
+var SessionEndPayloadSchema = HookPayloadSchema.extend({
   sessionId: external_exports.string(),
   duration: external_exports.number(),
   tasksCompleted: external_exports.array(external_exports.string())
 });
-var OnToolStartPayloadSchema = HookPayloadSchema.extend({
+var OnSessionEndPayloadSchema = SessionEndPayloadSchema;
+var PreToolUsePayloadSchema = HookPayloadSchema.extend({
   taskId: external_exports.string(),
   taskTitle: external_exports.string(),
-  previousTask: external_exports.string().optional()
+  previousTask: external_exports.string().optional(),
+  toolName: external_exports.string().optional(),
+  toolInput: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
 });
-var OnToolCompletePayloadSchema = HookPayloadSchema.extend({
+var OnToolStartPayloadSchema = PreToolUsePayloadSchema;
+var PostToolUsePayloadSchema = HookPayloadSchema.extend({
   taskId: external_exports.string(),
   taskTitle: external_exports.string(),
-  status: external_exports.enum(["done", "archived", "cancelled"])
+  status: external_exports.enum(["done", "archived", "cancelled"]),
+  toolResult: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
 });
-var OnFileChangePayloadSchema = HookPayloadSchema.extend({
-  filePath: external_exports.string(),
-  changeType: external_exports.enum(["write", "create", "delete"]),
-  sizeBytes: external_exports.number().optional()
+var OnToolCompletePayloadSchema = PostToolUsePayloadSchema;
+var NotificationPayloadSchema = HookPayloadSchema.extend({
+  filePath: external_exports.string().optional(),
+  changeType: external_exports.enum(["write", "create", "delete"]).optional(),
+  sizeBytes: external_exports.number().optional(),
+  message: external_exports.string().optional()
 });
-var OnErrorPayloadSchema = HookPayloadSchema.extend({
+var OnFileChangePayloadSchema = NotificationPayloadSchema;
+var PostToolUseFailurePayloadSchema = HookPayloadSchema.extend({
   errorCode: external_exports.union([external_exports.number(), external_exports.string()]),
   message: external_exports.string(),
   domain: external_exports.string().optional(),
@@ -39696,13 +39937,15 @@ var OnErrorPayloadSchema = HookPayloadSchema.extend({
   gateway: external_exports.string().optional(),
   stack: external_exports.string().optional()
 });
-var OnPromptSubmitPayloadSchema = HookPayloadSchema.extend({
+var OnErrorPayloadSchema = PostToolUseFailurePayloadSchema;
+var PromptSubmitPayloadSchema = HookPayloadSchema.extend({
   gateway: external_exports.string(),
   domain: external_exports.string(),
   operation: external_exports.string(),
   source: external_exports.string().optional()
 });
-var OnResponseCompletePayloadSchema = HookPayloadSchema.extend({
+var OnPromptSubmitPayloadSchema = PromptSubmitPayloadSchema;
+var ResponseCompletePayloadSchema = HookPayloadSchema.extend({
   gateway: external_exports.string(),
   domain: external_exports.string(),
   operation: external_exports.string(),
@@ -39710,6 +39953,32 @@ var OnResponseCompletePayloadSchema = HookPayloadSchema.extend({
   durationMs: external_exports.number().optional(),
   errorCode: external_exports.string().optional()
 });
+var OnResponseCompletePayloadSchema = ResponseCompletePayloadSchema;
+var SubagentStartPayloadSchema = HookPayloadSchema.extend({
+  agentId: external_exports.string(),
+  role: external_exports.string().optional(),
+  taskId: external_exports.string().optional()
+});
+var SubagentStopPayloadSchema = HookPayloadSchema.extend({
+  agentId: external_exports.string(),
+  status: external_exports.enum(["complete", "partial", "blocked", "failed"]).optional(),
+  taskId: external_exports.string().optional(),
+  summary: external_exports.string().optional()
+});
+var PreCompactPayloadSchema = HookPayloadSchema.extend({
+  tokensBefore: external_exports.number().optional(),
+  reason: external_exports.string().optional()
+});
+var PostCompactPayloadSchema = HookPayloadSchema.extend({
+  tokensBefore: external_exports.number().optional(),
+  tokensAfter: external_exports.number().optional(),
+  success: external_exports.boolean()
+});
+var ConfigChangePayloadSchema = HookPayloadSchema.extend({
+  key: external_exports.string(),
+  previousValue: external_exports.unknown().optional(),
+  newValue: external_exports.unknown().optional()
+});
 var OnWorkAvailablePayloadSchema = HookPayloadSchema.extend({
   taskIds: external_exports.array(external_exports.string()),
   epicId: external_exports.string().optional(),
@@ -39741,14 +40010,21 @@ var OnPatrolPayloadSchema = HookPayloadSchema.extend({
   scope: external_exports.string().optional()
 });
 var EVENT_SCHEMA_MAP = {
-  onSessionStart: OnSessionStartPayloadSchema,
-  onSessionEnd: OnSessionEndPayloadSchema,
-  onToolStart: OnToolStartPayloadSchema,
-  onToolComplete: OnToolCompletePayloadSchema,
-  onFileChange: OnFileChangePayloadSchema,
-  onError: OnErrorPayloadSchema,
-  onPromptSubmit: OnPromptSubmitPayloadSchema,
-  onResponseComplete: OnResponseCompletePayloadSchema,
+  // CAAMP canonical events (16)
+  SessionStart: SessionStartPayloadSchema,
+  SessionEnd: SessionEndPayloadSchema,
+  PreToolUse: PreToolUsePayloadSchema,
+  PostToolUse: PostToolUsePayloadSchema,
+  Notification: NotificationPayloadSchema,
+  PostToolUseFailure: PostToolUseFailurePayloadSchema,
+  PromptSubmit: PromptSubmitPayloadSchema,
+  ResponseComplete: ResponseCompletePayloadSchema,
+  SubagentStart: SubagentStartPayloadSchema,
+  SubagentStop: SubagentStopPayloadSchema,
+  PreCompact: PreCompactPayloadSchema,
+  PostCompact: PostCompactPayloadSchema,
+  ConfigChange: ConfigChangePayloadSchema,
+  // CLEO internal coordination events (5)
   onWorkAvailable: OnWorkAvailablePayloadSchema,
   onAgentSpawn: OnAgentSpawnPayloadSchema,
   onAgentComplete: OnAgentCompletePayloadSchema,
@@ -60620,7 +60896,7 @@ async function startTask(taskId, cwd, accessor) {
     accessor
   );
   const { hooks: hooks2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));
-  hooks2.dispatch("onToolStart", cwd ?? process.cwd(), {
+  hooks2.dispatch("PreToolUse", cwd ?? process.cwd(), {
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
     taskId,
     taskTitle: task.title
@@ -60646,7 +60922,7 @@ async function stopTask(cwd, accessor) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   if (taskId && task) {
     const { hooks: hooks2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));
-    hooks2.dispatch("onToolComplete", cwd ?? process.cwd(), {
+    hooks2.dispatch("PostToolUse", cwd ?? process.cwd(), {
       timestamp: now,
       taskId,
       taskTitle: task.title,
@@ -65364,7 +65640,7 @@ async function restoreSession(projectRoot, snapshot, options = {}, accessor) {
   await acc.upsertSingleSession(restoredSession);
   try {
     const { hooks: hooks2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));
-    await hooks2.dispatch("onSessionStart", projectRoot, {
+    await hooks2.dispatch("SessionStart", projectRoot, {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       sessionId: restoredSession.id,
       name: restoredSession.name,