@wirecat/cli-core 0.590.0 → 0.591.0

package/dist/entities/index.d.ts

@@ -235,6 +235,147 @@ export declare const ENTITIES: {
         readonly updated_at: v.NullableSchema<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 cursor_age_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     }, undefined>;
+    readonly deal: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly kind: v.PicklistSchema<["deal", "lead"], undefined>;
+        readonly title: v.StringSchema<undefined>;
+        readonly summary: v.StringSchema<undefined>;
+        readonly pipeline: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly pipeline_name: v.StringSchema<undefined>;
+        readonly stage: v.StringSchema<undefined>;
+        readonly status: v.PicklistSchema<["open", "won", "lost"], undefined>;
+        readonly organization: v.NullableSchema<v.StrictObjectSchema<{
+            readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly currency: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly amount: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly close_date: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        readonly closed_date: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        readonly closed_reason: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly rank: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        readonly deal: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly account: v.NullableSchema<v.StrictObjectSchema<{
+            readonly provider: v.StringSchema<undefined>;
+            readonly account: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly people: v.ArraySchema<v.StrictObjectSchema<{
+            readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+            readonly role: v.PicklistSchema<["owner", "contact", "decision-maker"], undefined>;
+        }, undefined>, undefined>;
+        readonly author: v.StrictObjectSchema<{
+            readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly kind: v.NullableSchema<v.PicklistSchema<["agent", "rule"], undefined>, undefined>;
+        }, undefined>;
+        readonly model: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly source: v.StringSchema<undefined>;
+        readonly reason: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly evidence: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly project: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly project_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly created_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 updated_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 untrusted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>;
+    readonly lead: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly kind: v.PicklistSchema<["deal", "lead"], undefined>;
+        readonly title: v.StringSchema<undefined>;
+        readonly summary: v.StringSchema<undefined>;
+        readonly pipeline: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly pipeline_name: v.StringSchema<undefined>;
+        readonly stage: v.StringSchema<undefined>;
+        readonly status: v.PicklistSchema<["open", "won", "lost"], undefined>;
+        readonly organization: v.NullableSchema<v.StrictObjectSchema<{
+            readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly currency: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly amount: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly close_date: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        readonly closed_date: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
+        readonly closed_reason: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly rank: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        readonly deal: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly account: v.NullableSchema<v.StrictObjectSchema<{
+            readonly provider: v.StringSchema<undefined>;
+            readonly account: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly people: v.ArraySchema<v.StrictObjectSchema<{
+            readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+            readonly role: v.PicklistSchema<["owner", "contact", "decision-maker"], undefined>;
+        }, undefined>, undefined>;
+        readonly author: v.StrictObjectSchema<{
+            readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly kind: v.NullableSchema<v.PicklistSchema<["agent", "rule"], undefined>, undefined>;
+        }, undefined>;
+        readonly model: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly source: v.StringSchema<undefined>;
+        readonly reason: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly evidence: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly project: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly project_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly created_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 updated_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 untrusted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>;
+    readonly pipeline: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly name: v.StringSchema<undefined>;
+        readonly kind: v.PicklistSchema<["deal", "lead"], undefined>;
+        readonly account: v.NullableSchema<v.StrictObjectSchema<{
+            readonly provider: v.StringSchema<undefined>;
+            readonly account: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly stages: v.ArraySchema<v.StrictObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly position: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly outcome: v.PicklistSchema<["open", "won", "lost"], undefined>;
+            readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly open: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly reached: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            readonly conversion: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly created_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 totals: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly items: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly open: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly won: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly lost: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly win_rate: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly since: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>, undefined>;
+        readonly untrusted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>;
+    readonly stage: v.StrictObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly position: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly outcome: v.PicklistSchema<["open", "won", "lost"], undefined>;
+        readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly open: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly reached: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+        readonly conversion: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+        readonly pipeline: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly pipeline_name: v.StringSchema<undefined>;
+        readonly kind: v.PicklistSchema<["deal", "lead"], undefined>;
+        readonly untrusted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>;
     readonly message: 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>]>;
@@ -3970,6 +4111,7 @@ export declare const ENTITIES: {
         readonly name: v.StringSchema<undefined>;
         readonly kind: v.PicklistSchema<["command", "agent"], undefined>;
         readonly when: v.StringSchema<undefined>;
+        readonly notify: v.OptionalSchema<v.PicklistSchema<["always", "failures", "never"], undefined>, undefined>;
         readonly last: v.NullableSchema<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 exit_code: v.NumberSchema<undefined>;
@@ -3983,6 +4125,7 @@ export declare const ENTITIES: {
             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>;
+                readonly reason: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
             }, undefined>, undefined>;
         }, undefined>, undefined>;
         readonly spent_today_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;

package/dist/entities/index.js

@@ -29,6 +29,7 @@ import { conversation } from "./conversation.js";
 import { conversationPreparation } from "./conversation-preparation.js";
 import { conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationReadiness, } from "./conversation-results.js";
 import { counterRefresh, counters } from "./counters.js";
+import { deal, lead, pipeline, stage } from "./deal.js";
 import { document } from "./document.js";
 import { documentLink } from "./document-link.js";
 import { evidence } from "./evidence.js";
@@ -100,6 +101,10 @@ import { topic } from "./topic.js";
 export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatCoverage, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mailCounts, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, organization, person, place, poll, pollChange, pollVote, project, ranking, reaction, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, reminder, removedModelKey, responseTimes, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, storeTable, tagChange, tagging, task, taskAnalysis, taskAnalysisMark, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, topicIcon, trackedChat, trackedChatHistory, waitingChats, watchedMessage, watchItem, };
 export const ENTITIES = {
     sync_progress: syncProgress,
+    deal,
+    lead,
+    pipeline,
+    stage,
     ...MEETING_RESULT_ENTITIES,
     message,
     message_context: messageContext,

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

@@ -48,6 +48,8 @@ export declare const scheduledJob: v.StrictObjectSchema<{
     readonly name: v.StringSchema<undefined>;
     readonly kind: v.PicklistSchema<["command", "agent"], undefined>;
     readonly when: v.StringSchema<undefined>;
+    /** When a finished run shows a desktop notice: `always`, `failures` or `never`; the default is shown, not left out. */
+    readonly notify: v.OptionalSchema<v.PicklistSchema<["always", "failures", "never"], undefined>, undefined>;
     readonly last: v.NullableSchema<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 exit_code: v.NumberSchema<undefined>;
@@ -62,6 +64,8 @@ export declare const scheduledJob: v.StrictObjectSchema<{
         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>;
+            /** A dotted id for `why`, so a client can translate it: `cost.day-cap`, `mail.none-new`, `mail.below-threshold`. */
+            readonly reason: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>, undefined>;
         }, undefined>, undefined>;
     }, undefined>, undefined>;
     /** Agent schedules: what today's runs cost, in US dollars. */

package/dist/entities/list-results.js

@@ -32,6 +32,8 @@ export const scheduledJob = v.strictObject({
     name: text,
     kind: v.picklist(["command", "agent"]),
     when: text,
+    /** When a finished run shows a desktop notice: `always`, `failures` or `never`; the default is shown, not left out. */
+    notify: v.optional(v.picklist(["always", "failures", "never"])),
     last: v.nullable(v.strictObject({
         at: time,
         exit_code: v.number(),
@@ -43,7 +45,12 @@ export const scheduledJob = v.strictObject({
         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 })),
+        skipped: v.optional(v.strictObject({
+            at: time,
+            why: text,
+            /** A dotted id for `why`, so a client can translate it: `cost.day-cap`, `mail.none-new`, `mail.below-threshold`. */
+            reason: v.optional(v.pipe(text, v.regex(/^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)+$/))),
+        })),
     })),
     /** Agent schedules: what today's runs cost, in US dollars. */
     spent_today_usd: v.optional(v.number()),

package/dist/errors/reasons.js

@@ -204,6 +204,7 @@ const OTHERS = [
     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 deleted deal or lead does not move or close"),
+    validation("deal.copy", "a CRM's copy changes in the CRM; its next sync brings the change here"),
     validation("deal.field", "a field of the deal or lead is not valid"),
     validation("deal.ref", "the reference names no deal or lead"),
     validation("deal.stage", "no stage of that name, or a stage name more than one pipeline has"),
@@ -211,6 +212,10 @@ const OTHERS = [
     validation("pipeline.duplicate", "a pipeline of that name and kind 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 or reference"],
+    validation("crm.stage-unknown", "a CRM item stands in a stage the store does not hold; it was not kept"),
+    validation("crm.pipeline-clash", "a CRM pipeline has the id of a stored pipeline of the other kind; it was not kept"),
+    validation("crm.item-invalid", "a CRM item has a field the store refuses, such as a currency it does not keep"),
+    validation("crm.unlisted-held", "a list of every id would mark most of a kind deleted; nothing was, until --rescan"),
     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 { CRM_KINDS, type CrmItem, type CrmKind, type CrmOrganization, type CrmPerson, type CrmPipeline, type CrmRecords, type CrmStage, isItemKind, } from "./domain/crm.js";
 export { DEAL_KINDS, DEAL_ROLES, DEAL_STATUSES, type DealKind, type DealRole, type DealStatus, STAGE_OUTCOMES, type StageOutcome, } 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";

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 { CRM_KINDS, isItemKind, } from "./domain/crm.js";
 export { DEAL_KINDS, DEAL_ROLES, DEAL_STATUSES, STAGE_OUTCOMES, } from "./domain/deals.js";
 export { FINANCE_REVIEWS, INVOICE_DIRECTIONS, INVOICE_STATUSES, MONEY_DIRECTIONS, } from "./domain/finance.js";
 export { validateFormattedText, } from "./domain/formatting.js";

package/dist/sends/index.d.ts

@@ -4,7 +4,7 @@ export { type Asker, type GuardRequest, guardFor, type SendGuard, type SendGuard
 export { currentOperation, guardedWrite, type Operated } from "./guarded.js";
 export { type AccountAction, type ChatAction, type SendEntry, SendJournal, type SendKind, type SendOutcome, sendsPathFor, } from "./journal.js";
 export { type KeyedGuard, keyedGuard } from "./keyed-guard.js";
-export { DEFAULT_PACE, type PaceRate, Pacer, pacePathFor } from "./pace.js";
+export { DEFAULT_PACE, type PaceRate, Pacer, pacePathFor, type TurnOptions, waitForTurn } from "./pace.js";
 export { assertOverridesTighten, CEILING_KEY, COMMAND_PATH_KEY, DEFAULT_PERMISSIONS, keyForCommand, keyForWrite, LEVELS, type Level, layerPermissions, levelFor, type PermissionKey, permissionOverrides, readKeysForCommand, skipFlagFor, WRITE_KEYS, } from "./permissions.js";
 export { type Recipient, RecipientList, recipientsPathFor } from "./recipients.js";
 export { newOperationId, newSendId } from "./send-id.js";

package/dist/sends/index.js

@@ -3,7 +3,7 @@ export { guardFor, sendGuard, sharedJournal, } from "./guard.js";
 export { currentOperation, guardedWrite } from "./guarded.js";
 export { SendJournal, sendsPathFor, } from "./journal.js";
 export { keyedGuard } from "./keyed-guard.js";
-export { DEFAULT_PACE, Pacer, pacePathFor } from "./pace.js";
+export { DEFAULT_PACE, Pacer, pacePathFor, waitForTurn } from "./pace.js";
 export { assertOverridesTighten, CEILING_KEY, COMMAND_PATH_KEY, DEFAULT_PERMISSIONS, keyForCommand, keyForWrite, LEVELS, layerPermissions, levelFor, permissionOverrides, readKeysForCommand, skipFlagFor, WRITE_KEYS, } from "./permissions.js";
 export { RecipientList, recipientsPathFor } from "./recipients.js";
 export { newOperationId, newSendId } from "./send-id.js";

package/dist/sends/pace.d.ts

@@ -1,4 +1,5 @@
 import type { AppIdentity } from "../ports/app.js";
+import type { Warn } from "../runs/events.js";
 /** How fast one profile may ask its messenger, counted across every process using it. */
 export interface PaceRate {
     /** 0 turns pacing off. */
@@ -30,3 +31,20 @@ export declare class Pacer {
     private read;
     private write;
 }
+export interface TurnOptions {
+    /** The provider, as a person calls it: `Telegram`, `Bitrix24`. */
+    name: string;
+    /** The call waiting, as a warning names it. */
+    operation: string;
+    /** Says so when the wait is long enough to notice, and when the pace file could not be read. */
+    warn?: Warn;
+    /** Waits; a timer when absent. A test or a cancellable run passes its own. */
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+}
+/**
+ * Waits for this call's turn in the profile's pace, the same wait for every provider: a short one silently, a long
+ * one with a warning, and one longer than a run would wait is refused as `rate_limited`, nothing sent. A pace file
+ * that cannot be read lets the call go: pacing is a courtesy to the provider, not a lock.
+ */
+export declare const waitForTurn: (pacer: Pacer, options: TurnOptions) => Promise<void>;

package/dist/sends/pace.js

@@ -1,6 +1,6 @@
 import { readFileSync, renameSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { resolvePaths } from "@wirecat/cli-base";
+import { CliError, resolvePaths } from "@wirecat/cli-base";
 import { withFileLockAsync } from "./file-lock.js";
 /** One call a second after a burst of 20: what a single `messages sync` already did with its 1 s page pause. */
 export const DEFAULT_PACE = { perMinute: 60, burst: 20 };
@@ -62,3 +62,42 @@ export class Pacer {
         renameSync(temporary, this.path);
     }
 }
+/** Shorter waits pass unannounced; a person at a terminal would not notice them. */
+const ANNOUNCE_WAIT_MS = 5_000;
+/** Longer than this the pace refuses instead of waiting, as a run already ends at a wait this long. */
+const LONGEST_PACE_WAIT_MS = 5 * 60_000;
+/**
+ * Waits for this call's turn in the profile's pace, the same wait for every provider: a short one silently, a long
+ * one with a warning, and one longer than a run would wait is refused as `rate_limited`, nothing sent. A pace file
+ * that cannot be read lets the call go: pacing is a courtesy to the provider, not a lock.
+ */
+export const waitForTurn = async (pacer, options) => {
+    const { name, operation, warn } = options;
+    const now = options.now ?? Date.now;
+    let at = now();
+    try {
+        at = await pacer.reserve();
+    }
+    catch (error) {
+        warn?.(`could not remember ${name}'s wait (${error instanceof Error ? error.message : String(error)})`, {
+            event: "warning",
+            code: "wait_not_remembered",
+            operation,
+        });
+    }
+    const waitMs = at - now();
+    if (waitMs <= 0)
+        return;
+    if (waitMs > LONGEST_PACE_WAIT_MS)
+        throw new CliError("rate_limited", `${name} asked this profile to wait, ${Math.ceil(waitMs / 1000)} s are left — nothing was sent to ${name}`, { retry_after_ms: waitMs, retry_at: new Date(at).toISOString(), remembered: true });
+    if (waitMs >= ANNOUNCE_WAIT_MS) {
+        const seconds = Math.ceil(waitMs / 1000);
+        warn?.(`waiting ${seconds} s to keep this profile's pace with ${name}`, {
+            event: "warning",
+            code: "pace_wait",
+            operation,
+            counts: { seconds },
+        });
+    }
+    await (options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms))))(waitMs);
+};

package/dist/services/index.d.ts

@@ -185,6 +185,7 @@ export type { QueryMetadata, SearchCoverage } from "./messages-search.js";
 export { metadataService } from "./metadata.js";
 export { embedEvents, embedMail, embedNotes, type FoundNote, type LinkedRecord, type NotesEmbedded, type NotesEmbedOptions, type NotesFound, type NotesFoundOf, type NotesQuery, type NotesSearchRequest, nearestNotes, RANK_WITHIN, searchNotes, searchNotesOf, searchNotesQuery, storeQuery, } from "./notes-search.js";
 export { type PackageUpgradeOutcome, type PackageUpgradePorts, type PackageUpgradeResult, type ServerRestarts, upgradePackage, } from "./package-upgrade.js";
+export { patiently } from "./patience.js";
 export { type PersonMeetingContext, type PersonMeetingContextItem, type PersonMeetingContextOptions, type PersonMeetingReadStore, personMeetingContext, } from "./person-meeting-context.js";
 export { privatePeopleService } from "./private-people.js";
 export { approveAsTask, type ProposalTaskStore, proposalSource } from "./proposal-tasks.js";

package/dist/services/index.js

@@ -143,6 +143,7 @@ export { meaningLane } from "./messages-meaning.js";
 export { metadataService } from "./metadata.js";
 export { embedEvents, embedMail, embedNotes, nearestNotes, RANK_WITHIN, searchNotes, searchNotesOf, searchNotesQuery, storeQuery, } from "./notes-search.js";
 export { upgradePackage, } from "./package-upgrade.js";
+export { patiently } from "./patience.js";
 export { personMeetingContext, } from "./person-meeting-context.js";
 export { privatePeopleService } from "./private-people.js";
 export { approveAsTask, proposalSource } from "./proposal-tasks.js";

package/dist/store/index.d.ts

@@ -34,7 +34,8 @@ 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, FunnelStage, Pipeline, PipelineInput, PipelineReport, PipelineStage, } from "./sqlite/deals.js";
+export { type CrmCopies, type CrmSaved, type CrmSkipped, crmIdentityId } from "./sqlite/crm.js";
+export type { Deal, DealFilter, DealInput, DealPerson, DealScope, DealsStore, FunnelStage, Pipeline, PipelineInput, PipelineReport, 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/index.js

@@ -20,6 +20,7 @@ export { planProjectAnnotationSnapshot } from "./project-transfer/snapshot-plan.
 export { resetAttachmentWords } from "./sqlite/attachment-texts.js";
 export { backfillNormalized, pendingNormalization } from "./sqlite/backfill.js";
 export { CATALOG_QUERY } from "./sqlite/catalog.js";
+export { crmIdentityId } from "./sqlite/crm.js";
 export { EVENT_FIELDS, } from "./sqlite/event-search.js";
 export { IMPORTED_DOCUMENT_QUERY } from "./sqlite/imported-documents.js";
 export { ORGANIZATION_KINDS, PROJECT_TYPES, SCOPES } from "./sqlite/knowledge.js";

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

@@ -0,0 +1,48 @@
+import type { CrmItem, CrmKind, CrmOrganization, CrmPerson, CrmPipeline } from "../../domain/crm.js";
+import { type DealKind } from "../../domain/deals.js";
+import type { AccountPeople } from "../people.js";
+import type { AccountKey } from "../types.js";
+import type { StoreContext } from "./open.js";
+/** What the store could not keep, and why: an item whose stage is not stored or whose field it refuses, or a pipeline. */
+export interface CrmSkipped {
+    externalId: string;
+    reason: "crm.stage-unknown" | "crm.item-invalid" | "crm.pipeline-clash";
+    message: string;
+}
+export interface CrmSaved {
+    saved: number;
+    skipped: CrmSkipped[];
+}
+/**
+ * A CRM account's copies in the store, written as the CRM has them: nothing waits for review (NEED-2271 A), and
+ * nothing is ever matched by name (WC-DATA-6). Rows the CRM no longer has are marked deleted, never removed
+ * (WC-DATA-7). Every write is one transaction per call.
+ */
+export interface CrmCopies {
+    /** One kind's pipelines and their stages, by the CRM's ids. A stage the CRM dropped stays: deals may stand in it. */
+    savePipelines(key: AccountKey, kind: DealKind, pipelines: CrmPipeline[]): Promise<CrmSaved>;
+    /** Deals or leads; one whose stage is not stored, or whose fields the store refuses, is skipped and named. */
+    saveItems(key: AccountKey, kind: DealKind, items: CrmItem[]): Promise<CrmSaved>;
+    /** Contacts, as identities of the account's provider; a contact joins a person only by its exact email. */
+    savePeople(key: AccountKey, people: CrmPerson[]): Promise<CrmSaved>;
+    /** Companies, each an organization of its own made on first sight, kept apart from any of the same name. */
+    saveOrganizations(key: AccountKey, organizations: CrmOrganization[]): Promise<CrmSaved>;
+    /** Marks deleted what the CRM said it deleted. Contacts stay: an identity has no deleted mark. Answers how many. */
+    remove(key: AccountKey, kind: CrmKind, externalIds: string[]): Promise<number>;
+    /**
+     * After a complete list of the kind's ids: marks deleted every stored one the list lacks that the CRM has not
+     * changed since `before` (epoch ms), so a row made while the list was read is never taken for a deleted one.
+     * `dryRun` only counts them.
+     */
+    removeUnlisted(key: AccountKey, kind: CrmKind, listed: string[], before: number, options?: {
+        dryRun?: boolean;
+    }): Promise<number>;
+    /** How many of the kind the account holds, not deleted; every contact it ever saved. */
+    count(key: AccountKey, kind: CrmKind): Promise<number>;
+}
+/**
+ * A contact's identity id: identities are unique per provider, and two portals of one CRM both have a contact 5.
+ * `contact:` references percent-encode it, so the `/` stays one part.
+ */
+export declare const crmIdentityId: (key: AccountKey, externalId: string, type?: "contact" | "user") => string;
+export declare const crmCopiesOver: (context: StoreContext, people: AccountPeople) => CrmCopies;