@wirecat/cli-core 0.550.0 → 0.551.0

package/dist/domain/status-words.js

@@ -0,0 +1,44 @@
+/**
+ * Word patterns for project status, ru/en/es, matched on the text as written (case folded here). A stem cannot tell
+ * `оплатил` from `оплати`, so the past forms a money stem shares with a request are listed whole: a message with one
+ * of them reads as "done", whatever stems it also hits.
+ */
+const words = (forms) => new RegExp(`(?<![\\p{L}\\p{N}])(?:${forms.join("|")})(?![\\p{L}\\p{N}])`, "iu");
+export const MONEY_DONE_FORMS = words([
+    "оплатил[аи]?",
+    "заплатил[аи]?",
+    "перевел[аи]?",
+    "перевёл",
+    "отправил[аи]?",
+    "оплачено",
+    "переведено",
+    "paid",
+    "transferred",
+    "pagué",
+    "pagado",
+    "transferí",
+]);
+/** First person future: "I'll send", "сделаю", "lo envío". Labelled a guess wherever it is shown. */
+export const PROMISE_FORMS = words([
+    "сделаю",
+    "пришлю",
+    "отправлю",
+    "подготовлю",
+    "проверю",
+    "напишу",
+    "позвоню",
+    "скину",
+    "вышлю",
+    "оплачу",
+    "будет готов[аоы]?",
+    "i'?ll (?:send|do|check|call|write|pay|prepare|share|fix)",
+    "i will (?:send|do|check|call|write|pay|prepare|share|fix)",
+    "will be ready",
+    "lo envío",
+    "te envío",
+    "enviaré",
+    "haré",
+    "mandaré",
+    "te llamo",
+    "estará listo",
+]);

package/dist/entities/fact.d.ts

@@ -2,7 +2,7 @@ import * as v from "valibot";
 export declare const fact: v.StrictObjectSchema<{
     readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
-    readonly kind: v.PicklistSchema<readonly ["fact", "statement", "question", "decision", "promise"], undefined>;
+    readonly kind: v.PicklistSchema<readonly ["fact", "statement", "question", "decision", "promise", "payment"], undefined>;
     readonly text: v.StringSchema<undefined>;
     readonly status: v.PicklistSchema<readonly ["proposed", "accepted", "superseded", "reversed", "rejected"], undefined>;
     readonly project: v.NullableSchema<v.StringSchema<undefined>, undefined>;
@@ -29,6 +29,17 @@ export declare const fact: v.StrictObjectSchema<{
     /** Who recorded it: the owner, or an agent whose fact waits as proposed. */
     readonly origin: v.PicklistSchema<["owner", "agent"], undefined>;
     readonly evidence: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+    /** A `payment` fact's fields. */
+    readonly payment: v.OptionalSchema<v.NullableSchema<v.StrictObjectSchema<{
+        readonly amount: v.StringSchema<undefined>;
+        readonly currency: v.StringSchema<undefined>;
+        readonly direction: v.PicklistSchema<readonly ["to_us", "from_us"], undefined>;
+        readonly counterparty: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly counterparty_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly due_at: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly state: v.PicklistSchema<readonly ["expected", "paid", "cancelled"], undefined>;
+        readonly item: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
     /** With `--sources`: each piece of evidence read back. */
     readonly sources: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
         readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;

package/dist/entities/fact.js

@@ -1,6 +1,17 @@
 import * as v from "valibot";
 import { FACT_STATUSES, FACT_TYPES, MEMORY_SCOPES } from "../domain/knowledge.js";
+import { PAYMENT_DIRECTIONS, PAYMENT_STATES } from "../meetings/index.js";
 import { author, evidenceSource, id, reference, text, time } from "./fields.js";
+const payment = v.strictObject({
+    amount: text,
+    currency: text,
+    direction: v.picklist(PAYMENT_DIRECTIONS),
+    counterparty: v.nullable(reference),
+    counterparty_name: v.nullable(text),
+    due_at: v.nullable(text),
+    state: v.picklist(PAYMENT_STATES),
+    item: v.nullable(text),
+});
 export const fact = v.strictObject({
     ref: reference,
     id,
@@ -24,6 +35,8 @@ export const fact = v.strictObject({
     /** Who recorded it: the owner, or an agent whose fact waits as proposed. */
     origin: v.picklist(["owner", "agent"]),
     evidence: v.array(reference),
+    /** A `payment` fact's fields. */
+    payment: v.optional(v.nullable(payment)),
     /** With `--sources`: each piece of evidence read back. */
     sources: v.optional(v.array(evidenceSource)),
     created_at: time,

package/dist/entities/index.d.ts

@@ -1099,6 +1099,7 @@ export declare const ENTITIES: {
         readonly reached_since: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
         readonly reached_last: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
         readonly stopped: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly limited: v.OptionalSchema<v.PicklistSchema<["group_too_large", "older_than_window"], undefined>, undefined>;
         readonly tasks: v.OptionalSchema<v.StrictObjectSchema<{
             readonly added: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
             readonly closed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -1145,6 +1146,11 @@ export declare const ENTITIES: {
                 readonly retryable: v.BooleanSchema<undefined>;
                 readonly retry_after_ms: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
             }, v.UnknownSchema, undefined>, undefined>;
+            readonly limited: v.OptionalSchema<v.PicklistSchema<["group_too_large", "older_than_window"], undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly limited: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly group_too_large: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly older_than_window: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         }, undefined>, undefined>;
         readonly tasks: v.OptionalSchema<v.StrictObjectSchema<{
             readonly added: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -5448,7 +5454,7 @@ export declare const ENTITIES: {
     readonly fact: v.StrictObjectSchema<{
         readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
-        readonly kind: v.PicklistSchema<readonly ["fact", "statement", "question", "decision", "promise"], undefined>;
+        readonly kind: v.PicklistSchema<readonly ["fact", "statement", "question", "decision", "promise", "payment"], undefined>;
         readonly text: v.StringSchema<undefined>;
         readonly status: v.PicklistSchema<readonly ["proposed", "accepted", "superseded", "reversed", "rejected"], undefined>;
         readonly project: v.NullableSchema<v.StringSchema<undefined>, undefined>;
@@ -5471,6 +5477,16 @@ export declare const ENTITIES: {
         readonly scope: v.NullableSchema<v.PicklistSchema<readonly ["personal", "work"], undefined>, undefined>;
         readonly origin: v.PicklistSchema<["owner", "agent"], undefined>;
         readonly evidence: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly payment: v.OptionalSchema<v.NullableSchema<v.StrictObjectSchema<{
+            readonly amount: v.StringSchema<undefined>;
+            readonly currency: v.StringSchema<undefined>;
+            readonly direction: v.PicklistSchema<readonly ["to_us", "from_us"], undefined>;
+            readonly counterparty: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            readonly counterparty_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly due_at: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly state: v.PicklistSchema<readonly ["expected", "paid", "cancelled"], undefined>;
+            readonly item: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly sources: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
             readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
             readonly kind: v.StringSchema<undefined>;
@@ -6257,7 +6273,7 @@ export declare const ENTITIES: {
                     readonly fingerprint: v.StringSchema<undefined>;
                 }, undefined>, undefined>;
                 readonly kind: v.LiteralSchema<"fact", undefined>;
-                readonly type: v.PicklistSchema<readonly ["fact", "statement", "question", "decision", "promise"], undefined>;
+                readonly type: v.PicklistSchema<readonly ["fact", "statement", "question", "decision", "promise", "payment"], undefined>;
                 readonly statement: v.StringSchema<undefined>;
             }, undefined>, v.StrictObjectSchema<{
                 readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;

package/dist/entities/meeting-findings.d.ts

@@ -17,7 +17,7 @@ export declare const meetingFindings: v.StrictObjectSchema<{
                 readonly fingerprint: v.StringSchema<undefined>;
             }, undefined>, undefined>;
             readonly kind: v.LiteralSchema<"fact", undefined>;
-            readonly type: v.PicklistSchema<readonly ["fact", "statement", "question", "decision", "promise"], undefined>;
+            readonly type: v.PicklistSchema<readonly ["fact", "statement", "question", "decision", "promise", "payment"], undefined>;
             readonly statement: v.StringSchema<undefined>;
         }, undefined>, v.StrictObjectSchema<{
             readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;

package/dist/entities/message-transfer.d.ts

@@ -202,6 +202,8 @@ export declare const messageSyncChat: v.StrictObjectSchema<{
     readonly reached_since: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
     readonly reached_last: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
     readonly stopped: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+    /** The history limits stopped the read: a group too large to read, or the window's start reached. */
+    readonly limited: v.OptionalSchema<v.PicklistSchema<["group_too_large", "older_than_window"], undefined>, undefined>;
     readonly tasks: v.OptionalSchema<v.StrictObjectSchema<{
         readonly added: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         readonly closed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -250,6 +252,12 @@ export declare const messageSyncAll: v.StrictObjectSchema<{
             readonly retryable: v.BooleanSchema<undefined>;
             readonly retry_after_ms: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
         }, v.UnknownSchema, undefined>, undefined>;
+        readonly limited: v.OptionalSchema<v.PicklistSchema<["group_too_large", "older_than_window"], undefined>, undefined>;
+    }, undefined>, undefined>;
+    /** How many chats the history limits left unread (big groups) or read only to the window's start. */
+    readonly limited: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly group_too_large: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly older_than_window: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
     }, undefined>, undefined>;
     readonly tasks: v.OptionalSchema<v.StrictObjectSchema<{
         readonly added: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -328,6 +336,8 @@ export declare const messageSync: v.UnionSchema<[v.StrictObjectSchema<{
     readonly reached_since: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
     readonly reached_last: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
     readonly stopped: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+    /** The history limits stopped the read: a group too large to read, or the window's start reached. */
+    readonly limited: v.OptionalSchema<v.PicklistSchema<["group_too_large", "older_than_window"], undefined>, undefined>;
     readonly tasks: v.OptionalSchema<v.StrictObjectSchema<{
         readonly added: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         readonly closed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -375,6 +385,12 @@ export declare const messageSync: v.UnionSchema<[v.StrictObjectSchema<{
             readonly retryable: v.BooleanSchema<undefined>;
             readonly retry_after_ms: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
         }, v.UnknownSchema, undefined>, undefined>;
+        readonly limited: v.OptionalSchema<v.PicklistSchema<["group_too_large", "older_than_window"], undefined>, undefined>;
+    }, undefined>, undefined>;
+    /** How many chats the history limits left unread (big groups) or read only to the window's start. */
+    readonly limited: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly group_too_large: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly older_than_window: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
     }, undefined>, undefined>;
     readonly tasks: v.OptionalSchema<v.StrictObjectSchema<{
         readonly added: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;

package/dist/entities/message-transfer.js

@@ -46,6 +46,7 @@ const tasks = v.optional(v.strictObject({
     held: v.optional(count),
     held_chats: v.optional(count),
 }));
+const historyLimited = v.picklist(["group_too_large", "older_than_window"]);
 export const messageSyncChat = v.strictObject({
     issue: v.optional(actionableError),
     resume: v.optional(v.strictObject({ before: v.optional(text) })),
@@ -59,6 +60,8 @@ export const messageSyncChat = v.strictObject({
     reached_since: v.optional(v.literal(true)),
     reached_last: v.optional(v.literal(true)),
     stopped: v.optional(v.literal(true)),
+    /** The history limits stopped the read: a group too large to read, or the window's start reached. */
+    limited: v.optional(historyLimited),
     tasks,
     /** `--full-history`: the chat's pushed history is now kept in full; `false` when the store does not know the chat. */
     history_included: v.optional(v.boolean()),
@@ -78,7 +81,10 @@ export const messageSyncAll = v.strictObject({
         stopped: v.optional(v.literal(true)),
         error: v.optional(text),
         issue: v.optional(actionableError),
+        limited: v.optional(historyLimited),
     })),
+    /** How many chats the history limits left unread (big groups) or read only to the window's start. */
+    limited: v.optional(v.strictObject({ group_too_large: count, older_than_window: count })),
     tasks,
 });
 export const messageSyncStarted = v.strictObject({ job: id, pid: count, chat: text, log: text });

package/dist/mcp/app-server.js

@@ -144,6 +144,7 @@ export const serveAppOverHttp = async (command, context, options, http) => {
     const listening = await serveOverHttp(build, {
         ...http,
         appName: app.command,
+        reaches: `your ${options.name}`,
         onCode: (code, expires) => context.renderer.note(context.env[mcpHttpMarker(app.envPrefix)] === undefined
             ? `login code for a new browser app: ${code} (until ${expires.toTimeString().slice(0, 5)}; a new one after each login)`
             : `a new login code for a browser app: \`${app.command} ${context.settings.profile} mcp server status\``),

package/dist/mcp/http/oauth.d.ts

@@ -14,11 +14,12 @@ export interface OwnerLogin {
  * the browser apps need dynamic registration — but nobody gets a token without the one-time code
  * printed in the owner's terminal. Five wrong codes delay further attempts for thirty seconds.
  */
-export declare const ownerLogin: ({ issuer, resource, file, appName, onCode, now, }: {
+export declare const ownerLogin: ({ issuer, resource, file, appName, reaches, onCode, now, }: {
     issuer: URL;
     resource: URL;
     file: string;
     appName: string;
+    reaches?: string;
     /** The code for the next login, for the owner's eyes only: their terminal, or the server's status file. */
     onCode: (code: string, expires: Date) => void;
     now?: () => number;

package/dist/mcp/http/oauth.js

@@ -51,7 +51,7 @@ const redirectAllowed = (uri) => {
  * the browser apps need dynamic registration — but nobody gets a token without the one-time code
  * printed in the owner's terminal. Five wrong codes delay further attempts for thirty seconds.
  */
-export const ownerLogin = ({ issuer, resource, file, appName, onCode, now = () => Date.now(), }) => {
+export const ownerLogin = ({ issuer, resource, file, appName, reaches = `your ${appName} data`, onCode, now = () => Date.now(), }) => {
     const store = tokenFile(file);
     const codes = new Map();
     let login = { value: "", expires: 0 };
@@ -153,7 +153,7 @@ export const ownerLogin = ({ issuer, resource, file, appName, onCode, now = () =
             .join("");
         const who = escapeHtml(client.name ?? "an application");
         const target = new URL(params.get("redirect_uri") ?? "");
-        const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escapeHtml(appName)} login</title><style>body{font:16px system-ui,sans-serif;max-width:28rem;margin:3rem auto;padding:0 1rem;color:#1d2430}input[type=text]{font:20px ui-monospace,monospace;letter-spacing:.1em;width:100%;padding:.5rem;margin:.5rem 0 1rem;box-sizing:border-box}button{font:inherit;padding:.5rem 1rem}.error{color:#b42318}</style></head><body><h1>${escapeHtml(appName)}</h1><p>An app that calls itself <strong>${who}</strong> asks to reach your messages through <code>${escapeHtml(appName)} mcp --http</code>.</p><p>After you allow it, the login goes to <strong>${escapeHtml(target.host)}</strong>. Allow only if that is the app you are connecting, such as chatgpt.com or claude.ai.</p><p>Type the code shown in WireCat Desktop, or in the terminal where the server runs. If you did not start this login, close this page.</p>${message ? `<p class="error">${escapeHtml(message)}</p>` : ""}<form method="post" action="${escapeHtml(`${base}/authorize`)}">${hidden}<label>Login code<input type="text" name="login_code" autocomplete="off" autofocus required></label><button type="submit">Allow</button></form></body></html>`;
+        const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escapeHtml(appName)} login</title><style>body{font:16px system-ui,sans-serif;max-width:28rem;margin:3rem auto;padding:0 1rem;color:#1d2430}input[type=text]{font:20px ui-monospace,monospace;letter-spacing:.1em;width:100%;padding:.5rem;margin:.5rem 0 1rem;box-sizing:border-box}button{font:inherit;padding:.5rem 1rem}.error{color:#b42318}</style></head><body><h1>${escapeHtml(appName)}</h1><p>An app that calls itself <strong>${who}</strong> asks to reach ${escapeHtml(reaches)} through <code>${escapeHtml(appName)} mcp serve --http</code>.</p><p>After you allow it, the login goes to <strong>${escapeHtml(target.host)}</strong>. Allow only if that is the app you are connecting, such as chatgpt.com or claude.ai.</p><p>Type the code shown in WireCat Desktop, or in the terminal where the server runs. If you did not start this login, close this page.</p>${message ? `<p class="error">${escapeHtml(message)}</p>` : ""}<form method="post" action="${escapeHtml(`${base}/authorize`)}">${hidden}<label>Login code<input type="text" name="login_code" autocomplete="off" autofocus required></label><button type="submit">Allow</button></form></body></html>`;
         return new Response(html, {
             status: message ? 400 : 200,
             headers: {

package/dist/mcp/http/serve.d.ts

@@ -13,6 +13,8 @@ export interface HttpOptions {
     /** Where the hashes of issued tokens and registered clients are kept. */
     tokenFile: string;
     appName: string;
+    /** What the browser login page says an app asks to reach: `your messages`, `your Google Calendar`. */
+    reaches?: string;
     onCode: (code: string, expires: Date) => void;
     onError?: (error: Error) => void;
     now?: () => number;

package/dist/mcp/http/serve.js

@@ -91,7 +91,7 @@ const toolsIn = async (request) => {
  * the owner's browser cannot reach the port through a rebound DNS name.
  */
 export const serveOverHttp = async (build, options) => {
-    const { publicUrl, port, tokenFile, appName, onCode, onError, now, lockFile, version } = options;
+    const { publicUrl, port, tokenFile, appName, reaches, onCode, onError, now, lockFile, version } = options;
     const lock = lockFile
         ? httpLock(lockFile, {
             pid: process.pid,
@@ -114,6 +114,7 @@ export const serveOverHttp = async (build, options) => {
         resource,
         file: tokenFile,
         appName,
+        ...(reaches ? { reaches } : {}),
         onCode: (code, expires) => {
             lock?.update({ loginCode: code, loginCodeExpiresAt: expires.toISOString() });
             onCode(code, expires);

package/dist/mcp/server.js

@@ -417,6 +417,7 @@ export const serveOverHttpUntilStopped = async (command, context, messenger, opt
     const listening = await serveOverHttp(build, {
         ...http,
         appName,
+        reaches: "your messages",
         // In the background its log is a file; the code goes only to the lock that `mcp server status` reads.
         onCode: (code, expires) => context.renderer.note(context.env[mcpHttpMarker(appEnvPrefix)] === undefined
             ? `login code for a new browser app: ${code} (until ${expires.toTimeString().slice(0, 5)}; a new one after each login)`

package/dist/mcp/surface.js

@@ -46,7 +46,7 @@ const runnableOnly = (result, offered) => {
     const body = result.structuredContent;
     if (result.isError || !Array.isArray(body?.next))
         return result;
-    const next = body.next.filter((step) => offered(step.command));
+    const next = body.next.filter((step) => step.command === undefined || offered(step.command));
     const { next: _, ...rest } = body;
     const kept = next.length > 0 ? { ...rest, next } : rest;
     return {

package/dist/meetings/findings-rules.d.ts

@@ -1,4 +1,4 @@
-import { MEETING_FACT_TYPES as FACT_TYPES } from "./meeting-context.js";
+import { FACT_TYPES, type Payment } from "./payment.js";
 declare const TASK_TYPES: readonly ["bug", "feature", "chore"];
 export interface FindingEvidence {
     reference: string;
@@ -14,9 +14,18 @@ interface FindingBase {
 }
 export interface FactFinding extends FindingBase {
     kind: "fact";
-    type: (typeof FACT_TYPES)[number];
+    type: Exclude<(typeof FACT_TYPES)[number], "payment">;
     statement: string;
 }
+/** A payment an agent read; confirming it records a `payment` fact. A paid one supersedes the expected one. */
+export interface PaymentFinding extends FindingBase {
+    kind: "payment";
+    /** The fact's full sentence; without one, the payment's title. */
+    statement?: string;
+    payment: Payment;
+    /** The `fact:` of the expected payment this one replaces, once it is paid or cancelled. */
+    supersedes?: string;
+}
 export interface TaskFinding extends FindingBase {
     kind: "task";
     type: (typeof TASK_TYPES)[number];
@@ -28,7 +37,7 @@ export interface TaskFinding extends FindingBase {
     assignee?: string;
     assigneeEvidence?: string[];
 }
-export type Finding = FactFinding | TaskFinding;
+export type Finding = FactFinding | TaskFinding | PaymentFinding;
 export interface FindingsInput {
     schemaVersion: 1;
     key: string;
@@ -59,6 +68,8 @@ export interface FindingsRules {
     reference: (raw: string) => string;
     /** A fact finding may name no project, and any finding may name a subject. */
     anySubject?: boolean;
+    /** Payment findings are staged on a project's evidence, not from a meeting. */
+    payments?: boolean;
 }
 export declare const validateFindings: (input: FindingsInput, rules: FindingsRules) => FindingsInput;
 export declare const findingFingerprint: ({ id: _id, ...finding }: Finding) => string;

package/dist/meetings/findings-rules.js

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
 import { CliError } from "@wirecat/cli-base";
-import { MEETING_FACT_TYPES as FACT_TYPES } from "./meeting-context.js";
+import { FACT_TYPES, validatePayment } from "./payment.js";
 import { meetingTimestamp } from "./timestamp.js";
 const TASK_TYPES = ["bug", "feature", "chore"];
 const invalid = (message) => {
@@ -69,12 +69,26 @@ export const validateFindings = (input, rules) => {
         };
         if (finding.kind === "fact") {
             fields(finding, ["id", "project", "subject", "evidence", "kind", "type", "statement"], rules.singular);
+            if (finding.type === "payment")
+                return invalid("a payment is a finding of kind payment");
             if (!FACT_TYPES.includes(finding.type))
                 return invalid("unknown fact finding type");
             return { ...base, kind: "fact", type: finding.type, statement: text(finding.statement, 2000) };
         }
+        if (finding.kind === "payment" && rules.payments) {
+            fields(finding, ["id", "project", "subject", "evidence", "kind", "statement", "payment", "supersedes"], rules.singular);
+            if (finding.supersedes !== undefined && !/^fact:[1-9]\d*$/.test(String(finding.supersedes)))
+                return invalid("a payment finding supersedes a fact: reference");
+            return {
+                ...base,
+                kind: "payment",
+                ...(finding.statement === undefined ? {} : { statement: text(finding.statement, 2000) }),
+                payment: validatePayment(finding.payment),
+                ...(finding.supersedes === undefined ? {} : { supersedes: finding.supersedes }),
+            };
+        }
         if (finding.kind !== "task")
-            return invalid("a finding is a fact or task");
+            return invalid(`a finding is a fact${rules.payments ? ", payment" : ""} or task`);
         fields(finding, [
             "id",
             "project",

package/dist/meetings/index.d.ts

@@ -9,17 +9,18 @@ export { entryInWindow, eventChange } from "./event-store.js";
 export { linkEvent } from "./events.js";
 export { exportMeeting, type MeetingExport, type MeetingExportFormat, type MeetingExportOptions, serializeVtt, } from "./export.js";
 export { type FindingEvidence, type FindingOutcome, findingHash, MEETING_FINDINGS_KIND, type MeetingFactFinding, type MeetingFinding, type MeetingFindingsInput, type MeetingFindingsReceipt, type MeetingTaskFinding, meetingFindingFingerprint, validateMeetingFindings, } from "./findings.js";
-export { type Finding, type FindingsInput, type FindingsReceipt, type FindingsRules, findingFingerprint, validateFindings, } from "./findings-rules.js";
+export { type Finding, type FindingsInput, type FindingsReceipt, type FindingsRules, findingFingerprint, type PaymentFinding, validateFindings, } from "./findings-rules.js";
 export { liftMeetingFields, MEETING_HIT_QUERY, meetingWordsQuery, parseMeetingQuery } from "./hit-query.js";
 export { type ImportFile, importFiles } from "./import.js";
 export { MEETING_ISSUES, MEETING_QUERY, type MeetingIssue, type MeetingItem, type MeetingOwner, meeting, meetingIssuesOf, meetingItem, } from "./item.js";
 export { joinKeyOf, joinUrlWithoutQuery } from "./join-key.js";
 export { CHAT_MESSAGES_READ, type MeetingChatLine, type MeetingChatLinesInput, type MeetingChatLinesStore, type MeetingLink, } from "./links.js";
-export { createMeetingContext, MEETING_FACT_TYPES, type MeetingContextAction, type MeetingContextChange, type MeetingContextOperation, type MeetingContextPorts, type MeetingContextReceipt, validateMeetingContextChange, } from "./meeting-context.js";
+export { createMeetingContext, type MeetingContextAction, type MeetingContextChange, type MeetingContextOperation, type MeetingContextPorts, type MeetingContextReceipt, validateMeetingContextChange, } from "./meeting-context.js";
 export { createMeetingManagement, dispatchMeetingMutation, type ManagedMeeting, type ManagedMeetingChange, type MeetingManagement, type MeetingManagementPorts, type MeetingMutationOptions, type MeetingMutationProposal, type MeetingMutationReceipt, type MeetingOperationOptions, type MeetingProviderContext, validateMeetingChange, } from "./meeting-management.js";
 export type { Attachment, ChatLine, Event, EventSeries, JsonValue, Meeting, MeetingSeries, Metadata, Occurrence, Participant, RecordTimes, SourceChatLine, SourceMeeting, Summary, SummaryContent, Transcript, TranscriptLine, TranscriptRow, } from "./model.js";
 export { type MeetingParticipantCandidate, type MeetingParticipantPage, type MeetingParticipantReader, type MeetingParticipantSearchOptions, type MeetingParticipantSearchStore, normalizeMeetingParticipantQuery, validateMeetingParticipantSearch, } from "./participant-search.js";
 export { type MeetingContextCue, type MeetingHitContextOptions, type MeetingHitContextPacket, type MeetingPassageOutputFormat, type MeetingPassageReader, type MeetingPassageRequest, type MeetingPassageResult, meetingHitContextLimits, validateMeetingPassage, } from "./passage.js";
+export { FACT_TYPES, PAYMENT_DIRECTIONS, PAYMENT_STATES, type Payment, paymentTitle, validatePayment, } from "./payment.js";
 export { type MeetingPreparationContext, type MeetingPreparationContextRequest, type MeetingPreparationContextStore, type PreparationPage, validateMeetingPreparationContext, } from "./preparation-context.js";
 export type { MeetingPreparationFact, MeetingPreparationKnowledgeRequest, MeetingPreparationKnowledgeStore, } from "./preparation-knowledge.js";
 export type { MeetingPreparationNote, MeetingPreparationNotesSelection, MeetingPreparationNotesStore, } from "./preparation-notes.js";

package/dist/meetings/index.js

@@ -12,10 +12,11 @@ export { importFiles } from "./import.js";
 export { MEETING_ISSUES, MEETING_QUERY, meeting, meetingIssuesOf, meetingItem, } from "./item.js";
 export { joinKeyOf, joinUrlWithoutQuery } from "./join-key.js";
 export { CHAT_MESSAGES_READ, } from "./links.js";
-export { createMeetingContext, MEETING_FACT_TYPES, validateMeetingContextChange, } from "./meeting-context.js";
+export { createMeetingContext, validateMeetingContextChange, } from "./meeting-context.js";
 export { createMeetingManagement, dispatchMeetingMutation, validateMeetingChange, } from "./meeting-management.js";
 export { normalizeMeetingParticipantQuery, validateMeetingParticipantSearch, } from "./participant-search.js";
 export { meetingHitContextLimits, validateMeetingPassage, } from "./passage.js";
+export { FACT_TYPES, PAYMENT_DIRECTIONS, PAYMENT_STATES, paymentTitle, validatePayment, } from "./payment.js";
 export { validateMeetingPreparationContext, } from "./preparation-context.js";
 export { readMeetingProjectEvidence } from "./project-evidence.js";
 export { meetingProjectEvidence, meetingProjectEvidenceAnswer, } from "./project-evidence-answer.js";

package/dist/meetings/meeting-context.d.ts

@@ -1,7 +1,6 @@
 import { type MeetingMutationOptions } from "./meeting-management.js";
+import { FACT_TYPES } from "./payment.js";
 import { type MeetingProviderScope } from "./provider.js";
-/** Mirrors the store's fact types; the store checks the type again when it writes. */
-export declare const MEETING_FACT_TYPES: readonly ["fact", "statement", "question", "decision", "promise"];
 export type MeetingContextChange = {
     action: "note.add";
     text: string;
@@ -19,7 +18,7 @@ export type MeetingContextChange = {
 } | {
     action: "fact.add";
     statement: string;
-    type: (typeof MEETING_FACT_TYPES)[number];
+    type: (typeof FACT_TYPES)[number];
     scope: "personal" | "work";
     evidence: readonly string[];
     subject?: string;

package/dist/meetings/meeting-context.js

@@ -1,8 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import { dispatchMeetingMutation } from "./meeting-management.js";
+import { FACT_TYPES } from "./payment.js";
 import { snapshotMeetingScope } from "./provider.js";
-/** Mirrors the store's fact types; the store checks the type again when it writes. */
-export const MEETING_FACT_TYPES = ["fact", "statement", "question", "decision", "promise"];
 const id = (value) => {
     if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1)
         throw new CliError("validation_error", "meeting context identifiers must be positive integers");
@@ -63,8 +62,8 @@ export const validateMeetingContextChange = (change) => {
             });
         }
         case "fact.add": {
-            if (!MEETING_FACT_TYPES.includes(change.type) || !["personal", "work"].includes(change.scope))
-                throw new CliError("validation_error", `fact type (${MEETING_FACT_TYPES.join(", ")}) and explicit personal/work scope are required`);
+            if (!FACT_TYPES.includes(change.type) || !["personal", "work"].includes(change.scope))
+                throw new CliError("validation_error", `fact type (${FACT_TYPES.join(", ")}) and explicit personal/work scope are required`);
             return Object.freeze({
                 action: change.action,
                 statement: text(change.statement, 20_000),

package/dist/meetings/payment.d.ts

@@ -0,0 +1,27 @@
+/** Every fact type the store takes; findings and meeting changes check against the same list. */
+export declare const FACT_TYPES: readonly ["fact", "statement", "question", "decision", "promise", "payment"];
+export declare const PAYMENT_DIRECTIONS: readonly ["to_us", "from_us"];
+export declare const PAYMENT_STATES: readonly ["expected", "paid", "cancelled"];
+/** A payment fact's fields, kept in `facts.metadata.payment`. */
+export interface Payment {
+    /** A decimal as text with two places, "50000.00": money is never a float. */
+    amount: string;
+    /** ISO 4217, "RUB". */
+    currency: string;
+    direction: (typeof PAYMENT_DIRECTIONS)[number];
+    /** `person:`, `organization:` or `project:`; `null` when only a name is known. */
+    counterparty: string | null;
+    counterparty_name: string | null;
+    /** An ISO date. */
+    due_at: string | null;
+    /** A change of state is a new fact that supersedes this one, so the history and its evidence stay. */
+    state: (typeof PAYMENT_STATES)[number];
+    /** What it is for, short: "support, September". The fact's statement is the full sentence. */
+    item: string | null;
+}
+/** A payment as stored: the amount with two decimals, the currency upper case; refuses what is not one. */
+export declare const validatePayment: (input: unknown) => Payment;
+/** One line for a payment, as a list or an inbox shows it: "1 200 EUR to us from Ana, due 31.10 (expected)". */
+export declare const paymentTitle: (fact: {
+    payment: Payment | null;
+}) => string;

package/dist/meetings/payment.js

@@ -0,0 +1,81 @@
+import { CliError } from "@wirecat/cli-base";
+/** Every fact type the store takes; findings and meeting changes check against the same list. */
+export const FACT_TYPES = ["fact", "statement", "question", "decision", "promise", "payment"];
+export const PAYMENT_DIRECTIONS = ["to_us", "from_us"];
+export const PAYMENT_STATES = ["expected", "paid", "cancelled"];
+const invalid = (message) => {
+    throw new CliError("validation_error", message);
+};
+const CURRENCIES = new Set(Intl.supportedValuesOf("currency"));
+const AMOUNT = /^(\d{1,15})(?:\.(\d{1,2}))?$/;
+const COUNTERPARTY = /^(person|organization|project):[1-9]\d*$/;
+const amountOf = (value) => {
+    const match = AMOUNT.exec(typeof value === "number" ? String(value) : typeof value === "string" ? value.trim() : "");
+    if (!match)
+        return invalid("a payment's amount is a positive number with at most 2 decimals, such as 1200.50");
+    const amount = `${BigInt(match[1] ?? "0")}.${(match[2] ?? "").padEnd(2, "0")}`;
+    if (amount === "0.00")
+        return invalid("a payment's amount is more than 0");
+    return amount;
+};
+const dateOf = (value) => {
+    const date = typeof value === "string" ? value.trim() : "";
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(date) || new Date(`${date}T00:00:00Z`).toISOString().slice(0, 10) !== date)
+        return invalid("a payment's due date is an ISO date, such as 2026-10-31");
+    return date;
+};
+const optionalText = (value, what, limit) => {
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value !== "string" || !value.trim() || value.length > limit || value.includes("\0"))
+        return invalid(`a payment's ${what} takes 1–${limit} characters`);
+    return value.trim();
+};
+const oneOf = (value, allowed, what) => {
+    if (typeof value !== "string" || !allowed.includes(value))
+        return invalid(`a payment's ${what} is one of ${allowed.join(", ")}`);
+    return value;
+};
+const FIELDS = ["amount", "currency", "direction", "counterparty", "counterparty_name", "due_at", "state", "item"];
+/** A payment as stored: the amount with two decimals, the currency upper case; refuses what is not one. */
+export const validatePayment = (input) => {
+    if (!input || typeof input !== "object" || Array.isArray(input))
+        return invalid("a payment is an object");
+    const raw = input;
+    const unknown = Object.keys(raw).filter((key) => !FIELDS.includes(key));
+    if (unknown.length)
+        return invalid(`a payment has no field ${unknown.join(", ")}; its fields are ${FIELDS.join(", ")}`);
+    const currency = typeof raw.currency === "string" ? raw.currency.trim().toUpperCase() : "";
+    if (!/^[A-Z]{3}$/.test(currency) || !CURRENCIES.has(currency))
+        return invalid("a payment's currency is an ISO 4217 code, such as EUR or RUB");
+    const counterparty = optionalText(raw.counterparty, "counterparty", 80);
+    if (counterparty !== null && !COUNTERPARTY.test(counterparty))
+        return invalid("a payment's counterparty is a person:, organization: or project: reference");
+    return {
+        amount: amountOf(raw.amount),
+        currency,
+        direction: oneOf(raw.direction, PAYMENT_DIRECTIONS, "direction"),
+        counterparty,
+        counterparty_name: optionalText(raw.counterparty_name, "counterparty name", 200),
+        due_at: raw.due_at === undefined || raw.due_at === null ? null : dateOf(raw.due_at),
+        state: oneOf(raw.state, PAYMENT_STATES, "state"),
+        item: optionalText(raw.item, "item", 200),
+    };
+};
+const grouped = (amount) => {
+    const [whole = "0", cents = "00"] = amount.split(".");
+    const digits = whole.replace(/\B(?=(\d{3})+(?!\d))/g, " ");
+    return cents === "00" ? digits : `${digits}.${cents}`;
+};
+/** One line for a payment, as a list or an inbox shows it: "1 200 EUR to us from Ana, due 31.10 (expected)". */
+export const paymentTitle = (fact) => {
+    const payment = fact.payment;
+    if (!payment)
+        return "";
+    const who = payment.counterparty_name ?? payment.counterparty;
+    const way = payment.direction === "to_us" ? "to us" : "from us";
+    const party = who === null ? "" : payment.direction === "to_us" ? ` from ${who}` : ` to ${who}`;
+    const due = payment.due_at === null ? "" : `, due ${payment.due_at.slice(8, 10)}.${payment.due_at.slice(5, 7)}`;
+    const item = payment.item === null ? "" : ` for ${payment.item}`;
+    return `${grouped(payment.amount)} ${payment.currency} ${way}${party}${item}${due} (${payment.state})`;
+};