@hflin/cclin 0.1.0

package/dist/runtime/model-profile.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @file 模型能力配置 — 根据模型名推断其支持的特性。
+ *
+ * 参考 memo-code 的 model_profile.ts，
+ * 不同模型支持不同能力（并行工具调用、思考链等）。
+ */
+import type OpenAI from 'openai';
+/** 模型能力画像。 */
+export type ModelProfile = {
+    /** 是否支持并行工具调用。 */
+    supportsParallelToolCalls: boolean;
+    /** 是否支持 reasoning_content 字段。 */
+    supportsReasoningContent: boolean;
+    /** 上下文窗口大小（token）。 */
+    contextWindow: number;
+    /** 是否是回退配置（无精确匹配）。 */
+    isFallback: boolean;
+};
+/**
+ * 根据模型名解析能力配置。
+ * 使用最长前缀匹配策略。
+ */
+export declare function resolveModelProfile(model: string): ModelProfile;
+type ToolSpec = {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+};
+/**
+ * 根据模型 profile 构建 chat completion 请求参数。
+ */
+export declare function buildChatCompletionRequest(params: {
+    model: string;
+    messages: OpenAI.Chat.Completions.ChatCompletionMessageParam[];
+    tools?: ToolSpec[];
+    profile: ModelProfile;
+}): OpenAI.Chat.Completions.ChatCompletionCreateParams;
+export {};
+//# sourceMappingURL=model-profile.d.ts.map

package/dist/runtime/model-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-profile.d.ts","sourceRoot":"","sources":["../../src/runtime/model-profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAIhC,cAAc;AACd,MAAM,MAAM,YAAY,GAAG;IACvB,kBAAkB;IAClB,yBAAyB,EAAE,OAAO,CAAA;IAClC,iCAAiC;IACjC,wBAAwB,EAAE,OAAO,CAAA;IACjC,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,sBAAsB;IACtB,UAAU,EAAE,OAAO,CAAA;CACtB,CAAA;AA+CD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAqB/D;AAID,KAAK,QAAQ,GAAG;IACZ,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACtC,CAAA;CACJ,CAAA;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,0BAA0B,EAAE,CAAA;IAC9D,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;IAClB,OAAO,EAAE,YAAY,CAAA;CACxB,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,0BAA0B,CAgBrD"}

package/dist/runtime/model-profile.js

@@ -0,0 +1,84 @@
+/**
+ * @file 模型能力配置 — 根据模型名推断其支持的特性。
+ *
+ * 参考 memo-code 的 model_profile.ts，
+ * 不同模型支持不同能力（并行工具调用、思考链等）。
+ */
+/** 保守的回退配置。 */
+const FALLBACK = {
+    supportsParallelToolCalls: false,
+    supportsReasoningContent: false,
+    contextWindow: 128_000,
+};
+/**
+ * 已知模型的能力映射。
+ * key 为模型名前缀（小写），匹配时取最长前缀。
+ */
+const KNOWN_PROFILES = {
+    'gpt-4o': {
+        supportsParallelToolCalls: true,
+        supportsReasoningContent: false,
+        contextWindow: 128_000,
+    },
+    'gpt-4o-mini': {
+        supportsParallelToolCalls: true,
+        supportsReasoningContent: false,
+        contextWindow: 128_000,
+    },
+    'deepseek-chat': {
+        supportsParallelToolCalls: false,
+        supportsReasoningContent: false,
+        contextWindow: 64_000,
+    },
+    'deepseek-reasoner': {
+        supportsParallelToolCalls: false,
+        supportsReasoningContent: true,
+        contextWindow: 64_000,
+    },
+    'claude': {
+        supportsParallelToolCalls: true,
+        supportsReasoningContent: false,
+        contextWindow: 200_000,
+    },
+};
+// ─── 解析函数 ─────────────────────────────────────────────────────────────────
+/**
+ * 根据模型名解析能力配置。
+ * 使用最长前缀匹配策略。
+ */
+export function resolveModelProfile(model) {
+    const slug = model.trim().toLowerCase();
+    // 精确匹配
+    if (KNOWN_PROFILES[slug]) {
+        return { ...KNOWN_PROFILES[slug], isFallback: false };
+    }
+    // 前缀匹配（取最长匹配）
+    let bestKey = '';
+    for (const key of Object.keys(KNOWN_PROFILES)) {
+        if (slug.startsWith(key) && key.length > bestKey.length) {
+            bestKey = key;
+        }
+    }
+    if (bestKey) {
+        return { ...KNOWN_PROFILES[bestKey], isFallback: false };
+    }
+    return { ...FALLBACK, isFallback: true };
+}
+/**
+ * 根据模型 profile 构建 chat completion 请求参数。
+ */
+export function buildChatCompletionRequest(params) {
+    const request = {
+        model: params.model,
+        messages: params.messages,
+    };
+    if (params.tools && params.tools.length > 0) {
+        request.tools = params.tools;
+        request.tool_choice = 'auto';
+        if (params.profile.supportsParallelToolCalls) {
+            request.parallel_tool_calls = true;
+        }
+    }
+    return request;
+}
+//# sourceMappingURL=model-profile.js.map

package/dist/runtime/model-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-profile.js","sourceRoot":"","sources":["../../src/runtime/model-profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,eAAe;AACf,MAAM,QAAQ,GAAiB;IAC3B,yBAAyB,EAAE,KAAK;IAChC,wBAAwB,EAAE,KAAK;IAC/B,aAAa,EAAE,OAAO;CACzB,CAAA;AAED;;;GAGG;AACH,MAAM,cAAc,GAAiC;IACjD,QAAQ,EAAE;QACN,yBAAyB,EAAE,IAAI;QAC/B,wBAAwB,EAAE,KAAK;QAC/B,aAAa,EAAE,OAAO;KACzB;IACD,aAAa,EAAE;QACX,yBAAyB,EAAE,IAAI;QAC/B,wBAAwB,EAAE,KAAK;QAC/B,aAAa,EAAE,OAAO;KACzB;IACD,eAAe,EAAE;QACb,yBAAyB,EAAE,KAAK;QAChC,wBAAwB,EAAE,KAAK;QAC/B,aAAa,EAAE,MAAM;KACxB;IACD,mBAAmB,EAAE;QACjB,yBAAyB,EAAE,KAAK;QAChC,wBAAwB,EAAE,IAAI;QAC9B,aAAa,EAAE,MAAM;KACxB;IACD,QAAQ,EAAE;QACN,yBAAyB,EAAE,IAAI;QAC/B,wBAAwB,EAAE,KAAK;QAC/B,aAAa,EAAE,OAAO;KACzB;CACJ,CAAA;AAED,6EAA6E;AAE7E;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAEvC,OAAO;IACP,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;IACzD,CAAC;IAED,cAAc;IACd,IAAI,OAAO,GAAG,EAAE,CAAA;IAChB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACtD,OAAO,GAAG,GAAG,CAAA;QACjB,CAAC;IACL,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;IAC5D,CAAC;IAED,OAAO,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;AAC5C,CAAC;AAaD;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAK1C;IACG,MAAM,OAAO,GAAuD;QAChE,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC5B,CAAA;IAED,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;QAC5B,OAAO,CAAC,WAAW,GAAG,MAAM,CAAA;QAE5B,IAAI,MAAM,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC;YAC3C,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAA;QACtC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAA;AAClB,CAAC"}

package/dist/runtime/prompt.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @file Prompt 管理模块 — 模板引擎 + 系统提示词动态组装。
+ *
+ * Phase 5：实现灵活的系统提示词加载：
+ *   1. 读取 prompt.md 模板
+ *   2. 渲染变量替换（{{date}}, {{user}}, {{pwd}}）
+ *   3. 加载 AGENTS.md（项目级指令）
+ *   4. 加载 SOUL.md（用户人格偏好）
+ *   5. 组装完整 system prompt
+ */
+/**
+ * 渲染模板字符串，将 {{key}} 替换为 vars 中的值。
+ *
+ * 设计决策：使用简单的正则替换而非完整模板引擎，
+ * 因为我们只需要少量变量替换，不需要条件/循环等高级特性。
+ */
+export declare function renderTemplate(template: string, vars: Record<string, string>): string;
+export type LoadSystemPromptOptions = {
+    /** 项目根目录，默认 process.cwd()。 */
+    cwd?: string;
+    /** 工具的 Markdown 描述文本（对应 {{tools}} 占位符）。 */
+    toolsText?: string;
+    /** Skills section 文本（由 renderSkillsSection 生成）。 */
+    skillsText?: string;
+};
+/**
+ * 加载并组装完整的系统提示词。
+ *
+ * 组装流程：
+ *   1. 读取 prompt.md 模板文件
+ *   2. 读取 SOUL.md（可选）
+ *   3. 渲染模板变量（date, user, pwd, soul_section）
+ *   4. 若模板中无 soul 占位符但有 SOUL.md → 追加到末尾
+ *   5. 读取 AGENTS.md（可选）→ 追加到末尾
+ *   6. 返回组装后的完整 system prompt
+ */
+export declare function loadSystemPrompt(options?: LoadSystemPromptOptions): Promise<string>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/runtime/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/runtime/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH;;;;;GAKG;AACH,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAKR;AA4FD,MAAM,MAAM,uBAAuB,GAAG;IAClC,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAClC,OAAO,GAAE,uBAA4B,GACtC,OAAO,CAAC,MAAM,CAAC,CAwCjB"}

package/dist/runtime/prompt.js

@@ -0,0 +1,152 @@
+/**
+ * @file Prompt 管理模块 — 模板引擎 + 系统提示词动态组装。
+ *
+ * Phase 5：实现灵活的系统提示词加载：
+ *   1. 读取 prompt.md 模板
+ *   2. 渲染变量替换（{{date}}, {{user}}, {{pwd}}）
+ *   3. 加载 AGENTS.md（项目级指令）
+ *   4. 加载 SOUL.md（用户人格偏好）
+ *   5. 组装完整 system prompt
+ */
+import os from 'node:os';
+import { readFile } from 'node:fs/promises';
+import { join, dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// ─── 模板引擎 ────────────────────────────────────────────────────────────────
+/** 模板变量匹配正则：{{varName}} */
+const TEMPLATE_PATTERN = /\{\{\s*([\w.-]+)\s*\}\}/g;
+/**
+ * 渲染模板字符串，将 {{key}} 替换为 vars 中的值。
+ *
+ * 设计决策：使用简单的正则替换而非完整模板引擎，
+ * 因为我们只需要少量变量替换，不需要条件/循环等高级特性。
+ */
+export function renderTemplate(template, vars) {
+    return template.replace(TEMPLATE_PATTERN, (_match, key) => vars[key] ?? '');
+}
+// ─── 环境信息 ────────────────────────────────────────────────────────────────
+/** 获取当前操作系统用户名。 */
+function resolveUsername() {
+    try {
+        return os.userInfo().username;
+    }
+    catch {
+        return process.env.USER ?? process.env.USERNAME ?? 'unknown';
+    }
+}
+/**
+ * 解析 cclin 主目录（存放 SOUL.md 等用户配置）。
+ *
+ * 优先级：环境变量 CCLIN_HOME > ~/.cclin
+ */
+function resolveCclinHome() {
+    const homeDir = os.homedir();
+    const configured = process.env.CCLIN_HOME?.trim();
+    if (configured) {
+        if (configured.startsWith('~/')) {
+            return resolve(join(homeDir, configured.slice(2)));
+        }
+        return resolve(configured);
+    }
+    return join(homeDir, '.cclin');
+}
+/**
+ * 读取项目根目录的 AGENTS.md。
+ *
+ * AGENTS.md 包含项目级的开发规范和指令，
+ * 加载后会追加到系统提示词末尾。
+ */
+async function readProjectAgentsMd(projectRoot) {
+    const agentsPath = join(projectRoot, 'AGENTS.md');
+    try {
+        const content = await readFile(agentsPath, 'utf-8');
+        if (!content.trim())
+            return null;
+        return { path: agentsPath, content };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 读取用户人格偏好文件 SOUL.md。
+ *
+ * SOUL.md 存放在 ~/.cclin/SOUL.md，包含用户的
+ * 语言、风格等个性化偏好，属于"软偏好层"。
+ */
+async function readSoulMd() {
+    const soulPath = join(resolveCclinHome(), 'SOUL.md');
+    try {
+        const content = await readFile(soulPath, 'utf-8');
+        if (!content.trim())
+            return null;
+        return { path: soulPath, content };
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Prompt 组装 ─────────────────────────────────────────────────────────────
+/** SOUL.md 占位符正则。 */
+const SOUL_PLACEHOLDER = /\{\{\s*soul_section\s*\}\}/;
+/**
+ * 将 SOUL.md 内容渲染为带说明的 section。
+ *
+ * 包含优先级说明：SOUL.md 是"软偏好层"，
+ * 不应覆盖安全规则或 AGENTS.md 指令。
+ */
+function renderSoulSection(soul) {
+    return `## User Personality (SOUL.md)
+Loaded from: ${soul.path}
+
+- Treat as soft preference for tone, style, and behavior.
+- Do NOT override safety rules, AGENTS.md, or explicit user instructions.
+
+${soul.content}`;
+}
+/**
+ * 加载并组装完整的系统提示词。
+ *
+ * 组装流程：
+ *   1. 读取 prompt.md 模板文件
+ *   2. 读取 SOUL.md（可选）
+ *   3. 渲染模板变量（date, user, pwd, soul_section）
+ *   4. 若模板中无 soul 占位符但有 SOUL.md → 追加到末尾
+ *   5. 读取 AGENTS.md（可选）→ 追加到末尾
+ *   6. 返回组装后的完整 system prompt
+ */
+export async function loadSystemPrompt(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    // 1. 定位并读取 prompt.md 模板
+    const moduleDir = dirname(fileURLToPath(import.meta.url));
+    const promptPath = join(moduleDir, 'prompt.md');
+    const template = await readFile(promptPath, 'utf-8');
+    // 2. 读取 SOUL.md
+    const soul = await readSoulMd();
+    const soulSection = soul ? renderSoulSection(soul) : '';
+    const hasSoulPlaceholder = SOUL_PLACEHOLDER.test(template);
+    // 3. 渲染模板变量
+    const vars = {
+        date: new Date().toISOString(),
+        user: resolveUsername(),
+        pwd: cwd,
+        soul_section: soulSection,
+        tools: options.toolsText ?? 'No tools available.',
+    };
+    let prompt = renderTemplate(template, vars);
+    // 4. 若模板中没有 soul 占位符，但有 SOUL.md → 追加
+    if (!hasSoulPlaceholder && soulSection) {
+        prompt = `${prompt}\n\n${soulSection}`;
+    }
+    // 5. 追加 Skills section（放在 AGENTS.md 之前）
+    if (options.skillsText) {
+        prompt = `${prompt}\n\n${options.skillsText}`;
+    }
+    // 6. 追加 AGENTS.md（放在越后面，优先级越高）
+    const agents = await readProjectAgentsMd(cwd);
+    if (agents) {
+        prompt = `${prompt}\n\n## Project AGENTS.md\nLoaded from: ${agents.path}\n\n${agents.content}`;
+    }
+    return prompt;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/runtime/prompt.js.map

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

package/dist/runtime/prompt.md

@@ -0,0 +1,64 @@
+You are **cclin**, an interactive CLI coding assistant. Use the tools available to you to help the user with software engineering tasks.
+
+**IMPORTANT**: Refuse to write or explain code that may be used maliciously.
+
+---
+
+# Core Identity
+
+- **Local First**: You operate directly on the user's machine. File operations and commands happen in the real environment.
+- **Project Aware**: Read and follow `AGENTS.md` files containing project structure, conventions, and preferences.
+- **Tool Rich**: Use your comprehensive toolkit to gather information and complete tasks.
+- **Safety Conscious**: The environment is NOT sandboxed. Your actions have immediate effects.
+
+{{soul_section}}
+
+# Session Context
+
+- Date: {{date}}
+- User: {{user}}
+- PWD: {{pwd}}
+
+---
+
+# Tone and Style
+
+- Answer directly without preamble or postamble
+- Keep responses concise unless the user asks for detail
+- One word answers are best when appropriate
+
+---
+
+# Tool Usage Policy
+
+- Prefer specialized tools over generic shell calls
+- Use tools extensively to read and understand before modifying
+- Follow existing code conventions and patterns
+
+## Available Tools
+
+{{tools}}
+
+---
+
+# Working Environment
+
+⚠️ **WARNING**: Environment is NOT SANDBOXED. Actions immediately affect the user's system.
+
+- Never access files outside working directory unless instructed
+- Note: On Windows, paths are case-insensitive (e.g., 'd:\' and 'D:\' are the same). Do not falsely reject valid paths due to case differences.
+- Be careful with destructive operations
+- Validate inputs before shell commands
+
+## Project Context (AGENTS.md)
+
+Files named `AGENTS.md` may exist with project-specific guidance. Follow their instructions.
+
+---
+
+# Ultimate Reminders
+
+- **Concise**: Keep text short
+- **Quality-focused**: Run lint/typecheck after changes
+- **Safety conscious**: Actions have real consequences
+- **Focused**: Only make necessary changes

package/dist/runtime/prompt.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file Unit tests for Prompt management (Phase 5).
+ *
+ * Tests: renderTemplate
+ */
+export {};
+//# sourceMappingURL=prompt.test.d.ts.map

package/dist/runtime/prompt.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.test.d.ts","sourceRoot":"","sources":["../../src/runtime/prompt.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/runtime/prompt.test.js

@@ -0,0 +1,38 @@
+/**
+ * @file Unit tests for Prompt management (Phase 5).
+ *
+ * Tests: renderTemplate
+ */
+import { describe, it, expect } from 'vitest';
+import { renderTemplate } from './prompt.js';
+describe('renderTemplate', () => {
+    it('should replace variables with values', () => {
+        const template = 'Hello, {{NAME}}! Welcome to {{PLACE}}.';
+        const vars = { NAME: 'Alice', PLACE: 'Wonderland' };
+        const result = renderTemplate(template, vars);
+        expect(result).toBe('Hello, Alice! Welcome to Wonderland.');
+    });
+    it('should handle whitespace in template tags', () => {
+        const template = 'Value: {{  KEY  }}';
+        const vars = { KEY: '123' };
+        const result = renderTemplate(template, vars);
+        expect(result).toBe('Value: 123');
+    });
+    it('should replace undefined variables with empty string', () => {
+        const template = 'Hello, {{NAME}}!';
+        const vars = {}; // NAME is missing
+        const result = renderTemplate(template, vars);
+        expect(result).toBe('Hello, !');
+    });
+    it('should leave text unchanged if no tags', () => {
+        const template = 'Just normal text without tags.';
+        const result = renderTemplate(template, { KEY: 'val' });
+        expect(result).toBe('Just normal text without tags.');
+    });
+    it('should replace multiple occurrences of the same variable', () => {
+        const template = '{{A}} plus {{A}} is 2{{A}}';
+        const result = renderTemplate(template, { A: '1' });
+        expect(result).toBe('1 plus 1 is 21');
+    });
+});
+//# sourceMappingURL=prompt.test.js.map

package/dist/runtime/prompt.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.test.js","sourceRoot":"","sources":["../../src/runtime/prompt.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC5C,MAAM,QAAQ,GAAG,wCAAwC,CAAA;QACzD,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;QACnD,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACjD,MAAM,QAAQ,GAAG,oBAAoB,CAAA;QACrC,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;QAC3B,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC5D,MAAM,QAAQ,GAAG,kBAAkB,CAAA;QACnC,MAAM,IAAI,GAAG,EAAE,CAAA,CAAC,kBAAkB;QAClC,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAC9C,MAAM,QAAQ,GAAG,gCAAgC,CAAA;QACjD,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAChE,MAAM,QAAQ,GAAG,4BAA4B,CAAA;QAC7C,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;QACnD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA"}

package/dist/runtime/react-loop.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @file ReAct 循环核心引擎。
+ *
+ * Phase 2：实现 Think → Act → Observe 循环骨架。
+ * 工具执行通过 `executeTool` 注入，Phase 2 使用 mock 实现。
+ *
+ * 设计：纯函数 `runTurn()`，不持有状态，所有状态通过参数传入。
+ * 这样 Session 类只做状态管理，循环逻辑可独立测试。
+ */
+import type { CallLLM, ChatMessage, LLMResponse, ParsedAssistant, TurnResult, ExecuteTool, TokenUsage, TokenCounter, CompactResult } from '../types.js';
+import type { HookRunnerMap } from './hooks.js';
+/**
+ * 从 LLM 响应中提取文本内容和工具调用块。
+ *
+ * 将 ContentBlock[] 分拆为两个维度：
+ *   - textContent：所有 TextBlock 拼接的纯文本
+ *   - toolUseBlocks：所有 ToolUseBlock 的结构化数据
+ */
+export declare function normalizeLLMResponse(response: LLMResponse): {
+    textContent: string;
+    toolUseBlocks: Array<{
+        id: string;
+        name: string;
+        input: unknown;
+    }>;
+    stopReason: string;
+    usage: Partial<TokenUsage> | undefined;
+    reasoningContent: string | undefined;
+};
+/**
+ * 将 normalized 响应转为 ParsedAssistant 结构。
+ *
+ * 判定逻辑：
+ *   1. 有工具调用 → action（取第一个工具），文本部分作为 thinking
+ *   2. 无工具调用但有文本 → final
+ *   3. 两者皆无 → 空对象
+ */
+export declare function parseLLMResponse(textContent: string, toolUseBlocks: Array<{
+    id: string;
+    name: string;
+    input: unknown;
+}>): ParsedAssistant;
+/** runTurn 的依赖注入参数。 */
+export type RunTurnDeps = {
+    /** 对话历史（会被就地修改）。 */
+    history: ChatMessage[];
+    /** LLM 调用函数。 */
+    callLLM: CallLLM;
+    /** 工具执行函数（Phase 2 默认 mock）。 */
+    executeTool?: ExecuteTool;
+    /** Token 计数器（Phase 6，启用压缩必需）。 */
+    tokenCounter?: TokenCounter;
+    /** 上下文窗口大小（token 数）。 */
+    contextWindow?: number;
+    /** 自动压缩阈值百分比。 */
+    compactThreshold?: number;
+    /** 自动压缩回调（由 Session 注入）。 */
+    compactFn?: () => Promise<CompactResult>;
+    /** Hook 注册表（Phase 7）。 */
+    hookRunners?: HookRunnerMap;
+    /** Session ID（供 Hook payload 使用）。 */
+    sessionId?: string;
+    /** 当前轮次编号（供 Hook payload 使用）。 */
+    turnIndex?: number;
+    /** 清理本轮一次性授权（Turn 结束时调用）。 */
+    clearApprovalsFn?: () => void;
+    /** 流式文本 chunk 回调（TUI 实时显示）。 */
+    onAssistantChunk?: (step: number, chunk: string) => void;
+};
+/**
+ * 执行一次 Turn 的 ReAct 循环。
+ *
+ * 流程：
+ *   1. 将用户输入追加到 history
+ *   2. 循环调用 LLM → 解析响应 → 处理工具/最终回答
+ *   3. 返回 TurnResult
+ *
+ * @param input - 用户输入文本
+ * @param deps  - 依赖注入（history, callLLM, executeTool）
+ */
+export declare function runTurn(input: string, deps: RunTurnDeps): Promise<TurnResult>;
+//# sourceMappingURL=react-loop.d.ts.map

package/dist/runtime/react-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-loop.d.ts","sourceRoot":"","sources":["../../src/runtime/react-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACR,OAAO,EACP,WAAW,EACX,WAAW,EAEX,eAAe,EAEf,UAAU,EAEV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,aAAa,EAChB,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAO/C;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,GAAG;IACzD,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAClE,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAA;IACtC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAA;CACvC,CAwBA;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC5B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,GACnE,eAAe,CAqBjB;AAuBD,uBAAuB;AACvB,MAAM,MAAM,WAAW,GAAG;IACtB,oBAAoB;IACpB,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,gBAAgB;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,iCAAiC;IACjC,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,wBAAwB;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;IACxC,yBAAyB;IACzB,WAAW,CAAC,EAAE,aAAa,CAAA;IAC3B,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B,+BAA+B;IAC/B,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3D,CAAA;AAUD;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC,CA8OrB"}