agenthub-multiagent-mcp 1.7.1 → 1.7.3

package/dist/hooks/index.d.ts

@@ -0,0 +1,93 @@
+/**
+ * MCP Hooks Enforcement System
+ *
+ * Entry point for all hook functionality.
+ * Provides a unified API for the tool handlers.
+ */
+export * from "./types.js";
+import { HookResult, AvailableTask, OnConnectBriefing, TaskCompleteValidation, SessionState, HookConfig } from "./types.js";
+import * as onConnect from "./onConnect.js";
+import * as onTaskStart from "./onTaskStart.js";
+import * as onTaskComplete from "./onTaskComplete.js";
+import * as onDisconnect from "./onDisconnect.js";
+import * as periodicReminder from "./periodicReminder.js";
+export { onConnect, onTaskStart, onTaskComplete, onDisconnect, periodicReminder };
+/**
+ * Hook Manager - Central orchestration for all hooks.
+ */
+export declare class HookManager {
+    /**
+     * Check if hooks are enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Handle agent connection (register or reconnect).
+     */
+    handleConnect(agentId: string, agentName: string, agentType: string | undefined, briefing: OnConnectBriefing, isReconnect: boolean): HookResult;
+    /**
+     * Handle task start.
+     * Returns blocked: true if ticket is required but not provided.
+     */
+    handleTaskStart(agentId: string, taskId: string | undefined, taskDescription: string, availableTasks: AvailableTask[]): HookResult;
+    /**
+     * Handle task completion.
+     * Returns blocked: true if context requirements are not met.
+     */
+    handleTaskComplete(agentId: string, validation: TaskCompleteValidation): HookResult;
+    /**
+     * Handle agent disconnect.
+     * Non-blocking - returns session summary.
+     */
+    handleDisconnect(agentId: string): {
+        summary: ReturnType<typeof onDisconnect.generateSessionSummary>;
+        slackMessage: string | null;
+    };
+    /**
+     * Check if a periodic reminder should be shown.
+     * Call after each tool call.
+     */
+    checkReminder(agentId: string): HookResult;
+    /**
+     * Record a context save operation.
+     */
+    recordContextSave(agentId: string, type: "decision" | "note" | "blocker" | "insight"): void;
+    /**
+     * Check if a tool is a context-saving operation.
+     */
+    isContextSaveOperation(toolName: string): boolean;
+    /**
+     * Check if a tool is a task lifecycle operation.
+     */
+    isTaskLifecycleOperation(toolName: string): boolean;
+    /**
+     * Get context counts for the current task.
+     */
+    getContextCounts(agentId: string): SessionState["context_counts"];
+    /**
+     * Check if task has incomplete work.
+     */
+    hasIncompleteWork(agentId: string): boolean;
+    /**
+     * Build partial completion data if there's incomplete work.
+     */
+    buildPartialCompletion(agentId: string): {
+        task_id: string;
+        summary: string;
+        outcome: "partial";
+        context_counts: SessionState["context_counts"];
+    } | null;
+    /**
+     * Build briefing data from API responses.
+     */
+    buildBriefing(availableTasks: AvailableTask[], pendingMessagesCount: number, unfinishedTask?: OnConnectBriefing["unfinished_task"], activeBlockers?: number): OnConnectBriefing;
+    /**
+     * Update hook configuration.
+     */
+    configure(config: Partial<HookConfig>): void;
+    /**
+     * Get current configuration.
+     */
+    getConfig(): HookConfig;
+}
+export declare const hookManager: HookManager;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAElF;;GAEG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,aAAa,CACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,EAAE,OAAO,GACnB,UAAU;IAQb;;;OAGG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,aAAa,EAAE,GAC9B,UAAU;IAYb;;;OAGG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,UAAU;IASnF;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;QACjC,OAAO,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,sBAAsB,CAAC,CAAC;QAChE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;IAID;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAQ1C;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI;IAI3F;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjD;;OAEG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAInD;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC,gBAAgB,CAAC;IAIjE;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI3C;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM;;;;;;IAItC;;OAEG;IACH,aAAa,CACX,cAAc,EAAE,aAAa,EAAE,EAC/B,oBAAoB,EAAE,MAAM,EAC5B,cAAc,CAAC,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,EACrD,cAAc,CAAC,EAAE,MAAM,GACtB,iBAAiB;IAIpB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAI5C;;OAEG;IACH,SAAS,IAAI,UAAU;CAGxB;AAGD,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,134 @@
+/**
+ * MCP Hooks Enforcement System
+ *
+ * Entry point for all hook functionality.
+ * Provides a unified API for the tool handlers.
+ */
+export * from "./types.js";
+import * as sessionState from "./sessionState.js";
+import * as onConnect from "./onConnect.js";
+import * as onTaskStart from "./onTaskStart.js";
+import * as onTaskComplete from "./onTaskComplete.js";
+import * as onDisconnect from "./onDisconnect.js";
+import * as periodicReminder from "./periodicReminder.js";
+// Re-export individual hook modules for direct access
+export { onConnect, onTaskStart, onTaskComplete, onDisconnect, periodicReminder };
+/**
+ * Hook Manager - Central orchestration for all hooks.
+ */
+export class HookManager {
+    /**
+     * Check if hooks are enabled.
+     */
+    isEnabled() {
+        return sessionState.isEnabled();
+    }
+    /**
+     * Handle agent connection (register or reconnect).
+     */
+    handleConnect(agentId, agentName, agentType, briefing, isReconnect) {
+        if (!this.isEnabled()) {
+            return { blocked: false };
+        }
+        return onConnect.executeOnConnect(agentId, agentName, agentType, briefing, isReconnect);
+    }
+    /**
+     * Handle task start.
+     * Returns blocked: true if ticket is required but not provided.
+     */
+    handleTaskStart(agentId, taskId, taskDescription, availableTasks) {
+        if (!this.isEnabled()) {
+            // Still track the task even if enforcement is disabled
+            if (taskId) {
+                sessionState.startTask(agentId, taskId);
+            }
+            return { blocked: false };
+        }
+        return onTaskStart.executeOnTaskStart(agentId, taskId, taskDescription, availableTasks);
+    }
+    /**
+     * Handle task completion.
+     * Returns blocked: true if context requirements are not met.
+     */
+    handleTaskComplete(agentId, validation) {
+        if (!this.isEnabled()) {
+            sessionState.completeTask(agentId);
+            return { blocked: false };
+        }
+        return onTaskComplete.executeOnTaskComplete(agentId, validation);
+    }
+    /**
+     * Handle agent disconnect.
+     * Non-blocking - returns session summary.
+     */
+    handleDisconnect(agentId) {
+        return onDisconnect.executeOnDisconnect(agentId);
+    }
+    /**
+     * Check if a periodic reminder should be shown.
+     * Call after each tool call.
+     */
+    checkReminder(agentId) {
+        if (!this.isEnabled()) {
+            return { blocked: false };
+        }
+        return periodicReminder.checkReminder(agentId);
+    }
+    /**
+     * Record a context save operation.
+     */
+    recordContextSave(agentId, type) {
+        sessionState.recordContextSave(agentId, type);
+    }
+    /**
+     * Check if a tool is a context-saving operation.
+     */
+    isContextSaveOperation(toolName) {
+        return periodicReminder.isContextSaveOperation(toolName);
+    }
+    /**
+     * Check if a tool is a task lifecycle operation.
+     */
+    isTaskLifecycleOperation(toolName) {
+        return periodicReminder.isTaskLifecycleOperation(toolName);
+    }
+    /**
+     * Get context counts for the current task.
+     */
+    getContextCounts(agentId) {
+        return sessionState.getContextCounts(agentId);
+    }
+    /**
+     * Check if task has incomplete work.
+     */
+    hasIncompleteWork(agentId) {
+        return onDisconnect.hasIncompleteWork(agentId);
+    }
+    /**
+     * Build partial completion data if there's incomplete work.
+     */
+    buildPartialCompletion(agentId) {
+        return onDisconnect.buildPartialCompletion(agentId);
+    }
+    /**
+     * Build briefing data from API responses.
+     */
+    buildBriefing(availableTasks, pendingMessagesCount, unfinishedTask, activeBlockers) {
+        return onConnect.buildBriefing(availableTasks, pendingMessagesCount, unfinishedTask, activeBlockers);
+    }
+    /**
+     * Update hook configuration.
+     */
+    configure(config) {
+        sessionState.setConfig(config);
+    }
+    /**
+     * Get current configuration.
+     */
+    getConfig() {
+        return sessionState.getConfig();
+    }
+}
+// Singleton instance
+export const hookManager = new HookManager();
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

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

package/dist/hooks/onConnect.d.ts

@@ -0,0 +1,20 @@
+/**
+ * OnConnect Hook
+ * Triggered on agent_register or agent_reconnect.
+ * Provides a briefing with available tasks and any unfinished work.
+ */
+import { HookResult, OnConnectBriefing, AvailableTask } from "./types.js";
+/**
+ * Format the connection briefing message.
+ */
+export declare function formatBriefing(agentName: string, agentType: string | undefined, briefing: OnConnectBriefing, isReconnect: boolean): string;
+/**
+ * Execute the OnConnect hook.
+ * Returns a briefing message to append to the registration response.
+ */
+export declare function executeOnConnect(agentId: string, agentName: string, agentType: string | undefined, briefing: OnConnectBriefing, isReconnect: boolean): HookResult;
+/**
+ * Build briefing data from API responses.
+ */
+export declare function buildBriefing(availableTasks: AvailableTask[], pendingMessagesCount: number, unfinishedTask?: OnConnectBriefing["unfinished_task"], activeBlockers?: number): OnConnectBriefing;
+//# sourceMappingURL=onConnect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onConnect.d.ts","sourceRoot":"","sources":["../../src/hooks/onConnect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG1E;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,EAAE,OAAO,GACnB,MAAM,CAyDR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,EAAE,OAAO,GACnB,UAAU,CAWZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,aAAa,EAAE,EAC/B,oBAAoB,EAAE,MAAM,EAC5B,cAAc,CAAC,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,EACrD,cAAc,CAAC,EAAE,MAAM,GACtB,iBAAiB,CAOnB"}

package/dist/hooks/onConnect.js

@@ -0,0 +1,85 @@
+/**
+ * OnConnect Hook
+ * Triggered on agent_register or agent_reconnect.
+ * Provides a briefing with available tasks and any unfinished work.
+ */
+import * as sessionState from "./sessionState.js";
+/**
+ * Format the connection briefing message.
+ */
+export function formatBriefing(agentName, agentType, briefing, isReconnect) {
+    const lines = [];
+    // Header
+    const action = isReconnect ? "Reconnected" : "Registered";
+    lines.push(`✅ ${action} as "${agentName}"`);
+    lines.push("");
+    // Available tasks
+    if (briefing.available_tasks.length > 0) {
+        const typeNote = agentType ? ` (matching your type: ${agentType})` : "";
+        lines.push(`📋 AVAILABLE TASKS${typeNote}:`);
+        for (const task of briefing.available_tasks.slice(0, 5)) {
+            const priority = task.priority.toUpperCase();
+            lines.push(`  • [${task.key}] ${task.title} - ${priority} priority`);
+        }
+        if (briefing.available_tasks.length > 5) {
+            lines.push(`  ... and ${briefing.available_tasks.length - 5} more`);
+        }
+        lines.push("");
+    }
+    else {
+        lines.push("📋 No tasks currently available matching your type.");
+        lines.push("");
+    }
+    // Unfinished work (for reconnects)
+    if (briefing.unfinished_task) {
+        lines.push("⚠️ UNFINISHED WORK:");
+        const task = briefing.unfinished_task;
+        const keyPart = task.key ? `[${task.key}] ` : "";
+        lines.push(`  • Previous task: ${keyPart}${task.title} (${task.last_status})`);
+        if (briefing.active_blockers > 0) {
+            lines.push(`  • Active blockers: ${briefing.active_blockers}`);
+        }
+        lines.push("");
+    }
+    // Pending messages
+    if (briefing.pending_messages_count > 0) {
+        lines.push(`📬 You have ${briefing.pending_messages_count} unread message(s).`);
+        lines.push("");
+    }
+    // Action guidance
+    lines.push("👉 ACTION REQUIRED:");
+    if (briefing.unfinished_task) {
+        lines.push("   • Resume previous task, OR");
+    }
+    if (briefing.available_tasks.length > 0) {
+        lines.push("   • Call `claim_ticket_task` to claim a task, OR");
+    }
+    lines.push("   • Call `agent_start_work` with a task_id to start work");
+    return lines.join("\n");
+}
+/**
+ * Execute the OnConnect hook.
+ * Returns a briefing message to append to the registration response.
+ */
+export function executeOnConnect(agentId, agentName, agentType, briefing, isReconnect) {
+    // Initialize session state
+    sessionState.getSession(agentId);
+    // Format the briefing
+    const message = formatBriefing(agentName, agentType, briefing, isReconnect);
+    return {
+        blocked: false,
+        append_to_response: message,
+    };
+}
+/**
+ * Build briefing data from API responses.
+ */
+export function buildBriefing(availableTasks, pendingMessagesCount, unfinishedTask, activeBlockers) {
+    return {
+        available_tasks: availableTasks,
+        pending_messages_count: pendingMessagesCount,
+        unfinished_task: unfinishedTask,
+        active_blockers: activeBlockers || 0,
+    };
+}
+//# sourceMappingURL=onConnect.js.map

package/dist/hooks/onConnect.js.map

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

package/dist/hooks/onDisconnect.d.ts

@@ -0,0 +1,40 @@
+/**
+ * OnDisconnect Hook
+ * Triggered on agent_disconnect or connection lost.
+ * Handles session cleanup, summary generation, and sync.
+ */
+import { SessionSummary, SessionState } from "./types.js";
+/**
+ * Generate a session summary from the session state.
+ */
+export declare function generateSessionSummary(agentId: string): SessionSummary | null;
+/**
+ * Format the session summary for Slack notification.
+ */
+export declare function formatSlackSummary(summary: SessionSummary): string;
+/**
+ * Execute the OnDisconnect hook.
+ * Non-blocking - handles cleanup and returns summary.
+ */
+export declare function executeOnDisconnect(agentId: string): {
+    summary: SessionSummary | null;
+    slackMessage: string | null;
+};
+/**
+ * Check if the session has incomplete work.
+ */
+export declare function hasIncompleteWork(agentId: string): boolean;
+/**
+ * Get the current task ID if there's incomplete work.
+ */
+export declare function getIncompleteTaskId(agentId: string): string | null;
+/**
+ * Build partial completion data for incomplete tasks.
+ */
+export declare function buildPartialCompletion(agentId: string): {
+    task_id: string;
+    summary: string;
+    outcome: "partial";
+    context_counts: SessionState["context_counts"];
+} | null;
+//# sourceMappingURL=onDisconnect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onDisconnect.d.ts","sourceRoot":"","sources":["../../src/hooks/onDisconnect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAc,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGtE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAmC7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAkBlE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IACpD,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAcA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,CAAC;IACnB,cAAc,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAAC;CAChD,GAAG,IAAI,CAkBP"}

package/dist/hooks/onDisconnect.js

@@ -0,0 +1,106 @@
+/**
+ * OnDisconnect Hook
+ * Triggered on agent_disconnect or connection lost.
+ * Handles session cleanup, summary generation, and sync.
+ */
+import * as sessionState from "./sessionState.js";
+/**
+ * Generate a session summary from the session state.
+ */
+export function generateSessionSummary(agentId) {
+    const session = sessionState.getSession(agentId);
+    if (!session) {
+        return null;
+    }
+    const now = new Date();
+    const durationMs = now.getTime() - session.connected_at.getTime();
+    const durationMinutes = Math.floor(durationMs / (60 * 1000));
+    const summary = {
+        agent_id: session.agent_id,
+        started_at: session.connected_at,
+        ended_at: now,
+        duration_minutes: durationMinutes,
+        tasks_worked: session.task_id ? [session.task_id] : [],
+        context_summary: {
+            decisions: session.context_counts.decisions,
+            notes: session.context_counts.notes,
+            blockers_resolved: 0, // Would need to track separately
+            insights: session.context_counts.insights,
+        },
+    };
+    // Check for incomplete task
+    if (session.task_id) {
+        summary.incomplete_task = {
+            task_id: session.task_id,
+            last_status: "partial",
+            auto_summary: `Session ended while working on task. Duration: ${durationMinutes} minutes. Context saved: ${session.context_counts.decisions} decisions, ${session.context_counts.notes} notes.`,
+        };
+    }
+    return summary;
+}
+/**
+ * Format the session summary for Slack notification.
+ */
+export function formatSlackSummary(summary) {
+    const lines = [];
+    lines.push(`🔌 Agent disconnected: ${summary.agent_id}`);
+    lines.push(`⏱️ Session duration: ${summary.duration_minutes} minutes`);
+    const ctx = summary.context_summary;
+    if (ctx.decisions > 0 || ctx.notes > 0 || ctx.insights > 0) {
+        lines.push(`📝 Context: ${ctx.decisions} decisions, ${ctx.notes} notes, ${ctx.insights} insights`);
+    }
+    if (summary.incomplete_task) {
+        lines.push(`⚠️ Incomplete task: ${summary.incomplete_task.task_id}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Execute the OnDisconnect hook.
+ * Non-blocking - handles cleanup and returns summary.
+ */
+export function executeOnDisconnect(agentId) {
+    // Generate summary before clearing session
+    const summary = generateSessionSummary(agentId);
+    // Clear the session
+    sessionState.clearSession(agentId);
+    // Format Slack message if we have a summary
+    const slackMessage = summary ? formatSlackSummary(summary) : null;
+    return {
+        summary,
+        slackMessage,
+    };
+}
+/**
+ * Check if the session has incomplete work.
+ */
+export function hasIncompleteWork(agentId) {
+    const session = sessionState.getSession(agentId);
+    return session?.task_id !== null;
+}
+/**
+ * Get the current task ID if there's incomplete work.
+ */
+export function getIncompleteTaskId(agentId) {
+    const session = sessionState.getSession(agentId);
+    return session?.task_id || null;
+}
+/**
+ * Build partial completion data for incomplete tasks.
+ */
+export function buildPartialCompletion(agentId) {
+    const session = sessionState.getSession(agentId);
+    if (!session?.task_id) {
+        return null;
+    }
+    const durationMs = session.task_started_at
+        ? new Date().getTime() - session.task_started_at.getTime()
+        : 0;
+    const durationMinutes = Math.floor(durationMs / (60 * 1000));
+    return {
+        task_id: session.task_id,
+        summary: `Session ended while working on task. Duration: ${durationMinutes} minutes.`,
+        outcome: "partial",
+        context_counts: session.context_counts,
+    };
+}
+//# sourceMappingURL=onDisconnect.js.map

package/dist/hooks/onDisconnect.js.map

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

package/dist/hooks/onTaskComplete.d.ts

@@ -0,0 +1,21 @@
+/**
+ * OnTaskComplete Hook
+ * Triggered on agent_complete_task.
+ * Enforces context requirements before allowing task completion.
+ */
+import { HookResult, TaskCompleteValidation } from "./types.js";
+/**
+ * Execute the OnTaskComplete hook.
+ * Validates that context has been saved and summary is adequate.
+ */
+export declare function executeOnTaskComplete(agentId: string, validation: TaskCompleteValidation): HookResult;
+/**
+ * Check if task completion should be allowed (for soft mode).
+ * Returns true even without context if enforcement is disabled.
+ */
+export declare function shouldAllowCompletion(agentId: string): boolean;
+/**
+ * Get a summary of context saved during the task.
+ */
+export declare function getTaskContextSummary(agentId: string): string;
+//# sourceMappingURL=onTaskComplete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onTaskComplete.d.ts","sourceRoot":"","sources":["../../src/hooks/onTaskComplete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAgB,MAAM,YAAY,CAAC;AAoD9E;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,sBAAsB,GACjC,UAAU,CAiCZ;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAU9D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAc7D"}

package/dist/hooks/onTaskComplete.js

@@ -0,0 +1,112 @@
+/**
+ * OnTaskComplete Hook
+ * Triggered on agent_complete_task.
+ * Enforces context requirements before allowing task completion.
+ */
+import * as sessionState from "./sessionState.js";
+/**
+ * Format the block message when context is missing.
+ */
+function formatBlockMessage(counts) {
+    const lines = [];
+    lines.push("🚫 CANNOT COMPLETE TASK - MISSING CONTEXT");
+    lines.push("");
+    lines.push("You haven't recorded any decisions or notes.");
+    lines.push("Before completing, you MUST document:");
+    lines.push("");
+    lines.push("REQUIRED (at least one):");
+    const decisionStatus = counts.decisions > 0 ? "✅" : "❌";
+    const noteStatus = counts.notes > 0 ? "✅" : "❌";
+    lines.push(`  ${decisionStatus} Decisions: ${counts.decisions}  → save_decision(description, reasoning)`);
+    lines.push(`  ${noteStatus} Notes: ${counts.notes}      → save_note(content)`);
+    lines.push("");
+    lines.push("OPTIONAL:");
+    lines.push(`  • Blockers: ${counts.blockers}   → save_blocker(description)`);
+    lines.push(`  • Insights: ${counts.insights}   → save_codebase_insight(area, insight)`);
+    lines.push("");
+    lines.push("📝 After saving context, call agent_complete_task again.");
+    return lines.join("\n");
+}
+/**
+ * Validate that the summary meets minimum requirements.
+ */
+function validateSummary(summary, minLength) {
+    if (!summary || summary.trim().length === 0) {
+        return {
+            valid: false,
+            message: "Summary cannot be empty. Describe what was accomplished.",
+        };
+    }
+    if (summary.trim().length < minLength) {
+        return {
+            valid: false,
+            message: `Summary is too short (${summary.trim().length} chars). Minimum: ${minLength} chars.`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Execute the OnTaskComplete hook.
+ * Validates that context has been saved and summary is adequate.
+ */
+export function executeOnTaskComplete(agentId, validation) {
+    const config = sessionState.getConfig();
+    // Get context counts from session
+    const sessionCounts = sessionState.getContextCounts(agentId);
+    // Validate summary
+    const summaryValidation = validateSummary(validation.summary, config.min_summary_length);
+    if (!summaryValidation.valid) {
+        return {
+            blocked: true,
+            message: `🚫 INVALID SUMMARY\n\n${summaryValidation.message}`,
+        };
+    }
+    // Check if context has been saved
+    if (!sessionState.hasContextSaved(agentId)) {
+        return {
+            blocked: true,
+            message: formatBlockMessage(sessionCounts),
+        };
+    }
+    // Validation passed - record completion
+    sessionState.completeTask(agentId);
+    // Return success with context summary
+    const contextNote = `✅ Task completed with ${sessionCounts.decisions} decision(s), ${sessionCounts.notes} note(s), ${sessionCounts.blockers} blocker(s), ${sessionCounts.insights} insight(s).`;
+    return {
+        blocked: false,
+        append_to_response: contextNote,
+    };
+}
+/**
+ * Check if task completion should be allowed (for soft mode).
+ * Returns true even without context if enforcement is disabled.
+ */
+export function shouldAllowCompletion(agentId) {
+    const config = sessionState.getConfig();
+    // If strict mode is off, always allow
+    if (!config.enabled) {
+        return true;
+    }
+    // Check if context has been saved
+    return sessionState.hasContextSaved(agentId);
+}
+/**
+ * Get a summary of context saved during the task.
+ */
+export function getTaskContextSummary(agentId) {
+    const counts = sessionState.getContextCounts(agentId);
+    const parts = [];
+    if (counts.decisions > 0)
+        parts.push(`${counts.decisions} decision(s)`);
+    if (counts.notes > 0)
+        parts.push(`${counts.notes} note(s)`);
+    if (counts.blockers > 0)
+        parts.push(`${counts.blockers} blocker(s)`);
+    if (counts.insights > 0)
+        parts.push(`${counts.insights} insight(s)`);
+    if (parts.length === 0) {
+        return "No context saved during this task.";
+    }
+    return `Context saved: ${parts.join(", ")}.`;
+}
+//# sourceMappingURL=onTaskComplete.js.map

package/dist/hooks/onTaskComplete.js.map

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