@wirecat/cli-core 0.499.0 → 0.501.0

package/dist/entities/index.d.ts

@@ -5340,9 +5340,11 @@ export declare const ENTITIES: {
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
         readonly kind: v.PicklistSchema<readonly ["fact", "statement", "question", "decision", "promise"], undefined>;
         readonly text: v.StringSchema<undefined>;
-        readonly status: v.PicklistSchema<readonly ["proposed", "accepted", "superseded", "reversed"], undefined>;
+        readonly status: v.PicklistSchema<readonly ["proposed", "accepted", "superseded", "reversed", "rejected"], undefined>;
         readonly project: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly subject: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly subject_name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly subject_is_owner: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         readonly occurred_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 supersedes: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
         readonly author: v.StrictObjectSchema<{
@@ -5358,6 +5360,16 @@ export declare const ENTITIES: {
         readonly scope: v.NullableSchema<v.PicklistSchema<readonly ["personal", "work"], undefined>, undefined>;
         readonly origin: v.PicklistSchema<["owner", "agent"], undefined>;
         readonly evidence: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly sources: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            readonly kind: v.StringSchema<undefined>;
+            readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly sender: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly 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 excerpt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly tool: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly missing: v.BooleanSchema<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 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`">]>;
     }, undefined>;
@@ -5367,6 +5379,8 @@ export declare const ENTITIES: {
         readonly kind: v.PicklistSchema<readonly ["summary", "digest", "preference"], undefined>;
         readonly text: v.StringSchema<undefined>;
         readonly subject: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly subject_name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly subject_is_owner: v.OptionalSchema<v.BooleanSchema<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>]>;
@@ -5378,6 +5392,16 @@ export declare const ENTITIES: {
         readonly scope: v.PicklistSchema<readonly ["personal", "work"], undefined>;
         readonly supersedes: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
         readonly evidence: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly sources: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            readonly kind: v.StringSchema<undefined>;
+            readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly sender: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly 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 excerpt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly tool: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly missing: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly last_verified_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 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`">]>;
@@ -5505,11 +5529,19 @@ export declare const ENTITIES: {
             readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
             readonly has_more: v.BooleanSchema<undefined>;
             readonly next_page: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 2, undefined>]>, undefined>;
+            readonly total: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                readonly relation: v.PicklistSchema<["eq", "gte"], undefined>;
+            }, undefined>, undefined>;
         }, undefined>, v.StrictObjectSchema<{
             readonly mode: v.LiteralSchema<"cursor", undefined>;
             readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
             readonly has_more: v.BooleanSchema<undefined>;
             readonly next_cursor: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>, undefined>;
+            readonly total: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                readonly relation: v.PicklistSchema<["eq", "gte"], undefined>;
+            }, undefined>, undefined>;
         }, undefined>], undefined>;
         readonly fingerprint: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
         readonly limits: v.StrictObjectSchema<{
@@ -5665,11 +5697,19 @@ export declare const ENTITIES: {
             readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
             readonly has_more: v.BooleanSchema<undefined>;
             readonly next_page: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 2, undefined>]>, undefined>;
+            readonly total: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                readonly relation: v.PicklistSchema<["eq", "gte"], undefined>;
+            }, undefined>, undefined>;
         }, undefined>, v.StrictObjectSchema<{
             readonly mode: v.LiteralSchema<"cursor", undefined>;
             readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
             readonly has_more: v.BooleanSchema<undefined>;
             readonly next_cursor: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>, undefined>;
+            readonly total: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                readonly relation: v.PicklistSchema<["eq", "gte"], undefined>;
+            }, undefined>, undefined>;
         }, undefined>], undefined>;
         readonly coverage: v.StrictObjectSchema<{
             readonly archive_completeness: v.LiteralSchema<"unknown", undefined>;
@@ -6028,11 +6068,19 @@ export declare const ENTITIES: {
                     readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
                     readonly has_more: v.BooleanSchema<undefined>;
                     readonly next_page: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 2, undefined>]>, undefined>;
+                    readonly total: v.OptionalSchema<v.StrictObjectSchema<{
+                        readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                        readonly relation: v.PicklistSchema<["eq", "gte"], undefined>;
+                    }, undefined>, undefined>;
                 }, undefined>, v.StrictObjectSchema<{
                     readonly mode: v.LiteralSchema<"cursor", undefined>;
                     readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
                     readonly has_more: v.BooleanSchema<undefined>;
                     readonly next_cursor: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>, undefined>;
+                    readonly total: v.OptionalSchema<v.StrictObjectSchema<{
+                        readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                        readonly relation: v.PicklistSchema<["eq", "gte"], undefined>;
+                    }, undefined>, undefined>;
                 }, undefined>], undefined>;
                 readonly coverage: v.StrictObjectSchema<{
                     readonly archive_completeness: v.LiteralSchema<"unknown", undefined>;

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

@@ -345,11 +345,19 @@ export declare const meetingPreparation: v.StrictObjectSchema<{
                 readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
                 readonly has_more: v.BooleanSchema<undefined>;
                 readonly next_page: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 2, undefined>]>, undefined>;
+                readonly total: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                    readonly relation: v.PicklistSchema<["eq", "gte"], undefined>;
+                }, undefined>, undefined>;
             }, undefined>, v.StrictObjectSchema<{
                 readonly mode: v.LiteralSchema<"cursor", undefined>;
                 readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
                 readonly has_more: v.BooleanSchema<undefined>;
                 readonly next_cursor: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>, undefined>;
+                readonly total: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                    readonly relation: v.PicklistSchema<["eq", "gte"], undefined>;
+                }, undefined>, undefined>;
             }, undefined>], undefined>;
             readonly coverage: v.StrictObjectSchema<{
                 readonly archive_completeness: v.LiteralSchema<"unknown", undefined>;

package/dist/entities/meeting-series-inventory.d.ts

@@ -19,11 +19,19 @@ export declare const meetingSeriesInventory: v.StrictObjectSchema<{
         readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
         readonly has_more: v.BooleanSchema<undefined>;
         readonly next_page: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 2, undefined>]>, undefined>;
+        readonly total: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly relation: v.PicklistSchema<["eq", "gte"], undefined>;
+        }, undefined>, undefined>;
     }, undefined>, v.StrictObjectSchema<{
         readonly mode: v.LiteralSchema<"cursor", undefined>;
         readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
         readonly has_more: v.BooleanSchema<undefined>;
         readonly next_cursor: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>, undefined>;
+        readonly total: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly relation: v.PicklistSchema<["eq", "gte"], undefined>;
+        }, undefined>, undefined>;
     }, undefined>], undefined>;
     readonly fingerprint: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
     readonly limits: v.StrictObjectSchema<{

package/dist/entities/memory.d.ts

@@ -5,6 +5,9 @@ export declare const memory: v.StrictObjectSchema<{
     readonly kind: v.PicklistSchema<readonly ["summary", "digest", "preference"], undefined>;
     readonly text: v.StringSchema<undefined>;
     readonly subject: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+    /** What the subject is called; `null` for the owner and for a row with no name. */
+    readonly subject_name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    readonly subject_is_owner: v.OptionalSchema<v.BooleanSchema<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>]>;
@@ -16,6 +19,17 @@ export declare const memory: v.StrictObjectSchema<{
     readonly scope: v.PicklistSchema<readonly ["personal", "work"], undefined>;
     readonly supersedes: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
     readonly evidence: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+    /** With `--sources`: each piece of evidence read back. */
+    readonly sources: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+        readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly kind: v.StringSchema<undefined>;
+        readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly sender: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly 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 excerpt: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly tool: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly missing: v.BooleanSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
     readonly last_verified_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 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`">]>;

package/dist/entities/memory.js

@@ -1,12 +1,15 @@
 import * as v from "valibot";
 import { MEMORY_KINDS, MEMORY_SCOPES, MEMORY_STATUSES } from "../domain/knowledge.js";
-import { author, id, reference, text, time } from "./fields.js";
+import { author, evidenceSource, id, reference, text, time } from "./fields.js";
 export const memory = v.strictObject({
     ref: reference,
     id,
     kind: v.picklist(MEMORY_KINDS),
     text,
     subject: v.nullable(reference),
+    /** What the subject is called; `null` for the owner and for a row with no name. */
+    subject_name: v.optional(v.nullable(text)),
+    subject_is_owner: v.optional(v.boolean()),
     author,
     model: v.nullable(text),
     confidence: v.nullable(v.number()),
@@ -14,6 +17,8 @@ export const memory = v.strictObject({
     scope: v.picklist(MEMORY_SCOPES),
     supersedes: v.nullable(reference),
     evidence: v.array(reference),
+    /** With `--sources`: each piece of evidence read back. */
+    sources: v.optional(v.array(evidenceSource)),
     last_verified_at: v.nullable(time),
     created_at: time,
     updated_at: time,

package/dist/mcp/meeting-preparation.d.ts

@@ -412,11 +412,19 @@ export declare const callMeetingPreparationTool: (read: MeetingPreparationReader
                     limit: number;
                     has_more: boolean;
                     next_page?: number | undefined;
+                    total?: {
+                        value: number;
+                        relation: "eq" | "gte";
+                    } | undefined;
                 } | {
                     mode: "cursor";
                     limit: number;
                     has_more: boolean;
                     next_cursor?: string | undefined;
+                    total?: {
+                        value: number;
+                        relation: "eq" | "gte";
+                    } | undefined;
                 };
                 coverage: {
                     archive_completeness: "unknown";

package/dist/mcp/meeting-series-inventory.d.ts

@@ -81,11 +81,19 @@ export declare const callMeetingSeriesInventoryTool: (read: MeetingSeriesInvento
             limit: number;
             has_more: boolean;
             next_page?: number | undefined;
+            total?: {
+                value: number;
+                relation: "eq" | "gte";
+            } | undefined;
         } | {
             mode: "cursor";
             limit: number;
             has_more: boolean;
             next_cursor?: string | undefined;
+            total?: {
+                value: number;
+                relation: "eq" | "gte";
+            } | undefined;
         };
         fingerprint: string;
         limits: {

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

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

package/dist/meetings/project-evidence-answer.d.ts

@@ -60,11 +60,19 @@ export declare const meetingProjectEvidence: v.StrictObjectSchema<{
         readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
         readonly has_more: v.BooleanSchema<undefined>;
         readonly next_page: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 2, undefined>]>, undefined>;
+        readonly total: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly relation: v.PicklistSchema<["eq", "gte"], undefined>;
+        }, undefined>, undefined>;
     }, undefined>, v.StrictObjectSchema<{
         readonly mode: v.LiteralSchema<"cursor", undefined>;
         readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
         readonly has_more: v.BooleanSchema<undefined>;
         readonly next_cursor: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "must not be empty">]>, undefined>;
+        readonly total: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly value: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly relation: v.PicklistSchema<["eq", "gte"], undefined>;
+        }, undefined>, undefined>;
     }, undefined>], undefined>;
     readonly coverage: v.StrictObjectSchema<{
         readonly archive_completeness: v.LiteralSchema<"unknown", undefined>;

package/dist/search/total.d.ts

@@ -0,0 +1,13 @@
+/** How many records match a search, every page together, shaped as Elasticsearch's `hits.total`. */
+export interface SearchTotal {
+    value: number;
+    /** `eq`: the exact count. `gte`: at least `value`; counting stopped at the cap or could not be done cheaply. */
+    relation: "eq" | "gte";
+}
+/** Matches counted at most, as Elasticsearch's default `track_total_hits`; past it the total is `gte`. */
+export declare const TOTAL_CAP = 10000;
+/**
+ * A total from a count capped at `TOTAL_CAP` (`undefined` when it could not be counted), never below what the pages
+ * already showed: `shown` hits, and one more when `hasMore`.
+ */
+export declare const totalOf: (count: number | undefined, shown: number, hasMore: boolean, exact?: boolean) => SearchTotal;

package/dist/search/total.js

@@ -0,0 +1,14 @@
+/** Matches counted at most, as Elasticsearch's default `track_total_hits`; past it the total is `gte`. */
+export const TOTAL_CAP = 10_000;
+/**
+ * A total from a count capped at `TOTAL_CAP` (`undefined` when it could not be counted), never below what the pages
+ * already showed: `shown` hits, and one more when `hasMore`.
+ */
+export const totalOf = (count, shown, hasMore, exact = true) => {
+    const least = shown + (hasMore ? 1 : 0);
+    if (count === undefined || count < least)
+        return { value: least, relation: "gte" };
+    if (count > TOTAL_CAP)
+        return { value: TOTAL_CAP, relation: "gte" };
+    return { value: count, relation: exact ? "eq" : "gte" };
+};

package/dist/services/index.d.ts

@@ -142,6 +142,7 @@ export declare const servicesFor: (deps: ServiceDeps) => Services;
 export { entriesOfList, type ListContext, type ListedEntry } from "../search/account-list.js";
 export { FIELD_VERSION, QUERY_FIELDS, QUERY_OPERATORS, validateAst } from "../search/lucene/registry.js";
 export { QUERY_LIMITS, QUERY_VERSION } from "../search/lucene/types.js";
+export { type SearchTotal, TOTAL_CAP } from "../search/total.js";
 export { TASK_KINDS, TASK_ORIGINS, type TaskKind, type TaskOrigin } from "../tasks/index.js";
 export type { AdminFound, AdminQuery, AdminSelection, AdminStatisticsService } from "./admin-statistics.js";
 export { adminStatisticsService } from "./admin-statistics.js";
@@ -170,7 +171,7 @@ export type { MeaningLane, MeaningSkipped } from "./messages-discovery.js";
 export { meaningLane } from "./messages-meaning.js";
 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, searchNotes, searchNotesOf, searchNotesQuery, storeQuery, } from "./notes-search.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 { type PersonMeetingContext, type PersonMeetingContextItem, type PersonMeetingContextOptions, type PersonMeetingReadStore, personMeetingContext, } from "./person-meeting-context.js";
 export { privatePeopleService } from "./private-people.js";

package/dist/services/index.js

@@ -107,6 +107,7 @@ export const servicesFor = (deps) => {
 export { entriesOfList } from "../search/account-list.js";
 export { FIELD_VERSION, QUERY_FIELDS, QUERY_OPERATORS, validateAst } from "../search/lucene/registry.js";
 export { QUERY_LIMITS, QUERY_VERSION } from "../search/lucene/types.js";
+export { TOTAL_CAP } from "../search/total.js";
 export { TASK_KINDS, TASK_ORIGINS } from "../tasks/index.js";
 export { adminStatisticsService } from "./admin-statistics.js";
 export { GAP_BOUNDS, gapsService } from "./archive-gaps.js";
@@ -128,7 +129,7 @@ export { proposeMeetingTask } from "./meeting-task-proposal.js";
 export { createTaskFromMeeting, readMeetingTask, } from "./meeting-tasks.js";
 export { meaningLane } from "./messages-meaning.js";
 export { metadataService } from "./metadata.js";
-export { embedEvents, embedMail, embedNotes, nearestNotes, searchNotes, searchNotesOf, searchNotesQuery, storeQuery, } from "./notes-search.js";
+export { embedEvents, embedMail, embedNotes, nearestNotes, RANK_WITHIN, searchNotes, searchNotesOf, searchNotesQuery, storeQuery, } from "./notes-search.js";
 export { upgradePackage, } from "./package-upgrade.js";
 export { personMeetingContext, } from "./person-meeting-context.js";
 export { privatePeopleService } from "./private-people.js";

package/dist/services/messages-archive-search.js

@@ -1,7 +1,8 @@
-import { CliError } from "@wirecat/cli-base";
+import { CliError, isCliError } from "@wirecat/cli-base";
 import { parseLocator } from "../domain/locator.js";
-import { searchDiscovery } from "./messages-discovery.js";
-import { searchLucene, statsLucene } from "./messages-search.js";
+import { TOTAL_CAP, totalOf } from "../search/total.js";
+import { discoveryRequest, searchDiscovery } from "./messages-discovery.js";
+import { countLucene, searchLucene, statsLucene } from "./messages-search.js";
 import { readThreadContext, threadBounds } from "./thread-context.js";
 /** How long a search may spend building the word index, then the stems, first (phase 2 plan S3: about 200 ms). */
 export const SEARCH_FILL_MS = 200;
@@ -48,8 +49,17 @@ export const searchStore = async (store, account, request, messenger = {}, meani
     if (!Number.isInteger(offset) || offset < 0 || offset > MAX_SEARCH_OFFSET)
         throw new CliError("validation_error", `offset takes a whole number from 0 to ${MAX_SEARCH_OFFSET}`);
     const found = await searchPage(store, account, { ...request, limit: request.limit + offset }, messenger, meaning, rerank);
+    const discovery = found.query?.discovery;
+    const total = discovery
+        ? totalOf(discovery.candidates, found.items.length, found.hasMore, !discovery.truncated)
+        : totalOf(await countLucene(store, account, { ...(request.discover ? discoveryRequest(request) : request), limit: request.limit + offset }, messenger, TOTAL_CAP).catch((error) => {
+            if (isCliError(error) && error.details.reason === "query.too-large")
+                return undefined;
+            throw error;
+        }), found.items.length, found.hasMore);
     return {
         ...found,
+        total,
         items: found.items.slice(offset),
         ...(found.hasMore && offset + request.limit <= MAX_SEARCH_OFFSET ? { nextOffset: offset + request.limit } : {}),
     };

package/dist/services/messages-discovery.d.ts

@@ -55,6 +55,12 @@ export type MeaningLane = (question: string, accounts: AccountKey[], embedders?:
 } | {
     skipped: MeaningSkipped;
 }>;
+/**
+ * The query discovery searches. A question's own "?" would parse as a one-character wildcard and send it to strict
+ * search (BUG-395); the colon of a time or ratio ("22:00", "1:1") would parse as a field and fail the whole search,
+ * and escaped it is syntax again, so it splits the numbers (BUG-450). A quoted timestamp keeps its colons (BUG-458).
+ */
+export declare const discoveryRequest: (asked: SearchQuery) => SearchQuery;
 export declare const searchDiscovery: (store: MessageStore, account: AccountKey, asked: SearchQuery, messenger?: Partial<Pick<MessengerTraits, "savedChatId" | "app" | "history" | "provider">>, meaning?: MeaningLane, rerank?: RerankLane) => Promise<SearchFound>;
 /** The nearest messages the question's filters allow, as hits, nearest first. */
 export declare const nearEligible: (store: MessageStore, account: AccountKey, request: SearchQuery, messenger: Partial<Pick<MessengerTraits, "savedChatId" | "app" | "history" | "provider">>, ranked: MeaningRanked, scope: string) => Promise<(FoundMessage & {

package/dist/services/messages-discovery.js

@@ -28,18 +28,21 @@ const FOLLOW_UPS_PER_HIT = 2;
 const RARE_AT = 3;
 /** Later messages read per hit before the search's filters; the latest that pass are kept. */
 const FOLLOW_UP_CANDIDATES = 20;
+/**
+ * The query discovery searches. A question's own "?" would parse as a one-character wildcard and send it to strict
+ * search (BUG-395); the colon of a time or ratio ("22:00", "1:1") would parse as a field and fail the whole search,
+ * and escaped it is syntax again, so it splits the numbers (BUG-450). A quoted timestamp keeps its colons (BUG-458).
+ */
+export const discoveryRequest = (asked) => asked.ast !== undefined || asked.exact || !asked.text
+    ? asked
+    : {
+        ...asked,
+        text: asked.text
+            .replace(/(?<=\p{L})\?(?=\s|$)/gu, "")
+            .replace(/"(?:[^"\\]|\\.)*"|(?<=\d):(?=\d)/gu, (found) => (found === ":" ? " " : found)),
+    };
 export const searchDiscovery = async (store, account, asked, messenger = {}, meaning, rerank) => {
-    // A question's own "?" would parse as a one-character wildcard and send it to strict search (BUG-395); the
-    // colon of a time or ratio ("22:00", "1:1") would parse as a field and fail the whole search, and escaped it is
-    // syntax again, so it splits the numbers (BUG-450). A quoted timestamp keeps its colons (BUG-458).
-    const request = asked.ast !== undefined || asked.exact || !asked.text
-        ? asked
-        : {
-            ...asked,
-            text: asked.text
-                .replace(/(?<=\p{L})\?(?=\s|$)/gu, "")
-                .replace(/"(?:[^"\\]|\\.)*"|(?<=\d):(?=\d)/gu, (found) => (found === ":" ? " " : found)),
-        };
+    const request = discoveryRequest(asked);
     const original = await prepareLucene(store, account, request, messenger);
     const text = request.text ?? "";
     const plan = planQuestion(text, request.ast !== undefined || !!request.exact || !!request.newest);