@m4ike1/ion-coding-agent 0.1.0

package/dist/core/session-naming-runtime.js

@@ -0,0 +1,336 @@
+/**
+ * Session Naming Runtime — a small, isolated harness-native mini runtime that
+ * generates exactly one session name per session from the first eligible user
+ * prompt, then permanently steps down.
+ *
+ * Architecture:
+ *
+ *                  HARNESS
+ *                     │
+ *         ┌──────────┴───────────┐
+ *         │                      │
+ * Session Naming Runtime     Main Agent
+ *         │                      │
+ * Minimal Context           Full Context
+ * Minimal Instructions      System Prompt
+ * Same Active Model         Same Active Model
+ * No Tools                  Tools
+ * One Job                   Actual Task
+ *         │
+ *         ▼
+ *    Session Name
+ *         │
+ *         ▼
+ *      DISABLED
+ *
+ * The runtime never sees the main agent's system prompt, conversation history,
+ * tools, or permissions. Naming runs through {@link completeSummarization} —
+ * the same choke point as compaction summaries — with a purpose-built naming
+ * context, `toolChoice: "none"`, and no cache writes, so it costs a fraction
+ * of a normal agent turn.
+ *
+ * Lifecycle: pending → waiting → naming → named → disabled.
+ * - pending: constructed for a brand-new session, not yet accepting prompts.
+ * - waiting: ready; the first eligible prompt whose model execution actually
+ *   starts becomes the naming source. Prompts aborted before model execution
+ *   starts are ignored and leave the runtime waiting.
+ * - naming: one bounded naming operation in flight (model attempts +
+ *   deterministic fallback).
+ * - named: a name was installed.
+ * - disabled: terminal. Manual naming (`:name`) also lands here immediately.
+ */
+import { contentText } from "@m4ike1/ion-ai";
+import { completeSummarization } from "./compaction/compaction.js";
+export const SESSION_NAMING_MAX_ATTEMPTS = 3;
+/** Model candidates may not exceed 6 words. */
+export const SESSION_NAMING_MAX_WORDS = 6;
+/** Model candidates may not exceed 60 characters. */
+export const SESSION_NAMING_MAX_CHARS = 60;
+/** Only this much of the source prompt is sent to the naming model. */
+export const SESSION_NAMING_MAX_SOURCE_CHARS = 2000;
+/** Small response budget — a title needs a handful of tokens. */
+const SESSION_NAMING_MAX_TOKENS = 64;
+const SESSION_NAMING_SYSTEM_PROMPT = `You are a session-name generator. Generate a concise title describing the user's primary intent or topic, not a copy of their words. Prefer 2-5 words, at most 6. Reply with ONLY the title: no quotes, no punctuation, no sentences, no questions, no explanation.`;
+/** Titles that carry no useful information. Accepted only via explicit manual naming. */
+const GENERIC_TITLES = new Set([
+    "chat",
+    "session",
+    "new session",
+    "new chat",
+    "untitled",
+    "question",
+    "help",
+    "help me",
+    "research",
+    "work",
+    "conversation",
+]);
+/** Normalize a title for comparison: case-insensitive with collapsed whitespace. */
+export function normalizeSessionNameForComparison(name) {
+    return name.trim().toLowerCase().replace(/\s+/g, " ");
+}
+/**
+ * Whether raw input is eligible as a naming source. Commands (`:`/`/`) are
+ * harness metadata, not session content; empty input names nothing.
+ */
+export function isNamingEligiblePrompt(text) {
+    const firstLine = text.split("\n")[0]?.trim() ?? "";
+    if (!firstLine)
+        return false;
+    if (firstLine.startsWith(":") || firstLine.startsWith("/"))
+        return false;
+    return true;
+}
+/**
+ * Normalize a raw model candidate: trim, collapse whitespace, strip wrapping
+ * quotes, drop trailing sentence punctuation.
+ */
+export function normalizeTitleCandidate(raw) {
+    let name = raw.trim().replace(/\s+/g, " ");
+    for (let i = 0; i < 2; i++) {
+        name = name.replace(/[.!?;:]+$/, "").trim();
+        const quoted = /^["'](.*)["']$/.exec(name);
+        if (!quoted)
+            break;
+        name = (quoted[1] ?? "").trim();
+    }
+    name = name.replace(/[.!?;:]+$/, "").trim();
+    return name;
+}
+/**
+ * Harness-side validation for a normalized model candidate. `existing` holds
+ * comparison-normalized names. Generic titles are rejected here — they remain
+ * acceptable when the user supplies them explicitly via manual naming, which
+ * bypasses the runtime entirely.
+ */
+export function validateTitleCandidate(name, existing) {
+    if (!name)
+        return { valid: false, collision: false, feedback: "empty title" };
+    if (name.length > SESSION_NAMING_MAX_CHARS) {
+        return {
+            valid: false,
+            collision: false,
+            feedback: `over ${SESSION_NAMING_MAX_CHARS} characters`,
+        };
+    }
+    const words = name.split(" ").filter(Boolean);
+    if (words.length > SESSION_NAMING_MAX_WORDS) {
+        return {
+            valid: false,
+            collision: false,
+            feedback: `over ${SESSION_NAMING_MAX_WORDS} words`,
+        };
+    }
+    if (/[\r\n]/.test(name) || /[{}[\]<>]/.test(name)) {
+        return { valid: false, collision: false, feedback: "forbidden characters" };
+    }
+    if (GENERIC_TITLES.has(normalizeSessionNameForComparison(name))) {
+        return { valid: false, collision: false, feedback: "too generic" };
+    }
+    if (existing.has(normalizeSessionNameForComparison(name))) {
+        return { valid: false, collision: true, feedback: "already in use" };
+    }
+    return { valid: true };
+}
+/**
+ * Deterministic fallback title derived from the source prompt: first line,
+ * markdown stripped, truncated. Returns undefined when nothing usable remains.
+ */
+export function deriveFallbackTitle(text) {
+    const firstLine = text.split("\n")[0]?.trim() ?? "";
+    if (!firstLine || firstLine.startsWith(":") || firstLine.startsWith("/"))
+        return undefined;
+    const cleaned = normalizeTitleCandidate(firstLine
+        .replace(/^#+\s*/, "")
+        .replace(/[*_`~]/g, "")
+        .replace(/^\[.*?\]\(.*?\)$/, ""));
+    if (!cleaned)
+        return undefined;
+    return cleaned.length > 50 ? `${cleaned.slice(0, 47)}...` : cleaned;
+}
+/** Append ` #2`, ` #3`, … until the name no longer collides. */
+export function uniquifySessionName(base, existing) {
+    if (!existing.has(normalizeSessionNameForComparison(base)))
+        return base;
+    let counter = 2;
+    while (existing.has(normalizeSessionNameForComparison(`${base} #${counter}`))) {
+        counter++;
+        if (counter > 9999)
+            break;
+    }
+    return `${base} #${counter}`;
+}
+export class SessionNamingRuntime {
+    state = "pending";
+    pendingPrompt;
+    epoch = 0;
+    namingAbort;
+    maxAttempts;
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+        this.maxAttempts = deps.maxAttempts ?? SESSION_NAMING_MAX_ATTEMPTS;
+    }
+    getState() {
+        return this.state;
+    }
+    /** Mark the runtime ready to accept the first eligible prompt. */
+    start() {
+        if (this.state === "pending")
+            this.state = "waiting";
+    }
+    /**
+     * Permanently step down. Abandons any in-flight naming operation (its late
+     * result is discarded via the epoch check) and releases candidate state.
+     * Called after successful naming and on explicit manual naming.
+     */
+    disable() {
+        this.epoch++;
+        this.namingAbort?.abort();
+        this.namingAbort = undefined;
+        this.pendingPrompt = undefined;
+        this.state = "disabled";
+    }
+    /**
+     * Record a submitted user prompt. Only the waiting state accepts one, and a
+     * newer submission replaces any pending candidate — prompts are never
+     * combined and aborted-prompt residue is never retained.
+     */
+    notePromptSubmitted(text) {
+        if (this.state !== "waiting")
+            return;
+        if (!isNamingEligiblePrompt(text))
+            return;
+        this.pendingPrompt = text;
+    }
+    /**
+     * Record that the model's execution actually started for the current run
+     * (first assistant stream event). The pending candidate becomes the naming
+     * source at this point and the one naming operation fires immediately, so
+     * it runs in the background while the main agent works. Ignored unless a
+     * candidate is pending.
+     */
+    notifyModelExecutionStarted() {
+        if (this.state !== "waiting" || this.pendingPrompt === undefined)
+            return;
+        const candidate = this.pendingPrompt;
+        this.pendingPrompt = undefined;
+        this.state = "naming";
+        void this.runNaming(candidate);
+    }
+    /**
+     * Settle the pending prompt after its run completes. Only clears a
+     * candidate whose model execution never started (e.g. aborted beforehand)
+     * so no stale text is retained; the naming decision itself already
+     * happened at execution start.
+     */
+    notePromptSettled() {
+        if (this.state !== "waiting")
+            return;
+        this.pendingPrompt = undefined;
+    }
+    install(name) {
+        this.state = "named";
+        try {
+            this.deps.installName(name);
+        }
+        catch {
+            // Naming must never degrade the main session.
+        }
+        this.pendingPrompt = undefined;
+        this.namingAbort = undefined;
+        this.state = "disabled";
+    }
+    async runNaming(candidatePrompt) {
+        const epoch = this.epoch;
+        const active = () => this.state === "naming" && this.epoch === epoch;
+        let existing;
+        try {
+            existing = new Set((await this.deps.listExistingNames()).map(normalizeSessionNameForComparison));
+        }
+        catch {
+            existing = new Set();
+        }
+        const avoid = [];
+        for (let attempt = 1; attempt <= this.maxAttempts; attempt++) {
+            let raw;
+            try {
+                if (!active())
+                    return;
+                const model = this.deps.getModel();
+                if (!model)
+                    break;
+                const auth = await this.deps.getRequestAuth(model);
+                if (!active())
+                    return;
+                raw = await this.generateCandidate(model, auth, candidatePrompt, avoid);
+                if (!active())
+                    return;
+            }
+            catch {
+                break;
+            }
+            if (raw === undefined)
+                break;
+            const normalized = normalizeTitleCandidate(raw);
+            const validation = validateTitleCandidate(normalized, existing);
+            if (validation.valid) {
+                this.install(normalized);
+                return;
+            }
+            avoid.push(validation.collision
+                ? `The title "${normalized}" is already in use. Generate a different title for the same subject — prefer semantic rephrasing or a distinctive qualifier.`
+                : `The suggestion "${normalized}" was rejected (${validation.feedback}). Follow the constraints exactly.`);
+        }
+        if (!active())
+            return;
+        const fallback = deriveFallbackTitle(candidatePrompt);
+        if (fallback === undefined) {
+            // Nothing usable to name from — leave the session unnamed.
+            this.state = "named";
+            this.state = "disabled";
+            return;
+        }
+        this.install(uniquifySessionName(fallback, existing));
+    }
+    async generateCandidate(model, auth, candidatePrompt, avoid) {
+        const source = candidatePrompt.length > SESSION_NAMING_MAX_SOURCE_CHARS
+            ? `${candidatePrompt.slice(0, SESSION_NAMING_MAX_SOURCE_CHARS)}…`
+            : candidatePrompt;
+        let userText = `Generate a concise session title for the following user request. Reply with ONLY the title.\n\n<USER PROMPT>\n${source}\n</USER PROMPT>`;
+        if (avoid.length > 0) {
+            userText += `\n\nConstraints from previous attempts:\n- ${avoid.join("\n- ")}`;
+        }
+        const context = {
+            systemPrompt: SESSION_NAMING_SYSTEM_PROMPT,
+            messages: [
+                {
+                    role: "user",
+                    content: [{ type: "text", text: userText }],
+                    timestamp: Date.now(),
+                },
+            ],
+        };
+        this.namingAbort = new AbortController();
+        let response;
+        try {
+            response = await completeSummarization(model, context, {
+                apiKey: auth.apiKey,
+                headers: auth.headers,
+                env: auth.env,
+                signal: this.namingAbort.signal,
+                maxTokens: SESSION_NAMING_MAX_TOKENS,
+            }, this.deps.streamFunction, this.deps.getRetryPolicy?.());
+        }
+        catch {
+            return undefined;
+        }
+        if (response.stopReason !== "stop")
+            return undefined;
+        if (response.content.some((block) => block.type === "toolCall"))
+            return undefined;
+        const text = contentText(response.content, "").trim();
+        return text || undefined;
+    }
+}
+//# sourceMappingURL=session-naming-runtime.js.map

package/dist/core/session-naming-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-naming-runtime.js","sourceRoot":"","sources":["../../src/core/session-naming-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Session Naming Runtime — a small, isolated harness-native mini runtime that\n * generates exactly one session name per session from the first eligible user\n * prompt, then permanently steps down.\n *\n * Architecture:\n *\n *                  HARNESS\n *                     │\n *         ┌──────────┴───────────┐\n *         │                      │\n * Session Naming Runtime     Main Agent\n *         │                      │\n * Minimal Context           Full Context\n * Minimal Instructions      System Prompt\n * Same Active Model         Same Active Model\n * No Tools                  Tools\n * One Job                   Actual Task\n *         │\n *         ▼\n *    Session Name\n *         │\n *         ▼\n *      DISABLED\n *\n * The runtime never sees the main agent's system prompt, conversation history,\n * tools, or permissions. Naming runs through {@link completeSummarization} —\n * the same choke point as compaction summaries — with a purpose-built naming\n * context, `toolChoice: \"none\"`, and no cache writes, so it costs a fraction\n * of a normal agent turn.\n *\n * Lifecycle: pending → waiting → naming → named → disabled.\n * - pending: constructed for a brand-new session, not yet accepting prompts.\n * - waiting: ready; the first eligible prompt whose model execution actually\n *   starts becomes the naming source. Prompts aborted before model execution\n *   starts are ignored and leave the runtime waiting.\n * - naming: one bounded naming operation in flight (model attempts +\n *   deterministic fallback).\n * - named: a name was installed.\n * - disabled: terminal. Manual naming (`:name`) also lands here immediately.\n */\n\nimport type { StreamFn } from \"@m4ike1/ion-agent-core\";\nimport { contentText, type RetryPolicy } from \"@m4ike1/ion-ai\";\nimport type { AssistantMessage, Context, Model } from \"@m4ike1/ion-ai/compat\";\nimport { completeSummarization } from \"./compaction/compaction.ts\";\n\nexport type SessionNamingState = \"pending\" | \"waiting\" | \"naming\" | \"named\" | \"disabled\";\n\n/** Request credentials for a standalone naming call. Mirrors the summarization auth shape. */\nexport interface SessionNamingRequestAuth {\n\tmodel: Model<any>;\n\tapiKey?: string;\n\theaders?: Record<string, string>;\n\tenv?: Record<string, string>;\n}\n\nexport interface SessionNamingRuntimeDeps {\n\t/** Owning session id (recorded as runtime metadata only). */\n\tsessionId: string;\n\t/** Resolve the currently active model at the moment naming starts. Never cached. */\n\tgetModel: () => Model<any> | undefined;\n\t/** Resolve request credentials for the given model. */\n\tgetRequestAuth: (model: Model<any>) => Promise<SessionNamingRequestAuth>;\n\t/** Session stream function so request behavior stays consistent. Optional. */\n\tstreamFunction?: StreamFn;\n\t/** Retry policy for transient stream drops. Optional. */\n\tgetRetryPolicy?: () => RetryPolicy | undefined;\n\t/** All existing session display names (any project scope the harness deems relevant). */\n\tlistExistingNames: () => Promise<string[]>;\n\t/** Install the final name (persistence + UI refresh owned by the caller). */\n\tinstallName: (name: string) => void;\n\t/** Maximum model generation attempts before the deterministic fallback. Defaults to 3. */\n\tmaxAttempts?: number;\n}\n\nexport const SESSION_NAMING_MAX_ATTEMPTS = 3;\n/** Model candidates may not exceed 6 words. */\nexport const SESSION_NAMING_MAX_WORDS = 6;\n/** Model candidates may not exceed 60 characters. */\nexport const SESSION_NAMING_MAX_CHARS = 60;\n/** Only this much of the source prompt is sent to the naming model. */\nexport const SESSION_NAMING_MAX_SOURCE_CHARS = 2000;\n/** Small response budget — a title needs a handful of tokens. */\nconst SESSION_NAMING_MAX_TOKENS = 64;\n\nconst SESSION_NAMING_SYSTEM_PROMPT = `You are a session-name generator. Generate a concise title describing the user's primary intent or topic, not a copy of their words. Prefer 2-5 words, at most 6. Reply with ONLY the title: no quotes, no punctuation, no sentences, no questions, no explanation.`;\n\n/** Titles that carry no useful information. Accepted only via explicit manual naming. */\nconst GENERIC_TITLES = new Set([\n\t\"chat\",\n\t\"session\",\n\t\"new session\",\n\t\"new chat\",\n\t\"untitled\",\n\t\"question\",\n\t\"help\",\n\t\"help me\",\n\t\"research\",\n\t\"work\",\n\t\"conversation\",\n]);\n\n/** Normalize a title for comparison: case-insensitive with collapsed whitespace. */\nexport function normalizeSessionNameForComparison(name: string): string {\n\treturn name.trim().toLowerCase().replace(/\\s+/g, \" \");\n}\n\n/**\n * Whether raw input is eligible as a naming source. Commands (`:`/`/`) are\n * harness metadata, not session content; empty input names nothing.\n */\nexport function isNamingEligiblePrompt(text: string): boolean {\n\tconst firstLine = text.split(\"\\n\")[0]?.trim() ?? \"\";\n\tif (!firstLine) return false;\n\tif (firstLine.startsWith(\":\") || firstLine.startsWith(\"/\")) return false;\n\treturn true;\n}\n\n/**\n * Normalize a raw model candidate: trim, collapse whitespace, strip wrapping\n * quotes, drop trailing sentence punctuation.\n */\nexport function normalizeTitleCandidate(raw: string): string {\n\tlet name = raw.trim().replace(/\\s+/g, \" \");\n\tfor (let i = 0; i < 2; i++) {\n\t\tname = name.replace(/[.!?;:]+$/, \"\").trim();\n\t\tconst quoted = /^[\"'](.*)[\"']$/.exec(name);\n\t\tif (!quoted) break;\n\t\tname = (quoted[1] ?? \"\").trim();\n\t}\n\tname = name.replace(/[.!?;:]+$/, \"\").trim();\n\treturn name;\n}\n\nexport type TitleValidation = { valid: true } | { valid: false; collision: boolean; feedback: string };\n\n/**\n * Harness-side validation for a normalized model candidate. `existing` holds\n * comparison-normalized names. Generic titles are rejected here — they remain\n * acceptable when the user supplies them explicitly via manual naming, which\n * bypasses the runtime entirely.\n */\nexport function validateTitleCandidate(name: string, existing: Set<string>): TitleValidation {\n\tif (!name) return { valid: false, collision: false, feedback: \"empty title\" };\n\tif (name.length > SESSION_NAMING_MAX_CHARS) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\tcollision: false,\n\t\t\tfeedback: `over ${SESSION_NAMING_MAX_CHARS} characters`,\n\t\t};\n\t}\n\tconst words = name.split(\" \").filter(Boolean);\n\tif (words.length > SESSION_NAMING_MAX_WORDS) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\tcollision: false,\n\t\t\tfeedback: `over ${SESSION_NAMING_MAX_WORDS} words`,\n\t\t};\n\t}\n\tif (/[\\r\\n]/.test(name) || /[{}[\\]<>]/.test(name)) {\n\t\treturn { valid: false, collision: false, feedback: \"forbidden characters\" };\n\t}\n\tif (GENERIC_TITLES.has(normalizeSessionNameForComparison(name))) {\n\t\treturn { valid: false, collision: false, feedback: \"too generic\" };\n\t}\n\tif (existing.has(normalizeSessionNameForComparison(name))) {\n\t\treturn { valid: false, collision: true, feedback: \"already in use\" };\n\t}\n\treturn { valid: true };\n}\n\n/**\n * Deterministic fallback title derived from the source prompt: first line,\n * markdown stripped, truncated. Returns undefined when nothing usable remains.\n */\nexport function deriveFallbackTitle(text: string): string | undefined {\n\tconst firstLine = text.split(\"\\n\")[0]?.trim() ?? \"\";\n\tif (!firstLine || firstLine.startsWith(\":\") || firstLine.startsWith(\"/\")) return undefined;\n\tconst cleaned = normalizeTitleCandidate(\n\t\tfirstLine\n\t\t\t.replace(/^#+\\s*/, \"\")\n\t\t\t.replace(/[*_`~]/g, \"\")\n\t\t\t.replace(/^\\[.*?\\]\\(.*?\\)$/, \"\"),\n\t);\n\tif (!cleaned) return undefined;\n\treturn cleaned.length > 50 ? `${cleaned.slice(0, 47)}...` : cleaned;\n}\n\n/** Append ` #2`, ` #3`, … until the name no longer collides. */\nexport function uniquifySessionName(base: string, existing: Set<string>): string {\n\tif (!existing.has(normalizeSessionNameForComparison(base))) return base;\n\tlet counter = 2;\n\twhile (existing.has(normalizeSessionNameForComparison(`${base} #${counter}`))) {\n\t\tcounter++;\n\t\tif (counter > 9999) break;\n\t}\n\treturn `${base} #${counter}`;\n}\n\nexport class SessionNamingRuntime {\n\tprivate state: SessionNamingState = \"pending\";\n\tprivate pendingPrompt: string | undefined;\n\tprivate epoch = 0;\n\tprivate namingAbort: AbortController | undefined;\n\tprivate readonly maxAttempts: number;\n\tprivate readonly deps: SessionNamingRuntimeDeps;\n\n\tconstructor(deps: SessionNamingRuntimeDeps) {\n\t\tthis.deps = deps;\n\t\tthis.maxAttempts = deps.maxAttempts ?? SESSION_NAMING_MAX_ATTEMPTS;\n\t}\n\n\tgetState(): SessionNamingState {\n\t\treturn this.state;\n\t}\n\n\t/** Mark the runtime ready to accept the first eligible prompt. */\n\tstart(): void {\n\t\tif (this.state === \"pending\") this.state = \"waiting\";\n\t}\n\n\t/**\n\t * Permanently step down. Abandons any in-flight naming operation (its late\n\t * result is discarded via the epoch check) and releases candidate state.\n\t * Called after successful naming and on explicit manual naming.\n\t */\n\tdisable(): void {\n\t\tthis.epoch++;\n\t\tthis.namingAbort?.abort();\n\t\tthis.namingAbort = undefined;\n\t\tthis.pendingPrompt = undefined;\n\t\tthis.state = \"disabled\";\n\t}\n\n\t/**\n\t * Record a submitted user prompt. Only the waiting state accepts one, and a\n\t * newer submission replaces any pending candidate — prompts are never\n\t * combined and aborted-prompt residue is never retained.\n\t */\n\tnotePromptSubmitted(text: string): void {\n\t\tif (this.state !== \"waiting\") return;\n\t\tif (!isNamingEligiblePrompt(text)) return;\n\t\tthis.pendingPrompt = text;\n\t}\n\n\t/**\n\t * Record that the model's execution actually started for the current run\n\t * (first assistant stream event). The pending candidate becomes the naming\n\t * source at this point and the one naming operation fires immediately, so\n\t * it runs in the background while the main agent works. Ignored unless a\n\t * candidate is pending.\n\t */\n\tnotifyModelExecutionStarted(): void {\n\t\tif (this.state !== \"waiting\" || this.pendingPrompt === undefined) return;\n\t\tconst candidate = this.pendingPrompt;\n\t\tthis.pendingPrompt = undefined;\n\t\tthis.state = \"naming\";\n\t\tvoid this.runNaming(candidate);\n\t}\n\n\t/**\n\t * Settle the pending prompt after its run completes. Only clears a\n\t * candidate whose model execution never started (e.g. aborted beforehand)\n\t * so no stale text is retained; the naming decision itself already\n\t * happened at execution start.\n\t */\n\tnotePromptSettled(): void {\n\t\tif (this.state !== \"waiting\") return;\n\t\tthis.pendingPrompt = undefined;\n\t}\n\n\tprivate install(name: string): void {\n\t\tthis.state = \"named\";\n\t\ttry {\n\t\t\tthis.deps.installName(name);\n\t\t} catch {\n\t\t\t// Naming must never degrade the main session.\n\t\t}\n\t\tthis.pendingPrompt = undefined;\n\t\tthis.namingAbort = undefined;\n\t\tthis.state = \"disabled\";\n\t}\n\n\tprivate async runNaming(candidatePrompt: string): Promise<void> {\n\t\tconst epoch = this.epoch;\n\t\tconst active = () => this.state === \"naming\" && this.epoch === epoch;\n\t\tlet existing: Set<string>;\n\t\ttry {\n\t\t\texisting = new Set((await this.deps.listExistingNames()).map(normalizeSessionNameForComparison));\n\t\t} catch {\n\t\t\texisting = new Set();\n\t\t}\n\t\tconst avoid: string[] = [];\n\t\tfor (let attempt = 1; attempt <= this.maxAttempts; attempt++) {\n\t\t\tlet raw: string | undefined;\n\t\t\ttry {\n\t\t\t\tif (!active()) return;\n\t\t\t\tconst model = this.deps.getModel();\n\t\t\t\tif (!model) break;\n\t\t\t\tconst auth = await this.deps.getRequestAuth(model);\n\t\t\t\tif (!active()) return;\n\t\t\t\traw = await this.generateCandidate(model, auth, candidatePrompt, avoid);\n\t\t\t\tif (!active()) return;\n\t\t\t} catch {\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tif (raw === undefined) break;\n\t\t\tconst normalized = normalizeTitleCandidate(raw);\n\t\t\tconst validation = validateTitleCandidate(normalized, existing);\n\t\t\tif (validation.valid) {\n\t\t\t\tthis.install(normalized);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tavoid.push(\n\t\t\t\tvalidation.collision\n\t\t\t\t\t? `The title \"${normalized}\" is already in use. Generate a different title for the same subject — prefer semantic rephrasing or a distinctive qualifier.`\n\t\t\t\t\t: `The suggestion \"${normalized}\" was rejected (${validation.feedback}). Follow the constraints exactly.`,\n\t\t\t);\n\t\t}\n\t\tif (!active()) return;\n\t\tconst fallback = deriveFallbackTitle(candidatePrompt);\n\t\tif (fallback === undefined) {\n\t\t\t// Nothing usable to name from — leave the session unnamed.\n\t\t\tthis.state = \"named\";\n\t\t\tthis.state = \"disabled\";\n\t\t\treturn;\n\t\t}\n\t\tthis.install(uniquifySessionName(fallback, existing));\n\t}\n\n\tprivate async generateCandidate(\n\t\tmodel: Model<any>,\n\t\tauth: SessionNamingRequestAuth,\n\t\tcandidatePrompt: string,\n\t\tavoid: string[],\n\t): Promise<string | undefined> {\n\t\tconst source =\n\t\t\tcandidatePrompt.length > SESSION_NAMING_MAX_SOURCE_CHARS\n\t\t\t\t? `${candidatePrompt.slice(0, SESSION_NAMING_MAX_SOURCE_CHARS)}…`\n\t\t\t\t: candidatePrompt;\n\t\tlet userText = `Generate a concise session title for the following user request. Reply with ONLY the title.\\n\\n<USER PROMPT>\\n${source}\\n</USER PROMPT>`;\n\t\tif (avoid.length > 0) {\n\t\t\tuserText += `\\n\\nConstraints from previous attempts:\\n- ${avoid.join(\"\\n- \")}`;\n\t\t}\n\t\tconst context: Context = {\n\t\t\tsystemPrompt: SESSION_NAMING_SYSTEM_PROMPT,\n\t\t\tmessages: [\n\t\t\t\t{\n\t\t\t\t\trole: \"user\",\n\t\t\t\t\tcontent: [{ type: \"text\", text: userText }],\n\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t},\n\t\t\t],\n\t\t};\n\t\tthis.namingAbort = new AbortController();\n\t\tlet response: AssistantMessage;\n\t\ttry {\n\t\t\tresponse = await completeSummarization(\n\t\t\t\tmodel,\n\t\t\t\tcontext,\n\t\t\t\t{\n\t\t\t\t\tapiKey: auth.apiKey,\n\t\t\t\t\theaders: auth.headers,\n\t\t\t\t\tenv: auth.env,\n\t\t\t\t\tsignal: this.namingAbort.signal,\n\t\t\t\t\tmaxTokens: SESSION_NAMING_MAX_TOKENS,\n\t\t\t\t},\n\t\t\t\tthis.deps.streamFunction,\n\t\t\t\tthis.deps.getRetryPolicy?.(),\n\t\t\t);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t\tif (response.stopReason !== \"stop\") return undefined;\n\t\tif (response.content.some((block) => block.type === \"toolCall\")) return undefined;\n\t\tconst text = contentText(response.content, \"\").trim();\n\t\treturn text || undefined;\n\t}\n}\n"]}

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

@@ -0,0 +1,9 @@
+import type { AgentSessionRuntimeDiagnostic } from "./agent-session-services.ts";
+import type { SettingsManager } from "./settings-manager.ts";
+export declare function collectSettingsDiagnostics(settingsManager: SettingsManager): AgentSessionRuntimeDiagnostic[];
+/**
+ * Remove duplicate type/message diagnostics while preserving their first occurrence.
+ * Startup and runtime settings managers can report the same file error.
+ */
+export declare function deduplicateDiagnostics(diagnostics: readonly AgentSessionRuntimeDiagnostic[]): AgentSessionRuntimeDiagnostic[];
+//# sourceMappingURL=settings-diagnostics.d.ts.map

package/dist/core/settings-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-diagnostics.d.ts","sourceRoot":"","sources":["../../src/core/settings-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,wBAAgB,0BAA0B,CAAC,eAAe,EAAE,eAAe,GAAG,6BAA6B,EAAE,CAK5G;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,WAAW,EAAE,SAAS,6BAA6B,EAAE,GACnD,6BAA6B,EAAE,CAQjC","sourcesContent":["import type { AgentSessionRuntimeDiagnostic } from \"./agent-session-services.ts\";\nimport type { SettingsManager } from \"./settings-manager.ts\";\n\nexport function collectSettingsDiagnostics(settingsManager: SettingsManager): AgentSessionRuntimeDiagnostic[] {\n\treturn settingsManager.drainErrors().map(({ scope, path, error }) => ({\n\t\ttype: \"warning\",\n\t\tmessage: path ? `Invalid settings file ${path}: ${error.message}` : `Invalid ${scope} settings: ${error.message}`,\n\t}));\n}\n\n/**\n * Remove duplicate type/message diagnostics while preserving their first occurrence.\n * Startup and runtime settings managers can report the same file error.\n */\nexport function deduplicateDiagnostics(\n\tdiagnostics: readonly AgentSessionRuntimeDiagnostic[],\n): AgentSessionRuntimeDiagnostic[] {\n\tconst seen = new Set<string>();\n\treturn diagnostics.filter((diagnostic) => {\n\t\tconst key = `${diagnostic.type}\\0${diagnostic.message}`;\n\t\tif (seen.has(key)) return false;\n\t\tseen.add(key);\n\t\treturn true;\n\t});\n}\n"]}

package/dist/core/settings-diagnostics.js

@@ -0,0 +1,21 @@
+export function collectSettingsDiagnostics(settingsManager) {
+    return settingsManager.drainErrors().map(({ scope, path, error }) => ({
+        type: "warning",
+        message: path ? `Invalid settings file ${path}: ${error.message}` : `Invalid ${scope} settings: ${error.message}`,
+    }));
+}
+/**
+ * Remove duplicate type/message diagnostics while preserving their first occurrence.
+ * Startup and runtime settings managers can report the same file error.
+ */
+export function deduplicateDiagnostics(diagnostics) {
+    const seen = new Set();
+    return diagnostics.filter((diagnostic) => {
+        const key = `${diagnostic.type}\0${diagnostic.message}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=settings-diagnostics.js.map

package/dist/core/settings-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-diagnostics.js","sourceRoot":"","sources":["../../src/core/settings-diagnostics.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,0BAA0B,CAAC,eAAgC,EAAmC;IAC7G,OAAO,eAAe,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACrE,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,yBAAyB,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,cAAc,KAAK,CAAC,OAAO,EAAE;KACjH,CAAC,CAAC,CAAC;AAAA,CACJ;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACrC,WAAqD,EACnB;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,GAAG,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;QACxD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IAAA,CACZ,CAAC,CAAC;AAAA,CACH","sourcesContent":["import type { AgentSessionRuntimeDiagnostic } from \"./agent-session-services.ts\";\nimport type { SettingsManager } from \"./settings-manager.ts\";\n\nexport function collectSettingsDiagnostics(settingsManager: SettingsManager): AgentSessionRuntimeDiagnostic[] {\n\treturn settingsManager.drainErrors().map(({ scope, path, error }) => ({\n\t\ttype: \"warning\",\n\t\tmessage: path ? `Invalid settings file ${path}: ${error.message}` : `Invalid ${scope} settings: ${error.message}`,\n\t}));\n}\n\n/**\n * Remove duplicate type/message diagnostics while preserving their first occurrence.\n * Startup and runtime settings managers can report the same file error.\n */\nexport function deduplicateDiagnostics(\n\tdiagnostics: readonly AgentSessionRuntimeDiagnostic[],\n): AgentSessionRuntimeDiagnostic[] {\n\tconst seen = new Set<string>();\n\treturn diagnostics.filter((diagnostic) => {\n\t\tconst key = `${diagnostic.type}\\0${diagnostic.message}`;\n\t\tif (seen.has(key)) return false;\n\t\tseen.add(key);\n\t\treturn true;\n\t});\n}\n"]}