@viewportai/daemon 0.1.0

package/dist/hooks/router.d.ts

@@ -0,0 +1,63 @@
+/**
+ * HookRouter — central dispatcher for agent hook events.
+ *
+ * Receives events from the HTTP endpoint (posted by `vpd hook notify`),
+ * validates them, emits typed events on the daemon bus, and handles
+ * blocking hooks like PermissionRequest by holding the HTTP response
+ * until a supervising client responds.
+ *
+ * Design:
+ *   - Event definitions are data (HookEventDefinition), not code.
+ *   - Adding a new hook = adding a schema + definition. No switch statements.
+ *   - The router doesn't know about specific agents — it's adapter-agnostic.
+ *   - Blocking logic is isolated to handleBlockingEvent().
+ */
+import type { TypedEventEmitter } from '../core/events.js';
+import type { DaemonEvents } from '../core/events.js';
+import type { SupervisionManager } from './supervision.js';
+import { type HookEventDefinition, type HookResponse } from './types.js';
+export interface PendingPermission {
+    hookRequestId: string;
+    sessionId: string;
+    adapter: string;
+    toolName: string;
+    toolInput: unknown;
+    cwd?: string;
+    createdAt: number;
+    timeoutMs: number;
+    resolve: (response: HookResponse) => void;
+    timer: ReturnType<typeof setTimeout>;
+}
+export declare class HookRouter {
+    private readonly eventBus;
+    private readonly supervision;
+    private readonly definitions;
+    private readonly pending;
+    private hookRequestCounter;
+    constructor(eventBus: TypedEventEmitter<DaemonEvents>, supervision: SupervisionManager);
+    /**
+     * Handle an incoming hook event from an agent.
+     *
+     * For non-blocking events: emits on the event bus and returns immediately.
+     * For blocking events (PermissionRequest): holds if supervised, or returns
+     * passthrough if nobody is watching.
+     */
+    handleEvent(input: Record<string, unknown>, adapter?: string): Promise<HookResponse>;
+    /** Register or override an event definition. */
+    registerDefinition(def: HookEventDefinition): void;
+    /** Resolve a pending permission request (called by WS handler). */
+    resolvePermission(hookRequestId: string, decision: {
+        behavior: 'allow' | 'deny';
+        message?: string;
+    }): boolean;
+    /** Get all pending permission requests (for UI state). */
+    getPendingPermissions(): ReadonlyMap<string, PendingPermission>;
+    /** Clean up all pending requests for a session (e.g., session ended). */
+    releaseSession(sessionId: string): void;
+    /** Clean up on shutdown. */
+    shutdown(): void;
+    private handleBlockingEvent;
+    private holdPermissionRequest;
+    private emitSpecificEvent;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/hooks/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/hooks/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAIlB,MAAM,YAAY,CAAC;AASpB,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1C,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CACtC;AAMD,qBAAa,UAAU;IAMnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAN9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAC7E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,kBAAkB,CAAK;gBAGZ,QAAQ,EAAE,iBAAiB,CAAC,YAAY,CAAC,EACzC,WAAW,EAAE,kBAAkB;IAgBlD;;;;;;OAMG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,GAAE,MAAiB,GACzB,OAAO,CAAC,YAAY,CAAC;IAuDxB,gDAAgD;IAChD,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI;IAIlD,mEAAmE;IACnE,iBAAiB,CACf,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE;QAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACzD,OAAO;IAgBV,0DAA0D;IAC1D,qBAAqB,IAAI,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAI/D,yEAAyE;IACzE,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAUvC,4BAA4B;IAC5B,QAAQ,IAAI,IAAI;YAYF,mBAAmB;IAuBjC,OAAO,CAAC,qBAAqB;IAwC7B,OAAO,CAAC,iBAAiB;CAgF1B"}

package/dist/hooks/router.js

@@ -0,0 +1,259 @@
+/**
+ * HookRouter — central dispatcher for agent hook events.
+ *
+ * Receives events from the HTTP endpoint (posted by `vpd hook notify`),
+ * validates them, emits typed events on the daemon bus, and handles
+ * blocking hooks like PermissionRequest by holding the HTTP response
+ * until a supervising client responds.
+ *
+ * Design:
+ *   - Event definitions are data (HookEventDefinition), not code.
+ *   - Adding a new hook = adding a schema + definition. No switch statements.
+ *   - The router doesn't know about specific agents — it's adapter-agnostic.
+ *   - Blocking logic is isolated to handleBlockingEvent().
+ */
+import { HOOK_INPUT_SCHEMAS, DEFAULT_EVENT_DEFINITIONS, HookBaseInputSchema, } from './types.js';
+import { logger } from '../core/logger.js';
+const log = logger.child({ module: 'hook-router' });
+// ---------------------------------------------------------------------------
+// HookRouter
+// ---------------------------------------------------------------------------
+export class HookRouter {
+    eventBus;
+    supervision;
+    definitions = new Map();
+    pending = new Map();
+    hookRequestCounter = 0;
+    constructor(eventBus, supervision) {
+        this.eventBus = eventBus;
+        this.supervision = supervision;
+        for (const def of DEFAULT_EVENT_DEFINITIONS) {
+            this.definitions.set(def.kind, def);
+        }
+        // Listen for permission responses from WS clients
+        this.eventBus.on('hook:permission-response', ({ hookRequestId, decision }) => {
+            this.resolvePermission(hookRequestId, decision);
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /**
+     * Handle an incoming hook event from an agent.
+     *
+     * For non-blocking events: emits on the event bus and returns immediately.
+     * For blocking events (PermissionRequest): holds if supervised, or returns
+     * passthrough if nobody is watching.
+     */
+    async handleEvent(input, adapter = 'claude') {
+        // Validate base fields
+        const baseResult = HookBaseInputSchema.safeParse(input);
+        if (!baseResult.success) {
+            log.warn({ input, error: baseResult.error.message }, 'Invalid hook input — missing base fields');
+            return { passthrough: true };
+        }
+        const kind = baseResult.data.hook_event_name;
+        const schema = HOOK_INPUT_SCHEMAS[kind];
+        if (!schema) {
+            log.debug({ kind }, 'Unknown hook event kind — passthrough');
+            return { passthrough: true };
+        }
+        const parsed = schema.safeParse(input);
+        if (!parsed.success) {
+            log.warn({ kind, error: parsed.error.message }, 'Hook input validation failed');
+            return { passthrough: true };
+        }
+        const sessionId = baseResult.data.session_id;
+        const cwd = baseResult.data.cwd;
+        // Emit the generic hook:event for any listeners
+        this.eventBus.emit('hook:event', {
+            kind,
+            sessionId,
+            adapter,
+            cwd,
+            payload: parsed.data,
+        });
+        // Dispatch to specific event handler
+        const def = this.definitions.get(kind);
+        if (def?.blocking) {
+            return this.handleBlockingEvent(kind, parsed.data, {
+                sessionId,
+                adapter,
+                cwd,
+                timeoutMs: def.defaultTimeoutMs,
+            });
+        }
+        // Non-blocking: emit specific event and return immediately
+        this.emitSpecificEvent(kind, parsed.data, {
+            sessionId,
+            adapter,
+        });
+        return { passthrough: false };
+    }
+    /** Register or override an event definition. */
+    registerDefinition(def) {
+        this.definitions.set(def.kind, def);
+    }
+    /** Resolve a pending permission request (called by WS handler). */
+    resolvePermission(hookRequestId, decision) {
+        const pending = this.pending.get(hookRequestId);
+        if (!pending)
+            return false;
+        clearTimeout(pending.timer);
+        this.pending.delete(hookRequestId);
+        log.info({ hookRequestId, sessionId: pending.sessionId, decision: decision.behavior }, 'Permission resolved by supervisor');
+        pending.resolve({ passthrough: false, decision });
+        return true;
+    }
+    /** Get all pending permission requests (for UI state). */
+    getPendingPermissions() {
+        return this.pending;
+    }
+    /** Clean up all pending requests for a session (e.g., session ended). */
+    releaseSession(sessionId) {
+        for (const [id, pending] of this.pending) {
+            if (pending.sessionId === sessionId) {
+                clearTimeout(pending.timer);
+                this.pending.delete(id);
+                pending.resolve({ passthrough: true });
+            }
+        }
+    }
+    /** Clean up on shutdown. */
+    shutdown() {
+        for (const [, pending] of this.pending) {
+            clearTimeout(pending.timer);
+            pending.resolve({ passthrough: true });
+        }
+        this.pending.clear();
+    }
+    // -------------------------------------------------------------------------
+    // Private
+    // -------------------------------------------------------------------------
+    async handleBlockingEvent(kind, data, ctx) {
+        // If not supervised, fall through immediately
+        if (!this.supervision.isSupervised(ctx.sessionId)) {
+            log.debug({ kind, sessionId: ctx.sessionId }, 'Not supervised — passthrough');
+            // Still emit the event for visibility (non-blocking listeners)
+            this.emitSpecificEvent(kind, data, ctx);
+            return { passthrough: true };
+        }
+        // For PermissionRequest: hold and wait for supervisor response
+        if (kind === 'PermissionRequest') {
+            return this.holdPermissionRequest(data, ctx);
+        }
+        // Other blocking events: emit and passthrough for now
+        this.emitSpecificEvent(kind, data, ctx);
+        return { passthrough: true };
+    }
+    holdPermissionRequest(data, ctx) {
+        const hookRequestId = `hk-${++this.hookRequestCounter}-${Date.now()}`;
+        const toolName = data.tool_name ?? 'unknown';
+        const toolInput = data.tool_input;
+        // Emit the permission request event so WS server can broadcast
+        this.eventBus.emit('hook:permission-request', {
+            sessionId: ctx.sessionId,
+            adapter: ctx.adapter,
+            hookRequestId,
+            toolName,
+            toolInput,
+            cwd: ctx.cwd,
+        });
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(hookRequestId);
+                log.info({ hookRequestId, sessionId: ctx.sessionId }, 'Permission request timed out');
+                resolve({ passthrough: true });
+            }, ctx.timeoutMs);
+            this.pending.set(hookRequestId, {
+                hookRequestId,
+                sessionId: ctx.sessionId,
+                adapter: ctx.adapter,
+                toolName,
+                toolInput,
+                cwd: ctx.cwd,
+                createdAt: Date.now(),
+                timeoutMs: ctx.timeoutMs,
+                resolve,
+                timer,
+            });
+        });
+    }
+    emitSpecificEvent(kind, data, ctx) {
+        switch (kind) {
+            case 'SessionStart':
+                this.eventBus.emit('hook:session-start', {
+                    sessionId: ctx.sessionId,
+                    adapter: ctx.adapter,
+                    cwd: data.cwd,
+                    source: data.source,
+                    agentType: data.agent_type,
+                    model: data.model,
+                });
+                break;
+            case 'SessionEnd':
+                this.eventBus.emit('hook:session-end', {
+                    sessionId: ctx.sessionId,
+                    adapter: ctx.adapter,
+                    reason: data.reason,
+                });
+                break;
+            case 'Notification':
+                this.eventBus.emit('hook:notification', {
+                    sessionId: ctx.sessionId,
+                    adapter: ctx.adapter,
+                    message: data.message ?? '',
+                    title: data.title,
+                    notificationType: data.notification_type,
+                });
+                break;
+            case 'PostToolUse':
+                this.eventBus.emit('hook:tool-completed', {
+                    sessionId: ctx.sessionId,
+                    adapter: ctx.adapter,
+                    toolName: data.tool_name ?? '',
+                    toolInput: data.tool_input,
+                    toolResponse: data.tool_response,
+                });
+                break;
+            case 'PostToolUseFailure':
+                this.eventBus.emit('hook:tool-failed', {
+                    sessionId: ctx.sessionId,
+                    adapter: ctx.adapter,
+                    toolName: data.tool_name ?? '',
+                    error: data.error,
+                    isInterrupt: data.is_interrupt,
+                });
+                break;
+            case 'Stop':
+                this.eventBus.emit('hook:stop', {
+                    sessionId: ctx.sessionId,
+                    adapter: ctx.adapter,
+                    lastMessage: data.last_assistant_message,
+                });
+                break;
+            case 'SubagentStart':
+                this.eventBus.emit('hook:subagent-start', {
+                    sessionId: ctx.sessionId,
+                    adapter: ctx.adapter,
+                    agentId: data.agent_id,
+                    agentType: data.agent_type,
+                });
+                break;
+            case 'SubagentStop':
+                this.eventBus.emit('hook:subagent-stop', {
+                    sessionId: ctx.sessionId,
+                    adapter: ctx.adapter,
+                    agentId: data.agent_id,
+                    agentType: data.agent_type,
+                    lastMessage: data.last_assistant_message,
+                });
+                break;
+            default:
+                // Generic events (UserPromptSubmit, TaskCompleted, PreToolUse, PermissionRequest)
+                // are already emitted via hook:event — no specific event needed yet
+                break;
+        }
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/hooks/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/hooks/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAIL,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;AAmBpD,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,OAAO,UAAU;IAMF;IACA;IANF,WAAW,GAAG,IAAI,GAAG,EAAsC,CAAC;IAC5D,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IACxD,kBAAkB,GAAG,CAAC,CAAC;IAE/B,YACmB,QAAyC,EACzC,WAA+B;QAD/B,aAAQ,GAAR,QAAQ,CAAiC;QACzC,gBAAW,GAAX,WAAW,CAAoB;QAEhD,KAAK,MAAM,GAAG,IAAI,yBAAyB,EAAE,CAAC;YAC5C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;QAED,kDAAkD;QAClD,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,0BAA0B,EAAE,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC3E,IAAI,CAAC,iBAAiB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,aAAa;IACb,4EAA4E;IAE5E;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CACf,KAA8B,EAC9B,UAAkB,QAAQ;QAE1B,uBAAuB;QACvB,MAAM,UAAU,GAAG,mBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CACN,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,EAC1C,0CAA0C,CAC3C,CAAC;YACF,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAED,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,eAAgC,CAAC;QAC9D,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,uCAAuC,CAAC,CAAC;YAC7D,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,8BAA8B,CAAC,CAAC;YAChF,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAED,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC;QAC7C,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QAEhC,gDAAgD;QAChD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE;YAC/B,IAAI;YACJ,SAAS;YACT,OAAO;YACP,GAAG;YACH,OAAO,EAAE,MAAM,CAAC,IAA+B;SAChD,CAAC,CAAC;QAEH,qCAAqC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,GAAG,EAAE,QAAQ,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,IAA+B,EAAE;gBAC5E,SAAS;gBACT,OAAO;gBACP,GAAG;gBACH,SAAS,EAAE,GAAG,CAAC,gBAAgB;aAChC,CAAC,CAAC;QACL,CAAC;QAED,2DAA2D;QAC3D,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,IAA+B,EAAE;YACnE,SAAS;YACT,OAAO;SACR,CAAC,CAAC;QACH,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,gDAAgD;IAChD,kBAAkB,CAAC,GAAwB;QACzC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,mEAAmE;IACnE,iBAAiB,CACf,aAAqB,EACrB,QAA0D;QAE1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAE3B,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAEnC,GAAG,CAAC,IAAI,CACN,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAC5E,mCAAmC,CACpC,CAAC;QAEF,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0DAA0D;IAC1D,qBAAqB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,yEAAyE;IACzE,cAAc,CAAC,SAAiB;QAC9B,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACpC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,QAAQ;QACN,KAAK,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,4EAA4E;IAC5E,UAAU;IACV,4EAA4E;IAEpE,KAAK,CAAC,mBAAmB,CAC/B,IAAmB,EACnB,IAA6B,EAC7B,GAA4E;QAE5E,8CAA8C;QAC9C,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,8BAA8B,CAAC,CAAC;YAC9E,+DAA+D;YAC/D,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YACxC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QAED,+DAA+D;QAC/D,IAAI,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/C,CAAC;QAED,sDAAsD;QACtD,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QACxC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAEO,qBAAqB,CAC3B,IAA6B,EAC7B,GAA4E;QAE5E,MAAM,aAAa,GAAG,MAAM,EAAE,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACtE,MAAM,QAAQ,GAAI,IAAI,CAAC,SAAoB,IAAI,SAAS,CAAC;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;QAElC,+DAA+D;QAC/D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,yBAAyB,EAAE;YAC5C,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,aAAa;YACb,QAAQ;YACR,SAAS;YACT,GAAG,EAAE,GAAG,CAAC,GAAG;SACb,CAAC,CAAC;QAEH,OAAO,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,EAAE;YAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;gBACnC,GAAG,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,8BAA8B,CAAC,CAAC;gBACtF,OAAO,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;YACjC,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;YAElB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE;gBAC9B,aAAa;gBACb,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,QAAQ;gBACR,SAAS;gBACT,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,OAAO;gBACP,KAAK;aACN,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB,CACvB,IAAmB,EACnB,IAA6B,EAC7B,GAA2C;QAE3C,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,cAAc;gBACjB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE;oBACvC,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,GAAG,EAAE,IAAI,CAAC,GAAyB;oBACnC,MAAM,EAAE,IAAI,CAAC,MAA4B;oBACzC,SAAS,EAAE,IAAI,CAAC,UAAgC;oBAChD,KAAK,EAAE,IAAI,CAAC,KAA2B;iBACxC,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,YAAY;gBACf,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE;oBACrC,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,MAAM,EAAE,IAAI,CAAC,MAA4B;iBAC1C,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,cAAc;gBACjB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE;oBACtC,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,OAAO,EAAG,IAAI,CAAC,OAAkB,IAAI,EAAE;oBACvC,KAAK,EAAE,IAAI,CAAC,KAA2B;oBACvC,gBAAgB,EAAE,IAAI,CAAC,iBAAuC;iBAC/D,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,aAAa;gBAChB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE;oBACxC,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,QAAQ,EAAG,IAAI,CAAC,SAAoB,IAAI,EAAE;oBAC1C,SAAS,EAAE,IAAI,CAAC,UAAU;oBAC1B,YAAY,EAAE,IAAI,CAAC,aAAa;iBACjC,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,oBAAoB;gBACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE;oBACrC,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,QAAQ,EAAG,IAAI,CAAC,SAAoB,IAAI,EAAE;oBAC1C,KAAK,EAAE,IAAI,CAAC,KAA2B;oBACvC,WAAW,EAAE,IAAI,CAAC,YAAmC;iBACtD,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE;oBAC9B,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,WAAW,EAAE,IAAI,CAAC,sBAA4C;iBAC/D,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,eAAe;gBAClB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE;oBACxC,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,OAAO,EAAE,IAAI,CAAC,QAA8B;oBAC5C,SAAS,EAAE,IAAI,CAAC,UAAgC;iBACjD,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,cAAc;gBACjB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE;oBACvC,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,OAAO,EAAE,IAAI,CAAC,QAA8B;oBAC5C,SAAS,EAAE,IAAI,CAAC,UAAgC;oBAChD,WAAW,EAAE,IAAI,CAAC,sBAA4C;iBAC/D,CAAC,CAAC;gBACH,MAAM;YACR;gBACE,kFAAkF;gBAClF,oEAAoE;gBACpE,MAAM;QACV,CAAC;IACH,CAAC;CACF"}

package/dist/hooks/supervision.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SupervisionManager — tracks which sessions are being supervised by remote clients.
+ *
+ * When a session is supervised, blocking hooks (like PermissionRequest) will hold
+ * and relay the request to the supervising clients instead of falling through to
+ * the agent's local UI (e.g., the terminal prompt).
+ *
+ * When no clients are supervising, hooks fall through so the local UX is unaffected.
+ */
+import type { ConnectedClient } from '../server/hello-builder.js';
+export declare class SupervisionManager {
+    /** sessionId → set of supervising clients */
+    private readonly supervisors;
+    /** Start supervising a session. */
+    supervise(sessionId: string, client: ConnectedClient): void;
+    /** Stop supervising a session. */
+    unsupervise(sessionId: string, client: ConnectedClient): void;
+    /** Check if any client is supervising this session. */
+    isSupervised(sessionId: string): boolean;
+    /** Get all supervising clients for a session. */
+    getSupervisors(sessionId: string): ReadonlySet<ConnectedClient>;
+    /** Remove a client from all sessions (call on disconnect). */
+    removeClient(client: ConnectedClient): string[];
+    /** Get all supervised session IDs. */
+    getSupervisedSessions(): string[];
+}
+//# sourceMappingURL=supervision.d.ts.map

package/dist/hooks/supervision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervision.d.ts","sourceRoot":"","sources":["../../src/hooks/supervision.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAKlE,qBAAa,kBAAkB;IAC7B,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;IAEvE,mCAAmC;IACnC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAU3D,kCAAkC;IAClC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAU7D,uDAAuD;IACvD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAKxC,iDAAiD;IACjD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC,eAAe,CAAC;IAI/D,8DAA8D;IAC9D,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE;IAiB/C,sCAAsC;IACtC,qBAAqB,IAAI,MAAM,EAAE;CAGlC"}

package/dist/hooks/supervision.js

@@ -0,0 +1,67 @@
+/**
+ * SupervisionManager — tracks which sessions are being supervised by remote clients.
+ *
+ * When a session is supervised, blocking hooks (like PermissionRequest) will hold
+ * and relay the request to the supervising clients instead of falling through to
+ * the agent's local UI (e.g., the terminal prompt).
+ *
+ * When no clients are supervising, hooks fall through so the local UX is unaffected.
+ */
+import { logger } from '../core/logger.js';
+const log = logger.child({ module: 'supervision' });
+export class SupervisionManager {
+    /** sessionId → set of supervising clients */
+    supervisors = new Map();
+    /** Start supervising a session. */
+    supervise(sessionId, client) {
+        let clients = this.supervisors.get(sessionId);
+        if (!clients) {
+            clients = new Set();
+            this.supervisors.set(sessionId, clients);
+        }
+        clients.add(client);
+        log.info({ sessionId, supervisorCount: clients.size }, 'Client started supervising');
+    }
+    /** Stop supervising a session. */
+    unsupervise(sessionId, client) {
+        const clients = this.supervisors.get(sessionId);
+        if (!clients)
+            return;
+        clients.delete(client);
+        if (clients.size === 0) {
+            this.supervisors.delete(sessionId);
+        }
+        log.info({ sessionId, supervisorCount: clients?.size ?? 0 }, 'Client stopped supervising');
+    }
+    /** Check if any client is supervising this session. */
+    isSupervised(sessionId) {
+        const clients = this.supervisors.get(sessionId);
+        return clients !== undefined && clients.size > 0;
+    }
+    /** Get all supervising clients for a session. */
+    getSupervisors(sessionId) {
+        return this.supervisors.get(sessionId) ?? new Set();
+    }
+    /** Remove a client from all sessions (call on disconnect). */
+    removeClient(client) {
+        const released = [];
+        for (const [sessionId, clients] of this.supervisors) {
+            if (clients.has(client)) {
+                clients.delete(client);
+                if (clients.size === 0) {
+                    this.supervisors.delete(sessionId);
+                    released.push(sessionId);
+                }
+            }
+        }
+        if (released.length > 0) {
+            log.info({ released }, 'Client disconnected — released supervision');
+        }
+        return released;
+    }
+    /** Get all supervised session IDs. */
+    getSupervisedSessions() {
+        return [...this.supervisors.keys()];
+    }
+}
+//# sourceMappingURL=supervision.js.map

package/dist/hooks/supervision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervision.js","sourceRoot":"","sources":["../../src/hooks/supervision.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;AAEpD,MAAM,OAAO,kBAAkB;IAC7B,6CAA6C;IAC5B,WAAW,GAAG,IAAI,GAAG,EAAgC,CAAC;IAEvE,mCAAmC;IACnC,SAAS,CAAC,SAAiB,EAAE,MAAuB;QAClD,IAAI,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,4BAA4B,CAAC,CAAC;IACvF,CAAC;IAED,kCAAkC;IAClC,WAAW,CAAC,SAAiB,EAAE,MAAuB;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,EAAE,EAAE,4BAA4B,CAAC,CAAC;IAC7F,CAAC;IAED,uDAAuD;IACvD,YAAY,CAAC,SAAiB;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,iDAAiD;IACjD,cAAc,CAAC,SAAiB;QAC9B,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IACtD,CAAC;IAED,8DAA8D;IAC9D,YAAY,CAAC,MAAuB;QAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpD,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACvB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACvB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBACnC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,4CAA4C,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,sCAAsC;IACtC,qBAAqB;QACnB,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/hooks/types.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Hook system types — adapter-agnostic event definitions for agent lifecycle hooks.
+ *
+ * The hook system allows the daemon to receive events from any agent (Claude Code,
+ * Gemini, Cursor, etc.) via lightweight CLI commands that POST to the daemon.
+ * Each hook event has a typed input schema and metadata about how it should be handled.
+ *
+ * Design:
+ *   - HookEventKind: all supported event names (extensible enum-like union)
+ *   - HookInput<K>: typed input for each event kind
+ *   - HookEventDefinition: registry entry with schema, blocking flag, handler
+ *   - HookResponse: what the daemon returns to the hook command
+ */
+import { z } from 'zod';
+export declare const HOOK_EVENT_KINDS: readonly ["SessionStart", "SessionEnd", "PermissionRequest", "Notification", "Stop", "PreToolUse", "PostToolUse", "PostToolUseFailure", "SubagentStart", "SubagentStop", "UserPromptSubmit", "TaskCompleted"];
+export type HookEventKind = (typeof HOOK_EVENT_KINDS)[number];
+export declare const HookBaseInputSchema: z.ZodObject<{
+    hook_event_name: z.ZodString;
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HookBaseInput = z.infer<typeof HookBaseInputSchema>;
+export declare const SessionStartInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodLiteral<"SessionStart">;
+    source: z.ZodOptional<z.ZodEnum<{
+        resume: "resume";
+        startup: "startup";
+        clear: "clear";
+        compact: "compact";
+    }>>;
+    agent_type: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SessionEndInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodLiteral<"SessionEnd">;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const PermissionRequestInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodLiteral<"PermissionRequest">;
+    tool_name: z.ZodString;
+    tool_input: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const NotificationInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodLiteral<"Notification">;
+    message: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    notification_type: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const StopInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodLiteral<"Stop">;
+    stop_hook_active: z.ZodOptional<z.ZodBoolean>;
+    last_assistant_message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const PreToolUseInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodLiteral<"PreToolUse">;
+    tool_name: z.ZodString;
+    tool_input: z.ZodOptional<z.ZodUnknown>;
+    tool_use_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const PostToolUseInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodLiteral<"PostToolUse">;
+    tool_name: z.ZodString;
+    tool_input: z.ZodOptional<z.ZodUnknown>;
+    tool_response: z.ZodOptional<z.ZodUnknown>;
+    tool_use_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const PostToolUseFailureInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodLiteral<"PostToolUseFailure">;
+    tool_name: z.ZodString;
+    tool_input: z.ZodOptional<z.ZodUnknown>;
+    tool_use_id: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    is_interrupt: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const SubagentStartInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodLiteral<"SubagentStart">;
+    agent_id: z.ZodOptional<z.ZodString>;
+    agent_type: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SubagentStopInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodLiteral<"SubagentStop">;
+    agent_id: z.ZodOptional<z.ZodString>;
+    agent_type: z.ZodOptional<z.ZodString>;
+    agent_transcript_path: z.ZodOptional<z.ZodString>;
+    last_assistant_message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const UserPromptSubmitInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodLiteral<"UserPromptSubmit">;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const TaskCompletedInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    transcript_path: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    permission_mode: z.ZodOptional<z.ZodString>;
+    hook_event_name: z.ZodLiteral<"TaskCompleted">;
+    task_id: z.ZodOptional<z.ZodString>;
+    task_subject: z.ZodOptional<z.ZodString>;
+    task_description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const HOOK_INPUT_SCHEMAS: Record<HookEventKind, z.ZodType>;
+/** Returned to the hook CLI command. */
+export interface HookResponse {
+    /** If true, the hook should exit non-zero so the agent falls through to its own UI. */
+    passthrough: boolean;
+    /** Permission decision (only for PermissionRequest). */
+    decision?: {
+        behavior: 'allow' | 'deny';
+        message?: string;
+    };
+}
+export interface HookContext {
+    /** The adapter/agent that sent this event (e.g., 'claude', 'gemini'). */
+    adapter: string;
+}
+export interface HookEventDefinition {
+    /** The event kind this definition handles. */
+    kind: HookEventKind;
+    /** Whether the hook should block and wait for a response (e.g., PermissionRequest). */
+    blocking: boolean;
+    /** Default timeout in ms for blocking hooks. */
+    defaultTimeoutMs: number;
+}
+export declare const DEFAULT_EVENT_DEFINITIONS: HookEventDefinition[];
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,gBAAgB,+MAanB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAM9D,eAAO,MAAM,mBAAmB;;;;;;iBAM9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;iBAKlC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;iBAGhC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;iBAIvC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;iBAKlC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;iBAI1B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;iBAKhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;iBAMjC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;iBAOxC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;iBAInC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;iBAMlC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;iBAGtC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;iBAKnC,CAAC;AAMH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAa/D,CAAC;AAMF,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,uFAAuF;IACvF,WAAW,EAAE,OAAO,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE;QAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AAMD,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,IAAI,EAAE,aAAa,CAAC;IACpB,uFAAuF;IACvF,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAMD,eAAO,MAAM,yBAAyB,EAAE,mBAAmB,EAa1D,CAAC"}