@wirecat/cli-core 0.583.0 → 0.585.0

package/CHANGELOG.md

@@ -7,6 +7,30 @@ shape of this file.
 
 ## Unreleased
 
+## 0.585.0 — 06.11.2026
+
+### Added
+
+- **Deals in the store (store version 52).** `store.deals` keeps the owner's sales pipelines (`pipelines`,
+  `pipeline_stages`, made by the owner only) and the deals in them (table `opportunities`, ref `deal:<id>`): title,
+  organization, project, stage, status `open`, `won` or `lost` kept apart from the stage, the expected amount in minor
+  units with its currency, the expected close day and the day it closed. The people on a deal are `related-to` links
+  with a role (`owner`, `contact`, `decision-maker`). The owner's deal is confirmed at once; an agent's is a `deal`
+  proposal only the owner decides. Only the owner moves a deal, within its own pipeline, or closes it.
+
+## 0.584.0 — 06.11.2026
+
+### Added
+
+- **`schedule list` gives an agent schedule's cost caps.** `max_cost_usd` is the cap on one run (`--max-cost`, null
+  when none) and `max_cost_per_day_usd` the daily cap in force, the schedule's `--max-cost-per-day` or the config's
+  (0 for none), so a screen can show `$0.84 of $5.00`; the text line says `today $0.84 of $5.00`.
+
+### Fixed
+
+- **`schedule list`'s output schema describes what it prints.** `spent_today_usd`, and the last run's `cost_usd`
+  and `skipped`, were printed but missing from the strict `scheduled_job` schema.
+
 ## 0.583.0 — 05.11.2026
 
 ### Changed — may break callers

package/dist/cli/messenger/store-maintenance-command.d.ts

@@ -3,9 +3,9 @@ import type { CacheDatabase } from "../../store/driver.js";
 import type { Messenger } from "./context.js";
 /** `doctor`'s short summary of the store. Must answer for a broken file, so an error is a field. */
 export declare const storeSummary: (env: NodeJS.ProcessEnv) => Promise<{
+    error?: undefined;
     path: string;
     exists: boolean;
-    error?: undefined;
 } | {
     path: string;
     exists: boolean;

package/dist/cli/schedule/schedule-command.js

@@ -138,6 +138,12 @@ export const scheduleLimitsOf = (config) => {
 const given = (limits) => Object.fromEntries(Object.entries(limits).filter(([, value]) => value !== undefined));
 const shown = (argv) => argv.map((arg) => (arg === "" ? '""' : arg)).join(" ");
 const usd = (value) => `$${value.toFixed(2)}`;
+/** The per-run cap an agent schedule was made with (`--max-cost`, passed to claude as --max-budget-usd), or null. */
+const runCapOf = (argv) => {
+    const at = argv.indexOf("--max-budget-usd");
+    const cap = at < 0 ? Number.NaN : Number(argv[at + 1]);
+    return Number.isFinite(cap) ? cap : null;
+};
 /**
  * Runs the CLI's own commands, or an agent, later or on a timer — through systemd (Linux), launchd
  * (macOS) or Task Scheduler (Windows). Every timer runs `schedule exec <file>`; the schedule file holds
@@ -184,19 +190,21 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
      * Why a run does not start now, or nothing: an agent whose runs reached the day's cost cap waits for tomorrow, and
      * one gated on mail waits for mail past its holder's mark — on its timer, until enough of it waits.
      */
+    /** A schedule's own limits, else the config file's, else the defaults. */
+    const limitsOf = (self, schedule) => ({
+        ...SCHEDULE_DEFAULTS,
+        ...given(configured?.(self) ?? {}),
+        ...given({
+            mailWaitMinutes: schedule.mailWaitMinutes,
+            mailBatch: schedule.mailBatch,
+            maxCostPerDay: schedule.maxCostPerDay,
+        }),
+    });
     const waits = async (self, file, { timed }) => {
         if (!existsSync(file))
             return undefined;
         const schedule = readSchedule(file);
-        const { mailWaitMinutes, mailBatch, maxCostPerDay } = {
-            ...SCHEDULE_DEFAULTS,
-            ...given(configured?.(self) ?? {}),
-            ...given({
-                mailWaitMinutes: schedule.mailWaitMinutes,
-                mailBatch: schedule.mailBatch,
-                maxCostPerDay: schedule.maxCostPerDay,
-            }),
-        };
+        const { mailWaitMinutes, mailBatch, maxCostPerDay } = limitsOf(self, schedule);
         if (schedule.kind === "agent" && maxCostPerDay > 0) {
             const spent = spentToday(file);
             if (spent >= maxCostPerDay) {
@@ -342,7 +350,13 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
             kind: schedule.kind,
             when: describeWhen(schedule.when),
             last: lastRun(scheduleFile(state, schedule.name)) ?? null,
-            ...(schedule.kind === "agent" ? { spentTodayUsd: spentToday(scheduleFile(state, schedule.name)) } : {}),
+            ...(schedule.kind === "agent"
+                ? {
+                    spentTodayUsd: spentToday(scheduleFile(state, schedule.name)),
+                    maxCostUsd: runCapOf(schedule.argv),
+                    maxCostPerDayUsd: limitsOf(this, schedule).maxCostPerDay,
+                }
+                : {}),
         }));
         const answer = listOf("schedule list", {
             items: rows.map((row) => snakeKeys(row)),
@@ -355,7 +369,7 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
                 return "";
             }
             return rows
-                .map(({ name, kind, when, last, spentTodayUsd }) => [
+                .map(({ name, kind, when, last, spentTodayUsd, maxCostPerDayUsd }) => [
                 name,
                 kind,
                 when,
@@ -366,7 +380,9 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
                                 `${last.failures} in a row${last.reason ? `: ${last.reason}` : ""} — ${last.output}`
                             : "")
                     : "not run yet",
-                ...(spentTodayUsd ? [`today ${usd(spentTodayUsd)}`] : []),
+                ...(spentTodayUsd
+                    ? [`today ${usd(spentTodayUsd)}${maxCostPerDayUsd ? ` of ${usd(maxCostPerDayUsd)}` : ""}`]
+                    : []),
                 ...(last?.skipped
                     ? [`skipped ${last.skipped.at.slice(0, 16).replace("T", " ")}: ${last.skipped.why}`]
                     : []),

package/dist/domain/deals.d.ts

@@ -0,0 +1,20 @@
+import type { FinanceReview } from "./finance.js";
+/** Whether a deal ended, kept apart from the stage it stands in. */
+export declare const DEAL_STATUSES: readonly ["open", "won", "lost"];
+/** The part a person plays on a deal: the owner's side runs it, the client's side talks or decides. */
+export declare const DEAL_ROLES: readonly ["owner", "contact", "decision-maker"];
+export type DealStatus = (typeof DEAL_STATUSES)[number];
+export type DealRole = (typeof DEAL_ROLES)[number];
+export interface DealTitleFields {
+    id: number;
+    title: string;
+    stage: string;
+    amount: number | null;
+    currency: string | null;
+    status: DealStatus;
+    review: FinanceReview;
+}
+/** "Site redesign · Proposal, 500 000.00 RUB": a ref summary's title, which `refLabel` prefixes. */
+export declare const dealLine: (deal: DealTitleFields) => string;
+/** "Deal Site redesign · Proposal, 500 000.00 RUB (won)". */
+export declare const dealTitle: (deal: DealTitleFields) => string;

package/dist/domain/deals.js

@@ -0,0 +1,15 @@
+import { moneyLabel } from "./money.js";
+/** Whether a deal ended, kept apart from the stage it stands in. */
+export const DEAL_STATUSES = ["open", "won", "lost"];
+/** The part a person plays on a deal: the owner's side runs it, the client's side talks or decides. */
+export const DEAL_ROLES = ["owner", "contact", "decision-maker"];
+/** "Site redesign · Proposal, 500 000.00 RUB": a ref summary's title, which `refLabel` prefixes. */
+export const dealLine = (deal) => {
+    const money = deal.amount === null || deal.currency === null ? "" : `, ${moneyLabel(deal.amount, deal.currency)}`;
+    const notes = [deal.status === "open" ? null : deal.status, deal.review === "confirmed" ? null : deal.review]
+        .filter(Boolean)
+        .join(", ");
+    return `${deal.title} · ${deal.stage}${money}${notes ? ` (${notes})` : ""}`;
+};
+/** "Deal Site redesign · Proposal, 500 000.00 RUB (won)". */
+export const dealTitle = (deal) => `Deal ${dealLine(deal)}`;

package/dist/domain/ref-summaries.js

@@ -52,6 +52,7 @@ const WORDS = {
     invoice: "Invoice",
     payment: "Payment",
     order: "Order",
+    deal: "Deal",
     email: "Email",
     email_thread: "Email thread",
     unknown: "Unknown",

package/dist/domain/references.d.ts

@@ -33,7 +33,7 @@ export type Reference = {
  * Things named by their store id (a task also by its key or the task package's id). `entity` is the name
  * before organizations and projects: it still parses, so an old file's reference resolves as not found.
  */
-export declare const SIMPLE_REFERENCES: readonly ["note", "document", "person", "organization", "project", "task", "memory", "fact", "bot", "event", "invoice", "payment", "order", "entity"];
+export declare const SIMPLE_REFERENCES: readonly ["note", "document", "person", "organization", "project", "task", "memory", "fact", "bot", "event", "invoice", "payment", "order", "deal", "entity"];
 export type SimpleReference = (typeof SIMPLE_REFERENCES)[number];
 export type RefKindName = Exclude<Reference["type"], "entity">;
 export interface RefKindSpec<R extends Reference = Reference> {

package/dist/domain/references.js

@@ -19,6 +19,7 @@ export const SIMPLE_REFERENCES = [
     "invoice",
     "payment",
     "order",
+    "deal",
     "entity",
 ];
 const malformed = (text, shape) => new CliError("validation_error", `"${singleLine(text)}" is not a reference — expected ${shape}`, {

package/dist/entities/index.d.ts

@@ -3979,7 +3979,15 @@ export declare const ENTITIES: {
             readonly error_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly failing_since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly failures: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly cost_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly skipped: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+                readonly why: v.StringSchema<undefined>;
+            }, undefined>, undefined>;
         }, undefined>, undefined>;
+        readonly spent_today_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly max_cost_usd: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+        readonly max_cost_per_day_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
     }, undefined>;
     readonly call_record: v.StrictObjectSchema<{
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;

package/dist/entities/list-results.d.ts

@@ -57,7 +57,19 @@ export declare const scheduledJob: v.StrictObjectSchema<{
         readonly error_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly failing_since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly failures: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly cost_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        /** The last time a run did not start, and why: the day's cost cap, or too little new mail. */
+        readonly skipped: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+            readonly why: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
     }, undefined>, undefined>;
+    /** Agent schedules: what today's runs cost, in US dollars. */
+    readonly spent_today_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    /** Agent schedules: the cap on one run (`--max-cost`), null when none. */
+    readonly max_cost_usd: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+    /** Agent schedules: the daily cap in force, the schedule's `--max-cost-per-day` or the config's; 0 for none. */
+    readonly max_cost_per_day_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
 }, undefined>;
 export declare const botTemplate: v.StrictObjectSchema<{
     readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;

package/dist/entities/list-results.js

@@ -41,7 +41,16 @@ export const scheduledJob = v.strictObject({
         error_code: v.optional(text),
         failing_since: v.optional(time),
         failures: v.optional(v.number()),
+        cost_usd: v.optional(v.number()),
+        /** The last time a run did not start, and why: the day's cost cap, or too little new mail. */
+        skipped: v.optional(v.strictObject({ at: time, why: text })),
     })),
+    /** Agent schedules: what today's runs cost, in US dollars. */
+    spent_today_usd: v.optional(v.number()),
+    /** Agent schedules: the cap on one run (`--max-cost`), null when none. */
+    max_cost_usd: v.optional(v.nullable(v.number())),
+    /** Agent schedules: the daily cap in force, the schedule's `--max-cost-per-day` or the config's; 0 for none. */
+    max_cost_per_day_usd: v.optional(v.number()),
 });
 export const botTemplate = v.strictObject({
     name: v.nullable(text),

package/dist/errors/reasons.js

@@ -203,6 +203,14 @@ const OTHERS = [
     validation("money.amount", "the amount is not a decimal string in the currency's scale"),
     validation("money.currency", "the currency is not one the store keeps money in"),
     validation("money.quantity", "the quantity is not a decimal above 0"),
+    validation("deal.closed", "a won, lost, rejected or deleted deal does not move or close again"),
+    validation("deal.field", "a field of the deal is not valid"),
+    ["deal.owner-only", "permission_error", "only the owner moves or closes a deal, or makes a pipeline"],
+    validation("deal.ref", "the reference names no deal"),
+    validation("deal.stage", "no stage of that name, or a stage name more than one pipeline has"),
+    validation("pipeline.duplicate", "a pipeline of that name is already stored"),
+    validation("pipeline.field", "a pipeline needs a name and at least one stage, each named once"),
+    ["pipeline.not-found", "not_found", "no stored pipeline has that name"],
     validation("order.duplicate", "the shop's order with this number is already stored; change its status instead"),
     validation("order.proposed", "the shop's order with this number already waits for the owner in a findings batch"),
     validation("order.field", "a field of the order is not valid"),

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { bareCheck, type CheckWords, checkWords } from "./domain/checks.js";
 export type { CounterField, CounterObservation, CounterObservations, CounterState } from "./domain/counters.js";
 export { COUNTER_FIELDS, counterValue, observedCounters } from "./domain/counters.js";
+export { DEAL_ROLES, DEAL_STATUSES, type DealRole, type DealStatus } from "./domain/deals.js";
 export { FINANCE_REVIEWS, type FinanceReview, INVOICE_DIRECTIONS, INVOICE_STATUSES, type InvoiceDirection, type InvoiceStatus, MONEY_DIRECTIONS, type MoneyDirection, } from "./domain/finance.js";
 export { type FormattedText, type HtmlFormatting, type MarkdownFormatting, type TextSpan, validateFormattedText, } from "./domain/formatting.js";
 export { formatLocator, isLocator, type MessageLocator, parseLocator } from "./domain/locator.js";

package/dist/index.js

@@ -1,5 +1,6 @@
 export { bareCheck, checkWords } from "./domain/checks.js";
 export { COUNTER_FIELDS, counterValue, observedCounters } from "./domain/counters.js";
+export { DEAL_ROLES, DEAL_STATUSES } from "./domain/deals.js";
 export { FINANCE_REVIEWS, INVOICE_DIRECTIONS, INVOICE_STATUSES, MONEY_DIRECTIONS, } from "./domain/finance.js";
 export { validateFormattedText, } from "./domain/formatting.js";
 export { formatLocator, isLocator, parseLocator } from "./domain/locator.js";

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

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

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

@@ -0,0 +1,4 @@
+import type { MessageStore } from "../../../store/index.js";
+import type { ProposalKind } from "../types.js";
+/** An agent's deal, by its own ref (`deal:12`) as orders are; only the owner decides it. */
+export declare const dealKind: (store: Pick<MessageStore, "deals">) => ProposalKind;

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

@@ -0,0 +1,32 @@
+import { kept, proposerOfAuthor, pushed } from "./shared.js";
+const rowOf = (deal) => ({
+    id: deal.ref,
+    kind: "deal",
+    status: deal.review,
+    project: deal.project,
+    subject: deal.ref,
+    object: deal.organization?.ref ?? null,
+    summary: `Deal ${deal.summary}`,
+    proposedBy: proposerOfAuthor(deal.author),
+    reason: deal.reason,
+    evidence: [],
+    score: null,
+    signals: null,
+    parts: null,
+    createdAt: deal.createdAt,
+});
+/** An agent's deal, by its own ref (`deal:12`) as orders are; only the owner decides it. */
+export const dealKind = (store) => ({
+    kind: "deal",
+    prefix: "deal",
+    list: async (filter) => {
+        const status = filter.status ?? "proposed";
+        const deals = await store.deals.list({ ...pushed(filter), ...(status === "all" ? {} : { review: status }) });
+        return kept(deals.map(rowOf), filter);
+    },
+    get: async (id) => rowOf(await store.deals.get(id)),
+    decide: async (id, { confirm, by, reason }) => {
+        const deal = confirm ? await store.deals.confirm(id, by, reason) : await store.deals.reject(id, by, reason);
+        return { id, kind: "deal", status: confirm ? "confirmed" : "rejected", made: confirm ? [deal.ref] : [] };
+    },
+});

package/dist/services/proposals/registry.js

@@ -1,6 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import { mayDecide } from "../../store/decisions.js";
 import { actionKind } from "./kinds/action.js";
+import { dealKind } from "./kinds/deals.js";
 import { factKind } from "./kinds/fact.js";
 import { invoiceKind, paymentKind } from "./kinds/finance.js";
 import { findingsKind } from "./kinds/findings.js";
@@ -135,6 +136,7 @@ export const proposalRegistry = (store) => {
         invoiceKind(store),
         paymentKind(store),
         orderKind(store),
+        dealKind(store),
         organizationKind(store),
         memoryKind(store),
         findingsKind(store),

package/dist/store/index.d.ts

@@ -34,6 +34,7 @@ export type { BotUpdate, BotUpdateStore } from "./sqlite/bot-updates.js";
 export type { CatalogActor, CatalogEntry, CatalogInput, CatalogQuery, CatalogStore } from "./sqlite/catalog.js";
 export { CATALOG_QUERY } from "./sqlite/catalog.js";
 export type { ChatMetadata } from "./sqlite/chats.js";
+export type { Deal, DealFilter, DealInput, DealPerson, DealsStore, Pipeline, PipelineStage, } from "./sqlite/deals.js";
 export type { Email, EmailAddress, EmailAttachment, EmailFacts, EmailFilter, EmailInput, EmailInThread, EmailLocationInput, EmailRecipient, EmailRef, EmailThread, EmailVectorHit, FolderEmail, Mailbox, MailboxInput, MailFilter, MailStore, PartialEmail, SenderScore, ThreadDetails, ThreadSave, } from "./sqlite/emails.js";
 export { EVENT_FIELDS, type EventChunkToEmbed, type EventHit, type EventQuery, type EventSearch, type NearestEvent, } from "./sqlite/event-search.js";
 export type { EvidenceSource } from "./sqlite/evidence-sources.js";

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

@@ -0,0 +1,104 @@
+import { type DealRole, type DealStatus } from "../../domain/deals.js";
+import { type FinanceReview } from "../../domain/finance.js";
+import { type Decider } from "../decisions.js";
+import { type ProposedByFilter } from "./actors.js";
+import { type Party, type Reviewed, type Written } from "./finance.js";
+import { type Author } from "./memories.js";
+import type { StoreContext } from "./open.js";
+export interface PipelineStage {
+    name: string;
+    position: number;
+    /** Open deals standing in it, the owner's and agents' not rejected. */
+    open: number;
+}
+export interface Pipeline {
+    name: string;
+    stages: PipelineStage[];
+    createdAt: string;
+}
+export interface DealPerson extends Party {
+    role: DealRole;
+}
+export interface Deal extends Reviewed {
+    id: string;
+    ref: string;
+    title: string;
+    /** One line with stage, amount and status, as a list or the review inbox prints it. */
+    summary: string;
+    pipeline: string;
+    stage: string;
+    status: DealStatus;
+    organization: Party | null;
+    /** Both `null` when no amount is expected yet. */
+    currency: string | null;
+    amount: string | null;
+    /** `YYYY-MM-DD`: the day it is expected to close. */
+    closeDate: string | null;
+    /** `YYYY-MM-DD`: the day it was won or lost. */
+    closedDate: string | null;
+    /** Why it was won or lost, as the owner said when closing it. */
+    closedReason: string | null;
+    people: DealPerson[];
+}
+export interface DealInput extends Written {
+    title: string;
+    /** A stage's name; `pipeline` names its pipeline when more than one has a stage of that name. */
+    stage: string;
+    pipeline?: string;
+    organization?: string;
+    /** A decimal string in `currency`; give both or neither. */
+    amount?: string;
+    currency?: string;
+    closeDate?: string;
+    people?: {
+        person: string;
+        role: DealRole;
+    }[];
+}
+export interface DealFilter {
+    status?: DealStatus;
+    /** A stage's or pipeline's name, in any letter case. */
+    stage?: string;
+    pipeline?: string;
+    project?: string;
+    organization?: string;
+    review?: FinanceReview;
+    proposedBy?: ProposedByFilter;
+    /** 1–500, 100 by default; newest written first. */
+    limit?: number;
+}
+/**
+ * The owner's sales pipelines and the deals in them. The owner's deal is confirmed at once; an agent's waits as
+ * proposed for him, and only he decides it. Only the owner makes a pipeline, moves a deal or closes it.
+ */
+export interface DealsStore {
+    addPipeline(input: {
+        name: string;
+        stages: string[];
+        by: Author;
+    }): Promise<Pipeline>;
+    pipelines(): Promise<Pipeline[]>;
+    add(input: DealInput): Promise<Deal>;
+    get(reference: string): Promise<Deal>;
+    list(filter?: DealFilter): Promise<Deal[]>;
+    /** To another stage of the deal's own pipeline. */
+    move(reference: string, input: {
+        stage: string;
+        by: Author;
+    }): Promise<Deal>;
+    /** `date` is the day it closed, today when left out. */
+    close(reference: string, input: {
+        status: Exclude<DealStatus, "open">;
+        date?: string;
+        reason?: string;
+        by: Author;
+    }): Promise<Deal>;
+    confirm(reference: string, by: Decider, reason?: string): Promise<Deal>;
+    reject(reference: string, by: Decider, reason?: string): Promise<Deal>;
+}
+type DealOperations = {
+    [K in keyof DealsStore]: DealsStore[K] extends (...args: infer A) => Promise<infer R> ? (...args: A) => R : never;
+};
+export declare const dealOperationsOver: (context: StoreContext) => DealOperations;
+export declare const dealsStoreOver: (context: StoreContext) => DealsStore;
+export {};