kritya 0.8.33-beta → 0.8.34-beta

package/README.md

@@ -124,8 +124,9 @@ kritya               # enter
 kritya [directory] [options]
 
   -c, --continue        resume the most recent session for this directory
-  -r, --resume [name]   list past sessions, or resume one by its short name
-                        (e.g. `kritya -r a3f9k2`; plain `-r` opens the list)
+  -r, --resume [name]   list past sessions, or resume one by its auto-derived
+                        name (e.g. `kritya -r fix-login-bug`) or 5-character
+                        code; plain `-r` opens the list
   -m, --model <id>      use any model ID your provider offers
   -p, --provider <name> nvidia (default), openai, openrouter, groq, deepseek,
                         mistral, together, ollama, switchyard (multi-model

package/dist/index.js

@@ -11,7 +11,7 @@ import { loadRules } from "./permissions/rules.js";
 import { ProviderClient } from "./provider/client.js";
 import { createSwitchyardClient } from "./provider/switchyardClient.js";
 import { SWITCHYARD_ROUTE_ID, resolveEffectiveModel, staleSwitchyardModelWarning, } from "./provider/switchyardSidecar.js";
-import { SessionStore, shortSessionId } from "./session/store.js";
+import { SessionStore } from "./session/store.js";
 import { exitNotice } from "./session/exitNotice.js";
 import { AuditLog } from "./audit/audit.js";
 import { runAuditCli } from "./audit/cli.js";
@@ -50,8 +50,9 @@ Usage: kritya [directory] [options]
 
 Options:
   -c, --continue      resume the most recent session for this directory
-  -r, --resume [name] list past sessions, or resume one by its short name
-                      (e.g. kritya -r a3f9k2; plain -r opens the picker)
+  -r, --resume [name] list past sessions, or resume one by its auto-derived
+                      name (e.g. kritya -r fix-login-bug) or 5-character code;
+                      plain -r opens the picker
   -m, --model <id>    model ID to use (any model your provider offers)
   -p, --provider <n>  provider: nvidia (default), openai, openrouter, groq,
                       deepseek, mistral, together, ollama, or a custom one
@@ -518,7 +519,7 @@ async function main() {
             return [
                 "",
                 `The conversation was saved to ${file}`,
-                `Resume it with:  kritya -r ${shortSessionId(file)}${where}`,
+                `Resume it with:  kritya -r ${SessionStore.displayName(file)}${where}`,
             ];
         },
     });
@@ -707,7 +708,7 @@ async function main() {
     // `renderTime` excludes Ink's own throttling, so it is the raw cost of the
     // frame rather than the interval between frames.
     const renderHistogram = sessionMeter.histogram("kritya.render.duration_ms", RENDER_BOUNDS_MS);
-    ui.instance = render(_jsx(App, { agent: agent, workspace: workspace, modelRef: modelRef, providerRef: providerRef, config: config, resumedCount: initialHistory.length, resumedName: resumedFile ? shortSessionId(resumedFile) : undefined, initialTasks: initialTasks, undoStack: undoStack, uiBridge: uiBridge, resumeSessions: resumeSessions.length ? resumeSessions : undefined, customCommands: loadCustomCommands(workspace, trustWorkspace, plugins), mcpToolCount: mcpTools.length, onSwitchClient: (newClient) => {
+    ui.instance = render(_jsx(App, { agent: agent, workspace: workspace, modelRef: modelRef, providerRef: providerRef, config: config, resumedCount: initialHistory.length, resumedName: resumedFile ? SessionStore.displayName(resumedFile) : undefined, initialTasks: initialTasks, undoStack: undoStack, uiBridge: uiBridge, resumeSessions: resumeSessions.length ? resumeSessions : undefined, customCommands: loadCustomCommands(workspace, trustWorkspace, plugins), mcpToolCount: mcpTools.length, onSwitchClient: (newClient) => {
             client = newClient;
         }, onRequestPermissionReady: (fn) => {
             permissionRef.current = fn;

package/dist/session/exitNotice.js

@@ -1,4 +1,4 @@
-import { shortSessionId } from "./store.js";
+import { SessionStore } from "./store.js";
 /**
  * The sign-off printed when an interactive session ends, or null when there is
  * nothing worth saying.
@@ -25,6 +25,6 @@ export function exitNotice(input) {
     // so say where that was when it is not where the user is standing.
     const where = input.workspace === input.cwd ? "" : ` ${input.workspace}`;
     return (`${dim}Session saved · ${n} message${n === 1 ? "" : "s"}${plain}\n` +
-        `${dim}  resume  ${plain}kritya -r ${shortSessionId(input.file)}${where}\n` +
+        `${dim}  resume  ${plain}kritya -r ${SessionStore.displayName(input.file)}${where}\n` +
         `${dim}  list    ${plain}kritya -r`);
 }

package/dist/session/store.js

@@ -81,6 +81,54 @@ export function shortSessionId(file) {
     // alphabet rather than clustered by the timestamp's shared prefix.
     return digest.readUInt32BE(0).toString(36).padStart(5, "0").slice(-5);
 }
+/**
+ * Turn a first user message into a short, typeable session name:
+ * "Fix the login bug!!" -> "fix-the-login-bug". Lowercase, runs of
+ * non-alphanumerics become one hyphen, capped at 40 characters so the name
+ * stays something a person will actually retype. Returns "" when nothing
+ * usable remains (empty input, only punctuation).
+ */
+export function slugifySessionName(text) {
+    const slug = text
+        .slice(0, 80)
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 40)
+        .replace(/-+$/g, "");
+    return slug;
+}
+/**
+ * Pull plain text out of a message for naming/preview purposes. Content can
+ * be a string, an array of content parts (text + images), or null — images
+ * contribute nothing to a name.
+ */
+function messageText(message) {
+    const content = message.content;
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .filter((p) => p.type === "text")
+            .map((p) => p.text)
+            .join(" ");
+    }
+    return "";
+}
+/**
+ * The first message that may name a session: a real user message, not one of
+ * the synthetic "[...]" notes the agent writes to itself (undo, summaries).
+ * Mirrors the filter listSessions() uses for its preview, so the name and
+ * the preview always agree about what the conversation is about.
+ */
+function nameableText(message) {
+    if (message.role !== "user")
+        return undefined;
+    const text = messageText(message).replace(/\s+/g, " ").trim();
+    if (!text || text.startsWith("["))
+        return undefined;
+    return text;
+}
 /**
  * Transcripts can contain secrets that passed through tool output, so they are
  * always written 0o600 rather than inheriting whatever mode the file had.
@@ -116,6 +164,39 @@ export class SessionStore {
     get messageCount() {
         return this.count;
     }
+    /**
+     * Whether this file's name is settled — either a sidecar already exists
+     * (written earlier, or by a previous process) or we just wrote one.
+     * Reset by rotate(), which starts a new file that deserves its own name.
+     */
+    nameResolved = false;
+    /**
+     * Name this session from its first real user message, once. Later messages
+     * never rename it: the name is meant to stay stable so `-r <name>` keeps
+     * working and the resume list doesn't shift under the user.
+     */
+    maybeNameSession(message) {
+        if (this.nameResolved || this.ephemeral)
+            return;
+        if (SessionStore.readName(this.file)) {
+            this.nameResolved = true;
+            return;
+        }
+        const text = nameableText(message);
+        if (!text)
+            return;
+        const slug = slugifySessionName(text);
+        if (!slug)
+            return;
+        try {
+            writeSessionFile(SessionStore.nameFilePathFor(this.file), slug + "\n");
+            this.nameResolved = true;
+        }
+        catch (err) {
+            // Naming is cosmetic; never fail a turn over it.
+            debugLog(`SessionStore.maybeNameSession(${this.file})`, err);
+        }
+    }
     newFilePath() {
         const stamp = new Date().toISOString().replace(/[:.]/g, "-");
         return path.join(this.dir, `${stamp}.jsonl`);
@@ -143,6 +224,35 @@ export class SessionStore {
     static tasksFilePathFor(sessionFile) {
         return sessionFile.replace(/\.jsonl$/, ".tasks.json");
     }
+    /**
+     * Sidecar holding the session's human-readable name (see
+     * slugifySessionName), written once from the first real user message.
+     * A sidecar rather than a rename: the transcript filename is the session's
+     * stable id for audit/telemetry correlation, and renaming it mid-session
+     * would churn that id plus the tasks sidecar that keys off it.
+     */
+    static nameFilePathFor(sessionFile) {
+        return sessionFile.replace(/\.jsonl$/, ".name");
+    }
+    /** The auto-derived name for a session file, if it earned one yet. */
+    static readName(sessionFile) {
+        try {
+            const name = fs.readFileSync(SessionStore.nameFilePathFor(sessionFile), "utf8").trim();
+            return name || undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * What the user types and sees: the auto-derived name when the session has
+     * one, otherwise the short hash code. Every surface that names a session —
+     * the exit notice, the crash report, the `--resume` picker, `-r <name>` —
+     * goes through here so they can never disagree.
+     */
+    static displayName(sessionFile) {
+        return SessionStore.readName(sessionFile) ?? shortSessionId(sessionFile);
+    }
     /**
      * Persists the current task checklist alongside the session, so `-c`/`-r`
      * can restore not just the conversation but what was done vs. pending.
@@ -211,6 +321,7 @@ export class SessionStore {
                 mode: 0o600,
             });
             this.count++;
+            this.maybeNameSession(message);
         }
         catch (err) {
             // Persistence is best-effort; never crash the session over it.
@@ -221,6 +332,8 @@ export class SessionStore {
     rotate() {
         this.file = this.newFilePath();
         this.count = 0;
+        // The new file deserves its own name, from its own first message.
+        this.nameResolved = false;
     }
     /**
      * Rewrite the session file to hold exactly `messages`, atomically. The log
@@ -331,7 +444,10 @@ export class SessionStore {
                 continue;
             const base = path.basename(entry, ".jsonl").toLowerCase();
             const short = shortSessionId(file);
-            if (short.startsWith(query) || base.startsWith(query))
+            const slug = SessionStore.readName(file)?.toLowerCase();
+            if (short.startsWith(query) ||
+                base.startsWith(query) ||
+                (slug !== undefined && (slug === query || slug.startsWith(query))))
                 matches.set(file, short);
         }
         if (!matches.size) {
@@ -432,6 +548,7 @@ export class SessionStore {
                     if (fs.statSync(file).mtimeMs < cutoff) {
                         fs.unlinkSync(file);
                         fs.rmSync(SessionStore.tasksFilePathFor(file), { force: true });
+                        fs.rmSync(SessionStore.nameFilePathFor(file), { force: true });
                     }
                 }
                 catch (err) {
@@ -504,6 +621,7 @@ export class SessionStore {
                 date,
                 preview,
                 title,
+                name: SessionStore.readName(file) ?? "",
                 shortId: shortSessionId(file),
                 count: lines.length,
             });

package/dist/ui/App.js

@@ -506,11 +506,15 @@ export function App({ agent, workspace, modelRef, providerRef, config, resumedCo
                                 }, placeholder: "steer the agent\u2026 (Enter to queue)" })] })] })), phase === "permission" && permission && (_jsx(PermissionPrompt, { toolName: permission.toolName, summary: permission.summary, diff: permission.diff, warning: permission.warning, onDecision: onPermissionDecision })), phase === "elicitation" && elicitation && (_jsx(ElicitationPrompt, { message: elicitation.message, fields: elicitation.fields, onDecision: onElicitationDecision })), phase === "confirmMode" && (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "green", paddingX: 1, children: [_jsx(Text, { bold: true, color: "green", children: "Switch to accept-edits mode?" }), _jsx(Text, { children: "File writes and edits will auto-approve without asking." }), _jsx(Text, { dimColor: true, children: "Destructive shell commands (rm -rf, force-push, etc.) always still ask, in every mode." }), _jsx(Text, { dimColor: true, children: "Shift+Tab again moves to dry-run mode; once more back to normal." }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Text, { color: "green", children: "Yes (y)" }), " \u00B7 No (n/Esc)"] }) })] })), phase === "confirmBypassMode" && (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "red", paddingX: 1, children: [_jsx(Text, { bold: true, color: "red", children: "Switch to auto mode? (sandbox-gated)" }), _jsx(Text, { children: "EVERY tool call will auto-approve, including destructive shell commands (rm -rf, force-push, etc.) \u2014 nothing will ask first." }), _jsx(Text, { dimColor: true, children: "The sandbox \u2014 not a human \u2014 is what contains any damage this mode causes." }), _jsx(Text, { dimColor: true, children: "Shift+Tab again goes back to normal." }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Text, { color: "red", children: "Yes (y)" }), " \u00B7 No (n/Esc)"] }) })] })), phase === "model" && (_jsx(ModelPicker, { current: model, customModels: config.customModels ?? [], onSelect: (id) => {
                     setPhase("input");
                     setModelEverywhere(id);
-                }, onCancel: () => setPhase("input") })), phase === "resume" && (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "magenta", paddingX: 1, children: [_jsxs(Text, { bold: true, color: "magenta", children: ["Resume a session", " ", _jsx(Text, { dimColor: true, children: "(type to search \u00B7 Esc for a fresh one \u00B7 -r <code> to skip this)" })] }), resumeFilter ? (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "filter: " }), resumeFilter] })) : null, _jsx(SelectList, { items: (resumeSessions ?? [])
-                            .filter((s) => s.title.toLowerCase().includes(resumeFilter.toLowerCase()) ||
-                            SessionStore.matchesContent(s.file, resumeFilter))
+                }, onCancel: () => setPhase("input") })), phase === "resume" && (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "magenta", paddingX: 1, children: [_jsxs(Text, { bold: true, color: "magenta", children: ["Resume a session", " ", _jsx(Text, { dimColor: true, children: "(type to search \u00B7 Esc for a fresh one \u00B7 -r <name> to skip this)" })] }), resumeFilter ? (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "filter: " }), resumeFilter] })) : null, _jsx(SelectList, { items: (resumeSessions ?? [])
+                            .filter((s) => {
+                            const f = resumeFilter.toLowerCase();
+                            return (s.title.toLowerCase().includes(f) ||
+                                s.name.toLowerCase().includes(f) ||
+                                SessionStore.matchesContent(s.file, resumeFilter));
+                        })
                             .map((s) => ({
-                            label: s.title,
+                            label: s.name || s.title,
                             value: s.file,
                             hint: `${s.shortId} · ${s.date} · ${s.count} msgs`,
                         })), onSelect: onResumeSelect, onCancel: () => onResumeSelect("") })] })), phase === "input" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { borderStyle: "round", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { color: "green", children: "\u276F " }), _jsx(TextInput, { value: input, onChange: (v) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kritya",
-  "version": "0.8.33-beta",
+  "version": "0.8.34-beta",
   "description": "Kritya — Superintelligence at your command line",
   "type": "module",
   "publishConfig": {