@windowkit/agent-chat 0.0.0-stage → 0.3.0

package/dist/drivers/claude/tools.js

@@ -0,0 +1,119 @@
+// Claude Code's built-in tools: which `coreTools` category each is in, its
+// kind, and the one line its card shows.
+/** The built-ins each category names. A name Claude Code no longer has is
+ *  harmless in `disallowedTools`. */
+export const CATEGORY_TOOLS = {
+    shell: ['Bash', 'BashOutput', 'KillShell'],
+    read: ['Read', 'Glob', 'Grep', 'LS'],
+    edit: ['Edit', 'MultiEdit', 'Write', 'NotebookEdit'],
+    web: ['WebFetch', 'WebSearch'],
+    agents: ['Agent', 'Task'],
+    todos: ['TodoWrite', 'TaskCreate', 'TaskUpdate', 'TaskList', 'TaskGet'],
+};
+/** The prefix in-process tools are named under: `mcp__app__openTicket`. */
+export const APP_SERVER = 'app';
+export const APP_PREFIX = `mcp__${APP_SERVER}__`;
+const KINDS = {
+    Bash: 'execute',
+    BashOutput: 'execute',
+    KillShell: 'execute',
+    Read: 'read',
+    LS: 'read',
+    NotebookRead: 'read',
+    Glob: 'search',
+    Grep: 'search',
+    Edit: 'edit',
+    MultiEdit: 'edit',
+    Write: 'edit',
+    NotebookEdit: 'edit',
+    WebFetch: 'fetch',
+    WebSearch: 'fetch',
+    Agent: 'think',
+    Task: 'think',
+    ExitPlanMode: 'think',
+};
+/** The tools this driver draws as something other than a tool card. */
+export const HIDDEN_TOOLS = new Set([
+    'TodoWrite',
+    'AskUserQuestion',
+]);
+export function labelOf(name) {
+    return name.startsWith(APP_PREFIX) ? name.slice(APP_PREFIX.length) : name;
+}
+export function isAppTool(name) {
+    return name.startsWith(APP_PREFIX);
+}
+export function kindOf(name) {
+    return KINDS[name] ?? 'other';
+}
+/** The card's line: `Read src/app.ts`, `make test`, `Fetch https://…`. */
+export function titleOf(name, input) {
+    const label = labelOf(name);
+    const i = (input && typeof input === 'object' ? input : {});
+    const s = (k) => (typeof i[k] === 'string' ? i[k] : '');
+    switch (name) {
+        case 'Bash':
+            return s('description') || firstLine(s('command')) || 'Bash';
+        case 'Read':
+        case 'Edit':
+        case 'MultiEdit':
+        case 'Write':
+            return s('file_path') ? `${name} ${s('file_path')}` : name;
+        case 'NotebookEdit':
+            return s('notebook_path') ? `${name} ${s('notebook_path')}` : name;
+        case 'Glob':
+            return s('pattern') ? `Find ${s('pattern')}` : name;
+        case 'Grep':
+            return s('pattern') ? `Search for ${s('pattern')}` : name;
+        case 'LS':
+            return s('path') ? `List ${s('path')}` : name;
+        case 'WebFetch':
+            return s('url') ? `Fetch ${s('url')}` : name;
+        case 'WebSearch':
+            return s('query') ? `Search the web for ${s('query')}` : name;
+        case 'Agent':
+        case 'Task':
+            return s('description') || 'Agent';
+        case 'ExitPlanMode':
+            return 'Approve the plan';
+        default:
+            return label;
+    }
+}
+/** What a finished built-in call shows, worked out from its input where the
+ *  input says more than the result: an edit is its diff. */
+export function outputOf(name, input, resultText, isError) {
+    const i = (input && typeof input === 'object' ? input : {});
+    if (!isError) {
+        if (name === 'Edit' && typeof i.file_path === 'string') {
+            return [
+                {
+                    type: 'diff',
+                    path: i.file_path,
+                    oldText: String(i.old_string ?? ''),
+                    newText: String(i.new_string ?? ''),
+                },
+            ];
+        }
+        if (name === 'Write' && typeof i.file_path === 'string') {
+            return [
+                {
+                    type: 'diff',
+                    path: i.file_path,
+                    oldText: null,
+                    newText: String(i.content ?? ''),
+                },
+            ];
+        }
+    }
+    if (!resultText)
+        return [];
+    if (kindOf(name) === 'execute')
+        return [{ type: 'terminal', text: resultText }];
+    return [{ type: 'text', text: resultText }];
+}
+function firstLine(text) {
+    const line = text.split('\n')[0] ?? '';
+    return line.length > 120 ? `${line.slice(0, 117)}…` : line;
+}
+//# sourceMappingURL=tools.js.map

package/dist/drivers/claude/tools.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { AgentChat, type AgentChatProps, type AgentChatViewProps, } from './view/AgentChat.js';
+export { useAgent, useSessionSnapshot } from './view/use-agent.js';
+export type { ComposerOptions } from './view/Composer.js';
+export { copyCode, defineTool, type CodeAction, type CodeActionContext, type ComponentEntry, type FenceEntry, type FenceInfo, type ToolRenderer, } from './view/types.js';
+export { splitFences, type Segment } from './view/fences.js';
+export { AgentUnavailableError, categoryOf, createAgentSession, describeRenderers, messageMarkdown, sourceLabel, transcriptMarkdown, type AgentDriver, type AgentOptions, type AgentSession, type AnyToolDef, type CoreToolSetting, type DriverConfig, type DriverEvent, type DriverHost, type DriverSession, type SessionSnapshot, type ToolContext, type ToolDef, type ToolParameters, type ToolRenderInfo, type ToolResult, } from './core/index.js';
+export type * from './core/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EACL,QAAQ,EACR,UAAU,EACV,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAC;AACzB,mBAAmB,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// `@windowkit/agent-chat`: `<AgentChat>` and the hooks around it, with the
+// core's types and helpers re-exported, so an app imports from one place.
+//
+// The drivers are not re-exported: each is its own subpath
+// (`/drivers/claude`), loaded when a session starts, so a bundle carries the
+// one it uses.
+export { AgentChat, } from './view/AgentChat.js';
+export { useAgent, useSessionSnapshot } from './view/use-agent.js';
+export { copyCode, defineTool, } from './view/types.js';
+export { splitFences } from './view/fences.js';
+export { AgentUnavailableError, categoryOf, createAgentSession, describeRenderers, messageMarkdown, sourceLabel, transcriptMarkdown, } from './core/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,0EAA0E;AAC1E,EAAE;AACF,2DAA2D;AAC3D,6EAA6E;AAC7E,eAAe;AAEf,OAAO,EACL,SAAS,GAGV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EACL,QAAQ,EACR,UAAU,GAOX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,kBAAkB,GAgBnB,MAAM,iBAAiB,CAAC"}

package/dist/testing/fake.d.ts

@@ -0,0 +1,63 @@
+import type { AgentDriver, DriverEvent, DriverHost, OutgoingMessage } from '../core/driver.js';
+import { type Capabilities, type MessageSource, type Question, type SessionInfo, type ToolKind, type ToolOutput } from '../core/types.js';
+export type FakeStep = DriverEvent
+/** Pause the script. */
+ | {
+    type: 'wait';
+    ms: number;
+}
+/** Stream text in chunks of `chunk` characters, `delay` ms apart. */
+ | {
+    type: 'say';
+    text: string;
+    chunk?: number;
+    delay?: number;
+    reasoning?: boolean;
+}
+/**
+ * A tool call, through the gate: an app tool (one in `tools`) runs the
+ * app's function; any other ends with `result`.
+ */
+ | {
+    type: 'call';
+    id?: string;
+    name: string;
+    input?: unknown;
+    kind?: ToolKind;
+    title?: string;
+    result?: string | readonly ToolOutput[];
+    error?: string;
+}
+/** A question for the user; the script goes on once it is answered. */
+ | {
+    type: 'ask';
+    id?: string;
+    questions: readonly Question[];
+};
+export type FakeScript = (message: OutgoingMessage, turn: number) => readonly FakeStep[] | Promise<readonly FakeStep[]> | AsyncIterable<FakeStep>;
+export interface FakeDriverOptions {
+    name?: string;
+    capabilities?: Partial<Capabilities>;
+    info?: Partial<SessionInfo>;
+    /** Throw this from `start`, as a harness that cannot run would. */
+    failStart?: Error;
+}
+export interface FakeDriver extends AgentDriver {
+    /** Every message the session sent. */
+    readonly sent: readonly OutgoingMessage[];
+    /** The host, once started. */
+    readonly host: DriverHost | null;
+    /** How many times `interrupt` was called. */
+    readonly interrupts: number;
+    /**
+     * A message from someone other than the user — another session, a
+     * channel — arriving as a harness reports one: the session draws it, and
+     * the script plays a turn for it after any turn under way, handed `from`
+     * where it is a peer.
+     */
+    receive(text: string, from: MessageSource): void;
+}
+export declare function fakeDriver(script: FakeScript, options?: FakeDriverOptions): FakeDriver;
+/** A script that answers turn `n` with `turns[n]`, and the last one after. */
+export declare function scripted(...turns: ReadonlyArray<readonly FakeStep[]>): FakeScript;
+//# sourceMappingURL=fake.d.ts.map

package/dist/testing/fake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake.d.ts","sourceRoot":"","sources":["../../src/testing/fake.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,UAAU,EAEV,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,WAAW,EAEhB,KAAK,QAAQ,EACb,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,QAAQ,GAChB,WAAW;AACb,wBAAwB;GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAC9B,qEAAqE;GACnE;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AACH;;;GAGG;GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACH,uEAAuE;GACrE;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,UAAU,GAAG,CACvB,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,MAAM,KAEZ,SAAS,QAAQ,EAAE,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5B,mEAAmE;IACnE,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CAClD;AAUD,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,iBAAsB,GAC9B,UAAU,CAkHZ;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CACtB,GAAG,KAAK,EAAE,aAAa,CAAC,SAAS,QAAQ,EAAE,CAAC,GAC3C,UAAU,CAEZ"}

package/dist/testing/fake.js

@@ -0,0 +1,270 @@
+// A driver that plays a script: no harness, no key, no network.
+//
+// It goes through the real session — the gate, the policy, the approval
+// row, the app's tools — so a test of the UI tests what an app ships, and the
+// demo example runs on a machine with nothing installed.
+import { NO_CAPABILITIES, } from '../core/types.js';
+const FAKE_CAPABILITIES = Object.freeze({
+    ...NO_CAPABILITIES,
+    tools: 'in-process',
+    systemPrompt: Object.freeze({ replace: true, append: true }),
+    coreTools: 'remove',
+    gate: 'every-call',
+});
+export function fakeDriver(script, options = {}) {
+    const sent = [];
+    let host = null;
+    let interrupts = 0;
+    let take = null;
+    let received = 0;
+    const capabilities = {
+        ...FAKE_CAPABILITIES,
+        ...options.capabilities,
+    };
+    const driver = {
+        name: options.name ?? 'fake',
+        get sent() {
+            return sent;
+        },
+        get host() {
+            return host;
+        },
+        get interrupts() {
+            return interrupts;
+        },
+        receive(text, from) {
+            if (!take) {
+                throw new Error('fakeDriver: receive() before the session started');
+            }
+            take(text, from);
+        },
+        async start(h) {
+            if (options.failStart)
+                throw options.failStart;
+            host = h;
+            h.emit({
+                type: 'info',
+                info: {
+                    agent: driver.name,
+                    model: 'fake',
+                    models: [],
+                    ...options.info,
+                },
+            });
+            let turn = 0;
+            let running = null;
+            let chain = Promise.resolve();
+            /** A turn for `message`, after the one under way. One that arrived
+             *  from elsewhere is reported as its turn begins, as a harness reports
+             *  a message when it takes it. */
+            const playTurn = (message, arrived) => {
+                const n = turn++;
+                chain = chain.then(async () => {
+                    if (arrived) {
+                        h.emit({
+                            type: 'message',
+                            id: message.id,
+                            text: message.text,
+                            from: arrived,
+                        });
+                    }
+                    const abort = new AbortController();
+                    running = abort;
+                    try {
+                        await play(h, script(message, n), n, abort.signal);
+                        if (!abort.signal.aborted)
+                            h.emit({ type: 'turn-end', reason: 'done' });
+                    }
+                    catch (err) {
+                        if (!abort.signal.aborted) {
+                            h.emit({
+                                type: 'turn-end',
+                                reason: 'error',
+                                error: err instanceof Error ? err.message : String(err),
+                            });
+                        }
+                    }
+                    finally {
+                        if (running === abort)
+                            running = null;
+                    }
+                });
+            };
+            take = (text, from) => playTurn({
+                id: `r${++received}`,
+                text,
+                attachments: [],
+                steer: false,
+                ...(from.kind === 'peer' ? { from } : {}),
+            }, from);
+            const session = {
+                capabilities,
+                send(message) {
+                    sent.push(message);
+                    if (message.steer)
+                        return;
+                    playTurn(message);
+                },
+                async interrupt() {
+                    interrupts++;
+                    running?.abort();
+                },
+                async setModel(id) {
+                    h.emit({ type: 'info', info: { model: id } });
+                },
+                async setMode(id) {
+                    h.emit({ type: 'info', info: { mode: id } });
+                },
+                async close() {
+                    running?.abort();
+                },
+            };
+            return session;
+        },
+    };
+    return driver;
+}
+/** A script that answers turn `n` with `turns[n]`, and the last one after. */
+export function scripted(...turns) {
+    return (_message, n) => turns[Math.min(n, turns.length - 1)] ?? [];
+}
+async function play(host, steps, turn, signal) {
+    const resolved = await steps;
+    let i = 0;
+    const iterable = Symbol.asyncIterator in resolved
+        ? resolved
+        : resolved;
+    for await (const step of iterable) {
+        if (signal.aborted)
+            return;
+        await run(host, step, `f${turn}:${i++}`, signal);
+    }
+}
+async function run(host, step, key, signal) {
+    switch (step.type) {
+        case 'wait':
+            await sleep(step.ms, signal);
+            return;
+        case 'say': {
+            const size = Math.max(1, step.chunk ?? step.text.length);
+            for (let at = 0; at < step.text.length; at += size) {
+                if (signal.aborted)
+                    return;
+                host.emit({
+                    type: 'text',
+                    id: key,
+                    delta: step.text.slice(at, at + size),
+                    ...(step.reasoning ? { reasoning: true } : {}),
+                });
+                await sleep(step.delay ?? 0, signal);
+            }
+            host.emit({
+                type: 'text',
+                id: key,
+                text: step.text,
+                done: true,
+                ...(step.reasoning ? { reasoning: true } : {}),
+            });
+            return;
+        }
+        case 'call':
+            await call(host, step, step.id ?? key, signal);
+            return;
+        case 'ask': {
+            await host.ask(step.id ?? key, step.questions, signal);
+            return;
+        }
+        default:
+            host.emit(step);
+    }
+}
+async function call(host, step, id, signal) {
+    const app = host.config.tools.has(step.name);
+    const def = app ? host.config.tools.get(step.name) : undefined;
+    const kind = step.kind ?? def?.kind ?? 'other';
+    const title = step.title ??
+        (def?.title && step.input !== undefined
+            ? def.title(step.input)
+            : step.name);
+    host.emit({
+        type: 'tool-start',
+        id,
+        name: step.name,
+        label: step.name,
+        kind,
+        title,
+        input: step.input ?? {},
+        app,
+    });
+    const toolCall = {
+        id,
+        name: step.name,
+        label: step.name,
+        kind,
+        title,
+        input: step.input ?? {},
+        app,
+    };
+    const gate = await host.gate(toolCall);
+    let input = step.input ?? {};
+    if (gate.behavior === 'deny') {
+        host.emit({ type: 'tool-end', id, state: 'denied', error: gate.message });
+        return;
+    }
+    if (gate.behavior === 'allow' && gate.input !== undefined)
+        input = gate.input;
+    if (gate.behavior === 'ask') {
+        const approval = await host.approve(toolCall, signal);
+        if (approval.behavior === 'deny') {
+            if (!signal.aborted) {
+                host.emit({
+                    type: 'tool-end',
+                    id,
+                    state: 'denied',
+                    error: approval.message,
+                });
+            }
+            return;
+        }
+        if (approval.input !== undefined)
+            input = approval.input;
+    }
+    if (signal.aborted)
+        return;
+    host.emit({ type: 'tool-update', id, state: 'running' });
+    if (app) {
+        const result = await host.runTool(step.name, input, { callId: id, signal });
+        if (signal.aborted)
+            return;
+        const text = result.content
+            .map((c) => (c.type === 'text' ? c.text : ''))
+            .join('\n');
+        host.emit({
+            type: 'tool-end',
+            id,
+            state: result.isError ? 'error' : 'done',
+            ...(result.isError ? { error: text } : {}),
+        });
+        return;
+    }
+    if (step.error !== undefined) {
+        host.emit({ type: 'tool-end', id, state: 'error', error: step.error });
+        return;
+    }
+    const output = typeof step.result === 'string'
+        ? [{ type: 'text', text: step.result }]
+        : (step.result ?? []);
+    host.emit({ type: 'tool-end', id, state: 'done', output });
+}
+function sleep(ms, signal) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        const timer = setTimeout(resolve, ms);
+        signal.addEventListener('abort', () => {
+            clearTimeout(timer);
+            resolve();
+        }, { once: true });
+    });
+}
+//# sourceMappingURL=fake.js.map

package/dist/testing/fake.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,2 @@
+export { fakeDriver, scripted, type FakeDriver, type FakeDriverOptions, type FakeScript, type FakeStep, } from './fake.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,UAAU,EACV,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,WAAW,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,4 @@
+// `@windowkit/agent-chat/testing`: a driver that plays a script, for tests
+// and for demos with no harness installed.
+export { fakeDriver, scripted, } from './fake.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,2CAA2C;AAE3C,OAAO,EACL,UAAU,EACV,QAAQ,GAKT,MAAM,WAAW,CAAC"}

package/dist/view/AgentChat.d.ts

@@ -0,0 +1,53 @@
+import { type ReactElement, type ReactNode } from 'react';
+import type { StyleProp } from 'react-x11';
+import { type AgentOptions, type AgentSession, type SessionSnapshot } from '../core/session.js';
+import { type ComposerOptions } from './Composer.js';
+import { type CodeAction, type ComponentEntry, type FenceEntry, type ToolRenderer } from './types.js';
+/** What the view takes, whoever owns the session. */
+export interface AgentChatViewProps {
+    /** Fenced blocks drawn by the app, by language. An entry with `describe`
+     *  also tells the agent the format exists. */
+    fences?: Readonly<Record<string, FenceEntry>>;
+    /** Components a reply may name as a tag on its own line. */
+    components?: Readonly<Record<string, ComponentEntry>>;
+    /** Tool calls drawn by the app, by the tool's label; `'*'` for the rest.
+     *  A tool's own `render` comes first. */
+    renderTool?: Readonly<Record<string, ToolRenderer>>;
+    /** Buttons on every fenced code block. Default `[copyCode]`. Nothing runs
+     *  a block unless an action here does. */
+    codeActions?: readonly CodeAction[];
+    /** A link in a reply was pressed. Nothing navigates by itself. */
+    onLink?: (href: string) => void;
+    placeholder?: string;
+    /** How the message box behaves: what it draws as markdown while typing,
+     *  the `@` file list, the `/` command list, pastes as attachments. */
+    composer?: ComposerOptions;
+    /** `true` for the session's line (agent, model, mode, cost, Copy), or a
+     *  function of the session for the app's own. Default `true`. */
+    header?: boolean | ((session: AgentSession) => ReactNode);
+    /** Shown while the transcript is empty. */
+    empty?: ReactNode;
+    /** Shown instead of the chat when the harness cannot run here. Default: a
+     *  line saying why. */
+    fallback?: ReactNode | ((snapshot: SessionSnapshot) => ReactNode);
+    /** Base text size. Default: the theme's. */
+    fontSize?: number;
+    autoFocus?: boolean;
+    style?: StyleProp;
+}
+type NoOptions = {
+    readonly [K in keyof AgentOptions]?: never;
+};
+/**
+ * Either the session's options — the chat owns its session — or a
+ * `session` from `useAgent`, and none of the options: they are the
+ * session's, and a chat handed one does not change it.
+ */
+export type AgentChatProps = AgentChatViewProps & ((AgentOptions & {
+    session?: undefined;
+}) | (NoOptions & {
+    session: AgentSession;
+}));
+export declare function AgentChat(props: AgentChatProps): ReactElement;
+export {};
+//# sourceMappingURL=AgentChat.d.ts.map

package/dist/view/AgentChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentChat.d.ts","sourceRoot":"","sources":["../../src/view/AgentChat.tsx"],"names":[],"mappings":"AASA,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAU/D,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAGpB,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC;kDAC8C;IAC9C,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9C,4DAA4D;IAC5D,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IACtD;6CACyC;IACzC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACpD;8CAC0C;IAC1C,WAAW,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACpC,kEAAkE;IAClE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;0EACsE;IACtE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;qEACiE;IACjE,MAAM,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,SAAS,CAAC,CAAC;IAC1D,2CAA2C;IAC3C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;2BACuB;IACvB,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,QAAQ,EAAE,eAAe,KAAK,SAAS,CAAC,CAAC;IAClE,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,KAAK,SAAS,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,EAAE,KAAK;CAAE,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAC7C,CACI,CAAC,YAAY,GAAG;IAAE,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,GACxC,CAAC,SAAS,GAAG;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAC1C,CAAC;AAEJ,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAM7D"}