plasalid 0.4.1 → 0.5.1

package/dist/ai/tools/ingest.js

@@ -1,27 +1,35 @@
-import { findAccountById } from "../../db/queries/account_balance.js";
-import { recordJournalEntry } from "../../db/queries/journal.js";
+import { createAccount, updateAccountMetadata, findAccountById, } from "../../db/queries/account_balance.js";
+import { validateTransaction, insertTransactionRows, recordTransaction, } from "../../db/queries/transactions.js";
+import { appendAction } from "../../db/queries/action_log.js";
 import { getConcernTarget, recordConcern, resolveConcern, } from "../../db/queries/concerns.js";
 import { runExclusive as runAccountExclusive } from "../../scanner/account_mutex.js";
 import { sanitizeForPrompt } from "../sanitize.js";
-import { ACCOUNT_TYPE_DESCRIPTIONS, } from "../../accounts/taxonomy.js";
+import { ACCOUNT_TYPE_DESCRIPTIONS } from "../../accounts/taxonomy.js";
 const ACCOUNT_TYPES = Object.keys(ACCOUNT_TYPE_DESCRIPTIONS);
-// ── Scan-side tool definitions ──────────────────────────────────────────────
-// These tools are exposed during both `plasalid scan` and `plasalid review`:
-// scan uses them to post the initial picture; review uses the same primitives
-// to fix mistakes (re-create a botched account, post a corrected entry, etc.).
-// `note_concern` belongs here too — it records a clarification without ever
-// prompting the user, which is what scan needs.
-const SCAN_DEFS = [
+/**
+ * Account + transaction write primitives
+ *
+ * Shared by scan, review, and record. Each tool branches once on
+ * `ctx.correlationId`: when set (record path), the data write and the
+ * action_log insert run inside a single transaction so the audit row is
+ * atomic with the change. Without it (scan / review), the write goes through
+ * the existing path unchanged.
+ */
+const ACCOUNT_DEFS = [
     {
         name: "create_account",
-        description: "Create a new account in the chart of accounts when a statement reveals one that doesn't exist yet. Use a stable id like 'asset:kbank-savings-1234'.",
+        description: "Create a new account in the chart of accounts. Account ids are colon-paths under one of the five top-level type roots ('asset', 'liability', 'income', 'expense', 'equity'). Examples: 'asset:kbank-savings-1234', 'expense:food', 'expense:food:groceries'. Every non-root account must have a parent_id that already exists and shares its type; create intermediate parents (e.g. 'expense:food') before their leaves. Top-level roots are auto-bootstrapped on first use.",
         input_schema: {
             type: "object",
             properties: {
-                id: { type: "string", description: "Stable identifier, lowercase, colon-separated. e.g. 'asset:kbank-savings-1234'." },
-                name: { type: "string", description: "Human-readable name. e.g. 'KBank Savings ••1234'." },
-                type: { type: "string", enum: ACCOUNT_TYPES, description: "Account type." },
-                subtype: { type: "string", description: "e.g. 'bank', 'credit_card', 'salary', 'food'." },
+                id: { type: "string", description: "Stable colon-path identifier, lowercase. e.g. 'expense:food:groceries' or 'asset:kbank-savings-1234'." },
+                name: { type: "string", description: "Human-readable name. e.g. 'Groceries' or 'KBank Savings ••1234'." },
+                type: { type: "string", enum: ACCOUNT_TYPES, description: "Account type. Must match the parent's type." },
+                parent_id: {
+                    type: ["string", "null"],
+                    description: "Parent account id (the prefix before the final ':' segment). Pass null only when creating one of the five top-level type roots — and then id must equal type. Examples: id='expense:food:groceries' → parent_id='expense:food'. id='expense:food' → parent_id='expense'. id='expense' → parent_id=null.",
+                },
+                subtype: { type: "string", description: "e.g. 'bank', 'credit_card', 'salary'." },
                 bank_name: { type: "string", description: "Thai institution code from the taxonomy (e.g. KBANK, SCB, KTC)." },
                 account_number_masked: { type: "string", description: "Last 4 digits only, e.g. '••1234'." },
                 currency: { type: "string", description: "ISO 4217 code. Defaults to 'THB'.", default: "THB" },
@@ -29,12 +37,12 @@ const SCAN_DEFS = [
                 statement_day: { type: "number", description: "Statement-cut day of month." },
                 metadata: { type: "object", description: "Free-form extra fields (e.g. {points_program: 'KTC Forever'})." },
             },
-            required: ["id", "name", "type"],
+            required: ["id", "name", "type", "parent_id"],
         },
     },
     {
         name: "update_account_metadata",
-        description: "Update account metadata (due day, statement day, points balance, masked number, bank).",
+        description: "Update account metadata (due day, statement day, points balance, masked number, bank). Use this — not record_transaction — when the user says things like 'set my KTC due day to 20' or 'statement day 28'.",
         input_schema: {
             type: "object",
             properties: {
@@ -50,68 +58,58 @@ const SCAN_DEFS = [
         },
     },
     {
-        name: "record_journal_entry",
-        description: "Post a balanced double-entry journal entry. The sum of debits MUST equal the sum of credits (within one currency). Convert Buddhist-Era dates by subtracting 543. Every line carries an ISO 4217 currency code (THB, USD, EUR, …); default to THB. Use the account's currency where set; only deviate when the source row is explicitly in another currency.",
+        name: "record_transaction",
+        description: "Post one balanced double-entry transaction — the right tool for any real-world event (purchase, payment, transfer, refund, salary, withdrawal). Use adjust_account_balance instead when the user is stating a current balance rather than describing a transaction. The sum of debits MUST equal the sum of credits (within one currency). Convert Buddhist-Era dates by subtracting 543. Each posting carries an ISO 4217 currency code (THB, USD, EUR, …); default to THB. Use the account's currency where set; only deviate when the source row is explicitly in another currency. When the transaction has an external counter-party, attach a `merchant` block — Plasalid dedups merchants and learns a default expense account per merchant so future statements skip re-categorization.",
         input_schema: {
             type: "object",
             properties: {
                 date: { type: "string", description: "ISO Gregorian date (YYYY-MM-DD)." },
-                description: { type: "string", description: "Short human-readable description of the entry." },
+                description: { type: "string", description: "Short human-readable description." },
                 source_page: { type: "number", description: "Page number in the source PDF, if known." },
-                lines: {
+                raw_descriptor: {
+                    type: "string",
+                    description: "The exact statement line (the raw merchant descriptor) when posting from a PDF — preserved for alias matching and later review. Omit for manual entries and transfers.",
+                },
+                merchant: {
+                    type: "object",
+                    description: "Counter-party block. Omit for transfers between own accounts and pure metadata movements. When set during a scan, Plasalid upserts the merchant by canonical_name and (optionally) records the raw descriptor as an alias for future matches. Set default_account_id to teach the cache when categorization is confident.",
+                    properties: {
+                        canonical_name: { type: "string", description: "Normalized merchant name, Title Case. e.g. 'Starbucks', 'Amazon', 'Spotify'." },
+                        alias: { type: "string", description: "The raw descriptor exactly as it appears on the statement. Plasalid normalizes and stores it so future statements skip the LLM." },
+                        default_account_id: { type: "string", description: "Optional learned cache: 'this merchant's expense category is X'. Set when categorization is confident." },
+                    },
+                    required: ["canonical_name"],
+                },
+                merchant_id: {
+                    type: "string",
+                    description: "Pre-resolved merchant id (from the scanner's alias pre-pass). When set, the merchant block is ignored. The scanner uses this to skip re-categorizing merchants it already knows.",
+                },
+                postings: {
                     type: "array",
-                    description: "Two or more journal lines that balance.",
+                    description: "Two or more postings that balance.",
                     items: {
                         type: "object",
                         properties: {
                             account_id: { type: "string", description: "Existing account id from list_accounts or create_account." },
-                            debit: { type: "number", description: "Debit amount in this line's currency. Use 0 if this line is a credit." },
-                            credit: { type: "number", description: "Credit amount in this line's currency. Use 0 if this line is a debit." },
-                            currency: { type: "string", description: "ISO 4217 currency code for this line (e.g. THB, USD, EUR). Defaults to THB.", default: "THB" },
-                            memo: { type: "string", description: "Optional per-line memo." },
+                            debit: { type: "number", description: "Debit amount in this posting's currency. Use 0 if this posting is a credit." },
+                            credit: { type: "number", description: "Credit amount in this posting's currency. Use 0 if this posting is a debit." },
+                            currency: { type: "string", description: "ISO 4217 currency code for this posting (e.g. THB, USD, EUR). Defaults to THB.", default: "THB" },
+                            memo: { type: "string", description: "Optional per-posting memo." },
                         },
                         required: ["account_id"],
                     },
                 },
             },
-            required: ["date", "description", "lines"],
-        },
-    },
-    {
-        name: "note_concern",
-        description: "Record a clarification request without pausing the run. Use during scan when a row is ambiguous (post your best-guess journal entry first, then call this with the entry's id), when a row is unparseable (skip the entry, call this with no entry_id), or when you have a concern about an account itself (pass account_id). The reviewer picks these up later with the full picture.",
-        input_schema: {
-            type: "object",
-            properties: {
-                prompt: {
-                    type: "string",
-                    description: "The question or concern in a complete sentence, with date, ฿-formatted amount, and human account names. Never reference internal ids.",
-                },
-                options: {
-                    type: "array",
-                    description: "Optional list of candidate answers the reviewer can offer the user.",
-                    items: { type: "string" },
-                },
-                entry_id: {
-                    type: "string",
-                    description: "Id of the journal entry this concern relates to (returned by record_journal_entry). Omit for file-level concerns about an unparseable row.",
-                },
-                account_id: {
-                    type: "string",
-                    description: "Id of the account this concern relates to. Set when the statement's bank name, currency, statement_day, due_day, or other metadata disagrees with the stored account, or when you suspect a new account you're about to create duplicates an existing one. Can be combined with entry_id.",
-                },
-            },
-            required: ["prompt"],
+            required: ["date", "description", "postings"],
         },
     },
 ];
-const SCAN_LABELS = {
+const ACCOUNT_LABELS = {
     create_account: "Creating account",
     update_account_metadata: "Updating account metadata",
-    record_journal_entry: "Posting journal entry",
-    note_concern: "Noting concern",
+    record_transaction: "Posting transaction",
 };
-async function scanExecute(db, name, input, ctx) {
+async function accountExecute(db, name, input, ctx) {
     switch (name) {
         case "create_account": {
             if (ctx?.dryRun)
@@ -119,20 +117,48 @@ async function scanExecute(db, name, input, ctx) {
             if (!ACCOUNT_TYPES.includes(input.type)) {
                 return `Invalid type "${input.type}". Allowed: ${ACCOUNT_TYPES.join(", ")}.`;
             }
-            const bank = input.bank_name ? String(input.bank_name).toUpperCase() : null;
-            // Account writes serialize across concurrent scan agents so the next
-            // list_accounts call (from any agent) sees this row.
             return await runAccountExclusive(() => {
                 try {
-                    db.prepare(`INSERT INTO accounts (id, name, type, subtype, bank_name, account_number_masked, currency, due_day, statement_day, metadata_json)
-             VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(input.id, input.name, input.type, input.subtype || null, bank, input.account_number_masked || null, input.currency || "THB", input.due_day ?? null, input.statement_day ?? null, input.metadata ? JSON.stringify(input.metadata) : null);
+                    const create = () => {
+                        createAccount(db, {
+                            id: input.id,
+                            name: input.name,
+                            type: input.type,
+                            parent_id: input.parent_id ?? null,
+                            subtype: input.subtype ?? null,
+                            bank_name: input.bank_name ?? null,
+                            account_number_masked: input.account_number_masked ?? null,
+                            currency: input.currency,
+                            due_day: input.due_day ?? null,
+                            statement_day: input.statement_day ?? null,
+                            metadata: input.metadata ?? null,
+                        });
+                    };
+                    if (ctx?.correlationId) {
+                        const tx = db.transaction(() => {
+                            create();
+                            const row = findAccountById(db, input.id);
+                            appendAction(db, {
+                                correlation_id: ctx.correlationId,
+                                command: ctx.command ?? "record",
+                                user_input: ctx.userInput ?? null,
+                                action_type: "create_account",
+                                target_id: input.id,
+                                payload: { row },
+                            });
+                        });
+                        tx();
+                    }
+                    else {
+                        create();
+                    }
                     return `Account created: ${input.id} (${input.name}, ${input.type}).`;
                 }
                 catch (err) {
-                    if (String(err.message).includes("UNIQUE")) {
+                    if (err.code === "ACCOUNT_EXISTS") {
                         return `Account "${input.id}" already exists. Use update_account_metadata to modify it.`;
                     }
-                    throw err;
+                    return `Could not create account "${input.id}": ${err.message}`;
                 }
             });
         }
@@ -140,109 +166,199 @@ async function scanExecute(db, name, input, ctx) {
             if (ctx?.dryRun)
                 return `Would update metadata for ${input.account_id}: ${JSON.stringify(input)}`;
             return await runAccountExclusive(() => {
-                const acct = findAccountById(db, input.account_id);
-                if (!acct)
-                    return `Account "${input.account_id}" not found.`;
-                const updates = [];
-                const params = [];
-                if (input.due_day !== undefined) {
-                    updates.push("due_day = ?");
-                    params.push(input.due_day);
-                }
-                if (input.statement_day !== undefined) {
-                    updates.push("statement_day = ?");
-                    params.push(input.statement_day);
-                }
-                if (input.points_balance !== undefined) {
-                    updates.push("points_balance = ?");
-                    params.push(input.points_balance);
-                }
-                if (input.account_number_masked !== undefined) {
-                    updates.push("account_number_masked = ?");
-                    params.push(input.account_number_masked);
-                }
-                if (input.bank_name !== undefined) {
-                    updates.push("bank_name = ?");
-                    params.push(String(input.bank_name).toUpperCase());
+                try {
+                    let changed = false;
+                    const apply = () => {
+                        const result = updateAccountMetadata(db, input.account_id, {
+                            due_day: input.due_day,
+                            statement_day: input.statement_day,
+                            points_balance: input.points_balance,
+                            account_number_masked: input.account_number_masked,
+                            bank_name: input.bank_name,
+                            metadata: input.metadata,
+                        });
+                        changed = result.changed;
+                        return result;
+                    };
+                    if (ctx?.correlationId) {
+                        const tx = db.transaction(() => {
+                            const result = apply();
+                            if (!result.changed)
+                                return;
+                            appendAction(db, {
+                                correlation_id: ctx.correlationId,
+                                command: ctx.command ?? "record",
+                                user_input: ctx.userInput ?? null,
+                                action_type: "update_account_metadata",
+                                target_id: input.account_id,
+                                payload: { before: result.before, after: result.after },
+                            });
+                        });
+                        tx();
+                    }
+                    else {
+                        apply();
+                    }
+                    return changed ? `Updated ${input.account_id}.` : "Nothing to update.";
                 }
-                if (input.metadata) {
-                    const existing = acct.metadata_json ? JSON.parse(acct.metadata_json) : {};
-                    const merged = { ...existing, ...input.metadata };
-                    updates.push("metadata_json = ?");
-                    params.push(JSON.stringify(merged));
+                catch (err) {
+                    if (String(err.message).includes("not found")) {
+                        return `Account "${input.account_id}" not found.`;
+                    }
+                    throw err;
                 }
-                if (updates.length === 0)
-                    return "Nothing to update.";
-                params.push(input.account_id);
-                db.prepare(`UPDATE accounts SET ${updates.join(", ")} WHERE id = ?`).run(...params);
-                return `Updated ${input.account_id}.`;
             });
         }
-        case "record_journal_entry": {
+        case "record_transaction": {
             if (!ctx)
-                return "record_journal_entry is only available inside an agent session.";
+                return "record_transaction is only available inside an agent session.";
             if (ctx.dryRun)
-                return `Would post journal entry "${input.description}" on ${input.date}.`;
-            const entryInput = {
+                return `Would post transaction "${input.description}" on ${input.date}.`;
+            const txInput = {
                 date: input.date,
                 description: input.description,
                 source_file_id: ctx.fileId,
                 source_page: input.source_page ?? null,
-                lines: (input.lines || []).map((l) => ({
-                    account_id: l.account_id,
-                    debit: l.debit ?? 0,
-                    credit: l.credit ?? 0,
-                    currency: l.currency || "THB",
-                    memo: l.memo ?? null,
+                raw_descriptor: input.raw_descriptor ?? null,
+                merchant: input.merchant ?? null,
+                merchant_id: input.merchant_id ?? null,
+                postings: (input.postings || []).map((p) => ({
+                    account_id: p.account_id,
+                    debit: p.debit ?? 0,
+                    credit: p.credit ?? 0,
+                    currency: p.currency || "THB",
+                    memo: p.memo ?? null,
                 })),
             };
             try {
-                const entryId = ctx.buffer
-                    ? ctx.buffer.appendEntry(entryInput)
-                    : recordJournalEntry(db, entryInput);
-                return `Posted journal entry ${entryId} (${input.date}).`;
+                let transactionId;
+                if (ctx.buffer) {
+                    transactionId = ctx.buffer.appendTransaction(txInput);
+                }
+                else if (ctx.correlationId) {
+                    const validated = validateTransaction(txInput);
+                    const tx = db.transaction(() => {
+                        insertTransactionRows(db, validated);
+                        appendAction(db, {
+                            correlation_id: ctx.correlationId,
+                            command: ctx.command ?? "record",
+                            user_input: ctx.userInput ?? null,
+                            action_type: "record_transaction",
+                            target_id: validated.id,
+                            payload: {
+                                transaction: {
+                                    date: validated.date,
+                                    description: validated.description,
+                                    source_page: validated.source_page ?? null,
+                                    raw_descriptor: validated.raw_descriptor ?? null,
+                                },
+                                postings: validated.postings,
+                            },
+                        });
+                    });
+                    tx();
+                    transactionId = validated.id;
+                }
+                else {
+                    transactionId = recordTransaction(db, txInput);
+                }
+                return `Posted transaction ${transactionId} (${input.date}).`;
             }
             catch (err) {
-                return `Could not post journal entry: ${err.message}`;
+                return `Could not post transaction: ${err.message}`;
             }
         }
-        case "note_concern": {
-            if (!ctx)
-                return "note_concern is only available inside an agent session.";
-            const target = {
-                entry_id: input.entry_id ?? null,
-                account_id: input.account_id ?? null,
-            };
-            if (ctx.buffer) {
-                ctx.buffer.appendConcern({ ...target, prompt: input.prompt, options: input.options });
-                return `Concern noted (buffered). Continue with the next row.`;
-            }
-            const id = recordConcern(db, {
-                file_id: ctx.fileId ?? null,
-                entry_id: target.entry_id,
-                account_id: target.account_id,
-                prompt: input.prompt,
-                options: input.options,
-            });
-            return `Concern noted (${id}). Continue with the next row.`;
-        }
         default:
             return undefined;
     }
 }
-export const scanIngestTools = {
-    DEFS: SCAN_DEFS,
-    LABELS: SCAN_LABELS,
-    execute: scanExecute,
+export const accountIngestTools = {
+    DEFS: ACCOUNT_DEFS,
+    LABELS: ACCOUNT_LABELS,
+    execute: accountExecute,
+};
+/**
+ * Scan-only concerns
+ *
+ * `note_concern` records a clarification mid-scan without ever prompting the
+ * user — only scan needs this. Record uses `clarify` (transient prompt, no
+ * concerns-table residue); review uses `ask_user` (prompts and resolves).
+ */
+const CONCERN_DEFS = [
+    {
+        name: "note_concern",
+        description: "Record a clarification request without pausing the run. Use during scan when a row is ambiguous (post your best-guess transaction first, then call this with the transaction's id), when a row is unparseable (skip the transaction, call this with no transaction_id), or when you have a concern about an account itself (pass account_id). Use kind='uncategorized_expense' when posting an expense to expense:uncategorized so reviewer can group these. The reviewer picks these up later with the full picture.",
+        input_schema: {
+            type: "object",
+            properties: {
+                prompt: {
+                    type: "string",
+                    description: "The question or concern in a complete sentence, with date, ฿-formatted amount, and human account names. Never reference internal ids.",
+                },
+                kind: {
+                    type: "string",
+                    description: "Optional category for the concern. Use 'uncategorized_expense' when the posting landed in expense:uncategorized; reviewer batches these into one cleanup pass.",
+                },
+                options: {
+                    type: "array",
+                    description: "Optional list of candidate answers the reviewer can offer the user.",
+                    items: { type: "string" },
+                },
+                transaction_id: {
+                    type: "string",
+                    description: "Id of the transaction this concern relates to (returned by record_transaction). Omit for file-level concerns about an unparseable row.",
+                },
+                account_id: {
+                    type: "string",
+                    description: "Id of the account this concern relates to. Set when the statement's bank name, currency, statement_day, due_day, or other metadata disagrees with the stored account, or when you suspect a new account you're about to create duplicates an existing one. Can be combined with transaction_id.",
+                },
+            },
+            required: ["prompt"],
+        },
+    },
+];
+const CONCERN_LABELS = {
+    note_concern: "Noting concern",
+};
+async function concernExecute(db, name, input, ctx) {
+    if (name !== "note_concern")
+        return undefined;
+    if (!ctx)
+        return "note_concern is only available inside an agent session.";
+    const target = {
+        transaction_id: input.transaction_id ?? null,
+        account_id: input.account_id ?? null,
+    };
+    if (ctx.buffer) {
+        ctx.buffer.appendConcern({ ...target, kind: input.kind ?? null, prompt: input.prompt, options: input.options });
+        return `Concern noted (buffered). Continue with the next row.`;
+    }
+    const id = recordConcern(db, {
+        file_id: ctx.fileId ?? null,
+        transaction_id: target.transaction_id,
+        account_id: target.account_id,
+        kind: input.kind ?? null,
+        prompt: input.prompt,
+        options: input.options,
+    });
+    return `Concern noted (${id}). Continue with the next row.`;
+}
+export const scanConcernTools = {
+    DEFS: CONCERN_DEFS,
+    LABELS: CONCERN_LABELS,
+    execute: concernExecute,
 };
-// ── Review-only tool definitions ────────────────────────────────────────────
-// `ask_user` is the only interactive primitive. Scan never reaches it (the
-// scan profile doesn't include this module), so we don't need a "scan, please
-// don't use this" guard.
+/**
+ * Review-only tool definitions
+ *
+ * `ask_user` is the only interactive primitive. Scan never reaches it (the
+ * scan profile doesn't include this module), so we don't need a "scan, please
+ * don't use this" guard.
+ */
 const REVIEW_DEFS = [
     {
         name: "ask_user",
-        description: "Ask the user a clarifying question when you cannot confidently proceed. The pipeline pauses and prompts the user interactively. Available during `plasalid review`. Not exposed during `plasalid scan` — use `note_concern` instead. Pass `entry_id` / `account_id` to attach the question to the same target as a scan-noted concern. Pass `concern_id` to resolve an existing open concern in place (recommended when re-posing a scan-noted concern to the user). Pass `related_concern_ids` to apply the user's single answer to a whole group of sibling concerns at once.",
+        description: "Ask the user a clarifying question when you cannot confidently proceed. The pipeline pauses and prompts the user interactively. Available during `plasalid review`. Not exposed during `plasalid scan` — use `note_concern` instead. Pass `transaction_id` / `account_id` to attach the question to the same target as a scan-noted concern. Pass `concern_id` to resolve an existing open concern in place (recommended when re-posing a scan-noted concern to the user). Pass `related_concern_ids` to apply the user's single answer to a whole group of sibling concerns at once.",
         input_schema: {
             type: "object",
             properties: {
@@ -252,9 +368,9 @@ const REVIEW_DEFS = [
                     description: "Optional list of candidate answers.",
                     items: { type: "string" },
                 },
-                entry_id: {
+                transaction_id: {
                     type: "string",
-                    description: "Optional: journal entry this question is about. Used to clear the entry's has_concern flag once all its concerns close.",
+                    description: "Optional: transaction this question is about. Used to clear the transaction's has_concern flag once all its concerns close.",
                 },
                 account_id: {
                     type: "string",
@@ -296,8 +412,6 @@ async function reviewExecute(db, name, input, ctx) {
         return undefined;
     if (!ctx)
         return "ask_user is only available inside an agent session.";
-    // Two modes: resolve an existing concern in place (concern_id supplied),
-    // or post a fresh question that becomes its own concerns row.
     let id;
     if (input.concern_id) {
         id = String(input.concern_id);
@@ -307,7 +421,7 @@ async function reviewExecute(db, name, input, ctx) {
     else {
         id = recordConcern(db, {
             file_id: ctx.fileId ?? null,
-            entry_id: input.entry_id ?? null,
+            transaction_id: input.transaction_id ?? null,
             account_id: input.account_id ?? null,
             prompt: input.prompt,
             options: input.options,
@@ -316,9 +430,6 @@ async function reviewExecute(db, name, input, ctx) {
     if (ctx.interactive && ctx.promptUser) {
         const answer = await ctx.promptUser(input.prompt, input.options, input.facts);
         resolveConcern(db, id, answer);
-        // Propagate the same answer to every sibling in the group so the user
-        // isn't asked the same thing again. Skip the primary id if the agent
-        // happened to include it.
         const siblings = Array.isArray(input.related_concern_ids) ? input.related_concern_ids : [];
         let propagated = 0;
         for (const sibId of siblings) {

package/dist/ai/tools/merchants.d.ts

@@ -0,0 +1,2 @@
+import type { ToolModule } from "./types.js";
+export declare const merchantTools: ToolModule;