@wirecat/cli-core 0.558.0 → 0.560.0

package/dist/mail/marks.js

@@ -8,7 +8,7 @@ export const HOLD_PARTIAL_MS = 7 * 86_400_000;
 /** Held emails kept on one mark at most; past it the oldest are skipped as partial. */
 const MOST_HELD = 500;
 const PREFIX = "consumer:";
-const noneSkipped = () => ({ bulk: 0, envelope: 0, partial: 0, draft: 0 });
+const noneSkipped = () => ({ bulk: 0, envelope: 0, partial: 0, draft: 0, suspicious: 0 });
 const keyOf = (holder) => {
     if (!HOLDER.test(holder))
         throw new CliError("validation_error", `a holder is lower-case letters, digits and dashes, not "${holder}"`);
@@ -59,6 +59,8 @@ const verdict = (email, now) => {
         return "envelope";
     if (email.bulk)
         return "bulk";
+    if (email.demoted)
+        return "suspicious";
     if (email.partial)
         return now - email.storedAt < HOLD_PARTIAL_MS ? "held" : "partial";
     return "read";
@@ -76,10 +78,15 @@ const parseCursor = (cursor) => {
  * only; the mark moves when the holder acknowledges. A holder with no mark starts from now: its first read is
  * empty and gives the cursor of the newest stored email.
  */
-export const readPastMark = async (store, mailbox, holder, { now = Date.now(), limit = MARK_BATCH } = {}) => {
+export const readPastMark = async (store, mailbox, holder, options = {}) => {
+    const { wanted, ...read } = await examine(store, mailbox, holder, options);
+    return { emails: await store.mail.emailHits(wanted), ...read };
+};
+/** `readPastMark` without the emails' text: the store ids it would read, by their verdicts. */
+const examine = async (store, mailbox, holder, { now = Date.now(), limit = MARK_BATCH }) => {
     const mark = await markOf(store, mailbox, holder);
     const account = await accountOf(store, mailbox);
-    const empty = { emails: [], more: false, held: 0, skipped: noneSkipped(), mark };
+    const empty = { wanted: [], more: false, held: 0, skipped: noneSkipped(), mark };
     if (!account)
         return { ...empty, cursor: cursorOf(0, now) };
     if (!mark)
@@ -105,9 +112,8 @@ export const readPastMark = async (store, mailbox, holder, { now = Date.now(), l
         else if (email.id > mark.throughId)
             skipped[said] += 1;
     }
-    const emails = await store.mail.emailHits(wanted.sort((a, b) => a - b));
     return {
-        emails,
+        wanted: wanted.sort((a, b) => a - b),
         cursor: cursorOf(batch.at(-1)?.id ?? mark.throughId, now),
         more: after.length > batch.length,
         held,
@@ -115,6 +121,29 @@ export const readPastMark = async (store, mailbox, holder, { now = Date.now(), l
         mark,
     };
 };
+/**
+ * Whether the holder has mail to read in any stored mailbox — what a schedule asks before it starts the holder's
+ * agent, so a run with nothing new costs no model call. Mail that is only skipped (bulk, envelopes, drafts,
+ * suspicious senders) moves the holder's mark here, as the agent would have acknowledged it, or it would wait
+ * forever behind the mark. A holder with no mark yet has mail to read: its first run sets the mark.
+ */
+export const holderHasMail = async (store, holder, now = Date.now()) => {
+    for (const mailbox of await store.accounts.accounts()) {
+        if (mailbox.provider !== "email")
+            continue;
+        for (;;) {
+            const read = await examine(store, mailbox, holder, { now });
+            if (!read.mark || read.wanted.length > 0)
+                return true;
+            if (read.cursor === cursorOf(read.mark.throughId, now))
+                break;
+            await acknowledgeMark(store, mailbox, holder, read.cursor, now);
+            if (!read.more)
+                break;
+        }
+    }
+    return false;
+};
 /**
  * Moves the holder's mark to the cursor its read gave, never back. An email whole when it was read counts read; one
  * still partial, or changed after the read (it may have become whole since), is held and comes with the next read.

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

@@ -73,7 +73,31 @@ export interface FindingsRules {
     anySubject?: boolean;
     /** Payment findings are staged on a project's evidence, not from a meeting. */
     payments?: boolean;
+    /** A task finding may name no project: it goes in its account's inbox. */
+    inboxTasks?: boolean;
 }
+/** A finding's cited evidence: 1–8 distinct references in `rules`' form, each with a 64-hex fingerprint. */
+export declare const validEvidence: (raw: unknown, rules: FindingsRules) => FindingEvidence[];
+/** A finding's simple key: unique among `ids`, which it joins. */
+export declare const findingId: (raw: unknown, ids: Set<string>) => string;
+/** One fact, payment or task finding, its ID added to `ids`. */
+export declare const validateFinding: (finding: Finding, rules: FindingsRules, ids: Set<string>) => Finding;
+/** A date's or assignee's support: references the finding's own evidence cites. */
+export declare const support: (value: unknown, evidence: readonly FindingEvidence[]) => string[];
+/** A batch's envelope — schema version, key, extractor — around 1–`most` findings each `one` checks. */
+export declare const validateBatch: <F>(input: {
+    schemaVersion: 1;
+    key: string;
+    extractor: string;
+    findings: unknown[];
+}, rules: Pick<FindingsRules, "plural" | "singular">, most: number, one: (finding: never, ids: Set<string>) => F) => {
+    schemaVersion: 1;
+    key: string;
+    extractor: string;
+    findings: F[];
+};
 export declare const validateFindings: (input: FindingsInput, rules: FindingsRules) => FindingsInput;
+export declare const findingText: (value: unknown, limit: number) => string;
+export declare const findingFields: (value: object, allowed: string[], noun: string) => void;
 export declare const findingFingerprint: ({ id: _id, ...finding }: Finding) => string;
 export {};

package/dist/meetings/findings-rules.js

@@ -17,132 +17,152 @@ const fields = (value, allowed, noun) => {
         invalid(`unknown ${noun} field`);
 };
 const SUBJECT = /^(person|organization|project):[1-9]\d*$|^task:[A-Za-z0-9][A-Za-z0-9_.-]{0,63}$/;
-export const validateFindings = (input, rules) => {
+/** A finding's cited evidence: 1–8 distinct references in `rules`' form, each with a 64-hex fingerprint. */
+export const validEvidence = (raw, rules) => {
+    if (!Array.isArray(raw) || raw.length < 1 || raw.length > 8)
+        return invalid(`a finding requires 1–8 cited ${rules.cited}s`);
+    const evidence = raw
+        .map((item) => {
+        if (!item || typeof item !== "object")
+            return invalid("finding evidence is a reference and fingerprint");
+        fields(item, ["reference", "fingerprint"], rules.singular);
+        if (typeof item.reference !== "string" || typeof item.fingerprint !== "string")
+            return invalid("evidence requires a reference and fingerprint");
+        const reference = rules.reference(item.reference);
+        if (!/^[a-f0-9]{64}$/.test(item.fingerprint))
+            return invalid(`finding evidence requires exact ${rules.cited} references and fingerprints`);
+        return { reference, fingerprint: item.fingerprint };
+    })
+        .sort((a, b) => a.reference.localeCompare(b.reference));
+    if (new Set(evidence.map((item) => item.reference)).size !== evidence.length)
+        return invalid(`duplicate evidence ${rules.cited}`);
+    return evidence;
+};
+/** A finding's simple key: unique among `ids`, which it joins. */
+export const findingId = (raw, ids) => {
+    const id = findingText(raw, 64);
+    if (!/^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$/.test(id) || ids.has(id))
+        return invalid("finding IDs must be unique simple keys");
+    ids.add(id);
+    return id;
+};
+/** One fact, payment or task finding, its ID added to `ids`. */
+export const validateFinding = (finding, rules, ids) => {
+    if (!finding || typeof finding !== "object")
+        return invalid("a finding is an object");
+    const id = findingId(finding.id, ids);
+    const project = finding.project === undefined && rules.anySubject ? undefined : text(finding.project, 64);
+    if (project !== undefined && !/^project:[1-9]\d*$/.test(project))
+        return invalid("a finding names a project reference");
+    if (finding.subject !== undefined && (!rules.anySubject || !SUBJECT.test(text(finding.subject, 80))))
+        return invalid("a finding's subject is a person:, organization:, task: or project: reference");
+    if (finding.kind === "task" && project === undefined && !rules.inboxTasks)
+        return invalid("a task finding names the project the task goes in");
+    const evidence = validEvidence(finding.evidence, rules);
+    const base = {
+        id,
+        ...(project === undefined ? {} : { project }),
+        ...(finding.subject === undefined ? {} : { subject: finding.subject }),
+        evidence,
+    };
+    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; money is a payments row, not a fact");
+        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 && !/^invoice:[1-9]\d*$/.test(String(finding.supersedes)))
+            return invalid("a payment finding supersedes an invoice: reference, the expected payment it settles or voids");
+        const payment = validatePayment(finding.payment);
+        if (payment.state === "expected" && finding.supersedes !== undefined)
+            return invalid("an expected payment supersedes nothing; a paid or cancelled one supersedes its invoice");
+        if (payment.state === "cancelled" && finding.supersedes === undefined)
+            return invalid("a cancelled payment names the invoice: it cancels in supersedes");
+        if (payment.state === "expected" && !/^(person|organization):/.test(payment.counterparty ?? ""))
+            return invalid("an expected payment becomes an invoice, which names its counterparty as a person: or organization:");
+        return {
+            ...base,
+            kind: "payment",
+            ...(finding.statement === undefined ? {} : { statement: text(finding.statement, 2000) }),
+            payment,
+            ...(finding.supersedes === undefined ? {} : { supersedes: finding.supersedes }),
+        };
+    }
+    if (finding.kind !== "task")
+        return invalid(`a finding is a fact${rules.payments ? ", payment" : ""} or task`);
+    fields(finding, [
+        "id",
+        "project",
+        "evidence",
+        "kind",
+        "type",
+        "title",
+        "reason",
+        "commitment",
+        "dueAt",
+        "dueEvidence",
+        "assignee",
+        "assigneeEvidence",
+    ], rules.singular);
+    if (!TASK_TYPES.includes(finding.type))
+        return invalid("a task finding type is bug, chore or feature");
+    if (!["explicit", "inferred"].includes(finding.commitment))
+        return invalid("task commitment must be explicit or inferred");
+    if ((finding.dueAt === undefined) !== (finding.dueEvidence === undefined) ||
+        (finding.assignee === undefined) !== (finding.assigneeEvidence === undefined))
+        return invalid("optional dates and assignees require their supporting evidence");
+    if (finding.assignee !== undefined &&
+        (typeof finding.assignee !== "string" || !/^person:[1-9]\d*$/.test(finding.assignee)))
+        return invalid("an assignee must be a person reference");
+    return {
+        ...base,
+        kind: "task",
+        type: finding.type,
+        title: text(finding.title, 300),
+        reason: text(finding.reason, 2000),
+        commitment: finding.commitment,
+        ...(finding.dueAt === undefined
+            ? {}
+            : {
+                dueAt: meetingTimestamp(finding.dueAt, "finding due date"),
+                dueEvidence: support(finding.dueEvidence, evidence),
+            }),
+        ...(finding.assignee === undefined
+            ? {}
+            : { assignee: finding.assignee, assigneeEvidence: support(finding.assigneeEvidence, evidence) }),
+    };
+};
+/** A date's or assignee's support: references the finding's own evidence cites. */
+export const support = (value, evidence) => {
+    if (!Array.isArray(value) ||
+        value.length < 1 ||
+        value.length > 8 ||
+        value.some((ref) => typeof ref !== "string" || !evidence.some((item) => item.reference === ref)))
+        return invalid("date and assignee support must cite the finding's evidence");
+    return [...new Set(value)].sort();
+};
+/** A batch's envelope — schema version, key, extractor — around 1–`most` findings each `one` checks. */
+export const validateBatch = (input, rules, most, one) => {
     if (!input || typeof input !== "object" || Buffer.byteLength(JSON.stringify(input), "utf8") > 65536)
         return invalid(`${rules.plural} take at most 65536 UTF-8 bytes`);
     fields(input, ["schemaVersion", "key", "extractor", "findings"], rules.singular);
     if (input.schemaVersion !== 1 ||
         !Array.isArray(input.findings) ||
         input.findings.length < 1 ||
-        input.findings.length > 16)
-        return invalid(`schemaVersion 1 takes 1–16 ${rules.plural}`);
+        input.findings.length > most)
+        return invalid(`schemaVersion 1 takes 1–${most} ${rules.plural}`);
     const key = text(input.key, 64);
     if (!/^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$/.test(key))
         return invalid("a findings key uses letters, digits, dot, colon, underscore or hyphen");
     const ids = new Set();
-    const findings = input.findings.map((finding) => {
-        if (!finding || typeof finding !== "object")
-            return invalid("a finding is an object");
-        const id = text(finding.id, 64);
-        if (!/^[a-zA-Z0-9][a-zA-Z0-9_.:-]*$/.test(id) || ids.has(id))
-            return invalid("finding IDs must be unique simple keys");
-        ids.add(id);
-        const project = finding.project === undefined && rules.anySubject ? undefined : text(finding.project, 64);
-        if (project !== undefined && !/^project:[1-9]\d*$/.test(project))
-            return invalid("a finding names a project reference");
-        if (finding.subject !== undefined && (!rules.anySubject || !SUBJECT.test(text(finding.subject, 80))))
-            return invalid("a finding's subject is a person:, organization:, task: or project: reference");
-        if (finding.kind === "task" && project === undefined)
-            return invalid("a task finding names the project the task goes in");
-        if (!Array.isArray(finding.evidence) || finding.evidence.length < 1 || finding.evidence.length > 8)
-            return invalid(`a finding requires 1–8 cited ${rules.cited}s`);
-        const evidence = finding.evidence
-            .map((item) => {
-            if (!item || typeof item !== "object")
-                return invalid("finding evidence is a reference and fingerprint");
-            fields(item, ["reference", "fingerprint"], rules.singular);
-            if (typeof item.reference !== "string" || typeof item.fingerprint !== "string")
-                return invalid("evidence requires a reference and fingerprint");
-            const reference = rules.reference(item.reference);
-            if (!/^[a-f0-9]{64}$/.test(item.fingerprint))
-                return invalid(`finding evidence requires exact ${rules.cited} references and fingerprints`);
-            return { reference, fingerprint: item.fingerprint };
-        })
-            .sort((a, b) => a.reference.localeCompare(b.reference));
-        if (new Set(evidence.map((item) => item.reference)).size !== evidence.length)
-            return invalid(`duplicate evidence ${rules.cited}`);
-        const base = {
-            id,
-            ...(project === undefined ? {} : { project }),
-            ...(finding.subject === undefined ? {} : { subject: finding.subject }),
-            evidence,
-        };
-        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; money is a payments row, not a fact");
-            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 && !/^invoice:[1-9]\d*$/.test(String(finding.supersedes)))
-                return invalid("a payment finding supersedes an invoice: reference, the expected payment it settles or voids");
-            const payment = validatePayment(finding.payment);
-            if (payment.state === "expected" && finding.supersedes !== undefined)
-                return invalid("an expected payment supersedes nothing; a paid or cancelled one supersedes its invoice");
-            if (payment.state === "cancelled" && finding.supersedes === undefined)
-                return invalid("a cancelled payment names the invoice: it cancels in supersedes");
-            if (payment.state === "expected" && !/^(person|organization):/.test(payment.counterparty ?? ""))
-                return invalid("an expected payment becomes an invoice, which names its counterparty as a person: or organization:");
-            return {
-                ...base,
-                kind: "payment",
-                ...(finding.statement === undefined ? {} : { statement: text(finding.statement, 2000) }),
-                payment,
-                ...(finding.supersedes === undefined ? {} : { supersedes: finding.supersedes }),
-            };
-        }
-        if (finding.kind !== "task")
-            return invalid(`a finding is a fact${rules.payments ? ", payment" : ""} or task`);
-        fields(finding, [
-            "id",
-            "project",
-            "evidence",
-            "kind",
-            "type",
-            "title",
-            "reason",
-            "commitment",
-            "dueAt",
-            "dueEvidence",
-            "assignee",
-            "assigneeEvidence",
-        ], rules.singular);
-        if (!TASK_TYPES.includes(finding.type))
-            return invalid("a task finding type is bug, chore or feature");
-        if (!["explicit", "inferred"].includes(finding.commitment))
-            return invalid("task commitment must be explicit or inferred");
-        const support = (value) => {
-            if (!Array.isArray(value) ||
-                value.length < 1 ||
-                value.length > 8 ||
-                value.some((ref) => typeof ref !== "string" || !evidence.some((item) => item.reference === ref)))
-                return invalid("date and assignee support must cite the finding's evidence");
-            return [...new Set(value)].sort();
-        };
-        if ((finding.dueAt === undefined) !== (finding.dueEvidence === undefined) ||
-            (finding.assignee === undefined) !== (finding.assigneeEvidence === undefined))
-            return invalid("optional dates and assignees require their supporting evidence");
-        if (finding.assignee !== undefined &&
-            (typeof finding.assignee !== "string" || !/^person:[1-9]\d*$/.test(finding.assignee)))
-            return invalid("an assignee must be a person reference");
-        return {
-            ...base,
-            kind: "task",
-            type: finding.type,
-            title: text(finding.title, 300),
-            reason: text(finding.reason, 2000),
-            commitment: finding.commitment,
-            ...(finding.dueAt === undefined
-                ? {}
-                : { dueAt: meetingTimestamp(finding.dueAt, "finding due date"), dueEvidence: support(finding.dueEvidence) }),
-            ...(finding.assignee === undefined
-                ? {}
-                : { assignee: finding.assignee, assigneeEvidence: support(finding.assigneeEvidence) }),
-        };
-    });
+    const findings = input.findings.map((finding) => one(finding, ids));
     return { schemaVersion: 1, key, extractor: text(input.extractor, 200), findings };
 };
+export const validateFindings = (input, rules) => validateBatch(input, rules, 16, (finding, ids) => validateFinding(finding, rules, ids));
+export const findingText = (value, limit) => text(value, limit);
+export const findingFields = (value, allowed, noun) => fields(value, allowed, noun);
 export const findingFingerprint = ({ id: _id, ...finding }) => findingHash(finding);

package/dist/meetings/index.d.ts

@@ -9,7 +9,7 @@ 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, type PaymentFinding, validateFindings, } from "./findings-rules.js";
+export { type FactFinding, type Finding, type FindingsInput, type FindingsReceipt, type FindingsRules, findingFields, findingFingerprint, findingId, findingText, type PaymentFinding, type TaskFinding, validateBatch, validateFinding, validateFindings, validEvidence, } 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";
@@ -53,6 +53,7 @@ export { validateMeetingSeriesInventoryCursor } from "./series-inventory-validat
 export type { MeetingSource, SourceParticipant } from "./source.js";
 export { aggregateMeetingStats, type MeetingSpeakerStats, type MeetingStats, type MeetingStatsInput, type MeetingStatsRow, type MeetingStatsSelection, type MeetingStatsStore, type MeetingWeekStats, } from "./stats.js";
 export type { ChatInput, ContractCase, EventCandidateFilter, IdentityInput, MeetingDetails, MeetingFilter, MeetingHitSource, MeetingInput, MeetingSave, MeetingStore, NewRecord, ParticipantInput, SearchHit, TranscriptInput, TranscriptLanguageFill, TranscriptRowInput, } from "./store.js";
+export { meetingTimestamp } from "./timestamp.js";
 export type { MeetingTranscriptReceiptStore, MeetingTranscriptStore, TranscriptAppend, TranscriptAppendReceipt, UnlinkedTranscriptInput, } from "./transcript-store.js";
 export { parseTranscriptText, TranscriptTextError, type TranscriptTextHeader } from "./transcript-text.js";
 export { type MeetingMediaDescriptor, type MeetingRecognitionSegment, type MeetingTranscriptionContext, type MeetingTranscriptionOptions, type MeetingTranscriptionReceipt, type MeetingTranscriptionSource, transcribeMeeting, } from "./transcription.js";

package/dist/meetings/index.js

@@ -6,7 +6,7 @@ export { entryInWindow, eventChange } from "./event-store.js";
 export { linkEvent } from "./events.js";
 export { exportMeeting, serializeVtt, } from "./export.js";
 export { findingHash, MEETING_FINDINGS_KIND, meetingFindingFingerprint, validateMeetingFindings, } from "./findings.js";
-export { findingFingerprint, validateFindings, } from "./findings-rules.js";
+export { findingFields, findingFingerprint, findingId, findingText, validateBatch, validateFinding, validateFindings, validEvidence, } from "./findings-rules.js";
 export { liftMeetingFields, MEETING_HIT_QUERY, meetingWordsQuery, parseMeetingQuery } from "./hit-query.js";
 export { importFiles } from "./import.js";
 export { MEETING_ISSUES, MEETING_QUERY, meeting, meetingIssuesOf, meetingItem, } from "./item.js";
@@ -39,6 +39,7 @@ export { validateMeetingSeriesHistory, } from "./series-history.js";
 export { createMeetingSeriesInventoryReader } from "./series-inventory.js";
 export { validateMeetingSeriesInventoryCursor } from "./series-inventory-validation.js";
 export { aggregateMeetingStats, } from "./stats.js";
+export { meetingTimestamp } from "./timestamp.js";
 export { parseTranscriptText, TranscriptTextError } from "./transcript-text.js";
 export { transcribeMeeting, } from "./transcription.js";
 export { createUpcomingMeetingReader } from "./upcoming.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/runs/secrets.d.ts

@@ -1,4 +1,6 @@
 export declare const secretNamed: (name: string) => boolean;
+/** A credential in a shape vendors publish so scanners find it: a known token prefix, a private key, a `Bearer` value. */
+export declare const holdsCredential: (text: string) => boolean;
 /**
  * Whether a run of token characters is a random string rather than words: long, mixed case, high Shannon entropy,
  * cut into short pieces (`Kz9vQ2mX`) where a name is cut into words (`InlineQueryResultMpeg4Gif`).

package/dist/runs/secrets.js

@@ -54,6 +54,8 @@ const PRIVATE_KEY = /-----BEGIN[A-Z ]* PRIVATE KEY-----[\s\S]*?(?:-----END[A-Z ]
 const SCHEME = /(?<![A-Za-z])(Bearer|Basic)(\s+)(?![A-Z]?[a-z]+(?![A-Za-z0-9]))[A-Za-z0-9._~+/=-]{8,}/g;
 // After a bare space only a value that is not a plain word: `pin 1234` is a secret, `pin this message` is not.
 const NAMED_PAIR = /(?<![\p{L}\p{N}])([\p{L}\p{N}_.-]*(?:token|pass|pwd|pin|otp|2fa|secret|credential|cookie|authorization|key|contrase|clave|пароль|пин|код)[\p{L}\p{N}_.-]*)(["']?\s*(?:=>|[:=])\s*["']?|\s+(?![\p{L}]+(?![\p{L}\p{N}])))((?:Bearer\s+|Basic\s+)?)([^\s"'&,;]+)/giu;
+/** A credential in a shape vendors publish so scanners find it: a known token prefix, a private key, a `Bearer` value. */
+export const holdsCredential = (text) => text.search(PRIVATE_KEY) >= 0 || text.search(KNOWN_TOKENS) >= 0 || text.search(SCHEME) >= 0;
 /**
  * Whether a run of token characters is a random string rather than words: long, mixed case, high Shannon entropy,
  * cut into short pieces (`Kz9vQ2mX`) where a name is cut into words (`InlineQueryResultMpeg4Gif`).

package/dist/services/index.d.ts

@@ -6,6 +6,7 @@ export { type ChatCoverage, chatCoverage } from "./chat-coverage.js";
 export type { ContextEvidenceItem, ContextEvidencePage, ContextEvidenceReader, ContextEvidenceRequest, ContextEvidenceSender, ContextIndex, ContextReadLimits, ContextReadUsage, ContextRecordReader, ContextSource, ScopedContextEvidenceReader, } from "./context-evidence.js";
 export { contextEvidenceFingerprint, createContextEvidenceReader } from "./context-evidence.js";
 export { excerpt } from "./excerpt.js";
+export { type IngestOptions, type IngestReceipt, ingest } from "./ingest.js";
 export { aliasHits, chatSenders, chatTitle, combinedScore, DEFAULT_LIMIT as DEFAULT_LINK_SCAN_LIMIT, DEFAULT_THRESHOLD as DEFAULT_LINK_SCAN_THRESHOLD, emailDomain, type LinkCandidate, type LinkScorer, mailThread, memberChats, memberDialog, PERSON_SCORERS, PERSON_THRESHOLD as PERSON_LINK_SCAN_THRESHOLD, SCAN_BOT, SCORERS, type ScanInput as LinkScanInput, type ScannedProject, type ScannedProposal, type ScanResult as LinkScanResult, type ScorerInput, type Signal as LinkSignal, scanProjectLinks, } from "./link-scorers/index.js";
 export type { MediaArchiveOptions, MediaArchivePorts } from "./media-archive.js";
 export { archiveMedia, checkMediaArchive } from "./media-archive.js";

package/dist/services/index.js

@@ -5,6 +5,7 @@ export { AGENDA_DEFAULTS } from "./agenda.js";
 export { chatCoverage } from "./chat-coverage.js";
 export { contextEvidenceFingerprint, createContextEvidenceReader } from "./context-evidence.js";
 export { excerpt } from "./excerpt.js";
+export { ingest } from "./ingest.js";
 export { aliasHits, chatSenders, chatTitle, combinedScore, DEFAULT_LIMIT as DEFAULT_LINK_SCAN_LIMIT, DEFAULT_THRESHOLD as DEFAULT_LINK_SCAN_THRESHOLD, emailDomain, mailThread, memberChats, memberDialog, PERSON_SCORERS, PERSON_THRESHOLD as PERSON_LINK_SCAN_THRESHOLD, SCAN_BOT, SCORERS, scanProjectLinks, } from "./link-scorers/index.js";
 export { archiveMedia, checkMediaArchive } from "./media-archive.js";
 export { moveMediaArchive } from "./media-archive-move.js";