@a5c-ai/agent-comm-mux 5.0.1-staging.04ca6ab00d21

package/dist/events-control.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Rate limits, run lifecycle / control, error, and debug events.
+ *
+ * Split out of events.ts for file-size hygiene; re-exported from events.ts
+ * so the public surface `import { ... } from './events.js'` is unchanged.
+ */
+import type { ErrorCode } from './types.js';
+import type { BaseEvent } from './types.js';
+export interface RateLimitedEvent extends BaseEvent {
+    type: 'rate_limited';
+    retryAfterMs?: number;
+}
+export interface ContextLimitWarningEvent extends BaseEvent {
+    type: 'context_limit_warning';
+    usedTokens: number;
+    maxTokens: number;
+    pctUsed: number;
+}
+export interface ContextCompactedEvent extends BaseEvent {
+    type: 'context_compacted';
+    summary: string;
+    tokensSaved: number;
+}
+export interface RetryEvent extends BaseEvent {
+    type: 'retry';
+    attempt: number;
+    maxAttempts: number;
+    reason: string;
+    delayMs: number;
+}
+export interface InterruptedEvent extends BaseEvent {
+    type: 'interrupted';
+}
+export interface AbortedEvent extends BaseEvent {
+    type: 'aborted';
+}
+export interface PausedEvent extends BaseEvent {
+    type: 'paused';
+}
+export interface ResumedEvent extends BaseEvent {
+    type: 'resumed';
+}
+export interface TimeoutEvent extends BaseEvent {
+    type: 'timeout';
+    kind: 'run' | 'inactivity';
+}
+export interface TurnLimitEvent extends BaseEvent {
+    type: 'turn_limit';
+    maxTurns: number;
+}
+export interface StreamFallbackEvent extends BaseEvent {
+    type: 'stream_fallback';
+    capability: 'text' | 'tool_calls' | 'thinking';
+    reason: string;
+}
+export interface AuthErrorEvent extends BaseEvent {
+    type: 'auth_error';
+    message: string;
+    guidance: string;
+}
+export interface RateLimitErrorEvent extends BaseEvent {
+    type: 'rate_limit_error';
+    message: string;
+    retryAfterMs?: number;
+}
+export interface ContextExceededEvent extends BaseEvent {
+    type: 'context_exceeded';
+    usedTokens: number;
+    maxTokens: number;
+}
+export interface CrashEvent extends BaseEvent {
+    type: 'crash';
+    exitCode: number;
+    stderr: string;
+}
+export interface ErrorEvent extends BaseEvent {
+    type: 'error';
+    code: ErrorCode;
+    message: string;
+    recoverable: boolean;
+}
+export interface DebugEvent extends BaseEvent {
+    type: 'debug';
+    level: 'verbose' | 'info' | 'warn';
+    message: string;
+}
+export interface LogEvent extends BaseEvent {
+    type: 'log';
+    source: 'stdout' | 'stderr';
+    line: string;
+}

package/dist/events-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-control.d.ts","sourceRoot":"","sources":["../src/events-control.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAyB,SAAQ,SAAS;IACzD,IAAI,EAAE,uBAAuB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAsB,SAAQ,SAAS;IACtD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,KAAK,GAAG,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,IAAI,EAAE,kBAAkB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAMD,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAS,SAAQ,SAAS;IACzC,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/events-control.js

@@ -0,0 +1,8 @@
+/**
+ * Rate limits, run lifecycle / control, error, and debug events.
+ *
+ * Split out of events.ts for file-size hygiene; re-exported from events.ts
+ * so the public surface `import { ... } from './events.js'` is unchanged.
+ */
+export {};
+//# sourceMappingURL=events-control.js.map

package/dist/events-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-control.js","sourceRoot":"","sources":["../src/events-control.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/events.d.ts

@@ -0,0 +1,285 @@
+/**
+ * AgentEvent union type and all event discriminants for @a5c-ai/agent-mux.
+ *
+ * 67 event types across 18 categories. All extend BaseEvent with a `type`
+ * discriminant, `runId`, `agent`, and `timestamp`.
+ */
+import type { CostRecord } from './types.js';
+export type { BaseEvent } from './types.js';
+import type { BaseEvent } from './types.js';
+export interface SessionStartEvent extends BaseEvent {
+    type: 'session_start';
+    sessionId: string;
+    resumed: boolean;
+    forkedFrom?: string;
+}
+export interface SessionResumeEvent extends BaseEvent {
+    type: 'session_resume';
+    sessionId: string;
+    priorTurnCount: number;
+}
+export interface SessionForkEvent extends BaseEvent {
+    type: 'session_fork';
+    sessionId: string;
+    forkedFrom: string;
+}
+export interface SessionCheckpointEvent extends BaseEvent {
+    type: 'session_checkpoint';
+    sessionId: string;
+    checkpointId: string;
+}
+export interface SessionEndEvent extends BaseEvent {
+    type: 'session_end';
+    sessionId: string;
+    turnCount: number;
+    cost?: CostRecord;
+}
+export interface TurnStartEvent extends BaseEvent {
+    type: 'turn_start';
+    turnIndex: number;
+}
+export interface TurnEndEvent extends BaseEvent {
+    type: 'turn_end';
+    turnIndex: number;
+    cost?: CostRecord;
+}
+export interface StepStartEvent extends BaseEvent {
+    type: 'step_start';
+    turnIndex: number;
+    stepIndex: number;
+    stepType: string;
+}
+export interface StepEndEvent extends BaseEvent {
+    type: 'step_end';
+    turnIndex: number;
+    stepIndex: number;
+}
+export interface MessageStartEvent extends BaseEvent {
+    type: 'message_start';
+}
+export interface TextDeltaEvent extends BaseEvent {
+    type: 'text_delta';
+    delta: string;
+    accumulated: string;
+}
+export interface MessageStopEvent extends BaseEvent {
+    type: 'message_stop';
+    text: string;
+}
+export interface ThinkingStartEvent extends BaseEvent {
+    type: 'thinking_start';
+    effort?: string;
+}
+export interface ThinkingDeltaEvent extends BaseEvent {
+    type: 'thinking_delta';
+    delta: string;
+    accumulated: string;
+}
+export interface ThinkingStopEvent extends BaseEvent {
+    type: 'thinking_stop';
+    thinking: string;
+}
+export interface ToolCallStartEvent extends BaseEvent {
+    type: 'tool_call_start';
+    toolCallId: string;
+    toolName: string;
+    inputAccumulated: string;
+}
+export interface ToolInputDeltaEvent extends BaseEvent {
+    type: 'tool_input_delta';
+    toolCallId: string;
+    delta: string;
+    inputAccumulated: string;
+}
+export interface ToolCallReadyEvent extends BaseEvent {
+    type: 'tool_call_ready';
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+}
+export interface ToolResultEvent extends BaseEvent {
+    type: 'tool_result';
+    toolCallId: string;
+    toolName: string;
+    output: unknown;
+    durationMs: number;
+}
+export interface ToolErrorEvent extends BaseEvent {
+    type: 'tool_error';
+    toolCallId: string;
+    toolName: string;
+    error: string;
+}
+export interface FileReadEvent extends BaseEvent {
+    type: 'file_read';
+    path: string;
+}
+export interface FileWriteEvent extends BaseEvent {
+    type: 'file_write';
+    path: string;
+    byteCount: number;
+}
+export interface FileCreateEvent extends BaseEvent {
+    type: 'file_create';
+    path: string;
+    byteCount: number;
+}
+export interface FileDeleteEvent extends BaseEvent {
+    type: 'file_delete';
+    path: string;
+}
+export interface FilePatchEvent extends BaseEvent {
+    type: 'file_patch';
+    path: string;
+    diff: string;
+}
+export interface ShellStartEvent extends BaseEvent {
+    type: 'shell_start';
+    command: string;
+    cwd: string;
+}
+export interface ShellStdoutDeltaEvent extends BaseEvent {
+    type: 'shell_stdout_delta';
+    delta: string;
+}
+export interface ShellStderrDeltaEvent extends BaseEvent {
+    type: 'shell_stderr_delta';
+    delta: string;
+}
+export interface ShellExitEvent extends BaseEvent {
+    type: 'shell_exit';
+    exitCode: number;
+    durationMs: number;
+}
+export interface McpToolCallStartEvent extends BaseEvent {
+    type: 'mcp_tool_call_start';
+    toolCallId: string;
+    server: string;
+    toolName: string;
+    input: unknown;
+}
+export interface McpToolResultEvent extends BaseEvent {
+    type: 'mcp_tool_result';
+    toolCallId: string;
+    server: string;
+    toolName: string;
+    output: unknown;
+}
+export interface McpToolErrorEvent extends BaseEvent {
+    type: 'mcp_tool_error';
+    toolCallId: string;
+    server: string;
+    toolName: string;
+    error: string;
+}
+export interface SubagentSpawnEvent extends BaseEvent {
+    type: 'subagent_spawn';
+    subagentId: string;
+    agentName: string;
+    prompt: string;
+}
+export interface SubagentResultEvent extends BaseEvent {
+    type: 'subagent_result';
+    subagentId: string;
+    agentName: string;
+    summary: string;
+    cost?: CostRecord;
+}
+export interface SubagentErrorEvent extends BaseEvent {
+    type: 'subagent_error';
+    subagentId: string;
+    agentName: string;
+    error: string;
+}
+export interface PluginLoadedEvent extends BaseEvent {
+    type: 'plugin_loaded';
+    pluginId: string;
+    pluginName: string;
+    version: string;
+}
+export interface PluginInvokedEvent extends BaseEvent {
+    type: 'plugin_invoked';
+    pluginId: string;
+    pluginName: string;
+}
+export interface PluginErrorEvent extends BaseEvent {
+    type: 'plugin_error';
+    pluginId: string;
+    pluginName: string;
+    error: string;
+}
+export interface SkillLoadedEvent extends BaseEvent {
+    type: 'skill_loaded';
+    skillName: string;
+    source: string;
+}
+export interface SkillInvokedEvent extends BaseEvent {
+    type: 'skill_invoked';
+    skillName: string;
+}
+export interface AgentdocReadEvent extends BaseEvent {
+    type: 'agentdoc_read';
+    path: string;
+}
+export interface ImageOutputEvent extends BaseEvent {
+    type: 'image_output';
+    mimeType: string;
+    base64?: string;
+    filePath?: string;
+}
+export interface ImageInputAckEvent extends BaseEvent {
+    type: 'image_input_ack';
+    mimeType: string;
+}
+export interface CostEvent extends BaseEvent {
+    type: 'cost';
+    cost: CostRecord;
+}
+export interface TokenUsageEvent extends BaseEvent {
+    type: 'token_usage';
+    inputTokens: number;
+    outputTokens: number;
+    thinkingTokens?: number;
+    cachedTokens?: number;
+}
+export interface InputRequiredEvent extends BaseEvent {
+    type: 'input_required';
+    interactionId: string;
+    question: string;
+    context?: string;
+    source: 'agent' | 'tool';
+}
+export interface ApprovalRequestEvent extends BaseEvent {
+    type: 'approval_request';
+    interactionId: string;
+    action: string;
+    detail: string;
+    toolName?: string;
+    riskLevel: 'low' | 'medium' | 'high';
+}
+export interface ApprovalGrantedEvent extends BaseEvent {
+    type: 'approval_granted';
+    interactionId: string;
+}
+export interface ApprovalDeniedEvent extends BaseEvent {
+    type: 'approval_denied';
+    interactionId: string;
+    reason?: string;
+}
+export type { RateLimitedEvent, ContextLimitWarningEvent, ContextCompactedEvent, RetryEvent, InterruptedEvent, AbortedEvent, PausedEvent, ResumedEvent, TimeoutEvent, TurnLimitEvent, StreamFallbackEvent, AuthErrorEvent, RateLimitErrorEvent, ContextExceededEvent, CrashEvent, ErrorEvent, DebugEvent, LogEvent, } from './events-control.js';
+import type { RateLimitedEvent, ContextLimitWarningEvent, ContextCompactedEvent, RetryEvent, InterruptedEvent, AbortedEvent, PausedEvent, ResumedEvent, TimeoutEvent, TurnLimitEvent, StreamFallbackEvent, AuthErrorEvent, RateLimitErrorEvent, ContextExceededEvent, CrashEvent, ErrorEvent, DebugEvent, LogEvent } from './events-control.js';
+/**
+ * The complete discriminated union of all 67 event types emitted by agent-mux.
+ *
+ * The `type` field is the discriminant. TypeScript narrowing works out of
+ * the box: `if (event.type === 'text_delta') { event.delta; /* TextDeltaEvent *\/ }`
+ */
+export type AgentEvent = SessionStartEvent | SessionResumeEvent | SessionForkEvent | SessionCheckpointEvent | SessionEndEvent | TurnStartEvent | TurnEndEvent | StepStartEvent | StepEndEvent | MessageStartEvent | TextDeltaEvent | MessageStopEvent | ThinkingStartEvent | ThinkingDeltaEvent | ThinkingStopEvent | ToolCallStartEvent | ToolInputDeltaEvent | ToolCallReadyEvent | ToolResultEvent | ToolErrorEvent | FileReadEvent | FileWriteEvent | FileCreateEvent | FileDeleteEvent | FilePatchEvent | ShellStartEvent | ShellStdoutDeltaEvent | ShellStderrDeltaEvent | ShellExitEvent | McpToolCallStartEvent | McpToolResultEvent | McpToolErrorEvent | SubagentSpawnEvent | SubagentResultEvent | SubagentErrorEvent | PluginLoadedEvent | PluginInvokedEvent | PluginErrorEvent | SkillLoadedEvent | SkillInvokedEvent | AgentdocReadEvent | ImageOutputEvent | ImageInputAckEvent | CostEvent | TokenUsageEvent | InputRequiredEvent | ApprovalRequestEvent | ApprovalGrantedEvent | ApprovalDeniedEvent | RateLimitedEvent | ContextLimitWarningEvent | ContextCompactedEvent | RetryEvent | InterruptedEvent | AbortedEvent | PausedEvent | ResumedEvent | TimeoutEvent | TurnLimitEvent | StreamFallbackEvent | AuthErrorEvent | RateLimitErrorEvent | ContextExceededEvent | CrashEvent | ErrorEvent | DebugEvent | LogEvent;
+/** Extract the event type for a given discriminant string. */
+export type EventOfType<T extends AgentEvent['type']> = Extract<AgentEvent, {
+    type: T;
+}>;
+/** All valid event type discriminant strings. */
+export type AgentEventType = AgentEvent['type'];
+/** Handler function type for a given event type. */
+export type AgentEventHandler<T extends AgentEventType> = (event: EventOfType<T>) => void;

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,8 @@
+/**
+ * AgentEvent union type and all event discriminants for @a5c-ai/agent-mux.
+ *
+ * 67 event types across 18 categories. All extend BaseEvent with a `type`
+ * discriminant, `runId`, `agent`, and `timestamp`.
+ */
+export {};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/hook-catalog.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Per-harness hook type catalog.
+ *
+ * Lists the hook types each harness natively supports. Used by
+ * `amux hooks <agent> discover` and to validate `add` / `set` operations.
+ *
+ * The catalog is conservative: it reflects documented, stable hook names
+ * at the time of writing. Unknown hook types are still accepted (marked
+ * "custom") so plugin adapters can register their own.
+ */
+import type { AgentName } from './types.js';
+export interface HookTypeEntry {
+    name: string;
+    description: string;
+    /** Direction of the hook: 'pre' blocks/modifies, 'post' observes. */
+    direction: 'pre' | 'post' | 'event';
+}
+export declare const HOOK_CATALOG: Record<string, HookTypeEntry[]>;
+export declare function getHookCatalog(agent: AgentName | string): HookTypeEntry[];
+export declare function isKnownHookType(agent: AgentName | string, hookType: string): boolean;

package/dist/hook-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-catalog.d.ts","sourceRoot":"","sources":["../src/hook-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;CACrC;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CA0CxD,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,aAAa,EAAE,CAEzE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIpF"}

package/dist/hook-catalog.js

@@ -0,0 +1,63 @@
+/**
+ * Per-harness hook type catalog.
+ *
+ * Lists the hook types each harness natively supports. Used by
+ * `amux hooks <agent> discover` and to validate `add` / `set` operations.
+ *
+ * The catalog is conservative: it reflects documented, stable hook names
+ * at the time of writing. Unknown hook types are still accepted (marked
+ * "custom") so plugin adapters can register their own.
+ */
+export const HOOK_CATALOG = {
+    claude: [
+        { name: 'PreToolUse', description: 'Before a tool is invoked.', direction: 'pre' },
+        { name: 'PostToolUse', description: 'After a tool returns.', direction: 'post' },
+        { name: 'UserPromptSubmit', description: 'When the user submits a prompt.', direction: 'pre' },
+        { name: 'Notification', description: 'Claude emits a notification.', direction: 'event' },
+        { name: 'Stop', description: 'Main agent stops.', direction: 'event' },
+        { name: 'SubagentStop', description: 'Subagent stops.', direction: 'event' },
+        { name: 'SessionStart', description: 'Session starts.', direction: 'event' },
+        { name: 'SessionEnd', description: 'Session ends.', direction: 'event' },
+    ],
+    codex: [
+        { name: 'OnToolCall', description: 'Around tool calls.', direction: 'pre' },
+        { name: 'OnStop', description: 'Codex run stops.', direction: 'event' },
+    ],
+    gemini: [
+        { name: 'pre_prompt', description: 'Before prompt submission.', direction: 'pre' },
+        { name: 'post_response', description: 'After model response.', direction: 'post' },
+    ],
+    copilot: [
+        { name: 'preTool', description: 'Before tool use.', direction: 'pre' },
+        { name: 'postTool', description: 'After tool use.', direction: 'post' },
+    ],
+    cursor: [
+        { name: 'pre_tool', description: 'Before tool use.', direction: 'pre' },
+        { name: 'post_tool', description: 'After tool use.', direction: 'post' },
+    ],
+    opencode: [
+        { name: 'on_step', description: 'Per-step hook.', direction: 'event' },
+    ],
+    pi: [
+        { name: 'onEvent', description: 'Generic event hook.', direction: 'event' },
+    ],
+    omp: [
+        { name: 'onEvent', description: 'Generic event hook.', direction: 'event' },
+    ],
+    openclaw: [
+        { name: 'onEvent', description: 'Generic event hook.', direction: 'event' },
+    ],
+    hermes: [
+        { name: 'onEvent', description: 'Generic event hook.', direction: 'event' },
+    ],
+};
+export function getHookCatalog(agent) {
+    return HOOK_CATALOG[agent] ?? [];
+}
+export function isKnownHookType(agent, hookType) {
+    const entries = HOOK_CATALOG[agent];
+    if (!entries)
+        return false;
+    return entries.some((e) => e.name === hookType);
+}
+//# sourceMappingURL=hook-catalog.js.map

package/dist/hook-catalog.js.map

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

package/dist/hook-dispatcher.d.ts

@@ -0,0 +1,24 @@
+/**
+ * HookDispatcher — runs registered hooks for a payload and aggregates results.
+ *
+ * Deny wins over allow; modifiedInput is merged in priority order; stdout
+ * fragments are concatenated. exitCode follows the first non-zero.
+ */
+import type { HookConfigManager, HookRegistration, UnifiedHookPayload, UnifiedHookResult } from './hooks.js';
+import type { BuiltInHooksRegistry } from './builtin-hooks.js';
+export interface DispatchOptions {
+    /** Override env passed to command/script hooks. */
+    env?: NodeJS.ProcessEnv;
+    /** Working directory for command/script hooks. */
+    cwd?: string;
+    /** Timeout per external hook (ms). */
+    timeoutMs?: number;
+}
+export declare class HookDispatcher {
+    private readonly config;
+    private readonly builtins;
+    constructor(config: HookConfigManager, builtins: BuiltInHooksRegistry);
+    dispatch(payload: UnifiedHookPayload, opts?: DispatchOptions): Promise<UnifiedHookResult>;
+    runAll(regs: HookRegistration[], payload: UnifiedHookPayload, opts: DispatchOptions): Promise<UnifiedHookResult>;
+    private runOne;
+}

package/dist/hook-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-dispatcher.d.ts","sourceRoot":"","sources":["../src/hook-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,oBAAoB;IAG3C,QAAQ,CACZ,OAAO,EAAE,kBAAkB,EAC3B,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,iBAAiB,CAAC;IAKvB,MAAM,CACV,IAAI,EAAE,gBAAgB,EAAE,EACxB,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,CAAC;YAYf,MAAM;CAUrB"}

package/dist/hook-dispatcher.js

@@ -0,0 +1,91 @@
+/**
+ * HookDispatcher — runs registered hooks for a payload and aggregates results.
+ *
+ * Deny wins over allow; modifiedInput is merged in priority order; stdout
+ * fragments are concatenated. exitCode follows the first non-zero.
+ */
+import { spawn } from 'node:child_process';
+export class HookDispatcher {
+    config;
+    builtins;
+    constructor(config, builtins) {
+        this.config = config;
+        this.builtins = builtins;
+    }
+    async dispatch(payload, opts = {}) {
+        const matches = await this.config.getForAgent(payload.agent, payload.hookType);
+        return await this.runAll(matches, payload, opts);
+    }
+    async runAll(regs, payload, opts) {
+        let aggregate = { decision: 'allow', stdout: '', exitCode: 0 };
+        for (const reg of regs) {
+            const result = await this.runOne(reg, payload, opts);
+            aggregate = mergeResults(aggregate, result);
+            if (aggregate.decision === 'deny')
+                break;
+        }
+        if (!aggregate.stdout)
+            delete aggregate.stdout;
+        if (aggregate.exitCode === 0)
+            delete aggregate.exitCode;
+        return aggregate;
+    }
+    async runOne(reg, payload, opts) {
+        if (reg.handler === 'builtin') {
+            return this.builtins.run(reg.target, payload);
+        }
+        return await runExternal(reg, payload, opts);
+    }
+}
+function mergeResults(a, b) {
+    const decision = a.decision === 'deny' || b.decision === 'deny'
+        ? 'deny'
+        : a.decision === 'modify' || b.decision === 'modify'
+            ? 'modify'
+            : 'allow';
+    const modifiedInput = a.modifiedInput || b.modifiedInput
+        ? { ...(a.modifiedInput ?? {}), ...(b.modifiedInput ?? {}) }
+        : undefined;
+    return {
+        decision,
+        message: b.message ?? a.message,
+        modifiedInput,
+        stdout: (a.stdout ?? '') + (b.stdout ?? ''),
+        exitCode: (a.exitCode && a.exitCode !== 0) ? a.exitCode : (b.exitCode ?? 0),
+    };
+}
+function runExternal(reg, payload, opts) {
+    return new Promise((resolve) => {
+        const child = spawn(reg.target, [], {
+            shell: reg.handler === 'command',
+            cwd: opts.cwd,
+            env: { ...process.env, ...opts.env },
+        });
+        let stdout = '';
+        let stderr = '';
+        const t = opts.timeoutMs
+            ? setTimeout(() => child.kill('SIGTERM'), opts.timeoutMs)
+            : null;
+        child.stdout.on('data', (d) => (stdout += d.toString()));
+        child.stderr.on('data', (d) => (stderr += d.toString()));
+        child.on('close', (code) => {
+            if (t)
+                clearTimeout(t);
+            const exit = code ?? 0;
+            resolve({
+                decision: exit === 0 ? 'allow' : 'deny',
+                stdout,
+                exitCode: exit,
+                message: stderr || undefined,
+            });
+        });
+        child.on('error', (err) => {
+            if (t)
+                clearTimeout(t);
+            resolve({ decision: 'deny', message: err.message, exitCode: 1 });
+        });
+        child.stdin.on('error', () => { });
+        child.stdin.end(JSON.stringify(payload));
+    });
+}
+//# sourceMappingURL=hook-dispatcher.js.map

package/dist/hook-dispatcher.js.map

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