@linghun/tui 0.1.0

package/dist/terminal-readiness-presenter.d.ts

@@ -0,0 +1,131 @@
+import type { Language, PermissionMode } from "@linghun/shared";
+export type ReadinessItemStatus = "pass" | "partial" | "fail" | "unknown" | "stale" | "blocked";
+export type TerminalReadinessItem = {
+    id: string;
+    label: string;
+    status: ReadinessItemStatus;
+    summary: string;
+    nextAction: string;
+};
+export type TerminalReadinessView = {
+    projectPath: string;
+    provider: string;
+    model: string;
+    endpointProfile: string;
+    providerLiveVerified: boolean;
+    permissionMode: PermissionMode;
+    language: Language;
+    index: {
+        status: string;
+        changedFiles?: number | null;
+        staleHint?: string;
+    };
+    cache: {
+        latestHitRate: number | null;
+        compacted: boolean;
+        workspaceSnapshot: string;
+    };
+    memory: {
+        projectRules: "found" | "missing" | "unreadable";
+        candidates: number;
+        accepted: number;
+    };
+    mcp: {
+        enabled: boolean;
+        servers: number;
+        tools: number;
+        errors: number;
+    };
+    background: {
+        total: number;
+        running: number;
+        blocked: number;
+    };
+    verification?: {
+        status: string;
+        summary: string;
+        unverified: number;
+        risk: number;
+    };
+    providerFailure?: {
+        code: string;
+        provider: string;
+        model: string;
+        endpointProfile: string;
+        summary: string;
+    };
+    freshness: {
+        webSourceEvidence: "present" | "missing";
+    };
+    runtimePath?: {
+        path: string;
+        kind: "main" | "fallback";
+        canClaimMature: boolean;
+        degradedReason?: string;
+    };
+    verificationLevel?: {
+        level: string;
+        canClaimPass: boolean;
+        canClaimMature: boolean;
+        upgradeBlocked: boolean;
+        blockReason?: string;
+    };
+    startupPath?: {
+        entryKind: string;
+        isVerifiedCurrent: boolean;
+        staleRisk: boolean;
+        staleReason?: string;
+    };
+    projectDoctor: {
+        status: ReadinessItemStatus;
+        packageManager: string;
+        scripts: string[];
+        configFiles: string[];
+        ciFiles: string[];
+        projectRules: "found" | "missing" | "unreadable";
+        checks: string[];
+        unknown: string[];
+    };
+    sourceDrift: {
+        status: ReadinessItemStatus;
+        checked: string[];
+        issues: string[];
+        nextAction: string;
+    };
+    contextPicker: {
+        status: ReadinessItemStatus;
+        refs: string[];
+        evidenceKinds: string[];
+        indexFreshness: "fresh" | "stale" | "unknown";
+    };
+    rollbackCoach: {
+        status: ReadinessItemStatus;
+        changedFiles: number;
+        untrackedFiles: number;
+        checkpoints: number;
+        gitStatus: "clean" | "dirty" | "unavailable";
+        mode: "advisory-only";
+        nextAction: string;
+    };
+    costPreview: {
+        status: ReadinessItemStatus;
+        level: "light" | "medium" | "heavy" | "unknown";
+        labels: string[];
+        nextAction: string;
+    };
+    problems: TerminalProblemView[];
+};
+export type TerminalProblemView = {
+    source: "verification" | "provider" | "background" | "freshness" | "index" | "project" | "drift" | "context" | "rollback" | "cost";
+    severity: "info" | "warning" | "error";
+    summary: string;
+    nextAction: string;
+    detailRef?: string;
+};
+export declare function formatTerminalReadinessDoctor(view: TerminalReadinessView, options?: {
+    showAll?: boolean;
+}): string;
+export declare function formatTerminalReadinessStatus(view: TerminalReadinessView): string;
+export declare function formatTerminalProblemsPanel(view: TerminalReadinessView): string;
+export declare function createReadinessItems(view: TerminalReadinessView): TerminalReadinessItem[];
+//# sourceMappingURL=terminal-readiness-presenter.d.ts.map

package/dist/terminal-readiness-presenter.d.ts.map

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

package/dist/terminal-readiness-presenter.js

@@ -0,0 +1,16 @@
+import {
+  createReadinessItems,
+  formatTerminalProblemsPanel,
+  formatTerminalReadinessDoctor,
+  formatTerminalReadinessStatus
+} from "./chunk-ZYSN7AWW.js";
+import "./chunk-CRW3636S.js";
+import "./chunk-CRSLDQOA.js";
+import "./chunk-VIBENDE3.js";
+import "./chunk-HAEU6OTS.js";
+export {
+  createReadinessItems,
+  formatTerminalProblemsPanel,
+  formatTerminalReadinessDoctor,
+  formatTerminalReadinessStatus
+};

package/dist/terminal-readiness-runtime.d.ts

@@ -0,0 +1,5 @@
+import type { TuiContext } from "./index.js";
+import type { TerminalReadinessView } from "./terminal-readiness-presenter.js";
+export declare function createTerminalReadinessView(context: TuiContext): TerminalReadinessView;
+export declare function createVerificationLevelForReadiness(context: TuiContext): NonNullable<TerminalReadinessView["verificationLevel"]>;
+//# sourceMappingURL=terminal-readiness-runtime.d.ts.map

package/dist/terminal-readiness-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-readiness-runtime.d.ts","sourceRoot":"","sources":["../src/terminal-readiness-runtime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,KAAK,EAAuB,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAMpG,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,UAAU,GAAG,qBAAqB,CAkGtF;AAuBD,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,UAAU,GAClB,WAAW,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,CAAC,CAmEzD"}

package/dist/terminal-readiness-runtime.js

@@ -0,0 +1,15 @@
+import {
+  createTerminalReadinessView,
+  createVerificationLevelForReadiness
+} from "./chunk-PBIPV4LD.js";
+import "./chunk-CRSLDQOA.js";
+import "./chunk-VIBENDE3.js";
+import "./chunk-ZJK25VFP.js";
+import "./chunk-3LT6OWQ2.js";
+import "./chunk-2YL5VKJ5.js";
+import "./chunk-EBACIBJP.js";
+import "./chunk-OZMX3E35.js";
+export {
+  createTerminalReadinessView,
+  createVerificationLevelForReadiness
+};

package/dist/terminal-setup-runtime.d.ts

@@ -0,0 +1,34 @@
+/**
+ * /terminal-setup command runtime.
+ * Detects the current terminal environment and outputs keybinding configuration guidance.
+ * Pure runtime module — no React/Ink dependencies.
+ */
+export type TerminalEnvironment = {
+    terminal: string;
+    shell: string;
+    os: "windows" | "macos" | "linux";
+    supportsUnicode: boolean;
+    supports256Color: boolean;
+    supportsTrueColor: boolean;
+    supportsBracketedPaste: boolean;
+    supportsMouseEvents: boolean;
+};
+export type SetupRecommendation = {
+    category: "keybinding" | "font" | "color" | "general";
+    title: string;
+    description: string;
+    priority: "high" | "medium" | "low";
+};
+export type ConfigSnippet = {
+    target: string;
+    content: string;
+    instruction: string;
+};
+export type SetupGuidance = {
+    environment: TerminalEnvironment;
+    recommendations: SetupRecommendation[];
+    configSnippets: ConfigSnippet[];
+};
+export declare function detectTerminalEnvironment(): TerminalEnvironment;
+export declare function generateSetupGuidance(env: TerminalEnvironment): SetupGuidance;
+//# sourceMappingURL=terminal-setup-runtime.d.ts.map

package/dist/terminal-setup-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-setup-runtime.d.ts","sourceRoot":"","sources":["../src/terminal-setup-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IAClC,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sBAAsB,EAAE,OAAO,CAAC;IAChC,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,mBAAmB,CAAC;IACjC,eAAe,EAAE,mBAAmB,EAAE,CAAC;IACvC,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC,CAAC;AAuGF,wBAAgB,yBAAyB,IAAI,mBAAmB,CA8B/D;AAoOD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,mBAAmB,GAAG,aAAa,CAe7E"}

package/dist/terminal-setup-runtime.js

@@ -0,0 +1,257 @@
+// src/terminal-setup-runtime.ts
+function detectOS() {
+  switch (process.platform) {
+    case "win32":
+      return "windows";
+    case "darwin":
+      return "macos";
+    default:
+      return "linux";
+  }
+}
+function detectTerminal() {
+  const env = process.env;
+  if (env.WT_SESSION) return "windows-terminal";
+  const termProgram = (env.TERM_PROGRAM ?? "").toLowerCase();
+  if (termProgram === "vscode") return "vscode";
+  if (termProgram === "iterm.app") return "iterm2";
+  if (env.GNOME_TERMINAL_SERVICE) return "gnome-terminal";
+  if (env.TERMINAL_EMULATOR?.includes("JetBrains")) return "jetbrains";
+  if (env.KITTY_WINDOW_ID) return "kitty";
+  if (env.ALACRITTY_LOG) return "alacritty";
+  return "unknown";
+}
+function detectShell() {
+  const env = process.env;
+  if (env.POWERSHELL_DISTRIBUTION_CHANNEL) return "pwsh";
+  if (env.PSModulePath) {
+    if (env.PSModulePath.includes("PowerShell\\7")) return "pwsh";
+    return "powershell";
+  }
+  const shell = env.SHELL ?? "";
+  if (shell.endsWith("/zsh") || shell.endsWith("/zsh.exe")) return "zsh";
+  if (shell.endsWith("/bash") || shell.endsWith("/bash.exe")) return "bash";
+  if (shell.endsWith("/fish") || shell.endsWith("/fish.exe")) return "fish";
+  if (env.ComSpec && !env.SHELL && detectOS() === "windows") return "cmd";
+  return "unknown";
+}
+function detectColorSupport() {
+  const env = process.env;
+  const colorTerm = (env.COLORTERM ?? "").toLowerCase();
+  const term = (env.TERM ?? "").toLowerCase();
+  const trueColor = colorTerm === "truecolor" || colorTerm === "24bit" || term.includes("24bit") || term.includes("direct");
+  const supports256 = trueColor || term.includes("256color") || colorTerm === "yes" || !!env.WT_SESSION;
+  return { supports256, trueColor };
+}
+function detectUnicodeSupport(terminal, os) {
+  if (terminal === "windows-terminal" || terminal === "vscode" || terminal === "iterm2" || terminal === "kitty" || terminal === "alacritty") {
+    return true;
+  }
+  if (os === "macos") return true;
+  const lang = (process.env.LANG ?? "").toLowerCase();
+  if (lang.includes("utf-8") || lang.includes("utf8")) return true;
+  if (os === "windows" && terminal === "unknown") return false;
+  return true;
+}
+function detectTerminalEnvironment() {
+  const os = detectOS();
+  const terminal = detectTerminal();
+  const shell = detectShell();
+  const { supports256, trueColor } = detectColorSupport();
+  const supportsUnicode = detectUnicodeSupport(terminal, os);
+  const supportsBracketedPaste = terminal !== "unknown" || os !== "windows";
+  const supportsMouseEvents = terminal === "windows-terminal" || terminal === "iterm2" || terminal === "kitty" || terminal === "alacritty" || terminal === "gnome-terminal" || terminal === "vscode";
+  return {
+    terminal,
+    shell,
+    os,
+    supportsUnicode,
+    supports256Color: supports256,
+    supportsTrueColor: trueColor,
+    supportsBracketedPaste,
+    supportsMouseEvents
+  };
+}
+function buildKeybindingRecommendations(env) {
+  const recs = [];
+  if (env.terminal === "windows-terminal") {
+    recs.push({
+      category: "keybinding",
+      title: "Unbind Ctrl+C from copy in Windows Terminal",
+      description: "Windows Terminal binds Ctrl+C to copy by default, which interferes with SIGINT. Use Ctrl+Shift+C for copy and free Ctrl+C for process interruption.",
+      priority: "high"
+    });
+    recs.push({
+      category: "keybinding",
+      title: "Add Ctrl+Shift+V for paste",
+      description: "Bind Ctrl+Shift+V to paste so Ctrl+V remains available for terminal apps.",
+      priority: "medium"
+    });
+  }
+  if (env.terminal === "vscode") {
+    recs.push({
+      category: "keybinding",
+      title: "Override Ctrl+R in VS Code terminal",
+      description: "VS Code captures Ctrl+R for recent files. Add a keybinding override to pass Ctrl+R through to the terminal for shell reverse-search.",
+      priority: "high"
+    });
+    recs.push({
+      category: "keybinding",
+      title: "Override Ctrl+G in VS Code terminal",
+      description: "VS Code captures Ctrl+G for go-to-line. Override it to pass through when the terminal panel is focused.",
+      priority: "medium"
+    });
+  }
+  return recs;
+}
+function buildFontRecommendations(env) {
+  const recs = [];
+  recs.push({
+    category: "font",
+    title: "Use a CJK-compatible monospace font",
+    description: "For optimal CJK character rendering, use Noto Sans Mono CJK, Cascadia Code, or Sarasa Mono as your terminal font. These fonts provide correct glyph widths for Chinese/Japanese/Korean characters.",
+    priority: "medium"
+  });
+  if (!env.supportsUnicode) {
+    recs.push({
+      category: "font",
+      title: "Enable Unicode support",
+      description: "Your terminal may not fully support Unicode/emoji rendering. Consider switching to Windows Terminal or setting your locale to UTF-8.",
+      priority: "high"
+    });
+  }
+  return recs;
+}
+function buildColorRecommendations(env) {
+  const recs = [];
+  if (!env.supportsTrueColor) {
+    recs.push({
+      category: "color",
+      title: "Enable true color support",
+      description: "Your terminal does not advertise true color (24-bit) support. Set COLORTERM=truecolor in your shell profile if your terminal supports it.",
+      priority: "low"
+    });
+  }
+  return recs;
+}
+function buildGeneralRecommendations(env) {
+  const recs = [];
+  if (env.os === "windows" && env.terminal === "unknown") {
+    recs.push({
+      category: "general",
+      title: "Upgrade to Windows Terminal",
+      description: "The legacy Windows console (conhost) has limited Unicode, color, and input support. Windows Terminal provides a much better experience for Linghun.",
+      priority: "high"
+    });
+  }
+  if (env.shell === "cmd") {
+    recs.push({
+      category: "general",
+      title: "Consider using PowerShell or pwsh",
+      description: "cmd.exe has limited scripting and environment support. PowerShell 7+ (pwsh) offers better integration with modern tools.",
+      priority: "medium"
+    });
+  }
+  return recs;
+}
+function buildConfigSnippets(env) {
+  const snippets = [];
+  if (env.terminal === "windows-terminal") {
+    snippets.push({
+      target: "Windows Terminal settings.json",
+      content: JSON.stringify(
+        {
+          actions: [
+            {
+              command: { action: "copy", singleLine: false },
+              keys: "ctrl+shift+c"
+            },
+            { command: "paste", keys: "ctrl+shift+v" },
+            { command: "unbound", keys: "ctrl+c" },
+            { command: "unbound", keys: "ctrl+v" }
+          ]
+        },
+        null,
+        2
+      ),
+      instruction: 'Open Settings (Ctrl+,) \u2192 Open JSON file. Merge the "actions" array into your existing config.'
+    });
+  }
+  if (env.terminal === "vscode") {
+    snippets.push({
+      target: "VS Code keybindings.json",
+      content: JSON.stringify(
+        [
+          {
+            key: "ctrl+r",
+            command: "workbench.action.terminal.sendSequence",
+            args: { text: "" },
+            when: "terminalFocus"
+          },
+          {
+            key: "ctrl+g",
+            command: "workbench.action.terminal.sendSequence",
+            args: { text: "\x07" },
+            when: "terminalFocus"
+          }
+        ],
+        null,
+        2
+      ),
+      instruction: "Open Command Palette \u2192 Preferences: Open Keyboard Shortcuts (JSON). Add these entries to the array."
+    });
+  }
+  if (!env.supportsTrueColor) {
+    if (env.shell === "zsh") {
+      snippets.push({
+        target: "~/.zshrc",
+        content: 'export COLORTERM="truecolor"',
+        instruction: "Add this line to the end of your ~/.zshrc file."
+      });
+    } else if (env.shell === "bash") {
+      snippets.push({
+        target: "~/.bashrc",
+        content: 'export COLORTERM="truecolor"',
+        instruction: "Add this line to the end of your ~/.bashrc file."
+      });
+    } else if (env.shell === "fish") {
+      snippets.push({
+        target: "~/.config/fish/config.fish",
+        content: "set -gx COLORTERM truecolor",
+        instruction: "Add this line to your ~/.config/fish/config.fish file."
+      });
+    } else if (env.shell === "powershell" || env.shell === "pwsh") {
+      snippets.push({
+        target: "$PROFILE (PowerShell profile)",
+        content: '$env:COLORTERM = "truecolor"',
+        instruction: "Add this line to your PowerShell profile. Run $PROFILE to find the path."
+      });
+    }
+  }
+  if (env.os === "linux" && !env.supportsUnicode) {
+    snippets.push({
+      target: "~/.bashrc or ~/.zshrc",
+      content: 'export LANG="en_US.UTF-8"\nexport LC_ALL="en_US.UTF-8"',
+      instruction: "Add these lines to your shell profile to enable UTF-8 locale."
+    });
+  }
+  return snippets;
+}
+function generateSetupGuidance(env) {
+  const recommendations = [
+    ...buildKeybindingRecommendations(env),
+    ...buildFontRecommendations(env),
+    ...buildColorRecommendations(env),
+    ...buildGeneralRecommendations(env)
+  ];
+  const configSnippets = buildConfigSnippets(env);
+  return {
+    environment: env,
+    recommendations,
+    configSnippets
+  };
+}
+export {
+  detectTerminalEnvironment,
+  generateSetupGuidance
+};

package/dist/tool-output-presenter.d.ts

@@ -0,0 +1,38 @@
+import type { Language } from "@linghun/shared";
+import type { ToolName, ToolOutput } from "@linghun/tools";
+export type TuiOutputLayer = "primary" | "details" | "debug";
+export type LayeredToolOutput = {
+    layer: TuiOutputLayer;
+    toolName: ToolName;
+    summary: string;
+    preview: string;
+    details?: string;
+    truncated: boolean;
+    fullOutputPath?: string;
+    evidenceId?: string;
+};
+export declare function createLayeredToolOutput(name: ToolName, output: ToolOutput, language: Language, evidenceId?: string): LayeredToolOutput;
+export declare function formatToolOutput(name: ToolName, output: ToolOutput, language: Language, evidenceId?: string): string;
+/**
+ * D.13L Section 4 — Tool start banner shown immediately before runTool.
+ * Mirrors CCB AssistantToolUseMessage rendering: `<UserFacingName>(<arg>)`.
+ *   Bash(<command>) / Read(<path>) / Edit(<file>) / Write(<file>) /
+ *   Grep(<pattern>) / Glob(<pattern>) / MultiEdit(<file>).
+ *
+ * Only emits when we can produce a single readable arg from input; otherwise
+ * returns undefined so the caller can skip the writeLine. The arg is redacted
+ * for secrets FIRST, then long commands / paths are clamped to 120 chars to
+ * keep one transcript line.
+ */
+export declare function formatToolStart(name: ToolName, input: unknown): string | undefined;
+export declare function sanitizeAssistantPrimaryText(text: string, language: Language): string;
+export declare function sanitizeAssistantPrimaryTextWithMetadata(text: string, language: Language): {
+    text: string;
+    removedRawToolProtocol: boolean;
+};
+export declare function createAssistantPrimaryTextSanitizer(language: Language): {
+    push(text: string): string;
+    flush(): string;
+    hadRawToolProtocol(): boolean;
+};
+//# sourceMappingURL=tool-output-presenter.d.ts.map

package/dist/tool-output-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-output-presenter.d.ts","sourceRoot":"","sources":["../src/tool-output-presenter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAmCF,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,QAAQ,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,iBAAiB,CAgBnB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,QAAQ,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CA4BR;AA2ND;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAsBlF;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAGrF;AAED,wBAAgB,wCAAwC,CACtD,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,sBAAsB,EAAE,OAAO,CAAA;CAAE,CA4BnD;AAED,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,QAAQ,GAAG;IACvE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,KAAK,IAAI,MAAM,CAAC;IAChB,kBAAkB,IAAI,OAAO,CAAC;CAC/B,CA4CA"}

package/dist/tool-output-presenter.js

@@ -0,0 +1,16 @@
+import {
+  createAssistantPrimaryTextSanitizer,
+  createLayeredToolOutput,
+  formatToolOutput,
+  formatToolStart,
+  sanitizeAssistantPrimaryText,
+  sanitizeAssistantPrimaryTextWithMetadata
+} from "./chunk-BOV4K7FP.js";
+export {
+  createAssistantPrimaryTextSanitizer,
+  createLayeredToolOutput,
+  formatToolOutput,
+  formatToolStart,
+  sanitizeAssistantPrimaryText,
+  sanitizeAssistantPrimaryTextWithMetadata
+};

package/dist/tool-result-budget.d.ts

@@ -0,0 +1,42 @@
+import type { ModelMessage } from "@linghun/providers";
+export type ToolResultBudgetArtifact = {
+    id: string;
+    toolUseId: string;
+    path: string;
+    relativePath: string;
+    bytes: number;
+    chars: number;
+    sha256: string;
+    previewChars: number;
+    preview: string;
+    hasMore: boolean;
+};
+export type ToolResultBudgetRecord = {
+    toolUseId: string;
+    originalChars: number;
+    replacementChars: number;
+    artifact: ToolResultBudgetArtifact;
+    reason: "single_result" | "aggregate_message";
+};
+export type ToolResultBudgetResult = {
+    messages: ModelMessage[];
+    records: ToolResultBudgetRecord[];
+};
+export type ToolResultBudgetReplacement = {
+    summary: string;
+    record: ToolResultBudgetRecord;
+    fingerprint: string;
+};
+export type ToolResultBudgetState = {
+    seenIds: Set<string>;
+    replacements: Map<string, ToolResultBudgetReplacement>;
+};
+export declare function applyToolResultBudgetToMessages(messages: ModelMessage[], options: {
+    projectPath: string;
+    sessionId: string;
+    now?: Date;
+    state?: ToolResultBudgetState;
+}): Promise<ToolResultBudgetResult>;
+export declare function formatToolResultBudgetEvidenceSummary(record: ToolResultBudgetRecord): string;
+export declare function formatToolResultBudgetSystemEvent(record: ToolResultBudgetRecord): string;
+//# sourceMappingURL=tool-result-budget.d.ts.map

package/dist/tool-result-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-budget.d.ts","sourceRoot":"","sources":["../src/tool-result-budget.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,MAAM,EAAE,eAAe,GAAG,mBAAmB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;CACxD,CAAC;AAcF,wBAAsB,+BAA+B,CACnD,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE;IACP,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B,GACA,OAAO,CAAC,sBAAsB,CAAC,CAyFjC;AA0ID,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAE5F;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAExF"}

package/dist/tool-result-budget.js

@@ -0,0 +1,11 @@
+import {
+  applyToolResultBudgetToMessages,
+  formatToolResultBudgetEvidenceSummary,
+  formatToolResultBudgetSystemEvent
+} from "./chunk-O7S3HYE6.js";
+import "./chunk-IWUIOLMF.js";
+export {
+  applyToolResultBudgetToMessages,
+  formatToolResultBudgetEvidenceSummary,
+  formatToolResultBudgetSystemEvent
+};

package/dist/tui-agent-job-runtime.d.ts

@@ -0,0 +1,38 @@
+import type { ModelRole } from "@linghun/config";
+import type { PermissionMode } from "@linghun/shared";
+import type { TuiContext } from "./index.js";
+import type { JobContext } from "./job-runtime.js";
+import type { DurableJobState } from "./tui-data-types.js";
+import type { AgentRun, AgentType, BackgroundTaskState, BackgroundTaskStatus, HandoffPacket } from "./tui-data-types.js";
+export declare function isAgentType(value: string): value is AgentType;
+export declare function getAgentRole(type: AgentType): ModelRole;
+export declare function getAgentPermissionMode(type: AgentType, parentMode: PermissionMode): PermissionMode;
+export declare function createEmptyAgentCost(task: string): AgentRun["cost"];
+export declare function createAgentContextSummary(packet: HandoffPacket, task: string, context: TuiContext): string;
+export declare function createAgentBackgroundTask(agent: AgentRun, context: TuiContext): BackgroundTaskState;
+export declare function isAgentCancellable(agent: Pick<AgentRun, "status">): boolean;
+export declare function mapAgentBackgroundResult(agent: AgentRun, lastTerminalStatus?: "completed" | "failed" | "blocked"): BackgroundTaskState["result"];
+export declare function findAgent(context: TuiContext, id: string | undefined): AgentRun | undefined;
+export declare function listCancellableAgents(context: TuiContext): AgentRun[];
+export declare function formatAgentSummary(agent: AgentRun, _context: TuiContext): string;
+export declare function findBackgroundTask(context: TuiContext, id: string | undefined): BackgroundTaskState | undefined;
+export declare function isActiveBackgroundStatus(status: BackgroundTaskStatus): boolean;
+export declare function isRuntimeActiveBackgroundTask(task: BackgroundTaskState): boolean;
+export declare function rememberBackgroundTask(context: TuiContext, task: BackgroundTaskState): void;
+export declare function cleanupCompletedBackgroundTasks(context: TuiContext): void;
+export declare function getBackgroundAbortControllers(context: TuiContext): Map<string, AbortController>;
+export declare function registerBackgroundAbortController(context: TuiContext, taskId: string): AbortController;
+export declare function clearBackgroundAbortController(context: TuiContext, taskId: string): void;
+export declare function abortBackgroundTask(context: TuiContext, taskId: string): boolean;
+export declare function toJobContext(context: TuiContext): JobContext;
+export declare function listDurableJobs(context: TuiContext): Promise<DurableJobState[]>;
+export declare function findDurableJob(context: TuiContext, id: string | undefined): Promise<DurableJobState | undefined>;
+export declare function getDurableJobsRoot(context: TuiContext): string;
+export declare function getDurableJobPaths(context: TuiContext, id: string): Pick<DurableJobState, "logPath" | "reportPath" | "fullOutputPath">;
+export declare function formatJobList(jobs: DurableJobState[], context: TuiContext): string;
+export declare function formatJobPrimary(job: DurableJobState, context: TuiContext): string;
+export declare function formatJobReport(job: DurableJobState): string;
+export declare function formatJobLogs(job: DurableJobState): Promise<string>;
+export declare function createJobBackgroundTask(job: DurableJobState, context: TuiContext): BackgroundTaskState;
+export declare function upsertJobBackgroundTask(context: TuiContext, job: DurableJobState): BackgroundTaskState;
+//# sourceMappingURL=tui-agent-job-runtime.d.ts.map

package/dist/tui-agent-job-runtime.d.ts.map

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