@wirecat/cli-core 0.498.0 → 0.500.0

package/CHANGELOG.md

@@ -5,6 +5,73 @@ Notable changes to `@wirecat/cli-core` (`@wirecat/cli-messaging` up to 0.261.0,
 minor version may break callers, and says how under "Changed — may break callers". `pnpm docs:check` checks the
 shape of this file.
 
+## Unreleased
+
+## 0.500.0 — 31.10.2026
+
+### Added
+
+- **A memory or fact can be forgotten for good.** `store.memories.remove(ref)` and `store.facts.remove(ref)` erase the
+  row, every link from or to it, its tags, and its words, pieces and vectors in the search indexes, in one write. The
+  words indexes are merged and freed pages zeroed (`secure_delete`), so the text is not left in the file; the
+  write-ahead log is emptied when no reader holds it. A record that replaced it no longer names it (`supersedes:
+  null`). Removing a fact also erases the soft-deleted memory it was migrated from in version 2, which still held its
+  text. Both answer `{ ref, removed: true, links }`, where `links` counts the links erased.
+- **`store.facts.reject(ref)`** turns down a proposed fact: `FACT_STATUSES` gains `rejected`.
+- **`store.memories.sources(ref)` and `store.facts.sources(ref)`** read each evidence link back as an `EvidenceSource`:
+  `ref`, `kind`, `title`, `sender`, `at`, `excerpt` (280 characters at most), `tool` and `missing`. A source deleted
+  since is still listed, `missing: true` with no excerpt, where `evidence` leaves it out; `ref` is `null` when its row
+  is gone from the store.
+- **`Memory` and `Fact` carry `subjectName` and `subjectIsOwner`.** A person is named by their name, else the
+  owner's alias for them, else an identity's name; a project or organization by its name. The owner has no name in the
+  store, so `subjectName` is `null` and `subjectIsOwner` is `true`. The `memory` and `fact` entities gain optional
+  `subject_name`, `subject_is_owner` and `sources`.
+
+## 0.499.0 — 31.10.2026
+
+### Added
+
+- **`decodeChannels(bytes)` in `@wirecat/cli-core/speech` returns every channel of a recording:**
+  `{ channels: Pcm[], mixed }`. A phone call recorded in stereo keeps one speaker per channel, and `decodeAudio`
+  keeps only the first, so the other speaker was lost. `decodeAudio` is unchanged and now exported too. Opus,
+  Vorbis, FLAC and MP3 keep their channels apart; a format only ffmpeg reads arrives as one channel with
+  `mixed: true`, so a caller can tell a mixed-down call from a mono one.
+- **OpenAI transcription: `transcribeOpenAI(pcm, { apiKey, model, languages, prompt, keywords })`.** It sends one
+  channel to OpenAI's `/audio/transcriptions` (`gpt-transcribe` by default, `languages[]` and `keywords[]` as
+  repeated fields, no SDK) and answers `[{ start, end, text }]` in seconds: one piece per stretch of speech the
+  voice detector found, each sent alone, so two channels merge into a dialogue by `start`. Two stretches the
+  detector split only because speech ran past 20 seconds stay one piece. `gpt-transcribe` gives no timestamps, so
+  the times are the detector's: about 0.1–0.3 s late at the start and 0.5–0.8 s late at the end, and very quiet
+  speech is missed, as it is locally. `bundle: true` trades the turns for fewer requests: up to ten minutes
+  (`LONGEST_REQUEST_SECONDS`) in one. It needs the voice detector file that comes with any speech model
+  (`models download`), except bundled audio of up to ten minutes. A 429 or a server error is tried again, waiting
+  as long as `Retry-After` asks; errors carry `auth.failed` (401), `access.denied` (403, which OpenAI also answers
+  for an unsupported country), `transcription.quota-exhausted` (credit, spend or usage limit; never retried),
+  `transcription.no-key`, `transcription.too-large`, `provider.rate-limited` or `provider.unavailable`, and never
+  the key. A keyword with `<`, `>` or a line break is refused before sending.
+- **`recognizeLocalPieces(model, pcm)` gives the same timed pieces from a local model**, one per stretch of speech
+  the voice detector cut.
+- **`transcribeWith: "openai"` sends voice messages to OpenAI**, with the key `models keys set openai` or
+  `OPENAI_API_KEY` holds and the model in the profile's `transcribeModel` (`gpt-transcribe` when unset). Only when
+  named: `auto` never sends audio off the machine, and a read-only process refuses. A transcript heard this way is
+  kept as `openai:<model>`.
+- **Meeting transcription keeps who spoke.** `MeetingRecognitionSegment.speaker` (trimmed; `null` is none) is stored
+  as the row's speaker, and segments of different speakers may overlap — two people on a call talk over each
+  other. One speaker's own segments still may not, and segments without a speaker are checked as before. A
+  transcript whose `recognition.engine` is `openai` is stored as `openai/<model>`, format `openai-transcription`;
+  local transcripts keep `local/<engine>/<model>` exactly.
+
+### Changed — may break callers
+
+- **An unknown `transcribeWith` in a profile now refuses to transcribe** with `validation_error`, naming the four
+  values. Before, any value other than `local` silently meant asking the messenger first. `models list` and
+  `models download` still read such a profile. Set it to `auto`, `messenger`, `local` or `openai`.
+
+### Fixed
+
+- **`runs list` with nothing recorded no longer says a run is kept only with `--record`.** Every command that does
+  its work is kept by default; `record: false` in the config keeps failures only, and `--no-record` keeps nothing.
+
 ## 0.497.0 — 31.10.2026
 
 ### Added

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

@@ -10,13 +10,13 @@ export declare const calendarTools: ({
     inputSchema: {
         type: string;
         properties: {
+            limit?: undefined;
             account_id: {
                 type: string;
                 minimum: number;
             };
             words?: undefined;
             timezone?: undefined;
-            limit?: undefined;
             event?: undefined;
         } | {
             account_id: {
@@ -38,9 +38,9 @@ export declare const calendarTools: ({
             };
             event?: undefined;
         } | {
+            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
-            limit?: undefined;
             event: {
                 type: string;
                 minLength: number;
@@ -50,9 +50,9 @@ export declare const calendarTools: ({
                 minimum: number;
             };
         } | {
+            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
-            limit?: undefined;
             event?: undefined;
             account_id?: undefined;
         };
@@ -71,13 +71,13 @@ export declare const calendarTools: ({
     inputSchema: {
         type: string;
         properties: {
+            limit?: undefined;
             account_id: {
                 type: string;
                 minimum: number;
             };
             words?: undefined;
             timezone?: undefined;
-            limit?: undefined;
             event?: undefined;
         } | {
             account_id: {
@@ -99,9 +99,9 @@ export declare const calendarTools: ({
             };
             event?: undefined;
         } | {
+            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
-            limit?: undefined;
             event: {
                 type: string;
                 minLength: number;
@@ -111,9 +111,9 @@ export declare const calendarTools: ({
                 minimum: number;
             };
         } | {
+            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
-            limit?: undefined;
             event?: undefined;
             account_id?: undefined;
         };
@@ -132,13 +132,13 @@ export declare const calendarTools: ({
     inputSchema: {
         type: string;
         properties: {
+            limit?: undefined;
             account_id: {
                 type: string;
                 minimum: number;
             };
             words?: undefined;
             timezone?: undefined;
-            limit?: undefined;
             event?: undefined;
         } | {
             account_id: {
@@ -160,9 +160,9 @@ export declare const calendarTools: ({
             };
             event?: undefined;
         } | {
+            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
-            limit?: undefined;
             event: {
                 type: string;
                 minLength: number;
@@ -172,9 +172,9 @@ export declare const calendarTools: ({
                 minimum: number;
             };
         } | {
+            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
-            limit?: undefined;
             event?: undefined;
             account_id?: undefined;
         };
@@ -193,13 +193,13 @@ export declare const calendarTools: ({
     inputSchema: {
         type: string;
         properties: {
+            limit?: undefined;
             account_id: {
                 type: string;
                 minimum: number;
             };
             words?: undefined;
             timezone?: undefined;
-            limit?: undefined;
             event?: undefined;
         } | {
             account_id: {
@@ -221,9 +221,9 @@ export declare const calendarTools: ({
             };
             event?: undefined;
         } | {
+            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
-            limit?: undefined;
             event: {
                 type: string;
                 minLength: number;
@@ -233,9 +233,9 @@ export declare const calendarTools: ({
                 minimum: number;
             };
         } | {
+            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
-            limit?: undefined;
             event?: undefined;
             account_id?: undefined;
         };

package/dist/cli/messenger/hearing-command.js

@@ -23,7 +23,7 @@ export const hearForCommand = async (context, messenger, messages, transcribe, m
         const hearing = await hearVoices(messenger, messages, kept, transcribe && !offline
             ? {
                 choice: {
-                    ...choose(messenger, context.settings, model === undefined ? {} : { model }, context.env),
+                    ...choose(messenger, context.settings, model === undefined ? {} : { model }, context.env, context.keyring),
                     ...(context.recognizer ? { open: context.recognizer } : {}),
                 },
                 connect: connect ?? ((work) => context.withMessenger(work)),

package/dist/cli/messenger/models-command.js

@@ -89,7 +89,7 @@ const downloadAudioModel = async (command, messenger, id) => {
         finally {
             recognizer.free();
         }
-        const chosen = choose(messenger, context.settings, {}, context.env).model.id;
+        const chosen = choose(messenger, context.settings, {}, context.env, context.keyring).model.id;
         renderAnswer(command, context, itemOf(audioItem(model, directory, chosen)), downloaded);
     }, { unbounded: true });
 };
@@ -174,7 +174,7 @@ export const modelsCommand = (messenger) => {
             const rerankers = kinds === undefined || kinds === "reranker"
                 ? RERANK_MODELS.filter((model) => id === undefined || model.id === id)
                 : [];
-            const chosen = audioModels.length > 0 ? choose(messenger, context.settings, {}, context.env).model.id : "";
+            const chosen = audioModels.length > 0 ? choose(messenger, context.settings, {}, context.env, context.keyring).model.id : "";
             const catalogue = [
                 ...audioModels.map((model) => audioItem(model, modelsDirectory(context.env), chosen)),
                 ...textModels.map((model) => textItem(model, textModelsDirectory(context.env))),

package/dist/cli/messenger/transcribe-command.js

@@ -1,7 +1,8 @@
 import { annotate } from "@wirecat/cli-base/commands";
 import { openKept } from "../../speech/hearing.js";
 import { isInstalled } from "../../speech/install.js";
-import { choose, hearLocally, hearOnline, notDownloaded } from "../../speech/transcribe.js";
+import { choose, heardVia, hearLocally, hearOnline, keptSource, notDownloaded, } from "../../speech/transcribe.js";
+import { environmentOf } from "../context.js";
 import { REMOTE_READ } from "../effects.js";
 import { renderAnswer } from "../envelope.js";
 import { messengerContext } from "./context.js";
@@ -22,10 +23,13 @@ export const transcribeSubcommand = (messages, messenger) => annotate(messages.c
     .action(async function (chat, messageId) {
     const context = messengerContext(this, messenger);
     const choice = {
-        ...choose(messenger, context.settings, this.opts(), context.env),
+        ...choose(messenger, context.settings, this.opts(), context.env, context.keyring),
         ...(context.recognizer ? { open: context.recognizer } : {}),
+        ...signalOf(this),
     };
-    // Before connecting: a missing model should not cost a login.
+    // Before connecting: a missing model or OpenAI key should not cost a login.
+    if (choice.refusal)
+        throw choice.refusal;
     if (choice.with === "local" && !isInstalled(choice.model, choice.directory)) {
         throw notDownloaded(messenger, choice.model);
     }
@@ -51,17 +55,17 @@ export const transcribeSubcommand = (messages, messenger) => annotate(messages.c
         return [resolved, undefined, await hearOnline(messenger, connection, resolved, id, choice, read)];
     });
     const heard = before
-        ? {
-            messageId: id,
-            text: before.text,
-            pending: false,
-            ...(before.source === messenger.provider ? { via: before.source } : { via: "local", model: before.source }),
-        }
+        ? { messageId: id, text: before.text, pending: false, ...heardVia(before.source, messenger.provider) }
         : online instanceof Uint8Array
             ? await hearLocally(online, id, choice)
             : online;
     if (!heard.pending && !before) {
-        await withKept((kept) => kept.keep({ chatId, messageId: id }, heard.text, heard.model ?? heard.via));
+        await withKept((kept) => kept.keep({ chatId, messageId: id }, heard.text, keptSource(heard)));
     }
     renderAnswer(this, context, heardAnswer(heard, chatId), () => `${heard.text}\n`);
 });
+const signalOf = (command) => {
+    const { signal, commandSignal } = environmentOf(command);
+    const signals = [signal, commandSignal].filter((one) => one !== undefined);
+    return signals.length ? { signal: AbortSignal.any(signals) } : {};
+};

package/dist/cli/runs/command.js

@@ -41,7 +41,8 @@ export const runsCommand = (app) => {
             args: words.length ? { query: typedQuery(words) } : {},
         }));
         if (runs.length === 0)
-            renderer.note("nothing recorded — a run is kept with `--record`, or when it fails");
+            renderer.note("nothing recorded — a command that does its work is kept unless the config says `record: false` (then only " +
+                "failures) or it ran with `--no-record`");
     });
     annotate(command.command("show"), {
         examples: [`${app.command} runs show run-101`],

package/dist/domain/knowledge.d.ts

@@ -1,5 +1,5 @@
 export declare const FACT_TYPES: readonly ["fact", "statement", "question", "decision", "promise"];
-export declare const FACT_STATUSES: readonly ["proposed", "accepted", "superseded", "reversed"];
+export declare const FACT_STATUSES: readonly ["proposed", "accepted", "superseded", "reversed", "rejected"];
 export declare const MEMORY_KINDS: readonly ["summary", "digest", "preference"];
 export declare const MEMORY_STATUSES: readonly ["proposed", "confirmed", "stale", "superseded"];
 export declare const MEMORY_SCOPES: readonly ["personal", "work"];

package/dist/domain/knowledge.js

@@ -1,6 +1,6 @@
 import { TASK_KINDS } from "../tasks/index.js";
 export const FACT_TYPES = ["fact", "statement", "question", "decision", "promise"];
-export const FACT_STATUSES = ["proposed", "accepted", "superseded", "reversed"];
+export const FACT_STATUSES = ["proposed", "accepted", "superseded", "reversed", "rejected"];
 export const MEMORY_KINDS = ["summary", "digest", "preference"];
 export const MEMORY_STATUSES = ["proposed", "confirmed", "stale", "superseded"];
 export const MEMORY_SCOPES = ["personal", "work"];

package/dist/entities/fact.d.ts

@@ -4,9 +4,12 @@ export declare const fact: v.StrictObjectSchema<{
     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>;
+    /** 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 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<{
@@ -24,6 +27,17 @@ export declare const fact: v.StrictObjectSchema<{
     /** Who recorded it: the owner, or an agent whose fact waits as proposed. */
     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>;
+    /** 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 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>;

package/dist/entities/fact.js

@@ -1,6 +1,6 @@
 import * as v from "valibot";
 import { FACT_STATUSES, FACT_TYPES, MEMORY_SCOPES } 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 fact = v.strictObject({
     ref: reference,
     id,
@@ -9,6 +9,9 @@ export const fact = v.strictObject({
     status: v.picklist(FACT_STATUSES),
     project: v.nullable(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()),
     occurred_at: v.nullable(time),
     supersedes: v.nullable(reference),
     author,
@@ -19,6 +22,8 @@ export const fact = v.strictObject({
     /** Who recorded it: the owner, or an agent whose fact waits as proposed. */
     origin: v.picklist(["owner", "agent"]),
     evidence: v.array(reference),
+    /** With `--sources`: each piece of evidence read back. */
+    sources: v.optional(v.array(evidenceSource)),
     created_at: time,
     updated_at: time,
 });

package/dist/entities/fields.d.ts

@@ -10,6 +10,17 @@ export declare const count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>
 /** Fields of an answer item someone other than the owner wrote, as dotted paths: an agent reads them as data. */
 export declare const untrusted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
 export declare const providerMetadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
+/** A reference a memory or fact rests on, read back; `missing` once it was deleted since. */
+export declare const evidenceSource: 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>;
 export declare const author: v.StrictObjectSchema<{
     readonly type: v.PicklistSchema<["person", "bot"], undefined>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;

package/dist/entities/fields.js

@@ -10,6 +10,17 @@ export const count = v.pipe(v.number(), v.integer(), v.minValue(0));
 /** Fields of an answer item someone other than the owner wrote, as dotted paths: an agent reads them as data. */
 export const untrusted = v.optional(v.array(text));
 export const providerMetadata = v.optional(v.record(v.string(), v.unknown()));
+/** A reference a memory or fact rests on, read back; `missing` once it was deleted since. */
+export const evidenceSource = v.strictObject({
+    ref: v.nullable(reference),
+    kind: text,
+    title: v.nullable(text),
+    sender: v.nullable(text),
+    at: v.nullable(time),
+    excerpt: v.nullable(text),
+    tool: v.nullable(text),
+    missing: v.boolean(),
+});
 export const author = v.strictObject({
     type: v.picklist(["person", "bot"]),
     id,

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`">]>;

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/errors/reasons.d.ts

@@ -7,7 +7,7 @@ export declare const REASONS: ErrorReason[];
  * Detail keys an error from this package may carry, until each is registered on its own reason. Not `cause`:
  * that can hold a provider's or SQLite's raw text.
  */
-export declare const DETAILS: readonly ["contracts", "calendars", "allowed", "alternative", "arguments", "at", "available", "batch", "budget", "built", "candidates", "chat", "chat_id", "cli", "complete", "emitted_bytes", "exact", "forum", "guide", "hint", "id", "index", "kind", "limit", "limit_source", "max_bytes", "model", "name", "operation_id", "operation_ids", "text_limit", "store_refused_in", "partial_output", "path", "permission", "person_ids", "previous_chat_id", "profiles", "provider_error", "provider", "recovery", "reference", "remembered", "retry_at", "runtime", "saved", "scheduled_for", "script", "sent", "sent_count", "settlement_failed", "span", "sqlite", "stage", "standing", "state", "stderr", "term", "total", "upgraded", "wanted"];
+export declare const DETAILS: readonly ["contracts", "calendars", "allowed", "alternative", "arguments", "at", "available", "batch", "budget", "built", "candidates", "chat", "chat_id", "cli", "complete", "emitted_bytes", "exact", "forum", "guide", "hint", "id", "index", "kind", "limit", "limit_source", "max_bytes", "model", "name", "operation_id", "operation_ids", "text_limit", "store_refused_in", "partial_output", "path", "permission", "person_ids", "previous_chat_id", "profiles", "provider_error", "provider", "recovery", "reference", "remembered", "retry_at", "retry_after_ms", "runtime", "saved", "scheduled_for", "script", "sent", "sent_count", "settlement_failed", "span", "sqlite", "stage", "standing", "state", "stderr", "term", "total", "upgraded", "wanted"];
 /** What a CLI adds to the shared registry: its own reasons, and the detail keys its adapters raise. */
 export interface AppErrors {
     reasons?: readonly ErrorReason[];

package/dist/errors/reasons.js

@@ -88,6 +88,13 @@ const OTHERS = [
     validation("memory.evidence-required", "a memory needs its evidence"),
     validation("memory.scope-required", "a memory needs its scope"),
     ["model.not-downloaded", "not_found", "the model is not downloaded on this machine"],
+    ["transcription.no-key", "authentication_error", "no OpenAI key is set for transcription"],
+    validation("transcription.too-large", "the audio is over the transcription provider's size limit"),
+    [
+        "transcription.quota-exhausted",
+        "permission_error",
+        "the transcription provider account has no credit or limit left",
+    ],
     validation("name.invalid", "the name is not valid"),
     validation("output.choose-fields", "at a terminal, --json names the fields it prints"),
     validation("output.one-object", "a report is one JSON object; --jsonl streams lists only"),
@@ -201,6 +208,7 @@ export const DETAILS = [
     "reference",
     "remembered",
     "retry_at",
+    "retry_after_ms",
     "runtime",
     "saved",
     "scheduled_for",

package/dist/meetings/transcription.d.ts

@@ -19,6 +19,11 @@ export interface MeetingRecognitionSegment {
     startMs: number;
     endMs: number;
     text: string;
+    /**
+     * Who spoke, when the source knows — a channel of a two-channel call. Speakers may overlap; one speaker may not.
+     * Trimmed; `null` is no speaker.
+     */
+    speaker?: string | null;
 }
 export interface MeetingTranscriptionContext {
     maxBytes: number;