zhitalk 0.0.0 → 0.0.2

package/dist/agent/colors.d.ts

@@ -0,0 +1,19 @@
+export declare function initColors(): Promise<void>;
+export declare const color: {
+    banner: (text: string) => string;
+    userPrefix: () => string;
+    aiPrefix: () => string;
+    goodbye: (text: string) => string;
+    cancelled: (text: string) => string;
+    error: (text: string) => string;
+    toolTag: () => string;
+    toolName: (name: string) => string;
+    toolAction: () => string;
+    toolArg: (arg: string) => string;
+    gray: (text: string) => string;
+    tokenInfo: (text: string) => string;
+    warn: (text: string) => string;
+    info: (text: string) => string;
+    good: (text: string) => string;
+};
+export declare function formatToolLog(name: string, detail?: string): string;

package/dist/agent/colors.js

@@ -0,0 +1,81 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.color = void 0;
+exports.initColors = initColors;
+exports.formatToolLog = formatToolLog;
+let _chalk = null;
+async function initColors() {
+    const mod = (await Promise.resolve().then(() => __importStar(require('chalk'))));
+    _chalk = mod.default;
+}
+function createPlainFallback() {
+    const handler = {
+        get: () => createPlainFallback(),
+        apply: (_target, _thisArg, args) => args[0] ?? '',
+    };
+    const fn = (...args) => args[0] ?? '';
+    return new Proxy(fn, handler);
+}
+function ck() {
+    if (!_chalk) {
+        return createPlainFallback();
+    }
+    return _chalk;
+}
+exports.color = {
+    banner: (text) => ck().cyanBright.bold(text),
+    userPrefix: () => ck().greenBright.bold('You: '),
+    aiPrefix: () => ck().cyanBright.bold('AI: '),
+    goodbye: (text) => ck().yellowBright(text),
+    cancelled: (text) => ck().yellowBright.bold(text),
+    error: (text) => ck().redBright.bold(text),
+    toolTag: () => ck().magentaBright('[Tool]'),
+    toolName: (name) => ck().yellowBright(name),
+    toolAction: () => ck().gray('called:'),
+    toolArg: (arg) => ck().cyan(arg),
+    gray: (text) => ck().gray(text),
+    tokenInfo: (text) => ck().gray(text),
+    warn: (text) => ck().yellow(text),
+    info: (text) => ck().blueBright(text),
+    good: (text) => ck().greenBright(text),
+};
+function formatToolLog(name, detail) {
+    const parts = [exports.color.toolTag(), exports.color.toolName(name), exports.color.toolAction()];
+    if (detail) {
+        parts.push(exports.color.toolArg(detail));
+    }
+    return '\n' + parts.join(' ');
+}

package/dist/agent/commands.d.ts

@@ -0,0 +1,7 @@
+export declare let threadId: string;
+export interface ChatCommand {
+    name: string;
+    description: string;
+    execute(args: string[]): void | Promise<void>;
+}
+export declare const commands: Map<string, ChatCommand>;

package/dist/agent/commands.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commands = exports.threadId = void 0;
+const crypto_1 = require("crypto");
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const colors_1 = require("./colors");
+const db_1 = require("./db");
+const agent_1 = require("./agent");
+exports.threadId = (0, crypto_1.randomUUID)();
+exports.commands = new Map();
+exports.commands.set('new', {
+    name: 'new',
+    description: 'Start a new chat session',
+    execute() {
+        exports.threadId = (0, crypto_1.randomUUID)();
+        console.log(colors_1.color.goodbye(`\nNew session started ${exports.threadId}.\n`));
+    },
+});
+exports.commands.set('rewind', {
+    name: 'rewind',
+    description: 'Restore a chat session by thread_id',
+    execute(args) {
+        const id = args[0];
+        if (!id) {
+            console.log(colors_1.color.error('\nError: please provide a thread_id. Usage: /rewind <thread_id>\n'));
+            return;
+        }
+        if (!(0, db_1.threadIdExists)(id)) {
+            console.log(colors_1.color.error(`\nError: thread_id "${id}" not found.\n`));
+            return;
+        }
+        exports.threadId = id;
+        console.log(colors_1.color.goodbye(`\nRestored session ${exports.threadId}.\n`));
+    },
+});
+exports.commands.set('sessions', {
+    name: 'sessions',
+    description: 'List recent chat sessions',
+    execute() {
+        const sessions = (0, db_1.listRecentSessions)();
+        if (sessions.length === 0) {
+            console.log('\n暂无聊天记录\n');
+            return;
+        }
+        const table = new cli_table3_1.default({
+            head: ['thread_id', '最后用户输入的问题', '时间'],
+        });
+        for (const s of sessions) {
+            table.push([s.thread_id, s.last_question, s.last_ts]);
+        }
+        console.log('\n' + table.toString() + '\n');
+    },
+});
+exports.commands.set('compact', {
+    name: 'compact',
+    description: 'Compress context for the current session',
+    async execute() {
+        const result = await (0, agent_1.compressContext)(exports.threadId);
+        if (result.didCompress) {
+            console.log(colors_1.color.goodbye(`\nContext compressed (count: ${result.count}).\n`));
+        }
+        else {
+            console.log('\nNo context to compress.\n');
+        }
+    },
+});

package/dist/agent/config.d.ts

@@ -0,0 +1,38 @@
+export declare const WORKSPACE_DIR: string;
+export declare const CONFIG_PATH: string;
+interface ModelConfig {
+    model: string;
+    apiKey: string;
+    baseURL: string;
+}
+export interface HookConfig {
+    matcher: string;
+    command: string;
+}
+export interface HooksConfig {
+    hooks: {
+        PreToolUse?: HookConfig[];
+        PostToolUse?: HookConfig[];
+        SessionStart?: HookConfig[];
+    };
+}
+export interface McpServerConfig {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+}
+interface ZhitalkConfig {
+    model?: ModelConfig;
+    env?: Record<string, string>;
+    hooks?: HooksConfig['hooks'];
+    mcpServers?: Record<string, McpServerConfig>;
+}
+export declare function loadConfig(): ZhitalkConfig;
+export declare function getModelConfig(): ModelConfig;
+export declare function getEnv(key: string): string | undefined;
+export declare function getHooksConfig(): HooksConfig;
+export declare function getMCPServerConfig(): Record<string, McpServerConfig>;
+export declare function clearConfigCache(): void;
+export {};

package/dist/agent/config.js

@@ -0,0 +1,116 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_PATH = exports.WORKSPACE_DIR = void 0;
+exports.loadConfig = loadConfig;
+exports.getModelConfig = getModelConfig;
+exports.getEnv = getEnv;
+exports.getHooksConfig = getHooksConfig;
+exports.getMCPServerConfig = getMCPServerConfig;
+exports.clearConfigCache = clearConfigCache;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+exports.WORKSPACE_DIR = path.join(os.homedir(), '.zhitalk');
+exports.CONFIG_PATH = path.join(exports.WORKSPACE_DIR, 'zhitalk.json');
+let cachedConfig = null;
+function loadConfig() {
+    if (cachedConfig) {
+        return cachedConfig;
+    }
+    if (!fs.existsSync(exports.CONFIG_PATH)) {
+        throw new Error(`找不到配置文件 ${exports.CONFIG_PATH}\n\n请创建该文件并配置相关信息，例如：\n{\n  "model": {\n    "model": "kimi-k2.6",\n    "apiKey": "your-api-key",\n    "baseURL": "https://api.moonshot.cn/v1"\n  },\n  "env": {\n    "TAVILY_API_KEY": "your-tavily-api-key"\n  }\n}`);
+    }
+    let config;
+    try {
+        const content = fs.readFileSync(exports.CONFIG_PATH, 'utf-8');
+        config = JSON.parse(content);
+    }
+    catch (e) {
+        throw new Error(`配置文件 ${exports.CONFIG_PATH} 解析失败：${e instanceof Error ? e.message : String(e)}`);
+    }
+    cachedConfig = config;
+    return config;
+}
+function getModelConfig() {
+    const config = loadConfig();
+    if (!config.model || typeof config.model !== 'object') {
+        throw new Error(`配置文件 ${exports.CONFIG_PATH} 中缺少 model 对象，请参考 https://zhitalk.chat/#config 修改配置`);
+    }
+    if (!config.model.model) {
+        throw new Error(`配置文件 ${exports.CONFIG_PATH} 中缺少 model.model 字段，请参考 https://zhitalk.chat/#config 修改配置`);
+    }
+    if (!config.model.apiKey) {
+        throw new Error(`配置文件 ${exports.CONFIG_PATH} 中缺少 model.apiKey 字段，请参考 https://zhitalk.chat/#config 修改配置`);
+    }
+    if (!config.model.baseURL) {
+        throw new Error(`配置文件 ${exports.CONFIG_PATH} 中缺少 model.baseURL 字段，请参考 https://zhitalk.chat/#config 修改配置`);
+    }
+    return config.model;
+}
+function getEnv(key) {
+    const config = loadConfig();
+    return config.env?.[key];
+}
+function getHooksConfig() {
+    try {
+        const config = loadConfig();
+        return { hooks: config.hooks || {} };
+    }
+    catch {
+        return { hooks: {} };
+    }
+}
+function getMCPServerConfig() {
+    try {
+        const content = fs.readFileSync(exports.CONFIG_PATH, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (!parsed.mcpServers || typeof parsed.mcpServers !== 'object') {
+            // console.warn('[MCP] zhitalk.json missing "mcpServers" field, skipping')
+            return {};
+        }
+        return parsed.mcpServers;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return {};
+        }
+        console.warn(`[MCP] Failed to load zhitalk.json: ${err.message}, skipping`);
+        return {};
+    }
+}
+function clearConfigCache() {
+    cachedConfig = null;
+}

package/dist/agent/context.d.ts

@@ -0,0 +1,3 @@
+import { BaseMessage } from '@langchain/core/messages';
+export declare function getModelContextLimit(): number;
+export declare function compressMessages(messages: BaseMessage[], existingSummary: string | null): Promise<string>;

package/dist/agent/context.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getModelContextLimit = getModelContextLimit;
+exports.compressMessages = compressMessages;
+const messages_1 = require("@langchain/core/messages");
+const model_1 = require("./model");
+const config_1 = require("./config");
+const MODEL_CONTEXT_LIMITS = {
+    // Moonshot / Kimi
+    'moonshot-v1-8k': 8192,
+    'moonshot-v1-32k': 32768,
+    'moonshot-v1-128k': 131072,
+    'kimi-k2.6': 256000,
+    // DeepSeek
+    'deepseek-chat': 1048576,
+    'deepseek-reasoner': 1048576,
+    'deepseek-v3': 65536,
+    'deepseek-v3.1': 131072,
+    'deepseek-v4': 1048576,
+    'deepseek-r1': 65536,
+    // MiniMax
+    'minimax-text-01': 1048576,
+    'minimax-m1': 1048576,
+    'minimax-m3': 1048576,
+    // GLM (Zhipu)
+    'glm-4': 131072,
+    'glm-4-plus': 131072,
+    'glm-4-air': 131072,
+    'glm-4-flash': 131072,
+    'glm-4v': 131072,
+    // Qwen (Alibaba)
+    'qwen-max': 32768,
+    'qwen-plus': 131072,
+    'qwen-plus-2025-07-28': 1048576,
+    'qwen-turbo': 1048576,
+    'qwen-long': 10485760,
+    // Xiaomi MiMo
+    'mimo-7b': 32768,
+    'mimo-v2.5': 1048576,
+};
+function getModelContextLimit() {
+    const modelName = (0, config_1.getModelConfig)().model || '';
+    return MODEL_CONTEXT_LIMITS[modelName.toLowerCase()] || 128000;
+}
+function formatMessagesForCompression(messages) {
+    return messages
+        .map((msg) => {
+        const role = msg.type;
+        let content = typeof msg.content === 'string'
+            ? msg.content
+            : JSON.stringify(msg.content);
+        if (role === 'ai' && msg.tool_calls?.length) {
+            content += `\n[Tool Calls: ${JSON.stringify(msg.tool_calls)}]`;
+        }
+        return `[${role}] ${content}`;
+    })
+        .join('\n\n');
+}
+async function compressMessages(messages, existingSummary) {
+    if (messages.length === 0) {
+        return existingSummary || '';
+    }
+    const text = formatMessagesForCompression(messages);
+    const prompt = `请对以下对话内容进行结构化压缩摘要，要求如下：
+
+1. 压缩比例至少 50%，去除重复、冗余、语气词和过渡性内容，但保留所有关键决策、结论、数据和待办事项。
+2. 若对话包含多轮主题，请按主题分段压缩。
+3. 无内容的项目可写“无”。
+
+输出格式（Markdown）：
+
+## 时间
+对话发生的时间范围或关键时间点。
+
+## 摘要
+概括本轮对话的核心内容。
+
+## 决策
+列出对话中做出的所有明确决策（如技术选型、方案确定、优先级调整等）。
+
+## 结论
+列出对话中达成的所有结论或共识。
+
+## 待办
+列出所有明确的待办事项（TODO），包括负责人（如有）。
+
+## 遗留问题
+列出尚未解决、需要后续跟进的问题。
+
+## 原话摘要
+摘录最具代表性的原话或关键信息，用引号标注。
+
+---
+
+对话内容如下：
+
+${text}`;
+    const model = (0, model_1.createModel)({ streaming: false });
+    const response = await model.invoke([new messages_1.HumanMessage(prompt)]);
+    const newSummary = typeof response.content === 'string'
+        ? response.content
+        : JSON.stringify(response.content);
+    if (existingSummary) {
+        return `${existingSummary}\n\n[后续对话摘要]\n${newSummary}`;
+    }
+    return newSummary;
+}

package/dist/agent/db.d.ts

@@ -0,0 +1,21 @@
+export declare const DB_PATH: string;
+export interface SessionRow {
+    thread_id: string;
+    last_question: string;
+    last_ts: string;
+}
+export interface MemorySearchResult {
+    id: number;
+    type: string;
+    content: string;
+    keywords: string | null;
+    importance: number;
+    session_id: string | null;
+    created_at: string;
+    updated_at: string;
+    final_score: number;
+}
+export declare function searchMemories(query: string[], limit?: number): MemorySearchResult[];
+export declare function threadIdExists(threadId: string): boolean;
+export declare function initDb(): void;
+export declare function listRecentSessions(): SessionRow[];

package/dist/agent/db.js

@@ -0,0 +1,159 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DB_PATH = void 0;
+exports.searchMemories = searchMemories;
+exports.threadIdExists = threadIdExists;
+exports.initDb = initDb;
+exports.listRecentSessions = listRecentSessions;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_1 = require("./config");
+const utils_1 = require("./utils");
+exports.DB_PATH = (0, path_1.join)(config_1.WORKSPACE_DIR, '.data', 'checkpointer.db');
+(0, fs_1.mkdirSync)((0, path_1.dirname)(exports.DB_PATH), { recursive: true });
+function searchMemories(query, limit = 10) {
+    const trimmedQueries = query.map((q) => q.trim()).filter((q) => q.length > 0);
+    if (trimmedQueries.length === 0) {
+        return [];
+    }
+    const queryStr = trimmedQueries.join(' OR ').replace(/-/g, ' ');
+    const db = new better_sqlite3_1.default(exports.DB_PATH);
+    try {
+        const rows = db.prepare(`
+      WITH ranked AS (
+        SELECT
+          m.*,
+          -bm25(memory_fts, 10.0, 5.0) AS relevance_score,
+          (m.importance * 0.3) AS importance_score,
+          (
+            1.0 / (
+              1.0 +
+              ((strftime('%s','now') - strftime('%s', m.updated_at)) / 86400.0)
+            )
+          ) AS time_score
+        FROM memory_fts
+        JOIN memory m ON m.id = memory_fts.rowid
+        WHERE memory_fts MATCH ?
+      )
+      SELECT *,
+        (
+          relevance_score * 0.6 +
+          importance_score * 0.3 +
+          time_score * 0.1
+        ) AS final_score
+      FROM ranked
+      ORDER BY final_score DESC
+      LIMIT ?
+    `).all(queryStr, limit);
+        return rows.map((r) => ({
+            id: r.id,
+            type: r.type,
+            content: r.content,
+            keywords: r.keywords,
+            importance: r.importance,
+            session_id: r.session_id,
+            created_at: r.created_at,
+            updated_at: r.updated_at,
+            final_score: r.final_score,
+        }));
+    }
+    finally {
+        db.close();
+    }
+}
+function threadIdExists(threadId) {
+    const db = new better_sqlite3_1.default(exports.DB_PATH);
+    try {
+        const row = db.prepare(`
+      SELECT 1 FROM checkpoints WHERE thread_id = ? LIMIT 1
+    `).get(threadId);
+        return !!row;
+    }
+    finally {
+        db.close();
+    }
+}
+function initDb() {
+    const db = new better_sqlite3_1.default(exports.DB_PATH);
+    try {
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS memory (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        type TEXT NOT NULL,
+        content TEXT NOT NULL,
+        keywords TEXT,
+        importance INTEGER DEFAULT 3,
+        session_id TEXT,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      )
+    `);
+        db.exec(`
+      CREATE VIRTUAL TABLE IF NOT EXISTS memory_fts USING fts5(
+        content,
+        keywords,
+        content='memory', content_rowid='id'
+      )
+    `);
+        db.exec(`
+      CREATE TRIGGER IF NOT EXISTS memory_fts_insert AFTER INSERT ON memory BEGIN
+        INSERT INTO memory_fts(rowid, content, keywords)
+        VALUES (new.id, new.content, new.keywords);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS memory_fts_delete AFTER DELETE ON memory BEGIN
+        INSERT INTO memory_fts(memory_fts, rowid, content, keywords)
+        VALUES ('delete', old.id, old.content, old.keywords);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS memory_fts_update AFTER UPDATE ON memory BEGIN
+        INSERT INTO memory_fts(memory_fts, rowid, content, keywords)
+        VALUES ('delete', old.id, old.content, old.keywords);
+        INSERT INTO memory_fts(rowid, content, keywords)
+        VALUES (new.id, new.content, new.keywords);
+      END;
+    `);
+    }
+    finally {
+        db.close();
+    }
+}
+function listRecentSessions() {
+    const db = new better_sqlite3_1.default(exports.DB_PATH);
+    try {
+        const rows = db.prepare(`
+      WITH thread_last_ts AS (
+        SELECT
+          thread_id,
+          MAX(json_extract(CAST(checkpoint AS TEXT), '$.ts')) AS last_ts
+        FROM checkpoints
+        GROUP BY thread_id
+      )
+      SELECT
+        t.thread_id,
+        (SELECT json_extract(CAST(w.value AS TEXT), '$[0].kwargs.content')
+         FROM writes w
+         WHERE w.thread_id = t.thread_id
+           AND w.channel = 'messages'
+           AND json_extract(CAST(w.value AS TEXT), '$[0].id[2]') = 'HumanMessage'
+         ORDER BY w.checkpoint_id DESC
+         LIMIT 1) AS last_question,
+        t.last_ts
+      FROM thread_last_ts t
+      ORDER BY t.last_ts DESC
+      LIMIT 20
+    `).all();
+        return rows.map((r) => ({
+            thread_id: r.thread_id,
+            last_question: (0, utils_1.truncate)(r.last_question, 50),
+            last_ts: (0, utils_1.formatRelativeTime)(r.last_ts),
+        }));
+    }
+    finally {
+        db.close();
+    }
+}

package/dist/agent/hooks.d.ts

@@ -0,0 +1,27 @@
+import { HookConfig, HooksConfig } from './config';
+export type { HookConfig, HooksConfig };
+export type HookResult = {
+    action: 'continue';
+} | {
+    action: 'block';
+    reason: string;
+} | {
+    action: 'inject';
+    message: string;
+};
+export declare function loadHooksConfig(): HooksConfig;
+export declare function clearHooksCache(): void;
+export declare function matchHooks(hooks: HookConfig[] | undefined, toolName: string): HookConfig[];
+export declare function runHook(hook: HookConfig, env: Record<string, string>, timeout?: number): Promise<HookResult>;
+export interface ToolHookContext {
+    toolName: string;
+    toolArgs: any;
+    toolCallId: string;
+    threadId: string;
+}
+export declare function runPreToolUseHooks(context: ToolHookContext): Promise<HookResult>;
+export interface PostToolHookContext extends ToolHookContext {
+    toolOutput: string;
+}
+export declare function runPostToolUseHooks(context: PostToolHookContext): Promise<HookResult>;
+export declare function runSessionStartHooks(threadId: string): Promise<void>;