@pentoshi/clai 2.0.62 → 3.0.0

package/dist/app/commands/command.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Command context = the focused surface a command is allowed to run in
+ * (PICK-002, CMD-002). `global` commands run anywhere the focused surface
+ * permits; others are scoped.
+ */
+export type CommandContext = "global" | "composer" | "picker" | "modal" | "secret" | "plan" | "transcript" | "transcript-search";
+export interface CommandDefinition {
+    /** Canonical name without the leading slash, e.g. "model". */
+    readonly name: string;
+    readonly aliases?: readonly string[];
+    readonly usage?: string | undefined;
+    readonly description: string;
+    /** Surfaces this command is available in; defaults to ["global"]. */
+    readonly contexts?: readonly CommandContext[];
+}
+export interface CommandInvocation {
+    /** Canonical resolved name (aliases are already resolved). */
+    readonly name: string;
+    /** Raw argument string, trimmed. */
+    readonly args: string;
+    readonly context: CommandContext;
+}
+export type CommandHandler = (invocation: CommandInvocation) => void | Promise<void>;
+export declare function normalizeCommandName(nameOrAlias: string): string;

package/dist/app/commands/command.js

@@ -0,0 +1,4 @@
+export function normalizeCommandName(nameOrAlias) {
+    return nameOrAlias.trim().replace(/^\/+/, "").toLowerCase();
+}
+//# sourceMappingURL=command.js.map

package/dist/app/commands/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/app/commands/command.ts"],"names":[],"mappings":"AAqCA,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,OAAO,WAAW,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9D,CAAC"}

package/dist/app/commands/registry.d.ts

@@ -0,0 +1,45 @@
+import { type CommandContext, type CommandDefinition, type CommandHandler, type CommandInvocation } from "./command.js";
+export interface CommandHelpEntry {
+    readonly command: string;
+    readonly usage?: string | undefined;
+    readonly description: string;
+    readonly aliases: readonly string[];
+}
+/**
+ * One typed source of truth for slash commands. Registration is closed once
+ * seeded; handlers are attached by whichever frontend consumes the registry so
+ * UI-coupled handler bodies are not duplicated across legacy and v2.
+ */
+export declare class CommandRegistry {
+    private readonly byName;
+    private readonly aliasToName;
+    private readonly handlers;
+    register(definition: CommandDefinition): void;
+    resolve(nameOrAlias: string): string | undefined;
+    has(nameOrAlias: string): boolean;
+    get(nameOrAlias: string): CommandDefinition | undefined;
+    all(): CommandDefinition[];
+    setHandler(nameOrAlias: string, handler: CommandHandler): void;
+    /** Prefix match over canonical names and aliases (for completion menus). */
+    suggestions(prefix: string): CommandDefinition[];
+    help(): CommandHelpEntry[];
+    /** Parse a raw `/name args` line into a resolved invocation, or undefined. */
+    parse(line: string, context?: CommandContext): CommandInvocation | undefined;
+    /**
+     * True when a submitted line should be treated as a slash-command attempt
+     * (known name, unique prefix, or command-shaped word) rather than a prompt.
+     * Paths like `/Users/...` return false.
+     */
+    looksLikeCommand(line: string): boolean;
+    /** Resolve + run the registered handler. Returns false if unknown/unhandled. */
+    dispatch(invocation: {
+        name: string;
+        args?: string | undefined;
+        context?: CommandContext | undefined;
+    }): Promise<boolean>;
+}
+/**
+ * Seed a registry from the shared legacy command catalogue so v2 and the
+ * classic REPL agree on the command set without a second hand-maintained list.
+ */
+export declare function buildDefaultCommandRegistry(): CommandRegistry;

package/dist/app/commands/registry.js

@@ -0,0 +1,164 @@
+import { slashCommands } from "../../repl/slash-commands.js";
+import { normalizeCommandName, } from "./command.js";
+/**
+ * Canonical command -> alias names. The legacy catalogue lists aliases as
+ * separate rows ("alias for /X"); here they collapse onto one canonical
+ * command so menus, help, keybindings, and dispatch all derive from a single
+ * definition (CMD-002, FEATURE_PARITY "aliases point to the same handler").
+ */
+const ALIAS_GROUPS = {
+    provider: ["use"],
+    search: ["search-provider"],
+    variants: ["reasoning"],
+    think: ["thinking"],
+    exit: ["quit"],
+};
+/**
+ * One typed source of truth for slash commands. Registration is closed once
+ * seeded; handlers are attached by whichever frontend consumes the registry so
+ * UI-coupled handler bodies are not duplicated across legacy and v2.
+ */
+export class CommandRegistry {
+    byName = new Map();
+    aliasToName = new Map();
+    handlers = new Map();
+    register(definition) {
+        const name = normalizeCommandName(definition.name);
+        if (this.byName.has(name) || this.aliasToName.has(name)) {
+            throw new Error(`duplicate command name: ${name}`);
+        }
+        this.byName.set(name, { ...definition, name });
+        for (const alias of definition.aliases ?? []) {
+            const normalized = normalizeCommandName(alias);
+            if (this.aliasToName.has(normalized) || this.byName.has(normalized)) {
+                throw new Error(`duplicate command alias: ${normalized}`);
+            }
+            this.aliasToName.set(normalized, name);
+        }
+    }
+    resolve(nameOrAlias) {
+        const name = normalizeCommandName(nameOrAlias);
+        if (this.byName.has(name))
+            return name;
+        return this.aliasToName.get(name);
+    }
+    has(nameOrAlias) {
+        return this.resolve(nameOrAlias) !== undefined;
+    }
+    get(nameOrAlias) {
+        const name = this.resolve(nameOrAlias);
+        return name ? this.byName.get(name) : undefined;
+    }
+    all() {
+        return [...this.byName.values()];
+    }
+    setHandler(nameOrAlias, handler) {
+        const name = this.resolve(nameOrAlias);
+        if (!name)
+            throw new Error(`unknown command: ${nameOrAlias}`);
+        this.handlers.set(name, handler);
+    }
+    /** Prefix match over canonical names and aliases (for completion menus). */
+    suggestions(prefix) {
+        const needle = normalizeCommandName(prefix);
+        const matches = [];
+        for (const def of this.byName.values()) {
+            const names = [def.name, ...(def.aliases ?? [])];
+            if (names.some((n) => n.startsWith(needle)))
+                matches.push(def);
+        }
+        return matches;
+    }
+    help() {
+        return this.all().map((def) => ({
+            command: `/${def.name}`,
+            usage: def.usage,
+            description: def.description,
+            aliases: (def.aliases ?? []).map((a) => `/${a}`),
+        }));
+    }
+    /** Parse a raw `/name args` line into a resolved invocation, or undefined. */
+    parse(line, context = "global") {
+        if (!line.startsWith("/"))
+            return undefined;
+        const rest = line.slice(1);
+        const boundary = rest.search(/\s/);
+        const rawName = boundary === -1 ? rest : rest.slice(0, boundary);
+        const args = boundary === -1 ? "" : rest.slice(boundary + 1).trim();
+        // Absolute paths (/Users/..., /tmp/foo) are prompts, not commands.
+        if (!rawName || rawName.includes("/") || rawName.includes("\\")) {
+            return undefined;
+        }
+        const exact = this.resolve(rawName);
+        if (exact)
+            return { name: exact, args, context };
+        // Unique prefix match so a broken completion menu still dispatches
+        // "/mod" → /model, "/imp" → /implement, etc.
+        if (rawName.length === 0)
+            return undefined;
+        const matches = this.suggestions(rawName);
+        if (matches.length === 1) {
+            return { name: matches[0].name, args, context };
+        }
+        return undefined;
+    }
+    /**
+     * True when a submitted line should be treated as a slash-command attempt
+     * (known name, unique prefix, or command-shaped word) rather than a prompt.
+     * Paths like `/Users/...` return false.
+     */
+    looksLikeCommand(line) {
+        if (!line.startsWith("/") || line.length < 2)
+            return false;
+        const firstToken = line.slice(1).split(/\s/)[0] ?? "";
+        if (!firstToken || firstToken.includes("/") || firstToken.includes("\\")) {
+            return false;
+        }
+        if (this.resolve(firstToken))
+            return true;
+        if (this.suggestions(firstToken).length > 0)
+            return true;
+        return /^[a-z][a-z0-9-]*$/i.test(firstToken);
+    }
+    /** Resolve + run the registered handler. Returns false if unknown/unhandled. */
+    async dispatch(invocation) {
+        const name = this.resolve(invocation.name);
+        if (!name)
+            return false;
+        const handler = this.handlers.get(name);
+        if (!handler)
+            return false;
+        await handler({
+            name,
+            args: invocation.args ?? "",
+            context: invocation.context ?? "global",
+        });
+        return true;
+    }
+}
+/**
+ * Seed a registry from the shared legacy command catalogue so v2 and the
+ * classic REPL agree on the command set without a second hand-maintained list.
+ */
+export function buildDefaultCommandRegistry() {
+    const registry = new CommandRegistry();
+    const aliasNames = new Set();
+    for (const aliases of Object.values(ALIAS_GROUPS)) {
+        for (const alias of aliases)
+            aliasNames.add(alias);
+    }
+    for (const command of slashCommands) {
+        const name = normalizeCommandName(command.command);
+        if (aliasNames.has(name))
+            continue; // attached to its canonical below
+        const aliases = ALIAS_GROUPS[name];
+        registry.register({
+            name,
+            description: command.description,
+            usage: command.usage,
+            ...(aliases ? { aliases } : {}),
+        });
+    }
+    return registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/app/commands/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/app/commands/registry.ts"],"names":[],"mappings":"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"}

package/dist/app/controllers/disposable.d.ts

@@ -0,0 +1,15 @@
+export interface Disposable {
+    dispose(): void;
+}
+/**
+ * Owns a set of disposables and tears them down in reverse creation order
+ * (ARCHITECTURE.md lifecycle). Disposal is idempotent (REL-001): a second call
+ * is a no-op, and one throwing disposer does not prevent the rest from running.
+ */
+export declare class CompositeDisposable implements Disposable {
+    private readonly items;
+    private disposed;
+    add<T extends Disposable>(item: T): T;
+    get isDisposed(): boolean;
+    dispose(): void;
+}

package/dist/app/controllers/disposable.js

@@ -0,0 +1,38 @@
+/**
+ * Owns a set of disposables and tears them down in reverse creation order
+ * (ARCHITECTURE.md lifecycle). Disposal is idempotent (REL-001): a second call
+ * is a no-op, and one throwing disposer does not prevent the rest from running.
+ */
+export class CompositeDisposable {
+    items = [];
+    disposed = false;
+    add(item) {
+        if (this.disposed) {
+            item.dispose();
+            return item;
+        }
+        this.items.push(item);
+        return item;
+    }
+    get isDisposed() {
+        return this.disposed;
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        const errors = [];
+        for (let i = this.items.length - 1; i >= 0; i -= 1) {
+            try {
+                this.items[i]?.dispose();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        this.items.length = 0;
+        if (errors.length > 0)
+            throw errors[0];
+    }
+}
+//# sourceMappingURL=disposable.js.map

package/dist/app/controllers/disposable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposable.js","sourceRoot":"","sources":["../../../src/app/controllers/disposable.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IACb,KAAK,GAAiB,EAAE,CAAC;IAClC,QAAQ,GAAG,KAAK,CAAC;IAEzB,GAAG,CAAuB,IAAO;QAC/B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC;gBACH,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACtB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/app/controllers/job-controller.d.ts

@@ -0,0 +1,22 @@
+import type { ToolResult } from "../../types.js";
+import type { BackgroundJob, JobsPort } from "../ports/jobs-port.js";
+import type { Disposable } from "./disposable.js";
+/**
+ * Thin lifecycle wrapper over `JobsPort` (CORE-004). Jobs live in the core
+ * manager and survive UI rerenders; this controller only observes and commands.
+ */
+export declare class JobController implements Disposable {
+    private readonly jobs;
+    constructor(jobs: JobsPort);
+    list(): ToolResult;
+    running(): BackgroundJob[];
+    get(id: string): BackgroundJob | undefined;
+    tail(id: string, bytes?: number): Promise<ToolResult>;
+    stop(id: string): ToolResult;
+    start(command: string, options?: {
+        cwd?: string | undefined;
+        name?: string | undefined;
+    }): Promise<ToolResult>;
+    hasRunning(): boolean;
+    dispose(): void;
+}

package/dist/app/controllers/job-controller.js

@@ -0,0 +1,35 @@
+/**
+ * Thin lifecycle wrapper over `JobsPort` (CORE-004). Jobs live in the core
+ * manager and survive UI rerenders; this controller only observes and commands.
+ */
+export class JobController {
+    jobs;
+    constructor(jobs) {
+        this.jobs = jobs;
+    }
+    list() {
+        return this.jobs.list();
+    }
+    running() {
+        return this.jobs.running();
+    }
+    get(id) {
+        return this.jobs.get(id);
+    }
+    tail(id, bytes) {
+        return this.jobs.tail(id, bytes);
+    }
+    stop(id) {
+        return this.jobs.stop(id);
+    }
+    start(command, options) {
+        return this.jobs.start(command, options);
+    }
+    hasRunning() {
+        return this.running().length > 0;
+    }
+    dispose() {
+        // Jobs intentionally outlive the UI; nothing to tear down here.
+    }
+}
+//# sourceMappingURL=job-controller.js.map

package/dist/app/controllers/job-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-controller.js","sourceRoot":"","sources":["../../../src/app/controllers/job-controller.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,IAAc;QAAd,SAAI,GAAJ,IAAI,CAAU;IAAG,CAAC;IAE/C,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC,EAAU,EAAE,KAAc;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CACH,OAAe,EACf,OAAiE;QAEjE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,OAAO;QACL,gEAAgE;IAClE,CAAC;CACF"}

package/dist/app/controllers/plan-controller.d.ts

@@ -0,0 +1,31 @@
+import type { SessionPlan } from "../../store/plan.js";
+import type { AnyAppEvent } from "../events/app-event.js";
+import type { PersistencePort } from "../ports/persistence-port.js";
+import type { Disposable } from "./disposable.js";
+export type PlanListener = () => void;
+/**
+ * Holds the one current plan entity and keeps it in sync with the event stream
+ * (PLAN-003: mutate the existing plan, never append duplicates). Approval and
+ * discard mutate persisted status through the persistence port. Observable so
+ * the UI can bind reactively without polling (PLAN-002).
+ */
+export declare class PlanController implements Disposable {
+    private readonly persistence;
+    private plan;
+    private readonly listeners;
+    constructor(persistence: PersistencePort);
+    current(): SessionPlan | undefined;
+    subscribe(listener: PlanListener): () => void;
+    observe(event: AnyAppEvent): void;
+    /**
+     * Load the plan for `sessionId` from disk into memory. Clears the in-memory
+     * plan when none is stored (so switching sessions never leaves a stale card).
+     */
+    load(sessionId: string): Promise<SessionPlan | undefined>;
+    /** Drop the in-memory plan without touching disk. */
+    clear(): void;
+    approve(): Promise<SessionPlan | undefined>;
+    discard(): Promise<void>;
+    dispose(): void;
+    private notify;
+}

package/dist/app/controllers/plan-controller.js

@@ -0,0 +1,69 @@
+/**
+ * Holds the one current plan entity and keeps it in sync with the event stream
+ * (PLAN-003: mutate the existing plan, never append duplicates). Approval and
+ * discard mutate persisted status through the persistence port. Observable so
+ * the UI can bind reactively without polling (PLAN-002).
+ */
+export class PlanController {
+    persistence;
+    plan;
+    listeners = new Set();
+    constructor(persistence) {
+        this.persistence = persistence;
+    }
+    current() {
+        return this.plan;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    observe(event) {
+        if (event.type === "plan-updated") {
+            this.plan = event.payload.plan;
+            this.notify();
+        }
+    }
+    /**
+     * Load the plan for `sessionId` from disk into memory. Clears the in-memory
+     * plan when none is stored (so switching sessions never leaves a stale card).
+     */
+    async load(sessionId) {
+        this.plan = await this.persistence.loadPlan(sessionId);
+        this.notify();
+        return this.plan;
+    }
+    /** Drop the in-memory plan without touching disk. */
+    clear() {
+        if (!this.plan)
+            return;
+        this.plan = undefined;
+        this.notify();
+    }
+    async approve() {
+        if (!this.plan)
+            return undefined;
+        const next = { ...this.plan, status: "approved" };
+        this.plan = next;
+        await this.persistence.savePlan(next);
+        this.notify();
+        return next;
+    }
+    async discard() {
+        if (!this.plan)
+            return;
+        const { sessionId } = this.plan;
+        this.plan = undefined;
+        await this.persistence.deletePlan(sessionId);
+        this.notify();
+    }
+    dispose() {
+        this.plan = undefined;
+        this.listeners.clear();
+    }
+    notify() {
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+//# sourceMappingURL=plan-controller.js.map

package/dist/app/controllers/plan-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-controller.js","sourceRoot":"","sources":["../../../src/app/controllers/plan-controller.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IAII;IAHrB,IAAI,CAA0B;IACrB,SAAS,GAAG,IAAI,GAAG,EAAgB,CAAC;IAErD,YAA6B,WAA4B;QAA5B,gBAAW,GAAX,WAAW,CAAiB;IAAG,CAAC;IAE7D,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,SAAS,CAAC,QAAsB;QAC9B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,CAAC,KAAkB;QACxB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,IAAI,CAAC,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,qDAAqD;IACrD,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO;QACvB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QACjC,MAAM,IAAI,GAAgB,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO;QACvB,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAEO,MAAM;QACZ,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,EAAE,CAAC;IACpD,CAAC;CACF"}

package/dist/app/controllers/session-controller.d.ts

@@ -0,0 +1,167 @@
+import type { ChatMessage, Mode, ProviderId } from "../../types.js";
+import { type CompactResult } from "../../agent/context-manager.js";
+import type { TranscriptItem as ClassicTranscriptItem } from "../../tui/state.js";
+import { type AnyAppEvent, type SessionId, type TurnId } from "../events/app-event.js";
+import { type Clock, type IdFactory } from "../events/sequencer.js";
+import { OutputSpool } from "../events/event-buffer.js";
+import type { AgentPort } from "../ports/agent-port.js";
+import type { PersistencePort } from "../ports/persistence-port.js";
+import type { ConfirmationPort } from "../ports/confirm-port.js";
+import type { SecretPort } from "../ports/secret-port.js";
+import { type TurnResult } from "./turn-controller.js";
+import { type Disposable } from "./disposable.js";
+export interface SessionState {
+    readonly sessionId: SessionId;
+    readonly mode: Mode;
+    readonly provider: ProviderId | undefined;
+    readonly model: string | undefined;
+    readonly running: boolean;
+    /** True while /compact is awaiting the summarizer (status strip). */
+    readonly compacting: boolean;
+    readonly historyLength: number;
+    readonly queued: readonly string[];
+    /** AI-generated (or last known) display name for this session. */
+    readonly title: string | undefined;
+}
+export type NoticeLevel = "info" | "warn";
+export interface SessionControllerDeps {
+    readonly agent: AgentPort;
+    readonly persistence: PersistencePort;
+    readonly emit: (event: AnyAppEvent) => void;
+    readonly sessionId?: string | undefined;
+    readonly provider?: ProviderId | undefined;
+    readonly model?: string | undefined;
+    readonly mode?: Mode | undefined;
+    readonly confirm?: ConfirmationPort | undefined;
+    readonly requestSecret?: SecretPort["request"] | undefined;
+    readonly idFactory?: IdFactory | undefined;
+    readonly clock?: Clock | undefined;
+    readonly mintTurnId?: (() => TurnId) | undefined;
+    /**
+     * Optional snapshot of the visual transcript for history.db (classic shape).
+     * When provided, completed turns upsert session + transcript so /history
+     * can restore tools and prompts, not only ChatMessage[].
+     */
+    readonly getTranscriptSnapshot?: (() => ClassicTranscriptItem[] | undefined) | undefined;
+    /** When true, never persist sessions or generate AI titles (CLI --no-history). */
+    readonly noHistory?: boolean | undefined;
+}
+/**
+ * Owns session-level state (mode, provider/model, cumulative history, queued
+ * drafts) and runs turns through a single `TurnController`. Cumulative history
+ * follows the current runner contract: `onMessages` hands back the full
+ * conversation for the turn (prior context + this turn), which replaces the
+ * stored history and is persisted on completion.
+ */
+export type TurnEndListener = (result: TurnResult) => void;
+export type SessionStateListener = () => void;
+export declare class SessionController implements Disposable {
+    private readonly deps;
+    readonly spool: OutputSpool;
+    private sessionIdValue;
+    private readonly sequencer;
+    private readonly turn;
+    private policy;
+    private readonly disposables;
+    private readonly turnEndListeners;
+    private readonly stateListeners;
+    private history;
+    private readonly queue;
+    /**
+     * Prompt promoted by "Send now" while a turn was running. After the abort
+     * settles, {@link continueQueue} runs this before any remaining queue items.
+     */
+    private priorityPrompt;
+    /** Re-entrancy guard for {@link continueQueue}. */
+    private continuingQueue;
+    private provider;
+    private model;
+    private mode;
+    private compactingFlag;
+    /** Display name written into history.db (AI title or explicit /save name). */
+    private sessionTitle;
+    /** User-message count at last successful AI title (classic refresh cadence). */
+    private titledAtUserCount;
+    private titleInFlight;
+    constructor(deps: SessionControllerDeps);
+    get sessionId(): SessionId;
+    getState(): SessionState;
+    get messages(): readonly ChatMessage[];
+    /** Subscribe to transient UI state such as running/queue status. */
+    subscribe(listener: SessionStateListener): () => void;
+    setProvider(provider: ProviderId | undefined): void;
+    setModel(model: string | undefined): void;
+    setMode(mode: Mode): void;
+    /**
+     * Replace model history (and optionally rebind the session id so later
+     * autosaves update the resumed history row).
+     */
+    loadHistory(messages: readonly ChatMessage[], options?: {
+        sessionId?: string;
+        title?: string | undefined;
+    }): void;
+    notice(level: NoticeLevel, text: string): void;
+    allowTool(name: string): void;
+    disallowTool(name: string): void;
+    allowedTools(): readonly string[];
+    /**
+     * Clear conversation state. When `mintNewId` is true (for `/new`/`/clean`),
+     * remint the session id so subsequent autosave does not overwrite the prior
+     * history row.
+     */
+    reset(options?: {
+        mintNewId?: boolean;
+    }): void;
+    compact(sessionTranscript?: string, keepRecent?: number, signal?: AbortSignal): Promise<CompactResult>;
+    /** Persist current messages (+ optional visual transcript) under this session id. */
+    persistNow(name?: string): Promise<void>;
+    /**
+     * Ask the model for a short conversation title and upsert it into history.
+     * Cadence matches classic TUI: first completed exchange, then every +2 user
+     * turns so the name tracks the evolving topic.
+     */
+    maybeRefreshTitle(): Promise<void>;
+    estimateContext(): {
+        messages: number;
+        tokens: number;
+    };
+    enqueue(prompt: string): void;
+    queued(): readonly string[];
+    removeQueued(index: number): void;
+    /**
+     * Remove a queued draft and return its text (for "Edit" → composer).
+     * Returns undefined when the index is out of range.
+     */
+    takeQueued(index: number): string | undefined;
+    /** Edit a queued draft in place before it runs (INPUT-007). */
+    editQueued(index: number, text: string): void;
+    /** Move a queued draft to a new position before it runs (INPUT-007). */
+    reorderQueued(fromIndex: number, toIndex: number): void;
+    /**
+     * Send a queued prompt immediately. If a turn is running, abort it first;
+     * the chosen prompt runs next (ahead of any remaining queue). If idle,
+     * submit it now.
+     */
+    sendQueuedNow(index: number): void;
+    abort(): void;
+    /**
+     * After a turn settles, run any "send now" priority prompt, then drain the
+     * queue one-by-one. Safe to call from onTurnEnd (re-entrancy guarded).
+     */
+    continueQueue(): Promise<void>;
+    /** In-memory plan-approval flag consumed by the agent gate (CORE-005). */
+    setPlanApproved(value: boolean): void;
+    isPlanApproved(): boolean;
+    /** Fires after every turn settles (completed/aborted/error), including drain. */
+    onTurnEnd(listener: TurnEndListener): () => void;
+    submit(prompt: string): Promise<TurnResult>;
+    /**
+     * Runs queued prompts one at a time while idle; stops on first
+     * non-completion. Prefer {@link continueQueue} from the UI so priority
+     * ("send now") prompts are honored too.
+     */
+    drain(): Promise<TurnResult[]>;
+    private runTurn;
+    dispose(): void;
+    private notifyState;
+}