@oh-my-pi/pi-coding-agent 17.2.11 → 17.2.12

package/dist/types/modes/theme/theme-class.d.ts

@@ -0,0 +1,244 @@
+import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import type { Effort } from "@oh-my-pi/pi-ai";
+import type { ColorMode, ThemeBg, ThemeColor } from "./schema.js";
+import { type SpinnerType, type SymbolKey, type SymbolPreset } from "./symbols.js";
+export declare class Theme {
+    #private;
+    private readonly mode;
+    private readonly symbolPreset;
+    /**
+     * Perceptual luma (0..1) of the status-line background — used to classify the
+     * theme light/dark. Undefined when it can't be resolved. Classified against the
+     * status line (the surface session accents render on) rather than the chat bubble
+     * (`userMessageBg`), which some themes (e.g. `porcelain`) style dark on an
+     * otherwise-light theme.
+     */
+    readonly statusLineLuminance: number | undefined;
+    constructor(fgColors: Record<ThemeColor, string | number>, bgColors: Record<ThemeBg, string | number>, mode: ColorMode, symbolPreset: SymbolPreset, symbolOverrides: Partial<Record<SymbolKey, string>>, spinnerFramesOverrides?: Partial<Record<SpinnerType, string[]>>);
+    /** True when the active theme has a light status-line background. */
+    get isLight(): boolean;
+    /**
+     * Surface luminance to size session accents against on light themes; undefined on
+     * dark themes so accents stay vivid. Pass straight to `getSessionAccentHex`.
+     */
+    get accentSurfaceLuminance(): number | undefined;
+    /**
+     * Get the resolved CSS hex string for a foreground theme color.
+     */
+    getColorHex(color: ThemeColor): string;
+    /**
+     * Get all foreground and background theme colors as CSS hex strings.
+     * Skips colors resolved to the default terminal color (unstyled).
+     */
+    getAllThemeColorHexes(): string[];
+    /**
+     * Get the most visually dominant theme colors as CSS hex strings — accent,
+     * border, success, error, warning, heading, link, diff markers, etc.
+     * These are the colors the session accent could visually clash with.
+     * Skips colors resolved to the default terminal color (unstyled).
+     */
+    getMajorThemeColorHexes(): string[];
+    /**
+     * Get the resolved CSS hex string for the theme's accent color.
+     */
+    getAccentColorHex(): string;
+    fg(color: ThemeColor, text: string): string;
+    bg(color: ThemeBg, text: string): string;
+    bold(text: string): string;
+    italic(text: string): string;
+    underline(text: string): string;
+    strikethrough(text: string): string;
+    inverse(text: string): string;
+    getFgAnsi(color: ThemeColor): string;
+    getBgAnsi(color: ThemeBg): string;
+    /**
+     * Foreground ANSI for text drawn **on top of** `fillColor` used as a solid
+     * background (e.g. a powerline chip). Picks near-black or near-white by the
+     * fill's perceived luminance (Rec. 601 luma) so the label stays legible on
+     * both bright and dark fills, across light and dark themes.
+     *
+     * Reads the RGB out of the already-resolved truecolor escape; when the fill
+     * is encoded as a 256-palette index (limited terminals) the RGB is
+     * unavailable, so it falls back to the theme `text` color.
+     */
+    getContrastFgAnsi(fillColor: ThemeColor): string;
+    getColorMode(): ColorMode;
+    getThinkingBorderColor(level: ThinkingLevel | Effort): (str: string) => string;
+    getBashModeBorderColor(): (str: string) => string;
+    getPythonModeBorderColor(): (str: string) => string;
+    /**
+     * Get a symbol by key.
+     */
+    symbol(key: SymbolKey): string;
+    /**
+     * Get a symbol styled with a color.
+     */
+    styledSymbol(key: SymbolKey, color: ThemeColor): string;
+    /**
+     * Get the current symbol preset.
+     */
+    getSymbolPreset(): SymbolPreset;
+    get status(): {
+        success: string;
+        error: string;
+        warning: string;
+        info: string;
+        pending: string;
+        disabled: string;
+        enabled: string;
+        running: string;
+        shadowed: string;
+        aborted: string;
+        done: string;
+    };
+    get nav(): {
+        cursor: string;
+        selected: string;
+        expand: string;
+        collapse: string;
+        back: string;
+    };
+    get tree(): {
+        branch: string;
+        last: string;
+        vertical: string;
+        horizontal: string;
+        hook: string;
+    };
+    get boxRound(): {
+        topLeft: string;
+        topRight: string;
+        bottomLeft: string;
+        bottomRight: string;
+        horizontal: string;
+        vertical: string;
+        cross: string;
+        teeDown: string;
+        teeUp: string;
+        teeRight: string;
+        teeLeft: string;
+    };
+    get boxSharp(): {
+        topLeft: string;
+        topRight: string;
+        bottomLeft: string;
+        bottomRight: string;
+        horizontal: string;
+        vertical: string;
+        cross: string;
+        teeDown: string;
+        teeUp: string;
+        teeRight: string;
+        teeLeft: string;
+    };
+    get sep(): {
+        powerline: string;
+        powerlineThin: string;
+        powerlineLeft: string;
+        powerlineRight: string;
+        powerlineThinLeft: string;
+        powerlineThinRight: string;
+        block: string;
+        space: string;
+        asciiLeft: string;
+        asciiRight: string;
+        dot: string;
+        slash: string;
+        pipe: string;
+    };
+    get icon(): {
+        model: string;
+        plan: string;
+        prewalk: string;
+        goal: string;
+        pause: string;
+        loop: string;
+        folder: string;
+        worktree: string;
+        scratchFolder: string;
+        file: string;
+        git: string;
+        branch: string;
+        pr: string;
+        tokens: string;
+        context: string;
+        cost: string;
+        time: string;
+        pi: string;
+        ghost: string;
+        agents: string;
+        job: string;
+        cache: string;
+        cacheMiss: string;
+        input: string;
+        output: string;
+        throughput: string;
+        host: string;
+        session: string;
+        package: string;
+        warning: string;
+        rewind: string;
+        auto: string;
+        fast: string;
+        extensionSkill: string;
+        extensionTool: string;
+        extensionSlashCommand: string;
+        extensionMcp: string;
+        extensionRule: string;
+        extensionHook: string;
+        extensionPrompt: string;
+        extensionContextFile: string;
+        extensionInstruction: string;
+        mic: string;
+        camera: string;
+    };
+    get thinking(): {
+        minimal: string;
+        low: string;
+        medium: string;
+        high: string;
+        xhigh: string;
+        max: string;
+        autoPending: string;
+    };
+    get checkbox(): {
+        checked: string;
+        unchecked: string;
+    };
+    get radio(): {
+        selected: string;
+        unselected: string;
+    };
+    get format(): {
+        bullet: string;
+        dash: string;
+        bracketLeft: string;
+        bracketRight: string;
+    };
+    get md(): {
+        quoteBorder: string;
+        hrChar: string;
+        bullet: string;
+        colorSwatch: string;
+    };
+    /**
+     * Default spinner frames (status spinner).
+     */
+    get spinnerFrames(): string[];
+    /**
+     * Get spinner frames by type.
+     */
+    getSpinnerFrames(type?: SpinnerType): string[];
+    /**
+     * Get language icon for a language name.
+     * Maps common language names to their corresponding symbol keys.
+     */
+    getLangIcon(lang: string | undefined): string;
+    /**
+     * Language icon tinted with the language's brand color (see
+     * {@link LANG_BRAND_COLORS}). Falls back to the muted theme color for
+     * languages without a brand entry, and returns the bare (possibly empty)
+     * icon when the active symbol preset has none.
+     */
+    getLangIconStyled(lang: string | undefined): string;
+}

package/dist/types/modes/theme/theme.d.ts

@@ -1,265 +1,13 @@
-import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
-import type { Effort } from "@oh-my-pi/pi-ai";
-import type { EditorTheme, MarkdownTheme, SelectListTheme, SettingsListTheme, SymbolTheme, Terminal } from "@oh-my-pi/pi-tui";
+import type { Terminal } from "@oh-my-pi/pi-tui";
+import type { ThemeColor } from "./schema.js";
+import type { SymbolPreset } from "./symbols.js";
+import type { Theme } from "./theme-class.js";
 export { getLanguageFromPath, isMarkdownPath } from "../../utils/lang-from-path.js";
-export type SymbolPreset = "unicode" | "nerd" | "ascii";
-/**
- * All available symbol keys organized by category.
- */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move";
-export type SpinnerType = "status" | "activity";
-export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "thinkingMax" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
-/** Check if a string is a valid ThemeColor value */
-export declare function isValidThemeColor(color: string): color is ThemeColor;
-export type ThemeBg = "selectedBg" | "userMessageBg" | "customMessageBg" | "toolPendingBg" | "toolSuccessBg" | "toolErrorBg" | "statusLineBg";
-type ColorMode = "truecolor" | "256color";
-export declare class Theme {
-    #private;
-    private readonly mode;
-    private readonly symbolPreset;
-    /**
-     * Perceptual luma (0..1) of the status-line background — used to classify the
-     * theme light/dark. Undefined when it can't be resolved. Classified against the
-     * status line (the surface session accents render on) rather than the chat bubble
-     * (`userMessageBg`), which some themes (e.g. `porcelain`) style dark on an
-     * otherwise-light theme.
-     */
-    readonly statusLineLuminance: number | undefined;
-    constructor(fgColors: Record<ThemeColor, string | number>, bgColors: Record<ThemeBg, string | number>, mode: ColorMode, symbolPreset: SymbolPreset, symbolOverrides: Partial<Record<SymbolKey, string>>, spinnerFramesOverrides?: Partial<Record<SpinnerType, string[]>>);
-    /** True when the active theme has a light status-line background. */
-    get isLight(): boolean;
-    /**
-     * Surface luminance to size session accents against on light themes; undefined on
-     * dark themes so accents stay vivid. Pass straight to `getSessionAccentHex`.
-     */
-    get accentSurfaceLuminance(): number | undefined;
-    /**
-     * Get the resolved CSS hex string for a foreground theme color.
-     */
-    getColorHex(color: ThemeColor): string;
-    /**
-     * Get all foreground and background theme colors as CSS hex strings.
-     * Skips colors resolved to the default terminal color (unstyled).
-     */
-    getAllThemeColorHexes(): string[];
-    /**
-     * Get the most visually dominant theme colors as CSS hex strings — accent,
-     * border, success, error, warning, heading, link, diff markers, etc.
-     * These are the colors the session accent could visually clash with.
-     * Skips colors resolved to the default terminal color (unstyled).
-     */
-    getMajorThemeColorHexes(): string[];
-    /**
-     * Get the resolved CSS hex string for the theme's accent color.
-     */
-    getAccentColorHex(): string;
-    fg(color: ThemeColor, text: string): string;
-    bg(color: ThemeBg, text: string): string;
-    bold(text: string): string;
-    italic(text: string): string;
-    underline(text: string): string;
-    strikethrough(text: string): string;
-    inverse(text: string): string;
-    getFgAnsi(color: ThemeColor): string;
-    getBgAnsi(color: ThemeBg): string;
-    /**
-     * Foreground ANSI for text drawn **on top of** `fillColor` used as a solid
-     * background (e.g. a powerline chip). Picks near-black or near-white by the
-     * fill's perceived luminance (Rec. 601 luma) so the label stays legible on
-     * both bright and dark fills, across light and dark themes.
-     *
-     * Reads the RGB out of the already-resolved truecolor escape; when the fill
-     * is encoded as a 256-palette index (limited terminals) the RGB is
-     * unavailable, so it falls back to the theme `text` color.
-     */
-    getContrastFgAnsi(fillColor: ThemeColor): string;
-    getColorMode(): ColorMode;
-    getThinkingBorderColor(level: ThinkingLevel | Effort): (str: string) => string;
-    getBashModeBorderColor(): (str: string) => string;
-    getPythonModeBorderColor(): (str: string) => string;
-    /**
-     * Get a symbol by key.
-     */
-    symbol(key: SymbolKey): string;
-    /**
-     * Get a symbol styled with a color.
-     */
-    styledSymbol(key: SymbolKey, color: ThemeColor): string;
-    /**
-     * Get the current symbol preset.
-     */
-    getSymbolPreset(): SymbolPreset;
-    get status(): {
-        success: string;
-        error: string;
-        warning: string;
-        info: string;
-        pending: string;
-        disabled: string;
-        enabled: string;
-        running: string;
-        shadowed: string;
-        aborted: string;
-        done: string;
-    };
-    get nav(): {
-        cursor: string;
-        selected: string;
-        expand: string;
-        collapse: string;
-        back: string;
-    };
-    get tree(): {
-        branch: string;
-        last: string;
-        vertical: string;
-        horizontal: string;
-        hook: string;
-    };
-    get boxRound(): {
-        topLeft: string;
-        topRight: string;
-        bottomLeft: string;
-        bottomRight: string;
-        horizontal: string;
-        vertical: string;
-        cross: string;
-        teeDown: string;
-        teeUp: string;
-        teeRight: string;
-        teeLeft: string;
-    };
-    get boxSharp(): {
-        topLeft: string;
-        topRight: string;
-        bottomLeft: string;
-        bottomRight: string;
-        horizontal: string;
-        vertical: string;
-        cross: string;
-        teeDown: string;
-        teeUp: string;
-        teeRight: string;
-        teeLeft: string;
-    };
-    get sep(): {
-        powerline: string;
-        powerlineThin: string;
-        powerlineLeft: string;
-        powerlineRight: string;
-        powerlineThinLeft: string;
-        powerlineThinRight: string;
-        block: string;
-        space: string;
-        asciiLeft: string;
-        asciiRight: string;
-        dot: string;
-        slash: string;
-        pipe: string;
-    };
-    get icon(): {
-        model: string;
-        plan: string;
-        prewalk: string;
-        goal: string;
-        pause: string;
-        loop: string;
-        folder: string;
-        worktree: string;
-        scratchFolder: string;
-        file: string;
-        git: string;
-        branch: string;
-        pr: string;
-        tokens: string;
-        context: string;
-        cost: string;
-        time: string;
-        pi: string;
-        ghost: string;
-        agents: string;
-        job: string;
-        cache: string;
-        cacheMiss: string;
-        input: string;
-        output: string;
-        throughput: string;
-        host: string;
-        session: string;
-        package: string;
-        warning: string;
-        rewind: string;
-        auto: string;
-        fast: string;
-        extensionSkill: string;
-        extensionTool: string;
-        extensionSlashCommand: string;
-        extensionMcp: string;
-        extensionRule: string;
-        extensionHook: string;
-        extensionPrompt: string;
-        extensionContextFile: string;
-        extensionInstruction: string;
-        mic: string;
-        camera: string;
-    };
-    get thinking(): {
-        minimal: string;
-        low: string;
-        medium: string;
-        high: string;
-        xhigh: string;
-        max: string;
-        autoPending: string;
-    };
-    get checkbox(): {
-        checked: string;
-        unchecked: string;
-    };
-    get radio(): {
-        selected: string;
-        unselected: string;
-    };
-    get format(): {
-        bullet: string;
-        dash: string;
-        bracketLeft: string;
-        bracketRight: string;
-    };
-    get md(): {
-        quoteBorder: string;
-        hrChar: string;
-        bullet: string;
-        colorSwatch: string;
-    };
-    /**
-     * Default spinner frames (status spinner).
-     */
-    get spinnerFrames(): string[];
-    /**
-     * Get spinner frames by type.
-     */
-    getSpinnerFrames(type?: SpinnerType): string[];
-    /**
-     * Get language icon for a language name.
-     * Maps common language names to their corresponding symbol keys.
-     */
-    getLangIcon(lang: string | undefined): string;
-    /**
-     * Language icon tinted with the language's brand color (see
-     * {@link LANG_BRAND_COLORS}). Falls back to the muted theme color for
-     * languages without a brand entry, and returns the bare (possibly empty)
-     * icon when the active symbol preset has none.
-     */
-    getLangIconStyled(lang: string | undefined): string;
-}
-export declare function getAvailableThemes(): Promise<string[]>;
-export interface ThemeInfo {
-    name: string;
-    path: string | undefined;
-}
-export declare function getAvailableThemesWithPaths(): Promise<ThemeInfo[]>;
-export declare function getThemeByName(name: string): Promise<Theme | undefined>;
+export { getAvailableThemes, getAvailableThemesWithPaths, getThemeByName, type ThemeInfo } from "./loader.js";
+export { isValidThemeColor, type ThemeBg, type ThemeColor } from "./schema.js";
+export { getAvailableSymbolPresets, isValidSymbolPreset, type SpinnerType, type SymbolKey, type SymbolPreset, } from "./symbols.js";
+export { Theme } from "./theme-class.js";
+export { getEditorTheme, getMarkdownTheme, getSelectListTheme, getSettingsListTheme, getSymbolTheme, highlightCode, setMarkdownMermaidRendering, } from "./tui-adapters.js";
 export declare var theme: Theme;
 /** Get the name of the currently active theme. */
 export declare function getCurrentThemeName(): string | undefined;
@@ -320,14 +68,6 @@ export declare function onThemeChange(callback: (event: ThemeChangeEvent) => voi
  * key cached renders on it so the next render re-shapes their output.
  */
 export declare function getThemeEpoch(): number;
-/**
- * Get available symbol presets.
- */
-export declare function getAvailableSymbolPresets(): SymbolPreset[];
-/**
- * Check if a string is a valid symbol preset.
- */
-export declare function isValidSymbolPreset(preset: string): preset is SymbolPreset;
 type MacOSAppearanceReprobeTerminal = Pick<Terminal, "appearance" | "onAppearanceChange" | "onAppearanceReport" | "onPrivateModeReport" | "refreshAppearance">;
 /**
  * Fall back to native macOS appearance notifications when the terminal
@@ -360,14 +100,3 @@ export declare function getThemeExportColors(themeName?: string): Promise<{
     cardBg?: string;
     infoBg?: string;
 }>;
-/**
- * Highlight code with syntax coloring based on file extension or language.
- * Returns array of highlighted lines.
- */
-export declare function highlightCode(code: string, lang?: string, highlightTheme?: Theme): string[];
-export declare function getSymbolTheme(): SymbolTheme;
-export declare function setMarkdownMermaidRendering(enabled: boolean): void;
-export declare function getMarkdownTheme(): MarkdownTheme;
-export declare function getSelectListTheme(): SelectListTheme;
-export declare function getEditorTheme(): EditorTheme;
-export declare function getSettingsListTheme(): SettingsListTheme;

package/dist/types/modes/theme/tui-adapters.d.ts

@@ -0,0 +1,13 @@
+import type { EditorTheme, MarkdownTheme, SelectListTheme, SettingsListTheme, SymbolTheme } from "@oh-my-pi/pi-tui";
+import type { Theme } from "./theme-class.js";
+/**
+ * Highlight code with syntax coloring based on file extension or language.
+ * Returns array of highlighted lines.
+ */
+export declare function highlightCode(code: string, lang?: string, highlightTheme?: Theme): string[];
+export declare function getSymbolTheme(): SymbolTheme;
+export declare function setMarkdownMermaidRendering(enabled: boolean): void;
+export declare function getMarkdownTheme(): MarkdownTheme;
+export declare function getSelectListTheme(): SelectListTheme;
+export declare function getEditorTheme(): EditorTheme;
+export declare function getSettingsListTheme(): SettingsListTheme;

package/dist/types/registry/agent-registry.d.ts

@@ -10,8 +10,6 @@
  */
 import type { AgentSession } from "../session/agent-session.js";
 export declare const MAIN_AGENT_ID = "Main";
-/** Sidecar marker retained beside a child transcript after an explicit kill. */
-export declare const AGENT_TOMBSTONE_SUFFIX = ".tombstone";
 export declare function getAgentTombstonePath(sessionFile: string): string;
 /**
  * - `running`: a turn is in flight.
@@ -22,7 +20,7 @@ export declare function getAgentTombstonePath(sessionFile: string): string;
  */
 export type AgentStatus = "running" | "idle" | "parked" | "aborted";
 /** Provenance of a displayed duration: active runtime, transcript span, or unavailable. */
-export type AgentDurationKind = "active" | "span" | "unknown";
+type AgentDurationKind = "active" | "span" | "unknown";
 /**
  * - `main`/`sub`: the user-facing agent tree (driving agent + task subagents).
  * - `advisor`: a passive review transcript persisted like a subagent for usage

package/dist/types/secrets/index.d.ts

@@ -18,7 +18,9 @@ export declare function getExistingSecretPlaceholderKey(keyDir?: string): Promis
  * key (with a warning) instead of breaking the session.
  */
 export declare function getSecretPlaceholderKeySync(keyDir?: string): string;
-export { deobfuscateSessionContext, deobfuscateToolArguments, obfuscateMessages, obfuscateProviderContext, type SecretEntry, SecretObfuscator, secretEntriesNeedPlaceholderKey, secretEntryNeedsPlaceholderKey, } from "./obfuscator.js";
+export { deobfuscateSessionContext, deobfuscateToolArguments, obfuscateMessages, obfuscateProviderContext, } from "./message-transform.js";
+export { type SecretEntry, SecretObfuscator } from "./obfuscator.js";
+export { secretEntriesNeedPlaceholderKey, secretEntryNeedsPlaceholderKey } from "./placeholder.js";
 /**
  * Load secrets from project-local and global secrets.yml files.
  * Project-local entries override global entries with matching content.

package/dist/types/secrets/message-transform.d.ts

@@ -0,0 +1,40 @@
+import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
+import type { AssistantMessage, Context, Message } from "@oh-my-pi/pi-ai";
+import type { SessionContext } from "../session/session-context.js";
+import type { SecretObfuscator } from "./obfuscator.js";
+/**
+ * Restore secret placeholders for local display. Only message kinds the model
+ * itself authored from obfuscated context carry placeholders — assistant
+ * content and the LLM-written branch/compaction summaries. User, developer, and
+ * tool-result messages are persisted with their literal text, so operator-authored
+ * placeholder-shaped text must survive untouched; those roles are never walked.
+ */
+export declare function deobfuscateSessionContext(sessionContext: SessionContext, obfuscator: SecretObfuscator | undefined): SessionContext;
+export declare function deobfuscateAgentMessages(obfuscator: SecretObfuscator, messages: AgentMessage[]): AgentMessage[];
+/**
+ * Restore placeholders in assistant content: visible text and tool-call
+ * arguments/intent/rawBlock. Thinking and signatures are opaque
+ * provider-replay/hidden-reasoning data and pass through byte-identical.
+ */
+export declare function deobfuscateAssistantContent(obfuscator: SecretObfuscator, content: AssistantMessage["content"]): AssistantMessage["content"];
+/**
+ * Restore placeholders inside a tool call's arguments. Arguments are arbitrary
+ * model-authored JSON, so tool-call arguments are the ONLY place a recursive
+ * JSON walk runs.
+ */
+export declare function deobfuscateToolArguments(obfuscator: SecretObfuscator, args: Record<string, unknown>): Record<string, unknown>;
+/** Redact secrets inside a tool call's arguments (same JSON-walk exception as {@link deobfuscateToolArguments}). */
+export declare function obfuscateToolArguments(obfuscator: SecretObfuscator, args: Record<string, unknown>, sharedRegexSecretValues?: ReadonlySet<string>): Record<string, unknown>;
+/**
+ * Redact secrets from outbound messages. User messages, tool results, and
+ * user-authored developer messages (e.g. `@file` mentions) are obfuscated.
+ * Assistant replay content is re-obfuscated too, because session restoration
+ * expands keyed placeholders locally before the next provider request. Inline
+ * image bytes are never walked.
+ */
+export declare function obfuscateMessages(obfuscator: SecretObfuscator, messages: Message[]): Message[];
+/**
+ * Redact outbound provider context. Only conversation messages are rewritten;
+ * the static system prompt and tool schemas pass through unchanged.
+ */
+export declare function obfuscateProviderContext(obfuscator: SecretObfuscator | undefined, context: Context): Context;