mocode-ai 1.2.7 → 1.2.9

package/dist/foo.js

@@ -1,28 +0,0 @@
-/**
- * Parse a semver string into its numeric major/minor/patch triple.
- *
- * Accepts the two shapes the caller asked about:
- *   - "1.2.3"
- *   - "v2.0.0-rc.1"
- *
- * Prerelease / build metadata are accepted after the patch number, but only
- * the three numeric core components are returned. Anything that does not
- * match `^v?MAJOR.MINOR.PATCH(-prerelease)?(+build)?` raises an Error whose
- * message contains "invalid semver".
- */
-const SEMVER_RE = /^v?(\d+)\.(\d+)\.(\d+)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
-export function parseSemver(input) {
-    if (typeof input !== 'string') {
-        throw new Error(`invalid semver: not a string: ${String(input)}`);
-    }
-    const m = SEMVER_RE.exec(input);
-    if (!m) {
-        throw new Error(`invalid semver: ${JSON.stringify(input)}`);
-    }
-    // Numeric groups are guaranteed by the \d+ pattern; Number() won't produce NaN.
-    return {
-        major: Number(m[1]),
-        minor: Number(m[2]),
-        patch: Number(m[3]),
-    };
-}

package/dist/foo.test.js

@@ -1,12 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { parseSemver } from './foo.js';
-test('parseSemver parses plain x.y.z', () => {
-    assert.deepEqual(parseSemver('1.2.3'), { major: 1, minor: 2, patch: 3 });
-});
-test('parseSemver parses v-prefixed prerelease', () => {
-    assert.deepEqual(parseSemver('v2.0.0-rc.1'), { major: 2, minor: 0, patch: 0 });
-});
-test('parseSemver throws "invalid semver" on garbage input', () => {
-    assert.throws(() => parseSemver('not-a-version'), /invalid semver/);
-});

package/dist/index.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/llm/capabilities.d.ts

@@ -1,19 +0,0 @@
-/**
- * 模型能力检测:仅用于 /image 等多模态输入的友好提示。
- *
- * 策略 — 保守 + 显式白名单/黑名单:
- * - 命中 KNOWN_TEXT_ONLY_PREFIXES 任一前缀 → false(确定无视觉)
- * - 命中 KNOWN_VISION_FAMILIES 任一前缀 → true(确定有视觉)
- * - 其它(未识别 / 自定义代理 / 新发布模型)→ 默认 true(放行,让 API 拒收兜底)
- *
- * 理由:视觉能力在 2024 后已成新模型默认;自定义 OpenAI 代理常把上游视觉模型重命名;
- * 过度保守会误伤合法配置。
- */
-/**
- * 判断模型是否支持视觉(多模态 image_url)。
- * - 模型未配置(`config.model` 为空或 default 兜底字符串)→ true(不阻断,等 API 报错)
- * - 命中 KNOWN_TEXT_ONLY_PREFIXES 任一前缀 → false(确定无视觉,优先查,避免 gpt-4o-mini vs -search 系列名冲突)
- * - 命中 KNOWN_VISION_FAMILIES 任一前缀 → true
- * - 其它(未识别 / 自定义代理 / 新发布模型)→ true(保守放行)
- */
-export declare function modelSupportsVision(model: string): boolean;

package/dist/llm/index.d.ts

@@ -1,111 +0,0 @@
-import OpenAI from 'openai';
-/**
- * 运行时重建 OpenAI 客户端(/model 切换 baseURL/apiKey 后调)。
- * config.model 已在 chat() 每次读取(热切),但 client 的 baseURL/apiKey 是构造时固化的实例字段,
- * 改 config 后必须重建 client 才能让新 baseURL/apiKey 对后续请求生效。
- * 子 agent 复用本模块 chat(),故只此一处重建即全链路生效。
- */
-export declare function reconfigureClient(): void;
-/**
- * 判定一个 chat 失败是否值得重试。
- * 用户中断(signal.aborted / AbortError / APIUserAbortError)始终返回 false,避免退避中把中断吞了。
- * 4xx(除 429)全不重试 —— 这是客户端请求错,重试只会再错一次。
- */
-export declare function isRetryableError(err: unknown, signal?: AbortSignal): boolean;
-/** 从 OpenAI APIError.headers 解析 Retry-After(秒);不支持或缺失返回 undefined。封顶 RETRY_MAX_MS。 */
-export declare function getRetryAfterMs(err: unknown): number | undefined;
-/** 第 N 次失败后等多久(retryAfterMs 有就用它,否则指数;再加 ±RETRY_JITTER 抖动)。 */
-export declare function computeBackoff(attempt: number, retryAfterMs?: number): number;
-type CreateImpl = (body: Record<string, unknown>, opts: {
-    signal?: AbortSignal;
-} | undefined) => Promise<AsyncIterable<unknown>>;
-/** 仅供单测用:覆盖 chat() 内部实际调用的 create 桩。生产代码不要碰。 */
-export declare function __setChatCreateImpl(impl: CreateImpl | null): void;
-export type ChatMessage = OpenAI.Chat.Completions.ChatCompletionMessageParam;
-/** 把内部工具定义转成 OpenAI 的 tool 格式 */
-export declare const chatTools: OpenAI.Chat.Completions.ChatCompletionTool[];
-/**
- * plan 模式用的受限工具 schema:剔除写盘 / 命令 / 记忆写入类(getPlanDisabledTools())。
- * 模型在 plan 模式下只看得到只读工具 → 调不到会改文件的工具。runAgent 在 plan 模式传给 chat()。
- *
- * 注意:planChatTools 是顶层 const(模块初始化时一次性求值);若运行时 /memory_switch 关闭
- * 记忆,这里仍是按当前 isMemoryEnabled() 算出的快照——重启 REPL 才完全生效。
- */
-export declare const planChatTools: OpenAI.Chat.Completions.ChatCompletionTool[];
-export interface ToolCallRef {
-    id: string;
-    name: string;
-    arguments: string;
-}
-/** 一次 chat 调用返回的真实 token 用量(include_usage 时由后端给出)。 */
-export interface ChatUsage {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-    /** prompt 中命中 cache 的 token 数(后端未报则为 0)。
-     *  计费时这部分按折扣价(DeepSeek 命中 $0.014/M vs 未命中 $0.14/M,差 10×)或免费
-     *  ——成本监控要从 promptTokens 中剔除,否则高估一个数量级。
-     *  多 provider 字段名不一致,见 extractUsageExtras。 */
-    cachedTokens: number;
-    /** completion 中"思考"消耗的 token(CoT 模型:OpenAI o1 / DeepSeek R1 / GLM-Z1)。
-     *  仍按 completion 全价计费,但对调试 thinking 长度有用。 */
-    reasoningTokens: number;
-}
-/**
- * 多 provider 兼容的 cache / reasoning 字段提取。
- * 不同后端报 cached 字段名差异巨大,这里按"最常见的几种"顺序 probe,
- * 首个合法非负数字即用(0 也算合法 —— cache miss 是合法状态,不是"无数据")。
- * 字段全缺 → 0,UI 不会显示任何额外标注(零行为变化)。
- *
- * 已实测 / 字段名已知:
- *   - OpenAI / Azure / 多数 OpenAI 兼容中转:
- *       prompt_tokens_details.cached_tokens
- *   - DeepSeek(含 R1):
- *       prompt_cache_hit_tokens(扁平,顶层)
- *   - Anthropic Claude:
- *       cache_read_input_tokens
- *   - Moonshot Kimi / GLM-4.6 / Qwen:同 OpenAI 标准
- *   - Ollama / 本地 vLLM / 其它:无 usage details → 0(零行为变化)
- *
- * reasoning 字段(CoT 模型):
- *   - OpenAI o1 / DeepSeek R1 / GLM-Z1:
- *       completion_tokens_details.reasoning_tokens
- *   - 其它(个别):reasoning_tokens(顶层)
- */
-export declare function extractUsageExtras(usage: unknown): {
-    cachedTokens: number;
-    reasoningTokens: number;
-};
-export interface ChatResult {
-    content: string | null;
-    toolCalls: ToolCallRef[];
-    usage?: ChatUsage;
-}
-/** 流式回调:文本增量 / 首个 tool_call 工具名。 */
-export interface StreamHandlers {
-    onText?: (delta: string) => void;
-    /** 首次得知某个 tool_call 的工具名时回调——模型开始生成工具调用参数(可能很长,如 write_file 大段内容),调用方可据此启「生成中」spinner,避免内容区干等。 */
-    onToolCall?: (name: string) => void;
-}
-/**
- * 流式调一次 LLM:增量回调文本,内部累加 tool_calls 片段。
- * tool_calls 跨 chunk 按 index 累加(id / name / arguments 拼接)。
- * include_usage 时末尾 chunk 携带 usage,先读再 continue(末尾 chunk 无 delta)。
- *
- * 包了一层重试:429/5xx/timeout/网络错按指数退避重试(默认 4 次),400/401/用户中断立即抛。
- * 重试由 chat() 统一管,chatOnce() 只负责单次请求,职责单一便于单测。
- */
-export declare function chat(messages: ChatMessage[], handlers?: StreamHandlers, signal?: AbortSignal, 
-/** 覆盖默认工具 schema;plan 模式传 planChatTools(只读子集),缺省=全量 chatTools。 */
-toolsOverride?: OpenAI.Chat.Completions.ChatCompletionTool[]): Promise<ChatResult>;
-/** 粗估一段文本的 token 数。CJK≈1/字,其余≈1/4字,向上取整。 */
-export declare function estimateTokens(text: string): number;
-/** 估算多模态 content 的 token(text parts + 固定每图 85);不把 base64 走 estimateTokens,避免 1MB 图算成 25 万 token。 */
-export declare function contentTokens(content: unknown): number;
-/** 估算单条消息的 token 数:结构开销 + content + tool_calls 参数。 */
-export declare function messageTokens(m: ChatMessage): number;
-/** 估算整段 messages 的 token 数(不含工具 schema,含 priming 常数)。 */
-export declare function estimateMessagesTokens(messages: ChatMessage[]): number;
-/** 估算 chatTools(工具 schema)占用的一次性 token,带缓存。 */
-export declare function estimateToolSchemaTokens(): number;
-export {};

package/dist/memory/discover.d.ts

@@ -1,15 +0,0 @@
-export interface MemoryFile {
-    path: string;
-    content: string;
-}
-/**
- * 返回要查找的 MOCODE.md 路径列表,按「远→近」顺序(合并时近的在后,更突出):
- * 全局 ~/.mocode/MOCODE.md → 项目级从根到 cwd 逐级 MOCODE.md。
- * 向上遍历 cwd 到根收集 [cwd..root],反转为 [root..cwd](远→近),前拼全局。
- */
-export declare function resolveMemoryFiles(): string[];
-/**
- * 读取所有存在的 MOCODE.md,返回 { path, content }(content 已 trim)。
- * 全程静默容错(不存在 / 读失败 → 跳过,不抛),风格对齐 skills/discover.ts 与 session/persist.ts。
- */
-export declare function loadMemoryFiles(): MemoryFile[];

package/dist/memory/index.d.ts

@@ -1,13 +0,0 @@
-export { buildMemoryIndexSection, loadAll, gcMemories, type MemoryEntry, type MemoryIndexItem, type MemoryType, type MemoryStatus, type MemoryScope, } from './store.js';
-export { kickoffReflection, drainMemoryBackground, getLastReflectResult, clearLastReflectResult, snapshotTranscript, formatReflectResult, runReflection, type ReflectResult, } from './reflect.js';
-/**
- * 合并全局 + 项目各级 MOCODE.md(远→近拼接,各段空行分隔),超 MAX_MEMORY_CHARS 截断 + 提示。
- * 懒加载(首次调用触发扫描;启动期 repl 调一次)。无 MOCODE.md 返空串。
- */
-export declare function loadMemory(): string;
-/**
- * 拼进系统提示的 memory 段(Tier-1 MOCODE.md);无 memory 返空串(零行为变化)。
- * 记忆子系统总开关关闭(isMemoryEnabled()==false)直接返空串:
- * 提示词、Memory Index 段都不进 — 配合 tools/builtins 把 memory_* 工具屏蔽。
- */
-export declare function buildMemorySection(): string;

package/dist/memory/reflect.d.ts

@@ -1,34 +0,0 @@
-import { type ChatMessage } from '../llm/index.js';
-export interface ReflectResult {
-    ts: string;
-    saves: number;
-    updates: number;
-    forgets: number;
-    gcDecayed: number;
-    gcCapped: number;
-    gcGced: number;
-    error?: string;
-}
-/**
- * 同步拍平最近 K 条对话(跳过 history[0] 大系统提示)。每条裁到 600 字符、总体裁到 6000,
- * 控制反思 prompt 体积。在 kickoff 调用前同步取快照,异步 pass 用这份文本,不再读 history。
- */
-export declare function snapshotTranscript(history: ChatMessage[], K: number): string;
-/**
- * 跑一次反思:chat() 空 handlers(静默)→ 解析 JSON → 经 store 落地 → gcMemories。
- * 解析失败整 pass 放弃(不部分落地)。store 调用全同步,落地是一个原子块。
- * 60s 超时(AbortSignal.timeout)防 exit 时 drain 挂死。
- */
-export declare function runReflection(transcript: string, signal?: AbortSignal): Promise<ReflectResult>;
-/** 摘要串(供 repl flush):存N 改N 忘N;有错误附上。 */
-export declare function formatReflectResult(r: ReflectResult): string;
-/**
- * fire-and-forget 触发反思。已有在飞任务 / autoReflect 关闭 / 记忆子系统总开关关闭 → 跳过。
- * 记忆关闭时反思毫无意义(没有可存的地方),且会误打日志、误弹摘要,故一并短路。
- * repl 轮末调:与下一轮 agent 并发跑,不阻塞。
- */
-export declare function kickoffReflection(transcript: string): void;
-/** 退出前等在飞反思收尾(startRepl 尾调;Ctrl+C 走 SIGINT 直退不等)。 */
-export declare function drainMemoryBackground(): Promise<void>;
-export declare function getLastReflectResult(): ReflectResult | null;
-export declare function clearLastReflectResult(): void;

package/dist/memory/store.d.ts

@@ -1,124 +0,0 @@
-export type MemoryType = 'decision' | 'fact' | 'pitfall' | 'reference' | 'feedback';
-export type MemoryStatus = 'active' | 'superseded' | 'archived';
-export type MemoryScope = 'project' | 'global';
-export interface MemoryEntry {
-    id: string;
-    type: MemoryType;
-    name: string;
-    summary: string;
-    body: string;
-    createdAt: string;
-    updatedAt: string;
-    lastRecalledAt: string | null;
-    recallCount: number;
-    status: MemoryStatus;
-    supersededBy: string | null;
-    pinned: boolean;
-    scope: MemoryScope;
-    source: {
-        session?: string;
-        turn?: number;
-    } | null;
-    lastUpdateReason?: string;
-}
-/** 索引项(无 body,不进 history 也不占 token)。 */
-export interface MemoryIndexItem {
-    id: string;
-    name: string;
-    summary: string;
-    type: MemoryType;
-    status: MemoryStatus;
-}
-/** 加载全部(global + project),按文件归一化 scope(防旧条目缺字段 / 字段错)。 */
-export declare function loadAll(): MemoryEntry[];
-export interface SaveInput {
-    name: string;
-    summary: string;
-    body: string;
-    type?: MemoryType;
-    pinned?: boolean;
-    scope?: MemoryScope;
-    source?: {
-        session?: string;
-        turn?: number;
-    } | null;
-}
-export type SaveResult = {
-    ok: true;
-    id: string;
-} | {
-    ok: false;
-    exists: string;
-};
-/** 新建:id 全局唯一(跨两文件),撞库返 exists 让工具层提示用 memory_update。 */
-export declare function saveEntry(input: SaveInput): SaveResult;
-export interface SearchOpts {
-    type?: MemoryType;
-    status?: MemoryStatus | 'any';
-    limit?: number;
-}
-/** 关键词搜索:多词子串匹配(name 权重最高)。命中即 bump recallCount/lastRecalledAt 写回(遗忘衰减依据)。 */
-export declare function searchEntries(query: string, opts?: SearchOpts): MemoryEntry[];
-/** 索引(无 body、不 bump recall)。 */
-export declare function listEntries(opts?: {
-    type?: MemoryType;
-    status?: MemoryStatus | 'any';
-}): MemoryIndexItem[];
-export interface UpdatePatch {
-    name?: string;
-    summary?: string;
-    body?: string;
-    reason?: string;
-    pinned?: boolean;
-}
-export type UpdateResult = {
-    ok: true;
-} | {
-    ok: false;
-    notFound: true;
-};
-/** 原地改:id 不变(name 可改 → 但 id 仍是旧 slug,故 name 改不会触发重 slug);记 lastUpdateReason;pinned 可切换。 */
-export declare function updateEntry(id: string, patch: UpdatePatch): UpdateResult;
-export type ForgetResult = {
-    ok: true;
-    mode: string;
-} | {
-    ok: false;
-    notFound: true;
-} | {
-    ok: false;
-    pinned: true;
-};
-/** 归档(默认,可复活)/ 硬删;pinned 拒删。 */
-export declare function forgetEntry(id: string, mode?: 'archive' | 'delete'): ForgetResult;
-export interface GcResult {
-    decayed: number;
-    capped: number;
-    gced: number;
-}
-/**
- * 遗忘策略(全同步,后台调):
- *  ① archived 超 GC_DAYS → 硬删;
- *  ② active + !pinned + (lastRecalledAt|createdAt) 早于 DECAY_DAYS → archived;
- *  ③ active 数 > MAX_ACTIVE → 按 recallCount 低 × 最近未召回久 淘汰到 archived。
- * pinned 豁免一切自动衰减。写回两文件(均按 scope 过滤)。
- */
-export declare function gcMemories(): GcResult;
-/**
- * active 条目按 updatedAt 降序,封顶 MAX_INDEX_ENTRIES,只注 id/name/summary/type。
- * 无 active 返空串(零行为变化)。body 不注入——按需 memory_search 取。
- *
- * 索引策略(省 token):不全量塞进每轮 systemPrompt。
- *  - pinned 永远包含(pinned = 用户明确想长期保留)
- *  - recallCount ≥ 1 包含(被引用过,价值已验证)
- *  - 否则仅当 (lastRecalledAt|createdAt) 近 RECENT_MS(=DECAY_DAYS×2) 内
- * 排序:pinned 先 → recallCount 降 → updatedAt 降。
- * 封顶 MAX_INDEX_ENTRIES;尾部标 hidden 数量,引导用 memory_list/memory_search 兜底。
- * 真正「陈旧」被滤掉时也明示(让 LLM 知道有内容存在但被策略隐藏,而不是误以为空)。
- *
- * memoryEnabled=false 时(记忆子系统总开关关闭)直接返空串:Memory Index 段
- * 不进系统提示,LLM 看不到工具使用提示;配合 tools/builtins 屏蔽 memory_* 工具,
- * 实现「关闭时零侵入」(默认行为)。传参由 repl 的 buildSystemMessage 在拼装前调
- * isMemoryEnabled() 注入(本文件是叶子,避免直接引 config 起环)。
- */
-export declare function buildMemoryIndexSection(memoryEnabled?: boolean): string;

package/dist/pet/bridge.d.ts

@@ -1,73 +0,0 @@
-import WebSocket from 'ws';
-import type { PetState, PetStateMeta, SkinListMessage } from './protocol.js';
-/** 默认端口;MOCODE_PET_PORT 环境变量覆盖(design.md 默认假设)。 */
-export declare const DEFAULT_PET_PORT = 47821;
-/**
- * 探测本地端口是否已有 WS server 监听并可完成一次 WS 握手。
- * 前置条件:port 为合法端口号。
- * 后置条件:返回 true 表示 <timeoutMs> 内握手成功(桌宠已在跑);false 表示超时/拒绝连接。
- * 无副作用(探测用的临时连接在返回前关闭)。
- */
-export declare function probePort(port: number, timeoutMs?: number): Promise<boolean>;
-/**
- * 拉起独立 Electron 桌宠进程(detached,不随当前 mocode 进程退出而杀死)。
- * 前置条件:调用方已确认端口未被占用(避免重复 spawn)。
- * 后置条件:
- *   - resolve() 表示 spawn 系统调用成功发出(不代表桌宠已可连接,调用方需配合 connectWithBackoff)。
- *   - reject(err) 表示可执行文件不可解析(mocode-pet-app 未安装/安装失败)——降级路径。
- */
-export declare function spawnPetProcess(): Promise<void>;
-/**
- * 按退避序列重试连接,直到成功或耗尽重试次数。
- * 前置条件:retryDelaysMs 非空、单调(本设计取 [200,400,800,1600,3200])。
- * 后置条件:
- *   - resolve(ws) 表示某次尝试内 probePort/connect 成功。
- *   - reject(err) 表示所有尝试均失败,err 汇总最后一次失败原因。
- * 循环不变量:每次尝试前 attempts < retryDelaysMs.length;每次失败后 attempts 严格 +1。
- */
-export declare function connectWithBackoff(port: number, retryDelaysMs?: number[]): Promise<WebSocket>;
-/**
- * 发送一次状态消息(经节流:与上次发送状态相同则跳过)。
- * 前置条件:无(未连接时静默 no-op,不抛错、不阻塞 agent 主循环)。
- * 后置条件:若 state !== lastSentState,构造并发送一条合法 StateMessage;否则无副作用。
- */
-export declare function sendState(state: PetState, meta?: PetStateMeta): void;
-/** 当前是否已建立活跃连接。 */
-export declare function isConnected(): boolean;
-/** 主动断开连接(best-effort 发 bye 后 close code=1000)。 */
-export declare function disconnect(): void;
-/**
- * 请求桌宠进程整体退出(方案C:CLI 侧退出入口;托盘图标是桌面侧的另一入口,见 packages/pet-app/src/main.ts)。
- * 不要求本连接是活跃连接——任何已连接的 mocode 进程都可以关闭桌宠。
- * 前置条件:当前进程已建立连接(未连接则先尝试探测端口直连,再发 shutdown)。
- * 后置条件:发送 shutdown 消息后主动断开本地连接;不等待桌宠进程确认退出(best-effort,不阻塞 REPL)。
- */
-export declare function killPetProcess(): Promise<{
-    ok: boolean;
-    reason?: string;
-}>;
-/**
- * 请求当前可用皮肤列表(供 /pet skin 菜单展示)。
- * 前置条件:当前进程已建立连接(未连接则先尝试探测端口直连;若桌宠未运行则失败)。
- * 后置条件:resolve 桌宠回复的 SkinListMessage;超时(2s 内无回复)reject。
- */
-export declare function listSkins(): Promise<SkinListMessage>;
-/**
- * 请求桌宠切换皮肤(选宠物)。
- * 前置条件:当前进程已建立连接(未连接则静默 no-op,与 sendState 的降级策略一致)。
- * 后置条件:已连接时发送 set_skin 消息;未连接时不抛错、无副作用。
- */
-export declare function setSkin(skinId: string): void;
-/**
- * /pet 命令入口。
- * 前置条件:REPL 主循环已初始化(不要求 agent 正在运行)。
- * 后置条件:
- *   - 若调用前无活跃连接:调用后 either 已建立连接(connected=true)
- *     或已尝试 spawn+重试全部失败(connected=false,附错误原因)。
- *   - 若调用前有活跃连接:调用后连接已关闭(connected=false)。
- * 不抛异常(所有失败路径转为返回值,供 REPL 渲染提示行)。
- */
-export declare function togglePet(): Promise<{
-    connected: boolean;
-    reason?: string;
-}>;

package/dist/pet/protocol.d.ts

@@ -1,83 +0,0 @@
-/** 桌宠状态集合。子 agent(task 工具派生)永不产生这些状态——只在主 agent hooks 组装处广播。 */
-export type PetState = 'idle' | 'thinking' | 'speaking' | 'tool_call' | 'done' | 'aborted' | 'error' | 'waiting_human';
-/** 全部合法状态值(供运行时校验,如 Set 成员判断)。 */
-export declare const PET_STATES: readonly PetState[];
-/** 状态负载:随 state 消息携带的可选元数据。 */
-export interface PetStateMeta {
-    /** 仅 tool_call 状态携带:当前调用的工具名(如 "write_file")。 */
-    toolName?: string;
-    /** 仅 error 状态携带:简短错误摘要(截断,不含敏感路径/密钥)。 */
-    errorMessage?: string;
-}
-/** 每个 mocode 进程生成一次,进程存活期间稳定。 */
-export type ClientId = string;
-export interface HelloMessage {
-    type: 'hello';
-    clientId: ClientId;
-    pid: number;
-    cwd: string;
-    ts: number;
-}
-export interface StateMessage {
-    type: 'state';
-    clientId: ClientId;
-    state: PetState;
-    meta?: PetStateMeta;
-    ts: number;
-}
-export interface PingMessage {
-    type: 'ping';
-    ts: number;
-}
-export interface ByeMessage {
-    type: 'bye';
-    clientId: ClientId;
-    ts: number;
-}
-/** 主动请求桌宠进程整体退出(与 disconnect 不同:disconnect 只断开本连接,shutdown 让桌宠 app.quit()）。
- *  不要求发送方是当前活跃连接——任何已连接的 mocode 进程都可以关闭桌宠(见 Requirement 补充:关闭桌宠)。 */
-export interface ShutdownMessage {
-    type: 'shutdown';
-    clientId: ClientId;
-    ts: number;
-}
-/** 请求切换桌宠皮肤(选宠物)。skinId 对应 assets/pets/manifest.json 里的 id,空字符串/'default' 表示恢复默认 mascot.svg。 */
-export interface SetSkinMessage {
-    type: 'set_skin';
-    clientId: ClientId;
-    skinId: string;
-    ts: number;
-}
-/** 请求当前可用皮肤列表(触发 server 回复 SkinListMessage)。 */
-export interface ListSkinsMessage {
-    type: 'list_skins';
-    ts: number;
-}
-export type ClientMessage = HelloMessage | StateMessage | PingMessage | ByeMessage | ShutdownMessage | SetSkinMessage | ListSkinsMessage;
-export interface WelcomeMessage {
-    type: 'welcome';
-    isActive: boolean;
-    ts: number;
-}
-export interface PongMessage {
-    type: 'pong';
-    ts: number;
-}
-/** 皮肤列表(供 /pet skin 菜单展示)。桌宠进程回复,ids 对应 assets/pets/ 下的候选素材。 */
-export interface SkinListMessage {
-    type: 'skin_list';
-    skins: {
-        id: string;
-        name: string;
-    }[];
-    currentSkinId: string;
-    ts: number;
-}
-export type ServerMessage = WelcomeMessage | PongMessage | SkinListMessage;
-/** 判断值是否为合法 PetState(供消息校验,非法值丢弃不崩)。 */
-export declare function isValidPetState(v: unknown): v is PetState;
-/** 校验并解析一条原始 JSON 字符串为 ClientMessage;失败(JSON 非法/缺字段/type 未知)返回 null。
- *  永不抛错——调用方(bridge/server)据此静默丢弃畸形消息,不断开连接。 */
-export declare function parseClientMessage(raw: string): ClientMessage | null;
-/** 校验并解析一条原始 JSON 字符串为 ServerMessage;失败返回 null(同上,永不抛错)。 */
-export declare function parseServerMessage(raw: string): ServerMessage | null;

package/dist/pet/state.d.ts

@@ -1,28 +0,0 @@
-import type { AgentHooks } from '../agent/core.js';
-import type { PetState } from './protocol.js';
-import * as bridge from './bridge.js';
-/** AgentHooks 方法名(供 deriveState 的 event 参数类型与穷举测试)。 */
-export type AgentHookEventName = 'onStepStart' | 'onText' | 'onToolCall' | 'onToolStart' | 'onToolResult' | 'onDone' | 'onAbort' | 'onMaxSteps' | 'onChatDone' | 'onToolBatchEnd' | 'onNoReply';
-/** deriveState 的可选参数(按事件类型而异)。 */
-export interface DeriveStateArgs {
-    /** onToolCall / onToolStart 的工具名。 */
-    toolName?: string;
-    /** onToolResult 的输出(用于判断是否报错:以"错误"开头,参考 agent/index.ts writeToolResult)。 */
-    toolOutput?: string;
-}
-/**
- * 纯函数:给定当前 hook 事件与其参数,推导下一个 PetState。
- * 前置条件:event 是 AgentHooks 定义的方法名之一。
- * 后置条件:返回值 ∈ PetState 枚举;对同一 (event, args) 输入,任意调用时刻返回值相同(确定性,可测)。
- * 不依赖调用历史之外的隐藏状态——纯函数式转移表。
- */
-export declare function deriveState(event: AgentHookEventName, args?: DeriveStateArgs): PetState;
-/**
- * 把 AgentHooks 事件流映射为 PetState 变化并调用 bridge.sendState。
- * 前置条件:传入的 sender 已存在(可能尚未连接,sendState 内部自行处理未连接情形——no-op)。
- * 后置条件:返回的 AgentHooks 对象的每个方法都是纯粹的"状态推导 + 转发",
- *   不修改 core.ts 的任何行为、不影响现有 TUI hooks 的调用结果。
- */
-export declare function createPetHooks(sender?: {
-    sendState: typeof bridge.sendState;
-}): AgentHooks;

package/dist/plan/active.d.ts

@@ -1,23 +0,0 @@
-import type { Plan } from './store.js';
-export interface ActivePlanSnapshot {
-    id: string;
-    title: string;
-    status: Plan['status'];
-    done: number;
-    total: number;
-}
-type Listener = (snap: ActivePlanSnapshot | null) => void;
-/** 取当前活跃 plan(完整对象,工具用)。无 → null。 */
-export declare function getActivePlan(): Plan | null;
-/** 设活跃 plan。同一 id 重复设也走 listener(repl 借此刷 status 行——即使内容未变,显式刷新有助)。 */
-export declare function setActivePlan(plan: Plan | null): void;
-/** 清活跃 plan(plan finish/abandon 后由 repl/todolist 调)。 */
-export declare function clearActivePlan(): void;
-/** 注册活跃 plan 变更监听器。返注销函数(不常用,模式 listener 一次性常驻)。 */
-export declare function onActivePlanChange(cb: Listener): () => void;
-/** 是否有活跃 plan(in_progress 状态)。finished/abandoned 不算「活跃」。 */
-export declare function hasActivePlan(): boolean;
-/** 给 status 行用的极简摘要(避免调用方读 Plan 全字段)。无 → 空串。 */
-/** 状态行 chip 用的短摘要(无 ANSI 颜色,由 layout 上色)。maxWidth 默认 56,留 room 给右段。 */
-export declare function getActivePlanSummary(maxWidth?: number): string;
-export {};

package/dist/plan/active.js

@@ -1,45 +0,0 @@
-// 活跃 plan 进程级缓存:单 plan/会话的内存状态 + 变更通知。
-//
-// 仿 src/agent/mode.ts 形态:零依赖、setter/getter/listener,不反向引用业务。
-// todo 工具每次改 plan → 调 setActivePlan(newPlan) → listener 触发(repl 刷 status 行 + history[0])。
-// store 仍是文件源(本缓存与之可能短暂不一致——以文件为准,缓存仅供快速读)。
-import { renderPlanChip } from './store.js';
-let active = null;
-const listeners = new Set();
-/** 取当前活跃 plan(完整对象,工具用)。无 → null。 */
-export function getActivePlan() {
-    return active;
-}
-/** 设活跃 plan。同一 id 重复设也走 listener(repl 借此刷 status 行——即使内容未变,显式刷新有助)。 */
-export function setActivePlan(plan) {
-    active = plan;
-    const snap = plan ? toSnapshot(plan) : null;
-    for (const cb of listeners) {
-        try {
-            cb(snap);
-        }
-        catch { /* listener 抛错不阻断其他 listener */ }
-    }
-}
-/** 清活跃 plan(plan finish/abandon 后由 repl/todolist 调)。 */
-export function clearActivePlan() {
-    setActivePlan(null);
-}
-/** 注册活跃 plan 变更监听器。返注销函数(不常用,模式 listener 一次性常驻)。 */
-export function onActivePlanChange(cb) {
-    listeners.add(cb);
-    return () => listeners.delete(cb);
-}
-/** 是否有活跃 plan(in_progress 状态)。finished/abandoned 不算「活跃」。 */
-export function hasActivePlan() {
-    return active !== null && active.status === 'in_progress';
-}
-/** 给 status 行用的极简摘要(避免调用方读 Plan 全字段)。无 → 空串。 */
-/** 状态行 chip 用的短摘要(无 ANSI 颜色,由 layout 上色)。maxWidth 默认 56,留 room 给右段。 */
-export function getActivePlanSummary(maxWidth = 56) {
-    return renderPlanChip(active, maxWidth);
-}
-function toSnapshot(p) {
-    const done = p.steps.filter((s) => s.status === 'done' || s.status === 'skipped').length;
-    return { id: p.id, title: p.title, status: p.status, done, total: p.steps.length };
-}

package/dist/plan/index.d.ts

@@ -1,13 +0,0 @@
-export { type Plan, type PlanStep, type PlanStatus, type StepStatus, plansDir, archiveDir, planPath, ensurePlansDir, ensureArchiveDir, newPlanId, parsePlan, serializePlan, readPlan, writePlan, deletePlan, deletePlanAnywhere, updatePlan, listPlans, archivePlan, unarchivePlan, renderPlanForLLM, renderPlanChip, } from './store.js';
-export { type ActivePlanSnapshot, getActivePlan, setActivePlan, clearActivePlan, onActivePlanChange, hasActivePlan, getActivePlanSummary, } from './active.js';
-/**
- * 拼给 systemPrompt 注入的活跃 plan 摘要段。
- *  - 无活跃 plan → 空串(repl 直接跳过拼接,systemPrompt 长度不变)。
- *  - 有 → 紧凑 markdown(目标 + 步骤 checkbox + 进度日志末 5 条),header + 内容。
- *
- * 触发:setActivePlan 后由 repl listener 调;也供 buildSystemMessage 直接同步取(repl 入口)。
- * 上限:超 MAX_ACTIVE_PLAN_CHARS 截到尾部(罕见,plan 文件本身就小)。
- */
-export declare function buildActivePlanSection(): string;
-/** 注入 systemPrompt 的活跃 plan 摘要上限(字符)。 */
-export declare const MAX_ACTIVE_PLAN_CHARS = 3000;