@vincemakes/kiso-runtime 0.15.3 → 0.15.5

package/dist/store.d.ts

@@ -66,6 +66,20 @@ export interface SessionMeta {
     readonly createdAt: number;
     readonly updatedAt: number;
 }
+/**
+ * The session's title — its first substantive prompt.
+ *
+ * Exported on the INTERNAL entry (never the public root: this is a
+ * projection helper, not an API the runtime wants to support forever —
+ * and adding it to the root surface is a ritual the api-surface gate
+ * rightly refused). It has two consumers and may only have one
+ * definition: `list()` below, which is what `kiso sessions` prints, and
+ * the CLI's session-card projection, which is what the resume PICKER
+ * shows. They were allowed to differ once — the listing got the title
+ * and the picker kept showing bare ids, so the fix reached the surface
+ * nobody uses and missed the one everybody does.
+ */
+export declare function sessionTitle(records: readonly StoreRecord[]): string;
 export declare class SessionStore {
     #private;
     readonly root: string;

package/dist/store.js

@@ -62,6 +62,54 @@ export class StaleWriterError extends Error {
 }
 /** Session ids become file names — keep them host-safe. */
 const ID_PATTERN = /^[A-Za-z0-9._-]+$/;
+/** REL-0152-D6 — a session is named by its first REQUEST, not its first
+ *  word.
+ *
+ *  This used to take `records[0]` unconditionally, so a session was
+ *  titled by whatever the user opened with. Three of the owner's five
+ *  sessions opened with a greeting, and the picker showed three
+ *  identical rows separated only by a timestamp they had to decode.
+ *  RD1B-F9 made ids unique; unique is not meaningful.
+ *
+ *  A greeting is skipped only when something follows it — a session that
+ *  is genuinely nothing but "hello" is still titled "hello", because the
+ *  alternative is naming it "(no prompt)" when a prompt plainly exists.
+ *  No model call: this is a scan of the turns already on disk. */
+/** A greeting is recognised by SHAPE, not by a word list: it is a
+ *  handful of characters with nothing asked in them. Counting code
+ *  points (never UTF-16 units) makes the rule the same in every
+ *  language — a two-character greeting is two characters whatever
+ *  script it is written in — and it keeps a word list out of a tree
+ *  that is required to be English. The ASCII pattern catches the few
+ *  openers long enough to pass the length test but still empty of a
+ *  request. */
+const MIN_TITLE_CHARS = 4;
+const ASCII_OPENER = /^\s*(hi|hey|hello|yo|hiya|howdy|ping|test|ok|okay|thanks|thx)[\s!.,?~]*$/i;
+const isOpener = (t) => [...t].length < MIN_TITLE_CHARS || ASCII_OPENER.test(t);
+/**
+ * The session's title — its first substantive prompt.
+ *
+ * Exported on the INTERNAL entry (never the public root: this is a
+ * projection helper, not an API the runtime wants to support forever —
+ * and adding it to the root surface is a ritual the api-surface gate
+ * rightly refused). It has two consumers and may only have one
+ * definition: `list()` below, which is what `kiso sessions` prints, and
+ * the CLI's session-card projection, which is what the resume PICKER
+ * shows. They were allowed to differ once — the listing got the title
+ * and the picker kept showing bare ids, so the fix reached the surface
+ * nobody uses and missed the one everybody does.
+ */
+export function sessionTitle(records) {
+    const asked = records
+        .map((r) => r.event)
+        .filter((e) => e.type === "user_input" && typeof e.content === "string")
+        .map((e) => e.content.trim())
+        .filter((t) => t !== "");
+    if (asked.length === 0)
+        return "(no prompt)";
+    const substantive = asked.find((t) => !isOpener(t));
+    return (substantive ?? asked[0]).slice(0, 60);
+}
 export class SessionStore {
     root;
     #fds = new Map();
@@ -293,12 +341,9 @@ export class SessionStore {
             const records = this.load(id);
             if (records.length === 0)
                 continue;
-            const first = records[0].event;
             metas.push({
                 id,
-                title: first.type === "user_input" && typeof first.content === "string"
-                    ? first.content.slice(0, 60)
-                    : "(no prompt)",
+                title: sessionTitle(records),
                 events: records.length,
                 runs: new Set(records.map((r) => r.runId)).size,
                 createdAt: records[0]?.ts ?? 0,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-runtime",
-	"version": "0.15.3",
+	"version": "0.15.5",
 	"description": "kiso runtime \u2014 durable multi-turn agent sessions: AgentDefinition, AgentRuntime, AgentSession, Run, append-only JSONL store.",
 	"type": "module",
 	"license": "MIT",
@@ -25,11 +25,11 @@
 		"test": "vitest run"
 	},
 	"dependencies": {
-		"@vincemakes/kiso-core": "0.15.3"
+		"@vincemakes/kiso-core": "0.15.5"
 	},
 	"peerDependencies": {
-		"@vincemakes/kiso-provider-anthropic": "0.15.3",
-		"@vincemakes/kiso-provider-openai": "0.15.3"
+		"@vincemakes/kiso-provider-anthropic": "0.15.5",
+		"@vincemakes/kiso-provider-openai": "0.15.5"
 	},
 	"peerDependenciesMeta": {
 		"@vincemakes/kiso-provider-anthropic": {
@@ -40,7 +40,7 @@
 		}
 	},
 	"devDependencies": {
-		"@vincemakes/kiso-evals": "0.15.3",
+		"@vincemakes/kiso-evals": "0.15.5",
 		"@types/node": "^26.1.2",
 		"typescript": "^5.7.2",
 		"vitest": "^3.0.0"