@sayknow-cli/coding-agent 0.6.4 → 0.6.6

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

@@ -325,6 +325,120 @@ export declare const defaultThemes: {
             preset: string;
         };
     };
+    "glow-octopus": {
+        $schema: string;
+        name: string;
+        vars: {
+            ink: string;
+            mantle: string;
+            surface: string;
+            surfaceBright: string;
+            text: string;
+            muted: string;
+            dim: string;
+            accent: string;
+            secondary: string;
+            success: string;
+            error: string;
+            warning: string;
+            link: string;
+            keyword: string;
+            function: string;
+            string: string;
+            number: string;
+            type: string;
+            diffRemoved: string;
+            toolSuccessBg: string;
+            toolErrorBg: string;
+            think1: string;
+            think2: string;
+            think3: string;
+            think4: string;
+        };
+        colors: {
+            accent: string;
+            border: string;
+            borderAccent: string;
+            borderMuted: string;
+            success: string;
+            error: string;
+            warning: string;
+            muted: string;
+            dim: string;
+            text: string;
+            thinkingText: string;
+            selectedBg: string;
+            userMessageBg: string;
+            userMessageText: string;
+            customMessageBg: string;
+            customMessageText: string;
+            customMessageLabel: string;
+            toolPendingBg: string;
+            toolSuccessBg: string;
+            toolErrorBg: string;
+            toolTitle: string;
+            toolOutput: string;
+            mdHeading: string;
+            mdLink: string;
+            mdLinkUrl: string;
+            mdCode: string;
+            mdCodeBlock: string;
+            mdCodeBlockBorder: string;
+            mdQuote: string;
+            mdQuoteBorder: string;
+            mdHr: string;
+            mdListBullet: string;
+            toolDiffAdded: string;
+            toolDiffRemoved: string;
+            toolDiffContext: string;
+            link: string;
+            syntaxComment: string;
+            syntaxKeyword: string;
+            syntaxFunction: string;
+            syntaxVariable: string;
+            syntaxString: string;
+            syntaxNumber: string;
+            syntaxType: string;
+            syntaxOperator: string;
+            syntaxPunctuation: string;
+            thinkingOff: string;
+            thinkingMinimal: string;
+            thinkingLow: string;
+            thinkingMedium: string;
+            thinkingHigh: string;
+            thinkingXhigh: string;
+            bashMode: string;
+            statusLineBg: string;
+            statusLineSep: string;
+            statusLineModel: string;
+            statusLinePath: string;
+            statusLineGitClean: string;
+            statusLineGitDirty: string;
+            statusLineContext: string;
+            statusLineSpend: string;
+            statusLineStaged: string;
+            statusLineDirty: string;
+            statusLineUntracked: string;
+            statusLineOutput: string;
+            statusLineCost: string;
+            statusLineSubagents: string;
+            pythonMode: string;
+        };
+        export: {
+            pageBg: string;
+            cardBg: string;
+            infoBg: string;
+        };
+        symbols: {
+            preset: string;
+            overrides: {
+                "icon.pi": string;
+                "icon.agents": string;
+                "status.running": string;
+                "md.bullet": string;
+            };
+        };
+    };
     "gruvbox-dark": {
         $schema: string;
         name: string;
@@ -424,6 +538,120 @@ export declare const defaultThemes: {
             preset: string;
         };
     };
+    "ink-octopus": {
+        $schema: string;
+        name: string;
+        vars: {
+            ink: string;
+            mantle: string;
+            surface: string;
+            surfaceBright: string;
+            text: string;
+            muted: string;
+            dim: string;
+            accent: string;
+            secondary: string;
+            success: string;
+            error: string;
+            warning: string;
+            link: string;
+            keyword: string;
+            function: string;
+            string: string;
+            number: string;
+            type: string;
+            diffRemoved: string;
+            toolSuccessBg: string;
+            toolErrorBg: string;
+            think1: string;
+            think2: string;
+            think3: string;
+            think4: string;
+        };
+        colors: {
+            accent: string;
+            border: string;
+            borderAccent: string;
+            borderMuted: string;
+            success: string;
+            error: string;
+            warning: string;
+            muted: string;
+            dim: string;
+            text: string;
+            thinkingText: string;
+            selectedBg: string;
+            userMessageBg: string;
+            userMessageText: string;
+            customMessageBg: string;
+            customMessageText: string;
+            customMessageLabel: string;
+            toolPendingBg: string;
+            toolSuccessBg: string;
+            toolErrorBg: string;
+            toolTitle: string;
+            toolOutput: string;
+            mdHeading: string;
+            mdLink: string;
+            mdLinkUrl: string;
+            mdCode: string;
+            mdCodeBlock: string;
+            mdCodeBlockBorder: string;
+            mdQuote: string;
+            mdQuoteBorder: string;
+            mdHr: string;
+            mdListBullet: string;
+            toolDiffAdded: string;
+            toolDiffRemoved: string;
+            toolDiffContext: string;
+            link: string;
+            syntaxComment: string;
+            syntaxKeyword: string;
+            syntaxFunction: string;
+            syntaxVariable: string;
+            syntaxString: string;
+            syntaxNumber: string;
+            syntaxType: string;
+            syntaxOperator: string;
+            syntaxPunctuation: string;
+            thinkingOff: string;
+            thinkingMinimal: string;
+            thinkingLow: string;
+            thinkingMedium: string;
+            thinkingHigh: string;
+            thinkingXhigh: string;
+            bashMode: string;
+            statusLineBg: string;
+            statusLineSep: string;
+            statusLineModel: string;
+            statusLinePath: string;
+            statusLineGitClean: string;
+            statusLineGitDirty: string;
+            statusLineContext: string;
+            statusLineSpend: string;
+            statusLineStaged: string;
+            statusLineDirty: string;
+            statusLineUntracked: string;
+            statusLineOutput: string;
+            statusLineCost: string;
+            statusLineSubagents: string;
+            pythonMode: string;
+        };
+        export: {
+            pageBg: string;
+            cardBg: string;
+            infoBg: string;
+        };
+        symbols: {
+            preset: string;
+            overrides: {
+                "icon.pi": string;
+                "icon.agents": string;
+                "status.running": string;
+                "md.bullet": string;
+            };
+        };
+    };
     opencode: {
         $schema: string;
         name: string;
@@ -649,4 +877,118 @@ export declare const defaultThemes: {
             };
         };
     };
+    "violet-octopus": {
+        $schema: string;
+        name: string;
+        vars: {
+            ink: string;
+            mantle: string;
+            surface: string;
+            surfaceBright: string;
+            text: string;
+            muted: string;
+            dim: string;
+            accent: string;
+            secondary: string;
+            success: string;
+            error: string;
+            warning: string;
+            link: string;
+            keyword: string;
+            function: string;
+            string: string;
+            number: string;
+            type: string;
+            diffRemoved: string;
+            toolSuccessBg: string;
+            toolErrorBg: string;
+            think1: string;
+            think2: string;
+            think3: string;
+            think4: string;
+        };
+        colors: {
+            accent: string;
+            border: string;
+            borderAccent: string;
+            borderMuted: string;
+            success: string;
+            error: string;
+            warning: string;
+            muted: string;
+            dim: string;
+            text: string;
+            thinkingText: string;
+            selectedBg: string;
+            userMessageBg: string;
+            userMessageText: string;
+            customMessageBg: string;
+            customMessageText: string;
+            customMessageLabel: string;
+            toolPendingBg: string;
+            toolSuccessBg: string;
+            toolErrorBg: string;
+            toolTitle: string;
+            toolOutput: string;
+            mdHeading: string;
+            mdLink: string;
+            mdLinkUrl: string;
+            mdCode: string;
+            mdCodeBlock: string;
+            mdCodeBlockBorder: string;
+            mdQuote: string;
+            mdQuoteBorder: string;
+            mdHr: string;
+            mdListBullet: string;
+            toolDiffAdded: string;
+            toolDiffRemoved: string;
+            toolDiffContext: string;
+            link: string;
+            syntaxComment: string;
+            syntaxKeyword: string;
+            syntaxFunction: string;
+            syntaxVariable: string;
+            syntaxString: string;
+            syntaxNumber: string;
+            syntaxType: string;
+            syntaxOperator: string;
+            syntaxPunctuation: string;
+            thinkingOff: string;
+            thinkingMinimal: string;
+            thinkingLow: string;
+            thinkingMedium: string;
+            thinkingHigh: string;
+            thinkingXhigh: string;
+            bashMode: string;
+            statusLineBg: string;
+            statusLineSep: string;
+            statusLineModel: string;
+            statusLinePath: string;
+            statusLineGitClean: string;
+            statusLineGitDirty: string;
+            statusLineContext: string;
+            statusLineSpend: string;
+            statusLineStaged: string;
+            statusLineDirty: string;
+            statusLineUntracked: string;
+            statusLineOutput: string;
+            statusLineCost: string;
+            statusLineSubagents: string;
+            pythonMode: string;
+        };
+        export: {
+            pageBg: string;
+            cardBg: string;
+            infoBg: string;
+        };
+        symbols: {
+            preset: string;
+            overrides: {
+                "icon.pi": string;
+                "icon.agents": string;
+                "status.running": string;
+                "md.bullet": string;
+            };
+        };
+    };
 };

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

@@ -6,7 +6,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.folder" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "checkbox.checked" | "checkbox.unchecked" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tab.integrations";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.folder" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.star" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "checkbox.checked" | "checkbox.unchecked" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "rail.user" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tab.integrations";
 export type SpinnerType = "status" | "activity";
 export declare const THEME_COLOR_KEYS: readonly ["accent", "border", "borderAccent", "borderMuted", "success", "error", "warning", "muted", "dim", "text", "thinkingText", "selectedBg", "userMessageBg", "userMessageText", "customMessageBg", "customMessageText", "customMessageLabel", "toolPendingBg", "toolSuccessBg", "toolErrorBg", "toolTitle", "toolOutput", "mdHeading", "mdLink", "mdLinkUrl", "mdCode", "mdCodeBlock", "mdCodeBlockBorder", "mdQuote", "mdQuoteBorder", "mdHr", "mdListBullet", "toolDiffAdded", "toolDiffRemoved", "toolDiffContext", "syntaxComment", "syntaxKeyword", "syntaxFunction", "syntaxVariable", "syntaxString", "syntaxNumber", "syntaxType", "syntaxOperator", "syntaxPunctuation", "thinkingOff", "thinkingMinimal", "thinkingLow", "thinkingMedium", "thinkingHigh", "thinkingXhigh", "bashMode", "pythonMode", "statusLineBg", "statusLineSep", "statusLineModel", "statusLinePath", "statusLineGitClean", "statusLineGitDirty", "statusLineContext", "statusLineSpend", "statusLineStaged", "statusLineDirty", "statusLineUntracked", "statusLineOutput", "statusLineCost", "statusLineSubagents"];
 export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
@@ -128,6 +128,7 @@ export declare class Theme {
         output: string;
         host: string;
         session: string;
+        star: string;
         package: string;
         warning: string;
         rewind: string;
@@ -162,6 +163,9 @@ export declare class Theme {
         bracketLeft: string;
         bracketRight: string;
     };
+    get rail(): {
+        user: string;
+    };
     get md(): {
         quoteBorder: string;
         hrChar: string;

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

@@ -256,7 +256,7 @@ export interface InteractiveModeContext {
     handleHandoffCommand(customInstructions?: string): Promise<void>;
     handleContributionPrepCommand(customInstructions?: string): Promise<void>;
     handleMoveCommand(targetPath: string): Promise<void>;
-    handleRenameCommand(title: string): Promise<void>;
+    handleRenameCommand(title?: string): Promise<void>;
     handleMemoryCommand(text: string): Promise<void>;
     handleSTTToggle(): Promise<void>;
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
@@ -286,6 +286,8 @@ export interface InteractiveModeContext {
     showUserMessageSelector(): void;
     showTreeSelector(): void;
     showSessionSelector(): void;
+    /** Resume the most recent saved session other than this one (the launch card's first row). */
+    continueRecentSession(): Promise<void>;
     showSessionsDashboard(): void;
     handleResumeSession(sessionPath: string, options?: {
         requireIdle?: boolean;

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

@@ -403,6 +403,8 @@ export interface SessionInfo {
     /** Working directory where the session was started. Empty string for old sessions. */
     cwd: string;
     title?: string;
+    /** Starred for discovery (see session-stars.ts); never affects resolution or retention. */
+    starred: boolean;
     /** Path to the parent session (if this session was forked). */
     parentSessionPath?: string;
     created: Date;
@@ -555,6 +557,8 @@ interface ResidentBlobSentinel {
 }
 export declare function residentBlobSentinelForTests(kind: ResidentBlobKind, ref: string): ResidentBlobSentinel;
 export declare function materializeResidentEntriesForPersistenceForTests<T>(entries: T[], textStore: BlobStore, imageStore?: BlobStore): T[];
+/** Starred sessions first, each group keeping its incoming (recency) order. */
+export declare function prioritizeStarredSessions(sessions: readonly SessionInfo[]): SessionInfo[];
 /** Get recent sessions for display in welcome screen */
 export declare function getRecentSessions(sessionDir: string, limit?: number, storage?: SessionStorage): Promise<RecentSessionInfo[]>;
 export declare function getRecentSessionDisplay(sessions: readonly SessionInfo[], limit?: number): Array<{
@@ -769,6 +773,11 @@ export declare class SessionManager {
     /** The source that set the session name: "user" (manual /rename or RPC) or "auto" (generated title). */
     get titleSource(): "auto" | "user" | undefined;
     getSessionName(): string | undefined;
+    isSessionStarred(): boolean;
+    /** Star or unstar this session. Returns `false` when it was already in that state. */
+    setSessionStarred(starred: boolean): Promise<boolean>;
+    /** Star or unstar a session listed in the resume picker (not necessarily this one). */
+    setSessionStarredForPicker(session: Pick<SessionInfo, "id">, starred: boolean): Promise<void>;
     setSessionName(name: string, source?: "auto" | "user"): Promise<boolean>;
     _persist(entry: SessionEntry): void;
     /** Append a configured fallback chain as child of current leaf, then advance leaf. Returns entry id. */

package/dist/types/session/session-stars.d.ts

@@ -0,0 +1,15 @@
+export declare function getSessionStarIndexPath(agentDir?: string): string;
+/**
+ * Ids of starred sessions. Cheap to call per listed session: the parsed index is
+ * cached until the file's mtime or size changes. A missing or unreadable index
+ * means nothing is starred; listing never fails because of stars.
+ */
+export declare function readStarredSessionIds(agentDir?: string): ReadonlySet<string>;
+export declare function isSessionIdStarred(sessionId: string, agentDir?: string): boolean;
+/**
+ * Star or unstar a session by id. Returns `true` when the index changed and
+ * `false` when the session was already in the requested state. The
+ * read-modify-write runs under a cross-process lock and lands with an atomic
+ * rename, so two CLIs toggling different sessions cannot drop each other's star.
+ */
+export declare function setSessionIdStarred(sessionId: string, starred: boolean, agentDir?: string): Promise<boolean>;

package/dist/types/tools/debug.d.ts

@@ -8,6 +8,7 @@ import type { OutputMeta } from "./output-meta";
 declare const debugSchema: z.ZodObject<{
     action: z.ZodEnum<{
         output: "output";
+        sessions: "sessions";
         pause: "pause";
         scopes: "scopes";
         variables: "variables";
@@ -34,7 +35,6 @@ declare const debugSchema: z.ZodObject<{
         loaded_sources: "loaded_sources";
         custom_request: "custom_request";
         terminate: "terminate";
-        sessions: "sessions";
     }>;
     program: z.ZodOptional<z.ZodString>;
     args: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -131,6 +131,7 @@ export declare class DebugTool implements AgentTool<typeof debugSchema, DebugToo
     readonly parameters: z.ZodObject<{
         action: z.ZodEnum<{
             output: "output";
+            sessions: "sessions";
             pause: "pause";
             scopes: "scopes";
             variables: "variables";
@@ -157,7 +158,6 @@ export declare class DebugTool implements AgentTool<typeof debugSchema, DebugToo
             loaded_sources: "loaded_sources";
             custom_request: "custom_request";
             terminate: "terminate";
-            sessions: "sessions";
         }>;
         program: z.ZodOptional<z.ZodString>;
         args: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/types/tui/output-block.d.ts

@@ -9,8 +9,19 @@ export interface OutputBlockOptions {
         lines: string[];
     }>;
     width: number;
-    applyBg?: boolean;
 }
+/**
+ * Render a tool output block as an open rail: a header line, then content hung
+ * off a single left rule in the state color. There is no enclosing box and no
+ * filled background in any state; the rail color alone carries running/success/error.
+ *
+ * ```
+ * ✓ Bash · 0.4s
+ * │ $ bun test
+ * ├ Output
+ * │ 12 pass
+ * ```
+ */
 export declare function renderOutputBlock(options: OutputBlockOptions, theme: Theme): string[];
 /**
  * Cached wrapper around `renderOutputBlock`.

package/dist/types/tui/utils.d.ts

@@ -1,5 +1,4 @@
-import type { Theme, ThemeBg } from "../modes/theme/theme";
-import type { State } from "./types";
+import type { Theme } from "../modes/theme/theme";
 export { Ellipsis, truncateToWidth } from "@sayknow-cli/tui";
 /**
  * Incremental xxHash64 key builder.
@@ -33,4 +32,3 @@ export declare function buildTreePrefix(ancestors: boolean[], theme: Theme): str
 export declare function getTreeBranch(isLast: boolean, theme: Theme): string;
 export declare function getTreeContinuePrefix(isLast: boolean, theme: Theme): string;
 export declare function padToWidth(text: string, width: number, bgFn?: (s: string) => string): string;
-export declare function getStateBgColor(state: State): ThemeBg;

package/dist/types/utils/session-title-generation.d.ts

@@ -0,0 +1,6 @@
+/** Start a new regeneration and invalidate every older completion. */
+export declare function beginSessionTitleGeneration(owner: object): number;
+/** Invalidate pending regeneration after a newer session mutation is accepted. */
+export declare function invalidateSessionTitleGeneration(owner: object): void;
+/** Return whether a regeneration still owns the latest generation lease. */
+export declare function isSessionTitleGenerationCurrent(owner: object, generation: number): boolean;

package/dist/types/utils/title-generator.d.ts

@@ -1,10 +1,19 @@
+import type { AgentMessage } from "@sayknow-cli/agent-core";
 import { type Api, type Model } from "@sayknow-cli/ai";
 import type { ModelRegistry } from "../config/model-registry";
 import type { Settings } from "../config/settings";
 /**
- * Generate a title for a session based on the first user message.
+ * Build a bounded conversation digest for title regeneration. Regeneration
+ * reads several messages so a throwaway first prompt can be corrected, while
+ * the automatic first-message path intentionally uses only its initial input.
+ */
+export declare function buildConversationTitleInput(messages: readonly AgentMessage[]): string | undefined;
+/**
+ * Generate a title for a session based on the provided user-message input.
+ * Automatic titles pass the first user message; regeneration passes a bounded
+ * conversation digest.
  *
- * @param firstMessage The first user message
+ * @param firstMessage The first user message or bounded conversation digest
  * @param registry Model registry
  * @param settings Settings used to resolve the smol role
  * @param sessionId Optional session id for sticky API key selection

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@sayknow-cli/coding-agent",
-	"version": "0.6.4",
+	"version": "0.6.6",
 	"description": "Sayknow-CLI CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://sayknow-cli.com",
 	"author": "jaybeyond",
@@ -54,12 +54,12 @@
 		"@agentclientprotocol/sdk": "1.3.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@sayknow-cli/stats": "0.6.4",
-		"@sayknow-cli/agent-core": "0.6.4",
-		"@sayknow-cli/ai": "0.6.4",
-		"@sayknow-cli/natives": "0.6.4",
-		"@sayknow-cli/tui": "0.6.4",
-		"@sayknow-cli/utils": "0.6.4",
+		"@sayknow-cli/stats": "0.6.6",
+		"@sayknow-cli/agent-core": "0.6.6",
+		"@sayknow-cli/ai": "0.6.6",
+		"@sayknow-cli/natives": "0.6.6",
+		"@sayknow-cli/tui": "0.6.6",
+		"@sayknow-cli/utils": "0.6.6",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/scripts/generate-sdk-operation-inventory.ts

@@ -34,6 +34,10 @@ const LOCKED_EXCLUSIONS: Readonly<Record<string, string>> = {
 	"slash_command:pet": "visual/local-only command, not a user-facing SDK control seam",
 	"slash_command:transcript": "visual/local-only transcript viewer, not a user-facing SDK control seam",
 	"slash_command:sessions": "visual/local-only sessions dashboard, not a user-facing SDK control seam",
+	"slash_command:star":
+		"local session-discovery metadata command; no SDK operation counterpart or runtime/retention authority",
+	"slash_command:unstar":
+		"local session-discovery metadata command; no SDK operation counterpart or runtime/retention authority",
 	"slash_command:import-session":
 		"local transcript-file import into a new session; ACP is explicitly disabled and no SDK operation reads caller-selected host paths",
 	"agent_session:constructor": "internal accessor/plumbing, not a user-facing control seam",
@@ -226,6 +230,10 @@ const SEAM_TO_SDK: Readonly<Record<string, string>> = {
 	"agent_session:abortBash": "bash.abort",
 	"agent_session:switchSession": "session.switch",
 	"agent_session:branch": "session.branch",
+	// `/fork` opens the user-prompt selector, which commits via
+	// `session.branch(entryId)` (selector-controller.ts). Despite the command and
+	// keybinding name, it is NOT the exact-state `session.fork` operation.
+	"slash_command:fork": "session.branch",
 	"agent_session:handoff": "session.handoff",
 	"agent_session:exportToHtml": "session.export_html",
 	"agent_session:getAvailableModels": "models.list/current",

package/src/cli/session-picker.ts

@@ -3,6 +3,7 @@ import { ProcessTerminal, TUI } from "@sayknow-cli/tui";
 import { pathIsWithin } from "@sayknow-cli/utils";
 import { type SessionSelectionResult, SessionSelectorComponent } from "../modes/components/session-selector";
 import { type SessionInfo, SessionManager } from "../session/session-manager";
+import { setSessionIdStarred } from "../session/session-stars";
 import { FileSessionStorage } from "../session/session-storage";
 
 export async function deleteSessionPickerCandidate(sessionPath: string, explicitSessionDir?: string): Promise<void> {
@@ -43,6 +44,9 @@ export async function selectSession(
 		},
 		SessionManager.inspectSessionTailReadOnly,
 		settle,
+		async (session, starred) => {
+			await setSessionIdStarred(session.id, starred);
+		},
 	);
 	selector.setOnRequestRender(() => ui.requestRender());
 	ui.addChild(selector);

package/src/config/keybindings.ts

@@ -43,6 +43,7 @@ interface AppKeybindings {
 	"app.session.tree": true;
 	"app.session.fork": true;
 	"app.session.resume": true;
+	"app.session.continue": true;
 	"app.session.observe": true;
 	"app.session.dashboard": true;
 	"app.jobs.open": true;
@@ -186,9 +187,15 @@ export const KEYBINDINGS = {
 		description: "Branch from message",
 	},
 	"app.session.resume": {
-		defaultKeys: [],
+		defaultKeys: "alt+r",
 		description: "Resume session",
 	},
+	// A Control chord on purpose: macOS terminals often turn Option into composed text,
+	// and continuing the last session is the one launch action that must always work.
+	"app.session.continue": {
+		defaultKeys: "ctrl+q",
+		description: "Continue the most recent session",
+	},
 	"app.session.observe": {
 		defaultKeys: "ctrl+s",
 		description: "Observe subagent sessions",