hyacinth-ai 0.9.6

package/dist/ui/tui-formatters.js

@@ -0,0 +1,145 @@
+const REPLACEMENT_CHAR_RE = /\uFFFD/g;
+const MAX_TOKEN_CHARS = 32;
+const LONG_TOKEN_RE = /\S{33,}/g;
+const LONG_TOKEN_TEST_RE = /\S{33,}/;
+const BINARY_LINE_REPLACEMENT_THRESHOLD = 12;
+const URL_PREFIX_RE = /^(https?:\/\/|file:\/\/)/i;
+const WINDOWS_DRIVE_RE = /^[a-zA-Z]:[\\/]/;
+const FILE_LIKE_RE = /^[a-zA-Z0-9._-]+$/;
+const EDGE_PUNCTUATION_RE = /^[`"'([{<]+|[`"')\]}>.,:;!?]+$/g;
+const ALPHANUMERIC_RE = /[A-Za-z0-9]/;
+const TOKENISH_MIN_LENGTH = 24;
+const RTL_SCRIPT_RE = /[\u0590-\u08ff\ufb1d-\ufdff\ufe70-\ufefc]/;
+const BIDI_CONTROL_RE = /[\u202a-\u202e\u2066-\u2069]/;
+const RTL_ISOLATE_START = '\u2067';
+const RTL_ISOLATE_END = '\u2069';
+const FENCED_CODE_RE = /(```|~~~)[^\n]*\n[\s\S]*?\n\1[^\n]*/g;
+const INLINE_CODE_RE = /(`+)(?:(?!\1).)+?\1/g;
+const ANSI_CSI_PATTERN = '\\x1b\\[[\\x20-\\x3f]*[\\x40-\\x7e]';
+const ANSI_OSC_PATTERN = '\\x1b\\][^\\x07\\x1b]*(?:\\x1b\\\\|\\x07)';
+const ANSI_CSI_REGEX = new RegExp(ANSI_CSI_PATTERN, 'g');
+const ANSI_OSC_REGEX = new RegExp(ANSI_OSC_PATTERN, 'g');
+function stripAnsi(input) {
+    return input.replace(ANSI_OSC_REGEX, '').replace(ANSI_CSI_REGEX, '');
+}
+function hasControlChars(text) {
+    for (const char of text) {
+        const code = char.charCodeAt(0);
+        const isAsciiControl = code <= 0x1f && code !== 0x09 && code !== 0x0a && code !== 0x0d;
+        const isC1Control = code >= 0x7f && code <= 0x9f;
+        if (isAsciiControl || isC1Control)
+            return true;
+    }
+    return false;
+}
+function stripControlChars(text) {
+    if (!hasControlChars(text))
+        return text;
+    let sanitized = '';
+    for (const char of text) {
+        const code = char.charCodeAt(0);
+        const isAsciiControl = code <= 0x1f && code !== 0x09 && code !== 0x0a && code !== 0x0d;
+        const isC1Control = code >= 0x7f && code <= 0x9f;
+        if (!isAsciiControl && !isC1Control)
+            sanitized += char;
+    }
+    return sanitized;
+}
+function chunkToken(token, maxChars) {
+    if (token.length <= maxChars)
+        return [token];
+    const chunks = [];
+    for (let i = 0; i < token.length; i += maxChars) {
+        chunks.push(token.slice(i, i + maxChars));
+    }
+    return chunks;
+}
+function isCopySensitiveToken(token) {
+    const coreToken = token.replace(EDGE_PUNCTUATION_RE, '');
+    const candidate = coreToken || token;
+    if (URL_PREFIX_RE.test(candidate))
+        return true;
+    if (candidate.startsWith('/') || candidate.startsWith('~/') || candidate.startsWith('./') || candidate.startsWith('../'))
+        return true;
+    if (WINDOWS_DRIVE_RE.test(candidate) || candidate.startsWith('\\\\'))
+        return true;
+    if (candidate.includes('/') || candidate.includes('\\'))
+        return true;
+    if (FILE_LIKE_RE.test(candidate) && (candidate.includes('_') || candidate.includes('-') || candidate.includes('.')))
+        return true;
+    if (candidate.length >= TOKENISH_MIN_LENGTH && /[a-z]/i.test(candidate) && /\d/.test(candidate))
+        return true;
+    return false;
+}
+function normalizeLongTokenForDisplay(token) {
+    if (isCopySensitiveToken(token))
+        return token;
+    if (!ALPHANUMERIC_RE.test(token))
+        return token;
+    return chunkToken(token, MAX_TOKEN_CHARS).join(' ');
+}
+function partitionByRegex(text, re) {
+    const parts = [];
+    let lastIndex = 0;
+    for (const match of text.matchAll(re)) {
+        const start = match.index ?? 0;
+        if (start > lastIndex)
+            parts.push({ kind: 'prose', text: text.slice(lastIndex, start) });
+        parts.push({ kind: 'code', text: match[0] });
+        lastIndex = start + match[0].length;
+    }
+    if (lastIndex < text.length)
+        parts.push({ kind: 'prose', text: text.slice(lastIndex) });
+    return parts;
+}
+function transformOutsideCode(text, transform) {
+    const fenced = partitionByRegex(text, FENCED_CODE_RE);
+    return fenced
+        .map((seg) => {
+        if (seg.kind === 'code')
+            return seg.text;
+        const inline = partitionByRegex(seg.text, INLINE_CODE_RE);
+        return inline.map((s) => (s.kind === 'code' ? s.text : transform(s.text))).join('');
+    })
+        .join('');
+}
+function redactBinaryLikeLine(line) {
+    const replacementCount = (line.match(REPLACEMENT_CHAR_RE) || []).length;
+    if (replacementCount >= BINARY_LINE_REPLACEMENT_THRESHOLD && replacementCount * 2 >= line.length) {
+        return '[binary data omitted]';
+    }
+    return line;
+}
+function isolateRtlLine(line) {
+    if (!RTL_SCRIPT_RE.test(line) || BIDI_CONTROL_RE.test(line))
+        return line;
+    return `${RTL_ISOLATE_START}${line}${RTL_ISOLATE_END}`;
+}
+function applyRtlIsolation(text) {
+    if (!RTL_SCRIPT_RE.test(text))
+        return text;
+    return text.split('\n').map((line) => isolateRtlLine(line)).join('\n');
+}
+export function sanitizeRenderableText(text) {
+    if (!text)
+        return text;
+    const hasAnsi = text.includes('\u001b');
+    const hasReplacementChars = text.includes('\uFFFD');
+    const hasLongTokens = LONG_TOKEN_TEST_RE.test(text);
+    const hasControls = hasControlChars(text);
+    if (!hasAnsi && !hasReplacementChars && !hasLongTokens && !hasControls) {
+        return applyRtlIsolation(text);
+    }
+    const withoutAnsi = hasAnsi ? stripAnsi(text) : text;
+    const withoutControlChars = hasControls ? stripControlChars(withoutAnsi) : withoutAnsi;
+    const redacted = hasReplacementChars
+        ? withoutControlChars.split('\n').map((line) => redactBinaryLikeLine(line)).join('\n')
+        : withoutControlChars;
+    const tokenSafe = LONG_TOKEN_TEST_RE.test(redacted)
+        ? transformOutsideCode(redacted, (segment) => LONG_TOKEN_TEST_RE.test(segment)
+            ? segment.replace(LONG_TOKEN_RE, normalizeLongTokenForDisplay)
+            : segment)
+        : redacted;
+    return applyRtlIsolation(tokenSafe);
+}
+//# sourceMappingURL=tui-formatters.js.map

package/dist/ui/user-message.d.ts

@@ -0,0 +1,5 @@
+import { MarkdownMessageComponent } from './markdown-message.js';
+export declare class UserMessageComponent extends MarkdownMessageComponent {
+    constructor(text: string);
+}
+//# sourceMappingURL=user-message.d.ts.map

package/dist/ui/user-message.js

@@ -0,0 +1,11 @@
+import { theme } from './theme.js';
+import { MarkdownMessageComponent } from './markdown-message.js';
+export class UserMessageComponent extends MarkdownMessageComponent {
+    constructor(text) {
+        super(text, 1, {
+            bgColor: (line) => theme.userBg(line),
+            color: (line) => theme.userText(line),
+        });
+    }
+}
+//# sourceMappingURL=user-message.js.map

package/dist/update/check.d.ts

@@ -0,0 +1,8 @@
+import type { VersionInfo } from './types.js';
+interface CheckResult {
+    version: VersionInfo;
+    downloadUrl: string;
+}
+export declare function checkForUpdate(repo: string, currentVersion: string, onStatus: (msg: string) => void): Promise<CheckResult | null>;
+export {};
+//# sourceMappingURL=check.d.ts.map

package/dist/update/check.js

@@ -0,0 +1,28 @@
+export async function checkForUpdate(repo, currentVersion, onStatus) {
+    const apiUrl = `https://api.github.com/repos/${repo}/releases/latest`;
+    onStatus(`查询最新版: ${apiUrl}`);
+    try {
+        const res = await fetch(apiUrl);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        const release = await res.json();
+        const latest = release.tag_name.replace(/^v/, '');
+        const zip = release.assets?.find(a => a.name.endsWith('.zip'));
+        if (!zip)
+            throw new Error('No .zip asset found');
+        const needsUpdate = latest !== currentVersion;
+        return {
+            version: {
+                current: currentVersion,
+                latest,
+                publishedAt: release.published_at,
+                needsUpdate,
+            },
+            downloadUrl: zip.browser_download_url,
+        };
+    }
+    catch (err) {
+        throw new Error(`版本检查失败: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/update/config.d.ts

@@ -0,0 +1,6 @@
+import type { UpdateConfig } from './types.js';
+declare const CONFIG_PATH: string;
+export declare function loadConfig(): UpdateConfig;
+export declare function saveConfig(cfg: UpdateConfig): void;
+export { CONFIG_PATH };
+//# sourceMappingURL=config.d.ts.map

package/dist/update/config.js

@@ -0,0 +1,18 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const CONFIG_PATH = path.join(os.homedir(), '.agent', 'update.json');
+export function loadConfig() {
+    try {
+        return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveConfig(cfg) {
+    fs.mkdirSync(path.dirname(CONFIG_PATH), { recursive: true });
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2));
+}
+export { CONFIG_PATH };
+//# sourceMappingURL=config.js.map

package/dist/update/download.d.ts

@@ -0,0 +1,3 @@
+import type { DownloadProgress } from './types.js';
+export declare function downloadWithProgress(url: string, destDir: string, onProgress: (p: DownloadProgress) => void): Promise<string>;
+//# sourceMappingURL=download.d.ts.map

package/dist/update/download.js

@@ -0,0 +1,27 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export async function downloadWithProgress(url, destDir, onProgress) {
+    fs.mkdirSync(destDir, { recursive: true });
+    const zipPath = path.join(destDir, 'release.zip');
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`HTTP ${res.status}`);
+    const contentLength = parseInt(res.headers.get('content-length') ?? '0', 10);
+    const reader = res.body.getReader();
+    const chunks = [];
+    let downloaded = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        chunks.push(value);
+        downloaded += value.length;
+        if (contentLength > 0) {
+            onProgress({ percent: Math.round((downloaded / contentLength) * 100), downloaded, total: contentLength });
+        }
+    }
+    const buf = Buffer.concat(chunks);
+    fs.writeFileSync(zipPath, buf);
+    return zipPath;
+}
+//# sourceMappingURL=download.js.map

package/dist/update/index.d.ts

@@ -0,0 +1,6 @@
+export { loadConfig, saveConfig } from './config.js';
+export { checkForUpdate } from './check.js';
+export { downloadWithProgress } from './download.js';
+export { findExtractedDir, installUpdate } from './install.js';
+export type { UpdateConfig, VersionInfo, DownloadProgress } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/update/index.js

@@ -0,0 +1,5 @@
+export { loadConfig, saveConfig } from './config.js';
+export { checkForUpdate } from './check.js';
+export { downloadWithProgress } from './download.js';
+export { findExtractedDir, installUpdate } from './install.js';
+//# sourceMappingURL=index.js.map

package/dist/update/install.d.ts

@@ -0,0 +1,3 @@
+export declare function findExtractedDir(tmpDir: string): string;
+export declare function installUpdate(extractedDir: string, installDir: string, onStatus: (msg: string) => void): void;
+//# sourceMappingURL=install.d.ts.map

package/dist/update/install.js

@@ -0,0 +1,33 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+export function findExtractedDir(tmpDir) {
+    const entries = fs.readdirSync(tmpDir).filter(e => e !== 'release.zip');
+    if (entries.length !== 1)
+        return tmpDir;
+    const sub = path.join(tmpDir, entries[0]);
+    return fs.statSync(sub).isDirectory() ? sub : tmpDir;
+}
+export function installUpdate(extractedDir, installDir, onStatus) {
+    const newDist = path.join(extractedDir, 'dist');
+    const newPkg = path.join(extractedDir, 'package.json');
+    if (!fs.existsSync(newDist) || !fs.existsSync(newPkg)) {
+        throw new Error('下载的包缺少 dist/ 或 package.json');
+    }
+    // 替换 dist
+    const dstDist = path.join(installDir, 'dist');
+    fs.rmSync(dstDist, { recursive: true, force: true });
+    fs.cpSync(newDist, dstDist, { recursive: true });
+    // 检查依赖变化
+    const oldPkg = JSON.parse(fs.readFileSync(path.join(installDir, 'package.json'), 'utf-8'));
+    const newPkgJson = JSON.parse(fs.readFileSync(newPkg, 'utf-8'));
+    if (JSON.stringify(oldPkg.dependencies) !== JSON.stringify(newPkgJson.dependencies)) {
+        fs.cpSync(newPkg, path.join(installDir, 'package.json'));
+        onStatus('依赖有变化，重装中...');
+        execSync('pnpm install --prod --no-frozen-lockfile', { cwd: installDir, stdio: 'inherit' });
+    }
+    else {
+        onStatus('依赖无变化，跳过重装');
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/update/types.d.ts

@@ -0,0 +1,16 @@
+export interface UpdateConfig {
+    repo?: string;
+    sourcePath?: string;
+}
+export interface VersionInfo {
+    current: string;
+    latest: string;
+    publishedAt: string;
+    needsUpdate: boolean;
+}
+export interface DownloadProgress {
+    percent: number;
+    downloaded: number;
+    total: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/update/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/utils/diff.d.ts

@@ -0,0 +1,9 @@
+export type DiffLineKind = 'header' | 'context' | 'add' | 'del';
+export interface DiffLine {
+    kind: DiffLineKind;
+    text: string;
+    oldLine?: number;
+    newLine?: number;
+}
+export declare function computeDiff(oldText: string, newText: string, filePath: string): DiffLine[];
+//# sourceMappingURL=diff.d.ts.map

package/dist/utils/diff.js

@@ -0,0 +1,45 @@
+/**
+ * 文件 diff 计算工具
+ * 使用 diff 包做行级 unified diff，供 TUI 渲染，不进入模型 context
+ */
+import { diffLines } from 'diff';
+const MAX_LINES = 50; // 超过此行数折叠
+const PREVIEW_LINES = 20; // 折叠时预览前 N 行
+export function computeDiff(oldText, newText, filePath) {
+    const result = [];
+    // normalize line endings
+    const oldNorm = oldText.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    const newNorm = newText.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    const changes = diffLines(oldNorm, newNorm, { ignoreNewlineAtEof: true });
+    let oldLine = 1;
+    let newLine = 1;
+    let totalNonHeader = 0;
+    for (const change of changes) {
+        // remove trailing newline then split
+        const raw = change.value.endsWith('\n') ? change.value.slice(0, -1) : change.value;
+        const lines = raw.split('\n').map(l => l.trimEnd()); // strip \r and trailing spaces
+        for (const line of lines) {
+            totalNonHeader++;
+            if (change.added) {
+                result.push({ kind: 'add', text: line, newLine: newLine++ });
+            }
+            else if (change.removed) {
+                result.push({ kind: 'del', text: line, oldLine: oldLine++ });
+            }
+            else {
+                result.push({ kind: 'context', text: line, oldLine: oldLine++, newLine: newLine++ });
+            }
+        }
+    }
+    // 折叠
+    if (totalNonHeader > MAX_LINES) {
+        const preview = result.slice(0, PREVIEW_LINES);
+        preview.push({
+            kind: 'context',
+            text: `… 还有 ${totalNonHeader - PREVIEW_LINES} 行（折叠）`,
+        });
+        return preview;
+    }
+    return result;
+}
+//# sourceMappingURL=diff.js.map

package/dist/utils/misc.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 通用工具函数 — 各模块共用的零依赖 helper。
+ *
+ * 提取自 dependency/analyzer.ts、memory/session.ts、gateway/cli.ts 中的重复实现。
+ */
+/** 将工作目录路径归一化为项目标识（projectKey） */
+export declare function toProjectKey(cwd: string): string;
+/** 从消息 content 中提取文本（跳过 thinking/tool_use 等非文本块） */
+export declare function extractTextContent(content: unknown): string;
+/** 日期格式化为 YYYY-MM-DD */
+export declare function formatDate(date?: Date): string;
+//# sourceMappingURL=misc.d.ts.map

package/dist/utils/misc.js

@@ -0,0 +1,34 @@
+/**
+ * 通用工具函数 — 各模块共用的零依赖 helper。
+ *
+ * 提取自 dependency/analyzer.ts、memory/session.ts、gateway/cli.ts 中的重复实现。
+ */
+/** 将工作目录路径归一化为项目标识（projectKey） */
+export function toProjectKey(cwd) {
+    const normalized = cwd.replace(/[/\\]+/g, '-');
+    return normalized.replace(/^[-]+|[-]+$/g, '').replace(/:/g, '');
+}
+/** 从消息 content 中提取文本（跳过 thinking/tool_use 等非文本块） */
+export function extractTextContent(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .filter((c) => c.type === 'text')
+            .map((c) => c.text)
+            .join('');
+    }
+    if (content && typeof content === 'object' && content.type === 'text') {
+        return content.text;
+    }
+    return '';
+}
+/** 日期格式化为 YYYY-MM-DD */
+export function formatDate(date) {
+    const d = date ?? new Date();
+    const yyyy = d.getFullYear();
+    const mm = String(d.getMonth() + 1).padStart(2, '0');
+    const dd = String(d.getDate()).padStart(2, '0');
+    return `${yyyy}-${mm}-${dd}`;
+}
+//# sourceMappingURL=misc.js.map

package/dist/world-engine/agent.d.ts

@@ -0,0 +1,41 @@
+import type { Message, ToolDefinition, StreamEvent } from '../types.js';
+import type { WorldStore } from './store.js';
+/** 只依赖结构化接口，不耦合具体 provider 实现（保持模块可移植） */
+export interface ProviderLike {
+    createStream(messages: Message[], tools?: ToolDefinition[], signal?: AbortSignal): AsyncIterable<StreamEvent>;
+}
+export interface ModelRouterLike {
+    getProvider(role: string): ProviderLike | null;
+}
+/** 角色身份（区分主角/陪伴角色/NPC 的关键） */
+export interface CharacterIdentity {
+    name: string;
+    desc?: string;
+    /** 其他称呼（名字/物种/昵称等），都指同一角色，如主角 name=天角兽, aliases=[孑遗] */
+    aliases?: string[];
+}
+export interface AgentIdentities {
+    /** 用户扮演的角色 */
+    protagonist?: CharacterIdentity;
+    /** 陪伴角色（LLM 的 soul） */
+    companion?: CharacterIdentity;
+}
+export declare class WorldAgent {
+    private readonly store;
+    private readonly modelRouter;
+    private readonly identities;
+    constructor(store: WorldStore, modelRouter: ModelRouterLike | null, identities?: AgentIdentities);
+    /** 主角/陪伴的动态身份补充（旁路学到的种族/别名/留痕），叠加到配置身份上 */
+    private characterOverlay;
+    /** observe 用的系统提示词 = 身份前言 + 世界维护规则 */
+    private observeSystem;
+    /** narrate 用的系统提示词 = 身份提示 + 旁白规则 */
+    private narrateSystem;
+    /** 主角 + 陪伴角色的名字（用于筛选相关社会关系） */
+    private mainCharacterNames;
+    narrate(pendingNarration?: string): Promise<string | undefined>;
+    observe(userInput: string, mainOutput: string): Promise<void>;
+    /** 观察对话的工具循环（最多 MAX_OBSERVE_ITERS 轮） */
+    private runToolLoop;
+}
+//# sourceMappingURL=agent.d.ts.map