@bbclaw/cli 0.1.0

package/dist/repl/sessionStore.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Session persistence: read/write chat sessions to ~/.bbclaw/sessions/<id>.json.
+ *
+ * One file per session, JSON-serializable. The session ID is a sortable
+ * timestamp + nonce, so file listings are naturally chronological.
+ */
+import type { LogEntry } from './slashCommands.js';
+export interface SessionData {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    providerId: string;
+    model: string | undefined;
+    log: LogEntry[];
+    history: string[];
+}
+export interface SessionMeta {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    providerId: string;
+    model: string | undefined;
+    summary: string;
+    turns: number;
+}
+export declare function newSessionId(): string;
+export declare function saveSession(data: SessionData): Promise<void>;
+export declare function loadSession(id: string): Promise<SessionData | null>;
+export declare function listSessions(): Promise<SessionMeta[]>;
+export declare function latestSession(): Promise<SessionData | null>;
+//# sourceMappingURL=sessionStore.d.ts.map

package/dist/repl/sessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../src/repl/sessionStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAKlD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,GAAG,EAAE,QAAQ,EAAE,CAAA;IACf,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,YAAY,IAAI,MAAM,CAOrC;AAUD,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAUzE;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CA2B3D;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAIjE"}

package/dist/repl/sessionStore.js

@@ -0,0 +1,79 @@
+/**
+ * Session persistence: read/write chat sessions to ~/.bbclaw/sessions/<id>.json.
+ *
+ * One file per session, JSON-serializable. The session ID is a sortable
+ * timestamp + nonce, so file listings are naturally chronological.
+ */
+import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const ROOT = process.env.BBCLAW_DIR ?? join(homedir(), '.bbclaw');
+const DIR = join(ROOT, 'sessions');
+export function newSessionId() {
+    const t = new Date();
+    const iso = t.toISOString();
+    const date = iso.slice(0, 10).replaceAll('-', '');
+    const time = iso.slice(11, 19).replaceAll(':', '');
+    const nonce = Math.floor(Math.random() * 0x10000).toString(16).padStart(4, '0');
+    return `${date}-${time}-${nonce}`;
+}
+async function ensureDir() {
+    await mkdir(DIR, { recursive: true });
+}
+function filePath(id) {
+    return join(DIR, `${id}.json`);
+}
+export async function saveSession(data) {
+    await ensureDir();
+    await writeFile(filePath(data.id), JSON.stringify(data, null, 2), 'utf8');
+}
+export async function loadSession(id) {
+    try {
+        const txt = await readFile(filePath(id), 'utf8');
+        const parsed = JSON.parse(txt);
+        if (typeof parsed.id !== 'string' || !Array.isArray(parsed.log))
+            return null;
+        if (!Array.isArray(parsed.history))
+            parsed.history = [];
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export async function listSessions() {
+    await ensureDir();
+    const files = await readdir(DIR).catch(() => []);
+    const out = [];
+    for (const f of files) {
+        if (!f.endsWith('.json'))
+            continue;
+        const id = f.slice(0, -5);
+        const data = await loadSession(id);
+        if (!data)
+            continue;
+        const firstUser = data.log.find((e) => e.kind === 'user');
+        const summary = firstUser
+            ? firstUser.text.slice(0, 60).replace(/\s+/g, ' ')
+            : '(empty)';
+        const turns = data.log.filter((e) => e.kind === 'user').length;
+        out.push({
+            id: data.id,
+            createdAt: data.createdAt,
+            updatedAt: data.updatedAt,
+            providerId: data.providerId,
+            model: data.model,
+            summary,
+            turns,
+        });
+    }
+    // Newest first.
+    out.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    return out;
+}
+export async function latestSession() {
+    const list = await listSessions();
+    const top = list[0];
+    return top ? await loadSession(top.id) : null;
+}
+//# sourceMappingURL=sessionStore.js.map

package/dist/repl/sessionStore.js.map

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

package/dist/repl/slashCommands.d.ts

@@ -0,0 +1,61 @@
+import { type ProviderRegistry } from '@bbclaw/core';
+import { type SessionData } from './sessionStore.js';
+/** UI-only log entry. Notes/errors are rendered but never sent to the provider. */
+export type LogEntry = {
+    kind: 'user';
+    text: string;
+} | {
+    kind: 'assistant';
+    text: string;
+} | {
+    kind: 'tool-use';
+    id: string;
+    name: string;
+    input: unknown;
+} | {
+    kind: 'tool-result';
+    toolUseId: string;
+    toolName: string;
+    output: string;
+    isError: boolean;
+} | {
+    kind: 'note';
+    text: string;
+} | {
+    kind: 'error';
+    text: string;
+};
+export interface SlashCommandContext {
+    registry: ProviderRegistry;
+    currentProviderId: string;
+    currentModel: string | undefined;
+    setProvider: (id: string) => void;
+    setModel: (model: string | undefined) => void;
+    clearLog: () => void;
+    addNote: (text: string) => void;
+    /** Resend the last user message in the log. No-op if there is none. */
+    retryLast: () => Promise<void>;
+    /** Replace all state from a SessionData (used by /resume). */
+    loadState: (data: SessionData) => void;
+    /** Snapshot of the current state, used by /save to write the file. */
+    snapshot: () => SessionData;
+    /** Names of tools currently approved without prompting this session. */
+    alwaysAllowed: () => string[];
+    /** Loop scheduling. */
+    startLoop: (prompt: string, intervalMs: number) => void;
+    stopLoop: () => void;
+    isLooping: () => boolean;
+    exit: () => void;
+}
+export interface SlashCommand {
+    name: string;
+    description: string;
+    run(ctx: SlashCommandContext, args: string[]): Promise<void> | void;
+}
+export declare const SLASH_COMMANDS: Record<string, SlashCommand>;
+export declare function parseSlash(input: string): {
+    name: string;
+    args: string[];
+} | null;
+export declare function dispatchSlash(input: string, ctx: SlashCommandContext): Promise<boolean>;
+//# sourceMappingURL=slashCommands.d.ts.map

package/dist/repl/slashCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slashCommands.d.ts","sourceRoot":"","sources":["../../src/repl/slashCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGvE,OAAO,EAA0C,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE5F,mFAAmF;AACnF,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC9F;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;IAC7C,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,uEAAuE;IACvE,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B,8DAA8D;IAC9D,SAAS,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;IACtC,sEAAsE;IACtE,QAAQ,EAAE,MAAM,WAAW,CAAA;IAC3B,wEAAwE;IACxE,aAAa,EAAE,MAAM,MAAM,EAAE,CAAA;IAC7B,uBAAuB;IACvB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IACvD,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,OAAO,CAAA;IACxB,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,GAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACpE;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAmTvD,CAAA;AA2BD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAMjF;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/repl/slashCommands.js

@@ -0,0 +1,328 @@
+import { WebBridgeProvider } from '@bbclaw/core';
+import { isAuthValid, loadAuth } from '../auth/authStore.js';
+import { BUILTIN_TOOLS } from '../tools/index.js';
+import { listSessions, loadSession, saveSession } from './sessionStore.js';
+export const SLASH_COMMANDS = {
+    help: {
+        name: 'help',
+        description: 'Show available slash commands.',
+        run(ctx) {
+            const lines = Object.values(SLASH_COMMANDS)
+                .map((c) => `  /${c.name.padEnd(10)} ${c.description}`)
+                .join('\n');
+            ctx.addNote(`Slash commands:\n${lines}`);
+        },
+    },
+    clear: {
+        name: 'clear',
+        description: 'Clear the conversation log.',
+        run(ctx) {
+            ctx.clearLog();
+        },
+    },
+    quit: {
+        name: 'quit',
+        description: 'Exit the REPL.',
+        run(ctx) {
+            ctx.exit();
+        },
+    },
+    exit: {
+        name: 'exit',
+        description: 'Exit the REPL (alias of /quit).',
+        run(ctx) {
+            ctx.exit();
+        },
+    },
+    providers: {
+        name: 'providers',
+        description: 'List configured providers.',
+        run(ctx) {
+            const list = ctx.registry.list();
+            if (list.length === 0) {
+                ctx.addNote('(no providers configured)');
+                return;
+            }
+            const lines = list
+                .map((p) => `  ${p.id === ctx.currentProviderId ? '*' : ' '} ${p.id.padEnd(16)} [${p.kind}] ${p.displayName}`)
+                .join('\n');
+            ctx.addNote(`Providers:\n${lines}`);
+        },
+    },
+    provider: {
+        name: 'provider',
+        description: 'Switch active provider: /provider <id>',
+        run(ctx, args) {
+            const id = args[0];
+            if (!id) {
+                ctx.addNote(`Current provider: ${ctx.currentProviderId}. Usage: /provider <id>`);
+                return;
+            }
+            if (!ctx.registry.has(id)) {
+                ctx.addNote(`Unknown provider "${id}". Try /providers.`);
+                return;
+            }
+            ctx.setProvider(id);
+            ctx.setModel(undefined);
+            ctx.addNote(`Switched provider → ${id}`);
+        },
+    },
+    model: {
+        name: 'model',
+        description: 'Set model for the active provider: /model <name>',
+        run(ctx, args) {
+            const m = args[0];
+            if (!m) {
+                ctx.addNote(`Current model: ${ctx.currentModel ?? '(provider default)'}. Usage: /model <name>`);
+                return;
+            }
+            ctx.setModel(m);
+            ctx.addNote(`Switched model → ${m}`);
+        },
+    },
+    health: {
+        name: 'health',
+        description: 'Probe all configured providers.',
+        async run(ctx) {
+            ctx.addNote('Probing providers...');
+            const results = await ctx.registry.healthCheckAll();
+            const lines = results
+                .map((r) => {
+                const status = r.ok ? 'ok' : 'failed';
+                const latency = r.latencyMs !== undefined ? ` ${r.latencyMs}ms` : '';
+                const reason = r.reason ? `  (${r.reason})` : '';
+                return `  ${r.id.padEnd(16)} ${status}${latency}${reason}`;
+            })
+                .join('\n');
+            ctx.addNote(`Health:\n${lines}`);
+        },
+    },
+    retry: {
+        name: 'retry',
+        description: 'Re-send the most recent user message.',
+        async run(ctx) {
+            await ctx.retryLast();
+        },
+    },
+    login: {
+        name: 'login',
+        description: 'Open a browser to sign in to the current web-bridge provider.',
+        async run(ctx) {
+            const provider = ctx.registry.get(ctx.currentProviderId);
+            if (!provider) {
+                ctx.addNote(`No provider "${ctx.currentProviderId}" registered.`);
+                return;
+            }
+            if (provider.kind !== 'web-bridge') {
+                ctx.addNote(`/login only applies to web-bridge providers. "${provider.id}" is kind=${provider.kind}.`);
+                return;
+            }
+            const wbp = provider;
+            ctx.addNote(`Opening browser for ${provider.displayName}…`);
+            try {
+                await wbp.showForLogin();
+            }
+            catch (e) {
+                ctx.addNote(`Failed to open browser: ${e instanceof Error ? e.message : String(e)}`);
+                return;
+            }
+            ctx.addNote('Sign in inside the browser window. I will poll for up to 90s and confirm automatically.');
+            // Fire-and-forget polling. Avoids blocking the REPL during login.
+            void (async () => {
+                const deadline = Date.now() + 90_000;
+                while (Date.now() < deadline) {
+                    await new Promise((r) => setTimeout(r, 2_000));
+                    const ok = await wbp.confirmLogin().catch(() => false);
+                    if (ok) {
+                        ctx.addNote(`✓ Login confirmed for ${provider.id}. Browser switched to headless.`);
+                        return;
+                    }
+                }
+                ctx.addNote(`⚠ Login still not detected after 90s. If you signed in, try sending a message — the SPA may just be slow.`);
+            })();
+        },
+    },
+    sessions: {
+        name: 'sessions',
+        description: 'List saved sessions.',
+        async run(ctx) {
+            const list = await listSessions();
+            if (list.length === 0) {
+                ctx.addNote('(no saved sessions)');
+                return;
+            }
+            const lines = list
+                .slice(0, 20)
+                .map((s) => `  ${s.id}  turns=${String(s.turns).padStart(3)}  ${s.providerId.padEnd(14)}  ${s.summary}`)
+                .join('\n');
+            ctx.addNote(`Sessions (newest first):\n${lines}\n\nUse /resume <id> to load.`);
+        },
+    },
+    save: {
+        name: 'save',
+        description: 'Force-save the current session.',
+        async run(ctx) {
+            const data = ctx.snapshot();
+            try {
+                await saveSession(data);
+                ctx.addNote(`✓ Saved as ${data.id}`);
+            }
+            catch (e) {
+                ctx.addNote(`Save failed: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        },
+    },
+    resume: {
+        name: 'resume',
+        description: 'Load a saved session by id: /resume <id>',
+        async run(ctx, args) {
+            const id = args[0];
+            if (!id) {
+                ctx.addNote('Usage: /resume <id>. Try /sessions to list available ids.');
+                return;
+            }
+            const data = await loadSession(id);
+            if (!data) {
+                ctx.addNote(`No session found with id "${id}".`);
+                return;
+            }
+            if (!ctx.registry.has(data.providerId)) {
+                ctx.addNote(`Session was for provider "${data.providerId}" which is not currently registered. Loading anyway; messages may fail until provider is available.`);
+            }
+            ctx.loadState(data);
+            ctx.addNote(`✓ Resumed session ${data.id} (${data.log.length} entries).`);
+        },
+    },
+    tools: {
+        name: 'tools',
+        description: 'List built-in tools available to the assistant.',
+        run(ctx) {
+            const lines = BUILTIN_TOOLS.map((t) => {
+                const firstSentence = (t.def.description ?? '').split(/[.。]/)[0] ?? '';
+                return `  ${t.def.name.padEnd(8)}  ${firstSentence.trim()}`;
+            }).join('\n');
+            ctx.addNote(`Built-in tools:\n${lines}`);
+        },
+    },
+    allowed: {
+        name: 'allowed',
+        description: 'Show tools approved without prompting this session.',
+        run(ctx) {
+            const list = ctx.alwaysAllowed();
+            if (list.length === 0) {
+                ctx.addNote('No tools are auto-approved. Press "a" at an approval prompt to add one.');
+                return;
+            }
+            ctx.addNote(`Auto-approved this session: ${list.join(', ')}`);
+        },
+    },
+    loop: {
+        name: 'loop',
+        description: 'Re-fire a prompt on an interval. Usage: /loop <30s|5m|1h> <prompt>',
+        run(ctx, args) {
+            if (args.length < 2) {
+                ctx.addNote('Usage: /loop <interval> <prompt>\n  intervals: 45s, 5m, 1h, or a bare number (seconds)\n  example: /loop 5m check the deploy status');
+                return;
+            }
+            const intervalArg = args[0];
+            if (!intervalArg) {
+                ctx.addNote('Interval is required. See /help loop.');
+                return;
+            }
+            const intervalMs = parseInterval(intervalArg);
+            if (intervalMs == null) {
+                ctx.addNote(`Could not parse interval "${intervalArg}". Use formats like 45s, 5m, 1h, or a bare number.`);
+                return;
+            }
+            if (intervalMs < 5_000) {
+                ctx.addNote('Minimum loop interval is 5s — pick something larger to keep the REPL usable.');
+                return;
+            }
+            const prompt = args.slice(1).join(' ').trim();
+            if (!prompt) {
+                ctx.addNote('Prompt is required after the interval.');
+                return;
+            }
+            ctx.startLoop(prompt, intervalMs);
+            ctx.addNote(`🔁 Loop started — every ${formatMs(intervalMs)}: "${prompt.slice(0, 80)}${prompt.length > 80 ? '…' : ''}"`);
+        },
+    },
+    unloop: {
+        name: 'unloop',
+        description: 'Stop the current loop.',
+        run(ctx) {
+            if (!ctx.isLooping()) {
+                ctx.addNote('No loop is currently running.');
+                return;
+            }
+            ctx.stopLoop();
+            ctx.addNote('🔁 Loop stopped.');
+        },
+    },
+    whoami: {
+        name: 'whoami',
+        description: 'Show the local BBClaw license status.',
+        async run(ctx) {
+            const auth = await loadAuth();
+            if (!auth) {
+                ctx.addNote('Not authenticated. Run: bbclaw auth login --code <code>');
+                return;
+            }
+            const expiry = new Date(auth.expiresAt).toLocaleString();
+            if (!isAuthValid(auth)) {
+                ctx.addNote(`✗ License expired on ${expiry}. Get a new code, then run bbclaw auth login.`);
+                return;
+            }
+            ctx.addNote(`✓ ${auth.code}\n  expires: ${expiry}\n  server:  ${auth.server}`);
+        },
+    },
+};
+function parseInterval(s) {
+    const m = s.trim().match(/^(\d+(?:\.\d+)?)([smh]?)$/);
+    if (!m)
+        return null;
+    const num = Number(m[1]);
+    if (!Number.isFinite(num) || num <= 0)
+        return null;
+    const unit = m[2] ?? '';
+    switch (unit) {
+        case 'h':
+            return num * 3_600_000;
+        case 'm':
+            return num * 60_000;
+        case 's':
+        case '':
+            return num * 1_000;
+        default:
+            return null;
+    }
+}
+function formatMs(ms) {
+    if (ms >= 3_600_000)
+        return `${(ms / 3_600_000).toFixed(ms % 3_600_000 ? 1 : 0)}h`;
+    if (ms >= 60_000)
+        return `${(ms / 60_000).toFixed(ms % 60_000 ? 1 : 0)}m`;
+    return `${(ms / 1_000).toFixed(0)}s`;
+}
+export function parseSlash(input) {
+    if (!input.startsWith('/'))
+        return null;
+    const parts = input.slice(1).trim().split(/\s+/);
+    const [name, ...args] = parts;
+    if (!name)
+        return null;
+    return { name, args };
+}
+export async function dispatchSlash(input, ctx) {
+    const parsed = parseSlash(input);
+    if (!parsed)
+        return false;
+    const cmd = SLASH_COMMANDS[parsed.name];
+    if (!cmd) {
+        ctx.addNote(`Unknown command "/${parsed.name}". Try /help.`);
+        return true;
+    }
+    await cmd.run(ctx, parsed.args);
+    return true;
+}
+//# sourceMappingURL=slashCommands.js.map

package/dist/repl/slashCommands.js.map

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

package/dist/repl/useChat.d.ts

@@ -0,0 +1,65 @@
+import { type Provider, type ProviderRegistry } from '@bbclaw/core';
+import { type BbclawTool } from '../tools/index.js';
+import { type SessionData } from './sessionStore.js';
+import type { LogEntry } from './slashCommands.js';
+export type ChatStatus = 'idle' | 'streaming' | 'awaiting-approval';
+export type ApprovalDecision = 'approve' | 'deny' | 'allow-all';
+export interface PendingTool {
+    id: string;
+    name: string;
+    input: unknown;
+}
+export interface RunningTool {
+    id: string;
+    name: string;
+    startedAt: number;
+}
+export interface LoopState {
+    prompt: string;
+    intervalMs: number;
+    iteration: number;
+    startedAt: number;
+    nextFireAt: number;
+}
+export interface UseChatOptions {
+    registry: ProviderRegistry;
+    maxTokens?: number;
+    initialSession?: SessionData;
+    /** Tools the assistant may call. Defaults to BUILTIN_TOOLS. */
+    tools?: BbclawTool[];
+    /** Hard cap on agent-loop iterations per send() call. */
+    maxIterations?: number;
+}
+export interface UsageStats {
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface UseChat {
+    log: LogEntry[];
+    streamingText: string;
+    status: ChatStatus;
+    providerId: string;
+    model: string | undefined;
+    currentProvider: Provider;
+    history: string[];
+    usage: UsageStats;
+    sessionId: string;
+    pendingTool: PendingTool | null;
+    runningTool: RunningTool | null;
+    loop: LoopState | null;
+    send(text: string): Promise<void>;
+    retryLast(): Promise<void>;
+    cancel(): void;
+    clearLog(): void;
+    addNote(text: string): void;
+    setProvider(id: string): void;
+    setModel(model: string | undefined): void;
+    loadState(data: SessionData): void;
+    snapshot(): SessionData;
+    respondToApproval(decision: ApprovalDecision): void;
+    alwaysAllowed(): string[];
+    startLoop(prompt: string, intervalMs: number): void;
+    stopLoop(): void;
+}
+export declare function useChat({ registry, maxTokens, initialSession, tools, maxIterations, }: UseChatOptions): UseChat;
+//# sourceMappingURL=useChat.d.ts.map

package/dist/repl/useChat.d.ts.map

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