@agent-relay/hooks 0.1.0

package/dist/browser.d.ts

@@ -0,0 +1,2 @@
+export * from './types.js';
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC"}

package/dist/browser.js

@@ -0,0 +1,3 @@
+// Browser-safe entry: types only, no Node dependencies
+export * from './types.js';
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,YAAY,CAAC"}

package/dist/emitter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * HookEmitter
+ *
+ * Lightweight async event emitter for hook handlers.
+ * - Supports async handlers
+ * - Allows stop-propagation via `{ stop: true }` return value
+ * - Can preload handlers from a config object
+ */
+export type EmitterHandlerResult = unknown | {
+    stop?: boolean;
+};
+export type EmitterHandler = (...args: unknown[]) => EmitterHandlerResult | Promise<EmitterHandlerResult>;
+export interface EmitResult {
+    /** Raw results from each handler in order */
+    results: EmitterHandlerResult[];
+    /** Whether propagation was stopped by a handler */
+    stopped: boolean;
+}
+export type EmitterHandlerConfig = Record<string, EmitterHandler | EmitterHandler[]>;
+export declare class HookEmitter {
+    private handlers;
+    constructor(config?: EmitterHandlerConfig);
+    /**
+     * Register a handler for an event.
+     * Returns an unsubscribe function to remove the handler.
+     */
+    on(event: string, handler: EmitterHandler): () => void;
+    /**
+     * Emit an event and invoke handlers sequentially.
+     * If a handler returns `{ stop: true }`, propagation halts.
+     */
+    emit(event: string, ...args: unknown[]): Promise<EmitResult>;
+    /**
+     * Load handlers from a configuration object.
+     * Values can be a single handler or an array of handlers.
+     */
+    load(config: EmitterHandlerConfig): void;
+    private shouldStop;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAE1G,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC,CAAC;AAErF,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAuC;gBAE3C,MAAM,CAAC,EAAE,oBAAoB;IAMzC;;;OAGG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI;IAWtD;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBlE;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IASxC,OAAO,CAAC,UAAU;CAGnB"}

package/dist/emitter.js

@@ -0,0 +1,63 @@
+/**
+ * HookEmitter
+ *
+ * Lightweight async event emitter for hook handlers.
+ * - Supports async handlers
+ * - Allows stop-propagation via `{ stop: true }` return value
+ * - Can preload handlers from a config object
+ */
+export class HookEmitter {
+    handlers = new Map();
+    constructor(config) {
+        if (config) {
+            this.load(config);
+        }
+    }
+    /**
+     * Register a handler for an event.
+     * Returns an unsubscribe function to remove the handler.
+     */
+    on(event, handler) {
+        const list = this.handlers.get(event) ?? [];
+        list.push(handler);
+        this.handlers.set(event, list);
+        return () => {
+            const updated = this.handlers.get(event)?.filter((fn) => fn !== handler) ?? [];
+            this.handlers.set(event, updated);
+        };
+    }
+    /**
+     * Emit an event and invoke handlers sequentially.
+     * If a handler returns `{ stop: true }`, propagation halts.
+     */
+    async emit(event, ...args) {
+        const results = [];
+        const handlers = this.handlers.get(event) ?? [];
+        let stopped = false;
+        for (const handler of handlers) {
+            const result = await handler(...args);
+            results.push(result);
+            if (this.shouldStop(result)) {
+                stopped = true;
+                break;
+            }
+        }
+        return { results, stopped };
+    }
+    /**
+     * Load handlers from a configuration object.
+     * Values can be a single handler or an array of handlers.
+     */
+    load(config) {
+        for (const [event, handler] of Object.entries(config)) {
+            const handlers = Array.isArray(handler) ? handler : [handler];
+            for (const h of handlers) {
+                this.on(event, h);
+            }
+        }
+    }
+    shouldStop(result) {
+        return typeof result === 'object' && result !== null && 'stop' in result && result.stop === true;
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,MAAM,OAAO,WAAW;IACd,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEvD,YAAY,MAA6B;QACvC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,EAAE,CAAC,KAAa,EAAE,OAAuB;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAE/B,OAAO,GAAG,EAAE;YACV,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,GAAG,IAAe;QAC1C,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChD,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM;YACR,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,MAA4B;QAC/B,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACtD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC9D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,MAA4B;QAC7C,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,IAAI,MAAM,IAAK,MAAc,CAAC,IAAI,KAAK,IAAI,CAAC;IAC5G,CAAC;CACF"}

package/dist/inbox-check/hook.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * Agent Relay Inbox Check Hook
+ *
+ * A Claude Code Stop hook that checks for unread messages in the agent-relay inbox.
+ * When messages are present, it blocks Claude from stopping and instructs it to
+ * read and respond to the messages.
+ *
+ * This enables autonomous agent-to-agent communication without human intervention.
+ *
+ * Usage in .claude/settings.json:
+ * {
+ *   "hooks": {
+ *     "Stop": [{
+ *       "hooks": [{
+ *         "type": "command",
+ *         "command": "node /path/to/agent-relay/dist/hooks/inbox-check/hook.js"
+ *       }]
+ *     }]
+ *   }
+ * }
+ *
+ * Environment Variables:
+ * - AGENT_RELAY_NAME: The agent's name (set by agent-relay wrapper)
+ * - AGENT_RELAY_INBOX_DIR: Custom inbox directory (default: /tmp/agent-relay)
+ */
+export {};
+//# sourceMappingURL=hook.d.ts.map

package/dist/inbox-check/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/inbox-check/hook.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG"}

package/dist/inbox-check/hook.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+/**
+ * Agent Relay Inbox Check Hook
+ *
+ * A Claude Code Stop hook that checks for unread messages in the agent-relay inbox.
+ * When messages are present, it blocks Claude from stopping and instructs it to
+ * read and respond to the messages.
+ *
+ * This enables autonomous agent-to-agent communication without human intervention.
+ *
+ * Usage in .claude/settings.json:
+ * {
+ *   "hooks": {
+ *     "Stop": [{
+ *       "hooks": [{
+ *         "type": "command",
+ *         "command": "node /path/to/agent-relay/dist/hooks/inbox-check/hook.js"
+ *       }]
+ *     }]
+ *   }
+ * }
+ *
+ * Environment Variables:
+ * - AGENT_RELAY_NAME: The agent's name (set by agent-relay wrapper)
+ * - AGENT_RELAY_INBOX_DIR: Custom inbox directory (default: /tmp/agent-relay)
+ */
+import { readFileSync } from 'node:fs';
+import { DEFAULT_INBOX_DIR, getAgentName, getInboxPath, hasUnreadMessages, countMessages, buildBlockReason } from './utils.js';
+/**
+ * Read hook input from stdin
+ */
+function readStdin() {
+    try {
+        const input = readFileSync(0, 'utf-8');
+        return JSON.parse(input);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Output hook result as JSON
+ */
+function outputResult(result) {
+    console.log(JSON.stringify(result));
+}
+/**
+ * Exit the hook process
+ */
+function exitHook(code) {
+    process.exit(code);
+}
+/**
+ * Main hook execution
+ */
+async function main() {
+    try {
+        // Read stdin (required by Claude Code hook protocol, but we only use env vars)
+        readStdin();
+        // Get agent name from env
+        const agentName = getAgentName();
+        // If no agent name configured, allow stop (not in relay mode)
+        if (!agentName) {
+            outputResult({ decision: 'approve' });
+            exitHook(0);
+        }
+        // Get inbox configuration
+        const inboxDir = process.env.AGENT_RELAY_INBOX_DIR || DEFAULT_INBOX_DIR;
+        const inboxPath = getInboxPath({ inboxDir, agentName });
+        // Check for unread messages
+        if (hasUnreadMessages(inboxPath)) {
+            const messageCount = countMessages(inboxPath);
+            const reason = buildBlockReason(inboxPath, messageCount);
+            // Log to stderr for visibility
+            console.error(`[agent-relay] Found ${messageCount} unread message(s), blocking stop`);
+            // Block stop and provide reason
+            outputResult({
+                decision: 'block',
+                reason
+            });
+        }
+        else {
+            // No messages, allow stop
+            outputResult({ decision: 'approve' });
+        }
+        exitHook(0);
+    }
+    catch (error) {
+        // On error, allow stop to avoid blocking user
+        console.error('[agent-relay] Hook error:', error);
+        outputResult({ decision: 'approve' });
+        exitHook(0);
+    }
+}
+// Run the hook
+main();
+//# sourceMappingURL=hook.js.map

package/dist/inbox-check/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../src/inbox-check/hook.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,SAAS,SAAS;IAChB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,MAAkB;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,+EAA+E;QAC/E,SAAS,EAAE,CAAC;QAEZ,0BAA0B;QAC1B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QAEjC,8DAA8D;QAC9D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,YAAY,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;YACtC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;QAED,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,iBAAiB,CAAC;QACxE,MAAM,SAAS,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;QAExD,4BAA4B;QAC5B,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,YAAY,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;YAEzD,+BAA+B;YAC/B,OAAO,CAAC,KAAK,CAAC,uBAAuB,YAAY,mCAAmC,CAAC,CAAC;YAEtF,gCAAgC;YAChC,YAAY,CAAC;gBACX,QAAQ,EAAE,OAAO;gBACjB,MAAM;aACP,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,0BAA0B;YAC1B,YAAY,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,QAAQ,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,8CAA8C;QAC9C,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;QAClD,YAAY,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;QACtC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;AACH,CAAC;AAED,eAAe;AACf,IAAI,EAAE,CAAC"}

package/dist/inbox-check/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Agent Relay Inbox Check Hook
+ *
+ * Exports for programmatic use of the hook utilities.
+ */
+export * from './types.js';
+export * from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/inbox-check/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inbox-check/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/inbox-check/index.js

@@ -0,0 +1,8 @@
+/**
+ * Agent Relay Inbox Check Hook
+ *
+ * Exports for programmatic use of the hook utilities.
+ */
+export * from './types.js';
+export * from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/inbox-check/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/inbox-check/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/inbox-check/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Types for Agent Relay Inbox Check Hook
+ */
+export interface HookInput {
+    /** The hook event type */
+    hook_event_name?: string;
+    /** Working directory */
+    workingDirectory?: string;
+    /** Session ID */
+    session_id?: string;
+    /** Stop reason from Claude */
+    stop_reason?: string;
+}
+export interface HookOutput {
+    /** Decision: "approve" to allow stop, "block" to continue */
+    decision: 'approve' | 'block';
+    /** Reason for the decision (shown to Claude if blocked) */
+    reason?: string;
+}
+export interface InboxMessage {
+    from: string;
+    timestamp: string;
+    body: string;
+}
+export interface InboxConfig {
+    /** Base directory for inbox files */
+    inboxDir: string;
+    /** Agent name (from env var or config) */
+    agentName?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/inbox-check/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/inbox-check/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,0BAA0B;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/inbox-check/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for Agent Relay Inbox Check Hook
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/inbox-check/types.js.map

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

package/dist/inbox-check/utils.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Utility functions for Agent Relay Inbox Check Hook
+ */
+import type { InboxConfig, InboxMessage } from './types.js';
+/** Default inbox directory */
+export declare const DEFAULT_INBOX_DIR = "/tmp/agent-relay";
+/**
+ * Get the agent name from environment or config
+ */
+export declare function getAgentName(): string | undefined;
+/**
+ * Get the inbox file path for an agent
+ */
+export declare function getInboxPath(config: InboxConfig): string;
+/**
+ * Check if inbox file exists and has content
+ */
+export declare function inboxExists(inboxPath: string): boolean;
+/**
+ * Read inbox file content
+ */
+export declare function readInbox(inboxPath: string): string;
+/**
+ * Check if inbox has unread messages
+ * Messages are marked with "## Message from" header
+ */
+export declare function hasUnreadMessages(inboxPath: string): boolean;
+/**
+ * Count unread messages in inbox
+ */
+export declare function countMessages(inboxPath: string): number;
+/**
+ * Parse messages from inbox content
+ */
+export declare function parseMessages(inboxPath: string): InboxMessage[];
+/**
+ * Format a message for display
+ */
+export declare function formatMessagePreview(msg: InboxMessage, maxLength?: number): string;
+/**
+ * Build the block reason message
+ */
+export declare function buildBlockReason(inboxPath: string, messageCount: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/inbox-check/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/inbox-check/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D,8BAA8B;AAC9B,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAGjD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAMxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAO5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAmB/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM,CAKtF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAehF"}

package/dist/inbox-check/utils.js

@@ -0,0 +1,107 @@
+/**
+ * Utility functions for Agent Relay Inbox Check Hook
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Default inbox directory */
+export const DEFAULT_INBOX_DIR = '/tmp/agent-relay';
+/**
+ * Get the agent name from environment or config
+ */
+export function getAgentName() {
+    // Check environment variable set by agent-relay wrapper
+    return process.env.AGENT_RELAY_NAME;
+}
+/**
+ * Get the inbox file path for an agent
+ */
+export function getInboxPath(config) {
+    const agentName = config.agentName || getAgentName();
+    if (!agentName) {
+        throw new Error('Agent name not configured. Set AGENT_RELAY_NAME env var.');
+    }
+    return join(config.inboxDir, agentName, 'inbox.md');
+}
+/**
+ * Check if inbox file exists and has content
+ */
+export function inboxExists(inboxPath) {
+    return existsSync(inboxPath);
+}
+/**
+ * Read inbox file content
+ */
+export function readInbox(inboxPath) {
+    if (!inboxExists(inboxPath)) {
+        return '';
+    }
+    return readFileSync(inboxPath, 'utf-8');
+}
+/**
+ * Check if inbox has unread messages
+ * Messages are marked with "## Message from" header
+ */
+export function hasUnreadMessages(inboxPath) {
+    const content = readInbox(inboxPath);
+    if (!content || !content.trim()) {
+        return false;
+    }
+    // Check for message headers
+    return content.includes('## Message from');
+}
+/**
+ * Count unread messages in inbox
+ */
+export function countMessages(inboxPath) {
+    const content = readInbox(inboxPath);
+    if (!content) {
+        return 0;
+    }
+    const matches = content.match(/## Message from/g);
+    return matches ? matches.length : 0;
+}
+/**
+ * Parse messages from inbox content
+ */
+export function parseMessages(inboxPath) {
+    const content = readInbox(inboxPath);
+    if (!content) {
+        return [];
+    }
+    const messages = [];
+    const messageBlocks = content.split(/(?=## Message from)/);
+    for (const block of messageBlocks) {
+        const headerMatch = block.match(/## Message from (\S+) \| (.+)\n/);
+        if (headerMatch) {
+            const [, from, timestamp] = headerMatch;
+            const body = block.replace(/## Message from .+\n/, '').trim();
+            messages.push({ from, timestamp, body });
+        }
+    }
+    return messages;
+}
+/**
+ * Format a message for display
+ */
+export function formatMessagePreview(msg, maxLength = 50) {
+    const preview = msg.body.length > maxLength
+        ? msg.body.substring(0, maxLength) + '...'
+        : msg.body;
+    return `[${msg.from}]: ${preview}`;
+}
+/**
+ * Build the block reason message
+ */
+export function buildBlockReason(inboxPath, messageCount) {
+    const messages = parseMessages(inboxPath);
+    const previews = messages.slice(0, 3).map(m => formatMessagePreview(m));
+    let reason = `You have ${messageCount} unread relay message(s) in ${inboxPath}.\n\n`;
+    reason += 'Messages:\n';
+    reason += previews.map(p => `  - ${p}`).join('\n');
+    if (messages.length > 3) {
+        reason += `\n  ... and ${messages.length - 3} more`;
+    }
+    reason += '\n\nPlease read the inbox file and respond to all messages before stopping.';
+    return reason;
+}
+//# sourceMappingURL=utils.js.map

package/dist/inbox-check/utils.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Agent Relay Hooks
+ *
+ * Entry point for the hooks system types and utilities.
+ */
+export * from './types.js';
+export * from './registry.js';
+export * from './trajectory-hooks.js';
+export * from './emitter.js';
+export * from './inbox-check/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * Agent Relay Hooks
+ *
+ * Entry point for the hooks system types and utilities.
+ */
+export * from './types.js';
+export * from './registry.js';
+export * from './trajectory-hooks.js';
+export * from './emitter.js';
+export * from './inbox-check/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC"}