@timurproko/a1 0.2.7-dev.1268 → 0.2.7-dev.1269

package/README.md

@@ -67,7 +67,7 @@ a1 --session <id>
 
 When a session exits, A1 prints the `a1 --session <id>` command that resumes it; a custom session store is included in the printed command. Closing the terminal ends the agent, as it does for Pi.
 
-Bare A1 automatically names unnamed sessions from the first prompt and regenerates automatic names on the next prompt after a worktree-context change. Manual `/name` renames are preserved. Names appear after footer stats, with a secondary-accent reveal for automatic changes. Disable **Automatic session name** in Agent settings; see [session names](docs/features/session-naming.md) for details.
+Bare A1 automatically names unnamed sessions from the first prompt and regenerates automatic names on the next prompt after a worktree-context change. Manual `/name` renames are preserved. Names appear after footer stats, with a secondary-accent reveal for automatic changes. Agent settings offers **Session name format** with Kebab case (default), Sentence case, and Title Case for future generated names, or **Automatic session name** to disable naming; see [session names](docs/features/session-naming.md) for details.
 
 Show all commands:
 

package/dist/composition/session-naming.js

@@ -6,6 +6,7 @@ export function bindAutomaticSessionNaming(backend, settings, bare) {
     const naming = new SessionNamingController({
         backend, naming: backend.naming,
         enabled: () => settings?.value("sessionAutoName") ?? true,
+        format: () => settings?.value("sessionNameFormat") ?? "kebab",
         withContext: async (consume, signal) => {
             const sessionId = backend.identity.currentHistorySessionId();
             const sessionFile = backend.identity.currentSessionFile();

package/dist/features/owned-ui/settings-app.js

@@ -820,10 +820,18 @@ function labelOf(entry) {
 function rangeOf(entry) {
     return { minimum: entry.minimum, maximum: entry.maximum, values: numericValues(entry.choices) };
 }
-/** Booleans read as yes and no. */
-function displaySettingValue(_entry, value) {
+/** Scalar choices use their readable presentation without changing stored values. */
+function displaySettingValue(entry, value) {
     if (typeof value === "boolean")
         return value ? "yes" : "no";
+    if (entry.backend === "a1" && entry.id === "sessionNameFormat") {
+        if (value === "kebab")
+            return "Kebab case";
+        if (value === "sentence")
+            return "Sentence case";
+        if (value === "title")
+            return "Title Case";
+    }
     return String(value);
 }
 function describeRaw(value) {

package/dist/features/session-naming/controller.d.ts

@@ -1,4 +1,5 @@
 import type { OwnedUiSessionBackend, OwnedUiSessionNamingPort } from "../../contracts/owned-ui/index.js";
+import type { SessionNameFormat } from "./generate.js";
 export interface SessionNamingContext {
     readonly cwd: string;
     readonly branch: string | null;
@@ -10,6 +11,7 @@ interface NamingOptions {
     /** Executes the synchronous callback under authoritative repository-context coordination. */
     readonly withContext: <T>(consume: (context: SessionNamingContext) => T, signal: AbortSignal) => Promise<T>;
     readonly enabled: () => boolean;
+    readonly format: () => SessionNameFormat;
 }
 /** One background naming chain per eligible prompt/context; owns no timers or engine objects. */
 export declare class SessionNamingController {

package/dist/features/session-naming/controller.js

@@ -1,4 +1,3 @@
-import { generateSessionName } from "./generate.js";
 function contextKey(context) {
     return JSON.stringify([context.cwd.replace(/\\/g, "/"), context.branch, context.revision]);
 }
@@ -134,13 +133,15 @@ export class SessionNamingController {
         this.#attempted = key;
         const work = new AbortController();
         this.#work = { abort: work, key: repositoryKey };
-        void generateSessionName(prompt, `${context.cwd.split(/[\\/]/).at(-1) ?? ""} (${context.branch ?? "no branch"})`, request => this.#options.naming.complete(request), work.signal).then(name => {
+        void import("./generate.js").then(async ({ formatSessionName, generateSessionNameCandidate }) => {
+            const candidate = await generateSessionNameCandidate(prompt, `${context.cwd.split(/[\\/]/).at(-1) ?? ""} (${context.branch ?? "no branch"})`, request => this.#options.naming.complete(request), work.signal, this.#options.format);
             if (work.signal.aborted || this.#disposed || !this.#options.enabled())
                 return;
             return this.#options.withContext(current => {
                 if (contextKey(current) !== repositoryKey || work.signal.aborted || this.#disposed || !this.#options.enabled())
                     return false;
-                return this.#options.naming.apply(state, name, key);
+                const name = formatSessionName(candidate, this.#options.format());
+                return name !== null && this.#options.naming.apply(state, name, key);
             }, work.signal);
         }).catch(() => { }).finally(() => { if (this.#work?.abort === work)
             this.#work = undefined; });

package/dist/features/session-naming/generate.d.ts

@@ -1,3 +1,5 @@
 import type { OwnedUiSessionNameCompletion } from "../../contracts/owned-ui/index.js";
+export type SessionNameFormat = "kebab" | "sentence" | "title";
+export declare function formatSessionName(value: string, format: SessionNameFormat): string | null;
 /** Two bounded tool-free attempts; cancellation never becomes an automatic fallback. */
-export declare function generateSessionName(prompt: string, hints: string, complete: (request: OwnedUiSessionNameCompletion) => Promise<string | null>, signal: AbortSignal, timeoutMs?: number): Promise<string>;
+export declare function generateSessionNameCandidate(prompt: string, hints: string, complete: (request: OwnedUiSessionNameCompletion) => Promise<string | null>, signal: AbortSignal, format: () => SessionNameFormat, timeoutMs?: number): Promise<string>;

package/dist/features/session-naming/generate.js

@@ -1,14 +1,22 @@
-function normalize(value) {
-    const name = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+export function formatSessionName(value, format) {
+    const words = (format === "kebab" ? value.toLowerCase() : value).match(/[a-z0-9]+/gi) ?? [];
+    const name = words.map((word, index) => {
+        if (format === "kebab")
+            return word;
+        if (/^[A-Z0-9]+$/.test(word) || /[a-z][A-Z]/.test(word))
+            return word;
+        const lower = word.toLowerCase();
+        return format === "title" || index === 0 ? lower[0].toUpperCase() + lower.slice(1) : lower;
+    }).join(format === "kebab" ? "-" : " ");
     if (!name)
         return null;
     if (name.length <= 16)
         return name;
-    const boundary = name.slice(0, 17).lastIndexOf("-");
-    return (boundary >= 4 ? name.slice(0, boundary) : name.slice(0, 16)).replace(/-+$/g, "") || null;
+    const boundary = name.slice(0, 17).lastIndexOf(format === "kebab" ? "-" : " ");
+    return (boundary >= 4 ? name.slice(0, boundary) : name.slice(0, 16)).replace(/[- ]+$/g, "") || null;
 }
 /** Two bounded tool-free attempts; cancellation never becomes an automatic fallback. */
-export async function generateSessionName(prompt, hints, complete, signal, timeoutMs = 30_000) {
+export async function generateSessionNameCandidate(prompt, hints, complete, signal, format, timeoutMs = 30_000) {
     for (const maxTokens of [4_096, 32_768]) {
         signal.throwIfAborted();
         const deadline = new AbortController();
@@ -21,14 +29,15 @@ export async function generateSessionName(prompt, hints, complete, signal, timeo
                 aborted = () => reject(attempt.reason);
                 attempt.addEventListener("abort", aborted, { once: true });
             });
+            const requestedFormat = format();
+            const style = requestedFormat === "kebab" ? "a lowercase hyphenated title" : `a ${requestedFormat === "sentence" ? "sentence case" : "title case"} title with spaces, preserving acronyms and technical spelling`;
             const response = await Promise.race([complete({
-                    prompt: `Name this coding task with a lowercase hyphenated title of at most 16 characters. Reply only with the title.\nRepository hints: ${hints.slice(0, 300)}\n<task>\n${prompt.slice(0, 500)}\n</task>`,
+                    prompt: `Name this coding task with ${style} of at most 16 characters. Reply only with the title.\nRepository hints: ${hints.slice(0, 300)}\n<task>\n${prompt.slice(0, 500)}\n</task>`,
                     maxTokens, signal: attempt,
                 }), cancelled]);
             signal.throwIfAborted();
-            const name = response === null ? null : normalize(response);
-            if (name !== null)
-                return name;
+            if (response !== null && formatSessionName(response, format()) !== null)
+                return response;
         }
         catch {
             signal.throwIfAborted();
@@ -40,5 +49,6 @@ export async function generateSessionName(prompt, hints, complete, signal, timeo
         }
     }
     signal.throwIfAborted();
-    return normalize((prompt.toLowerCase().match(/[a-z0-9]+/g) ?? []).slice(0, 3).join("-")) ?? "new-task";
+    const fallback = (prompt.match(/[a-z0-9]+/gi) ?? []).slice(0, 3).join(" ");
+    return fallback || "new task";
 }

package/dist/ui/settings/declarations.d.ts

@@ -154,6 +154,18 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
         defaultValue: true;
         allowedValues: readonly [true, false];
     }>;
+    readonly sessionNameFormat: Readonly<{
+        id: "sessionNameFormat";
+        label: "Session name format";
+        section: Readonly<{
+            id: "agent";
+            title: "Agent";
+        }>;
+        description: "Format for future automatic names: fix-api-cache, Fix API cache, or Fix API Cache. Existing and manual names stay unchanged.";
+        application: "live";
+        defaultValue: "kebab";
+        allowedValues: readonly ["kebab", "sentence", "title"];
+    }>;
     readonly promptSuggestions: Readonly<{
         id: "promptSuggestions";
         label: "Prompt suggestions";

package/dist/ui/settings/declarations.js

@@ -109,6 +109,15 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         defaultValue: true,
         allowedValues: Object.freeze([true, false]),
     }),
+    sessionNameFormat: Object.freeze({
+        id: "sessionNameFormat",
+        label: "Session name format",
+        section: AGENT_SECTION,
+        description: "Format for future automatic names: fix-api-cache, Fix API cache, or Fix API Cache. Existing and manual names stay unchanged.",
+        application: "live",
+        defaultValue: "kebab",
+        allowedValues: Object.freeze(["kebab", "sentence", "title"]),
+    }),
     promptSuggestions: Object.freeze({
         id: "promptSuggestions",
         label: "Prompt suggestions",

package/docs/features/session-naming.md

@@ -1,9 +1,23 @@
 # Session names
 
-Bare A1 automatically names an unnamed session from its first prompt while the agent works. Names are short lowercase hyphenated labels (up to 16 characters), generated by the active model in a separate tool-free request. The request does not add a conversation turn or delay the main response. It makes at most two attempts, with 30-second deadlines and respective 4,096/32,768 token ceilings; provider failures use a deterministic prompt-based fallback.
+Bare A1 automatically names an unnamed session from its first prompt while the agent works. Names are short labels (up to 16 characters, including separators), generated by the active model in a separate tool-free request. The request does not add a conversation turn or delay the main response. It makes at most two attempts, with 30-second deadlines and respective 4,096/32,768 token ceilings; provider failures use a deterministic prompt-based fallback.
 
 **Automatic session name** in the Agent settings group is enabled by default. Turning it off cancels pending naming without deleting the current name. The `a1 pi` comparison profile does not receive automatic naming or the A1 footer layout/reveal.
 
+## Name format
+
+Choose **Session name format** in Agent settings:
+
+| Choice | Example |
+| --- | --- |
+| **Kebab case** (default) | `fix-api-cache` |
+| **Sentence case** | `Fix API cache` |
+| **Title Case** | `Fix API Cache` |
+
+Sentence case capitalizes the first word; Title Case capitalizes every ordinary word. Both preserve acronyms and technical spellings supplied by the model, such as `API` and `GitHub`. The same format applies to prompt-based fallback, and all formats keep the 16-character limit, trimming at a word boundary where possible.
+
+The choice is saved to your A1 profile and applies live to future automatic naming, including context regeneration and pending results. Changing it does not rewrite an existing name or start another naming request. Manual `/name` values remain untouched.
+
 ## Task-context changes
 
 Linking a different worktree, clearing and re-entering the same worktree, or changing its confirmed branch makes an automatic name eligible for regeneration. A durable association revision detects exit/re-entry even between footer refreshes. Repeating a link without leaving, runtime heartbeats, commits, dirty files, and PR-check updates do not trigger regeneration.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timurproko/a1",
-  "version": "0.2.7-dev.1268",
+  "version": "0.2.7-dev.1269",
   "description": "Standalone single-agent terminal UI on pinned Pi",
   "type": "module",
   "privateLaunchContract": "neutral-launch-v1",
@@ -113,7 +113,7 @@
     "@mariozechner/clipboard": "^0.3.9"
   },
   "publication": {
-    "source": "5611d6339b9a320baebd3329b3abd85a810c48f9",
-    "pullRequest": 895
+    "source": "0783454e6931f7478be0a1bbfe27d9e886a0c3a3",
+    "pullRequest": 896
   }
 }