thatgfsj-code 0.3.0 → 0.3.1

package/dist/core/config.js

@@ -0,0 +1,162 @@
+/**
+ * Config Manager - Handles configuration loading and saving
+ * Supports multiple AI providers: MiniMax, SiliconFlow, OpenAI, Anthropic
+ *
+ * 0.2.3: Tolerates unknown / legacy provider names (e.g. `custom_openai`
+ * from 1.0.4-era configs) — keeps the user's provider and falls back to
+ * deriving a sensible baseUrl from `CUSTOM_BASE_URL` / `BASE_URL` env vars
+ * or from the provider id itself, instead of silently overwriting the
+ * provider field. Also refreshes default model to current SiliconFlow
+ * recommendation (Qwen2.5-72B-Instruct instead of 7B).
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { PROVIDERS } from './types.js';
+const DEFAULT_CONFIG = {
+    model: 'Qwen/Qwen2.5-72B-Instruct',
+    apiKey: '',
+    temperature: 0.7,
+    maxTokens: 4096,
+    provider: 'siliconflow',
+    baseUrl: 'https://api.siliconflow.cn/v1'
+};
+export class ConfigManager {
+    configPath;
+    constructor() {
+        const homeDir = homedir();
+        const configDir = join(homeDir, '.thatgfsj');
+        this.configPath = join(configDir, 'config.json');
+    }
+    /**
+     * Load configuration with environment variable support
+     */
+    static async load() {
+        const manager = new ConfigManager();
+        return manager.loadConfig();
+    }
+    /**
+     * Load config from file and merge with environment variables
+     */
+    loadConfig() {
+        let config = { ...DEFAULT_CONFIG };
+        try {
+            if (existsSync(this.configPath)) {
+                const data = readFileSync(this.configPath, 'utf-8');
+                const loaded = JSON.parse(data);
+                config = { ...config, ...loaded };
+            }
+        }
+        catch (error) {
+            console.warn('Failed to load config, using defaults:', error);
+        }
+        // Resolve provider and get API key from environment
+        config = this.resolveProvider(config);
+        return config;
+    }
+    /**
+     * Resolve provider and API key from config or environment
+     *
+     * 0.2.3: tolerate unknown / legacy provider names (e.g. `custom_openai`).
+     *   - If the provider is in `PROVIDERS`, use its baseUrl + envKeys.
+     *   - Otherwise keep the user-specified provider id exactly and try to
+     *     derive a baseUrl from `CUSTOM_BASE_URL` / `BASE_URL` env vars; if
+     *     neither is set, fall back to the OpenAI-compatible default
+     *     (https://api.openai.com/v1) so the request still goes through.
+     *     No silent overwrite of `provider`.
+     *   - When API key is missing for an unknown provider, we still keep the
+     *     provider and surface a non-fatal warning.
+     */
+    resolveProvider(config) {
+        const provider = config.provider || 'siliconflow';
+        const providerConfig = PROVIDERS[provider];
+        if (!providerConfig) {
+            // Unknown / legacy / custom provider — keep what the user wrote, but
+            // resolve a reasonable baseUrl.
+            const envBase = process.env.CUSTOM_BASE_URL || process.env.BASE_URL;
+            const baseUrl = config.baseUrl ||
+                envBase ||
+                // Last-resort: OpenAI-compatible default. The user can override via
+                // `gfcode init` or by editing ~/.thatgfsj/config.json.
+                'https://api.openai.com/v1';
+            const apiKey = config.apiKey ||
+                process.env.OPENAI_API_KEY ||
+                process.env.CUSTOM_API_KEY ||
+                '';
+            // Model: keep user choice, otherwise fall back to env MODEL, otherwise
+            // a benign default. No warning spam — this is an expected path.
+            const model = config.model || process.env.MODEL || 'gpt-4o-mini';
+            return {
+                ...config,
+                provider: provider,
+                baseUrl,
+                model,
+                apiKey,
+            };
+        }
+        // Known provider
+        let model = process.env.MODEL || config.model || providerConfig.defaultModel;
+        let apiKey = config.apiKey;
+        let baseUrl = config.baseUrl || providerConfig.baseUrl;
+        if (provider === 'ollama') {
+            apiKey = '';
+            baseUrl = process.env.OLLAMA_BASE_URL || baseUrl;
+        }
+        else {
+            for (const envKey of providerConfig.envKeys) {
+                if (process.env[envKey]) {
+                    apiKey = process.env[envKey];
+                    break;
+                }
+            }
+        }
+        return {
+            ...config,
+            provider,
+            baseUrl,
+            model,
+            apiKey: apiKey || ''
+        };
+    }
+    /**
+     * Get AIConfig for AIEngine
+     */
+    static async getAIConfig() {
+        const config = await ConfigManager.load();
+        return {
+            model: config.model,
+            apiKey: config.apiKey,
+            temperature: config.temperature,
+            maxTokens: config.maxTokens,
+            baseUrl: config.baseUrl,
+            provider: config.provider
+        };
+    }
+    /**
+     * Save configuration
+     */
+    async save(config) {
+        const current = this.loadConfig();
+        const merged = { ...current, ...config };
+        const dir = dirname(this.configPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(this.configPath, JSON.stringify(merged, null, 2));
+    }
+    /**
+     * Get config path
+     */
+    getPath() {
+        return this.configPath;
+    }
+    /**
+     * List available providers
+     */
+    static listProviders() {
+        return Object.entries(PROVIDERS)
+            .map(([key, val]) => `  ${key}: ${val.name}`)
+            .join('\n');
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/context-compactor.d.ts

@@ -0,0 +1,54 @@
+/**
+ * S05: Context Compactor - 3-tier progressive compression strategy
+ *
+ * Tier 1: Truncation   - Remove oldest messages beyond hard limit
+ * Tier 2: Summarize    - Replace old message ranges with summary
+ * Tier 3: Selective    - Keep only recent N turns around tool executions
+ *
+ * Core insight: Context window is finite. Three-tier strategy enables "infinite" work.
+ */
+import { ChatMessage } from './types.js';
+export interface CompactorConfig {
+    /** Hard limit: messages beyond this get removed first */
+    hardLimit?: number;
+    /** Soft limit: messages beyond this get summarized */
+    softLimit?: number;
+    /** How many recent turns to always preserve */
+    preserveRecent?: number;
+    /** Enable summarization (requires AI API) */
+    enableSummarize?: boolean;
+}
+export interface CompressionResult {
+    originalCount: number;
+    compactedCount: number;
+    removedCount: number;
+    method: 'none' | 'truncation' | 'summarize' | 'selective';
+}
+/**
+ * S05: Context Compactor
+ */
+export declare class ContextCompactor {
+    private config;
+    private totalTokensUsed;
+    constructor(config?: CompactorConfig);
+    /**
+     * S05: Compact messages using 3-tier strategy
+     * Called at the end of each agent turn
+     */
+    compact(messages: ChatMessage[]): {
+        compacted: ChatMessage[];
+        result: CompressionResult;
+    };
+    private truncate;
+    private summarizeStrategy;
+    private summarizeTopic;
+    private selectiveStrategy;
+    isNearLimit(messages: ChatMessage[], limit?: number): boolean;
+    estimateTokens(messages: ChatMessage[]): number;
+    autoCompact(messages: ChatMessage[]): {
+        compacted: ChatMessage[];
+        result: CompressionResult;
+    };
+}
+export declare function integrateWithSessionManager(SessionManagerClass: any): void;
+//# sourceMappingURL=context-compactor.d.ts.map

package/dist/core/context-compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compactor.d.ts","sourceRoot":"","sources":["../../src/core/context-compactor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;CAC3D;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,eAAe,CAAK;gBAEhB,MAAM,GAAE,eAAoB;IAUxC;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG;QAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QAAC,MAAM,EAAE,iBAAiB,CAAA;KAAE;IAqBzF,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,iBAAiB;IAiEzB,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,KAAK,GAAE,MAAe,GAAG,OAAO;IAOrE,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM;IAQ/C,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG;QAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QAAC,MAAM,EAAE,iBAAiB,CAAA;KAAE;CAS9F;AAID,wBAAgB,2BAA2B,CAAC,mBAAmB,EAAE,GAAG,QAcnE"}

package/dist/core/context-compactor.js

@@ -0,0 +1,197 @@
+/**
+ * S05: Context Compactor - 3-tier progressive compression strategy
+ *
+ * Tier 1: Truncation   - Remove oldest messages beyond hard limit
+ * Tier 2: Summarize    - Replace old message ranges with summary
+ * Tier 3: Selective    - Keep only recent N turns around tool executions
+ *
+ * Core insight: Context window is finite. Three-tier strategy enables "infinite" work.
+ */
+/**
+ * S05: Context Compactor
+ */
+export class ContextCompactor {
+    config;
+    totalTokensUsed = 0;
+    constructor(config = {}) {
+        this.config = {
+            hardLimit: 50,
+            softLimit: 30,
+            preserveRecent: 10,
+            enableSummarize: false,
+            ...config
+        };
+    }
+    /**
+     * S05: Compact messages using 3-tier strategy
+     * Called at the end of each agent turn
+     */
+    compact(messages) {
+        const count = messages.length;
+        // Tier 1: Within hard limit — no compression
+        if (count <= (this.config.hardLimit || 50)) {
+            return {
+                compacted: messages,
+                result: { originalCount: count, compactedCount: count, removedCount: 0, method: 'none' }
+            };
+        }
+        // Tier 2: Beyond soft limit — summarize middle messages
+        if (count > (this.config.softLimit || 30)) {
+            return this.summarizeStrategy(messages);
+        }
+        // Tier 3: Between soft and hard — selective preservation
+        return this.selectiveStrategy(messages);
+    }
+    // Tier 1: Simple truncation
+    truncate(messages, maxMessages) {
+        const systemMsg = messages.find(m => m.role === 'system');
+        const others = messages.filter(m => m.role !== 'system');
+        const toRemove = others.length - maxMessages;
+        if (toRemove <= 0 || others.length === 0) {
+            return messages;
+        }
+        // Remove oldest non-system messages
+        const keptOthers = others.slice(toRemove);
+        return systemMsg ? [systemMsg, ...keptOthers] : keptOthers;
+    }
+    // Tier 2: Summarize middle messages (stub — needs AI for real summarization)
+    summarizeStrategy(messages) {
+        const preserved = this.config.preserveRecent || 10;
+        const systemMsg = messages.find(m => m.role === 'system');
+        const others = messages.filter(m => m.role !== 'system');
+        if (others.length <= preserved) {
+            return {
+                compacted: messages,
+                result: { originalCount: messages.length, compactedCount: messages.length, removedCount: 0, method: 'none' }
+            };
+        }
+        // Keep recent N turns
+        const recent = others.slice(-preserved);
+        // Summarize the middle (this is a placeholder — real impl would call AI)
+        const summaryMsg = {
+            role: 'system',
+            content: '[S05: ' + (others.length - preserved) + ' earlier messages summarized — ' +
+                'conversation had ' + (others.length - preserved) + ' exchanges covering ' +
+                this.summarizeTopic(others.slice(0, -preserved)) + ']'
+        };
+        const compacted = systemMsg
+            ? [systemMsg, summaryMsg, ...recent]
+            : [summaryMsg, ...recent];
+        return {
+            compacted,
+            result: {
+                originalCount: messages.length,
+                compactedCount: compacted.length,
+                removedCount: messages.length - compacted.length,
+                method: 'summarize'
+            }
+        };
+    }
+    // Extract simple topic from message content
+    summarizeTopic(msgs) {
+        const texts = msgs
+            .filter(m => m.role === 'user')
+            .map(m => m.content)
+            .slice(0, 3)
+            .join(' ')
+            .substring(0, 50);
+        return texts || 'various topics';
+    }
+    // Tier 3: Selective — keep turns around tool executions
+    selectiveStrategy(messages) {
+        const systemMsg = messages.find(m => m.role === 'system');
+        const others = messages.filter(m => m.role !== 'system');
+        const max = this.config.softLimit || 30;
+        if (others.length <= max) {
+            return {
+                compacted: messages,
+                result: { originalCount: messages.length, compactedCount: messages.length, removedCount: 0, method: 'none' }
+            };
+        }
+        // Find indices of tool-related messages
+        const toolIndices = new Set();
+        others.forEach((m, i) => {
+            if (m.tool_calls || m.role === 'tool' || m.role === 'assistant') {
+                toolIndices.add(i);
+            }
+        });
+        // Also add indices around tool messages
+        for (const idx of toolIndices) {
+            for (let offset = -2; offset <= 2; offset++) {
+                toolIndices.add(idx + offset);
+            }
+        }
+        // Keep system message + messages near tool executions + recent messages
+        const recentCount = Math.floor(max * 0.3); // 30% recent
+        const toolCount = max - recentCount;
+        const recent = others.slice(-recentCount);
+        const toolMsgs = [];
+        for (const idx of [...toolIndices].sort((a, b) => a - b)) {
+            if (toolMsgs.length >= toolCount)
+                break;
+            if (idx >= 0 && idx < others.length - recentCount) {
+                toolMsgs.push(others[idx]);
+            }
+        }
+        const compacted = systemMsg
+            ? [systemMsg, ...toolMsgs, ...recent]
+            : [...toolMsgs, ...recent];
+        // Deduplicate while preserving order
+        const seen = new Set();
+        const deduped = compacted.filter(m => {
+            const key = m.role + m.content.substring(0, 30);
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+        return {
+            compacted: deduped,
+            result: {
+                originalCount: messages.length,
+                compactedCount: deduped.length,
+                removedCount: messages.length - deduped.length,
+                method: 'selective'
+            }
+        };
+    }
+    // S05: Check if context is approaching limit
+    isNearLimit(messages, limit = 150000) {
+        // Rough estimate: 1 message ~= 200 tokens on average
+        const estimatedTokens = messages.length * 200;
+        return estimatedTokens > limit * 0.8; // 80% of limit
+    }
+    // S05: Get estimated token count
+    estimateTokens(messages) {
+        return messages.reduce((sum, m) => {
+            // Rough: content chars / 4 tokens
+            return sum + Math.ceil(m.content.length / 4) + 10; // +10 for role/overhead
+        }, 0);
+    }
+    // S05: Auto-compact if needed (called from AIEngine or SessionManager)
+    autoCompact(messages) {
+        if (this.isNearLimit(messages)) {
+            return this.compact(messages);
+        }
+        return {
+            compacted: messages,
+            result: { originalCount: messages.length, compactedCount: messages.length, removedCount: 0, method: 'none' }
+        };
+    }
+}
+// ==================== SessionManager Integration ====================
+export function integrateWithSessionManager(SessionManagerClass) {
+    const originalTruncate = SessionManagerClass.prototype.truncate;
+    SessionManagerClass.prototype.truncate = function (maxMessages, forceCompact = false) {
+        if (forceCompact) {
+            const compactor = new ContextCompactor({ hardLimit: maxMessages });
+            const { compacted, result } = compactor.autoCompact(this.messages);
+            if (result.method !== 'none') {
+                this.messages = compacted;
+                return result;
+            }
+        }
+        return originalTruncate.call(this, maxMessages);
+    };
+}
+//# sourceMappingURL=context-compactor.js.map

package/dist/core/context-compactor.js.map

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

package/dist/core/hooks.d.ts

@@ -0,0 +1,75 @@
+/**
+ * S08: Hooks System
+ * Inject custom logic at key event points without modifying agent source code
+ *
+ * Hook points: before/after tool calls, before/after agent loop, onError, etc.
+ * Users can register hooks for: audit logging, auto-formatting, security filtering, notifications
+ */
+import { ChatMessage } from './types.js';
+export type HookName = 'beforeToolCall' | 'afterToolCall' | 'beforeAgentLoop' | 'afterAgentLoop' | 'onError' | 'beforeMessage' | 'afterMessage' | 'onCompact';
+export interface HookContext {
+    toolName?: string;
+    toolParams?: Record<string, any>;
+    toolResult?: any;
+    messages?: ChatMessage[];
+    error?: Error;
+    iteration?: number;
+    [key: string]: any;
+}
+export type HookFn = (ctx: HookContext) => void | Promise<void>;
+export interface HookRegistration {
+    name: HookName;
+    fn: HookFn;
+    priority?: number;
+    once?: boolean;
+}
+export declare class HookManager {
+    private hooks;
+    constructor();
+    /**
+     * S08: Register a hook
+     * @param name Hook point name
+     * @param fn Function to run
+     * @param priority Higher priority runs first
+     * @param once If true, auto-removed after first run
+     */
+    register(name: HookName, fn: HookFn, priority?: number, once?: boolean): void;
+    /**
+     * S08: Unregister a hook by function reference
+     */
+    unregister(name: HookName, fn: HookFn): void;
+    /**
+     * S08: Clear all hooks for a given name (or all)
+     */
+    clear(name?: HookName): void;
+    /**
+     * S08: Emit a hook — call all registered functions at that point
+     * Returns after all sync hooks complete, awaits async ones
+     */
+    emit(name: HookName, ctx: HookContext): Promise<void>;
+    /**
+     * S08: Check if any hooks are registered for a given name
+     */
+    hasHooks(name: HookName): boolean;
+    /**
+     * S08: Get hook count
+     */
+    getHookCount(name?: HookName): number;
+}
+/**
+ * S08: Audit logging hook — logs all tool calls
+ */
+export declare function auditLogHook(ctx: HookContext): void;
+/**
+ * S08: Prettier auto-format hook — run prettier after file writes
+ */
+export declare function prettierFormatHook(ctx: HookContext): Promise<void>;
+/**
+ * S08: Security filter hook — block suspicious patterns
+ */
+export declare function securityFilterHook(ctx: HookContext): {
+    blocked: boolean;
+    reason: string;
+};
+export declare function getHookManager(): HookManager;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAY,MAAM,YAAY,CAAC;AAInD,MAAM,MAAM,QAAQ,GAChB,gBAAgB,GAChB,eAAe,GACf,iBAAiB,GACjB,gBAAgB,GAChB,SAAS,GACT,eAAe,GACf,cAAc,GACd,WAAW,CAAC;AAEhB,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAgD;;IAa7D;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,IAAI,UAAQ,GAAG,IAAI;IAOtE;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5C;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI;IAU5B;;;OAGG;IACG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAIjC;;OAEG;IACH,YAAY,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM;CAUtC;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAMnD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAiBzF;AAMD,wBAAgB,cAAc,IAAI,WAAW,CAK5C"}

package/dist/core/hooks.js

@@ -0,0 +1,146 @@
+/**
+ * S08: Hooks System
+ * Inject custom logic at key event points without modifying agent source code
+ *
+ * Hook points: before/after tool calls, before/after agent loop, onError, etc.
+ * Users can register hooks for: audit logging, auto-formatting, security filtering, notifications
+ */
+// ==================== Hook Manager ====================
+export class HookManager {
+    hooks = new Map();
+    constructor() {
+        // Initialize all hook types
+        const allHooks = [
+            'beforeToolCall', 'afterToolCall', 'beforeAgentLoop', 'afterAgentLoop',
+            'onError', 'beforeMessage', 'afterMessage', 'onCompact'
+        ];
+        for (const h of allHooks) {
+            this.hooks.set(h, []);
+        }
+    }
+    /**
+     * S08: Register a hook
+     * @param name Hook point name
+     * @param fn Function to run
+     * @param priority Higher priority runs first
+     * @param once If true, auto-removed after first run
+     */
+    register(name, fn, priority = 0, once = false) {
+        const regs = this.hooks.get(name) || [];
+        regs.push({ name, fn, priority, once });
+        regs.sort((a, b) => (b.priority || 0) - (a.priority || 0));
+        this.hooks.set(name, regs);
+    }
+    /**
+     * S08: Unregister a hook by function reference
+     */
+    unregister(name, fn) {
+        const regs = this.hooks.get(name) || [];
+        this.hooks.set(name, regs.filter(r => r.fn !== fn));
+    }
+    /**
+     * S08: Clear all hooks for a given name (or all)
+     */
+    clear(name) {
+        if (name) {
+            this.hooks.set(name, []);
+        }
+        else {
+            for (const [, regs] of this.hooks) {
+                regs.length = 0;
+            }
+        }
+    }
+    /**
+     * S08: Emit a hook — call all registered functions at that point
+     * Returns after all sync hooks complete, awaits async ones
+     */
+    async emit(name, ctx) {
+        const regs = this.hooks.get(name) || [];
+        for (const reg of regs) {
+            try {
+                await Promise.resolve(reg.fn(ctx));
+            }
+            catch (error) {
+                console.error(`[Hook ${name}] error:`, error.message);
+            }
+            // Remove if one-time hook
+            if (reg.once) {
+                this.unregister(name, reg.fn);
+            }
+        }
+    }
+    /**
+     * S08: Check if any hooks are registered for a given name
+     */
+    hasHooks(name) {
+        return (this.hooks.get(name)?.length || 0) > 0;
+    }
+    /**
+     * S08: Get hook count
+     */
+    getHookCount(name) {
+        if (name) {
+            return this.hooks.get(name)?.length || 0;
+        }
+        let total = 0;
+        for (const regs of this.hooks.values()) {
+            total += regs.length;
+        }
+        return total;
+    }
+}
+// ==================== Built-in Hooks ====================
+/**
+ * S08: Audit logging hook — logs all tool calls
+ */
+export function auditLogHook(ctx) {
+    if (ctx.toolName) {
+        const ts = new Date().toISOString().split('T')[1].split('.')[0];
+        const status = ctx.toolResult?.success ? 'OK' : 'FAIL';
+        console.log(`[AUDIT ${ts}] ${status} | tool=${ctx.toolName} | params=${JSON.stringify(ctx.toolParams || {})} | result=${ctx.toolResult?.success ? 'OK' : ctx.toolResult?.error}`);
+    }
+}
+/**
+ * S08: Prettier auto-format hook — run prettier after file writes
+ */
+export async function prettierFormatHook(ctx) {
+    if (ctx.toolName === 'file' && ctx.toolParams?.action === 'write') {
+        const path = ctx.toolParams.path;
+        const ext = path.split('.').pop()?.toLowerCase();
+        const formattable = ['js', 'ts', 'jsx', 'tsx', 'json', 'md', 'css', 'html'];
+        if (formattable.includes(ext || '')) {
+            console.log(`[Hook] Auto-format skipped (prettier not installed) for ${path}`);
+            // In real impl: spawn prettier on the file
+        }
+    }
+}
+/**
+ * S08: Security filter hook — block suspicious patterns
+ */
+export function securityFilterHook(ctx) {
+    if (ctx.toolName === 'shell' && ctx.toolParams?.command) {
+        const cmd = ctx.toolParams.command;
+        const suspicious = [
+            /curl\s+.*\|.*sh/i,
+            /wget\s+.*\|.*sh/i,
+            /base64\s+-d/i,
+            /\.\/[^/]+\s+&&.*rm/i
+        ];
+        for (const pattern of suspicious) {
+            if (pattern.test(cmd)) {
+                return { blocked: true, reason: `Suspicious pattern detected: ${pattern}` };
+            }
+        }
+    }
+    return { blocked: false, reason: '' };
+}
+// ==================== Singleton ====================
+let globalHookManager = null;
+export function getHookManager() {
+    if (!globalHookManager) {
+        globalHookManager = new HookManager();
+    }
+    return globalHookManager;
+}
+//# sourceMappingURL=hooks.js.map