@cleocode/core 2026.4.42 → 2026.4.43

package/dist/hooks/handlers/work-capture-hooks.js

@@ -1,165 +0,0 @@
-/**
- * Active-Work Capture Hook Handlers
- *
- * Captures dispatch mutation events to BRAIN during active work, closing
- * the gap between lifecycle-only capture (session end, task complete) and
- * continuous capture. Only WRITE operations that represent meaningful work
- * are captured — reads and operations already handled by lifecycle hooks
- * are skipped to avoid flooding brain.db.
- *
- * Disabled by default. Enable via:
- *   - Config: brain.captureWork = true  (checked first)
- *   - Env:    CLEO_BRAIN_CAPTURE_WORK=true  (overrides config)
- *
- * Auto-registers on module load.
- *
- * @task T142
- */
-import { hooks } from '../registry.js';
-import { isMissingBrainSchemaError } from './handler-helpers.js';
-/**
- * Check whether active-work capture is enabled.
- *
- * Resolution order (first truthy wins):
- *   1. CLEO_BRAIN_CAPTURE_WORK env var (explicit override)
- *   2. brain.captureWork project config value
- *
- * Defaults to false when neither is set.
- */
-async function isWorkCaptureEnabled(projectRoot) {
-    const envOverride = process.env['CLEO_BRAIN_CAPTURE_WORK'];
-    if (envOverride !== undefined) {
-        return envOverride === 'true';
-    }
-    try {
-        const { loadConfig } = await import('../../config.js');
-        const config = await loadConfig(projectRoot);
-        return config.brain?.captureWork ?? false;
-    }
-    catch {
-        return false;
-    }
-}
-// ---------------------------------------------------------------------------
-// Smart-filter: which mutations to capture
-// ---------------------------------------------------------------------------
-/**
- * Mutations that represent novel work not already captured by lifecycle hooks.
- *
- * Excluded (already captured elsewhere):
- *   - tasks.complete  → task-hooks.ts (PostToolUse)
- *   - session.start   → session-hooks.ts (SessionStart)
- *   - session.end     → session-hooks.ts (SessionEnd)
- *   - memory.brain.observe → observeBrain itself writes to brain; self-loop
- *
- * All query gateway operations are excluded by the gateway check before
- * this set is consulted.
- */
-const CAPTURE_OPERATIONS = new Set([
-    'tasks.add',
-    'tasks.update',
-    'tasks.move',
-    'tasks.link',
-    'tasks.unlink',
-    'tasks.label',
-    'tasks.unlabel',
-    'tasks.note',
-]);
-/**
- * Determine whether a mutate operation should be captured.
- *
- * Only `mutate` gateway operations in CAPTURE_OPERATIONS are captured.
- * All `query` gateway calls are skipped (reads produce no novel work).
- *
- * @param gateway - 'query' or 'mutate'
- * @param domain  - e.g. 'tasks'
- * @param operation - e.g. 'add'
- */
-function shouldCapture(gateway, domain, operation) {
-    if (gateway !== 'mutate')
-        return false;
-    const key = `${domain}.${operation}`;
-    return CAPTURE_OPERATIONS.has(key);
-}
-// ---------------------------------------------------------------------------
-// Handlers
-// ---------------------------------------------------------------------------
-/**
- * Handle PromptSubmit — log incoming mutation intents to BRAIN.
- *
- * Only fires for mutate operations in CAPTURE_OPERATIONS.
- * Gated behind brain.captureWork config (or CLEO_BRAIN_CAPTURE_WORK env).
- *
- * @param projectRoot - Absolute path to the project root
- * @param payload     - PromptSubmit event payload
- */
-export async function handleWorkPromptSubmit(projectRoot, payload) {
-    if (!shouldCapture(payload.gateway, payload.domain, payload.operation))
-        return;
-    if (!(await isWorkCaptureEnabled(projectRoot)))
-        return;
-    const { observeBrain } = await import('../../memory/brain-retrieval.js');
-    try {
-        await observeBrain(projectRoot, {
-            text: `Dispatch intent: ${payload.gateway}:${payload.domain}.${payload.operation}${payload.source ? ` (from ${payload.source})` : ''}`,
-            title: `Work intent: ${payload.domain}.${payload.operation}`,
-            type: 'discovery',
-            sourceType: 'agent',
-        });
-    }
-    catch (err) {
-        if (!isMissingBrainSchemaError(err))
-            throw err;
-    }
-}
-/**
- * Handle ResponseComplete — capture completed mutations to BRAIN.
- *
- * Only fires for successful mutate operations in CAPTURE_OPERATIONS.
- * Failures are skipped — the intent was already captured by handleWorkPromptSubmit.
- * Gated behind brain.captureWork config (or CLEO_BRAIN_CAPTURE_WORK env).
- *
- * @param projectRoot - Absolute path to the project root
- * @param payload     - ResponseComplete event payload
- */
-export async function handleWorkResponseComplete(projectRoot, payload) {
-    if (!shouldCapture(payload.gateway, payload.domain, payload.operation))
-        return;
-    // Only capture successful completions — failures are noise
-    if (!payload.success)
-        return;
-    if (!(await isWorkCaptureEnabled(projectRoot)))
-        return;
-    const { observeBrain } = await import('../../memory/brain-retrieval.js');
-    try {
-        const durationNote = payload.durationMs != null ? ` (${payload.durationMs}ms)` : '';
-        await observeBrain(projectRoot, {
-            text: `Dispatch complete: ${payload.gateway}:${payload.domain}.${payload.operation}${durationNote}`,
-            title: `Work done: ${payload.domain}.${payload.operation}`,
-            type: 'change',
-            sourceType: 'agent',
-        });
-    }
-    catch (err) {
-        if (!isMissingBrainSchemaError(err))
-            throw err;
-    }
-}
-// ---------------------------------------------------------------------------
-// Auto-registration
-// ---------------------------------------------------------------------------
-// Register at lower priority (90) than lifecycle hooks (100) so lifecycle
-// handlers always run first.
-hooks.register({
-    id: 'work-capture-prompt-submit',
-    event: 'PromptSubmit',
-    handler: handleWorkPromptSubmit,
-    priority: 90,
-});
-hooks.register({
-    id: 'work-capture-response-complete',
-    event: 'ResponseComplete',
-    handler: handleWorkResponseComplete,
-    priority: 90,
-});
-//# sourceMappingURL=work-capture-hooks.js.map

package/dist/hooks/handlers/work-capture-hooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"work-capture-hooks.js","sourceRoot":"","sources":["../../../src/hooks/handlers/work-capture-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;;;;;;;GAQG;AACH,KAAK,UAAU,oBAAoB,CAAC,WAAmB;IACrD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAC3D,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,WAAW,KAAK,MAAM,CAAC;IAChC,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,KAAK,EAAE,WAAW,IAAI,KAAK,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS;IACzC,WAAW;IACX,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,aAAa;IACb,eAAe;IACf,YAAY;CACb,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,SAAS,aAAa,CAAC,OAAe,EAAE,MAAc,EAAE,SAAiB;IACvE,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;IACrC,OAAO,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,OAA4B;IAE5B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO;IAC/E,IAAI,CAAC,CAAC,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO;IAEvD,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,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACtI,KAAK,EAAE,gBAAgB,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE;YAC5D,IAAI,EAAE,WAAW;YACjB,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;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,WAAmB,EACnB,OAAgC;IAEhC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO;IAC/E,2DAA2D;IAC3D,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO;IAC7B,IAAI,CAAC,CAAC,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO;IAEvD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,MAAM,YAAY,CAAC,WAAW,EAAE;YAC9B,IAAI,EAAE,sBAAsB,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,GAAG,YAAY,EAAE;YACnG,KAAK,EAAE,cAAc,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE;YAC1D,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,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,0EAA0E;AAC1E,6BAA6B;AAC7B,KAAK,CAAC,QAAQ,CAAC;IACb,EAAE,EAAE,4BAA4B;IAChC,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,sBAAsB;IAC/B,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC;AAEH,KAAK,CAAC,QAAQ,CAAC;IACb,EAAE,EAAE,gCAAgC;IACpC,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,0BAA0B;IACnC,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC"}

package/dist/hooks/index.js

@@ -1,13 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,220 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,66 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}