ptbk 0.119.0-17 → 0.119.0-21

package/dist/chats/conversation.js

@@ -0,0 +1,188 @@
+import { rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { PtbkError, errorMessage } from '../common/errors.js';
+import { ensureDirectory, readTextIfExists } from '../common/fs.js';
+import { shortId } from '../common/ids.js';
+import { formatAgentReference, parseReferenceValue } from '../book/references.js';
+import { resolveEffectiveAgent } from '../project/agents.js';
+import { setting } from '../project/config.js';
+import { EXPERT_DOCUMENTATION_DIRECTORY } from '../project/expert.js';
+import { runHarness } from '../harness/run.js';
+import { ToolBridge } from '../engine/bridge.js';
+import { renderAgentInstructions } from '../engine/prompt.js';
+import { teamTools } from '../engine/team.js';
+import { chatAgent, isHumanFacing } from './chat-book.js';
+import { conversationChats } from './task-chats.js';
+/**
+ * Time limit of one chat reply.
+ */
+const REPLY_TIMEOUT_MS = 10 * 60_000;
+/**
+ * Most transcript characters given to the agent (older messages are summarized by omission, visibly).
+ */
+const MAX_TRANSCRIPT_CHARACTERS = 60_000;
+/**
+ * Marker of a learning note at the end of an agent's chat reply.
+ */
+const LEARN_MARKER = /^PTBK_LEARN\s+(.+)$/m;
+/**
+ * Lets the chat's agent answer the user's latest message (read-only; tasks only through `create_task`).
+ *
+ * Opening or reading a chat never runs this; only a new user message in a human-led chat does.
+ *
+ * @private chats
+ */
+export async function replyInChat(context, chatName) {
+    const stored = await context.chats.find(chatName);
+    if (!stored)
+        throw new PtbkError(`No chat named "${chatName}".`, { kind: 'not-found' });
+    const { chat } = stored;
+    if (!isHumanFacing(chat))
+        throw new PtbkError('Agent↔agent consultation chats are task records, not conversations with the user.', { kind: 'usage' });
+    const agentReference = chatAgent(chat);
+    if (!agentReference)
+        throw new PtbkError(`The chat "${chat.name}" has no single agent participant.`, { kind: 'configuration' });
+    const last = chat.messages[chat.messages.length - 1];
+    if (!last || last.senderKey !== 'user')
+        return { createdTasks: [] };
+    const agent = await resolveEffectiveAgent(context.catalog, agentReference);
+    const errors = agent.diagnostics.filter((diagnostic) => diagnostic.severity === 'error');
+    if (errors.length)
+        return { createdTasks: [], error: `${agentReference} cannot reply: ${errors.map((diagnostic) => diagnostic.message).join(' ')}` };
+    const preferred = setting(context.settings, 'routing.harness');
+    const harnessId = [preferred, ...context.pool.usable()].find((id) => Boolean(id) && Boolean(context.pool.plugin(id)?.capabilities.readOnly) && Boolean(context.pool.inspection(id)?.usable));
+    if (!harnessId)
+        return { createdTasks: [], error: 'No usable harness supports read-only chat replies.' };
+    const plugin = context.pool.plugin(harnessId);
+    const inspection = context.pool.inspection(harnessId);
+    const contextFile = setting(context.settings, 'paths.context');
+    const projectInstructions = contextFile ? await readTextIfExists(join(context.project.root, contextFile)) : undefined;
+    let transcript = chat.messages.map((message) => `**${message.sender}** (${message.at}):\n${message.text}${message.choices?.length ? `\n(offered choices: ${message.choices.join(' | ')})` : ''}`).join('\n\n');
+    if (transcript.length > MAX_TRANSCRIPT_CHARACTERS)
+        transcript = `[… earlier messages omitted; read ${stored.relativePath} for the full chat]\n\n${transcript.slice(-MAX_TRANSCRIPT_CHARACTERS)}`;
+    const created = [];
+    const tools = plugin.capabilities.mcp
+        ? [
+            {
+                name: 'create_task',
+                description: 'Create an ordinary task for the agenda (saved and committed; executed later with checks). Only for work the user asked for or clearly agreed to.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        title: { type: 'string', description: 'Readable, distinct task name' },
+                        description: { type: 'string', description: 'Intended result and constraints' },
+                        agent: { type: 'string', description: 'Optional responsible agent, e.g. @Developer' },
+                        priority: { type: 'number' },
+                    },
+                    required: ['title', 'description'],
+                },
+                handler: async (input) => {
+                    try {
+                        const name = await context.createTask({
+                            title: String(input.title ?? '').trim(),
+                            description: String(input.description ?? '').trim(),
+                            agent: typeof input.agent === 'string' && input.agent.trim() ? input.agent.trim() : undefined,
+                            priority: typeof input.priority === 'number' && input.priority >= 0 ? input.priority : undefined,
+                            chat: chat.name,
+                        });
+                        created.push(name);
+                        return { text: `Created the task {{${name}}} (linked to this chat). The agenda will execute it.` };
+                    }
+                    catch (error) {
+                        return { text: `The task was not created: ${errorMessage(error)}`, isError: true };
+                    }
+                },
+            },
+        ]
+        : [];
+    // Conversation-scoped TEAM consultation: bounded read-only advice, recorded as linked two-agent chats with their own
+    // scoped commits; the chat's agent stays the user's speaker and specialists never join the human chat.
+    const consultations = [];
+    if (plugin.capabilities.mcp && agent.team.length) {
+        const recorder = conversationChats(context.chats, chat.name, { takenNames: () => context.catalog.index.names() });
+        const controller = new AbortController();
+        context.signal?.addEventListener('abort', () => controller.abort(), { once: true });
+        tools.push(...teamTools({
+            project: context.project,
+            catalog: context.catalog,
+            pool: context.pool,
+            settings: context.settings,
+            chats: {
+                askUser: recorder.askUser,
+                recordConsultation: async (input) => {
+                    const name = await recorder.recordConsultation(input);
+                    if (name)
+                        consultations.push(name);
+                    return name;
+                },
+            },
+            task: { ref: `{{${chat.name}}}`, title: chat.name },
+            scope: 'conversation',
+            agentName: agent.name,
+            harness: harnessId,
+            depth: 0,
+            budget: { calls: 0 },
+            questionsAllowed: false,
+            signal: controller.signal,
+            onUserChat: () => undefined,
+            onActivity: (text) => context.onActivity?.(`${agent.name} in {{${chat.name}}}: ${text}`),
+        }, { includeUser: false }));
+    }
+    const prompt = [
+        `# Conversation\n\nYou are **${agent.name}**, talking with the user (the project owner) in the persistent chat {{${chat.name}}} of the project at \`${context.project.root}\`.`,
+        `## Your role\n\n${renderAgentInstructions(agent) || '_No additional instructions._'}`,
+        projectInstructions ? `## Project instructions (${contextFile})\n\n${projectInstructions.slice(0, 16_000)}` : '',
+        chat.links.length ? `## Linked Books\n\n${chat.links.join(', ')}` : '',
+        `## Conversation so far\n\n${transcript}`,
+        [
+            '## How to answer',
+            '',
+            '- Reply to the user\'s latest message directly and helpfully; you may inspect project files and Git history to answer.',
+            '- This conversation is read-only: never modify files or run write operations.',
+            tools.some((tool) => tool.name === 'create_task') ? '- To start work the user asked for or agreed to, call the `create_task` tool; the agenda executes it later with checks and commits. Do not claim work is done when you only created a task.' : '- You cannot create tasks here; describe what `ptbk add` should contain instead.',
+            ...(tools.some((tool) => tool.name === 'consult')
+                ? ['- For a specialist question, call the `consult` tool with a teammate from your TEAM (or @Expert for Promptbook itself) and tell the user whose advice you relay. Advice is not executed work: specialist work goes through `create_task`.']
+                : []),
+            '- If the user corrected you or stated a lasting, project-specific preference relevant to your role, add a final line `PTBK_LEARN <one sentence>` (it is removed from your reply).',
+        ].join('\n'),
+    ]
+        .filter(Boolean)
+        .join('\n\n');
+    const bridge = tools.length ? await ToolBridge.start(tools) : undefined;
+    const directory = await ensureDirectory(context.project.runtime.temporary);
+    const promptFile = join(directory, `chat-${shortId()}.md`);
+    await writeFile(promptFile, prompt);
+    context.onActivity?.(`${agent.name} is replying in {{${chat.name}}}`);
+    let result;
+    try {
+        result = await runHarness(plugin, {
+            projectRoot: context.project.root,
+            cwd: context.project.root,
+            prompt,
+            promptFile,
+            readOnly: true,
+            mcp: bridge?.launch(),
+            env: context.env,
+            timeoutMs: REPLY_TIMEOUT_MS,
+            signal: context.signal,
+            allowCredits: setting(context.settings, 'execution.allowCredits'),
+            authentication: inspection.authentication,
+            readableDirectories: agent.name === 'Expert' || agent.chain.includes('Expert') ? [EXPERT_DOCUMENTATION_DIRECTORY] : [],
+            model: context.settings.harnesses[harnessId]?.model,
+        }, inspection.executablePath ?? plugin.executable);
+    }
+    finally {
+        await bridge?.close();
+        await rm(promptFile, { force: true });
+    }
+    if (result.outcome !== 'completed' || !result.finalMessage.trim())
+        return { createdTasks: created, error: result.outcome === 'completed' ? `${agent.name} gave no reply.` : result.diagnostic };
+    const learning = LEARN_MARKER.exec(result.finalMessage)?.[1]?.trim();
+    const text = result.finalMessage.replace(LEARN_MARKER, '').replace(/^PTBK_RESULT .*$/m, '').trim();
+    const reply = await context.chats.append(chat.name, { sender: formatAgentReference(agent.name), text: text || '(no reply text)' }, { trailers: created.length ? { 'Task-Name': created } : undefined });
+    if (learning && agent.learning.open && agent.definition && parseReferenceValue(agentReference)?.normalized !== 'teacher' && setting(context.settings, 'learning.enabled')) {
+        await context.scheduleLearning?.({ chat: chat.name, agent: agent.name, note: learning }).catch(() => undefined);
+    }
+    return { reply, createdTasks: created, learning, consultations };
+}
+//# sourceMappingURL=conversation.js.map

package/dist/chats/conversation.js.map

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

package/dist/chats/local.d.ts

@@ -0,0 +1,46 @@
+import { type EffectiveSettings } from '../project/config.js';
+import type { Project } from '../project/workspace.js';
+import type { ChatSource } from '../ui/chat-client.js';
+import { ChatStore } from './store.js';
+/**
+ * Chats of a project whose service is not running: every write takes the project lock briefly and is committed as
+ * its own scoped operation; agent replies run in this process through the same read-only conversation turn.
+ *
+ * @private chats
+ */
+export declare class LocalChats {
+    private readonly project;
+    private readonly settings;
+    private readonly env;
+    private readonly repositoryRoot;
+    private catalog;
+    readonly store: ChatStore;
+    private readonly state;
+    private pool?;
+    private inFlight;
+    private constructor();
+    /**
+     * Opens the chats of a project (Git is required for committed chats unless commits are disabled).
+     */
+    static open(project: Project, settings: EffectiveSettings, env: NodeJS.ProcessEnv): Promise<LocalChats>;
+    /** Commits chat or authoring paths. */
+    private commit;
+    /** Runs one write under the project lock (a service cannot start in the middle of it). */
+    private locked;
+    /** Reloads the agent catalog (new Books written meanwhile). */
+    private reload;
+    /**
+     * Lets the chat's agent reply in this process (read-only; tasks only through ordinary committed authoring).
+     */
+    reply(name: string, onActivity?: (text: string) => void): Promise<string | undefined>;
+    /** Agent replies still being produced in this process. */
+    get pendingReplies(): number;
+    /**
+     * A chat source for terminal clients; agent replies run here after each user message that needs one.
+     */
+    source(options: {
+        readonly replies: boolean;
+        readonly onActivity?: (text: string) => void;
+        readonly onReplyError?: (error: string) => void;
+    }): ChatSource;
+}

package/dist/chats/local.js

@@ -0,0 +1,184 @@
+import { writeFile } from 'node:fs/promises';
+import { PtbkError } from '../common/errors.js';
+import { hashFileIfExists, toProjectRelative } from '../common/fs.js';
+import { shortId } from '../common/ids.js';
+import { formatAgentReference } from '../book/references.js';
+import { AgentCatalog, learningPolicyOf } from '../project/agents.js';
+import { setting } from '../project/config.js';
+import { commitPaths, inspectGit } from '../project/git.js';
+import { createChatLearningTask } from '../engine/generated.js';
+import { HarnessPool } from '../engine/harnesses.js';
+import { StateStore } from '../engine/state.js';
+import { acquireProjectLock } from '../service/records.js';
+import { newTaskPath, renderTaskBook } from '../tasks/authoring.js';
+import { generatedName } from '../tasks/identity.js';
+import { replyInChat } from './conversation.js';
+import { appendUserMessage, chatAgentChoices, chatDetail, createUserChat } from './service.js';
+import { ChatStore } from './store.js';
+/**
+ * Chats of a project whose service is not running: every write takes the project lock briefly and is committed as
+ * its own scoped operation; agent replies run in this process through the same read-only conversation turn.
+ *
+ * @private chats
+ */
+export class LocalChats {
+    project;
+    settings;
+    env;
+    repositoryRoot;
+    catalog;
+    store;
+    state;
+    pool;
+    inFlight = 0;
+    constructor(project, settings, env, repositoryRoot, catalog) {
+        this.project = project;
+        this.settings = settings;
+        this.env = env;
+        this.repositoryRoot = repositoryRoot;
+        this.catalog = catalog;
+        const commit = setting(settings, 'execution.commit') && Boolean(repositoryRoot);
+        this.state = new StateStore(project.runtime.state);
+        this.store = new ChatStore(project, {
+            timeZone: setting(settings, 'timezone'),
+            persistence: commit
+                ? { commit: async (paths, subject, trailers) => await this.commit(paths, subject, trailers) }
+                : { uncommitted: async (path) => await this.state.addOwnedUncommitted({ [toProjectRelative(project.root, path)]: (await hashFileIfExists(path)) ?? null }) },
+            takenNames: async () => {
+                await this.reload();
+                return this.catalog.index.names();
+            },
+        });
+    }
+    /**
+     * Opens the chats of a project (Git is required for committed chats unless commits are disabled).
+     */
+    static async open(project, settings, env) {
+        const git = await inspectGit(project.root);
+        if (setting(settings, 'execution.commit') && git.state !== 'repository') {
+            throw new PtbkError('The project is not in a Git working tree, so chat messages cannot be committed.', { kind: 'setup', next: ['Run `ptbk init`, or use --no-commit.'] });
+        }
+        const catalog = await AgentCatalog.load(project.root, setting(settings, 'paths.agents'), setting(settings, 'paths.tasks'));
+        return new LocalChats(project, settings, env, git.state === 'repository' ? git.root : undefined, catalog);
+    }
+    /** Commits chat or authoring paths. */
+    async commit(paths, subject, trailers) {
+        const outcome = await commitPaths({ projectRoot: this.project.root, repositoryRoot: this.repositoryRoot, paths, subject, trailers, temporaryDirectory: this.project.runtime.temporary, env: this.env });
+        return outcome.committed ? outcome.sha : undefined;
+    }
+    /** Runs one write under the project lock (a service cannot start in the middle of it). */
+    async locked(operation) {
+        const release = await acquireProjectLock(this.project, `chat-${shortId()}`, 'authoring');
+        try {
+            return await operation();
+        }
+        finally {
+            await release();
+        }
+    }
+    /** Reloads the agent catalog (new Books written meanwhile). */
+    async reload() {
+        this.catalog = await AgentCatalog.load(this.project.root, setting(this.settings, 'paths.agents'), setting(this.settings, 'paths.tasks'));
+    }
+    /**
+     * Lets the chat's agent reply in this process (read-only; tasks only through ordinary committed authoring).
+     */
+    async reply(name, onActivity) {
+        await this.reload();
+        if (!this.pool) {
+            this.pool = new HarnessPool(this.project.root, this.settings, this.env);
+            await this.pool.refresh(this.pool.enabled(), true);
+        }
+        const turn = await replyInChat({
+            project: this.project,
+            settings: this.settings,
+            catalog: this.catalog,
+            pool: this.pool,
+            chats: this.store,
+            env: this.env,
+            onActivity,
+            createTask: async (input) => await this.locked(async () => {
+                await this.reload();
+                const title = generatedName(input.title, { taken: this.catalog.index.names(), timeZone: setting(this.settings, 'timezone') });
+                const commitments = [];
+                if (input.agent)
+                    commitments.push(`TASK AGENT ${input.agent.startsWith('@') || input.agent.startsWith('{') ? input.agent : formatAgentReference(input.agent)}`);
+                if (input.priority !== undefined)
+                    commitments.push(`TASK PRIORITY ${input.priority}`);
+                commitments.push(`TASK ORIGIN chat {{${input.chat}}}`, `LINK {{${input.chat}}}`);
+                const path = await newTaskPath(this.catalog.index.rootPath('tasks'), input.title, Date.now(), setting(this.settings, 'timezone'));
+                await writeFile(path, renderTaskBook({ title, description: input.description || undefined, commitments }), { flag: 'wx' });
+                if (this.repositoryRoot && setting(this.settings, 'execution.commit'))
+                    await this.commit([path], `Add task - ${title}`, { 'Task-Name': title, 'Chat-Name': input.chat });
+                else
+                    await this.state.addOwnedUncommitted({ [toProjectRelative(this.project.root, path)]: (await hashFileIfExists(path)) ?? null });
+                return title;
+            }),
+            scheduleLearning: async (input) => await this.locked(async () => {
+                await this.reload();
+                const learner = await this.catalog.resolve(formatAgentReference(input.agent));
+                if (learner.kind !== 'agent' || !learningPolicyOf(learner.definition.document).open)
+                    return undefined;
+                const created = await createChatLearningTask({
+                    tasksDirectory: this.catalog.index.rootPath('tasks'),
+                    chat: input.chat,
+                    agent: learner.definition.name,
+                    agentPath: learner.definition.relativePath,
+                    note: input.note,
+                    timeZone: setting(this.settings, 'timezone'),
+                    taken: this.catalog.index.names(),
+                });
+                if (this.repositoryRoot && setting(this.settings, 'execution.commit'))
+                    await this.commit([created.path], `Add task - ${created.name}`, { 'Task-Name': created.name, 'Chat-Name': input.chat });
+                else
+                    await this.state.addOwnedUncommitted({ [toProjectRelative(this.project.root, created.path)]: (await hashFileIfExists(created.path)) ?? null });
+                return created.name;
+            }),
+        }, name);
+        return turn.error;
+    }
+    /** Agent replies still being produced in this process. */
+    get pendingReplies() {
+        return this.inFlight;
+    }
+    /**
+     * A chat source for terminal clients; agent replies run here after each user message that needs one.
+     */
+    source(options) {
+        const respond = (name) => {
+            if (!options.replies)
+                return;
+            // The harness turn runs unlocked (it can take minutes); its writes are scoped commits of their own paths.
+            this.inFlight++;
+            void this.reply(name, options.onActivity)
+                .then((error) => error && options.onReplyError?.(error), (error) => options.onReplyError?.(String(error)))
+                .finally(() => this.inFlight--);
+        };
+        return {
+            list: async () => await this.store.summaries(),
+            agents: async () => {
+                await this.reload();
+                return chatAgentChoices(this.catalog);
+            },
+            get: async (name) => await chatDetail(this.store, name),
+            create: async (agent, text, title) => {
+                const written = await this.locked(async () => {
+                    await this.reload();
+                    return await createUserChat(this.store, this.catalog, agent, text, { name: title });
+                });
+                await this.store.markRead(written.chat.name);
+                respond(written.chat.name);
+                return { name: written.chat.name, commit: written.commit };
+            },
+            send: async (name, text, expected) => {
+                const result = await this.locked(async () => await appendUserMessage(this.store, this.state, name, text, { expected }));
+                if (result.needsReply)
+                    respond(result.written.chat.name);
+                return { name: result.written.chat.name, commit: result.written.commit };
+            },
+            read: async (name) => await this.store.markRead(name),
+            replies: options.replies,
+        };
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/chats/local.js.map

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

package/dist/chats/migration.d.ts

@@ -0,0 +1,12 @@
+import type { Project } from '../project/workspace.js';
+import type { StateStore } from '../engine/state.js';
+import type { ChatStore } from './store.js';
+/**
+ * Upgrades pending request records of older engines into agent-authored chats waiting for the user, once.
+ *
+ * The original agent, reason, answer options and task wait state are kept; nothing is answered on the user's behalf.
+ * Returns the number of migrated requests.
+ *
+ * @private chats
+ */
+export declare function migrateLegacyRequests(project: Project, chats: ChatStore, state: StateStore, takenNames: () => ReadonlySet<string>): Promise<number>;

package/dist/chats/migration.js

@@ -0,0 +1,62 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { listDirectory } from '../common/fs.js';
+import { formatAgentReference, referenceName } from '../book/references.js';
+/**
+ * Upgrades pending request records of older engines into agent-authored chats waiting for the user, once.
+ *
+ * The original agent, reason, answer options and task wait state are kept; nothing is answered on the user's behalf.
+ * Returns the number of migrated requests.
+ *
+ * @private chats
+ */
+export async function migrateLegacyRequests(project, chats, state, takenNames) {
+    let migrated = 0;
+    const records = [...(await state.readParked())];
+    const active = await state.readActive();
+    if (active)
+        records.push(active);
+    for (const entry of await listDirectory(project.runtime.requests)) {
+        if (!entry.isFile || !/^r-[a-z0-9]+\.json$/.test(entry.name))
+            continue;
+        const path = join(project.runtime.requests, entry.name);
+        let request;
+        try {
+            request = JSON.parse(await readFile(path, 'utf8'));
+        }
+        catch {
+            continue;
+        }
+        if (request.status !== 'pending')
+            continue;
+        const agent = referenceName(request.origin?.agent ?? 'Fixer');
+        const created = await chats.create({
+            name: `${agent} asks: ${request.question.split('\n')[0].slice(0, 70)}`,
+            members: ['@User', formatAgentReference(agent)],
+            status: 'waiting-for-user',
+            links: request.origin?.taskTitle ? [`{{${request.origin.taskTitle}}}`] : [],
+            messages: [{ sender: formatAgentReference(agent), text: [request.reason, request.attempted ? `Already attempted: ${request.attempted}` : undefined, request.question].filter(Boolean).join('\n\n'), choices: request.choices?.length ? request.choices : undefined }],
+            taken: takenNames(),
+            trailers: request.origin?.taskTitle ? { 'Task-Name': request.origin.taskTitle } : undefined,
+        });
+        for (const record of records) {
+            const legacy = record;
+            const updates = {};
+            if (legacy.requestId === request.id)
+                Object.assign(updates, { waitingChat: created.chat.name, awaitedMessages: created.chat.messages.length, chats: [...(record.chats ?? []), created.chat.name] });
+            if (legacy.recoveryRequestId === request.id)
+                Object.assign(updates, { recoveryChat: created.chat.name, awaitedMessages: created.chat.messages.length });
+            if (!Object.keys(updates).length)
+                continue;
+            const updated = { ...record, ...updates };
+            if (record === active)
+                await state.writeActive(updated);
+            else
+                await state.writeParked(updated);
+        }
+        await writeFile(path, `${JSON.stringify({ ...request, status: 'cancelled', answer: `Migrated to the chat {{${created.chat.name}}}.` }, null, 2)}\n`);
+        migrated++;
+    }
+    return migrated;
+}
+//# sourceMappingURL=migration.js.map

package/dist/chats/migration.js.map

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

package/dist/chats/service.d.ts

@@ -0,0 +1,81 @@
+import type { AgentCatalog } from '../project/agents.js';
+import type { ActiveRecord, StateStore } from '../engine/state.js';
+import type { ChatStore, ChatSummary, ChatWrite } from './store.js';
+/**
+ * A selectable target agent of a new chat.
+ *
+ * @private chats
+ */
+export type ChatAgentChoice = {
+    /** Display name. */
+    readonly name: string;
+    /** Reference to pass when creating the chat (`@Developer`, `{Frontend Developer}`). */
+    readonly reference: string;
+    /**
+     * `chatter` is the default partner of a new chat (offered first, chosen with Enter); `ordinary`, `hidden`
+     * (core/hidden agents) and `expert` are the alternatives behind "Choose another agent".
+     */
+    readonly group: 'chatter' | 'ordinary' | 'hidden' | 'expert';
+    /** First goal of the agent, when declared. */
+    readonly description?: string;
+};
+/**
+ * One chat with its complete messages, as shown by every client.
+ *
+ * @private chats
+ */
+export type ChatDetail = {
+    readonly summary: ChatSummary;
+    readonly messages: ReadonlyArray<{
+        readonly sender: string;
+        readonly at: string;
+        readonly text: string;
+        readonly choices?: readonly string[];
+    }>;
+};
+/**
+ * Agents the user may chat with: Chatter first (the default partner of a new chat, when it is a valid agent), then
+ * every alternative: visible ordinary agents, hidden/core agents and the engine-provided Expert. User, Void and Null
+ * are never offered.
+ *
+ * @private chats
+ */
+export declare function chatAgentChoices(catalog: AgentCatalog): ChatAgentChoice[];
+/**
+ * The default partner of a new chat (Chatter), or an actionable diagnostic when it is missing or invalid. Another
+ * agent is never substituted silently, and nothing is created or initialized here.
+ *
+ * @private chats
+ */
+export declare function defaultChatAgent(choices: readonly ChatAgentChoice[]): ChatAgentChoice;
+/**
+ * Reads one chat with its messages.
+ *
+ * @private chats
+ */
+export declare function chatDetail(store: ChatStore, name: string): Promise<ChatDetail>;
+/**
+ * Starts a new user-led chat with exactly one agent (its first message is committed).
+ *
+ * @private chats
+ */
+export declare function createUserChat(store: ChatStore, catalog: AgentCatalog, agent: string, text: string, options?: {
+    readonly name?: string;
+}): Promise<ChatWrite>;
+/**
+ * Appends the user's message to a chat (one commit).
+ *
+ * In a chat waiting for the user, a reply matching the offered choices (or any reply when none were offered) answers
+ * it, reopens the chat and lets the waiting task resume; any other reply is a clarifying question for the agent.
+ * A failure-recovery decision accepts only one of its offered choices.
+ *
+ * @private chats
+ */
+export declare function appendUserMessage(store: ChatStore, state: StateStore, name: string, text: string, options?: {
+    readonly expected?: number;
+}): Promise<{
+    readonly written: ChatWrite;
+    readonly waitingTask?: ActiveRecord;
+    readonly answered: boolean;
+    readonly needsReply: boolean;
+}>;