@sagmans/dsh-tui 0.1.0

package/lib/agent/history.js

@@ -0,0 +1,179 @@
+/** Sessions the picker offers before a menu stops being a menu. */
+export const PICKER_LIMIT = 30;
+/** Events read to title one session: enough to reach its title or first prompt. */
+export const TITLE_EVENT_LIMIT = 40;
+/** Longest session title the picker shows, before the row can no longer hold it. */
+export const TITLE_CHAR_LIMIT = 72;
+/** Events read to resolve a session's preset: a selection sits in its blank prefix. */
+export const PRESET_EVENT_LIMIT = 40;
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+/** One stored header, or undefined when the snapshot carries no usable identity. */
+function headerOf(snapshot) {
+    const entry = asRecord(snapshot);
+    const header = asRecord(entry?.header);
+    const id = header?.id;
+    if (typeof id !== 'string')
+        return undefined;
+    const eventCount = entry?.eventCount;
+    return {
+        id,
+        agentPreset: typeof header?.agentPreset === 'string' ? header.agentPreset : undefined,
+        eventCount: typeof eventCount === 'number' ? eventCount : undefined,
+    };
+}
+function clip(title, limit) {
+    const collapsed = title.replace(/\s+/gu, ' ').trim();
+    if (collapsed === '')
+        return '';
+    return collapsed.length > limit ? `${collapsed.slice(0, limit - 1)}…` : collapsed;
+}
+/**
+ * Name a session, preferring the title the harness derived or the reader set.
+ *
+ * The durable `session/title` wins because it is what every other surface
+ * shows; a session that has none yet falls back to its first human prompt.
+ * Injected context and plugin notices also arrive as user-role messages, so
+ * only a direct prompt may name a session.
+ */
+export function sessionTitle(events, limit = TITLE_CHAR_LIMIT) {
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+        const event = events[index];
+        if (event?.type !== 'session/title')
+            continue;
+        const declared = asRecord(event.data)?.title;
+        if (typeof declared !== 'string')
+            continue;
+        const title = clip(declared, limit);
+        if (title !== '')
+            return title;
+    }
+    for (const event of events) {
+        if (event.type !== 'user/message')
+            continue;
+        const data = asRecord(event.data);
+        if (asRecord(data?.source)?.kind !== 'user')
+            continue;
+        const content = Array.isArray(data?.content) ? data.content : [];
+        const parts = [];
+        for (const block of content) {
+            const text = asRecord(block)?.text;
+            if (typeof text === 'string')
+                parts.push(text);
+        }
+        const title = clip(parts.join(' '), limit);
+        if (title === '')
+            continue;
+        return title;
+    }
+    return undefined;
+}
+/**
+ * Title one stored session.
+ *
+ * The tail is read first because a title is latest-wins and usually written
+ * after the first turn; the head is the fallback for a session that has a
+ * prompt but no title yet.
+ */
+export async function readSessionTitle(history, session) {
+    const end = session.eventCount ?? 0;
+    if (end > TITLE_EVENT_LIMIT) {
+        const tail = await history.read(session.id, { offset: end - TITLE_EVENT_LIMIT, limit: TITLE_EVENT_LIMIT });
+        const declared = sessionTitle(tail);
+        if (declared !== undefined)
+            return declared;
+    }
+    return sessionTitle(await history.read(session.id, { limit: TITLE_EVENT_LIMIT }));
+}
+/**
+ * The agent preset a stored session runs.
+ *
+ * The creation header names the preset the session STARTED with, and a
+ * selection recorded while it was still blank replaced it. The projection's own
+ * rule is that the last selection wins over the header, so the tail is read
+ * first and the head second: the harness refuses a switch once a turn has run,
+ * which puts any selection in the blank prefix. Reading both keeps this correct
+ * if that rule ever loosens, and the event count bounds the work either way.
+ */
+export async function presetOfStoredSession(history, id) {
+    const header = await history.header(id);
+    if (header === undefined)
+        return undefined;
+    const end = header.eventCount ?? 0;
+    if (end > PRESET_EVENT_LIMIT) {
+        const tail = await lastSelection(history, id, end - PRESET_EVENT_LIMIT, PRESET_EVENT_LIMIT);
+        if (tail !== undefined)
+            return tail;
+    }
+    return await lastSelection(history, id, 0, PRESET_EVENT_LIMIT) ?? header.agentPreset;
+}
+/** The last recorded selection inside one slice of a session's log. */
+async function lastSelection(history, id, offset, limit) {
+    const events = await history.read(id, { offset, limit });
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+        const event = events[index];
+        if (event?.type !== 'agent-preset/selected')
+            continue;
+        const preset = asRecord(event.data)?.agentPreset;
+        if (typeof preset === 'string' && preset !== '')
+            return preset;
+    }
+    return undefined;
+}
+/**
+ * Wrap the persistence service in the little of it a terminal needs.
+ *
+ * The seam itself is optional here: a composition without durable storage can
+ * still run the surface, it just cannot list or replay stored sessions. A read
+ * handle is always closed, because an unclosed one keeps backend resources
+ * alive for the rest of the process.
+ */
+export function createSessionHistory(ctx) {
+    const service = ctx.get('sessionPersistence');
+    if (typeof service?.list !== 'function' || typeof service.open !== 'function')
+        return undefined;
+    const read = async (id, options) => {
+        const handle = (await service.open(id, 'read'));
+        try {
+            const result = await handle.read(options?.offset ?? 0, options?.limit);
+            const events = [];
+            for (const entry of result.events ?? []) {
+                const record = asRecord(entry);
+                if (typeof record?.type !== 'string')
+                    continue;
+                events.push({ type: record.type, data: record.data });
+            }
+            return events;
+        }
+        finally {
+            await handle.close();
+        }
+    };
+    return {
+        read,
+        header: async (id) => {
+            const stat = service.stat;
+            return typeof stat === 'function' ? headerOf(await stat.call(service, id)) : undefined;
+        },
+        list: async (limit) => {
+            const snapshots = await service.list();
+            const sessions = [];
+            for (const entry of Array.isArray(snapshots) ? snapshots : []) {
+                const header = asRecord(asRecord(entry)?.header);
+                const id = header?.id;
+                if (typeof id !== 'string')
+                    continue;
+                const eventCount = asRecord(entry)?.eventCount;
+                sessions.push({
+                    id,
+                    cwd: typeof header?.cwd === 'string' ? header.cwd : undefined,
+                    createdAt: typeof header?.createdAt === 'number' ? header.createdAt : 0,
+                    eventCount: typeof eventCount === 'number' ? eventCount : undefined,
+                });
+            }
+            return sessions.sort((left, right) => right.createdAt - left.createdAt).slice(0, limit);
+        },
+    };
+}
+//# sourceMappingURL=history.js.map

package/lib/agent/history.js.map

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

package/lib/agent/host.d.ts

@@ -0,0 +1,58 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import { type SessionId } from '@deepseek-ai/dsh-session';
+/** Everything the terminal surface needs to own one interactive agent. */
+export interface TuiAgent {
+    readonly sessionId: SessionId;
+    readonly agent: Agent;
+    /** Queue an ordinary next-turn prompt from the human. */
+    submit(text: string): void;
+    /** Redirect the running turn without starting another one. */
+    steer(text: string): void;
+    /** Abort the active activity; the inbox is left alone. */
+    interrupt(): void;
+    /** Stop the loop and release the session. */
+    dispose(): Promise<void>;
+}
+/** History a fork inherits from the session it branches off. */
+export interface ForkInheritance {
+    /** Session the branch starts from. */
+    readonly from: SessionId;
+    /** Contiguous prefix of that session's log, ending on a completed turn. */
+    readonly events: readonly unknown[];
+}
+/** Launch inputs that decide which agent this run drives. */
+export interface StartAgentOptions {
+    readonly sessionId: SessionId;
+    readonly resume: boolean;
+    readonly model: string | undefined;
+    readonly provider: string | undefined;
+    /** Workspace for a fresh session; ignored when resuming persisted history. */
+    readonly cwd: string;
+    /**
+     * Compose the agent's own scoped world before it is published.
+     *
+     * Agent-scoped waterfalls — model selection among them — only see requests
+     * dispatched inside that scope, so they must be registered here rather than
+     * on the context that created the agent.
+     */
+    readonly setup?: (agentCtx: Context) => void;
+    /** Branch from another session's completed history instead of starting empty. */
+    readonly fork?: ForkInheritance;
+    /**
+     * Agent preset a NEW session runs, recorded in its header.
+     *
+     * The caller mounts it in `setup`; a resume keeps the preset its own log
+     * recorded, so it never passes one.
+     */
+    readonly preset?: string | undefined;
+}
+/**
+ * Create or resume the one agent this surface drives.
+ *
+ * A resume is attempted first when the launcher asked for it, because a
+ * session that exists must keep its own identity and history; a missing
+ * session is not an error the user should see, so creation is the fallback.
+ */
+export declare function startAgent(ctx: Context, options: StartAgentOptions): Promise<TuiAgent>;
+//# sourceMappingURL=host.d.ts.map

package/lib/agent/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/agent/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAG9F,0EAA0E;AAC1E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,yDAAyD;IACzD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,8DAA8D;IAC9D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,0DAA0D;IAC1D,SAAS,IAAI,IAAI,CAAA;IACjB,6CAA6C;IAC7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CACpC;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IAC5C,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAA;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC;AAiBD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkC5F"}

package/lib/agent/host.js

@@ -0,0 +1,59 @@
+import { SessionLogOffset } from '@deepseek-ai/dsh-session';
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+function routeOf(ctx, options) {
+    if (options.model !== undefined || options.provider !== undefined) {
+        return {
+            ...(options.provider === undefined ? {} : { provider: options.provider }),
+            ...(options.model === undefined ? {} : { model: options.model }),
+        };
+    }
+    const selection = ctx.get('agentDefaultModel')?.currentSelection();
+    return selection === undefined ? {} : { provider: selection.provider, model: selection.model };
+}
+function userMessage(text) {
+    return createUserMessage({ content: [{ type: 'text', text }], source: { kind: 'user' } });
+}
+/**
+ * Create or resume the one agent this surface drives.
+ *
+ * A resume is attempted first when the launcher asked for it, because a
+ * session that exists must keep its own identity and history; a missing
+ * session is not an error the user should see, so creation is the fallback.
+ */
+export async function startAgent(ctx, options) {
+    const agentOptions = routeOf(ctx, options);
+    const meta = { cwd: options.cwd };
+    const setup = options.setup === undefined ? {} : { setup: options.setup };
+    // A branch inherits a prefix of its parent's log, so the child is marked as
+    // seeded and carries the exact cut the host validates against.
+    const branch = options.fork === undefined
+        ? {}
+        : {
+            seed: options.fork.events,
+            inheritedEventCount: SessionLogOffset(options.fork.events.length),
+        };
+    const preset = options.preset === undefined ? {} : { agentPreset: options.preset };
+    const identity = options.fork === undefined
+        ? { ...meta, ...preset }
+        : { ...meta, parentSession: options.fork.from, isSeeded: true, ...preset };
+    const handle = options.resume
+        ? await ctx.agents
+            .resume({ resumeSessionId: options.sessionId, agentOptions, ...setup })
+            .catch(() => ctx.agents.create({ sessionId: options.sessionId, meta: identity, agentOptions, ...branch, ...setup }))
+        : await ctx.agents.create({ sessionId: options.sessionId, meta: identity, agentOptions, ...branch, ...setup });
+    let disposed = false;
+    return {
+        sessionId: options.sessionId,
+        agent: handle.agent,
+        submit: text => handle.agent.followup(userMessage(text)),
+        steer: text => handle.agent.steer(userMessage(text)),
+        interrupt: () => handle.agent.cancel({ kind: 'user' }),
+        dispose: async () => {
+            if (disposed)
+                return;
+            disposed = true;
+            await handle.dispose();
+        },
+    };
+}
+//# sourceMappingURL=host.js.map

package/lib/agent/host.js.map

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

package/lib/agent/model.d.ts

@@ -0,0 +1,61 @@
+import type { Context } from '@deepseek-ai/cordis';
+/** The route a reader chose for the next step. */
+export interface ModelChoice {
+    readonly provider: string;
+    readonly model: string;
+    readonly reasoningEffort?: string;
+}
+/** One provider a session may route through. */
+export interface ProviderEntry {
+    readonly id: string;
+    readonly name: string;
+}
+/** What a `/model` argument asks the surface to do. */
+export type ModelCommand = {
+    readonly kind: 'current';
+} | {
+    readonly kind: 'list-models';
+    readonly provider: string;
+} | {
+    readonly kind: 'switch';
+    readonly choice: ModelChoice;
+} | {
+    readonly kind: 'invalid';
+    readonly reason: string;
+};
+/**
+ * Read a `/model` argument.
+ *
+ * The forms are deliberately unambiguous: a bare argument that names a provider
+ * lists that provider's models, `provider/model` switches, and anything else is
+ * taken as a model id inside the route already in use, because a reader
+ * switching between two models of one provider should not have to repeat it.
+ */
+export declare function parseModelArgument(argument: string, providers: readonly ProviderEntry[], current: ModelChoice | undefined): ModelCommand;
+/**
+ * Own the reader's model choice for one session.
+ *
+ * The choice is applied through the agent's own scoped waterfalls, so it takes
+ * effect on the next step rather than splitting an in-flight request, and the
+ * loop logs its own durable notice when the route actually changes.
+ */
+export declare class ModelSwitch {
+    private readonly selection;
+    private installed;
+    /** Compose the switch into the agent's scope, where the waterfalls are dispatched. */
+    install(agentCtx: Context): void;
+    choose(choice: ModelChoice): void;
+    current(): ModelChoice | undefined;
+    /** Forget the choice, so the session returns to the composition default. */
+    reset(): void;
+    dispose(): void;
+}
+/** Read the advisory catalog of routes this composition can reach. */
+export declare function createModelCatalog(ctx: Context): {
+    providers(): readonly ProviderEntry[];
+    models(provider: string): Promise<readonly {
+        readonly id: string;
+        readonly name: string;
+    }[]>;
+} | undefined;
+//# sourceMappingURL=model.d.ts.map

package/lib/agent/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/agent/model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,uDAAuD;AACvD,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,aAAa,EAAE,EACnC,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,YAAY,CAgBd;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkE;IAC5F,OAAO,CAAC,SAAS,CAA0B;IAE3C,sFAAsF;IACtF,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAKhC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAUjC,OAAO,IAAI,WAAW,GAAG,SAAS;IAUlC,4EAA4E;IAC5E,KAAK,IAAI,IAAI;IAKb,OAAO,IAAI,IAAI;CAIhB;AAQD,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG;IAChD,SAAS,IAAI,SAAS,aAAa,EAAE,CAAA;IACrC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAA;CAC7F,GAAG,SAAS,CAeZ"}

package/lib/agent/model.js

@@ -0,0 +1,92 @@
+import { installModelSelection } from '@deepseek-ai/dsh-agent';
+import { ReasoningEffortId } from '@deepseek-ai/dsh-llm';
+/**
+ * Read a `/model` argument.
+ *
+ * The forms are deliberately unambiguous: a bare argument that names a provider
+ * lists that provider's models, `provider/model` switches, and anything else is
+ * taken as a model id inside the route already in use, because a reader
+ * switching between two models of one provider should not have to repeat it.
+ */
+export function parseModelArgument(argument, providers, current) {
+    const trimmed = argument.trim();
+    if (trimmed === '')
+        return { kind: 'current' };
+    const slash = trimmed.indexOf('/');
+    if (slash > 0 && slash < trimmed.length - 1) {
+        return { kind: 'switch', choice: { provider: trimmed.slice(0, slash), model: trimmed.slice(slash + 1) } };
+    }
+    if (providers.some(provider => provider.id === trimmed))
+        return { kind: 'list-models', provider: trimmed };
+    if (current === undefined) {
+        const names = providers.map(provider => provider.id).join(', ');
+        return {
+            kind: 'invalid',
+            reason: `no route in use; say /model <provider>/${trimmed}${names === '' ? '' : ` — providers: ${names}`}`,
+        };
+    }
+    return { kind: 'switch', choice: { provider: current.provider, model: trimmed } };
+}
+/**
+ * Own the reader's model choice for one session.
+ *
+ * The choice is applied through the agent's own scoped waterfalls, so it takes
+ * effect on the next step rather than splitting an in-flight request, and the
+ * loop logs its own durable notice when the route actually changes.
+ */
+export class ModelSwitch {
+    selection = { current: undefined, assembled: undefined };
+    installed;
+    /** Compose the switch into the agent's scope, where the waterfalls are dispatched. */
+    install(agentCtx) {
+        this.installed?.();
+        this.installed = installModelSelection(agentCtx, this.selection);
+    }
+    choose(choice) {
+        this.selection.current = {
+            provider: choice.provider,
+            model: choice.model,
+            ...choice.reasoningEffort === undefined
+                ? {}
+                : { reasoningEffort: ReasoningEffortId(choice.reasoningEffort) },
+        };
+    }
+    current() {
+        const current = this.selection.current;
+        if (current === undefined)
+            return undefined;
+        return {
+            provider: current.provider,
+            model: current.model,
+            ...current.reasoningEffort === undefined ? {} : { reasoningEffort: String(current.reasoningEffort) },
+        };
+    }
+    /** Forget the choice, so the session returns to the composition default. */
+    reset() {
+        this.selection.current = undefined;
+        this.selection.assembled = undefined;
+    }
+    dispose() {
+        this.installed?.();
+        this.installed = undefined;
+    }
+}
+/** Read the advisory catalog of routes this composition can reach. */
+export function createModelCatalog(ctx) {
+    const llm = ctx.get('llm');
+    if (typeof llm?.listProviders !== 'function')
+        return undefined;
+    const providers = () => (llm.listProviders?.() ?? []).flatMap(entry => typeof entry.id === 'string' ? [{ id: entry.id, name: typeof entry.name === 'string' ? entry.name : entry.id }] : []);
+    return {
+        providers,
+        models: async (provider) => {
+            if (typeof llm.listModels !== 'function')
+                return [];
+            const models = await llm.listModels(provider);
+            return models.flatMap(entry => typeof entry.id === 'string'
+                ? [{ id: entry.id, name: typeof entry.name === 'string' ? entry.name : entry.id }]
+                : []);
+        },
+    };
+}
+//# sourceMappingURL=model.js.map

package/lib/agent/model.js.map

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

package/lib/agent/present.d.ts

@@ -0,0 +1,12 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type ToolPresenter } from '../cards.ts';
+/**
+ * Present tool calls and results through each tool's own render intent.
+ *
+ * The surface must not know tool names: a tool package declares how its call
+ * and result read. An unknown tool, a missing presenter, or a throwing one
+ * degrades to the generic card instead of breaking the transcript, because a
+ * broken card is recoverable and a broken transcript is not.
+ */
+export declare function createToolPresenter(ctx: Context): ToolPresenter;
+//# sourceMappingURL=present.d.ts.map

package/lib/agent/present.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"present.d.ts","sourceRoot":"","sources":["../../src/agent/present.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,aAAa,CAAA;AAUpB;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAiC/D"}

package/lib/agent/present.js

@@ -0,0 +1,52 @@
+import { cardOfCall, cardOfResult, contentLines, } from "../cards.js";
+function parseArguments(argumentsJson) {
+    try {
+        return JSON.parse(argumentsJson);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Present tool calls and results through each tool's own render intent.
+ *
+ * The surface must not know tool names: a tool package declares how its call
+ * and result read. An unknown tool, a missing presenter, or a throwing one
+ * degrades to the generic card instead of breaking the transcript, because a
+ * broken card is recoverable and a broken transcript is not.
+ */
+export function createToolPresenter(ctx) {
+    const definition = (name) => {
+        try {
+            return ctx.tools.get(name);
+        }
+        catch {
+            return undefined;
+        }
+    };
+    return {
+        call(name, argumentsJson) {
+            try {
+                const view = definition(name)?.presentCall?.(parseArguments(argumentsJson));
+                return cardOfCall(view, name);
+            }
+            catch {
+                return undefined;
+            }
+        },
+        result(name, input) {
+            try {
+                const view = definition(name)?.presentResult?.(parseArguments(input.argumentsJson), { content: input.content, isError: input.isError, meta: input.meta });
+                return cardOfResult(view, {
+                    fallbackTitle: name,
+                    failed: input.isError,
+                    contentLines: contentLines(input.content),
+                });
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+//# sourceMappingURL=present.js.map

package/lib/agent/present.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"present.js","sourceRoot":"","sources":["../../src/agent/present.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,GAGb,MAAM,aAAa,CAAA;AAEpB,SAAS,cAAc,CAAC,aAAqB;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAY,CAAA;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC,CAAA;IACD,OAAO;QACL,IAAI,CAAC,IAAI,EAAE,aAAa;YACtB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,cAAc,CAAC,aAAa,CAAU,CAAC,CAAA;gBACpF,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,KAAsB;YACjC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,CAC5C,cAAc,CAAC,KAAK,CAAC,aAAa,CAAU,EAC5C,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAW,CAC9E,CAAA;gBACD,OAAO,YAAY,CAAC,IAAI,EAAE;oBACxB,aAAa,EAAE,IAAI;oBACnB,MAAM,EAAE,KAAK,CAAC,OAAO;oBACrB,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;iBAC1C,CAAC,CAAA;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/lib/agent/presets.d.ts

@@ -0,0 +1,75 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { PickerRow } from '../ui/picker.ts';
+/**
+ * The roster of agent compositions, and the mode one session runs.
+ *
+ * A preset is the plugin composition an agent's own scope joins: its tools,
+ * prompt sections, skills, and planning rows. The session header records the
+ * one it started with, a switch while the session is still blank is recorded as
+ * a `agent-preset/selected` event, and the `agentPreset` projection is the
+ * answer every reader resolves — the header alone is not.
+ */
+/** One preset as the roster publishes it. */
+export interface PresetSummary {
+    readonly id: string;
+    readonly trust: 'system' | 'user';
+    /** Display text the preset itself published, when it published any. */
+    readonly name: string | undefined;
+    readonly description: string | undefined;
+    /** Why this preset cannot compose a session, absent when it can. */
+    readonly broken: string | undefined;
+}
+/** What a `/preset` argument asks the surface to do. */
+export type PresetCommand = {
+    readonly kind: 'pick';
+} | {
+    readonly kind: 'switch';
+    readonly id: string;
+};
+/**
+ * Read a `/preset` argument.
+ *
+ * A bare command opens the picker because choosing by eye is the point of a
+ * selector; anything else is an id, which is the token the session log records.
+ */
+export declare function parsePresetArgument(argument: string): PresetCommand;
+/** How one preset appears in the picker. */
+export declare function describePreset(preset: PresetSummary, currentId: string | undefined): PickerRow;
+/** The roster this surface reads, described structurally. */
+export interface PresetRoster {
+    /** The preset a session starts on when nobody names one. */
+    readonly defaultId: string;
+    list(): Promise<readonly PresetSummary[]>;
+    resolve(id: string | undefined): Promise<PresetSummary>;
+    /**
+     * Join one unpublished agent scope to its preset.
+     *
+     * A rejection here rolls the whole agent creation back, so a preset that
+     * cannot compose never yields a half-configured session.
+     */
+    mount(agentCtx: Context, id: string): Promise<void>;
+    /** Compose a blank session's agent from another preset and record it. */
+    select(agent: unknown, id: string): Promise<string>;
+    /** The preset one live session runs, from its own projection. */
+    current(session: unknown): string | undefined;
+    /**
+     * Whether a session has produced a turn, which is what fixes its preset.
+     *
+     * Read as the harness reads it, and only to keep the picker from offering a
+     * choice that would be refused: {@link PresetRoster.select} remains the
+     * authority, because a session can start between this read and the switch.
+     */
+    started(session: unknown): boolean;
+}
+/** The projection key the roster advances and this surface reads. */
+export declare const AGENT_PRESET_KEY = "agentPreset";
+/**
+ * Wrap the roster in the little of it a terminal needs.
+ *
+ * The seam is optional here: a composition that dropped the row still runs the
+ * surface, it just has no mode to choose. Every call is guarded because the
+ * service arrives from another package and its shape is this surface's
+ * assumption, not its contract.
+ */
+export declare function createPresetRoster(ctx: Context): PresetRoster | undefined;
+//# sourceMappingURL=presets.d.ts.map

package/lib/agent/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/agent/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD;;;;;;;;GAQG;AAEH,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAA;IACjC,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED,wDAAwD;AACxD,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAGnE;AAgBD,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAa9F;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,IAAI,IAAI,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAA;IACzC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IACvD;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,yEAAyE;IACzE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACnD,iEAAiE;IACjE,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;IAC7C;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAA;CACnC;AAED,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,gBAAgB,CAAA;AAwC7C;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAoCzE"}