ptbk 0.119.0-16 → 0.119.0-21

package/dist/chats/service.js

@@ -0,0 +1,122 @@
+import { PtbkError } from '../common/errors.js';
+import { commitmentsOf } from '../book/parse.js';
+import { formatAgentReference, normalizeAgentName } from '../book/references.js';
+import { CHATTER_NAME } from '../project/defaults.js';
+import { isHumanFacing } from './chat-book.js';
+/**
+ * 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 function chatAgentChoices(catalog) {
+    const chatterKey = normalizeAgentName(CHATTER_NAME);
+    const ordinary = catalog.ordinary().filter((entry) => entry.normalized !== chatterKey);
+    const ordinaryKeys = new Set(ordinary.map((agent) => agent.normalized));
+    const winners = catalog.index.winners('agent').filter((entry) => entry.kind === 'agent' && entry.tier !== 4);
+    const chatter = winners.find((entry) => entry.normalized === chatterKey);
+    const hidden = winners.filter((entry) => !ordinaryKeys.has(entry.normalized) && entry.normalized !== chatterKey);
+    const choice = (entry, group) => ({
+        name: entry.name,
+        reference: formatAgentReference(entry.name),
+        group,
+        description: commitmentsOf(entry.document, 'GOAL')[0]?.value.split('\n')[0]?.slice(0, 100),
+    });
+    return [
+        ...(chatter ? [choice(chatter, 'chatter')] : []),
+        ...ordinary.map((entry) => choice(entry, 'ordinary')),
+        ...hidden.map((entry) => choice(entry, 'hidden')),
+        // The built-in Expert always wins its name, so it is always available.
+        { name: 'Expert', reference: '@Expert', group: 'expert', description: 'Engine-provided Promptbook expert (current syntax and capabilities).' },
+    ];
+}
+/**
+ * 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 function defaultChatAgent(choices) {
+    const chatter = choices.find((choice) => choice.group === 'chatter');
+    if (chatter)
+        return chatter;
+    throw new PtbkError(`${CHATTER_NAME}, the default partner of new chats, is missing or invalid in this project.`, {
+        kind: 'setup',
+        reason: `No valid \`AGENT ${CHATTER_NAME}\` Book was found (normally agents/.core/chatter.book).`,
+        effect: 'No chat was started; no other agent was chosen in its place.',
+        next: ['Run `ptbk init` (or `ptbk start`) to add the missing core agent, or fix its Book (`ptbk lint`).', 'Or choose an agent explicitly, e.g. `ptbk chat --agent Developer`.'],
+    });
+}
+/**
+ * Reads one chat with its messages.
+ *
+ * @private chats
+ */
+export async function chatDetail(store, name) {
+    const stored = await store.find(name);
+    if (!stored)
+        throw new PtbkError(`No chat named "${name}".`, { kind: 'not-found', next: ['List chats with `ptbk chat --list`.'] });
+    const summary = (await store.summaries()).find((item) => item.path === stored.relativePath);
+    return { summary, messages: stored.chat.messages.map((message) => ({ sender: message.sender, at: message.at, text: message.text, choices: message.choices })) };
+}
+/**
+ * Starts a new user-led chat with exactly one agent (its first message is committed).
+ *
+ * @private chats
+ */
+export async function createUserChat(store, catalog, agent, text, options = {}) {
+    const reference = agent.startsWith('@') || agent.startsWith('{') ? agent : formatAgentReference(agent);
+    const resolution = await catalog.resolve(reference);
+    if (resolution.kind === 'non-agent' && resolution.name !== 'Expert')
+        throw new PtbkError(`You cannot chat with ${resolution.name}; choose a project agent or @Expert.`, { kind: 'usage' });
+    if (resolution.kind !== 'agent' && resolution.kind !== 'non-agent') {
+        throw new PtbkError(`Cannot chat with ${agent}: ${resolution.kind === 'wrong-kind' ? `${resolution.entry.relativePath} is a ${resolution.entry.kind}, not an agent` : `no such agent (${resolution.kind})`}.`, { kind: 'usage', next: ['Run `ptbk chat` without --agent to choose one.'] });
+    }
+    const name = resolution.kind === 'agent' ? resolution.definition.name : 'Expert';
+    const first = text.split('\n').find((line) => line.trim())?.trim();
+    if (!first)
+        throw new PtbkError('The first message of a chat cannot be empty.', { kind: 'usage' });
+    return await store.create({
+        name: options.name?.trim() || `${name}: ${first.slice(0, 60)}`,
+        members: ['@User', formatAgentReference(name)],
+        status: 'open',
+        messages: [{ sender: '@User', text }],
+        taken: catalog.index.names(),
+    });
+}
+/**
+ * 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 async function appendUserMessage(store, state, name, text, options = {}) {
+    const stored = await store.find(name);
+    if (!stored)
+        throw new PtbkError(`No chat named "${name}".`, { kind: 'not-found', next: ['List chats with `ptbk chat --list`.'] });
+    if (!isHumanFacing(stored.chat))
+        throw new PtbkError('Agent↔agent consultation chats are task records; you cannot write into them.', { kind: 'usage' });
+    const waiting = stored.chat.status === 'waiting-for-user';
+    const awaited = waiting ? [...stored.chat.messages].reverse().find((message) => message.senderKey !== 'user') : undefined;
+    const applicable = !awaited?.choices?.length || awaited.choices.includes(text.trim());
+    const active = await state.readActive();
+    const records = [...(await state.readParked()), ...(active ? [active] : [])];
+    const waitingTask = records.find((record) => record.waitingChat === stored.chat.name || record.recoveryChat === stored.chat.name);
+    if (waitingTask?.recoveryChat === stored.chat.name && waiting && !applicable) {
+        throw new PtbkError(`"${text}" is not one of the offered answers.`, { kind: 'usage', reason: `Choose one of: ${awaited.choices.join(' | ')}`, effect: 'Nothing was saved.' });
+    }
+    const answered = waiting && applicable;
+    const written = await store.append(stored.chat.name, { sender: '@User', text: answered && awaited?.choices?.length ? text.trim() : text }, {
+        // Answering reopens the chat; writing into a resolved chat continues the conversation.
+        status: answered || stored.chat.status === 'resolved' ? 'open' : undefined,
+        expectedMessages: options.expected,
+        trailers: waitingTask ? { 'Task-Name': waitingTask.taskTitle } : undefined,
+    });
+    await store.markRead(written.chat.name);
+    return { written, waitingTask, answered, needsReply: !(waitingTask && answered) };
+}
+//# sourceMappingURL=service.js.map

package/dist/chats/service.js.map

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

package/dist/chats/store.d.ts

@@ -0,0 +1,132 @@
+import type { Project } from '../project/workspace.js';
+import { type ChatBook, type ChatMessage, type ChatStatus } from './chat-book.js';
+/**
+ * How chat operations are versioned: each human-facing operation is its own commit unless explicitly uncommitted.
+ *
+ * @private chats
+ */
+export type ChatPersistence = {
+    /** Commits exactly these paths; returns the commit (undefined when nothing was committed). Absent in no-commit mode. */
+    readonly commit?: (paths: readonly string[], subject: string, trailers: Readonly<Record<string, string | readonly string[] | undefined>>) => Promise<string | undefined>;
+    /** Records a written path as owned but uncommitted (explicit no-commit mode). */
+    readonly uncommitted?: (path: string) => Promise<void>;
+};
+/**
+ * A stored chat with its location.
+ *
+ * @private chats
+ */
+export type StoredChat = {
+    readonly path: string;
+    readonly relativePath: string;
+    readonly chat: ChatBook;
+};
+/**
+ * Summary of a chat for status views, dashboards and the API.
+ *
+ * @private chats
+ */
+export type ChatSummary = {
+    readonly name: string;
+    readonly path: string;
+    readonly members: readonly string[];
+    /** The agent participant (human-facing chats). */
+    readonly agent?: string;
+    readonly status: ChatStatus;
+    readonly humanFacing: boolean;
+    readonly links: readonly string[];
+    readonly messages: number;
+    readonly last?: {
+        readonly sender: string;
+        readonly at: string;
+        readonly preview: string;
+    };
+    /** The agent's question awaiting the user (when waiting-for-user). */
+    readonly awaiting?: {
+        readonly sender: string;
+        readonly text: string;
+        readonly choices?: readonly string[];
+    };
+    /** New messages not authored by User since this viewer last opened the chat. */
+    readonly unread: number;
+};
+/**
+ * Result of a chat write.
+ *
+ * @private chats
+ */
+export type ChatWrite = StoredChat & {
+    readonly commit?: string;
+};
+/**
+ * Durable chat Books in root-level `chats/`, with per-message persistence and local read markers.
+ *
+ * @private chats
+ */
+export declare class ChatStore {
+    private readonly project;
+    private readonly options;
+    private readonly mutex;
+    /** Absolute chats directory. */
+    readonly directory: string;
+    constructor(project: Project, options: {
+        readonly timeZone: string;
+        readonly persistence?: ChatPersistence;
+        /** Fresh normalized names of every project Book, rechecked when a new chat is published. */
+        readonly takenNames?: () => Promise<ReadonlySet<string>>;
+    });
+    /** Current timestamp in the project's time zone. */
+    now(): string;
+    /** Every chat Book (deterministic order: shallow first, then path). */
+    list(): Promise<StoredChat[]>;
+    /** Finds a chat by name (`{Name}`, `@Name` or plain text); the first same-name chat wins. */
+    find(name: string): Promise<StoredChat | undefined>;
+    /**
+     * Creates a chat named after its readable title plus creation date/time (distinct under normalization from every
+     * Book); a human-facing chat is committed. The final name is allocated once, under the store's lock.
+     */
+    create(options: {
+        readonly name: string;
+        readonly members: readonly string[];
+        readonly status: ChatStatus;
+        readonly links?: readonly string[];
+        readonly messages?: ReadonlyArray<Pick<ChatMessage, 'sender' | 'text' | 'choices'> & {
+            readonly at?: string;
+        }>;
+        /** Normalized names already used by other Books. */
+        readonly taken?: ReadonlySet<string>;
+        /** Extra trailers (e.g. `Task-Name`). */
+        readonly trailers?: Readonly<Record<string, string | readonly string[] | undefined>>;
+        /**
+         * Commit even an agent↔agent chat as its own scoped operation (a consultation serving a conversation without
+         * an owning task); task-scoped consultations instead join their task's result commit.
+         */
+        readonly commit?: boolean;
+    }): Promise<ChatWrite>;
+    /**
+     * Appends one message (optionally changing the status) in a single save and, for human-facing chats, commit.
+     *
+     * `expectedMessages` rejects a stale client that did not see the latest message (no duplicate answers).
+     */
+    append(name: string, message: Pick<ChatMessage, 'sender' | 'text' | 'choices'>, options?: {
+        readonly status?: ChatStatus;
+        readonly expectedMessages?: number;
+        readonly trailers?: Readonly<Record<string, string | readonly string[] | undefined>>;
+    }): Promise<ChatWrite>;
+    /** Changes only the durable status (e.g. resolving a request without a new message). */
+    setStatus(name: string, status: ChatStatus): Promise<ChatWrite>;
+    /** Commits (or records as uncommitted) one chat operation. */
+    private persist;
+    /** Local per-viewer read markers (`.ptbk/state/chat-read.json`): chat key → seen message count. */
+    readMarkers(): Promise<Record<string, number>>;
+    /** Marks a chat as read up to its current messages (runtime-only; never committed, never an answer). */
+    markRead(name: string): Promise<void>;
+    /** Summaries of every chat, waiting-for-user first, then most recent. */
+    summaries(): Promise<ChatSummary[]>;
+}
+/**
+ * Builds the summary of one chat.
+ *
+ * @private chats
+ */
+export declare function summarize(chat: ChatBook, relativePath: string, seen: number): ChatSummary;

package/dist/chats/store.js

@@ -0,0 +1,181 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { PtbkError } from '../common/errors.js';
+import { ensureDirectory, listDirectory, readJsonIfExists, toProjectRelative, writeJsonAtomic } from '../common/fs.js';
+import { Mutex } from '../common/mutex.js';
+import { formatIsoWithOffset } from '../common/time.js';
+import { normalizeAgentName, parseReferenceValue } from '../book/references.js';
+import { CHATS_DIRECTORY } from '../project/books.js';
+import { newTaskPath } from '../tasks/authoring.js';
+import { generatedName } from '../tasks/identity.js';
+import { appendChatMessage, chatAgent, isHumanFacing, parseChatBook, renderChatBook, setChatStatus } from './chat-book.js';
+/**
+ * Durable chat Books in root-level `chats/`, with per-message persistence and local read markers.
+ *
+ * @private chats
+ */
+export class ChatStore {
+    project;
+    options;
+    mutex = new Mutex();
+    /** Absolute chats directory. */
+    directory;
+    constructor(project, options) {
+        this.project = project;
+        this.options = options;
+        this.directory = join(project.root, CHATS_DIRECTORY);
+    }
+    /** Current timestamp in the project's time zone. */
+    now() {
+        return formatIsoWithOffset(Date.now(), this.options.timeZone);
+    }
+    /** Every chat Book (deterministic order: shallow first, then path). */
+    async list() {
+        const found = [];
+        const stack = [this.directory];
+        while (stack.length) {
+            const current = stack.pop();
+            for (const entry of await listDirectory(current)) {
+                const path = join(current, entry.name);
+                if (entry.isDirectory && !entry.name.startsWith('_') && !entry.name.startsWith('.'))
+                    stack.push(path);
+                else if (entry.isFile && entry.name.toLowerCase().endsWith('.book')) {
+                    const source = await readFile(path, 'utf8').catch(() => undefined);
+                    if (source !== undefined)
+                        found.push({ path, relativePath: toProjectRelative(this.project.root, path), chat: parseChatBook(source) });
+                }
+            }
+        }
+        return found.sort((a, b) => a.relativePath.split('/').length - b.relativePath.split('/').length || (a.relativePath < b.relativePath ? -1 : 1));
+    }
+    /** Finds a chat by name (`{Name}`, `@Name` or plain text); the first same-name chat wins. */
+    async find(name) {
+        const key = parseReferenceValue(name)?.normalized ?? normalizeAgentName(name);
+        return (await this.list()).find((stored) => stored.chat.key === key);
+    }
+    /**
+     * Creates a chat named after its readable title plus creation date/time (distinct under normalization from every
+     * Book); a human-facing chat is committed. The final name is allocated once, under the store's lock.
+     */
+    async create(options) {
+        return await this.mutex.run(async () => {
+            const fresh = (await this.options.takenNames?.().catch(() => undefined)) ?? [];
+            const taken = new Set([...(options.taken ?? []), ...fresh, ...(await this.list()).map((stored) => stored.chat.key)]);
+            const title = options.name.replace(/[\r\n]+/g, ' ').slice(0, 120);
+            const name = generatedName(title, { taken, timeZone: this.options.timeZone });
+            await ensureDirectory(this.directory);
+            const path = await newTaskPath(this.directory, title, Date.now(), this.options.timeZone);
+            const source = renderChatBook({ name, members: options.members, status: options.status, links: options.links, messages: (options.messages ?? []).map((message) => ({ ...message, at: message.at ?? this.now() })) });
+            await writeFile(path, source, { flag: 'wx' });
+            const chat = parseChatBook(source);
+            const commit = isHumanFacing(chat) || options.commit ? await this.persist(path, name, options.trailers) : undefined;
+            return { path, relativePath: toProjectRelative(this.project.root, path), chat, commit };
+        });
+    }
+    /**
+     * Appends one message (optionally changing the status) in a single save and, for human-facing chats, commit.
+     *
+     * `expectedMessages` rejects a stale client that did not see the latest message (no duplicate answers).
+     */
+    async append(name, message, options = {}) {
+        return await this.mutex.run(async () => {
+            const stored = await this.find(name);
+            if (!stored)
+                throw new PtbkError(`No chat named "${name}".`, { kind: 'not-found', next: ['List chats with `ptbk chat --list`.'] });
+            if (options.expectedMessages !== undefined && options.expectedMessages !== stored.chat.messages.length) {
+                throw new PtbkError(`The chat "${stored.chat.name}" changed since it was displayed (${stored.chat.messages.length} messages, expected ${options.expectedMessages}).`, {
+                    kind: 'conflict',
+                    effect: 'Your message was not added twice; nothing was saved.',
+                    next: ['Reload the chat and reply again if still needed.'],
+                });
+            }
+            if (!message.text.trim())
+                throw new PtbkError('A chat message cannot be empty.', { kind: 'usage' });
+            const source = await readFile(stored.path, 'utf8');
+            const updated = appendChatMessage(source, { ...message, at: this.now() }, options.status);
+            await writeFile(stored.path, updated);
+            const chat = parseChatBook(updated);
+            const commit = isHumanFacing(chat) ? await this.persist(stored.path, chat.name, options.trailers) : undefined;
+            return { ...stored, chat, commit };
+        });
+    }
+    /** Changes only the durable status (e.g. resolving a request without a new message). */
+    async setStatus(name, status) {
+        return await this.mutex.run(async () => {
+            const stored = await this.find(name);
+            if (!stored)
+                throw new PtbkError(`No chat named "${name}".`, { kind: 'not-found' });
+            if (stored.chat.status === status)
+                return stored;
+            const updated = setChatStatus(await readFile(stored.path, 'utf8'), status);
+            await writeFile(stored.path, updated);
+            const chat = parseChatBook(updated);
+            const commit = isHumanFacing(chat) ? await this.persist(stored.path, chat.name) : undefined;
+            return { ...stored, chat, commit };
+        });
+    }
+    /** Commits (or records as uncommitted) one chat operation. */
+    async persist(path, name, trailers = {}) {
+        const persistence = this.options.persistence;
+        if (!persistence)
+            return undefined;
+        if (!persistence.commit) {
+            await persistence.uncommitted?.(path);
+            return undefined;
+        }
+        try {
+            return await persistence.commit([path], `Chat - ${name}`, { 'Chat-Name': name, ...trailers });
+        }
+        catch (error) {
+            throw new PtbkError(`The chat message was written but could not be committed.`, {
+                kind: 'persistence',
+                reason: error.details?.reason ?? String(error),
+                preserved: `${toProjectRelative(this.project.root, path)} keeps the message; it is visibly unsent until committed.`,
+                next: ['Fix the Git problem; the pending change is committed with the next chat operation or by `ptbk recover`.'],
+            });
+        }
+    }
+    /** Local per-viewer read markers (`.ptbk/state/chat-read.json`): chat key → seen message count. */
+    async readMarkers() {
+        return (await readJsonIfExists(join(this.project.runtime.state, 'chat-read.json')).catch(() => undefined)) ?? {};
+    }
+    /** Marks a chat as read up to its current messages (runtime-only; never committed, never an answer). */
+    async markRead(name) {
+        const stored = await this.find(name);
+        if (!stored)
+            return;
+        const markers = await this.readMarkers();
+        markers[stored.chat.key] = stored.chat.messages.length;
+        await ensureDirectory(this.project.runtime.state);
+        await writeJsonAtomic(join(this.project.runtime.state, 'chat-read.json'), markers);
+    }
+    /** Summaries of every chat, waiting-for-user first, then most recent. */
+    async summaries() {
+        const markers = await this.readMarkers();
+        const summaries = (await this.list()).map(({ relativePath, chat }) => summarize(chat, relativePath, markers[chat.key] ?? 0));
+        return summaries.sort((a, b) => Number(b.status === 'waiting-for-user') - Number(a.status === 'waiting-for-user') || (b.last?.at ?? '').localeCompare(a.last?.at ?? ''));
+    }
+}
+/**
+ * Builds the summary of one chat.
+ *
+ * @private chats
+ */
+export function summarize(chat, relativePath, seen) {
+    const last = chat.messages[chat.messages.length - 1];
+    const awaiting = chat.status === 'waiting-for-user' ? [...chat.messages].reverse().find((message) => message.senderKey !== 'user') : undefined;
+    return {
+        name: chat.name,
+        path: relativePath,
+        members: chat.members,
+        agent: chatAgent(chat),
+        status: chat.status,
+        humanFacing: isHumanFacing(chat),
+        links: chat.links,
+        messages: chat.messages.length,
+        last: last ? { sender: last.sender, at: last.at, preview: last.text.replace(/\s+/g, ' ').slice(0, 160) } : undefined,
+        awaiting: awaiting ? { sender: awaiting.sender, text: awaiting.text, choices: awaiting.choices } : undefined,
+        unread: chat.messages.slice(seen).filter((message) => message.senderKey !== 'user').length,
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/chats/store.js.map

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

package/dist/chats/task-chats.d.ts

@@ -0,0 +1,52 @@
+import type { ChatStore } from './store.js';
+/**
+ * Chat operations available to an executing task (TEAM @User, browser sign-in, recovery) and its consultations.
+ *
+ * @private chats
+ */
+export type TaskChats = {
+    /**
+     * Starts or continues the agent→User chat for a genuine blocker; repeated reports of the same unresolved question
+     * reuse the waiting chat instead of asking again. Returns the chat and the message count to wait beyond.
+     */
+    readonly askUser: (input: {
+        readonly agent: string;
+        readonly question: string;
+        readonly reason?: string;
+        readonly attempted?: string;
+        readonly choices?: readonly string[];
+    }) => Promise<{
+        readonly chat: string;
+        readonly awaited: number;
+        readonly reused: boolean;
+    }>;
+    /** Records a task-scoped agent↔agent consultation; it is saved with the task's single result commit. */
+    readonly recordConsultation: (input: {
+        readonly from: string;
+        readonly to: string;
+        readonly question: string;
+        readonly answer: string;
+    }) => Promise<string | undefined>;
+};
+/**
+ * Chat operations of a consultation serving a human-facing conversation without an owning task (e.g. Chatter asking
+ * a specialist): each bounded two-agent exchange is its own chat Book linked to the conversation and persisted as an
+ * ordinary scoped authoring operation — never a fabricated task, a task result or a participant of the human chat.
+ *
+ * @private chats
+ */
+export declare function conversationChats(store: ChatStore, conversation: string, options: {
+    readonly takenNames: () => ReadonlySet<string>;
+}): TaskChats;
+/**
+ * Chat operations bound to one task.
+ *
+ * @private chats
+ */
+export declare function taskChats(store: ChatStore, task: {
+    readonly name: string;
+    readonly key: string;
+}, options: {
+    readonly takenNames: () => ReadonlySet<string>;
+    readonly onCreated?: (path: string) => void;
+}): TaskChats;

package/dist/chats/task-chats.js

@@ -0,0 +1,96 @@
+import { formatAgentReference, parseReferenceValue, referenceName } from '../book/references.js';
+/**
+ * Whether a chat links a task (by normalized name).
+ */
+function linksTask(chat, taskKey) {
+    return chat.links.some((link) => parseReferenceValue(link)?.normalized === taskKey);
+}
+/**
+ * Composes the agent's message: what is blocked, what was attempted and the minimal question/action.
+ */
+function questionText(input) {
+    return [input.reason?.trim(), input.attempted?.trim() ? `Already attempted: ${input.attempted.trim()}` : undefined, input.question.trim()].filter(Boolean).join('\n\n');
+}
+/**
+ * Chat operations of a consultation serving a human-facing conversation without an owning task (e.g. Chatter asking
+ * a specialist): each bounded two-agent exchange is its own chat Book linked to the conversation and persisted as an
+ * ordinary scoped authoring operation — never a fabricated task, a task result or a participant of the human chat.
+ *
+ * @private chats
+ */
+export function conversationChats(store, conversation, options) {
+    return {
+        askUser: async () => {
+            throw new Error('Advisors of a conversation cannot ask the user; the conversation agent replies to the user itself.');
+        },
+        recordConsultation: async (input) => {
+            const from = formatAgentReference(referenceName(input.from));
+            const to = formatAgentReference(referenceName(input.to));
+            const created = await store.create({
+                name: `Consultation: ${referenceName(input.from)} with ${referenceName(input.to)} for ${conversation}`.slice(0, 120),
+                members: [from, to],
+                status: 'resolved',
+                links: [`{{${conversation}}}`],
+                messages: [
+                    { sender: from, text: input.question },
+                    { sender: to, text: input.answer },
+                ],
+                taken: options.takenNames(),
+                commit: true,
+            });
+            return created.chat.name;
+        },
+    };
+}
+/**
+ * Chat operations bound to one task.
+ *
+ * @private chats
+ */
+export function taskChats(store, task, options) {
+    const taskRef = `{{${task.name}}}`;
+    return {
+        askUser: async (input) => {
+            const agentRef = formatAgentReference(referenceName(input.agent));
+            const text = questionText(input);
+            const agentKey = parseReferenceValue(agentRef)?.normalized;
+            const existing = (await store.list()).find((stored) => linksTask(stored.chat, task.key) && stored.chat.members.some((member) => parseReferenceValue(member)?.normalized === agentKey) && stored.chat.members.some((member) => parseReferenceValue(member)?.normalized === 'user'));
+            if (existing) {
+                const last = [...existing.chat.messages].reverse().find((message) => message.senderKey === agentKey);
+                // The same still-unanswered question is never sent twice.
+                if (existing.chat.status === 'waiting-for-user' && last && last.text.trim() === text.trim())
+                    return { chat: existing.chat.name, awaited: existing.chat.messages.length, reused: true };
+                const written = await store.append(existing.chat.name, { sender: agentRef, text, choices: input.choices }, { status: 'waiting-for-user', trailers: { 'Task-Name': task.name } });
+                return { chat: written.chat.name, awaited: written.chat.messages.length, reused: false };
+            }
+            const created = await store.create({
+                name: `${referenceName(input.agent)} asks: ${input.question.split('\n').find((line) => line.trim())?.trim().slice(0, 70) ?? task.name}`,
+                members: ['@User', agentRef],
+                status: 'waiting-for-user',
+                links: [taskRef],
+                messages: [{ sender: agentRef, text, choices: input.choices }],
+                taken: options.takenNames(),
+                trailers: { 'Task-Name': task.name },
+            });
+            options.onCreated?.(created.path);
+            return { chat: created.chat.name, awaited: created.chat.messages.length, reused: false };
+        },
+        recordConsultation: async (input) => {
+            const from = formatAgentReference(referenceName(input.from));
+            const to = formatAgentReference(referenceName(input.to));
+            const created = await store.create({
+                name: `Consultation: ${referenceName(input.from)} with ${referenceName(input.to)} on ${task.name}`.slice(0, 120),
+                members: [from, to],
+                status: 'resolved',
+                links: [taskRef],
+                messages: [
+                    { sender: from, text: input.question },
+                    { sender: to, text: input.answer },
+                ],
+                taken: options.takenNames(),
+            });
+            return created.chat.name;
+        },
+    };
+}
+//# sourceMappingURL=task-chats.js.map

package/dist/chats/task-chats.js.map

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