@wirecat/cli-core 0.409.0 → 0.410.0

package/CHANGELOG.md

@@ -5,6 +5,27 @@ 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.
 
+## 0.410.0 — 24.10.2026
+
+### Added
+
+- `buildDoctorReport`, `doctorReportFileName` and their report types are public through `/cli`.
+  Consumers can reuse run selection, identifier labelling and home-path redaction while retaining
+  typed diagnostic payloads and optional technical context. Existing reports keep their shape
+  when context is omitted. `eventFields: "recorded"` retains allowlisted recorded technical
+  fields for consumers that already include them; the default report projection is unchanged.
+
+### Fixed
+
+- **Meeting search continuation arguments match the generated MCP schema.** Stored numeric selector IDs are
+  serialized as strings in replay arguments, so an agent can pass the returned next step to the shared read tool
+  without converting IDs. Validated search requests still use numeric store IDs.
+
+- Media archives skip call events alongside service events and keyboards. A message containing
+  both a file and a call event now archives the file and verifies its checksum; call-only
+  messages make no download request. Unknown attachment kinds still fail rather than being
+  silently dropped.
+
 ## 0.409.0 — 24.10.2026
 
 ### Added

package/dist/cli/index.d.ts

@@ -112,6 +112,7 @@ export { type ModeProblem, type PrivateFiles, privateFiles, withSqliteSidecars }
 export { reactionsCommand } from "./messenger/reactions-command.js";
 export { callsCommand, stickersCommand } from "./messenger/records-command.js";
 export { repliesCommand } from "./messenger/replies-command.js";
+export { buildReport as buildDoctorReport, type Report as DoctorReport, type ReportContext as DoctorReportContext, reportFileName as doctorReportFileName, } from "./messenger/report.js";
 export { reviewCommand } from "./messenger/review.js";
 export { scheduleCommand } from "./messenger/schedule-command.js";
 export { allAnswer, allHitItem, type HitItem, type MessageHitItem, messageHitItem, type NoteHitItem, noteHitItem, } from "./messenger/search-answers.js";

package/dist/cli/index.js

@@ -106,6 +106,7 @@ export { privateFiles, withSqliteSidecars } from "./messenger/private-files.js";
 export { reactionsCommand } from "./messenger/reactions-command.js";
 export { callsCommand, stickersCommand } from "./messenger/records-command.js";
 export { repliesCommand } from "./messenger/replies-command.js";
+export { buildReport as buildDoctorReport, reportFileName as doctorReportFileName, } from "./messenger/report.js";
 export { reviewCommand } from "./messenger/review.js";
 export { scheduleCommand } from "./messenger/schedule-command.js";
 export { allAnswer, allHitItem, messageHitItem, noteHitItem, } from "./messenger/search-answers.js";

package/dist/cli/messenger/report.d.ts

@@ -1,9 +1,9 @@
 import { type RunMetadata } from "../../runs/run.js";
 import type { SendEntry } from "../../sends/journal.js";
-export interface Report {
+export interface Report<Doctor extends object = Record<string, unknown>> {
     createdAt: string;
     /** What `doctor --json` answers — versions, paths, counts and the messenger's own checks. */
-    doctor: Record<string, unknown>;
+    doctor: Doctor;
     /** The run the report is about: the one asked for, or the newest that failed. */
     run: {
         metadata: RunMetadata;
@@ -12,13 +12,25 @@ export interface Report {
     /** The newest write attempts — outcomes and ids, never text (`src/sends/journal.ts`). */
     sends: SendEntry[];
 }
+/** Optional technical context supplied by a consumer; it is redacted with the rest of the report. */
+export interface ReportContext {
+    createdAt?: never;
+    doctor?: never;
+    run?: never;
+    sends?: never;
+    version?: string;
+    runtime?: string;
+    platform?: string;
+    arch?: string;
+    profile?: string | null;
+}
 /**
  * **Everything a report holds is already free of content** — the doctor, the run log and the send
  * journal are built that way. Two things are added: every id becomes a label, and the home
- * directory is hidden, since paths name the person's account on this machine. Copied from max-cli.
+ * directory is hidden, since paths name the person's account on this machine.
  */
-export declare const buildReport: ({ doctor, runsDir, runId, command, sends, now, home, }: {
-    doctor: Record<string, unknown>;
+export declare const buildReport: <Doctor extends object, Context extends ReportContext = Record<never, never>>({ doctor, runsDir, runId, command, sends, now, home, context, eventFields, }: {
+    doctor: Doctor;
     runsDir: string;
     runId?: string;
     /** What to type to list runs, for the error when `runId` names none. */
@@ -26,7 +38,10 @@ export declare const buildReport: ({ doctor, runsDir, runId, command, sends, now
     sends: SendEntry[];
     now?: Date;
     home: string | undefined;
-}) => Report;
+    context?: Context;
+    /** Retain allowlisted recorded fields, including time and severity, for an existing consumer contract. */
+    eventFields?: "report" | "recorded";
+}) => Report<Doctor> & Omit<Context, keyof Report>;
 /**
  * Every field of a journal line that names a chat, a message or a write. A send's `operationId` is
  * its `sendId`, so one left raw would undo the other's label.

package/dist/cli/messenger/report.js

@@ -1,6 +1,7 @@
 import { createHash, randomBytes } from "node:crypto";
 import { join } from "node:path";
 import { CliError } from "@wirecat/cli-base";
+import { LOG_ATTRIBUTES } from "../../runs/log-attributes.js";
 import { findRun, listRuns, readEvents } from "../../runs/run.js";
 const RECENT_SENDS = 20;
 /** Only these fields of a run event travel; a field added later is left out until it is named here. */
@@ -18,21 +19,22 @@ const EVENT_FIELDS = [
 /**
  * **Everything a report holds is already free of content** — the doctor, the run log and the send
  * journal are built that way. Two things are added: every id becomes a label, and the home
- * directory is hidden, since paths name the person's account on this machine. Copied from max-cli.
+ * directory is hidden, since paths name the person's account on this machine.
  */
-export const buildReport = ({ doctor, runsDir, runId, command, sends, now = new Date(), home, }) => {
+export const buildReport = ({ doctor, runsDir, runId, command, sends, now = new Date(), home, context, eventFields = "report", }) => {
     const chosen = runId === undefined ? newestFailed(runsDir) : findRun(runsDir, runId);
     if (runId !== undefined && !chosen)
         throw new CliError("not_found", `no run ${runId} — \`${command} runs list\` names them`);
     const label = labeller();
     const account = doctor.account;
     const report = {
+        ...context,
         createdAt: now.toISOString(),
         doctor: {
             ...doctor,
             ...(account?.remembered ? { account: { ...account, remembered: label(account.remembered) } } : {}),
         },
-        run: chosen ? { metadata: chosen.metadata, events: readEvents(chosen.dir).map(eventOf(label)) } : null,
+        run: chosen ? { metadata: chosen.metadata, events: readEvents(chosen.dir).map(eventOf(label, eventFields)) } : null,
         sends: sends.slice(-RECENT_SENDS).map((entry) => labelled(entry, label)),
     };
     return JSON.parse(hideHome(JSON.stringify(report), home));
@@ -85,8 +87,21 @@ const labeller = () => {
     const salt = randomBytes(16);
     return (id) => `id:${createHash("sha256").update(salt).update(id).digest("hex").slice(0, 12)}`;
 };
-const eventOf = (label) => (event) => {
-    const kept = Object.fromEntries(Object.entries(event).filter(([key]) => EVENT_FIELDS.includes(key)));
+const RECORDED_FIELDS = new Set([...LOG_ATTRIBUTES, "time", "severity"]);
+const RECORDED_ID_FIELDS = new Set([
+    ...SEND_ID_FIELDS.map((key) => key.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`)),
+    "actor_id",
+    "target_id",
+]);
+const eventOf = (label, fields) => (event) => {
+    const kept = Object.fromEntries(Object.entries(event)
+        .filter(([key]) => (fields === "recorded" ? RECORDED_FIELDS.has(key) : EVENT_FIELDS.includes(key)))
+        .map(([key, value]) => [
+        key,
+        fields === "recorded" && RECORDED_ID_FIELDS.has(key) && value !== undefined && value !== null
+            ? label(String(value))
+            : value,
+    ]));
     const ids = kept.ids;
     if (typeof ids !== "object" || ids === null)
         return kept;

package/dist/domain/attachments.js

@@ -6,6 +6,7 @@ export const NOT_FILES = new Set([
     "location",
     "contact",
     "control",
+    "call",
     "inline_keyboard",
 ]);
 /** The stored kinds `has:<kind>` matches: MAX stores a file as `file`, Telegram as `document`. */

package/dist/meetings/cli/search.js

@@ -81,11 +81,11 @@ export const meetingHitSearchRequest = (query, options, signal) => {
 /** Parsed dates must become ISO values again so the CLI can replay its own continuation. */
 export const meetingSearchArguments = (query, options) => Object.fromEntries(Object.entries({
     query,
-    meeting_id: options.meetingId,
-    identity_id: options.identityId,
-    person_id: options.personId,
-    event_id: options.eventId,
-    series_id: options.seriesId,
+    meeting_id: options.meetingId?.toString(),
+    identity_id: options.identityId?.toString(),
+    person_id: options.personId?.toString(),
+    event_id: options.eventId?.toString(),
+    series_id: options.seriesId?.toString(),
     project: options.project,
     tag: options.tag,
     topic: options.topic,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.409.0",
+  "version": "0.410.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",
@@ -209,7 +209,7 @@
     "@types/node": "^22.20.4",
     "@types/pngjs": "6.0.5",
     "@vitest/coverage-v8": "^5.0.2",
-    "@wirecat/cli-base": "0.50.2",
+    "@wirecat/cli-base": "0.50.4",
     "commander": "15.0.0",
     "cspell": "10.3.6",
     "drizzle-kit": "1.0.0-rc.4",