@sheason/pi-coding-agent 0.74.1-sheason.0 → 0.78.0-sheason.0.6.0-alpha.2

package/dist/core/agent-session-proxy.d.ts

@@ -0,0 +1,268 @@
+import type { AgentMessage, ThinkingLevel } from "@sheason/pi-agent-core";
+import type { Api } from "@sheason/pi-ai";
+import type { AgentSessionEvent } from "./agent-session.ts";
+import type { SourceInfo } from "./source-info.ts";
+export interface ProxyPromptOptions {
+    images?: Array<{
+        url: string;
+        mediaType?: string;
+    }>;
+    streamingBehavior?: "steer" | "followUp";
+}
+/** A single keybinding hint entry for the startup banner. */
+export interface BannerKeyHint {
+    /** Display text for the key (e.g. "Ctrl+C", "/", "!!") */
+    key: string;
+    /** Description of what the key does (e.g. "to interrupt", "for commands") */
+    description: string;
+}
+/** A loaded resource section (Context, Skills, Prompts, Extensions, Themes). */
+export interface LoadedResourceSection {
+    /** Section name (e.g. "Context", "Skills", "Prompts", "Extensions", "Themes") */
+    name: string;
+    /** Compact display (single line, comma-separated) */
+    compactList: string;
+    /** Expanded display (one item per line, with paths) */
+    expandedList: string;
+}
+/** A diagnostic entry for resource conflicts/errors. */
+export interface ResourceDiagnosticEntry {
+    /** Diagnostic type */
+    type: "warning" | "error" | "collision";
+    /** Human-readable message */
+    message: string;
+    /** File path if applicable */
+    path?: string;
+    /** Collision details if type is "collision" */
+    collision?: {
+        resourceType: "extension" | "skill" | "prompt" | "theme";
+        name: string;
+        winnerPath: string;
+        loserPath: string;
+        winnerSource?: string;
+        loserSource?: string;
+    };
+}
+/** Structured banner data, theme-independent so connect clients can render with their own theme. */
+export interface BannerData {
+    /** App name */
+    appName: string;
+    /** Version string (e.g. "0.76.0") */
+    version: string;
+    /** Expanded keybinding hints (shown when banner is expanded) */
+    expandedHints: BannerKeyHint[];
+    /** Compact keybinding hints (shown when banner is collapsed) */
+    compactHints: BannerKeyHint[];
+    /** Compact onboarding text */
+    compactOnboarding: string;
+    /** Full onboarding text */
+    onboarding: string;
+    /** Loaded resource sections (Context, Skills, Prompts, etc.) */
+    loadedResources: LoadedResourceSection[];
+    /** Diagnostics (Skill conflicts, Prompt conflicts, Extension issues, etc.) */
+    diagnostics: Array<{
+        /** Section label (e.g. "Skill conflicts", "Prompt conflicts", "Extension issues") */
+        label: string;
+        /** Diagnostic entries */
+        entries: ResourceDiagnosticEntry[];
+    }>;
+    /** Changelog markdown for "What's New" section, or undefined if no new entries */
+    changelogMarkdown: string | undefined;
+}
+/** Cumulative token usage across all assistant messages in the session. */
+export interface TokenUsage {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    cost: number;
+    usingSubscription: boolean;
+}
+/** Context window usage info for the current branch. */
+export interface ContextUsageInfo {
+    tokens: number | null;
+    contextWindow: number;
+    percent: number | null;
+}
+/** Model details needed by the footer and UI. */
+export interface ModelInfo {
+    id: string;
+    provider: string;
+    reasoning: boolean;
+    contextWindow: number;
+}
+/**
+ * Model item for remote model selector. Field-compatible with `Model<any>`
+ * (the upstream `ScopedModelsSelectorComponent`'s expected input type) so
+ * connect-mode callers can cast `ModelItemData[]` to `Model<any>[]` without
+ * fabricating missing fields. Fields mirror the relevant subset of
+ * `packages/ai/src/types.ts#Model`.
+ */
+export interface ModelItemData {
+    id: string;
+    name: string;
+    provider: string;
+    api: Api;
+    baseUrl: string;
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    reasoning: boolean;
+    contextWindow: number;
+    maxTokens: number;
+    input: ("text" | "image")[];
+}
+/** Settings that can be read and modified remotely via serve mode. */
+export interface RemoteSettings {
+    autoCompact: boolean;
+    thinkingLevel: ThinkingLevel;
+    availableThinkingLevels: readonly ThinkingLevel[];
+    steeringMode: "all" | "one-at-a-time";
+    followUpMode: "all" | "one-at-a-time";
+    enableSkillCommands: boolean;
+    doubleEscapeAction: "fork" | "tree" | "none";
+    showImages: boolean;
+    imageWidthCells: number;
+    autoResizeImages: boolean;
+    blockImages: boolean;
+    transport: string;
+    httpIdleTimeoutMs: number;
+    currentTheme: string;
+    availableThemes: string[];
+    hideThinkingBlock: boolean;
+    collapseChangelog: boolean;
+    enableInstallTelemetry: boolean;
+    treeFilterMode: string;
+    showHardwareCursor: boolean;
+    editorPaddingX: number;
+    autocompleteMaxVisible: number;
+    quietStartup: boolean;
+    clearOnShrink: boolean;
+    showTerminalProgress: boolean;
+    warnings: Record<string, unknown>;
+}
+/** Lightweight tree node for wire transport (no full message content). */
+export interface TreeNodeData {
+    id: string;
+    type: string;
+    parentId: string | null;
+    timestamp: string;
+    label?: string;
+    /** Preview text for message entries */
+    preview?: string;
+    children: TreeNodeData[];
+}
+/** User message item for fork selector. */
+export interface UserMessageItem {
+    id: string;
+    text: string;
+}
+/** Session info for session selector. */
+export interface SessionItemData {
+    path: string;
+    id: string;
+    cwd: string;
+    name?: string;
+    parentSessionPath?: string;
+    created: string;
+    modified: string;
+    messageCount: number;
+    firstMessage: string;
+}
+/** Slash command exposed via serve mode for connect mode autocomplete. */
+export interface ServeSlashCommand {
+    /** Command name (without leading slash) */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Argument hint (e.g. "<provider/model-id>") */
+    argumentHint?: string;
+    /** What kind of command this is */
+    source: "builtin" | "extension" | "prompt" | "skill";
+    /** Source metadata (absent for builtin commands) */
+    sourceInfo?: SourceInfo;
+}
+export interface SessionStateSnapshot {
+    model: string;
+    thinkingLevel: ThinkingLevel;
+    isStreaming: boolean;
+    isCompacting: boolean;
+    isBashRunning: boolean;
+    steeringMessages: readonly string[];
+    followUpMessages: readonly string[];
+    sessionFile: string | undefined;
+    sessionName: string | undefined;
+    messages: readonly AgentMessage[];
+    banner: BannerData | undefined;
+    tokenUsage: TokenUsage;
+    contextUsage: ContextUsageInfo;
+    modelInfo: ModelInfo;
+    autoCompactEnabled: boolean;
+    cwd: string;
+    availableProviderCount: number;
+    remoteSettings: RemoteSettings;
+    /** Currently scoped model IDs for Ctrl+P cycling (null = all enabled) */
+    scopedModelIds: string[] | null;
+    /** Persisted enabled model patterns from settings */
+    enabledModelPatterns: string[] | undefined;
+    /** Extension paths loaded on the server — client can load the same extensions for UI */
+    extensionPaths: string[];
+}
+export interface AgentSessionProxy {
+    subscribe(listener: (event: AgentSessionEvent) => void): () => void;
+    prompt(text: string, options?: ProxyPromptOptions): Promise<void>;
+    steer(text: string, images?: Array<{
+        url: string;
+        mediaType?: string;
+    }>): void;
+    followUp(text: string, images?: Array<{
+        url: string;
+        mediaType?: string;
+    }>): void;
+    abort(): void;
+    abortBash(): void;
+    readonly model: string;
+    readonly thinkingLevel: ThinkingLevel;
+    readonly isStreaming: boolean;
+    readonly isCompacting: boolean;
+    readonly isBashRunning: boolean;
+    readonly steeringMessages: readonly string[];
+    readonly followUpMessages: readonly string[];
+    readonly sessionFile: string | undefined;
+    readonly sessionName: string | undefined;
+    readonly messages: readonly AgentMessage[];
+    compact(customInstructions?: string): Promise<void>;
+    setModel(modelId: string): void;
+    cycleModel(direction: 1 | -1): void;
+    setThinkingLevel(level: ThinkingLevel): void;
+    cycleThinkingLevel(direction: 1 | -1): void;
+    setAutoCompactEnabled(enabled: boolean): void;
+    setSteeringMode(mode: "all" | "one-at-a-time"): void;
+    setFollowUpMode(mode: "all" | "one-at-a-time"): void;
+    newSession(): Promise<void>;
+    switchSession(sessionFile: string): Promise<void>;
+    fork(entryId?: string): Promise<void>;
+    renameSession(name: string): void;
+    setLabel(entryId: string, label: string | undefined): void;
+    reload(): Promise<void>;
+    setScopedModels(enabledIds: string[] | null): void;
+    setEnabledModels(patterns: string[] | undefined): void;
+    /** Generic settings update — applies a batch of key/value pairs to the server's SettingsManager */
+    updateSettings(updates: Record<string, unknown>): void;
+    getTree(): TreeNodeData[];
+    getUserMessagesForForking(): UserMessageItem[];
+    getSessions(): Promise<SessionItemData[]>;
+    /** Async variants for remote proxies — local impl wraps sync methods */
+    fetchTree(): Promise<TreeNodeData[]>;
+    fetchUserMessages(): Promise<UserMessageItem[]>;
+    fetchCommands(): Promise<ServeSlashCommand[]>;
+    fetchModels(): Promise<ModelItemData[]>;
+    getCommands(): ServeSlashCommand[];
+    getModels(): ModelItemData[];
+    dispose(): void;
+    getSnapshot(): SessionStateSnapshot;
+}
+//# sourceMappingURL=agent-session-proxy.d.ts.map

package/dist/core/agent-session-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-proxy.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-proxy.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentMessage, ThinkingLevel } from \"@sheason/pi-agent-core\";\nimport type { Api } from \"@sheason/pi-ai\";\nimport type { AgentSessionEvent } from \"./agent-session.ts\";\nimport type { SourceInfo } from \"./source-info.ts\";\n\nexport interface ProxyPromptOptions {\n\timages?: Array<{ url: string; mediaType?: string }>;\n\tstreamingBehavior?: \"steer\" | \"followUp\";\n}\n\n/** A single keybinding hint entry for the startup banner. */\nexport interface BannerKeyHint {\n\t/** Display text for the key (e.g. \"Ctrl+C\", \"/\", \"!!\") */\n\tkey: string;\n\t/** Description of what the key does (e.g. \"to interrupt\", \"for commands\") */\n\tdescription: string;\n}\n\n/** A loaded resource section (Context, Skills, Prompts, Extensions, Themes). */\nexport interface LoadedResourceSection {\n\t/** Section name (e.g. \"Context\", \"Skills\", \"Prompts\", \"Extensions\", \"Themes\") */\n\tname: string;\n\t/** Compact display (single line, comma-separated) */\n\tcompactList: string;\n\t/** Expanded display (one item per line, with paths) */\n\texpandedList: string;\n}\n\n/** A diagnostic entry for resource conflicts/errors. */\nexport interface ResourceDiagnosticEntry {\n\t/** Diagnostic type */\n\ttype: \"warning\" | \"error\" | \"collision\";\n\t/** Human-readable message */\n\tmessage: string;\n\t/** File path if applicable */\n\tpath?: string;\n\t/** Collision details if type is \"collision\" */\n\tcollision?: {\n\t\tresourceType: \"extension\" | \"skill\" | \"prompt\" | \"theme\";\n\t\tname: string;\n\t\twinnerPath: string;\n\t\tloserPath: string;\n\t\twinnerSource?: string;\n\t\tloserSource?: string;\n\t};\n}\n\n/** Structured banner data, theme-independent so connect clients can render with their own theme. */\nexport interface BannerData {\n\t/** App name */\n\tappName: string;\n\t/** Version string (e.g. \"0.76.0\") */\n\tversion: string;\n\t/** Expanded keybinding hints (shown when banner is expanded) */\n\texpandedHints: BannerKeyHint[];\n\t/** Compact keybinding hints (shown when banner is collapsed) */\n\tcompactHints: BannerKeyHint[];\n\t/** Compact onboarding text */\n\tcompactOnboarding: string;\n\t/** Full onboarding text */\n\tonboarding: string;\n\t/** Loaded resource sections (Context, Skills, Prompts, etc.) */\n\tloadedResources: LoadedResourceSection[];\n\t/** Diagnostics (Skill conflicts, Prompt conflicts, Extension issues, etc.) */\n\tdiagnostics: Array<{\n\t\t/** Section label (e.g. \"Skill conflicts\", \"Prompt conflicts\", \"Extension issues\") */\n\t\tlabel: string;\n\t\t/** Diagnostic entries */\n\t\tentries: ResourceDiagnosticEntry[];\n\t}>;\n\t/** Changelog markdown for \"What's New\" section, or undefined if no new entries */\n\tchangelogMarkdown: string | undefined;\n}\n\n/** Cumulative token usage across all assistant messages in the session. */\nexport interface TokenUsage {\n\tinput: number;\n\toutput: number;\n\tcacheRead: number;\n\tcacheWrite: number;\n\tcost: number;\n\tusingSubscription: boolean;\n}\n\n/** Context window usage info for the current branch. */\nexport interface ContextUsageInfo {\n\ttokens: number | null;\n\tcontextWindow: number;\n\tpercent: number | null;\n}\n\n/** Model details needed by the footer and UI. */\nexport interface ModelInfo {\n\tid: string;\n\tprovider: string;\n\treasoning: boolean;\n\tcontextWindow: number;\n}\n\n/**\n * Model item for remote model selector. Field-compatible with `Model<any>`\n * (the upstream `ScopedModelsSelectorComponent`'s expected input type) so\n * connect-mode callers can cast `ModelItemData[]` to `Model<any>[]` without\n * fabricating missing fields. Fields mirror the relevant subset of\n * `packages/ai/src/types.ts#Model`.\n */\nexport interface ModelItemData {\n\tid: string;\n\tname: string;\n\tprovider: string;\n\tapi: Api;\n\tbaseUrl: string;\n\tcost: {\n\t\tinput: number;\n\t\toutput: number;\n\t\tcacheRead: number;\n\t\tcacheWrite: number;\n\t};\n\treasoning: boolean;\n\tcontextWindow: number;\n\tmaxTokens: number;\n\tinput: (\"text\" | \"image\")[];\n}\n\n/** Settings that can be read and modified remotely via serve mode. */\nexport interface RemoteSettings {\n\tautoCompact: boolean;\n\tthinkingLevel: ThinkingLevel;\n\tavailableThinkingLevels: readonly ThinkingLevel[];\n\tsteeringMode: \"all\" | \"one-at-a-time\";\n\tfollowUpMode: \"all\" | \"one-at-a-time\";\n\tenableSkillCommands: boolean;\n\tdoubleEscapeAction: \"fork\" | \"tree\" | \"none\";\n\t// Extended server-side settings\n\tshowImages: boolean;\n\timageWidthCells: number;\n\tautoResizeImages: boolean;\n\tblockImages: boolean;\n\ttransport: string;\n\thttpIdleTimeoutMs: number;\n\tcurrentTheme: string;\n\tavailableThemes: string[];\n\thideThinkingBlock: boolean;\n\tcollapseChangelog: boolean;\n\tenableInstallTelemetry: boolean;\n\ttreeFilterMode: string;\n\tshowHardwareCursor: boolean;\n\teditorPaddingX: number;\n\tautocompleteMaxVisible: number;\n\tquietStartup: boolean;\n\tclearOnShrink: boolean;\n\tshowTerminalProgress: boolean;\n\twarnings: Record<string, unknown>;\n}\n\n/** Lightweight tree node for wire transport (no full message content). */\nexport interface TreeNodeData {\n\tid: string;\n\ttype: string;\n\tparentId: string | null;\n\ttimestamp: string;\n\tlabel?: string;\n\t/** Preview text for message entries */\n\tpreview?: string;\n\tchildren: TreeNodeData[];\n}\n\n/** User message item for fork selector. */\nexport interface UserMessageItem {\n\tid: string;\n\ttext: string;\n}\n\n/** Session info for session selector. */\nexport interface SessionItemData {\n\tpath: string;\n\tid: string;\n\tcwd: string;\n\tname?: string;\n\tparentSessionPath?: string;\n\tcreated: string;\n\tmodified: string;\n\tmessageCount: number;\n\tfirstMessage: string;\n}\n\n/** Slash command exposed via serve mode for connect mode autocomplete. */\nexport interface ServeSlashCommand {\n\t/** Command name (without leading slash) */\n\tname: string;\n\t/** Human-readable description */\n\tdescription?: string;\n\t/** Argument hint (e.g. \"<provider/model-id>\") */\n\targumentHint?: string;\n\t/** What kind of command this is */\n\tsource: \"builtin\" | \"extension\" | \"prompt\" | \"skill\";\n\t/** Source metadata (absent for builtin commands) */\n\tsourceInfo?: SourceInfo;\n}\n\nexport interface SessionStateSnapshot {\n\tmodel: string;\n\tthinkingLevel: ThinkingLevel;\n\tisStreaming: boolean;\n\tisCompacting: boolean;\n\tisBashRunning: boolean;\n\tsteeringMessages: readonly string[];\n\tfollowUpMessages: readonly string[];\n\tsessionFile: string | undefined;\n\tsessionName: string | undefined;\n\tmessages: readonly AgentMessage[];\n\tbanner: BannerData | undefined;\n\ttokenUsage: TokenUsage;\n\tcontextUsage: ContextUsageInfo;\n\tmodelInfo: ModelInfo;\n\tautoCompactEnabled: boolean;\n\tcwd: string;\n\tavailableProviderCount: number;\n\tremoteSettings: RemoteSettings;\n\t/** Currently scoped model IDs for Ctrl+P cycling (null = all enabled) */\n\tscopedModelIds: string[] | null;\n\t/** Persisted enabled model patterns from settings */\n\tenabledModelPatterns: string[] | undefined;\n\t/** Extension paths loaded on the server — client can load the same extensions for UI */\n\textensionPaths: string[];\n}\n\nexport interface AgentSessionProxy {\n\t// Event subscription\n\tsubscribe(listener: (event: AgentSessionEvent) => void): () => void;\n\n\t// Commands\n\tprompt(text: string, options?: ProxyPromptOptions): Promise<void>;\n\tsteer(text: string, images?: Array<{ url: string; mediaType?: string }>): void;\n\tfollowUp(text: string, images?: Array<{ url: string; mediaType?: string }>): void;\n\tabort(): void;\n\tabortBash(): void;\n\n\t// State queries\n\treadonly model: string;\n\treadonly thinkingLevel: ThinkingLevel;\n\treadonly isStreaming: boolean;\n\treadonly isCompacting: boolean;\n\treadonly isBashRunning: boolean;\n\treadonly steeringMessages: readonly string[];\n\treadonly followUpMessages: readonly string[];\n\treadonly sessionFile: string | undefined;\n\treadonly sessionName: string | undefined;\n\treadonly messages: readonly AgentMessage[];\n\n\t// Session operations\n\tcompact(customInstructions?: string): Promise<void>;\n\tsetModel(modelId: string): void;\n\tcycleModel(direction: 1 | -1): void;\n\tsetThinkingLevel(level: ThinkingLevel): void;\n\tcycleThinkingLevel(direction: 1 | -1): void;\n\tsetAutoCompactEnabled(enabled: boolean): void;\n\tsetSteeringMode(mode: \"all\" | \"one-at-a-time\"): void;\n\tsetFollowUpMode(mode: \"all\" | \"one-at-a-time\"): void;\n\n\t// Runtime operations\n\tnewSession(): Promise<void>;\n\tswitchSession(sessionFile: string): Promise<void>;\n\tfork(entryId?: string): Promise<void>;\n\trenameSession(name: string): void;\n\tsetLabel(entryId: string, label: string | undefined): void;\n\treload(): Promise<void>;\n\n\t// Scoped model management\n\tsetScopedModels(enabledIds: string[] | null): void;\n\tsetEnabledModels(patterns: string[] | undefined): void;\n\n\t/** Generic settings update — applies a batch of key/value pairs to the server's SettingsManager */\n\tupdateSettings(updates: Record<string, unknown>): void;\n\n\t// Data queries (for connect mode selectors)\n\tgetTree(): TreeNodeData[];\n\tgetUserMessagesForForking(): UserMessageItem[];\n\tgetSessions(): Promise<SessionItemData[]>;\n\n\t/** Async variants for remote proxies — local impl wraps sync methods */\n\tfetchTree(): Promise<TreeNodeData[]>;\n\tfetchUserMessages(): Promise<UserMessageItem[]>;\n\tfetchCommands(): Promise<ServeSlashCommand[]>;\n\tfetchModels(): Promise<ModelItemData[]>;\n\n\t// Command discovery\n\tgetCommands(): ServeSlashCommand[];\n\n\t// Model discovery\n\tgetModels(): ModelItemData[];\n\n\t// Lifecycle\n\tdispose(): void;\n\n\t// Snapshot\n\tgetSnapshot(): SessionStateSnapshot;\n}\n"]}

package/dist/core/agent-session-proxy.js

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

package/dist/core/agent-session-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-proxy.js","sourceRoot":"","sources":["../../src/core/agent-session-proxy.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentMessage, ThinkingLevel } from \"@sheason/pi-agent-core\";\nimport type { Api } from \"@sheason/pi-ai\";\nimport type { AgentSessionEvent } from \"./agent-session.ts\";\nimport type { SourceInfo } from \"./source-info.ts\";\n\nexport interface ProxyPromptOptions {\n\timages?: Array<{ url: string; mediaType?: string }>;\n\tstreamingBehavior?: \"steer\" | \"followUp\";\n}\n\n/** A single keybinding hint entry for the startup banner. */\nexport interface BannerKeyHint {\n\t/** Display text for the key (e.g. \"Ctrl+C\", \"/\", \"!!\") */\n\tkey: string;\n\t/** Description of what the key does (e.g. \"to interrupt\", \"for commands\") */\n\tdescription: string;\n}\n\n/** A loaded resource section (Context, Skills, Prompts, Extensions, Themes). */\nexport interface LoadedResourceSection {\n\t/** Section name (e.g. \"Context\", \"Skills\", \"Prompts\", \"Extensions\", \"Themes\") */\n\tname: string;\n\t/** Compact display (single line, comma-separated) */\n\tcompactList: string;\n\t/** Expanded display (one item per line, with paths) */\n\texpandedList: string;\n}\n\n/** A diagnostic entry for resource conflicts/errors. */\nexport interface ResourceDiagnosticEntry {\n\t/** Diagnostic type */\n\ttype: \"warning\" | \"error\" | \"collision\";\n\t/** Human-readable message */\n\tmessage: string;\n\t/** File path if applicable */\n\tpath?: string;\n\t/** Collision details if type is \"collision\" */\n\tcollision?: {\n\t\tresourceType: \"extension\" | \"skill\" | \"prompt\" | \"theme\";\n\t\tname: string;\n\t\twinnerPath: string;\n\t\tloserPath: string;\n\t\twinnerSource?: string;\n\t\tloserSource?: string;\n\t};\n}\n\n/** Structured banner data, theme-independent so connect clients can render with their own theme. */\nexport interface BannerData {\n\t/** App name */\n\tappName: string;\n\t/** Version string (e.g. \"0.76.0\") */\n\tversion: string;\n\t/** Expanded keybinding hints (shown when banner is expanded) */\n\texpandedHints: BannerKeyHint[];\n\t/** Compact keybinding hints (shown when banner is collapsed) */\n\tcompactHints: BannerKeyHint[];\n\t/** Compact onboarding text */\n\tcompactOnboarding: string;\n\t/** Full onboarding text */\n\tonboarding: string;\n\t/** Loaded resource sections (Context, Skills, Prompts, etc.) */\n\tloadedResources: LoadedResourceSection[];\n\t/** Diagnostics (Skill conflicts, Prompt conflicts, Extension issues, etc.) */\n\tdiagnostics: Array<{\n\t\t/** Section label (e.g. \"Skill conflicts\", \"Prompt conflicts\", \"Extension issues\") */\n\t\tlabel: string;\n\t\t/** Diagnostic entries */\n\t\tentries: ResourceDiagnosticEntry[];\n\t}>;\n\t/** Changelog markdown for \"What's New\" section, or undefined if no new entries */\n\tchangelogMarkdown: string | undefined;\n}\n\n/** Cumulative token usage across all assistant messages in the session. */\nexport interface TokenUsage {\n\tinput: number;\n\toutput: number;\n\tcacheRead: number;\n\tcacheWrite: number;\n\tcost: number;\n\tusingSubscription: boolean;\n}\n\n/** Context window usage info for the current branch. */\nexport interface ContextUsageInfo {\n\ttokens: number | null;\n\tcontextWindow: number;\n\tpercent: number | null;\n}\n\n/** Model details needed by the footer and UI. */\nexport interface ModelInfo {\n\tid: string;\n\tprovider: string;\n\treasoning: boolean;\n\tcontextWindow: number;\n}\n\n/**\n * Model item for remote model selector. Field-compatible with `Model<any>`\n * (the upstream `ScopedModelsSelectorComponent`'s expected input type) so\n * connect-mode callers can cast `ModelItemData[]` to `Model<any>[]` without\n * fabricating missing fields. Fields mirror the relevant subset of\n * `packages/ai/src/types.ts#Model`.\n */\nexport interface ModelItemData {\n\tid: string;\n\tname: string;\n\tprovider: string;\n\tapi: Api;\n\tbaseUrl: string;\n\tcost: {\n\t\tinput: number;\n\t\toutput: number;\n\t\tcacheRead: number;\n\t\tcacheWrite: number;\n\t};\n\treasoning: boolean;\n\tcontextWindow: number;\n\tmaxTokens: number;\n\tinput: (\"text\" | \"image\")[];\n}\n\n/** Settings that can be read and modified remotely via serve mode. */\nexport interface RemoteSettings {\n\tautoCompact: boolean;\n\tthinkingLevel: ThinkingLevel;\n\tavailableThinkingLevels: readonly ThinkingLevel[];\n\tsteeringMode: \"all\" | \"one-at-a-time\";\n\tfollowUpMode: \"all\" | \"one-at-a-time\";\n\tenableSkillCommands: boolean;\n\tdoubleEscapeAction: \"fork\" | \"tree\" | \"none\";\n\t// Extended server-side settings\n\tshowImages: boolean;\n\timageWidthCells: number;\n\tautoResizeImages: boolean;\n\tblockImages: boolean;\n\ttransport: string;\n\thttpIdleTimeoutMs: number;\n\tcurrentTheme: string;\n\tavailableThemes: string[];\n\thideThinkingBlock: boolean;\n\tcollapseChangelog: boolean;\n\tenableInstallTelemetry: boolean;\n\ttreeFilterMode: string;\n\tshowHardwareCursor: boolean;\n\teditorPaddingX: number;\n\tautocompleteMaxVisible: number;\n\tquietStartup: boolean;\n\tclearOnShrink: boolean;\n\tshowTerminalProgress: boolean;\n\twarnings: Record<string, unknown>;\n}\n\n/** Lightweight tree node for wire transport (no full message content). */\nexport interface TreeNodeData {\n\tid: string;\n\ttype: string;\n\tparentId: string | null;\n\ttimestamp: string;\n\tlabel?: string;\n\t/** Preview text for message entries */\n\tpreview?: string;\n\tchildren: TreeNodeData[];\n}\n\n/** User message item for fork selector. */\nexport interface UserMessageItem {\n\tid: string;\n\ttext: string;\n}\n\n/** Session info for session selector. */\nexport interface SessionItemData {\n\tpath: string;\n\tid: string;\n\tcwd: string;\n\tname?: string;\n\tparentSessionPath?: string;\n\tcreated: string;\n\tmodified: string;\n\tmessageCount: number;\n\tfirstMessage: string;\n}\n\n/** Slash command exposed via serve mode for connect mode autocomplete. */\nexport interface ServeSlashCommand {\n\t/** Command name (without leading slash) */\n\tname: string;\n\t/** Human-readable description */\n\tdescription?: string;\n\t/** Argument hint (e.g. \"<provider/model-id>\") */\n\targumentHint?: string;\n\t/** What kind of command this is */\n\tsource: \"builtin\" | \"extension\" | \"prompt\" | \"skill\";\n\t/** Source metadata (absent for builtin commands) */\n\tsourceInfo?: SourceInfo;\n}\n\nexport interface SessionStateSnapshot {\n\tmodel: string;\n\tthinkingLevel: ThinkingLevel;\n\tisStreaming: boolean;\n\tisCompacting: boolean;\n\tisBashRunning: boolean;\n\tsteeringMessages: readonly string[];\n\tfollowUpMessages: readonly string[];\n\tsessionFile: string | undefined;\n\tsessionName: string | undefined;\n\tmessages: readonly AgentMessage[];\n\tbanner: BannerData | undefined;\n\ttokenUsage: TokenUsage;\n\tcontextUsage: ContextUsageInfo;\n\tmodelInfo: ModelInfo;\n\tautoCompactEnabled: boolean;\n\tcwd: string;\n\tavailableProviderCount: number;\n\tremoteSettings: RemoteSettings;\n\t/** Currently scoped model IDs for Ctrl+P cycling (null = all enabled) */\n\tscopedModelIds: string[] | null;\n\t/** Persisted enabled model patterns from settings */\n\tenabledModelPatterns: string[] | undefined;\n\t/** Extension paths loaded on the server — client can load the same extensions for UI */\n\textensionPaths: string[];\n}\n\nexport interface AgentSessionProxy {\n\t// Event subscription\n\tsubscribe(listener: (event: AgentSessionEvent) => void): () => void;\n\n\t// Commands\n\tprompt(text: string, options?: ProxyPromptOptions): Promise<void>;\n\tsteer(text: string, images?: Array<{ url: string; mediaType?: string }>): void;\n\tfollowUp(text: string, images?: Array<{ url: string; mediaType?: string }>): void;\n\tabort(): void;\n\tabortBash(): void;\n\n\t// State queries\n\treadonly model: string;\n\treadonly thinkingLevel: ThinkingLevel;\n\treadonly isStreaming: boolean;\n\treadonly isCompacting: boolean;\n\treadonly isBashRunning: boolean;\n\treadonly steeringMessages: readonly string[];\n\treadonly followUpMessages: readonly string[];\n\treadonly sessionFile: string | undefined;\n\treadonly sessionName: string | undefined;\n\treadonly messages: readonly AgentMessage[];\n\n\t// Session operations\n\tcompact(customInstructions?: string): Promise<void>;\n\tsetModel(modelId: string): void;\n\tcycleModel(direction: 1 | -1): void;\n\tsetThinkingLevel(level: ThinkingLevel): void;\n\tcycleThinkingLevel(direction: 1 | -1): void;\n\tsetAutoCompactEnabled(enabled: boolean): void;\n\tsetSteeringMode(mode: \"all\" | \"one-at-a-time\"): void;\n\tsetFollowUpMode(mode: \"all\" | \"one-at-a-time\"): void;\n\n\t// Runtime operations\n\tnewSession(): Promise<void>;\n\tswitchSession(sessionFile: string): Promise<void>;\n\tfork(entryId?: string): Promise<void>;\n\trenameSession(name: string): void;\n\tsetLabel(entryId: string, label: string | undefined): void;\n\treload(): Promise<void>;\n\n\t// Scoped model management\n\tsetScopedModels(enabledIds: string[] | null): void;\n\tsetEnabledModels(patterns: string[] | undefined): void;\n\n\t/** Generic settings update — applies a batch of key/value pairs to the server's SettingsManager */\n\tupdateSettings(updates: Record<string, unknown>): void;\n\n\t// Data queries (for connect mode selectors)\n\tgetTree(): TreeNodeData[];\n\tgetUserMessagesForForking(): UserMessageItem[];\n\tgetSessions(): Promise<SessionItemData[]>;\n\n\t/** Async variants for remote proxies — local impl wraps sync methods */\n\tfetchTree(): Promise<TreeNodeData[]>;\n\tfetchUserMessages(): Promise<UserMessageItem[]>;\n\tfetchCommands(): Promise<ServeSlashCommand[]>;\n\tfetchModels(): Promise<ModelItemData[]>;\n\n\t// Command discovery\n\tgetCommands(): ServeSlashCommand[];\n\n\t// Model discovery\n\tgetModels(): ModelItemData[];\n\n\t// Lifecycle\n\tdispose(): void;\n\n\t// Snapshot\n\tgetSnapshot(): SessionStateSnapshot;\n}\n"]}

package/dist/core/agent-session-runtime.d.ts

@@ -1,8 +1,8 @@
-import type { AgentSession } from "./agent-session.js";
-import type { AgentSessionRuntimeDiagnostic, AgentSessionServices } from "./agent-session-services.js";
-import type { ReplacedSessionContext, SessionStartEvent } from "./extensions/index.js";
-import type { CreateAgentSessionResult } from "./sdk.js";
-import { SessionManager } from "./session-manager.js";
+import type { AgentSession } from "./agent-session.ts";
+import type { AgentSessionRuntimeDiagnostic, AgentSessionServices } from "./agent-session-services.ts";
+import type { ReplacedSessionContext, SessionStartEvent } from "./extensions/index.ts";
+import type { CreateAgentSessionResult } from "./sdk.ts";
+import { SessionManager } from "./session-manager.ts";
 /**
  * Result returned by runtime creation.
  *
@@ -41,20 +41,20 @@ export declare class SessionImportFileNotFoundError extends Error {
  * caller. The caller is responsible for user-facing error handling.
  */
 export declare class AgentSessionRuntime {
+    private rebindSession?;
+    private beforeSessionInvalidate?;
     private _session;
     private _services;
     private readonly createRuntime;
     private _diagnostics;
     private _modelFallbackMessage?;
-    private rebindSession?;
-    private beforeSessionInvalidate?;
-    constructor(_session: AgentSession, _services: AgentSessionServices, createRuntime: CreateAgentSessionRuntimeFactory, _diagnostics?: AgentSessionRuntimeDiagnostic[], _modelFallbackMessage?: string | undefined);
+    constructor(_session: AgentSession, _services: AgentSessionServices, createRuntime: CreateAgentSessionRuntimeFactory, _diagnostics?: AgentSessionRuntimeDiagnostic[], _modelFallbackMessage?: string);
     get services(): AgentSessionServices;
     get session(): AgentSession;
     get cwd(): string;
     get diagnostics(): readonly AgentSessionRuntimeDiagnostic[];
     get modelFallbackMessage(): string | undefined;
-    setRebindSession(rebindSession?: (session: AgentSession) => Promise<void>): void;
+    setRebindSession(rebindSession?: (session: AgentSession, reason: "new" | "resume" | "fork") => Promise<void>): void;
     /**
      * Set a synchronous callback that runs after `session_shutdown` handlers finish
      * but before the current session is invalidated.
@@ -113,5 +113,5 @@ export declare function createAgentSessionRuntime(createRuntime: CreateAgentSess
     sessionManager: SessionManager;
     sessionStartEvent?: SessionStartEvent;
 }): Promise<AgentSessionRuntime>;
-export { type AgentSessionRuntimeDiagnostic, type AgentSessionServices, type CreateAgentSessionFromServicesOptions, type CreateAgentSessionServicesOptions, createAgentSessionFromServices, createAgentSessionServices, } from "./agent-session-services.js";
+export { type AgentSessionRuntimeDiagnostic, type AgentSessionServices, type CreateAgentSessionFromServicesOptions, type CreateAgentSessionServicesOptions, createAgentSessionFromServices, createAgentSessionServices, } from "./agent-session-services.ts";
 //# sourceMappingURL=agent-session-runtime.d.ts.map

package/dist/core/agent-session-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session-runtime.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { copyFileSync, existsSync, mkdirSync } from \"node:fs\";\nimport { basename, join, resolve } from \"node:path\";\nimport type { AgentSession } from \"./agent-session.js\";\nimport type { AgentSessionRuntimeDiagnostic, AgentSessionServices } from \"./agent-session-services.js\";\nimport type { ReplacedSessionContext, SessionShutdownEvent, SessionStartEvent } from \"./extensions/index.js\";\nimport { emitSessionShutdownEvent } from \"./extensions/runner.js\";\nimport type { CreateAgentSessionResult } from \"./sdk.js\";\nimport { assertSessionCwdExists } from \"./session-cwd.js\";\nimport { SessionManager } from \"./session-manager.js\";\n\n/**\n * Result returned by runtime creation.\n *\n * The caller gets the created session, its cwd-bound services, and all\n * diagnostics collected during setup.\n */\nexport interface CreateAgentSessionRuntimeResult extends CreateAgentSessionResult {\n\tservices: AgentSessionServices;\n\tdiagnostics: AgentSessionRuntimeDiagnostic[];\n}\n\n/**\n * Creates a full runtime for a target cwd and session manager.\n *\n * The factory closes over process-global fixed inputs, recreates cwd-bound\n * services for the effective cwd, resolves session options against those\n * services, and finally creates the AgentSession.\n */\nexport type CreateAgentSessionRuntimeFactory = (options: {\n\tcwd: string;\n\tagentDir: string;\n\tsessionManager: SessionManager;\n\tsessionStartEvent?: SessionStartEvent;\n}) => Promise<CreateAgentSessionRuntimeResult>;\n\n/**\n * Thrown when /import references a JSONL file path that does not exist.\n */\nexport class SessionImportFileNotFoundError extends Error {\n\treadonly filePath: string;\n\n\tconstructor(filePath: string) {\n\t\tsuper(`File not found: ${filePath}`);\n\t\tthis.name = \"SessionImportFileNotFoundError\";\n\t\tthis.filePath = filePath;\n\t}\n}\n\nfunction extractUserMessageText(content: string | Array<{ type: string; text?: string }>): string {\n\tif (typeof content === \"string\") {\n\t\treturn content;\n\t}\n\n\treturn content\n\t\t.filter((part): part is { type: \"text\"; text: string } => part.type === \"text\" && typeof part.text === \"string\")\n\t\t.map((part) => part.text)\n\t\t.join(\"\");\n}\n\n/**\n * Owns the current AgentSession plus its cwd-bound services.\n *\n * Session replacement methods tear down the current runtime first, then create\n * and apply the next runtime. If creation fails, the error is propagated to the\n * caller. The caller is responsible for user-facing error handling.\n */\nexport class AgentSessionRuntime {\n\tprivate rebindSession?: (session: AgentSession) => Promise<void>;\n\tprivate beforeSessionInvalidate?: () => void;\n\n\tconstructor(\n\t\tprivate _session: AgentSession,\n\t\tprivate _services: AgentSessionServices,\n\t\tprivate readonly createRuntime: CreateAgentSessionRuntimeFactory,\n\t\tprivate _diagnostics: AgentSessionRuntimeDiagnostic[] = [],\n\t\tprivate _modelFallbackMessage?: string,\n\t) {}\n\n\tget services(): AgentSessionServices {\n\t\treturn this._services;\n\t}\n\n\tget session(): AgentSession {\n\t\treturn this._session;\n\t}\n\n\tget cwd(): string {\n\t\treturn this._services.cwd;\n\t}\n\n\tget diagnostics(): readonly AgentSessionRuntimeDiagnostic[] {\n\t\treturn this._diagnostics;\n\t}\n\n\tget modelFallbackMessage(): string | undefined {\n\t\treturn this._modelFallbackMessage;\n\t}\n\n\tsetRebindSession(rebindSession?: (session: AgentSession) => Promise<void>): void {\n\t\tthis.rebindSession = rebindSession;\n\t}\n\n\t/**\n\t * Set a synchronous callback that runs after `session_shutdown` handlers finish\n\t * but before the current session is invalidated.\n\t *\n\t * This is for host-owned UI teardown that must not yield to the event loop,\n\t * such as detaching extension-provided TUI components before the old extension\n\t * context becomes stale.\n\t */\n\tsetBeforeSessionInvalidate(beforeSessionInvalidate?: () => void): void {\n\t\tthis.beforeSessionInvalidate = beforeSessionInvalidate;\n\t}\n\n\tprivate async emitBeforeSwitch(\n\t\treason: \"new\" | \"resume\",\n\t\ttargetSessionFile?: string,\n\t): Promise<{ cancelled: boolean }> {\n\t\tconst runner = this.session.extensionRunner;\n\t\tif (!runner.hasHandlers(\"session_before_switch\")) {\n\t\t\treturn { cancelled: false };\n\t\t}\n\n\t\tconst result = await runner.emit({\n\t\t\ttype: \"session_before_switch\",\n\t\t\treason,\n\t\t\ttargetSessionFile,\n\t\t});\n\t\treturn { cancelled: result?.cancel === true };\n\t}\n\n\tprivate async emitBeforeFork(\n\t\tentryId: string,\n\t\toptions: { position: \"before\" | \"at\" },\n\t): Promise<{ cancelled: boolean }> {\n\t\tconst runner = this.session.extensionRunner;\n\t\tif (!runner.hasHandlers(\"session_before_fork\")) {\n\t\t\treturn { cancelled: false };\n\t\t}\n\n\t\tconst result = await runner.emit({\n\t\t\ttype: \"session_before_fork\",\n\t\t\tentryId,\n\t\t\t...options,\n\t\t});\n\t\treturn { cancelled: result?.cancel === true };\n\t}\n\n\tprivate async teardownCurrent(reason: SessionShutdownEvent[\"reason\"], targetSessionFile?: string): Promise<void> {\n\t\tawait emitSessionShutdownEvent(this.session.extensionRunner, {\n\t\t\ttype: \"session_shutdown\",\n\t\t\treason,\n\t\t\ttargetSessionFile,\n\t\t});\n\t\tthis.beforeSessionInvalidate?.();\n\t\tthis.session.dispose();\n\t}\n\n\tprivate apply(result: CreateAgentSessionRuntimeResult): void {\n\t\tthis._session = result.session;\n\t\tthis._services = result.services;\n\t\tthis._diagnostics = result.diagnostics;\n\t\tthis._modelFallbackMessage = result.modelFallbackMessage;\n\t}\n\n\tprivate async finishSessionReplacement(withSession?: (ctx: ReplacedSessionContext) => Promise<void>): Promise<void> {\n\t\tif (this.rebindSession) {\n\t\t\tawait this.rebindSession(this.session);\n\t\t}\n\t\tif (withSession) {\n\t\t\tawait withSession(this.session.createReplacedSessionContext());\n\t\t}\n\t}\n\n\tasync switchSession(\n\t\tsessionPath: string,\n\t\toptions?: { cwdOverride?: string; withSession?: (ctx: ReplacedSessionContext) => Promise<void> },\n\t): Promise<{ cancelled: boolean }> {\n\t\tconst beforeResult = await this.emitBeforeSwitch(\"resume\", sessionPath);\n\t\tif (beforeResult.cancelled) {\n\t\t\treturn beforeResult;\n\t\t}\n\n\t\tconst previousSessionFile = this.session.sessionFile;\n\t\tconst sessionManager = SessionManager.open(sessionPath, undefined, options?.cwdOverride);\n\t\tassertSessionCwdExists(sessionManager, this.cwd);\n\t\tawait this.teardownCurrent(\"resume\", sessionManager.getSessionFile());\n\t\tthis.apply(\n\t\t\tawait this.createRuntime({\n\t\t\t\tcwd: sessionManager.getCwd(),\n\t\t\t\tagentDir: this.services.agentDir,\n\t\t\t\tsessionManager,\n\t\t\t\tsessionStartEvent: { type: \"session_start\", reason: \"resume\", previousSessionFile },\n\t\t\t}),\n\t\t);\n\t\tawait this.finishSessionReplacement(options?.withSession);\n\t\treturn { cancelled: false };\n\t}\n\n\tasync newSession(options?: {\n\t\tparentSession?: string;\n\t\tsetup?: (sessionManager: SessionManager) => Promise<void>;\n\t\twithSession?: (ctx: ReplacedSessionContext) => Promise<void>;\n\t}): Promise<{ cancelled: boolean }> {\n\t\tconst beforeResult = await this.emitBeforeSwitch(\"new\");\n\t\tif (beforeResult.cancelled) {\n\t\t\treturn beforeResult;\n\t\t}\n\n\t\tconst previousSessionFile = this.session.sessionFile;\n\t\tconst sessionDir = this.session.sessionManager.getSessionDir();\n\t\tconst sessionManager = SessionManager.create(this.cwd, sessionDir);\n\t\tif (options?.parentSession) {\n\t\t\tsessionManager.newSession({ parentSession: options.parentSession });\n\t\t}\n\n\t\tawait this.teardownCurrent(\"new\", sessionManager.getSessionFile());\n\t\tthis.apply(\n\t\t\tawait this.createRuntime({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.services.agentDir,\n\t\t\t\tsessionManager,\n\t\t\t\tsessionStartEvent: { type: \"session_start\", reason: \"new\", previousSessionFile },\n\t\t\t}),\n\t\t);\n\t\tif (options?.setup) {\n\t\t\tawait options.setup(this.session.sessionManager);\n\t\t\tthis.session.agent.state.messages = this.session.sessionManager.buildSessionContext().messages;\n\t\t}\n\t\tawait this.finishSessionReplacement(options?.withSession);\n\t\treturn { cancelled: false };\n\t}\n\n\tasync fork(\n\t\tentryId: string,\n\t\toptions?: { position?: \"before\" | \"at\"; withSession?: (ctx: ReplacedSessionContext) => Promise<void> },\n\t): Promise<{ cancelled: boolean; selectedText?: string }> {\n\t\tconst position = options?.position ?? \"before\";\n\t\tconst beforeResult = await this.emitBeforeFork(entryId, { position });\n\t\tif (beforeResult.cancelled) {\n\t\t\treturn { cancelled: true };\n\t\t}\n\t\tlet targetLeafId: string | null;\n\t\tlet selectedText: string | undefined;\n\n\t\tconst selectedEntry = this.session.sessionManager.getEntry(entryId);\n\t\tif (!selectedEntry) {\n\t\t\tthrow new Error(\"Invalid entry ID for forking\");\n\t\t}\n\n\t\tif (position === \"at\") {\n\t\t\ttargetLeafId = selectedEntry.id;\n\t\t} else {\n\t\t\tif (selectedEntry.type !== \"message\" || selectedEntry.message.role !== \"user\") {\n\t\t\t\tthrow new Error(\"Invalid entry ID for forking\");\n\t\t\t}\n\t\t\ttargetLeafId = selectedEntry.parentId;\n\t\t\tselectedText = extractUserMessageText(selectedEntry.message.content);\n\t\t}\n\n\t\tconst previousSessionFile = this.session.sessionFile;\n\t\tif (this.session.sessionManager.isPersisted()) {\n\t\t\tconst currentSessionFile = this.session.sessionFile;\n\t\t\tif (!currentSessionFile) {\n\t\t\t\tthrow new Error(\"Persisted session is missing a session file\");\n\t\t\t}\n\t\t\tconst sessionDir = this.session.sessionManager.getSessionDir();\n\t\t\tif (!targetLeafId) {\n\t\t\t\tconst sessionManager = SessionManager.create(this.cwd, sessionDir);\n\t\t\t\tsessionManager.newSession({ parentSession: currentSessionFile });\n\t\t\t\tawait this.teardownCurrent(\"fork\", sessionManager.getSessionFile());\n\t\t\t\tthis.apply(\n\t\t\t\t\tawait this.createRuntime({\n\t\t\t\t\t\tcwd: this.cwd,\n\t\t\t\t\t\tagentDir: this.services.agentDir,\n\t\t\t\t\t\tsessionManager,\n\t\t\t\t\t\tsessionStartEvent: { type: \"session_start\", reason: \"fork\", previousSessionFile },\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t\tawait this.finishSessionReplacement(options?.withSession);\n\t\t\t\treturn { cancelled: false, selectedText };\n\t\t\t}\n\n\t\t\tconst sourceManager = SessionManager.open(currentSessionFile, sessionDir);\n\t\t\tconst forkedSessionPath = sourceManager.createBranchedSession(targetLeafId);\n\t\t\tif (!forkedSessionPath) {\n\t\t\t\tthrow new Error(\"Failed to create forked session\");\n\t\t\t}\n\t\t\tconst sessionManager = SessionManager.open(forkedSessionPath, sessionDir);\n\t\t\tawait this.teardownCurrent(\"fork\", sessionManager.getSessionFile());\n\t\t\tthis.apply(\n\t\t\t\tawait this.createRuntime({\n\t\t\t\t\tcwd: sessionManager.getCwd(),\n\t\t\t\t\tagentDir: this.services.agentDir,\n\t\t\t\t\tsessionManager,\n\t\t\t\t\tsessionStartEvent: { type: \"session_start\", reason: \"fork\", previousSessionFile },\n\t\t\t\t}),\n\t\t\t);\n\t\t\tawait this.finishSessionReplacement(options?.withSession);\n\t\t\treturn { cancelled: false, selectedText };\n\t\t}\n\n\t\tconst sessionManager = this.session.sessionManager;\n\t\tif (!targetLeafId) {\n\t\t\tsessionManager.newSession({ parentSession: this.session.sessionFile });\n\t\t} else {\n\t\t\tsessionManager.createBranchedSession(targetLeafId);\n\t\t}\n\t\tawait this.teardownCurrent(\"fork\", sessionManager.getSessionFile());\n\t\tthis.apply(\n\t\t\tawait this.createRuntime({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.services.agentDir,\n\t\t\t\tsessionManager,\n\t\t\t\tsessionStartEvent: { type: \"session_start\", reason: \"fork\", previousSessionFile },\n\t\t\t}),\n\t\t);\n\t\tawait this.finishSessionReplacement(options?.withSession);\n\t\treturn { cancelled: false, selectedText };\n\t}\n\n\t/**\n\t * Import a session JSONL file and switch runtime state to the imported session.\n\t *\n\t * @returns `{ cancelled: true }` when cancelled by `session_before_switch`, otherwise `{ cancelled: false }`.\n\t * @throws {SessionImportFileNotFoundError} When the input path does not exist.\n\t * @throws {MissingSessionCwdError} When the imported session cwd cannot be resolved and no override is provided.\n\t */\n\tasync importFromJsonl(inputPath: string, cwdOverride?: string): Promise<{ cancelled: boolean }> {\n\t\tconst resolvedPath = resolve(inputPath);\n\t\tif (!existsSync(resolvedPath)) {\n\t\t\tthrow new SessionImportFileNotFoundError(resolvedPath);\n\t\t}\n\n\t\tconst sessionDir = this.session.sessionManager.getSessionDir();\n\t\tif (!existsSync(sessionDir)) {\n\t\t\tmkdirSync(sessionDir, { recursive: true });\n\t\t}\n\n\t\tconst destinationPath = join(sessionDir, basename(resolvedPath));\n\t\tconst beforeResult = await this.emitBeforeSwitch(\"resume\", destinationPath);\n\t\tif (beforeResult.cancelled) {\n\t\t\treturn beforeResult;\n\t\t}\n\n\t\tconst previousSessionFile = this.session.sessionFile;\n\t\tif (resolve(destinationPath) !== resolvedPath) {\n\t\t\tcopyFileSync(resolvedPath, destinationPath);\n\t\t}\n\n\t\tconst sessionManager = SessionManager.open(destinationPath, sessionDir, cwdOverride);\n\t\tassertSessionCwdExists(sessionManager, this.cwd);\n\t\tawait this.teardownCurrent(\"resume\", sessionManager.getSessionFile());\n\t\tthis.apply(\n\t\t\tawait this.createRuntime({\n\t\t\t\tcwd: sessionManager.getCwd(),\n\t\t\t\tagentDir: this.services.agentDir,\n\t\t\t\tsessionManager,\n\t\t\t\tsessionStartEvent: { type: \"session_start\", reason: \"resume\", previousSessionFile },\n\t\t\t}),\n\t\t);\n\t\tawait this.finishSessionReplacement();\n\t\treturn { cancelled: false };\n\t}\n\n\tasync dispose(): Promise<void> {\n\t\tawait emitSessionShutdownEvent(this.session.extensionRunner, {\n\t\t\ttype: \"session_shutdown\",\n\t\t\treason: \"quit\",\n\t\t});\n\t\tthis.beforeSessionInvalidate?.();\n\t\tthis.session.dispose();\n\t}\n}\n\n/**\n * Create the initial runtime from a runtime factory and initial session target.\n *\n * The same factory is stored on the returned AgentSessionRuntime and reused for\n * later /new, /resume, /fork, and import flows.\n */\nexport async function createAgentSessionRuntime(\n\tcreateRuntime: CreateAgentSessionRuntimeFactory,\n\toptions: {\n\t\tcwd: string;\n\t\tagentDir: string;\n\t\tsessionManager: SessionManager;\n\t\tsessionStartEvent?: SessionStartEvent;\n\t},\n): Promise<AgentSessionRuntime> {\n\tassertSessionCwdExists(options.sessionManager, options.cwd);\n\tconst result = await createRuntime(options);\n\treturn new AgentSessionRuntime(\n\t\tresult.session,\n\t\tresult.services,\n\t\tcreateRuntime,\n\t\tresult.diagnostics,\n\t\tresult.modelFallbackMessage,\n\t);\n}\n\nexport {\n\ttype AgentSessionRuntimeDiagnostic,\n\ttype AgentSessionServices,\n\ttype CreateAgentSessionFromServicesOptions,\n\ttype CreateAgentSessionServicesOptions,\n\tcreateAgentSessionFromServices,\n\tcreateAgentSessionServices,\n} from \"./agent-session-services.js\";\n"]}
+{"version":3,"file":"agent-session-runtime.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { copyFileSync, existsSync, mkdirSync } from \"node:fs\";\nimport { basename, join, resolve } from \"node:path\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport type { AgentSession } from \"./agent-session.ts\";\nimport type { AgentSessionRuntimeDiagnostic, AgentSessionServices } from \"./agent-session-services.ts\";\nimport type { ReplacedSessionContext, SessionShutdownEvent, SessionStartEvent } from \"./extensions/index.ts\";\nimport { emitSessionShutdownEvent } from \"./extensions/runner.ts\";\nimport type { CreateAgentSessionResult } from \"./sdk.ts\";\nimport { assertSessionCwdExists } from \"./session-cwd.ts\";\nimport { SessionManager } from \"./session-manager.ts\";\n\n/**\n * Result returned by runtime creation.\n *\n * The caller gets the created session, its cwd-bound services, and all\n * diagnostics collected during setup.\n */\nexport interface CreateAgentSessionRuntimeResult extends CreateAgentSessionResult {\n\tservices: AgentSessionServices;\n\tdiagnostics: AgentSessionRuntimeDiagnostic[];\n}\n\n/**\n * Creates a full runtime for a target cwd and session manager.\n *\n * The factory closes over process-global fixed inputs, recreates cwd-bound\n * services for the effective cwd, resolves session options against those\n * services, and finally creates the AgentSession.\n */\nexport type CreateAgentSessionRuntimeFactory = (options: {\n\tcwd: string;\n\tagentDir: string;\n\tsessionManager: SessionManager;\n\tsessionStartEvent?: SessionStartEvent;\n}) => Promise<CreateAgentSessionRuntimeResult>;\n\n/**\n * Thrown when /import references a JSONL file path that does not exist.\n */\nexport class SessionImportFileNotFoundError extends Error {\n\treadonly filePath: string;\n\n\tconstructor(filePath: string) {\n\t\tsuper(`File not found: ${filePath}`);\n\t\tthis.name = \"SessionImportFileNotFoundError\";\n\t\tthis.filePath = filePath;\n\t}\n}\n\nfunction extractUserMessageText(content: string | Array<{ type: string; text?: string }>): string {\n\tif (typeof content === \"string\") {\n\t\treturn content;\n\t}\n\n\treturn content\n\t\t.filter((part): part is { type: \"text\"; text: string } => part.type === \"text\" && typeof part.text === \"string\")\n\t\t.map((part) => part.text)\n\t\t.join(\"\");\n}\n\n/**\n * Owns the current AgentSession plus its cwd-bound services.\n *\n * Session replacement methods tear down the current runtime first, then create\n * and apply the next runtime. If creation fails, the error is propagated to the\n * caller. The caller is responsible for user-facing error handling.\n */\nexport class AgentSessionRuntime {\n\tprivate rebindSession?: (session: AgentSession, reason: \"new\" | \"resume\" | \"fork\") => Promise<void>;\n\tprivate beforeSessionInvalidate?: () => void;\n\tprivate _session: AgentSession;\n\tprivate _services: AgentSessionServices;\n\tprivate readonly createRuntime: CreateAgentSessionRuntimeFactory;\n\tprivate _diagnostics: AgentSessionRuntimeDiagnostic[];\n\tprivate _modelFallbackMessage?: string;\n\n\tconstructor(\n\t\t_session: AgentSession,\n\t\t_services: AgentSessionServices,\n\t\tcreateRuntime: CreateAgentSessionRuntimeFactory,\n\t\t_diagnostics: AgentSessionRuntimeDiagnostic[] = [],\n\t\t_modelFallbackMessage?: string,\n\t) {\n\t\tthis._session = _session;\n\t\tthis._services = _services;\n\t\tthis.createRuntime = createRuntime;\n\t\tthis._diagnostics = _diagnostics;\n\t\tthis._modelFallbackMessage = _modelFallbackMessage;\n\t}\n\n\tget services(): AgentSessionServices {\n\t\treturn this._services;\n\t}\n\n\tget session(): AgentSession {\n\t\treturn this._session;\n\t}\n\n\tget cwd(): string {\n\t\treturn this._services.cwd;\n\t}\n\n\tget diagnostics(): readonly AgentSessionRuntimeDiagnostic[] {\n\t\treturn this._diagnostics;\n\t}\n\n\tget modelFallbackMessage(): string | undefined {\n\t\treturn this._modelFallbackMessage;\n\t}\n\n\tsetRebindSession(rebindSession?: (session: AgentSession, reason: \"new\" | \"resume\" | \"fork\") => Promise<void>): void {\n\t\tthis.rebindSession = rebindSession;\n\t}\n\n\t/**\n\t * Set a synchronous callback that runs after `session_shutdown` handlers finish\n\t * but before the current session is invalidated.\n\t *\n\t * This is for host-owned UI teardown that must not yield to the event loop,\n\t * such as detaching extension-provided TUI components before the old extension\n\t * context becomes stale.\n\t */\n\tsetBeforeSessionInvalidate(beforeSessionInvalidate?: () => void): void {\n\t\tthis.beforeSessionInvalidate = beforeSessionInvalidate;\n\t}\n\n\tprivate async emitBeforeSwitch(\n\t\treason: \"new\" | \"resume\",\n\t\ttargetSessionFile?: string,\n\t): Promise<{ cancelled: boolean }> {\n\t\tconst runner = this.session.extensionRunner;\n\t\tif (!runner.hasHandlers(\"session_before_switch\")) {\n\t\t\treturn { cancelled: false };\n\t\t}\n\n\t\tconst result = await runner.emit({\n\t\t\ttype: \"session_before_switch\",\n\t\t\treason,\n\t\t\ttargetSessionFile,\n\t\t});\n\t\treturn { cancelled: result?.cancel === true };\n\t}\n\n\tprivate async emitBeforeFork(\n\t\tentryId: string,\n\t\toptions: { position: \"before\" | \"at\" },\n\t): Promise<{ cancelled: boolean }> {\n\t\tconst runner = this.session.extensionRunner;\n\t\tif (!runner.hasHandlers(\"session_before_fork\")) {\n\t\t\treturn { cancelled: false };\n\t\t}\n\n\t\tconst result = await runner.emit({\n\t\t\ttype: \"session_before_fork\",\n\t\t\tentryId,\n\t\t\t...options,\n\t\t});\n\t\treturn { cancelled: result?.cancel === true };\n\t}\n\n\tprivate async teardownCurrent(reason: SessionShutdownEvent[\"reason\"], targetSessionFile?: string): Promise<void> {\n\t\tawait emitSessionShutdownEvent(this.session.extensionRunner, {\n\t\t\ttype: \"session_shutdown\",\n\t\t\treason,\n\t\t\ttargetSessionFile,\n\t\t});\n\t\tthis.beforeSessionInvalidate?.();\n\t\tthis.session.dispose();\n\t}\n\n\tprivate apply(result: CreateAgentSessionRuntimeResult): void {\n\t\tthis._session = result.session;\n\t\tthis._services = result.services;\n\t\tthis._diagnostics = result.diagnostics;\n\t\tthis._modelFallbackMessage = result.modelFallbackMessage;\n\t}\n\n\tprivate async finishSessionReplacement(\n\t\treason: \"new\" | \"resume\" | \"fork\",\n\t\twithSession?: (ctx: ReplacedSessionContext) => Promise<void>,\n\t): Promise<void> {\n\t\tif (this.rebindSession) {\n\t\t\tawait this.rebindSession(this.session, reason);\n\t\t}\n\t\tif (withSession) {\n\t\t\tawait withSession(this.session.createReplacedSessionContext());\n\t\t}\n\t}\n\n\tasync switchSession(\n\t\tsessionPath: string,\n\t\toptions?: { cwdOverride?: string; withSession?: (ctx: ReplacedSessionContext) => Promise<void> },\n\t): Promise<{ cancelled: boolean }> {\n\t\tconst beforeResult = await this.emitBeforeSwitch(\"resume\", sessionPath);\n\t\tif (beforeResult.cancelled) {\n\t\t\treturn beforeResult;\n\t\t}\n\n\t\tconst previousSessionFile = this.session.sessionFile;\n\t\tconst sessionManager = SessionManager.open(sessionPath, undefined, options?.cwdOverride);\n\t\tassertSessionCwdExists(sessionManager, this.cwd);\n\t\tawait this.teardownCurrent(\"resume\", sessionManager.getSessionFile());\n\t\tthis.apply(\n\t\t\tawait this.createRuntime({\n\t\t\t\tcwd: sessionManager.getCwd(),\n\t\t\t\tagentDir: this.services.agentDir,\n\t\t\t\tsessionManager,\n\t\t\t\tsessionStartEvent: { type: \"session_start\", reason: \"resume\", previousSessionFile },\n\t\t\t}),\n\t\t);\n\t\tawait this.finishSessionReplacement(\"resume\", options?.withSession);\n\t\treturn { cancelled: false };\n\t}\n\n\tasync newSession(options?: {\n\t\tparentSession?: string;\n\t\tsetup?: (sessionManager: SessionManager) => Promise<void>;\n\t\twithSession?: (ctx: ReplacedSessionContext) => Promise<void>;\n\t}): Promise<{ cancelled: boolean }> {\n\t\tconst beforeResult = await this.emitBeforeSwitch(\"new\");\n\t\tif (beforeResult.cancelled) {\n\t\t\treturn beforeResult;\n\t\t}\n\n\t\tconst previousSessionFile = this.session.sessionFile;\n\t\tconst sessionDir = this.session.sessionManager.getSessionDir();\n\t\tconst sessionManager = SessionManager.create(this.cwd, sessionDir);\n\t\tif (options?.parentSession) {\n\t\t\tsessionManager.newSession({ parentSession: options.parentSession });\n\t\t}\n\n\t\tawait this.teardownCurrent(\"new\", sessionManager.getSessionFile());\n\t\tthis.apply(\n\t\t\tawait this.createRuntime({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.services.agentDir,\n\t\t\t\tsessionManager,\n\t\t\t\tsessionStartEvent: { type: \"session_start\", reason: \"new\", previousSessionFile },\n\t\t\t}),\n\t\t);\n\t\tif (options?.setup) {\n\t\t\tawait options.setup(this.session.sessionManager);\n\t\t\tthis.session.agent.state.messages = this.session.sessionManager.buildSessionContext().messages;\n\t\t}\n\t\tawait this.finishSessionReplacement(\"new\", options?.withSession);\n\t\treturn { cancelled: false };\n\t}\n\n\tasync fork(\n\t\tentryId: string,\n\t\toptions?: { position?: \"before\" | \"at\"; withSession?: (ctx: ReplacedSessionContext) => Promise<void> },\n\t): Promise<{ cancelled: boolean; selectedText?: string }> {\n\t\tconst position = options?.position ?? \"before\";\n\t\tconst beforeResult = await this.emitBeforeFork(entryId, { position });\n\t\tif (beforeResult.cancelled) {\n\t\t\treturn { cancelled: true };\n\t\t}\n\t\tlet targetLeafId: string | null;\n\t\tlet selectedText: string | undefined;\n\n\t\tconst selectedEntry = this.session.sessionManager.getEntry(entryId);\n\t\tif (!selectedEntry) {\n\t\t\tthrow new Error(\"Invalid entry ID for forking\");\n\t\t}\n\n\t\tif (position === \"at\") {\n\t\t\ttargetLeafId = selectedEntry.id;\n\t\t} else {\n\t\t\tif (selectedEntry.type !== \"message\" || selectedEntry.message.role !== \"user\") {\n\t\t\t\tthrow new Error(\"Invalid entry ID for forking\");\n\t\t\t}\n\t\t\ttargetLeafId = selectedEntry.parentId;\n\t\t\tselectedText = extractUserMessageText(selectedEntry.message.content);\n\t\t}\n\n\t\tconst previousSessionFile = this.session.sessionFile;\n\t\tif (this.session.sessionManager.isPersisted()) {\n\t\t\tconst currentSessionFile = this.session.sessionFile;\n\t\t\tif (!currentSessionFile) {\n\t\t\t\tthrow new Error(\"Persisted session is missing a session file\");\n\t\t\t}\n\t\t\tconst sessionDir = this.session.sessionManager.getSessionDir();\n\t\t\tif (!targetLeafId) {\n\t\t\t\tconst sessionManager = SessionManager.create(this.cwd, sessionDir);\n\t\t\t\tsessionManager.newSession({ parentSession: currentSessionFile });\n\t\t\t\tawait this.teardownCurrent(\"fork\", sessionManager.getSessionFile());\n\t\t\t\tthis.apply(\n\t\t\t\t\tawait this.createRuntime({\n\t\t\t\t\t\tcwd: this.cwd,\n\t\t\t\t\t\tagentDir: this.services.agentDir,\n\t\t\t\t\t\tsessionManager,\n\t\t\t\t\t\tsessionStartEvent: { type: \"session_start\", reason: \"fork\", previousSessionFile },\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t\tawait this.finishSessionReplacement(\"fork\", options?.withSession);\n\t\t\t\treturn { cancelled: false, selectedText };\n\t\t\t}\n\n\t\t\tconst sessionManager = SessionManager.open(currentSessionFile, sessionDir);\n\t\t\tconst forkedSessionPath = sessionManager.createBranchedSession(targetLeafId);\n\t\t\tif (!forkedSessionPath) {\n\t\t\t\tthrow new Error(\"Failed to create forked session\");\n\t\t\t}\n\t\t\tawait this.teardownCurrent(\"fork\", sessionManager.getSessionFile());\n\t\t\tthis.apply(\n\t\t\t\tawait this.createRuntime({\n\t\t\t\t\tcwd: sessionManager.getCwd(),\n\t\t\t\t\tagentDir: this.services.agentDir,\n\t\t\t\t\tsessionManager,\n\t\t\t\t\tsessionStartEvent: { type: \"session_start\", reason: \"fork\", previousSessionFile },\n\t\t\t\t}),\n\t\t\t);\n\t\t\tawait this.finishSessionReplacement(\"fork\", options?.withSession);\n\t\t\treturn { cancelled: false, selectedText };\n\t\t}\n\n\t\tconst sessionManager = this.session.sessionManager;\n\t\tif (!targetLeafId) {\n\t\t\tsessionManager.newSession({ parentSession: this.session.sessionFile });\n\t\t} else {\n\t\t\tsessionManager.createBranchedSession(targetLeafId);\n\t\t}\n\t\tawait this.teardownCurrent(\"fork\", sessionManager.getSessionFile());\n\t\tthis.apply(\n\t\t\tawait this.createRuntime({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.services.agentDir,\n\t\t\t\tsessionManager,\n\t\t\t\tsessionStartEvent: { type: \"session_start\", reason: \"fork\", previousSessionFile },\n\t\t\t}),\n\t\t);\n\t\tawait this.finishSessionReplacement(\"fork\", options?.withSession);\n\t\treturn { cancelled: false, selectedText };\n\t}\n\n\t/**\n\t * Import a session JSONL file and switch runtime state to the imported session.\n\t *\n\t * @returns `{ cancelled: true }` when cancelled by `session_before_switch`, otherwise `{ cancelled: false }`.\n\t * @throws {SessionImportFileNotFoundError} When the input path does not exist.\n\t * @throws {MissingSessionCwdError} When the imported session cwd cannot be resolved and no override is provided.\n\t */\n\tasync importFromJsonl(inputPath: string, cwdOverride?: string): Promise<{ cancelled: boolean }> {\n\t\tconst resolvedPath = resolvePath(inputPath);\n\t\tif (!existsSync(resolvedPath)) {\n\t\t\tthrow new SessionImportFileNotFoundError(resolvedPath);\n\t\t}\n\n\t\tconst sessionDir = this.session.sessionManager.getSessionDir();\n\t\tif (!existsSync(sessionDir)) {\n\t\t\tmkdirSync(sessionDir, { recursive: true });\n\t\t}\n\n\t\tconst destinationPath = join(sessionDir, basename(resolvedPath));\n\t\tconst beforeResult = await this.emitBeforeSwitch(\"resume\", destinationPath);\n\t\tif (beforeResult.cancelled) {\n\t\t\treturn beforeResult;\n\t\t}\n\n\t\tconst previousSessionFile = this.session.sessionFile;\n\t\tif (resolve(destinationPath) !== resolvedPath) {\n\t\t\tcopyFileSync(resolvedPath, destinationPath);\n\t\t}\n\n\t\tconst sessionManager = SessionManager.open(destinationPath, sessionDir, cwdOverride);\n\t\tassertSessionCwdExists(sessionManager, this.cwd);\n\t\tawait this.teardownCurrent(\"resume\", sessionManager.getSessionFile());\n\t\tthis.apply(\n\t\t\tawait this.createRuntime({\n\t\t\t\tcwd: sessionManager.getCwd(),\n\t\t\t\tagentDir: this.services.agentDir,\n\t\t\t\tsessionManager,\n\t\t\t\tsessionStartEvent: { type: \"session_start\", reason: \"resume\", previousSessionFile },\n\t\t\t}),\n\t\t);\n\t\tawait this.finishSessionReplacement(\"resume\");\n\t\treturn { cancelled: false };\n\t}\n\n\tasync dispose(): Promise<void> {\n\t\tawait emitSessionShutdownEvent(this.session.extensionRunner, {\n\t\t\ttype: \"session_shutdown\",\n\t\t\treason: \"quit\",\n\t\t});\n\t\tthis.beforeSessionInvalidate?.();\n\t\tthis.session.dispose();\n\t}\n}\n\n/**\n * Create the initial runtime from a runtime factory and initial session target.\n *\n * The same factory is stored on the returned AgentSessionRuntime and reused for\n * later /new, /resume, /fork, and import flows.\n */\nexport async function createAgentSessionRuntime(\n\tcreateRuntime: CreateAgentSessionRuntimeFactory,\n\toptions: {\n\t\tcwd: string;\n\t\tagentDir: string;\n\t\tsessionManager: SessionManager;\n\t\tsessionStartEvent?: SessionStartEvent;\n\t},\n): Promise<AgentSessionRuntime> {\n\tassertSessionCwdExists(options.sessionManager, options.cwd);\n\tconst result = await createRuntime(options);\n\treturn new AgentSessionRuntime(\n\t\tresult.session,\n\t\tresult.services,\n\t\tcreateRuntime,\n\t\tresult.diagnostics,\n\t\tresult.modelFallbackMessage,\n\t);\n}\n\nexport {\n\ttype AgentSessionRuntimeDiagnostic,\n\ttype AgentSessionServices,\n\ttype CreateAgentSessionFromServicesOptions,\n\ttype CreateAgentSessionServicesOptions,\n\tcreateAgentSessionFromServices,\n\tcreateAgentSessionServices,\n} from \"./agent-session-services.ts\";\n"]}

package/dist/core/agent-session-runtime.js

@@ -1,5 +1,6 @@
 import { copyFileSync, existsSync, mkdirSync } from "node:fs";
 import { basename, join, resolve } from "node:path";
+import { resolvePath } from "../utils/paths.js";
 import { emitSessionShutdownEvent } from "./extensions/runner.js";
 import { assertSessionCwdExists } from "./session-cwd.js";
 import { SessionManager } from "./session-manager.js";
@@ -31,13 +32,13 @@ function extractUserMessageText(content) {
  * caller. The caller is responsible for user-facing error handling.
  */
 export class AgentSessionRuntime {
+    rebindSession;
+    beforeSessionInvalidate;
     _session;
     _services;
     createRuntime;
     _diagnostics;
     _modelFallbackMessage;
-    rebindSession;
-    beforeSessionInvalidate;
     constructor(_session, _services, createRuntime, _diagnostics = [], _modelFallbackMessage) {
         this._session = _session;
         this._services = _services;
@@ -113,9 +114,9 @@ export class AgentSessionRuntime {
         this._diagnostics = result.diagnostics;
         this._modelFallbackMessage = result.modelFallbackMessage;
     }
-    async finishSessionReplacement(withSession) {
+    async finishSessionReplacement(reason, withSession) {
         if (this.rebindSession) {
-            await this.rebindSession(this.session);
+            await this.rebindSession(this.session, reason);
         }
         if (withSession) {
             await withSession(this.session.createReplacedSessionContext());
@@ -136,7 +137,7 @@ export class AgentSessionRuntime {
             sessionManager,
             sessionStartEvent: { type: "session_start", reason: "resume", previousSessionFile },
         }));
-        await this.finishSessionReplacement(options?.withSession);
+        await this.finishSessionReplacement("resume", options?.withSession);
         return { cancelled: false };
     }
     async newSession(options) {
@@ -161,7 +162,7 @@ export class AgentSessionRuntime {
             await options.setup(this.session.sessionManager);
             this.session.agent.state.messages = this.session.sessionManager.buildSessionContext().messages;
         }
-        await this.finishSessionReplacement(options?.withSession);
+        await this.finishSessionReplacement("new", options?.withSession);
         return { cancelled: false };
     }
     async fork(entryId, options) {
@@ -203,15 +204,14 @@ export class AgentSessionRuntime {
                     sessionManager,
                     sessionStartEvent: { type: "session_start", reason: "fork", previousSessionFile },
                 }));
-                await this.finishSessionReplacement(options?.withSession);
+                await this.finishSessionReplacement("fork", options?.withSession);
                 return { cancelled: false, selectedText };
             }
-            const sourceManager = SessionManager.open(currentSessionFile, sessionDir);
-            const forkedSessionPath = sourceManager.createBranchedSession(targetLeafId);
+            const sessionManager = SessionManager.open(currentSessionFile, sessionDir);
+            const forkedSessionPath = sessionManager.createBranchedSession(targetLeafId);
             if (!forkedSessionPath) {
                 throw new Error("Failed to create forked session");
             }
-            const sessionManager = SessionManager.open(forkedSessionPath, sessionDir);
             await this.teardownCurrent("fork", sessionManager.getSessionFile());
             this.apply(await this.createRuntime({
                 cwd: sessionManager.getCwd(),
@@ -219,7 +219,7 @@ export class AgentSessionRuntime {
                 sessionManager,
                 sessionStartEvent: { type: "session_start", reason: "fork", previousSessionFile },
             }));
-            await this.finishSessionReplacement(options?.withSession);
+            await this.finishSessionReplacement("fork", options?.withSession);
             return { cancelled: false, selectedText };
         }
         const sessionManager = this.session.sessionManager;
@@ -236,7 +236,7 @@ export class AgentSessionRuntime {
             sessionManager,
             sessionStartEvent: { type: "session_start", reason: "fork", previousSessionFile },
         }));
-        await this.finishSessionReplacement(options?.withSession);
+        await this.finishSessionReplacement("fork", options?.withSession);
         return { cancelled: false, selectedText };
     }
     /**
@@ -247,7 +247,7 @@ export class AgentSessionRuntime {
      * @throws {MissingSessionCwdError} When the imported session cwd cannot be resolved and no override is provided.
      */
     async importFromJsonl(inputPath, cwdOverride) {
-        const resolvedPath = resolve(inputPath);
+        const resolvedPath = resolvePath(inputPath);
         if (!existsSync(resolvedPath)) {
             throw new SessionImportFileNotFoundError(resolvedPath);
         }
@@ -273,7 +273,7 @@ export class AgentSessionRuntime {
             sessionManager,
             sessionStartEvent: { type: "session_start", reason: "resume", previousSessionFile },
         }));
-        await this.finishSessionReplacement();
+        await this.finishSessionReplacement("resume");
         return { cancelled: false };
     }
     async dispose() {