@wirecat/cli-core 0.556.0 → 0.557.0

package/dist/meetings/mcp/index.d.ts

@@ -38,6 +38,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -53,11 +54,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -75,11 +76,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -101,7 +102,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -188,6 +188,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -203,11 +204,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -225,11 +226,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -251,7 +252,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -338,6 +338,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -353,11 +354,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -375,11 +376,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -401,7 +402,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -488,6 +488,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -503,11 +504,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -525,11 +526,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -551,7 +552,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -638,6 +638,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -653,11 +654,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -675,11 +676,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -701,7 +702,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;

package/dist/services/proposals/kinds/finance.d.ts

@@ -0,0 +1,4 @@
+import type { MessageStore } from "../../../store/index.js";
+import type { ProposalKind } from "../types.js";
+export declare const invoiceKind: (store: Pick<MessageStore, "finance">) => ProposalKind;
+export declare const paymentKind: (store: Pick<MessageStore, "finance">) => ProposalKind;

package/dist/services/proposals/kinds/finance.js

@@ -0,0 +1,40 @@
+import { kept, proposerOfAuthor, pushed } from "./shared.js";
+const rowOf = (kind, entry) => ({
+    id: entry.ref,
+    kind,
+    status: entry.review,
+    project: entry.project,
+    subject: entry.ref,
+    object: "counterparty" in entry
+        ? entry.counterparty.ref
+        : ((entry.direction === "in" ? entry.payer : entry.payee)?.ref ?? null),
+    summary: entry.title,
+    proposedBy: proposerOfAuthor(entry.author),
+    reason: entry.reason,
+    evidence: [],
+    score: null,
+    signals: null,
+    parts: null,
+    createdAt: entry.createdAt,
+});
+/**
+ * An agent's or an import's invoice or payment. One kind per entity, because the registry routes an id by its prefix
+ * and the id is the entry's own ref (`payment:12`), as a fact's is. Only the owner decides money.
+ */
+const financeKind = (store, kind) => ({
+    kind,
+    prefix: kind,
+    list: async (filter) => {
+        const status = filter.status ?? "proposed";
+        const options = { ...pushed(filter), ...(status === "all" ? {} : { review: status }) };
+        const entries = kind === "invoice" ? await store.finance.invoices(options) : await store.finance.payments(options);
+        return kept(entries.map((entry) => rowOf(kind, entry)), filter);
+    },
+    get: async (id) => rowOf(kind, kind === "invoice" ? await store.finance.invoice(id) : await store.finance.payment(id)),
+    decide: async (id, { confirm, by, reason }) => {
+        const entry = confirm ? await store.finance.confirm(id, by, reason) : await store.finance.reject(id, by, reason);
+        return { id, kind, status: confirm ? "confirmed" : "rejected", made: confirm ? [entry.ref] : [] };
+    },
+});
+export const invoiceKind = (store) => financeKind(store, "invoice");
+export const paymentKind = (store) => financeKind(store, "payment");

package/dist/services/proposals/registry.js

@@ -2,6 +2,7 @@ import { CliError } from "@wirecat/cli-base";
 import { mayDecide } from "../../store/decisions.js";
 import { actionKind } from "./kinds/action.js";
 import { factKind } from "./kinds/fact.js";
+import { invoiceKind, paymentKind } from "./kinds/finance.js";
 import { findingsKind } from "./kinds/findings.js";
 import { keyDocumentKind } from "./kinds/key-document.js";
 import { memoryKind } from "./kinds/memory.js";
@@ -122,6 +123,8 @@ export const proposalRegistry = (store) => {
         relationshipUpdateKind(store),
         keyDocumentKind(store),
         factKind(store),
+        invoiceKind(store),
+        paymentKind(store),
         memoryKind(store),
         findingsKind(store),
     ])

package/dist/store/index.d.ts

@@ -38,6 +38,7 @@ export { EVENT_FIELDS, type EventChunkToEmbed, type EventHit, type EventQuery, t
 export type { EvidenceSource } from "./sqlite/evidence-sources.js";
 export type { Fact, FactInput, FactsStore, PaymentFilter } from "./sqlite/facts.js";
 export type { FileListQuery, FilesStore, StoredFile } from "./sqlite/files.js";
+export type { Allocation, FinanceStore, Invoice, InvoiceDetail, InvoiceInput, InvoiceLine, InvoiceLineInput, OpenTotal, Party, Payment as FinancePayment, PaymentDetail as FinancePaymentDetail, PaymentInput as FinancePaymentInput, } from "./sqlite/finance.js";
 export { IMPORTED_DOCUMENT_QUERY, type ImportedDocuments } from "./sqlite/imported-documents.js";
 export type { Involvement, InvolvementStore } from "./sqlite/involvements.js";
 export type { Annotation, KnowledgeRelation, KnowledgeStore, KnowledgeTarget, LabelledType, Organization, Project, Reminder, } from "./sqlite/knowledge.js";

package/dist/store/sqlite/entity-types.d.ts

@@ -20,6 +20,7 @@ export declare const ENTITY_TABLES: {
     readonly file: "files";
     readonly identity: "identities";
     readonly image: "attachments";
+    readonly invoice: "invoices";
     readonly meeting: "meetings";
     readonly meeting_transcript: "meeting_transcripts";
     readonly meeting_transcript_row: "meeting_transcript_rows";
@@ -27,6 +28,7 @@ export declare const ENTITY_TABLES: {
     readonly message: "messages";
     readonly note: "notes";
     readonly organization: "organizations";
+    readonly payment: "payments";
     readonly person: "persons";
     readonly place: "places";
     readonly project: "projects";

package/dist/store/sqlite/entity-types.js

@@ -19,6 +19,7 @@ export const ENTITY_TABLES = {
     file: "files",
     identity: "identities",
     image: "attachments",
+    invoice: "invoices",
     meeting: "meetings",
     meeting_transcript: "meeting_transcripts",
     meeting_transcript_row: "meeting_transcript_rows",
@@ -26,6 +27,7 @@ export const ENTITY_TABLES = {
     message: "messages",
     note: "notes",
     organization: "organizations",
+    payment: "payments",
     person: "persons",
     place: "places",
     project: "projects",

package/dist/store/sqlite/finance.d.ts

@@ -0,0 +1,199 @@
+import { type FinanceReview, type InvoiceDirection, type InvoiceStatus, type MoneyDirection } from "../../domain/finance.js";
+import { type Money } from "../../domain/money.js";
+import { type Decider } from "../decisions.js";
+import { type Actor, type ProposedByFilter } from "./actors.js";
+import { type Author } from "./memories.js";
+import type { StoreContext } from "./open.js";
+/** A `person:` or `organization:` on an invoice or a payment, with its name so a list needs no lookup. */
+export interface Party {
+    ref: string;
+    name: string | null;
+    /** The owner's own person row. */
+    owner: boolean;
+}
+interface Reviewed {
+    review: FinanceReview;
+    /** `name` is a bot's handle and `kind` whether it is an agent or a rule; both `null` for a person. */
+    author: {
+        type: Actor["type"];
+        id: string;
+        name: string | null;
+        kind: "agent" | "rule" | null;
+    };
+    model: string | null;
+    confirmedBy: {
+        type: Actor["type"];
+        id: string;
+    } | null;
+    source: string;
+    /** Why an agent or an import proposed it. */
+    reason: string | null;
+    project: string | null;
+    projectName: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Invoice extends Reviewed {
+    id: string;
+    ref: string;
+    /** One line, as a list or the review inbox prints it. */
+    title: string;
+    direction: InvoiceDirection;
+    number: string | null;
+    issuer: Party | null;
+    counterparty: Party;
+    currency: string;
+    total: string;
+    /** Settled by confirmed payments. */
+    paid: string;
+    /** Still owed: `total − paid`. */
+    open: string;
+    issueDate: string | null;
+    dueDate: string | null;
+    status: InvoiceStatus;
+}
+export interface InvoiceLine {
+    position: number;
+    description: string;
+    quantity: string;
+    unitPrice: string | null;
+    amount: string;
+}
+export interface Allocation {
+    payment: string;
+    invoice: string;
+    amount: string;
+    currency: string;
+    createdAt: string;
+}
+export interface InvoiceDetail extends Invoice {
+    lines: InvoiceLine[];
+    allocations: Allocation[];
+}
+export interface Payment extends Reviewed {
+    id: string;
+    ref: string;
+    title: string;
+    direction: MoneyDirection;
+    payer: Party | null;
+    payee: Party | null;
+    amount: string;
+    currency: string;
+    /** `YYYY-MM-DD`. */
+    date: string;
+    reference: string | null;
+    /** Allocated to invoices, confirmed or not. */
+    allocated: string;
+    unallocated: string;
+}
+export interface PaymentDetail extends Payment {
+    allocations: Allocation[];
+}
+interface Written {
+    /** The owner's entry is confirmed at once; a bot's waits as proposed for the owner. */
+    by: Author;
+    project?: string;
+    /** Where a bot's row came from, such as `agent` or an importer's name; the owner's is always `owner`. */
+    source?: string;
+    /** Why a bot proposes it, kept for the reviewer. */
+    reason?: string;
+}
+export interface InvoiceLineInput {
+    description: string;
+    /** A decimal string; `1` when not given. */
+    quantity?: string;
+    /** Decimal strings in the invoice's currency. Give either or both: both must agree, quantity × unit price. */
+    unitPrice?: string;
+    amount?: string;
+}
+export interface InvoiceInput extends Written {
+    direction: InvoiceDirection;
+    number?: string;
+    /** `person:` or `organization:`. */
+    issuer?: string;
+    counterparty: string;
+    currency: string;
+    /** `YYYY-MM-DD`. */
+    issueDate?: string;
+    dueDate?: string;
+    /** Kept as a draft until `issueInvoice`; otherwise issued at once. */
+    draft?: boolean;
+    lines: InvoiceLineInput[];
+    /** The total printed on the invoice: refused when it is not the sum of the lines. */
+    total?: string;
+}
+export interface PaymentInput extends Written {
+    direction: MoneyDirection;
+    payer?: string;
+    payee?: string;
+    amount: string;
+    currency: string;
+    date: string;
+    reference?: string;
+    /** Invoices it settles, in the payment's currency; a bot's count only once the owner confirms the payment. */
+    allocations?: {
+        invoice: string;
+        amount: string;
+    }[];
+}
+interface ListFilter {
+    project?: string;
+    review?: FinanceReview;
+    proposedBy?: ProposedByFilter;
+    /** 1–500, 100 by default; newest written first. */
+    limit?: number;
+}
+export interface OpenTotal extends Money {
+    invoices: number;
+}
+export interface FinanceStore {
+    addInvoice(input: InvoiceInput): Promise<InvoiceDetail>;
+    invoice(reference: string): Promise<InvoiceDetail>;
+    invoices(filter?: ListFilter & {
+        direction?: InvoiceDirection;
+        status?: InvoiceStatus;
+        /** Issued or partly paid. */
+        open?: boolean;
+        counterparty?: string;
+    }): Promise<Invoice[]>;
+    /** The owner sends a draft: its status then follows its allocations. */
+    issueInvoice(reference: string, by: Author): Promise<InvoiceDetail>;
+    /** The owner cancels an invoice no confirmed payment is allocated to; proposed allocations to it go. */
+    voidInvoice(reference: string, by: Author): Promise<InvoiceDetail>;
+    addPayment(input: PaymentInput): Promise<PaymentDetail>;
+    payment(reference: string): Promise<PaymentDetail>;
+    payments(filter?: ListFilter & {
+        direction?: MoneyDirection;
+        party?: string;
+    }): Promise<Payment[]>;
+    /**
+     * Settles part of an invoice with part of a payment, in one currency, never beyond either. The owner allocates any
+     * payment; a bot only one it proposed that is still proposed.
+     */
+    allocate(input: {
+        payment: string;
+        invoice: string;
+        amount: string;
+        by: Author;
+    }): Promise<Allocation>;
+    /**
+     * The owner confirms a proposed `invoice:` or `payment:`; only the owner decides money. A payment whose allocations
+     * would settle more than an invoice's total, given the confirmed payments by then, is refused and stays proposed.
+     */
+    confirm(reference: string, by: Decider, reason?: string): Promise<InvoiceDetail | PaymentDetail>;
+    /** The owner turns a proposal down; it stays, `rejected`, and its allocations go. */
+    reject(reference: string, by: Decider, reason?: string): Promise<InvoiceDetail | PaymentDetail>;
+    /** What is still owed on confirmed open invoices, per direction and per currency: nothing is converted. */
+    openTotals(filter?: {
+        project?: string;
+    }): Promise<{
+        receivable: OpenTotal[];
+        payable: OpenTotal[];
+    }>;
+}
+type FinanceOperations = {
+    [K in keyof FinanceStore]: FinanceStore[K] extends (...args: infer A) => Promise<infer R> ? (...args: A) => R : never;
+};
+export declare const financeOperationsOver: (context: StoreContext) => FinanceOperations;
+export declare const financeStoreOver: (context: StoreContext) => FinanceStore;
+export {};