@fleetagent/pi-coding-agent 0.0.1

package/dist/core/session/stores/session-store.d.ts

@@ -0,0 +1,48 @@
+import type { FileEntry, SessionEntry, SessionHeader, SessionInfo, SessionListProgress, SessionTreeNode } from "../types.ts";
+export interface SessionOpenResult {
+    reference: string;
+    exists: boolean;
+    entries: FileEntry[];
+}
+export interface SessionStore {
+    isPersisted(): boolean;
+    getSessionReference(): string | undefined;
+    setSessionReference(reference: string): void;
+    openSession(reference: string): SessionOpenResult;
+    getSessionDirForReference(reference: string): string;
+    getDefaultSessionDir(cwd: string, agentDir?: string): string;
+    getSessionsRoot(): string;
+    prepareSessionReference(sessionDir: string, sessionId: string, timestamp: string): string | undefined;
+    getParentSessionReference(): string | undefined;
+    exists(path: string): boolean;
+    ensureDir(path: string): void;
+    load(filePath: string): FileEntry[];
+    findMostRecent(sessionDir: string): string | null;
+    list(dir: string, onProgress?: SessionListProgress): Promise<SessionInfo[]>;
+    listAll(sessionsDir: string, onProgress?: SessionListProgress): Promise<SessionInfo[]>;
+    setEntries(entries: FileEntry[]): void;
+    getFileEntries(): FileEntry[];
+    getHeader(): SessionHeader | null;
+    getEntries(): SessionEntry[];
+    getEntryIndex(): Map<string, SessionEntry>;
+    has(id: string): boolean;
+    appendEntry(entry: SessionEntry): void;
+    saveSnapshot(): void;
+    commitSnapshot(): void;
+    getLeafId(): string | null;
+    setLeafId(leafId: string | null): void;
+    getLeafEntry(): SessionEntry | undefined;
+    getEntry(id: string): SessionEntry | undefined;
+    getChildren(parentId: string): SessionEntry[];
+    getLabel(id: string): string | undefined;
+    getBranch(fromId?: string): SessionEntry[];
+    getTree(): SessionTreeNode[];
+    getSessionName(): string | undefined;
+    getLabelsForEntryIds(entryIds: Set<string>): Array<{
+        targetId: string;
+        label: string;
+        timestamp: string;
+    }>;
+    hasAssistantMessage(): boolean;
+}
+//# sourceMappingURL=session-store.d.ts.map

package/dist/core/session/stores/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../../src/core/session/stores/session-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,SAAS,EACT,YAAY,EACZ,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC5B,WAAW,IAAI,OAAO,CAAC;IACvB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAAC;IAC1C,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAClD,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACrD,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7D,eAAe,IAAI,MAAM,CAAC;IAC1B,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACtG,yBAAyB,IAAI,MAAM,GAAG,SAAS,CAAC;IAChD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACpC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5E,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACvF,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACvC,cAAc,IAAI,SAAS,EAAE,CAAC;IAC9B,SAAS,IAAI,aAAa,GAAG,IAAI,CAAC;IAClC,UAAU,IAAI,YAAY,EAAE,CAAC;IAC7B,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC,YAAY,IAAI,IAAI,CAAC;IACrB,cAAc,IAAI,IAAI,CAAC;IACvB,SAAS,IAAI,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACvC,YAAY,IAAI,YAAY,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC/C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IAC3C,OAAO,IAAI,eAAe,EAAE,CAAC;IAC7B,cAAc,IAAI,MAAM,GAAG,SAAS,CAAC;IACrC,oBAAoB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3G,mBAAmB,IAAI,OAAO,CAAC;CAC/B","sourcesContent":["import type {\n\tFileEntry,\n\tSessionEntry,\n\tSessionHeader,\n\tSessionInfo,\n\tSessionListProgress,\n\tSessionTreeNode,\n} from \"../types.ts\";\n\nexport interface SessionOpenResult {\n\treference: string;\n\texists: boolean;\n\tentries: FileEntry[];\n}\n\nexport interface SessionStore {\n\tisPersisted(): boolean;\n\tgetSessionReference(): string | undefined;\n\tsetSessionReference(reference: string): void;\n\topenSession(reference: string): SessionOpenResult;\n\tgetSessionDirForReference(reference: string): string;\n\tgetDefaultSessionDir(cwd: string, agentDir?: string): string;\n\tgetSessionsRoot(): string;\n\tprepareSessionReference(sessionDir: string, sessionId: string, timestamp: string): string | undefined;\n\tgetParentSessionReference(): string | undefined;\n\texists(path: string): boolean;\n\tensureDir(path: string): void;\n\tload(filePath: string): FileEntry[];\n\tfindMostRecent(sessionDir: string): string | null;\n\tlist(dir: string, onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\tlistAll(sessionsDir: string, onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\tsetEntries(entries: FileEntry[]): void;\n\tgetFileEntries(): FileEntry[];\n\tgetHeader(): SessionHeader | null;\n\tgetEntries(): SessionEntry[];\n\tgetEntryIndex(): Map<string, SessionEntry>;\n\thas(id: string): boolean;\n\tappendEntry(entry: SessionEntry): void;\n\tsaveSnapshot(): void;\n\tcommitSnapshot(): void;\n\tgetLeafId(): string | null;\n\tsetLeafId(leafId: string | null): void;\n\tgetLeafEntry(): SessionEntry | undefined;\n\tgetEntry(id: string): SessionEntry | undefined;\n\tgetChildren(parentId: string): SessionEntry[];\n\tgetLabel(id: string): string | undefined;\n\tgetBranch(fromId?: string): SessionEntry[];\n\tgetTree(): SessionTreeNode[];\n\tgetSessionName(): string | undefined;\n\tgetLabelsForEntryIds(entryIds: Set<string>): Array<{ targetId: string; label: string; timestamp: string }>;\n\thasAssistantMessage(): boolean;\n}\n"]}

package/dist/core/session/stores/session-store.js

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

package/dist/core/session/stores/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../../../src/core/session/stores/session-store.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tFileEntry,\n\tSessionEntry,\n\tSessionHeader,\n\tSessionInfo,\n\tSessionListProgress,\n\tSessionTreeNode,\n} from \"../types.ts\";\n\nexport interface SessionOpenResult {\n\treference: string;\n\texists: boolean;\n\tentries: FileEntry[];\n}\n\nexport interface SessionStore {\n\tisPersisted(): boolean;\n\tgetSessionReference(): string | undefined;\n\tsetSessionReference(reference: string): void;\n\topenSession(reference: string): SessionOpenResult;\n\tgetSessionDirForReference(reference: string): string;\n\tgetDefaultSessionDir(cwd: string, agentDir?: string): string;\n\tgetSessionsRoot(): string;\n\tprepareSessionReference(sessionDir: string, sessionId: string, timestamp: string): string | undefined;\n\tgetParentSessionReference(): string | undefined;\n\texists(path: string): boolean;\n\tensureDir(path: string): void;\n\tload(filePath: string): FileEntry[];\n\tfindMostRecent(sessionDir: string): string | null;\n\tlist(dir: string, onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\tlistAll(sessionsDir: string, onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\tsetEntries(entries: FileEntry[]): void;\n\tgetFileEntries(): FileEntry[];\n\tgetHeader(): SessionHeader | null;\n\tgetEntries(): SessionEntry[];\n\tgetEntryIndex(): Map<string, SessionEntry>;\n\thas(id: string): boolean;\n\tappendEntry(entry: SessionEntry): void;\n\tsaveSnapshot(): void;\n\tcommitSnapshot(): void;\n\tgetLeafId(): string | null;\n\tsetLeafId(leafId: string | null): void;\n\tgetLeafEntry(): SessionEntry | undefined;\n\tgetEntry(id: string): SessionEntry | undefined;\n\tgetChildren(parentId: string): SessionEntry[];\n\tgetLabel(id: string): string | undefined;\n\tgetBranch(fromId?: string): SessionEntry[];\n\tgetTree(): SessionTreeNode[];\n\tgetSessionName(): string | undefined;\n\tgetLabelsForEntryIds(entryIds: Set<string>): Array<{ targetId: string; label: string; timestamp: string }>;\n\thasAssistantMessage(): boolean;\n}\n"]}

package/dist/core/session/types.d.ts

@@ -0,0 +1,138 @@
+import type { AgentMessage } from "@fleetagent/pi-agent-core";
+import type { ImageContent, TextContent } from "@fleetagent/pi-ai";
+export interface SessionHeader {
+    type: "session";
+    version?: number;
+    id: string;
+    timestamp: string;
+    cwd: string;
+    parentSession?: string;
+}
+export interface NewSessionOptions {
+    id?: string;
+    parentSession?: string;
+}
+export interface SessionEntryBase {
+    type: string;
+    id: string;
+    parentId: string | null;
+    timestamp: string;
+}
+export interface SessionMessageEntry extends SessionEntryBase {
+    type: "message";
+    message: AgentMessage;
+}
+export interface ThinkingLevelChangeEntry extends SessionEntryBase {
+    type: "thinking_level_change";
+    thinkingLevel: string;
+}
+export interface ModelChangeEntry extends SessionEntryBase {
+    type: "model_change";
+    provider: string;
+    modelId: string;
+}
+export interface CompactionEntry<T = unknown> extends SessionEntryBase {
+    type: "compaction";
+    summary: string;
+    firstKeptEntryId: string;
+    tokensBefore: number;
+    /** Extension-specific data (e.g., ArtifactIndex, version markers for structured compaction) */
+    details?: T;
+    /** True if generated by an extension, undefined/false if pi-generated (backward compatible) */
+    fromHook?: boolean;
+}
+export interface BranchSummaryEntry<T = unknown> extends SessionEntryBase {
+    type: "branch_summary";
+    fromId: string;
+    summary: string;
+    /** Extension-specific data (not sent to LLM) */
+    details?: T;
+    /** True if generated by an extension, false if pi-generated */
+    fromHook?: boolean;
+}
+/**
+ * Custom entry for extensions to store extension-specific data in the session.
+ * Use customType to identify your extension's entries.
+ *
+ * Purpose: Persist extension state across session reloads. On reload, extensions can
+ * scan entries for their customType and reconstruct internal state.
+ *
+ * Does NOT participate in LLM context (ignored by buildSessionContext).
+ * For injecting content into context, see CustomMessageEntry.
+ */
+export interface CustomEntry<T = unknown> extends SessionEntryBase {
+    type: "custom";
+    customType: string;
+    data?: T;
+}
+/** Label entry for user-defined bookmarks/markers on entries. */
+export interface LabelEntry extends SessionEntryBase {
+    type: "label";
+    targetId: string;
+    label: string | undefined;
+}
+/** Session metadata entry (e.g., user-defined display name). */
+export interface SessionInfoEntry extends SessionEntryBase {
+    type: "session_info";
+    name?: string;
+}
+/**
+ * Custom message entry for extensions to inject messages into LLM context.
+ * Use customType to identify your extension's entries.
+ *
+ * Unlike CustomEntry, this DOES participate in LLM context.
+ * The content is converted to a user message in buildSessionContext().
+ * Use details for extension-specific metadata (not sent to LLM).
+ *
+ * display controls TUI rendering:
+ * - false: hidden entirely
+ * - true: rendered with distinct styling (different from user messages)
+ */
+export interface CustomMessageEntry<T = unknown> extends SessionEntryBase {
+    type: "custom_message";
+    customType: string;
+    content: string | (TextContent | ImageContent)[];
+    details?: T;
+    display: boolean;
+}
+/** Session entry - has id/parentId for tree structure (returned by "read" methods in SessionManager) */
+export type SessionEntry = SessionMessageEntry | ThinkingLevelChangeEntry | ModelChangeEntry | CompactionEntry | BranchSummaryEntry | CustomEntry | CustomMessageEntry | LabelEntry | SessionInfoEntry;
+/** Raw file entry (includes header) */
+export type FileEntry = SessionHeader | SessionEntry;
+/** Tree node for getTree() - defensive copy of session structure */
+export interface SessionTreeNode {
+    entry: SessionEntry;
+    children: SessionTreeNode[];
+    /** Resolved label for this entry, if any */
+    label?: string;
+    /** Timestamp of the latest label change for this entry, if any */
+    labelTimestamp?: string;
+}
+export interface SessionContext {
+    messages: AgentMessage[];
+    thinkingLevel: string;
+    model: {
+        provider: string;
+        modelId: string;
+    } | null;
+}
+export interface SessionInfo {
+    /** Backend-neutral session reference. Defaults to path for JSONL compatibility when omitted. */
+    reference?: string;
+    /** JSONL compatibility alias for reference. */
+    path: string;
+    id: string;
+    /** Working directory where the session was started. Empty string for old sessions. */
+    cwd: string;
+    /** User-defined display name from session_info entries. */
+    name?: string;
+    /** Path to the parent session (if this session was forked). */
+    parentSessionPath?: string;
+    created: Date;
+    modified: Date;
+    messageCount: number;
+    firstMessage: string;
+    allMessagesText: string;
+}
+export type SessionListProgress = (loaded: number, total: number) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/session/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/session/types.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentMessage } from \"@fleetagent/pi-agent-core\";\nimport type { ImageContent, TextContent } from \"@fleetagent/pi-ai\";\n\nexport interface SessionHeader {\n\ttype: \"session\";\n\tversion?: number; // v1 sessions don't have this\n\tid: string;\n\ttimestamp: string;\n\tcwd: string;\n\tparentSession?: string;\n}\n\nexport interface NewSessionOptions {\n\tid?: string;\n\tparentSession?: string;\n}\n\nexport interface SessionEntryBase {\n\ttype: string;\n\tid: string;\n\tparentId: string | null;\n\ttimestamp: string;\n}\n\nexport interface SessionMessageEntry extends SessionEntryBase {\n\ttype: \"message\";\n\tmessage: AgentMessage;\n}\n\nexport interface ThinkingLevelChangeEntry extends SessionEntryBase {\n\ttype: \"thinking_level_change\";\n\tthinkingLevel: string;\n}\n\nexport interface ModelChangeEntry extends SessionEntryBase {\n\ttype: \"model_change\";\n\tprovider: string;\n\tmodelId: string;\n}\n\nexport interface CompactionEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"compaction\";\n\tsummary: string;\n\tfirstKeptEntryId: string;\n\ttokensBefore: number;\n\t/** Extension-specific data (e.g., ArtifactIndex, version markers for structured compaction) */\n\tdetails?: T;\n\t/** True if generated by an extension, undefined/false if pi-generated (backward compatible) */\n\tfromHook?: boolean;\n}\n\nexport interface BranchSummaryEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"branch_summary\";\n\tfromId: string;\n\tsummary: string;\n\t/** Extension-specific data (not sent to LLM) */\n\tdetails?: T;\n\t/** True if generated by an extension, false if pi-generated */\n\tfromHook?: boolean;\n}\n\n/**\n * Custom entry for extensions to store extension-specific data in the session.\n * Use customType to identify your extension's entries.\n *\n * Purpose: Persist extension state across session reloads. On reload, extensions can\n * scan entries for their customType and reconstruct internal state.\n *\n * Does NOT participate in LLM context (ignored by buildSessionContext).\n * For injecting content into context, see CustomMessageEntry.\n */\nexport interface CustomEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"custom\";\n\tcustomType: string;\n\tdata?: T;\n}\n\n/** Label entry for user-defined bookmarks/markers on entries. */\nexport interface LabelEntry extends SessionEntryBase {\n\ttype: \"label\";\n\ttargetId: string;\n\tlabel: string | undefined;\n}\n\n/** Session metadata entry (e.g., user-defined display name). */\nexport interface SessionInfoEntry extends SessionEntryBase {\n\ttype: \"session_info\";\n\tname?: string;\n}\n\n/**\n * Custom message entry for extensions to inject messages into LLM context.\n * Use customType to identify your extension's entries.\n *\n * Unlike CustomEntry, this DOES participate in LLM context.\n * The content is converted to a user message in buildSessionContext().\n * Use details for extension-specific metadata (not sent to LLM).\n *\n * display controls TUI rendering:\n * - false: hidden entirely\n * - true: rendered with distinct styling (different from user messages)\n */\nexport interface CustomMessageEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"custom_message\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdetails?: T;\n\tdisplay: boolean;\n}\n\n/** Session entry - has id/parentId for tree structure (returned by \"read\" methods in SessionManager) */\nexport type SessionEntry =\n\t| SessionMessageEntry\n\t| ThinkingLevelChangeEntry\n\t| ModelChangeEntry\n\t| CompactionEntry\n\t| BranchSummaryEntry\n\t| CustomEntry\n\t| CustomMessageEntry\n\t| LabelEntry\n\t| SessionInfoEntry;\n\n/** Raw file entry (includes header) */\nexport type FileEntry = SessionHeader | SessionEntry;\n\n/** Tree node for getTree() - defensive copy of session structure */\nexport interface SessionTreeNode {\n\tentry: SessionEntry;\n\tchildren: SessionTreeNode[];\n\t/** Resolved label for this entry, if any */\n\tlabel?: string;\n\t/** Timestamp of the latest label change for this entry, if any */\n\tlabelTimestamp?: string;\n}\n\nexport interface SessionContext {\n\tmessages: AgentMessage[];\n\tthinkingLevel: string;\n\tmodel: { provider: string; modelId: string } | null;\n}\n\nexport interface SessionInfo {\n\t/** Backend-neutral session reference. Defaults to path for JSONL compatibility when omitted. */\n\treference?: string;\n\t/** JSONL compatibility alias for reference. */\n\tpath: string;\n\tid: string;\n\t/** Working directory where the session was started. Empty string for old sessions. */\n\tcwd: string;\n\t/** User-defined display name from session_info entries. */\n\tname?: string;\n\t/** Path to the parent session (if this session was forked). */\n\tparentSessionPath?: string;\n\tcreated: Date;\n\tmodified: Date;\n\tmessageCount: number;\n\tfirstMessage: string;\n\tallMessagesText: string;\n}\n\nexport type SessionListProgress = (loaded: number, total: number) => void;\n"]}

package/dist/core/session/types.js

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

package/dist/core/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/session/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentMessage } from \"@fleetagent/pi-agent-core\";\nimport type { ImageContent, TextContent } from \"@fleetagent/pi-ai\";\n\nexport interface SessionHeader {\n\ttype: \"session\";\n\tversion?: number; // v1 sessions don't have this\n\tid: string;\n\ttimestamp: string;\n\tcwd: string;\n\tparentSession?: string;\n}\n\nexport interface NewSessionOptions {\n\tid?: string;\n\tparentSession?: string;\n}\n\nexport interface SessionEntryBase {\n\ttype: string;\n\tid: string;\n\tparentId: string | null;\n\ttimestamp: string;\n}\n\nexport interface SessionMessageEntry extends SessionEntryBase {\n\ttype: \"message\";\n\tmessage: AgentMessage;\n}\n\nexport interface ThinkingLevelChangeEntry extends SessionEntryBase {\n\ttype: \"thinking_level_change\";\n\tthinkingLevel: string;\n}\n\nexport interface ModelChangeEntry extends SessionEntryBase {\n\ttype: \"model_change\";\n\tprovider: string;\n\tmodelId: string;\n}\n\nexport interface CompactionEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"compaction\";\n\tsummary: string;\n\tfirstKeptEntryId: string;\n\ttokensBefore: number;\n\t/** Extension-specific data (e.g., ArtifactIndex, version markers for structured compaction) */\n\tdetails?: T;\n\t/** True if generated by an extension, undefined/false if pi-generated (backward compatible) */\n\tfromHook?: boolean;\n}\n\nexport interface BranchSummaryEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"branch_summary\";\n\tfromId: string;\n\tsummary: string;\n\t/** Extension-specific data (not sent to LLM) */\n\tdetails?: T;\n\t/** True if generated by an extension, false if pi-generated */\n\tfromHook?: boolean;\n}\n\n/**\n * Custom entry for extensions to store extension-specific data in the session.\n * Use customType to identify your extension's entries.\n *\n * Purpose: Persist extension state across session reloads. On reload, extensions can\n * scan entries for their customType and reconstruct internal state.\n *\n * Does NOT participate in LLM context (ignored by buildSessionContext).\n * For injecting content into context, see CustomMessageEntry.\n */\nexport interface CustomEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"custom\";\n\tcustomType: string;\n\tdata?: T;\n}\n\n/** Label entry for user-defined bookmarks/markers on entries. */\nexport interface LabelEntry extends SessionEntryBase {\n\ttype: \"label\";\n\ttargetId: string;\n\tlabel: string | undefined;\n}\n\n/** Session metadata entry (e.g., user-defined display name). */\nexport interface SessionInfoEntry extends SessionEntryBase {\n\ttype: \"session_info\";\n\tname?: string;\n}\n\n/**\n * Custom message entry for extensions to inject messages into LLM context.\n * Use customType to identify your extension's entries.\n *\n * Unlike CustomEntry, this DOES participate in LLM context.\n * The content is converted to a user message in buildSessionContext().\n * Use details for extension-specific metadata (not sent to LLM).\n *\n * display controls TUI rendering:\n * - false: hidden entirely\n * - true: rendered with distinct styling (different from user messages)\n */\nexport interface CustomMessageEntry<T = unknown> extends SessionEntryBase {\n\ttype: \"custom_message\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdetails?: T;\n\tdisplay: boolean;\n}\n\n/** Session entry - has id/parentId for tree structure (returned by \"read\" methods in SessionManager) */\nexport type SessionEntry =\n\t| SessionMessageEntry\n\t| ThinkingLevelChangeEntry\n\t| ModelChangeEntry\n\t| CompactionEntry\n\t| BranchSummaryEntry\n\t| CustomEntry\n\t| CustomMessageEntry\n\t| LabelEntry\n\t| SessionInfoEntry;\n\n/** Raw file entry (includes header) */\nexport type FileEntry = SessionHeader | SessionEntry;\n\n/** Tree node for getTree() - defensive copy of session structure */\nexport interface SessionTreeNode {\n\tentry: SessionEntry;\n\tchildren: SessionTreeNode[];\n\t/** Resolved label for this entry, if any */\n\tlabel?: string;\n\t/** Timestamp of the latest label change for this entry, if any */\n\tlabelTimestamp?: string;\n}\n\nexport interface SessionContext {\n\tmessages: AgentMessage[];\n\tthinkingLevel: string;\n\tmodel: { provider: string; modelId: string } | null;\n}\n\nexport interface SessionInfo {\n\t/** Backend-neutral session reference. Defaults to path for JSONL compatibility when omitted. */\n\treference?: string;\n\t/** JSONL compatibility alias for reference. */\n\tpath: string;\n\tid: string;\n\t/** Working directory where the session was started. Empty string for old sessions. */\n\tcwd: string;\n\t/** User-defined display name from session_info entries. */\n\tname?: string;\n\t/** Path to the parent session (if this session was forked). */\n\tparentSessionPath?: string;\n\tcreated: Date;\n\tmodified: Date;\n\tmessageCount: number;\n\tfirstMessage: string;\n\tallMessagesText: string;\n}\n\nexport type SessionListProgress = (loaded: number, total: number) => void;\n"]}

package/dist/core/session-cwd.d.ts

@@ -0,0 +1,19 @@
+export interface SessionCwdIssue {
+    sessionReference?: string;
+    sessionCwd: string;
+    fallbackCwd: string;
+}
+interface SessionCwdSource {
+    getCwd(): string;
+    getSessionReference(): string | undefined;
+}
+export declare function getMissingSessionCwdIssue(sessionManager: SessionCwdSource, fallbackCwd: string): SessionCwdIssue | undefined;
+export declare function formatMissingSessionCwdError(issue: SessionCwdIssue): string;
+export declare function formatMissingSessionCwdPrompt(issue: SessionCwdIssue): string;
+export declare class MissingSessionCwdError extends Error {
+    readonly issue: SessionCwdIssue;
+    constructor(issue: SessionCwdIssue);
+}
+export declare function assertSessionCwdExists(sessionManager: SessionCwdSource, fallbackCwd: string): void;
+export {};
+//# sourceMappingURL=session-cwd.d.ts.map

package/dist/core/session-cwd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cwd.d.ts","sourceRoot":"","sources":["../../src/core/session-cwd.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,gBAAgB;IACzB,MAAM,IAAI,MAAM,CAAC;IACjB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,wBAAgB,yBAAyB,CACxC,cAAc,EAAE,gBAAgB,EAChC,WAAW,EAAE,MAAM,GACjB,eAAe,GAAG,SAAS,CAgB7B;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAG3E;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAE5E;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAEhC,YAAY,KAAK,EAAE,eAAe,EAIjC;CACD;AAED,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAKlG","sourcesContent":["import { existsSync } from \"node:fs\";\n\nexport interface SessionCwdIssue {\n\tsessionReference?: string;\n\tsessionCwd: string;\n\tfallbackCwd: string;\n}\n\ninterface SessionCwdSource {\n\tgetCwd(): string;\n\tgetSessionReference(): string | undefined;\n}\n\nexport function getMissingSessionCwdIssue(\n\tsessionManager: SessionCwdSource,\n\tfallbackCwd: string,\n): SessionCwdIssue | undefined {\n\tconst sessionReference = sessionManager.getSessionReference();\n\tif (!sessionReference) {\n\t\treturn undefined;\n\t}\n\n\tconst sessionCwd = sessionManager.getCwd();\n\tif (!sessionCwd || existsSync(sessionCwd)) {\n\t\treturn undefined;\n\t}\n\n\treturn {\n\t\tsessionReference,\n\t\tsessionCwd,\n\t\tfallbackCwd,\n\t};\n}\n\nexport function formatMissingSessionCwdError(issue: SessionCwdIssue): string {\n\tconst sessionReference = issue.sessionReference ? `\\nSession reference: ${issue.sessionReference}` : \"\";\n\treturn `Stored session working directory does not exist: ${issue.sessionCwd}${sessionReference}\\nCurrent working directory: ${issue.fallbackCwd}`;\n}\n\nexport function formatMissingSessionCwdPrompt(issue: SessionCwdIssue): string {\n\treturn `cwd from session does not exist\\n${issue.sessionCwd}\\n\\ncontinue in current cwd\\n${issue.fallbackCwd}`;\n}\n\nexport class MissingSessionCwdError extends Error {\n\treadonly issue: SessionCwdIssue;\n\n\tconstructor(issue: SessionCwdIssue) {\n\t\tsuper(formatMissingSessionCwdError(issue));\n\t\tthis.name = \"MissingSessionCwdError\";\n\t\tthis.issue = issue;\n\t}\n}\n\nexport function assertSessionCwdExists(sessionManager: SessionCwdSource, fallbackCwd: string): void {\n\tconst issue = getMissingSessionCwdIssue(sessionManager, fallbackCwd);\n\tif (issue) {\n\t\tthrow new MissingSessionCwdError(issue);\n\t}\n}\n"]}

package/dist/core/session-cwd.js

@@ -0,0 +1,38 @@
+import { existsSync } from "node:fs";
+export function getMissingSessionCwdIssue(sessionManager, fallbackCwd) {
+    const sessionReference = sessionManager.getSessionReference();
+    if (!sessionReference) {
+        return undefined;
+    }
+    const sessionCwd = sessionManager.getCwd();
+    if (!sessionCwd || existsSync(sessionCwd)) {
+        return undefined;
+    }
+    return {
+        sessionReference,
+        sessionCwd,
+        fallbackCwd,
+    };
+}
+export function formatMissingSessionCwdError(issue) {
+    const sessionReference = issue.sessionReference ? `\nSession reference: ${issue.sessionReference}` : "";
+    return `Stored session working directory does not exist: ${issue.sessionCwd}${sessionReference}\nCurrent working directory: ${issue.fallbackCwd}`;
+}
+export function formatMissingSessionCwdPrompt(issue) {
+    return `cwd from session does not exist\n${issue.sessionCwd}\n\ncontinue in current cwd\n${issue.fallbackCwd}`;
+}
+export class MissingSessionCwdError extends Error {
+    issue;
+    constructor(issue) {
+        super(formatMissingSessionCwdError(issue));
+        this.name = "MissingSessionCwdError";
+        this.issue = issue;
+    }
+}
+export function assertSessionCwdExists(sessionManager, fallbackCwd) {
+    const issue = getMissingSessionCwdIssue(sessionManager, fallbackCwd);
+    if (issue) {
+        throw new MissingSessionCwdError(issue);
+    }
+}
+//# sourceMappingURL=session-cwd.js.map

package/dist/core/session-cwd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cwd.js","sourceRoot":"","sources":["../../src/core/session-cwd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAarC,MAAM,UAAU,yBAAyB,CACxC,cAAgC,EAChC,WAAmB,EACW;IAC9B,MAAM,gBAAgB,GAAG,cAAc,CAAC,mBAAmB,EAAE,CAAC;IAC9D,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC;IAC3C,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO;QACN,gBAAgB;QAChB,UAAU;QACV,WAAW;KACX,CAAC;AAAA,CACF;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAsB,EAAU;IAC5E,MAAM,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,wBAAwB,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,OAAO,oDAAoD,KAAK,CAAC,UAAU,GAAG,gBAAgB,gCAAgC,KAAK,CAAC,WAAW,EAAE,CAAC;AAAA,CAClJ;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAsB,EAAU;IAC7E,OAAO,oCAAoC,KAAK,CAAC,UAAU,gCAAgC,KAAK,CAAC,WAAW,EAAE,CAAC;AAAA,CAC/G;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACvC,KAAK,CAAkB;IAEhC,YAAY,KAAsB,EAAE;QACnC,KAAK,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAAA,CACnB;CACD;AAED,MAAM,UAAU,sBAAsB,CAAC,cAAgC,EAAE,WAAmB,EAAQ;IACnG,MAAM,KAAK,GAAG,yBAAyB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACrE,IAAI,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;AAAA,CACD","sourcesContent":["import { existsSync } from \"node:fs\";\n\nexport interface SessionCwdIssue {\n\tsessionReference?: string;\n\tsessionCwd: string;\n\tfallbackCwd: string;\n}\n\ninterface SessionCwdSource {\n\tgetCwd(): string;\n\tgetSessionReference(): string | undefined;\n}\n\nexport function getMissingSessionCwdIssue(\n\tsessionManager: SessionCwdSource,\n\tfallbackCwd: string,\n): SessionCwdIssue | undefined {\n\tconst sessionReference = sessionManager.getSessionReference();\n\tif (!sessionReference) {\n\t\treturn undefined;\n\t}\n\n\tconst sessionCwd = sessionManager.getCwd();\n\tif (!sessionCwd || existsSync(sessionCwd)) {\n\t\treturn undefined;\n\t}\n\n\treturn {\n\t\tsessionReference,\n\t\tsessionCwd,\n\t\tfallbackCwd,\n\t};\n}\n\nexport function formatMissingSessionCwdError(issue: SessionCwdIssue): string {\n\tconst sessionReference = issue.sessionReference ? `\\nSession reference: ${issue.sessionReference}` : \"\";\n\treturn `Stored session working directory does not exist: ${issue.sessionCwd}${sessionReference}\\nCurrent working directory: ${issue.fallbackCwd}`;\n}\n\nexport function formatMissingSessionCwdPrompt(issue: SessionCwdIssue): string {\n\treturn `cwd from session does not exist\\n${issue.sessionCwd}\\n\\ncontinue in current cwd\\n${issue.fallbackCwd}`;\n}\n\nexport class MissingSessionCwdError extends Error {\n\treadonly issue: SessionCwdIssue;\n\n\tconstructor(issue: SessionCwdIssue) {\n\t\tsuper(formatMissingSessionCwdError(issue));\n\t\tthis.name = \"MissingSessionCwdError\";\n\t\tthis.issue = issue;\n\t}\n}\n\nexport function assertSessionCwdExists(sessionManager: SessionCwdSource, fallbackCwd: string): void {\n\tconst issue = getMissingSessionCwdIssue(sessionManager, fallbackCwd);\n\tif (issue) {\n\t\tthrow new MissingSessionCwdError(issue);\n\t}\n}\n"]}

package/dist/core/session-manager.d.ts

@@ -0,0 +1,2 @@
+export * from "./session/index.ts";
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/core/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/core/session-manager.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC","sourcesContent":["export * from \"./session/index.ts\";\n"]}

package/dist/core/session-manager.js

@@ -0,0 +1,2 @@
+export * from "./session/index.js";
+//# sourceMappingURL=session-manager.js.map

package/dist/core/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../src/core/session-manager.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC","sourcesContent":["export * from \"./session/index.ts\";\n"]}

package/dist/core/settings-manager.d.ts

@@ -0,0 +1,264 @@
+import type { Transport } from "@fleetagent/pi-ai";
+export interface CompactionSettings {
+    enabled?: boolean;
+    reserveTokens?: number;
+    keepRecentTokens?: number;
+}
+export interface BranchSummarySettings {
+    reserveTokens?: number;
+    skipPrompt?: boolean;
+}
+export interface ProviderRetrySettings {
+    timeoutMs?: number;
+    maxRetries?: number;
+    maxRetryDelayMs?: number;
+}
+export interface RetrySettings {
+    enabled?: boolean;
+    maxRetries?: number;
+    baseDelayMs?: number;
+    provider?: ProviderRetrySettings;
+}
+export interface TerminalSettings {
+    showImages?: boolean;
+    imageWidthCells?: number;
+    clearOnShrink?: boolean;
+    showTerminalProgress?: boolean;
+}
+export interface ImageSettings {
+    autoResize?: boolean;
+    blockImages?: boolean;
+}
+export interface ThinkingBudgetsSettings {
+    minimal?: number;
+    low?: number;
+    medium?: number;
+    high?: number;
+}
+export interface MarkdownSettings {
+    codeBlockIndent?: string;
+}
+export interface WarningSettings {
+    anthropicExtraUsage?: boolean;
+}
+export type TransportSetting = Transport;
+/**
+ * Package source for npm/git packages.
+ * - String form: load all resources from the package
+ * - Object form: filter which resources to load
+ */
+export type PackageSource = string | {
+    source: string;
+    extensions?: string[];
+    skills?: string[];
+    prompts?: string[];
+    themes?: string[];
+};
+export interface Settings {
+    lastChangelogVersion?: string;
+    defaultProvider?: string;
+    defaultModel?: string;
+    defaultThinkingLevel?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    transport?: TransportSetting;
+    steeringMode?: "all" | "one-at-a-time";
+    followUpMode?: "all" | "one-at-a-time";
+    theme?: string;
+    compaction?: CompactionSettings;
+    branchSummary?: BranchSummarySettings;
+    retry?: RetrySettings;
+    hideThinkingBlock?: boolean;
+    shellPath?: string;
+    quietStartup?: boolean;
+    shellCommandPrefix?: string;
+    npmCommand?: string[];
+    collapseChangelog?: boolean;
+    enableInstallTelemetry?: boolean;
+    packages?: PackageSource[];
+    extensions?: string[];
+    skills?: string[];
+    prompts?: string[];
+    themes?: string[];
+    enableSkillCommands?: boolean;
+    terminal?: TerminalSettings;
+    images?: ImageSettings;
+    enabledModels?: string[];
+    doubleEscapeAction?: "fork" | "tree" | "none";
+    treeFilterMode?: "default" | "no-tools" | "user-only" | "labeled-only" | "all";
+    thinkingBudgets?: ThinkingBudgetsSettings;
+    editorPaddingX?: number;
+    autocompleteMaxVisible?: number;
+    showHardwareCursor?: boolean;
+    markdown?: MarkdownSettings;
+    warnings?: WarningSettings;
+    sessionDir?: string;
+    httpIdleTimeoutMs?: number;
+}
+export type SettingsScope = "global" | "project";
+export interface SettingsStorage {
+    withLock(scope: SettingsScope, fn: (current: string | undefined) => string | undefined): void;
+}
+export interface SettingsError {
+    scope: SettingsScope;
+    error: Error;
+}
+export declare class FileSettingsStorage implements SettingsStorage {
+    private globalSettingsPath;
+    private projectSettingsPath;
+    constructor(cwd: string, agentDir: string);
+    private acquireLockSyncWithRetry;
+    withLock(scope: SettingsScope, fn: (current: string | undefined) => string | undefined): void;
+}
+export declare class InMemorySettingsStorage implements SettingsStorage {
+    private global;
+    private project;
+    withLock(scope: SettingsScope, fn: (current: string | undefined) => string | undefined): void;
+}
+export declare class SettingsManager {
+    private storage;
+    private globalSettings;
+    private projectSettings;
+    private settings;
+    private modifiedFields;
+    private modifiedNestedFields;
+    private modifiedProjectFields;
+    private modifiedProjectNestedFields;
+    private globalSettingsLoadError;
+    private projectSettingsLoadError;
+    private writeQueue;
+    private errors;
+    private constructor();
+    /** Create a SettingsManager that loads from files */
+    static create(cwd: string, agentDir?: string): SettingsManager;
+    /** Create a SettingsManager from an arbitrary storage backend */
+    static fromStorage(storage: SettingsStorage): SettingsManager;
+    /** Create an in-memory SettingsManager (no file I/O) */
+    static inMemory(settings?: Partial<Settings>): SettingsManager;
+    private static loadFromStorage;
+    private static tryLoadFromStorage;
+    /** Migrate old settings format to new format */
+    private static migrateSettings;
+    getGlobalSettings(): Settings;
+    getProjectSettings(): Settings;
+    reload(): Promise<void>;
+    /** Apply additional overrides on top of current settings */
+    applyOverrides(overrides: Partial<Settings>): void;
+    /** Mark a global field as modified during this session */
+    private markModified;
+    /** Mark a project field as modified during this session */
+    private markProjectModified;
+    private recordError;
+    private clearModifiedScope;
+    private enqueueWrite;
+    private cloneModifiedNestedFields;
+    private persistScopedSettings;
+    private save;
+    private saveProjectSettings;
+    flush(): Promise<void>;
+    drainErrors(): SettingsError[];
+    getLastChangelogVersion(): string | undefined;
+    setLastChangelogVersion(version: string): void;
+    getSessionDir(): string | undefined;
+    getDefaultProvider(): string | undefined;
+    getDefaultModel(): string | undefined;
+    setDefaultProvider(provider: string): void;
+    setDefaultModel(modelId: string): void;
+    setDefaultModelAndProvider(provider: string, modelId: string): void;
+    getSteeringMode(): "all" | "one-at-a-time";
+    setSteeringMode(mode: "all" | "one-at-a-time"): void;
+    getFollowUpMode(): "all" | "one-at-a-time";
+    setFollowUpMode(mode: "all" | "one-at-a-time"): void;
+    getTheme(): string | undefined;
+    setTheme(theme: string): void;
+    getDefaultThinkingLevel(): "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
+    setDefaultThinkingLevel(level: "off" | "minimal" | "low" | "medium" | "high" | "xhigh"): void;
+    getTransport(): TransportSetting;
+    setTransport(transport: TransportSetting): void;
+    getCompactionEnabled(): boolean;
+    setCompactionEnabled(enabled: boolean): void;
+    getCompactionReserveTokens(): number;
+    getCompactionKeepRecentTokens(): number;
+    getCompactionSettings(): {
+        enabled: boolean;
+        reserveTokens: number;
+        keepRecentTokens: number;
+    };
+    getBranchSummarySettings(): {
+        reserveTokens: number;
+        skipPrompt: boolean;
+    };
+    getBranchSummarySkipPrompt(): boolean;
+    getRetryEnabled(): boolean;
+    setRetryEnabled(enabled: boolean): void;
+    getRetrySettings(): {
+        enabled: boolean;
+        maxRetries: number;
+        baseDelayMs: number;
+    };
+    getHttpIdleTimeoutMs(): number;
+    setHttpIdleTimeoutMs(timeoutMs: number): void;
+    getProviderRetrySettings(): {
+        timeoutMs?: number;
+        maxRetries?: number;
+        maxRetryDelayMs: number;
+    };
+    getHideThinkingBlock(): boolean;
+    setHideThinkingBlock(hide: boolean): void;
+    getShellPath(): string | undefined;
+    setShellPath(path: string | undefined): void;
+    getQuietStartup(): boolean;
+    setQuietStartup(quiet: boolean): void;
+    getShellCommandPrefix(): string | undefined;
+    setShellCommandPrefix(prefix: string | undefined): void;
+    getNpmCommand(): string[] | undefined;
+    setNpmCommand(command: string[] | undefined): void;
+    getCollapseChangelog(): boolean;
+    setCollapseChangelog(collapse: boolean): void;
+    getEnableInstallTelemetry(): boolean;
+    setEnableInstallTelemetry(enabled: boolean): void;
+    getPackages(): PackageSource[];
+    setPackages(packages: PackageSource[]): void;
+    setProjectPackages(packages: PackageSource[]): void;
+    getExtensionPaths(): string[];
+    setExtensionPaths(paths: string[]): void;
+    setProjectExtensionPaths(paths: string[]): void;
+    getSkillPaths(): string[];
+    setSkillPaths(paths: string[]): void;
+    setProjectSkillPaths(paths: string[]): void;
+    getPromptTemplatePaths(): string[];
+    setPromptTemplatePaths(paths: string[]): void;
+    setProjectPromptTemplatePaths(paths: string[]): void;
+    getThemePaths(): string[];
+    setThemePaths(paths: string[]): void;
+    setProjectThemePaths(paths: string[]): void;
+    getEnableSkillCommands(): boolean;
+    setEnableSkillCommands(enabled: boolean): void;
+    getThinkingBudgets(): ThinkingBudgetsSettings | undefined;
+    getShowImages(): boolean;
+    setShowImages(show: boolean): void;
+    getImageWidthCells(): number;
+    setImageWidthCells(width: number): void;
+    getClearOnShrink(): boolean;
+    setClearOnShrink(enabled: boolean): void;
+    getShowTerminalProgress(): boolean;
+    setShowTerminalProgress(enabled: boolean): void;
+    getImageAutoResize(): boolean;
+    setImageAutoResize(enabled: boolean): void;
+    getBlockImages(): boolean;
+    setBlockImages(blocked: boolean): void;
+    getEnabledModels(): string[] | undefined;
+    setEnabledModels(patterns: string[] | undefined): void;
+    getDoubleEscapeAction(): "fork" | "tree" | "none";
+    setDoubleEscapeAction(action: "fork" | "tree" | "none"): void;
+    getTreeFilterMode(): "default" | "no-tools" | "user-only" | "labeled-only" | "all";
+    setTreeFilterMode(mode: "default" | "no-tools" | "user-only" | "labeled-only" | "all"): void;
+    getShowHardwareCursor(): boolean;
+    setShowHardwareCursor(enabled: boolean): void;
+    getEditorPaddingX(): number;
+    setEditorPaddingX(padding: number): void;
+    getAutocompleteMaxVisible(): number;
+    setAutocompleteMaxVisible(maxVisible: number): void;
+    getCodeBlockIndent(): string;
+    getWarnings(): WarningSettings;
+    setWarnings(warnings: WarningSettings): void;
+}
+//# sourceMappingURL=settings-manager.d.ts.map