@cleocode/core 2026.4.31 → 2026.4.35

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,220 @@
+/**
+ * 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';
+// ============================================================================
+// 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 SessionStartPayload}. */
+export const SessionStartPayloadSchema = HookPayloadSchema.extend({
+    sessionId: z.string(),
+    name: z.string(),
+    scope: z.string(),
+    agent: z.string().optional(),
+});
+/** @deprecated Use {@link SessionStartPayloadSchema}. Kept for backward compatibility. */
+export const OnSessionStartPayloadSchema = SessionStartPayloadSchema;
+/** Zod schema for {@link SessionEndPayload}. */
+export const SessionEndPayloadSchema = HookPayloadSchema.extend({
+    sessionId: z.string(),
+    duration: z.number(),
+    tasksCompleted: z.array(z.string()),
+});
+/** @deprecated Use {@link SessionEndPayloadSchema}. Kept for backward compatibility. */
+export const OnSessionEndPayloadSchema = SessionEndPayloadSchema;
+/** Zod schema for {@link PreToolUsePayload}. */
+export const PreToolUsePayloadSchema = HookPayloadSchema.extend({
+    taskId: z.string(),
+    taskTitle: z.string(),
+    previousTask: z.string().optional(),
+    toolName: z.string().optional(),
+    toolInput: z.record(z.string(), z.unknown()).optional(),
+});
+/** @deprecated Use {@link PreToolUsePayloadSchema}. Kept for backward compatibility. */
+export const OnToolStartPayloadSchema = PreToolUsePayloadSchema;
+/** Zod schema for {@link PostToolUsePayload}. */
+export const PostToolUsePayloadSchema = HookPayloadSchema.extend({
+    taskId: z.string(),
+    taskTitle: z.string(),
+    status: z.enum(['done', 'archived', 'cancelled']),
+    toolResult: z.record(z.string(), z.unknown()).optional(),
+});
+/** @deprecated Use {@link PostToolUsePayloadSchema}. Kept for backward compatibility. */
+export const OnToolCompletePayloadSchema = PostToolUsePayloadSchema;
+/** Zod schema for {@link NotificationPayload}. */
+export const NotificationPayloadSchema = HookPayloadSchema.extend({
+    filePath: z.string().optional(),
+    changeType: z.enum(['write', 'create', 'delete']).optional(),
+    sizeBytes: z.number().optional(),
+    message: z.string().optional(),
+});
+/** @deprecated Use {@link NotificationPayloadSchema}. Kept for backward compatibility. */
+export const OnFileChangePayloadSchema = NotificationPayloadSchema;
+/** Zod schema for {@link PostToolUseFailurePayload}. */
+export const PostToolUseFailurePayloadSchema = 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(),
+});
+/** @deprecated Use {@link PostToolUseFailurePayloadSchema}. Kept for backward compatibility. */
+export const OnErrorPayloadSchema = PostToolUseFailurePayloadSchema;
+/** Zod schema for {@link PromptSubmitPayload}. */
+export const PromptSubmitPayloadSchema = HookPayloadSchema.extend({
+    gateway: z.string(),
+    domain: z.string(),
+    operation: z.string(),
+    source: z.string().optional(),
+});
+/** @deprecated Use {@link PromptSubmitPayloadSchema}. Kept for backward compatibility. */
+export const OnPromptSubmitPayloadSchema = PromptSubmitPayloadSchema;
+/** Zod schema for {@link ResponseCompletePayload}. */
+export const ResponseCompletePayloadSchema = HookPayloadSchema.extend({
+    gateway: z.string(),
+    domain: z.string(),
+    operation: z.string(),
+    success: z.boolean(),
+    durationMs: z.number().optional(),
+    errorCode: z.string().optional(),
+});
+/** @deprecated Use {@link ResponseCompletePayloadSchema}. Kept for backward compatibility. */
+export const OnResponseCompletePayloadSchema = ResponseCompletePayloadSchema;
+/** Zod schema for {@link SubagentStartPayload}. */
+export const SubagentStartPayloadSchema = HookPayloadSchema.extend({
+    agentId: z.string(),
+    role: z.string().optional(),
+    taskId: z.string().optional(),
+});
+/** Zod schema for {@link SubagentStopPayload}. */
+export const SubagentStopPayloadSchema = HookPayloadSchema.extend({
+    agentId: z.string(),
+    status: z.enum(['complete', 'partial', 'blocked', 'failed']).optional(),
+    taskId: z.string().optional(),
+    summary: z.string().optional(),
+});
+/** Zod schema for {@link PreCompactPayload}. */
+export const PreCompactPayloadSchema = HookPayloadSchema.extend({
+    tokensBefore: z.number().optional(),
+    reason: z.string().optional(),
+});
+/** Zod schema for {@link PostCompactPayload}. */
+export const PostCompactPayloadSchema = HookPayloadSchema.extend({
+    tokensBefore: z.number().optional(),
+    tokensAfter: z.number().optional(),
+    success: z.boolean(),
+});
+/** Zod schema for {@link ConfigChangePayload}. */
+export const ConfigChangePayloadSchema = HookPayloadSchema.extend({
+    key: z.string(),
+    previousValue: z.unknown().optional(),
+    newValue: z.unknown().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 = {
+    // 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,
+    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":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,0CAA0C;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAC;AAEH,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAChE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,0FAA0F;AAC1F,MAAM,CAAC,MAAM,2BAA2B,GAAG,yBAAyB,CAAC;AAErE,gDAAgD;AAChD,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACpC,CAAC,CAAC;AAEH,wFAAwF;AACxF,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AAEjE,gDAAgD;AAChD,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAC;AAEH,wFAAwF;AACxF,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAAC;AAEhE,iDAAiD;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAC/D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAEH,yFAAyF;AACzF,MAAM,CAAC,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AAEpE,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,0FAA0F;AAC1F,MAAM,CAAC,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AAEnE,wDAAwD;AACxD,MAAM,CAAC,MAAM,+BAA+B,GAAG,iBAAiB,CAAC,MAAM,CAAC;IACtE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,gGAAgG;AAChG,MAAM,CAAC,MAAM,oBAAoB,GAAG,+BAA+B,CAAC;AAEpE,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,0FAA0F;AAC1F,MAAM,CAAC,MAAM,2BAA2B,GAAG,yBAAyB,CAAC;AAErE,sDAAsD;AACtD,MAAM,CAAC,MAAM,6BAA6B,GAAG,iBAAiB,CAAC,MAAM,CAAC;IACpE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,8FAA8F;AAC9F,MAAM,CAAC,MAAM,+BAA+B,GAAG,6BAA6B,CAAC;AAE7E,mDAAmD;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC,MAAM,CAAC;IACjE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,gDAAgD;AAChD,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAC9D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAC/D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAEH,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAChE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,sCAAsC;AACtC,+EAA+E;AAE/E,qDAAqD;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,iBAAiB,CAAC,MAAM,CAAC;IACnE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC3F,CAAC,CAAC;AAEH,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,qDAAqD;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,iBAAiB,CAAC,MAAM,CAAC;IACnE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAClE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAC5D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACxE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,gBAAgB,GAA0C;IAC9D,8BAA8B;IAC9B,YAAY,EAAE,yBAAyB;IACvC,UAAU,EAAE,uBAAuB;IACnC,UAAU,EAAE,uBAAuB;IACnC,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB;IACvC,kBAAkB,EAAE,+BAA+B;IACnD,YAAY,EAAE,yBAAyB;IACvC,gBAAgB,EAAE,6BAA6B;IAC/C,aAAa,EAAE,0BAA0B;IACzC,YAAY,EAAE,yBAAyB;IACvC,UAAU,EAAE,uBAAuB;IACnC,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB;IACvC,wCAAwC;IACxC,eAAe,EAAE,4BAA4B;IAC7C,YAAY,EAAE,yBAAyB;IACvC,eAAe,EAAE,4BAA4B;IAC7C,cAAc,EAAE,2BAA2B;IAC3C,QAAQ,EAAE,qBAAqB;CAChC,CAAC;AAcF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgB,EAAE,OAAgB;IAChE,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,iBAAiB,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAEzC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAE/F,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC"}

package/dist/hooks/provider-hooks.js

@@ -0,0 +1,66 @@
+/**
+ * Provider Hook Capabilities - Phase 2C of T5237
+ *
+ * Helper functions for querying which providers support which hook events.
+ * Wraps CAAMP's provider discovery and normalizer functions with CLEO-specific helpers.
+ *
+ * Updated for CAAMP 1.9.1: uses CanonicalHookEvent and toNative/toCanonical normalizers.
+ *
+ * @module @cleocode/cleo/hooks/provider-hooks
+ */
+import { getCommonHookEvents, getProvidersByHookEvent, supportsHook, toCanonical, toNative, } from '@cleocode/caamp';
+import { isProviderHookEvent } from './types.js';
+/**
+ * Get all providers that support a specific hook event
+ *
+ * @param event - The hook event to query (canonical or internal)
+ * @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 canonical hook events supported by all specified providers
+ */
+export function getSharedHookEvents(providerIds) {
+    return getCommonHookEvents(providerIds);
+}
+/**
+ * Translate a canonical hook event to a provider-native event name.
+ *
+ * @param event - The canonical CAAMP event name
+ * @param providerId - The provider to translate for
+ * @returns The native event name, or null if the provider doesn't support it
+ */
+export function toNativeHookEvent(event, providerId) {
+    return toNative(event, providerId);
+}
+/**
+ * Translate a provider-native event name back to its canonical equivalent.
+ *
+ * @param nativeEvent - The provider-specific event name
+ * @param providerId - The provider this event belongs to
+ * @returns The canonical event name, or null if no mapping exists
+ */
+export function toCanonicalHookEvent(nativeEvent, providerId) {
+    return toCanonical(nativeEvent, providerId);
+}
+/**
+ * Check if a provider supports a specific canonical hook event.
+ *
+ * @param event - The canonical event name
+ * @param providerId - The provider to check
+ * @returns True if the provider supports this event
+ */
+export function providerSupportsHookEvent(event, providerId) {
+    return supportsHook(event, providerId);
+}
+export { getCommonHookEvents, getProvidersByHookEvent, supportsHook, toCanonical, toNative };
+//# 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;;;;;;;;;GASG;AAEH,OAAO,EAEL,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,QAAQ,GACT,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,KAA2B,CAAC,CAAC;IACvE,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,CAAyB,CAAC;AAClE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAyB,EAAE,UAAkB;IAC7E,OAAO,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,UAAkB;IAElB,OAAO,WAAW,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAyB,EAAE,UAAkB;IACrF,OAAO,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AACzC,CAAC;AAGD,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC"}

package/dist/hooks/registry.js

@@ -0,0 +1,229 @@
+/**
+ * Hook Registry System - Phase 2C of T5237
+ *
+ * Central registry for managing hook handlers with priority-based execution,
+ * async dispatch, and best-effort error handling. Integrates with CAAMP 1.9.1
+ * canonical event definitions while providing CLEO's execution engine.
+ *
+ * @module @cleocode/cleo/hooks/registry
+ */
+import { getLogger } from '../logger.js';
+/** Map from old `on`-prefix event names to new canonical names. Used for backward compat. */
+const LEGACY_EVENT_MAP = {
+    onSessionStart: 'SessionStart',
+    onSessionEnd: 'SessionEnd',
+    onToolStart: 'PreToolUse',
+    onToolComplete: 'PostToolUse',
+    onFileChange: 'Notification',
+    onError: 'PostToolUseFailure',
+    onPromptSubmit: 'PromptSubmit',
+    onResponseComplete: 'ResponseComplete',
+};
+/**
+ * Default configuration for the hook system.
+ * All events are enabled by default.
+ */
+const DEFAULT_HOOK_CONFIG = {
+    enabled: true,
+    events: {
+        // 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,
+        onCascadeStart: true,
+        onPatrol: true,
+    },
+};
+/**
+ * Central registry for hook handlers.
+ *
+ * Manages registration, priority-based ordering, and async dispatch
+ * of hook handlers. Provides best-effort execution where errors in
+ * one handler do not block others.
+ *
+ * Backward compatibility: handlers registered with legacy `on`-prefix
+ * event names (e.g. `onSessionStart`) are automatically remapped to their
+ * canonical equivalents (e.g. `SessionStart`) with a deprecation warning.
+ */
+export class HookRegistry {
+    handlers = 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
+     *
+     * @example
+     * ```typescript
+     * const unregister = hooks.register({
+     *   id: 'my-handler',
+     *   event: 'SessionStart',
+     *   handler: async (root, payload) => { console.log('Session started'); },
+     *   priority: 100
+     * });
+     *
+     * // Later: unregister()
+     * ```
+     */
+    register(registration) {
+        const resolvedEvent = this.resolveEvent(registration.event);
+        const resolvedRegistration = { ...registration, event: resolvedEvent };
+        const list = this.handlers.get(resolvedEvent) || [];
+        list.push(resolvedRegistration);
+        // Sort by priority (highest first)
+        list.sort((a, b) => b.priority - a.priority);
+        this.handlers.set(resolvedEvent, list);
+        // Return unregister function
+        return () => {
+            const handlers = this.handlers.get(resolvedEvent);
+            if (handlers) {
+                const idx = handlers.findIndex((h) => h.id === registration.id);
+                if (idx !== -1)
+                    handlers.splice(idx, 1);
+            }
+        };
+    }
+    /**
+     * Dispatch an event to all registered handlers.
+     *
+     * Executes handlers in parallel using Promise.allSettled for best-effort
+     * execution. Errors in individual handlers are logged but do not block
+     * other handlers or propagate to the caller.
+     *
+     * 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('SessionStart', '/project', {
+     *   timestamp: new Date().toISOString(),
+     *   sessionId: 'sess-123',
+     *   name: 'My Session',
+     *   scope: 'feature'
+     * });
+     * ```
+     */
+    async dispatch(event, projectRoot, payload) {
+        // Check if hooks enabled globally
+        if (!this.config.enabled)
+            return;
+        const resolvedEvent = this.resolveEvent(event);
+        // Check if this event enabled
+        if (!this.config.events[resolvedEvent])
+            return;
+        const handlers = this.handlers.get(resolvedEvent);
+        if (!handlers || handlers.length === 0)
+            return;
+        // Execute all handlers in parallel (best-effort)
+        await Promise.allSettled(handlers.map(async (reg) => {
+            try {
+                await reg.handler(projectRoot, payload);
+            }
+            catch (error) {
+                // Hooks are best-effort - log but don't throw
+                getLogger('hooks').warn({ err: error, hookId: reg.id, event: resolvedEvent }, 'Hook handler failed');
+            }
+        }));
+    }
+    /**
+     * 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) {
+        const resolvedEvent = this.resolveEvent(event);
+        return this.config.enabled && this.config.events[resolvedEvent];
+    }
+    /**
+     * Update the hook system configuration.
+     *
+     * Merges the provided config with the existing config.
+     *
+     * @param config - Partial configuration to apply
+     *
+     * @example
+     * ```typescript
+     * hooks.setConfig({ enabled: false }); // Disable all hooks
+     * hooks.setConfig({ events: { PostToolUseFailure: false } }); // Disable specific event
+     * ```
+     */
+    setConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Get the current hook configuration.
+     *
+     * @returns A copy of the current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * 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) {
+        const resolvedEvent = this.resolveEvent(event);
+        return [...(this.handlers.get(resolvedEvent) || [])];
+    }
+}
+/**
+ * Singleton instance of the HookRegistry.
+ *
+ * Use this instance for all hook operations throughout the application.
+ */
+export const hooks = new HookRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/hooks/registry.js.map

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

package/dist/hooks/types.js

@@ -0,0 +1,66 @@
+/**
+ * Universal Hooks Core Types - Phase 2B of T5237
+ *
+ * This module defines the core type system for CLEO's Universal Hooks
+ * integration with CAAMP 1.9.1. CLEO builds the hook registry and
+ * execution system while CAAMP provides the canonical event definitions.
+ *
+ * @module @cleocode/cleo/hooks/types
+ */
+import { buildHookMatrix, CANONICAL_HOOK_EVENTS, HOOK_CATEGORIES, supportsHook, toCanonical, toNative, } from '@cleocode/caamp';
+// Re-export CAAMP provider query functions for hook capability discovery
+export { getCommonHookEvents, getProvidersByHookEvent } from '@cleocode/caamp';
+// Re-export CAAMP canonical event constants and normalizer APIs
+export { buildHookMatrix, CANONICAL_HOOK_EVENTS, HOOK_CATEGORIES, supportsHook, toCanonical, toNative, };
+/**
+ * CLEO-local coordination events used by the autonomous runtime.
+ *
+ * These are internal lifecycle signals for worker orchestration and are not
+ * surfaced through CAAMP's provider capability registry.
+ */
+export const INTERNAL_HOOK_EVENTS = [
+    'onWorkAvailable',
+    'onAgentSpawn',
+    'onAgentComplete',
+    'onCascadeStart',
+    'onPatrol',
+];
+const INTERNAL_HOOK_EVENT_SET = new Set(INTERNAL_HOOK_EVENTS);
+/**
+ * Type guard for CAAMP/provider-discoverable canonical hook events.
+ */
+export function isProviderHookEvent(event) {
+    return !INTERNAL_HOOK_EVENT_SET.has(event);
+}
+/**
+ * Type guard for CLEO-local coordination hook events.
+ */
+export function isInternalHookEvent(event) {
+    return INTERNAL_HOOK_EVENT_SET.has(event);
+}
+/**
+ * Mapping from CLEO internal lifecycle events to CAAMP canonical hook event names.
+ *
+ * Updated for CAAMP 1.9.1 canonical taxonomy.
+ */
+export const CLEO_TO_CAAMP_HOOK_MAP = {
+    'session.start': 'SessionStart',
+    'session.end': 'SessionEnd',
+    'task.start': 'PreToolUse',
+    'task.complete': 'PostToolUse',
+    'file.change': 'Notification',
+    'system.error': 'PostToolUseFailure',
+    'prompt.submit': 'PromptSubmit',
+    'response.complete': 'ResponseComplete',
+};
+/**
+ * Internal CLEO lifecycle events that drive autonomous coordination.
+ */
+export const CLEO_INTERNAL_HOOK_MAP = {
+    'agent.work.available': 'onWorkAvailable',
+    'agent.spawn': 'onAgentSpawn',
+    'agent.complete': 'onAgentComplete',
+    'cascade.start': 'onCascadeStart',
+    'watcher.patrol': 'onPatrol',
+};
+//# sourceMappingURL=types.js.map

package/dist/hooks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,yEAAyE;AACzE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,gEAAgE;AAChE,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,QAAQ,GACT,CAAC;AASF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,iBAAiB;IACjB,cAAc;IACd,iBAAiB;IACjB,gBAAgB;IAChB,UAAU;CACF,CAAC;AAYX,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAS,oBAAoB,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAgB;IAClD,OAAO,CAAC,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAgB;IAClD,OAAO,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AA2ZD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,eAAe,EAAE,cAAc;IAC/B,aAAa,EAAE,YAAY;IAC3B,YAAY,EAAE,YAAY;IAC1B,eAAe,EAAE,aAAa;IAC9B,aAAa,EAAE,cAAc;IAC7B,cAAc,EAAE,oBAAoB;IACpC,eAAe,EAAE,cAAc;IAC/B,mBAAmB,EAAE,kBAAkB;CACc,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,sBAAsB,EAAE,iBAAiB;IACzC,aAAa,EAAE,cAAc;IAC7B,gBAAgB,EAAE,iBAAiB;IACnC,eAAe,EAAE,gBAAgB;IACjC,gBAAgB,EAAE,UAAU;CACpB,CAAC"}