@hflin/cclin 0.1.0

package/dist/tui/state/chat_timeline.js.map

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

package/dist/tui/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @file TUI 专用视图类型 — 与 runtime types 解耦。
+ *
+ * 这些类型仅用于 UI 渲染层，不影响 runtime 逻辑。
+ * 参考 memo-code/packages/tui/src/types.ts 设计。
+ */
+export declare const TOOL_STATUS: {
+    readonly PENDING: "pending";
+    readonly EXECUTING: "executing";
+    readonly SUCCESS: "success";
+    readonly ERROR: "error";
+};
+export type ToolStatus = (typeof TOOL_STATUS)[keyof typeof TOOL_STATUS];
+export type ToolAction = {
+    tool: string;
+    input: unknown;
+};
+/** 单步视图（一次 LLM → 工具调用周期）。 */
+export type StepView = {
+    index: number;
+    assistantText: string;
+    thinking?: string;
+    action?: ToolAction;
+    observation?: string;
+    toolStatus?: ToolStatus;
+};
+/** 单轮对话视图。 */
+export type TurnView = {
+    index: number;
+    userInput: string;
+    steps: StepView[];
+    status?: 'running' | 'ok' | 'error' | 'cancelled';
+    errorMessage?: string;
+    finalText?: string;
+    sequence?: number;
+};
+export type SystemMessageTone = 'info' | 'warning' | 'error';
+export type SystemMessage = {
+    id: string;
+    title: string;
+    content: string;
+    sequence: number;
+    tone?: SystemMessageTone;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/tui/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tui/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,WAAW;;;;;CAKd,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAA;AAIvE,MAAM,MAAM,UAAU,GAAG;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;CACjB,CAAA;AAID,6BAA6B;AAC7B,MAAM,MAAM,QAAQ,GAAG;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,UAAU,CAAA;CAC1B,CAAA;AAID,cAAc;AACd,MAAM,MAAM,QAAQ,GAAG;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,GAAG,WAAW,CAAA;IACjD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAID,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;AAE5D,MAAM,MAAM,aAAa,GAAG;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,iBAAiB,CAAA;CAC3B,CAAA"}

package/dist/tui/types.js

@@ -0,0 +1,14 @@
+/**
+ * @file TUI 专用视图类型 — 与 runtime types 解耦。
+ *
+ * 这些类型仅用于 UI 渲染层，不影响 runtime 逻辑。
+ * 参考 memo-code/packages/tui/src/types.ts 设计。
+ */
+// ─── 工具状态 ─────────────────────────────────────────────────────────────
+export const TOOL_STATUS = {
+    PENDING: 'pending',
+    EXECUTING: 'executing',
+    SUCCESS: 'success',
+    ERROR: 'error',
+};
+//# sourceMappingURL=types.js.map

package/dist/tui/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tui/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yEAAyE;AAEzE,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACR,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,435 @@
+/**
+ * @file cclin agent 核心类型定义。
+ *
+ * Phase 1：仅包含 LLM 交互类型。
+ * 后续阶段将扩展（工具、钩子、会话等）。
+ */
+/** 对话角色。 */
+export type Role = 'system' | 'user' | 'assistant' | 'tool';
+/** 助手发出的结构化工具调用（OpenAI tool_calls 格式）。 */
+export type AssistantToolCall = {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+};
+/**
+ * 模型侧消息（按 role 区分的联合类型）。
+ *
+ * 使用 OpenAI chat-completion 消息格式，以便：
+ *   1. 可直接通过这些类型构建历史记录数组。
+ *   2. 以最少的映射转换为 OpenAI SDK 参数。
+ */
+export type ChatMessage = {
+    role: 'system';
+    content: string;
+} | {
+    role: 'user';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string;
+    /** DeepSeek 思考链（保留用于后续轮次）。 */
+    reasoning_content?: string;
+    /** 结构化工具调用列表（如有）。 */
+    tool_calls?: AssistantToolCall[];
+} | {
+    role: 'tool';
+    content: string;
+    /** 对应 assistant.tool_calls[*].id。 */
+    tool_call_id: string;
+    /** 工具名称（用于调试）。 */
+    name?: string;
+};
+/** Token 用量统计。 */
+export type TokenUsage = {
+    prompt: number;
+    completion: number;
+    total: number;
+};
+/** 文本内容块。 */
+export type TextBlock = {
+    type: 'text';
+    text: string;
+};
+/** 工具调用请求块。 */
+export type ToolUseBlock = {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: unknown;
+};
+/** LLM 响应中的内容块。 */
+export type ContentBlock = TextBlock | ToolUseBlock;
+/** 结构化的 LLM 响应。 */
+export type LLMResponse = {
+    content: ContentBlock[];
+    reasoning_content?: string;
+    stop_reason: 'end_turn' | 'tool_use' | 'max_tokens' | 'stop_sequence';
+    usage?: Partial<TokenUsage>;
+};
+/**
+ * LLM 调用函数签名。
+ *
+ * 接收对话历史，返回结构化响应。
+ * `onChunk` 保留用于后续流式支持。
+ */
+export type CallLLM = (messages: ChatMessage[], onChunk?: (chunk: string) => void) => Promise<LLMResponse>;
+/**
+ * 解析后的助手响应（action / final 二选一）。
+ *
+ * - `action`：工具调用请求，包含工具名和输入参数。
+ * - `final`：最终文本回答。
+ * - `thinking`：思考内容（当 action/final 混合了思考文本时）。
+ */
+export type ParsedAssistant = {
+    /** 工具调用：工具名 + 输入参数（第一个工具，保持向后兼容）。 */
+    action?: {
+        tool: string;
+        input: unknown;
+    };
+    /** 所有工具调用列表（Phase 3+，支持多工具并行调用）。 */
+    actions?: Array<{
+        tool: string;
+        input: unknown;
+    }>;
+    /** 最终回答文本。 */
+    final?: string;
+    /** 思考内容（混合输出时提取）。 */
+    thinking?: string;
+};
+/**
+ * 单步调试记录，用于回放和可观测性。
+ *
+ * 每次 LLM 调用 → 解析 → 工具执行为一个 step。
+ */
+export type AgentStepTrace = {
+    /** 步骤索引，从 0 开始。 */
+    index: number;
+    /** LLM 原始输出文本。 */
+    assistantText: string;
+    /** 解析后的 action/final 结构。 */
+    parsed: ParsedAssistant;
+    /** 工具执行结果（如有）。 */
+    observation?: string;
+    /** 本步骤的实际工具调用数量。 */
+    toolCallCount?: number;
+    /** 本步骤 token 统计。 */
+    tokenUsage?: Partial<TokenUsage>;
+};
+/** 单轮对话的状态码。 */
+export type TurnStatus = 'ok' | 'error' | 'cancelled';
+/**
+ * 单轮对话的执行结果。
+ *
+ * 包含最终输出、所有步骤轨迹、状态和 token 统计。
+ */
+export type TurnResult = {
+    /** 最终输出文本。 */
+    finalText: string;
+    /** 步骤轨迹数组。 */
+    steps: AgentStepTrace[];
+    /** 运行状态。 */
+    status: TurnStatus;
+    /** 错误信息（若有）。 */
+    errorMessage?: string;
+    /** 本轮 token 统计。 */
+    tokenUsage?: Partial<TokenUsage>;
+};
+/**
+ * 工具执行函数签名。
+ *
+ * Phase 2 使用 mock 实现，Phase 3 替换为真实工具注册表。
+ */
+export type ExecuteTool = (toolName: string, toolInput: unknown) => Promise<string>;
+/** JSON Schema 子集，用于描述工具输入参数。 */
+export type ToolInputSchema = {
+    type: 'object';
+    properties: Record<string, {
+        type: string;
+        description?: string;
+        items?: {
+            type: string;
+        };
+        enum?: string[];
+        default?: unknown;
+    }>;
+    required?: string[];
+};
+/** 工具执行结果。 */
+export type ToolResult = {
+    /** 输出文本。 */
+    output: string;
+    /** 是否为错误结果。 */
+    isError?: boolean;
+};
+/**
+ * 工具定义接口。
+ *
+ * 每个工具通过此接口描述自身：
+ *   - name / description：用于 LLM 理解工具用途
+ *   - inputSchema：JSON Schema 描述参数格式
+ *   - execute：实际执行逻辑
+ *   - isMutating：是否修改外部状态（用于安全分级）
+ */
+export type ToolDefinition = {
+    /** 工具唯一名称。 */
+    name: string;
+    /** 工具描述（给 LLM 阅读）。 */
+    description: string;
+    /** 输入参数的 JSON Schema 描述。 */
+    inputSchema: ToolInputSchema;
+    /** 是否会修改外部状态（文件、进程等）。 */
+    isMutating: boolean;
+    /** 执行工具。 */
+    execute: (input: Record<string, unknown>) => Promise<ToolResult>;
+};
+/** 审批策略：always=每次询问, once=同指纹本轮只问一次, session=整个会话有效。 */
+export type ApprovalPolicy = 'always' | 'once' | 'session';
+/** 用户审批决定。 */
+export type ApprovalDecision = 'approve' | 'deny';
+/** 审批检查结果（联合类型）。 */
+export type ApprovalCheckResult = {
+    needsApproval: false;
+} | {
+    needsApproval: true;
+    fingerprint: string;
+    reason: string;
+    toolName: string;
+    input: unknown;
+};
+/** 审批请求（传给 UI 回调）。 */
+export type ApprovalRequest = {
+    toolName: string;
+    input: unknown;
+    fingerprint: string;
+    reason: string;
+};
+/** 审批回调钩子。 */
+export type ApprovalHooks = {
+    /** 请求用户审批，返回用户决定。 */
+    requestApproval?: (request: ApprovalRequest) => Promise<ApprovalDecision>;
+};
+/** 工具调用请求。 */
+export type ToolAction = {
+    id: string;
+    name: string;
+    input: unknown;
+};
+/** 单个工具执行状态。 */
+export type ToolActionStatus = 'success' | 'approval_denied' | 'tool_not_found' | 'input_invalid' | 'execution_failed';
+/** 单个工具执行结果。 */
+export type ToolActionResult = {
+    actionId: string;
+    tool: string;
+    status: ToolActionStatus;
+    success: boolean;
+    observation: string;
+    durationMs: number;
+};
+/** 批量工具执行结果。 */
+export type ToolExecutionResult = {
+    results: ToolActionResult[];
+    combinedObservation: string;
+    hasRejection: boolean;
+};
+/** Token 计数器接口。 */
+export type TokenCounter = {
+    /** 使用的 tokenizer 模型名。 */
+    model: string;
+    /** 计算纯文本的 token 数。 */
+    countText: (text: string) => number;
+    /** 计算消息数组的 token 数（含 ChatML 开销）。 */
+    countMessages: (messages: ChatMessage[]) => number;
+    /** 释放 tokenizer 资源。 */
+    dispose: () => void;
+};
+/** 压缩触发原因。 */
+export type CompactReason = 'auto' | 'manual';
+/** 压缩结果状态。 */
+export type CompactStatus = 'success' | 'skipped' | 'failed';
+/** 压缩执行结果。 */
+export type CompactResult = {
+    /** 触发原因。 */
+    reason: CompactReason;
+    /** 执行状态。 */
+    status: CompactStatus;
+    /** 压缩前 token 数。 */
+    beforeTokens: number;
+    /** 压缩后 token 数。 */
+    afterTokens: number;
+    /** 阈值 token 数。 */
+    thresholdTokens: number;
+    /** 缩减百分比。 */
+    reductionPercent: number;
+    /** 生成的摘要文本（成功时）。 */
+    summary?: string;
+    /** 错误信息（失败时）。 */
+    errorMessage?: string;
+};
+/** 通用 Hook 回调签名（支持同步/异步）。 */
+export type AgentHookHandler<Payload> = (payload: Payload) => Promise<void> | void;
+/** Turn 开始时的 Hook 负载。 */
+export type TurnStartHookPayload = {
+    sessionId: string;
+    turn: number;
+    input: string;
+    history: ChatMessage[];
+};
+/** 工具调用（action）时的 Hook 负载。 */
+export type ActionHookPayload = {
+    sessionId: string;
+    turn: number;
+    step: number;
+    action: {
+        tool: string;
+        input: unknown;
+    };
+    thinking?: string;
+    history: ChatMessage[];
+};
+/** 工具执行结果（observation）的 Hook 负载。 */
+export type ObservationHookPayload = {
+    sessionId: string;
+    turn: number;
+    step: number;
+    tool: string;
+    observation: string;
+    history: ChatMessage[];
+};
+/** 最终回答的 Hook 负载。 */
+export type FinalHookPayload = {
+    sessionId: string;
+    turn: number;
+    finalText: string;
+    status: TurnStatus;
+    steps: AgentStepTrace[];
+    turnUsage: Partial<TokenUsage>;
+};
+/** 上下文 token 使用量报告的 Hook 负载。 */
+export type ContextUsageHookPayload = {
+    sessionId: string;
+    turn: number;
+    step: number;
+    promptTokens: number;
+    contextWindow: number;
+    thresholdTokens: number;
+    usagePercent: number;
+};
+/** 上下文压缩完成的 Hook 负载。 */
+export type ContextCompactedHookPayload = {
+    sessionId: string;
+    turn: number;
+    reason: CompactReason;
+    status: CompactStatus;
+    beforeTokens: number;
+    afterTokens: number;
+    thresholdTokens: number;
+    reductionPercent: number;
+    summary?: string;
+    errorMessage?: string;
+};
+/** 审批请求发出的 Hook 负载。 */
+export type ApprovalHookPayload = {
+    sessionId: string;
+    turn: number;
+    step: number;
+    request: ApprovalRequest;
+};
+/** 审批结果返回的 Hook 负载。 */
+export type ApprovalResponseHookPayload = {
+    sessionId: string;
+    turn: number;
+    step: number;
+    fingerprint: string;
+    decision: ApprovalDecision;
+};
+/** 标题生成的 Hook 负载（预留）。 */
+export type TitleGeneratedHookPayload = {
+    sessionId: string;
+    turn: number;
+    title: string;
+    originalPrompt: string;
+};
+/** Hook 集合：一次性注入的生命周期监听器。 */
+export type AgentHooks = {
+    onTurnStart?: AgentHookHandler<TurnStartHookPayload>;
+    onAction?: AgentHookHandler<ActionHookPayload>;
+    onObservation?: AgentHookHandler<ObservationHookPayload>;
+    onFinal?: AgentHookHandler<FinalHookPayload>;
+    onContextUsage?: AgentHookHandler<ContextUsageHookPayload>;
+    onContextCompacted?: AgentHookHandler<ContextCompactedHookPayload>;
+    onApprovalRequest?: AgentHookHandler<ApprovalHookPayload>;
+    onApprovalResponse?: AgentHookHandler<ApprovalResponseHookPayload>;
+    onTitleGenerated?: AgentHookHandler<TitleGeneratedHookPayload>;
+};
+/** 中间件：带可选名称的 Hook 集合，支持批量注册多个。 */
+export type AgentMiddleware = AgentHooks & {
+    name?: string;
+};
+/** 工具来源标识。 */
+export type ToolSource = 'native' | 'mcp';
+/** MCP Server 配置（stdio 传输）。 */
+export type MCPServerConfig = {
+    /** 启动命令（如 'node', 'npx'）。 */
+    command: string;
+    /** 命令参数列表。 */
+    args?: string[];
+    /** 环境变量覆盖（会与 process.env 合并）。 */
+    env?: Record<string, string>;
+};
+/** MCP 配置文件的完整格式。 */
+export type MCPConfigFile = {
+    mcpServers?: Record<string, MCPServerConfig>;
+};
+/** MCP 工具定义（继承 ToolDefinition，增加来源信息）。 */
+export type McpToolDefinition = ToolDefinition & {
+    /** 工具来源。 */
+    source: 'mcp';
+    /** 所属 MCP Server 名称。 */
+    serverName: string;
+    /** 在 MCP Server 上的原始工具名。 */
+    originalName: string;
+};
+/**
+ * 工具查询接口（ToolOrchestrator 的依赖抽象）。
+ *
+ * 让 ToolOrchestrator 同时支持 ToolRegistry 和 ToolRouter。
+ */
+export type ToolQueryable = {
+    /** 根据工具名获取工具定义。 */
+    get(name: string): ToolDefinition | undefined;
+};
+/** 历史事件类型标识。 */
+export type HistoryEventType = 'turn_start' | 'action' | 'observation' | 'final' | 'compact' | 'error';
+/** 单条历史事件（写入 JSONL）。 */
+export type HistoryEvent = {
+    /** ISO 时间戳。 */
+    ts: string;
+    /** 会话 ID。 */
+    sessionId: string;
+    /** 事件类型。 */
+    type: HistoryEventType;
+    /** 所属 turn 序号。 */
+    turn?: number;
+    /** 所属 step 序号。 */
+    step?: number;
+    /** 事件内容。 */
+    content?: string;
+    /** 角色。 */
+    role?: Role;
+    /** 扩展元数据。 */
+    meta?: Record<string, unknown>;
+};
+/** 历史写入接口。 */
+export type HistorySink = {
+    /** 追加一条事件。 */
+    append(event: HistoryEvent): Promise<void>;
+    /** 刷新缓冲区。 */
+    flush(): Promise<void>;
+    /** 关闭并释放资源。 */
+    close(): Promise<void>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * @file cclin agent 核心类型定义。
+ *
+ * Phase 1：仅包含 LLM 交互类型。
+ * 后续阶段将扩展（工具、钩子、会话等）。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/tokenizer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @file Token 计数器 — 基于 gpt-tokenizer 的本地 token 估算。
+ *
+ * Phase 6：为上下文压缩提供精确的 token 计数能力。
+ *
+ * 设计决策：
+ *   - 使用 gpt-tokenizer（纯 JS 实现）而非 @dqbd/tiktoken（需要 WASM）
+ *   - 按 ChatML 格式估算消息 token（每条消息 +4 overhead）
+ *   - 支持 assistant 含 tool_calls 和 reasoning_content 的复杂消息
+ */
+import type { TokenCounter } from '../types.js';
+/**
+ * 创建 Token 计数器。
+ *
+ * 返回的 TokenCounter 对象提供：
+ *   - countText：单段文本的 token 数
+ *   - countMessages：消息数组的 token 数（含 ChatML 开销）
+ *   - dispose：释放资源（当前为空操作，保留接口一致性）
+ */
+export declare function createTokenCounter(): TokenCounter;
+//# sourceMappingURL=tokenizer.d.ts.map

package/dist/utils/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../src/utils/tokenizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,aAAa,CAAA;AAgC5D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAuBjD"}

package/dist/utils/tokenizer.js

@@ -0,0 +1,71 @@
+/**
+ * @file Token 计数器 — 基于 gpt-tokenizer 的本地 token 估算。
+ *
+ * Phase 6：为上下文压缩提供精确的 token 计数能力。
+ *
+ * 设计决策：
+ *   - 使用 gpt-tokenizer（纯 JS 实现）而非 @dqbd/tiktoken（需要 WASM）
+ *   - 按 ChatML 格式估算消息 token（每条消息 +4 overhead）
+ *   - 支持 assistant 含 tool_calls 和 reasoning_content 的复杂消息
+ */
+import { encode } from 'gpt-tokenizer';
+/** 每条消息的 ChatML 包装开销（role + 分隔符）。 */
+const TOKENS_PER_MESSAGE = 4;
+/** 助手回复的起始标记开销。 */
+const TOKENS_FOR_ASSISTANT_PRIMING = 2;
+/**
+ * 将 ChatMessage 转换为用于 token 计数的文本负载。
+ *
+ * 不同 role 的消息结构不同，需要按实际发送给 API 的格式估算：
+ *   - assistant：可能含 reasoning_content 和 tool_calls
+ *   - tool：包含 tool_call_id 和 name
+ *   - system / user：直接取 content
+ */
+function messagePayloadForCounting(message) {
+    if (message.role === 'assistant') {
+        const reasoning = message.reasoning_content
+            ? `\n${message.reasoning_content}`
+            : '';
+        if (message.tool_calls?.length) {
+            return `${message.content}${reasoning}\n${JSON.stringify(message.tool_calls)}`;
+        }
+        return `${message.content}${reasoning}`;
+    }
+    if (message.role === 'tool') {
+        return `${message.content}\n${message.tool_call_id}\n${message.name ?? ''}`;
+    }
+    return message.content;
+}
+/**
+ * 创建 Token 计数器。
+ *
+ * 返回的 TokenCounter 对象提供：
+ *   - countText：单段文本的 token 数
+ *   - countMessages：消息数组的 token 数（含 ChatML 开销）
+ *   - dispose：释放资源（当前为空操作，保留接口一致性）
+ */
+export function createTokenCounter() {
+    const countText = (text) => {
+        if (!text)
+            return 0;
+        return encode(text).length;
+    };
+    const countMessages = (messages) => {
+        if (!messages.length)
+            return 0;
+        let total = 0;
+        for (const message of messages) {
+            total += TOKENS_PER_MESSAGE;
+            total += countText(messagePayloadForCounting(message));
+        }
+        total += TOKENS_FOR_ASSISTANT_PRIMING;
+        return total;
+    };
+    return {
+        model: 'cl100k_base',
+        countText,
+        countMessages,
+        dispose: () => { },
+    };
+}
+//# sourceMappingURL=tokenizer.js.map

package/dist/utils/tokenizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.js","sourceRoot":"","sources":["../../src/utils/tokenizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAGtC,qCAAqC;AACrC,MAAM,kBAAkB,GAAG,CAAC,CAAA;AAE5B,mBAAmB;AACnB,MAAM,4BAA4B,GAAG,CAAC,CAAA;AAEtC;;;;;;;GAOG;AACH,SAAS,yBAAyB,CAAC,OAAoB;IACnD,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,iBAAiB;YACvC,CAAC,CAAC,KAAK,OAAO,CAAC,iBAAiB,EAAE;YAClC,CAAC,CAAC,EAAE,CAAA;QACR,IAAI,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;YAC7B,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAA;QAClF,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,EAAE,CAAA;IAC3C,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,YAAY,KAAK,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,CAAA;IAC/E,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAA;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB;IAC9B,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE;QACvC,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,CAAA;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAA;IAC9B,CAAC,CAAA;IAED,MAAM,aAAa,GAAG,CAAC,QAAuB,EAAU,EAAE;QACtD,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO,CAAC,CAAA;QAC9B,IAAI,KAAK,GAAG,CAAC,CAAA;QACb,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,KAAK,IAAI,kBAAkB,CAAA;YAC3B,KAAK,IAAI,SAAS,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAA;QAC1D,CAAC;QACD,KAAK,IAAI,4BAA4B,CAAA;QACrC,OAAO,KAAK,CAAA;IAChB,CAAC,CAAA;IAED,OAAO;QACH,KAAK,EAAE,aAAa;QACpB,SAAS;QACT,aAAa;QACb,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;KACpB,CAAA;AACL,CAAC"}

package/dist/utils/tokenizer.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file Unit tests for token counter (Phase 6).
+ *
+ * Tests: createTokenCounter (countText, countMessages)
+ */
+export {};
+//# sourceMappingURL=tokenizer.test.d.ts.map

package/dist/utils/tokenizer.test.d.ts.map

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