@ccmsg/protocol 1.11.0 → 1.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ccmsg/protocol",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "description": "Wire contract (schema + types + op attribute table) shared by the ccmsg daemon and web UI",
   "license": "MIT",
   "author": "kawaz",

package/src/control/dump.ts

@@ -1,6 +1,6 @@
 import { type Static, type TSchema, Type } from "@sinclair/typebox";
 import { request, response } from "../envelope.ts";
-import { Timestamp } from "../identifiers.ts";
+import { Sid, Timestamp } from "../identifiers.ts";
 
 /** The vocabulary a transcript is read in: item types, the shape one item
  * takes, the ledger of ids they carry, and the named selections a person dumps
@@ -396,6 +396,32 @@ export type DumpIdEntry = Static<typeof DumpIdEntry>;
 export const DumpIds = Type.Array(DumpIdEntry, { $id: "DumpIds" });
 export type DumpIds = Static<typeof DumpIds>;
 
+/** The file a dump is written to.
+ *
+ * The reply to a dump names a path rather than carrying the items, so the file
+ * is where they actually travel — which makes its shape as much a part of the
+ * contract as the reply is: a successor session handed the path, or a client
+ * that fetches it, would otherwise be reading a format nothing states. It
+ * repeats what it was asked for, because a file outlives the request that made
+ * it and has to say on its own what it is a dump of and what was left out. */
+export const SessionDumpFile = Type.Object(
+  {
+    sid: Sid,
+    /** The agent the dump is of, absent when it is of the session itself. */
+    agent_id: Type.Optional(Type.String()),
+    written_at: Timestamp,
+    /** The selection as applied: presets expanded and exclusions kept in
+     * place, so the file states what it holds without the instance's config
+     * having to be read beside it. */
+    types: Type.Array(TranscriptItemSelector),
+    /** Oldest first, as the transcript had them. */
+    items: Type.Array(TranscriptItem),
+    ids: DumpIds,
+  },
+  { $id: "SessionDumpFile" },
+);
+export type SessionDumpFile = Static<typeof SessionDumpFile>;
+
 /** A selection an operator named and can ask for by name.
  *
  * Presets are configured on the instance rather than fixed here, because what

package/src/fixtures/control.ts

@@ -48,6 +48,7 @@ import type {
 import type {
   DumpPresetsReadRequest,
   DumpPresetsReadResponse,
+  SessionDumpFile,
   TranscriptItem,
 } from "../control/dump.ts";
 import type {
@@ -163,7 +164,7 @@ export const SESSION_DUMP_WRITE_REQUEST: Static<typeof SessionDumpWriteRequest>
 export const SESSION_DUMP_WRITE_RESPONSE: Static<typeof SessionDumpWriteResponse> = {
   ok: true,
   request_id,
-  path: "/transcripts/6f1a2b3c.dump.md",
+  path: "/transcripts/6f1a2b3c.dump.json",
   instance,
   entries: { thinking: 41, "tool:Bash": 62, "tool:Read": 25 },
   ids: [
@@ -180,6 +181,16 @@ export const SESSION_DUMP_WRITE_RESPONSE: Static<typeof SessionDumpWriteResponse
   bytes: 65_536,
 };
 
+/** The file the reply above names, holding the items themselves. */
+export const SESSION_DUMP_FILE: Static<typeof SessionDumpFile> = {
+  sid,
+  agent_id: "a471372f2",
+  written_at: FIXTURE_NOW,
+  types: ["tool:Read", "tool:Write", "tool:Edit", "tool:Glob", "thinking"],
+  items: [],
+  ids: [{ kind: "agent", id: "a471372f2", label: "dump-kinds-design", status: "ok" }],
+};
+
 export const DUMP_PRESETS_READ_REQUEST: Static<typeof DumpPresetsReadRequest> = {
   request_id,
   op: "dump_presets_read",