gencode-ai 0.4.0 → 0.5.0

package/dist/ext/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ext/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE7H,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpE,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/ext/hooks/matcher.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Hook Matcher - Pattern matching for filtering hooks by tool name
+ *
+ * Supports:
+ * - Wildcard matching (empty string, "*")
+ * - Exact string matching
+ * - Regex patterns (e.g., "Edit|Write")
+ */
+/**
+ * Check if a matcher pattern matches a tool name
+ *
+ * Pattern types:
+ * - undefined, "", "*": Match all tools
+ * - "ToolName": Exact match
+ * - "Tool1|Tool2": Regex alternation (or any valid regex)
+ *
+ * @param pattern - Matcher pattern (can be undefined, string, or regex)
+ * @param toolName - Tool name to match against (can be undefined)
+ * @returns true if pattern matches, false otherwise
+ */
+export declare function matchesTool(pattern: string | undefined, toolName: string | undefined): boolean;
+/**
+ * Validate if a matcher pattern is a valid regex
+ *
+ * @param pattern - Pattern to validate
+ * @returns true if valid regex, false otherwise
+ */
+export declare function isValidRegex(pattern: string): boolean;
+/**
+ * Test if a pattern will match a specific tool name
+ * Useful for configuration validation and testing
+ *
+ * @param pattern - Matcher pattern
+ * @param toolName - Tool name to test
+ * @returns true if pattern would match this tool
+ */
+export declare function testMatch(pattern: string | undefined, toolName: string): boolean;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/ext/hooks/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../../src/ext/hooks/matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAmB9F;AAMD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOrD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhF"}

package/dist/ext/hooks/matcher.js

@@ -0,0 +1,72 @@
+/**
+ * Hook Matcher - Pattern matching for filtering hooks by tool name
+ *
+ * Supports:
+ * - Wildcard matching (empty string, "*")
+ * - Exact string matching
+ * - Regex patterns (e.g., "Edit|Write")
+ */
+// =============================================================================
+// Matcher Functions
+// =============================================================================
+/**
+ * Check if a matcher pattern matches a tool name
+ *
+ * Pattern types:
+ * - undefined, "", "*": Match all tools
+ * - "ToolName": Exact match
+ * - "Tool1|Tool2": Regex alternation (or any valid regex)
+ *
+ * @param pattern - Matcher pattern (can be undefined, string, or regex)
+ * @param toolName - Tool name to match against (can be undefined)
+ * @returns true if pattern matches, false otherwise
+ */
+export function matchesTool(pattern, toolName) {
+    // Wildcard patterns - match everything (including events without toolName like SessionStart)
+    if (!pattern || pattern === '' || pattern === '*') {
+        return true;
+    }
+    // No tool name to match against - can only match wildcard (already handled above)
+    if (!toolName) {
+        return false;
+    }
+    // Try regex matching first
+    try {
+        const regex = new RegExp(pattern);
+        return regex.test(toolName);
+    }
+    catch {
+        // If regex fails, fall back to exact string match
+        return pattern === toolName;
+    }
+}
+// =============================================================================
+// Matcher Validation
+// =============================================================================
+/**
+ * Validate if a matcher pattern is a valid regex
+ *
+ * @param pattern - Pattern to validate
+ * @returns true if valid regex, false otherwise
+ */
+export function isValidRegex(pattern) {
+    try {
+        new RegExp(pattern);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Test if a pattern will match a specific tool name
+ * Useful for configuration validation and testing
+ *
+ * @param pattern - Matcher pattern
+ * @param toolName - Tool name to test
+ * @returns true if pattern would match this tool
+ */
+export function testMatch(pattern, toolName) {
+    return matchesTool(pattern, toolName);
+}
+//# sourceMappingURL=matcher.js.map

package/dist/ext/hooks/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../../../src/ext/hooks/matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B,EAAE,QAA4B;IACnF,6FAA6F;IAC7F,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kFAAkF;IAClF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;QAClD,OAAO,OAAO,KAAK,QAAQ,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,OAA2B,EAAE,QAAgB;IACrE,OAAO,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,152 @@
+/**
+ * Hooks System Type Definitions
+ *
+ * Event-driven hooks system for executing shell commands or scripts
+ * in response to specific events (tool execution, prompts, sessions).
+ *
+ * Based on Claude Code's hooks architecture.
+ */
+import type { ToolResult } from '../../core/tools/types.js';
+/**
+ * Hook events that can trigger hook execution
+ *
+ * Tool Events:
+ * - PreToolUse: Before tool execution
+ * - PostToolUse: After successful tool execution
+ * - PostToolUseFailure: After failed tool execution
+ *
+ * User Events:
+ * - UserPromptSubmit: Before processing user prompt
+ *
+ * Session Events:
+ * - SessionStart: Session begins
+ * - SessionEnd: Session ends
+ * - Stop: Main agent finishes
+ */
+export type HookEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Stop';
+/**
+ * Hook type defines the execution strategy
+ * - command: Execute shell command
+ * - prompt: Use LLM to evaluate (future)
+ */
+export type HookType = 'command' | 'prompt';
+/**
+ * Definition for a single hook
+ */
+export interface HookDefinition {
+    /** Hook execution type */
+    type: HookType;
+    /** Shell command to execute (for command type) */
+    command?: string;
+    /** LLM prompt to evaluate (for prompt type - future) */
+    prompt?: string;
+    /** Maximum execution time in milliseconds (default: 60000) */
+    timeout?: number;
+    /** Display message while hook is running */
+    statusMessage?: string;
+    /** If true, wait for hook completion before proceeding */
+    blocking?: boolean;
+}
+/**
+ * Matcher configuration for filtering hooks by tool name
+ */
+export interface HookMatcher {
+    /**
+     * Pattern to match tool names
+     * - undefined or "*" or "": Match all tools
+     * - "ToolName": Exact match
+     * - "Tool1|Tool2": Regex alternation
+     */
+    matcher?: string;
+    /** Hooks to execute when matcher succeeds */
+    hooks: HookDefinition[];
+}
+/**
+ * Complete hooks configuration (settings.json format)
+ *
+ * Example:
+ * ```json
+ * {
+ *   "PostToolUse": [
+ *     {
+ *       "matcher": "Write|Edit",
+ *       "hooks": [
+ *         {
+ *           "type": "command",
+ *           "command": "npm run lint:fix $FILE_PATH",
+ *           "timeout": 5000
+ *         }
+ *       ]
+ *     }
+ *   ]
+ * }
+ * ```
+ */
+export interface HooksConfig {
+    [event: string]: HookMatcher[];
+}
+/**
+ * Context available to hooks during execution
+ */
+export interface HookContext {
+    /** Event that triggered the hook */
+    event: HookEvent;
+    /** Current session ID (if available) */
+    sessionId?: string;
+    /** Current working directory */
+    cwd: string;
+    /** Tool name (for tool-related events) */
+    toolName?: string;
+    /** Tool input parameters (for tool-related events) */
+    toolInput?: Record<string, unknown>;
+    /** Tool result (for PostToolUse events) */
+    toolResult?: ToolResult;
+    /** Timestamp when hook was triggered */
+    timestamp: Date;
+}
+/**
+ * Result from hook execution
+ */
+export interface HookResult {
+    /** Whether hook executed successfully (exit code 0) */
+    success: boolean;
+    /** stdout from hook command */
+    output?: string;
+    /** stderr from hook command or error message */
+    error?: string;
+    /** If true, hook blocked the action (exit code 2) */
+    blocked?: boolean;
+    /** Process exit code */
+    exitCode?: number;
+    /** Execution duration in milliseconds */
+    durationMs?: number;
+}
+/**
+ * JSON payload sent to hooks via stdin
+ *
+ * Hooks receive this data on stdin and can use it to make decisions.
+ */
+export interface HookStdinPayload {
+    /** Session ID */
+    session_id: string;
+    /** Current working directory */
+    cwd: string;
+    /** Hook event name */
+    hook_event_name: string;
+    /** Tool name (for tool events) */
+    tool_name: string;
+    /** Tool input (for tool events) */
+    tool_input: Record<string, unknown>;
+}
+/**
+ * Options for triggering hooks
+ */
+export interface TriggerOptions {
+    /** If true, run hooks in parallel (default: true) */
+    parallel?: boolean;
+    /** If true, stop on first blocking hook (default: true) */
+    stopOnBlock?: boolean;
+    /** Maximum number of hooks to execute (default: unlimited) */
+    maxHooks?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ext/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAM5D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,aAAa,GACb,oBAAoB,GACpB,kBAAkB,GAClB,cAAc,GACd,YAAY,GACZ,MAAM,CAAC;AAMX;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,IAAI,EAAE,QAAQ,CAAC;IAEf,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,6CAA6C;IAC7C,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CAChC;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,KAAK,EAAE,SAAS,CAAC;IAEjB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IAEZ,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,wCAAwC;IACxC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IAEZ,sBAAsB;IACtB,eAAe,EAAE,MAAM,CAAC;IAExB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/ext/hooks/types.js

@@ -0,0 +1,10 @@
+/**
+ * Hooks System Type Definitions
+ *
+ * Event-driven hooks system for executing shell commands or scripts
+ * in response to specific events (tool execution, prompts, sessions).
+ *
+ * Based on Claude Code's hooks architecture.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ext/hooks/types.js.map

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

package/dist/ext/hooks/utils.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Hook Utilities - Helper functions for hooks system
+ *
+ * Functions:
+ * - Variable expansion in commands
+ * - Input sanitization
+ * - JSON payload formatting
+ * - Hook validation
+ */
+import type { HookDefinition, HookContext, HookStdinPayload } from './types.js';
+/**
+ * Expand variables in a command string
+ *
+ * Supported variables:
+ * - $TOOL_NAME - Name of the tool being executed
+ * - $FILE_PATH - File path from tool input (if available)
+ * - $COMMAND - Command from tool input (for Bash tool)
+ * - $SESSION_ID - Current session ID
+ * - $CWD - Current working directory
+ *
+ * Note: This is a simple string replacement. For security, we rely on
+ * bash's argument parsing when using spawn(['bash', '-c', command]).
+ *
+ * @param command - Command string with variables
+ * @param context - Hook execution context
+ * @returns Command with variables expanded
+ */
+export declare function expandVariables(command: string, context: HookContext): string;
+/**
+ * Build JSON payload for hook stdin
+ *
+ * @param context - Hook execution context
+ * @returns JSON payload object
+ */
+export declare function buildStdinPayload(context: HookContext): HookStdinPayload;
+/**
+ * Serialize payload to JSON string for stdin
+ *
+ * @param payload - Payload object
+ * @param pretty - If true, pretty-print JSON (default: true)
+ * @returns JSON string
+ */
+export declare function serializePayload(payload: HookStdinPayload, pretty?: boolean): string;
+/**
+ * Validate a hook definition
+ *
+ * @param hook - Hook definition to validate
+ * @returns Validation result
+ */
+export declare function validateHook(hook: HookDefinition): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Format hook result for display
+ *
+ * @param result - Hook result
+ * @returns Formatted string
+ */
+export declare function formatResult(result: {
+    success: boolean;
+    output?: string;
+    error?: string;
+    blocked?: boolean;
+    exitCode?: number;
+    durationMs?: number;
+}): string;
+/**
+ * Sanitize a file path to prevent path traversal
+ *
+ * @param filePath - File path to sanitize
+ * @returns Sanitized path or null if invalid
+ */
+export declare function sanitizePath(filePath: string): string | null;
+//# sourceMappingURL=utils.d.ts.map

package/dist/ext/hooks/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/ext/hooks/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAOhF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CA2B7E;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,gBAAgB,CAQxE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAO,GAAG,MAAM,CAEjF;AAMD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CA6CA;AAMD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CA+BT;AAMD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe5D"}

package/dist/ext/hooks/utils.js

@@ -0,0 +1,198 @@
+/**
+ * Hook Utilities - Helper functions for hooks system
+ *
+ * Functions:
+ * - Variable expansion in commands
+ * - Input sanitization
+ * - JSON payload formatting
+ * - Hook validation
+ */
+import { STATUS_SYMBOLS } from '../../base/utils/format-utils.js';
+// =============================================================================
+// Variable Expansion
+// =============================================================================
+/**
+ * Expand variables in a command string
+ *
+ * Supported variables:
+ * - $TOOL_NAME - Name of the tool being executed
+ * - $FILE_PATH - File path from tool input (if available)
+ * - $COMMAND - Command from tool input (for Bash tool)
+ * - $SESSION_ID - Current session ID
+ * - $CWD - Current working directory
+ *
+ * Note: This is a simple string replacement. For security, we rely on
+ * bash's argument parsing when using spawn(['bash', '-c', command]).
+ *
+ * @param command - Command string with variables
+ * @param context - Hook execution context
+ * @returns Command with variables expanded
+ */
+export function expandVariables(command, context) {
+    let expanded = command;
+    // Replace tool name
+    if (context.toolName) {
+        expanded = expanded.replace(/\$TOOL_NAME/g, context.toolName);
+    }
+    // Replace file path if available
+    if (context.toolInput?.file_path && typeof context.toolInput.file_path === 'string') {
+        expanded = expanded.replace(/\$FILE_PATH/g, context.toolInput.file_path);
+    }
+    // Replace command if available (for Bash tool hooks)
+    if (context.toolInput?.command && typeof context.toolInput.command === 'string') {
+        expanded = expanded.replace(/\$COMMAND/g, context.toolInput.command);
+    }
+    // Replace session ID
+    if (context.sessionId) {
+        expanded = expanded.replace(/\$SESSION_ID/g, context.sessionId);
+    }
+    // Replace working directory
+    expanded = expanded.replace(/\$CWD/g, context.cwd);
+    return expanded;
+}
+// =============================================================================
+// JSON Payload
+// =============================================================================
+/**
+ * Build JSON payload for hook stdin
+ *
+ * @param context - Hook execution context
+ * @returns JSON payload object
+ */
+export function buildStdinPayload(context) {
+    return {
+        session_id: context.sessionId || '',
+        cwd: context.cwd,
+        hook_event_name: context.event,
+        tool_name: context.toolName || '',
+        tool_input: context.toolInput || {},
+    };
+}
+/**
+ * Serialize payload to JSON string for stdin
+ *
+ * @param payload - Payload object
+ * @param pretty - If true, pretty-print JSON (default: true)
+ * @returns JSON string
+ */
+export function serializePayload(payload, pretty = true) {
+    return JSON.stringify(payload, null, pretty ? 2 : undefined);
+}
+// =============================================================================
+// Hook Validation
+// =============================================================================
+/**
+ * Validate a hook definition
+ *
+ * @param hook - Hook definition to validate
+ * @returns Validation result
+ */
+export function validateHook(hook) {
+    const errors = [];
+    // Check type
+    if (!hook.type) {
+        errors.push('Hook must have a type');
+    }
+    else if (hook.type !== 'command' && hook.type !== 'prompt') {
+        errors.push(`Invalid hook type: ${hook.type}`);
+    }
+    // Validate command hooks
+    if (hook.type === 'command') {
+        if (!hook.command) {
+            errors.push('Command hook must have a command field');
+        }
+        else if (typeof hook.command !== 'string') {
+            errors.push('Command must be a string');
+        }
+        else if (hook.command.trim() === '') {
+            errors.push('Command cannot be empty');
+        }
+    }
+    // Validate prompt hooks
+    if (hook.type === 'prompt') {
+        if (!hook.prompt) {
+            errors.push('Prompt hook must have a prompt field');
+        }
+        else if (typeof hook.prompt !== 'string') {
+            errors.push('Prompt must be a string');
+        }
+    }
+    // Validate timeout
+    if (hook.timeout !== undefined) {
+        if (typeof hook.timeout !== 'number') {
+            errors.push('Timeout must be a number');
+        }
+        else if (hook.timeout <= 0) {
+            errors.push('Timeout must be positive');
+        }
+        else if (hook.timeout > 600000) {
+            errors.push('Timeout cannot exceed 10 minutes (600000ms)');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+// =============================================================================
+// Result Formatting
+// =============================================================================
+/**
+ * Format hook result for display
+ *
+ * @param result - Hook result
+ * @returns Formatted string
+ */
+export function formatResult(result) {
+    const parts = [];
+    // Status
+    if (result.blocked) {
+        parts.push(STATUS_SYMBOLS.BLOCKED);
+    }
+    else if (result.success) {
+        parts.push(STATUS_SYMBOLS.SUCCESS);
+    }
+    else {
+        parts.push(STATUS_SYMBOLS.FAILED);
+    }
+    // Exit code
+    if (result.exitCode !== undefined) {
+        parts.push(`(exit ${result.exitCode})`);
+    }
+    // Duration
+    if (result.durationMs !== undefined) {
+        parts.push(`${result.durationMs}ms`);
+    }
+    // Output or error
+    if (result.output && result.output.trim()) {
+        parts.push(`\nOutput: ${result.output.trim()}`);
+    }
+    if (result.error && result.error.trim()) {
+        parts.push(`\nError: ${result.error.trim()}`);
+    }
+    return parts.join(' ');
+}
+// =============================================================================
+// Path Sanitization
+// =============================================================================
+/**
+ * Sanitize a file path to prevent path traversal
+ *
+ * @param filePath - File path to sanitize
+ * @returns Sanitized path or null if invalid
+ */
+export function sanitizePath(filePath) {
+    // Reject paths with ..
+    if (filePath.includes('..')) {
+        return null;
+    }
+    // Reject absolute paths to sensitive directories
+    const sensitive = ['/etc/', '/var/', '/sys/', '/proc/', '/dev/'];
+    for (const dir of sensitive) {
+        if (filePath.startsWith(dir)) {
+            return null;
+        }
+    }
+    return filePath;
+}
+//# sourceMappingURL=utils.js.map

package/dist/ext/hooks/utils.js.map

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

package/dist/ext/mcp/auth.d.ts

@@ -0,0 +1,34 @@
+/**
+ * MCP OAuth Authentication Storage
+ * Manages OAuth tokens and client configuration
+ */
+import type { OAuthTokens, OAuthClientConfig } from './types.js';
+/**
+ * Get OAuth tokens for a server
+ */
+export declare function getOAuthTokens(serverName: string): Promise<OAuthTokens | null>;
+/**
+ * Save OAuth tokens for a server
+ */
+export declare function saveOAuthTokens(serverName: string, tokens: OAuthTokens): Promise<void>;
+/**
+ * Get OAuth client config for a server
+ */
+export declare function getOAuthClientConfig(serverName: string): Promise<OAuthClientConfig | null>;
+/**
+ * Save OAuth client config for a server
+ */
+export declare function saveOAuthClientConfig(serverName: string, clientConfig: OAuthClientConfig): Promise<void>;
+/**
+ * Remove OAuth data for a server (logout)
+ */
+export declare function removeOAuthData(serverName: string): Promise<void>;
+/**
+ * Check if tokens are expired
+ */
+export declare function areTokensExpired(tokens: OAuthTokens): boolean;
+/**
+ * Check if tokens are valid (exist and not expired)
+ */
+export declare function hasValidTokens(serverName: string): Promise<boolean>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/ext/mcp/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/ext/mcp/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAgB,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA8B/E;;GAEG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAGpF;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAGnC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,iBAAiB,GAC9B,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAQ7D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOzE"}