@camox/api-contract 0.71.0 → 0.72.0

package/dist/drafts.d.ts

@@ -42,17 +42,17 @@ export declare const LOOK_PATH_PARAM = "path";
 export declare const LOOK_LOCALE_PARAM = "locale";
 /**
  * The look document's Block Definition mode: instead of a page, the block of the Block Definition
- * `LOOK_BLOCK_DEFINITION_PARAM` names, alone in the site's shell, with its default content and
- * Block Settings and the overrides `LOOK_CONTENT_PARAM` and `LOOK_SETTINGS_PARAM` give as JSON, in
- * the shape the content tools take.
+ * `LOOK_BLOCK_DEFINITION_PARAM` names, alone in the site's shell, with empty fields and the
+ * content and Block Settings `LOOK_CONTENT_PARAM` and `LOOK_SETTINGS_PARAM` give as JSON merged
+ * on, in the shape the content tools take.
  */
 export declare const LOOK_BLOCK_DEFINITION_PARAM = "blockDefinition";
 export declare const LOOK_CONTENT_PARAM = "content";
 export declare const LOOK_SETTINGS_PARAM = "settings";
 /**
  * The look document's Layout Definition mode: instead of a page, the curated Layout
- * `LOOK_LAYOUT_DEFINITION_PARAM` names, alone in the site's shell, its blocks with their default
- * content and Block Settings and the overrides `LOOK_BLOCKS_PARAM` gives as JSON, by Block
+ * `LOOK_LAYOUT_DEFINITION_PARAM` names, alone in the site's shell, its blocks with empty fields
+ * and the content and Block Settings `LOOK_BLOCKS_PARAM` gives as JSON merged on, by Block
  * Definition name (`{ navbar: { content, settings } }`), around a labelled placeholder where a
  * page's content goes, as tall as `LOOK_PLACEHOLDER_PARAM` says: one of `LOOK_PLACEHOLDER_HEIGHTS`,
  * the first without.

package/dist/drafts.js

@@ -42,17 +42,17 @@ const LOOK_PATH_PARAM = "path";
 const LOOK_LOCALE_PARAM = "locale";
 /**
 * The look document's Block Definition mode: instead of a page, the block of the Block Definition
-* `LOOK_BLOCK_DEFINITION_PARAM` names, alone in the site's shell, with its default content and
-* Block Settings and the overrides `LOOK_CONTENT_PARAM` and `LOOK_SETTINGS_PARAM` give as JSON, in
-* the shape the content tools take.
+* `LOOK_BLOCK_DEFINITION_PARAM` names, alone in the site's shell, with empty fields and the
+* content and Block Settings `LOOK_CONTENT_PARAM` and `LOOK_SETTINGS_PARAM` give as JSON merged
+* on, in the shape the content tools take.
 */
 const LOOK_BLOCK_DEFINITION_PARAM = "blockDefinition";
 const LOOK_CONTENT_PARAM = "content";
 const LOOK_SETTINGS_PARAM = "settings";
 /**
 * The look document's Layout Definition mode: instead of a page, the curated Layout
-* `LOOK_LAYOUT_DEFINITION_PARAM` names, alone in the site's shell, its blocks with their default
-* content and Block Settings and the overrides `LOOK_BLOCKS_PARAM` gives as JSON, by Block
+* `LOOK_LAYOUT_DEFINITION_PARAM` names, alone in the site's shell, its blocks with empty fields
+* and the content and Block Settings `LOOK_BLOCKS_PARAM` gives as JSON merged on, by Block
 * Definition name (`{ navbar: { content, settings } }`), around a labelled placeholder where a
 * page's content goes, as tall as `LOOK_PLACEHOLDER_PARAM` says: one of `LOOK_PLACEHOLDER_HEIGHTS`,
 * the first without.

package/dist/index.d.ts

@@ -17,6 +17,29 @@ export declare function artifactTitle(source: string): string;
  */
 export declare function artifactSourceHash(source: string): Promise<string>;
 //#endregion
+//#region src/empty-values.d.ts
+/**
+ * What a field holds before anyone writes it: the empty value of its kind. Fields declare no
+ * default, so content missing a field, or holding a value of the wrong kind, reads as this.
+ * Shared by the SDK (rendering, new repeatable items, authoring forms) and the API (creating
+ * content, conforming it on read), so both agree on what an unset field is.
+ */
+/** A link that goes nowhere yet. */
+export declare const EMPTY_LINK: {
+  readonly type: "external";
+  readonly text: "";
+  readonly href: "";
+  readonly newTab: false;
+};
+/**
+ * The empty value of a field, from its stored JSON Schema (`fieldType` and, for an enum, its
+ * options): `""` for text, a link to nowhere, `false`, an enum's first option, `null` for one
+ * asset or record, and `[]` for lists and repeaters. A fresh copy each call.
+ */
+export declare function emptyFieldValue(fieldSchema: unknown): unknown;
+/** The empty value of every field of a content or settings schema, by name. */
+export declare function emptyFieldValues(schema: unknown): Record<string, unknown>;
+//#endregion
 //#region src/record-templates.d.ts
 /**
  * A collection's `toTitle` and `toDescription` are record templates: text with `{{field}}` tokens

package/dist/index.js

@@ -43,6 +43,51 @@ async function artifactSourceHash(source) {
 	return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
 }
 
+//#endregion
+//#region src/empty-values.ts
+/**
+* What a field holds before anyone writes it: the empty value of its kind. Fields declare no
+* default, so content missing a field, or holding a value of the wrong kind, reads as this.
+* Shared by the SDK (rendering, new repeatable items, authoring forms) and the API (creating
+* content, conforming it on read), so both agree on what an unset field is.
+*/
+/** A link that goes nowhere yet. */
+const EMPTY_LINK = {
+	type: "external",
+	text: "",
+	href: "",
+	newTab: false
+};
+function isObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* The empty value of a field, from its stored JSON Schema (`fieldType` and, for an enum, its
+* options): `""` for text, a link to nowhere, `false`, an enum's first option, `null` for one
+* asset or record, and `[]` for lists and repeaters. A fresh copy each call.
+*/
+function emptyFieldValue(fieldSchema) {
+	const schema = isObject(fieldSchema) ? fieldSchema : {};
+	switch (schema.fieldType) {
+		case "Link": return { ...EMPTY_LINK };
+		case "Boolean": return false;
+		case "Enum": return (Array.isArray(schema.enum) ? schema.enum : []).find((option) => typeof option === "string") ?? "";
+		case "Image":
+		case "File":
+		case "Reference": return null;
+		case "ImageList":
+		case "FileList":
+		case "ReferenceList":
+		case "Repeater": return [];
+		default: return "";
+	}
+}
+/** The empty value of every field of a content or settings schema, by name. */
+function emptyFieldValues(schema) {
+	const properties = isObject(schema) && isObject(schema.properties) ? schema.properties : {};
+	return Object.fromEntries(Object.entries(properties).map(([name, field]) => [name, emptyFieldValue(field)]));
+}
+
 //#endregion
 //#region src/record-templates.ts
 /**
@@ -144,4 +189,4 @@ function isSettingCondition(value) {
 }
 
 //#endregion
-export { ARTICLE_TYPES, ICON_CATALOG_VERSION, PAGE_TEXT_LINK_PREFIX, QUERY_LIMIT_CAP, SYSTEM_ORDER_KEYS, UNTITLED_ARTIFACT, artifactSourceHash, artifactSourceTitle, artifactTitle, generateUuidv7, isPageUrlMarker, isQueryBacked, isSettingCondition, isSystemOrderKey, linkedRecordId, nonStringTemplateFields, projectIdSchema, recordLink, recordText, referenceQueryProblem, scopeIconSvgIds, templateFields, uuidv7JsonSchema, uuidv7Schema, validateIconValue };
+export { ARTICLE_TYPES, EMPTY_LINK, ICON_CATALOG_VERSION, PAGE_TEXT_LINK_PREFIX, QUERY_LIMIT_CAP, SYSTEM_ORDER_KEYS, UNTITLED_ARTIFACT, artifactSourceHash, artifactSourceTitle, artifactTitle, emptyFieldValue, emptyFieldValues, generateUuidv7, isPageUrlMarker, isQueryBacked, isSettingCondition, isSystemOrderKey, linkedRecordId, nonStringTemplateFields, projectIdSchema, recordLink, recordText, referenceQueryProblem, scopeIconSvgIds, templateFields, uuidv7JsonSchema, uuidv7Schema, validateIconValue };

package/dist/router.d.ts

@@ -4728,40 +4728,6 @@ declare const schema: {
         identity: undefined;
         generated: undefined;
       }, {}, {}>;
-      defaultContent: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-        name: "default_content";
-        tableName: "block_definitions";
-        dataType: "json";
-        columnType: "SQLiteTextJson";
-        data: unknown;
-        driverParam: string;
-        notNull: false;
-        hasDefault: false;
-        isPrimaryKey: false;
-        isAutoincrement: false;
-        hasRuntimeDefault: false;
-        enumValues: undefined;
-        baseColumn: never;
-        identity: undefined;
-        generated: undefined;
-      }, {}, {}>;
-      defaultSettings: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-        name: "default_settings";
-        tableName: "block_definitions";
-        dataType: "json";
-        columnType: "SQLiteTextJson";
-        data: unknown;
-        driverParam: string;
-        notNull: false;
-        hasDefault: false;
-        isPrimaryKey: false;
-        isAutoincrement: false;
-        hasRuntimeDefault: false;
-        enumValues: undefined;
-        baseColumn: never;
-        identity: undefined;
-        generated: undefined;
-      }, {}, {}>;
       layoutOnly: import("drizzle-orm/sqlite-core").SQLiteColumn<{
         name: "layout_only";
         tableName: "block_definitions";
@@ -9934,11 +9900,9 @@ declare const TRANSLATED_ENTITIES: readonly ["page", "block", "sharedContent", "
 type TranslatedEntity = (typeof TRANSLATED_ENTITIES)[number];
 /**
  * A job translating a default-locale entity into one locale of a draft (ADR 0015). Jobs are keyed
- * by entity, locale, draft and source, and debounced like generation jobs. A job translating
- * `defaults` translates the code-owned defaults of a block placed in that locale instead, or of
- * the shared content a synced block created there, which have no default-locale source. A job
- * merging with `live` merges the draft's localization with Live's, which Live changed since the
- * draft copied it, so it's no longer a conflict (ADR 0016).
+ * by entity, locale, draft and source, and debounced like generation jobs. A job merging with
+ * `live` merges the draft's localization with Live's, which Live changed since the draft copied
+ * it, so it's no longer a conflict (ADR 0016).
  */
 type TranslationJob = {
   kind: "translation";
@@ -9946,7 +9910,7 @@ type TranslationJob = {
   entityId: string;
   locale: string;
   draftId: string;
-  source?: "defaults" | "live";
+  source?: "live";
 };
 /**
  * A job writing a draft's Draft Overview from its changes, keyed by draft: a newer request
@@ -10243,8 +10207,6 @@ type Field = FieldBase & ({
   itemContentSchema: unknown;
   /** The settings schema of the repeater's items, if they have settings. */
   itemSettingsSchema: unknown;
-  /** How many items a new block starts with. */
-  defaultItems: number;
 } | {
   kind: "Reference";
   collectionId: string;
@@ -17027,8 +16989,6 @@ declare const router: {
       description: string;
       contentSchema: unknown;
       settingsSchema: unknown;
-      defaultContent: unknown;
-      defaultSettings: unknown;
       layoutOnly: boolean | null;
       synced: boolean;
       schemaHash: string;
@@ -17043,8 +17003,6 @@ declare const router: {
       description: string;
       contentSchema: unknown;
       settingsSchema: unknown;
-      defaultContent: unknown;
-      defaultSettings: unknown;
       layoutOnly: boolean | null;
       synced: boolean;
       schemaHash: string;
@@ -17772,8 +17730,6 @@ declare const router: {
           description: import("zod").ZodString;
           contentSchema: import("zod").ZodUnknown;
           settingsSchema: import("zod").ZodOptional<import("zod").ZodUnknown>;
-          defaultContent: import("zod").ZodOptional<import("zod").ZodUnknown>;
-          defaultSettings: import("zod").ZodOptional<import("zod").ZodUnknown>;
           layoutOnly: import("zod").ZodOptional<import("zod").ZodBoolean>;
           synced: import("zod").ZodOptional<import("zod").ZodBoolean>;
         }, import("zod/v4/core").$strip>>;
@@ -17792,20 +17748,10 @@ declare const router: {
           }, import("zod/v4/core").$strip>>;
           blocks: import("zod").ZodArray<import("zod").ZodPreprocess<import("zod").ZodObject<{
             type: import("zod").ZodString;
-            content: import("zod").ZodUnknown;
-            settings: import("zod").ZodOptional<import("zod").ZodUnknown>;
             slot: import("zod").ZodOptional<import("zod").ZodEnum<{
               after: "after";
               before: "before";
             }>>;
-            repeatableItems: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
-              tempId: import("zod").ZodString;
-              parentTempId: import("zod").ZodNullable<import("zod").ZodString>;
-              fieldName: import("zod").ZodString;
-              content: import("zod").ZodUnknown;
-              settings: import("zod").ZodOptional<import("zod").ZodUnknown>;
-              position: import("zod").ZodString;
-            }, import("zod/v4/core").$strip>>>;
           }, import("zod/v4/core").$strip>, unknown>>;
         }, import("zod/v4/core").$strip>>;
         collections: import("zod").ZodArray<import("zod").ZodPipe<import("zod").ZodObject<{
@@ -17938,19 +17884,6 @@ declare const router: {
         }>>>;
         homepage: import("zod").ZodNullable<import("zod").ZodObject<{
           layoutId: import("zod").ZodString;
-          blocks: import("zod").ZodArray<import("zod").ZodObject<{
-            type: import("zod").ZodString;
-            content: import("zod").ZodUnknown;
-            settings: import("zod").ZodOptional<import("zod").ZodUnknown>;
-            repeatableItems: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
-              tempId: import("zod").ZodString;
-              parentTempId: import("zod").ZodNullable<import("zod").ZodString>;
-              fieldName: import("zod").ZodString;
-              content: import("zod").ZodUnknown;
-              settings: import("zod").ZodOptional<import("zod").ZodUnknown>;
-              position: import("zod").ZodString;
-            }, import("zod/v4/core").$strip>>>;
-          }, import("zod/v4/core").$strip>>;
         }, import("zod/v4/core").$strip>>;
       }, import("zod/v4/core").$strip>;
     }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
@@ -17974,13 +17907,12 @@ declare const router: {
         deletedDefinitionTypes: string[];
         count: number;
       } | null;
-      homepage: {
+      homepage: ({
         created: false;
       } | {
         created: true;
         pageId: string;
-        blockCount: number;
-      } | null;
+      }) | null;
     }, {
       blocks: {
         count: number;
@@ -18002,13 +17934,12 @@ declare const router: {
         deletedDefinitionTypes: string[];
         count: number;
       } | null;
-      homepage: {
+      homepage: ({
         created: false;
       } | {
         created: true;
         pageId: string;
-        blockCount: number;
-      } | null;
+      }) | null;
     }>, Record<never, never>, Record<never, never>>;
   };
   drafts: {

package/dist/threads.d.ts

@@ -34,8 +34,8 @@ export declare const BUILD_STATUS_ENTRY = "camox.build-status";
 export declare const RECONCILE_ENTRY = "camox.reconcile";
 /**
  * The kind of the transcript entry opening a draft's thread a Live thread handed a request off
- * to: the Brief, which the model reads and editors see as from Camox, ahead of the editor's
- * messages. In a draft Camox opened, such as its Patrol Draft, Camox's own messages are Briefs
+ * to: the Brief, which the model reads ahead of the editor's messages, and editors see collapsed
+ * after them, so the request reads on as they sent it. In a draft Camox opened, such as its Patrol Draft, Camox's own messages are Briefs
  * too, with their `operationId` as data, and start the agent's run, which acts for Camox.
  */
 export declare const BRIEF_ENTRY = "camox.brief";
@@ -48,8 +48,8 @@ export declare const DRAFT_ENDED_ENTRY = "camox.draft-ended";
 /**
  * The kind of the transcript entry a Live thread starts afresh from once its agent handed a
  * request off to a draft (ADR 0036): a reset of Pi's context, with a `startedDraftCardSchema` as
- * data. Editors see it as the draft's card, alone, and the model reads a note naming the draft.
- * Everything before it is left out of both.
+ * data. Editors see an empty thread, and the model reads a note naming the draft. Everything
+ * before it is left out of both.
  */
 export declare const DRAFT_CARD_ENTRY = "camox.draft-card";
 /**
@@ -330,6 +330,15 @@ export type ThreadMessage = {
   from: "camox";
   text: string;
 } |
+/**
+ * The Brief the agent on Live wrote as it handed the request off to the draft, shown after the
+ * editor's messages it opened the thread with, though the model reads it before them.
+ */
+{
+  id: string;
+  from: "brief";
+  text: string;
+} |
 /** The agent's final message of a turn, in Markdown. */
 {
   id: string;
@@ -470,6 +479,11 @@ type ThreadStep = {
 {
   type: "camox";
   text: string;
+} |
+/** The Brief opening a draft's thread a Live thread handed a request off to. */
+{
+  type: "brief";
+  text: string;
 } | {
   type: "answer";
   text: string;

package/dist/threads.js

@@ -32,8 +32,8 @@ const BUILD_STATUS_ENTRY = "camox.build-status";
 const RECONCILE_ENTRY = "camox.reconcile";
 /**
 * The kind of the transcript entry opening a draft's thread a Live thread handed a request off
-* to: the Brief, which the model reads and editors see as from Camox, ahead of the editor's
-* messages. In a draft Camox opened, such as its Patrol Draft, Camox's own messages are Briefs
+* to: the Brief, which the model reads ahead of the editor's messages, and editors see collapsed
+* after them, so the request reads on as they sent it. In a draft Camox opened, such as its Patrol Draft, Camox's own messages are Briefs
 * too, with their `operationId` as data, and start the agent's run, which acts for Camox.
 */
 const BRIEF_ENTRY = "camox.brief";
@@ -46,8 +46,8 @@ const DRAFT_ENDED_ENTRY = "camox.draft-ended";
 /**
 * The kind of the transcript entry a Live thread starts afresh from once its agent handed a
 * request off to a draft (ADR 0036): a reset of Pi's context, with a `startedDraftCardSchema` as
-* data. Editors see it as the draft's card, alone, and the model reads a note naming the draft.
-* Everything before it is left out of both.
+* data. Editors see an empty thread, and the model reads a note naming the draft. Everything
+* before it is left out of both.
 */
 const DRAFT_CARD_ENTRY = "camox.draft-card";
 /**
@@ -375,14 +375,7 @@ function threadStepOf(entry) {
 			...push
 		};
 	}
-	if (entry.kind === "camox.draft-card") {
-		const card = startedDraftCardSchema.safeParse(entry.data).data;
-		return card && {
-			id,
-			type: "draft",
-			...card
-		};
-	}
+	if (entry.kind === "camox.draft-card") return void 0;
 	const message = entry.model?.find((candidate) => candidate.role !== "system");
 	if (!message) return void 0;
 	if (message.role === "user") {
@@ -407,7 +400,7 @@ function threadStepOf(entry) {
 		}
 		if (entry.kind === "camox.brief") return {
 			id,
-			type: "camox",
+			type: z.object({ operationId: z.string() }).safeParse(entry.data).success ? "camox" : "brief",
 			text: textOf(message.content)
 		};
 		if (entry.kind === "camox.reconcile") {
@@ -474,101 +467,118 @@ function threadViewOf({ steps, running, toolCalls = [], callingTools = false, ch
 		});
 		endTurn();
 	};
-	for (const step of steps) switch (step.type) {
-		case "editor":
-			if (unfinished) fail();
-			messages.push({
-				id: step.id,
-				from: "editor",
-				sender: step.sender,
-				text: step.text
-			});
-			waiting = step.id;
-			break;
-		case "connectedAgent":
-			if (unfinished) fail();
-			messages.push({
-				id: step.id,
-				from: "connectedAgent",
-				member: step.member,
-				client: step.client,
-				text: step.text
-			});
-			waiting = step.id;
-			break;
-		case "camox":
-			if (unfinished) fail();
-			messages.push({
-				id: step.id,
-				from: "camox",
-				text: step.text
-			});
-			waiting = step.id;
-			break;
-		case "stopped":
-			if (waiting === void 0) break;
-			messages.push({
-				id: step.id,
-				from: "stopped",
-				sender: step.sender
-			});
-			endTurn();
-			break;
-		case "answer":
-			if (waiting === void 0 && messages.at(-1)?.from === "stopped") break;
-			messages.push({
-				id: step.id,
-				from: "agent",
-				text: step.text
-			});
-			{
-				const before = {
-					waiting,
-					status
+	/** A hand-off's Brief, shown once the editors' messages it opened the thread with are. */
+	let brief;
+	const showBrief = () => {
+		if (brief) messages.push(brief);
+		brief = void 0;
+	};
+	for (const step of steps) {
+		if (step.type !== "editor" && step.type !== "connectedAgent") showBrief();
+		switch (step.type) {
+			case "brief":
+				brief = {
+					id: step.id,
+					from: "brief",
+					text: step.text
 				};
+				break;
+			case "editor":
+				if (unfinished) fail();
+				messages.push({
+					id: step.id,
+					from: "editor",
+					sender: step.sender,
+					text: step.text
+				});
+				waiting = step.id;
+				break;
+			case "connectedAgent":
+				if (unfinished) fail();
+				messages.push({
+					id: step.id,
+					from: "connectedAgent",
+					member: step.member,
+					client: step.client,
+					text: step.text
+				});
+				waiting = step.id;
+				break;
+			case "camox":
+				if (unfinished) fail();
+				messages.push({
+					id: step.id,
+					from: "camox",
+					text: step.text
+				});
+				waiting = step.id;
+				break;
+			case "stopped":
+				if (waiting === void 0) break;
+				messages.push({
+					id: step.id,
+					from: "stopped",
+					sender: step.sender
+				});
+				endTurn();
+				break;
+			case "answer":
+				if (waiting === void 0 && messages.at(-1)?.from === "stopped") break;
+				messages.push({
+					id: step.id,
+					from: "agent",
+					text: step.text
+				});
+				{
+					const before = {
+						waiting,
+						status
+					};
+					endTurn();
+					answered = before;
+				}
+				break;
+			case "draft":
+				if (waiting === void 0 && messages.at(-1)?.from === "stopped") break;
+				{
+					const draft = drafts[step.draftId];
+					messages.push({
+						id: step.id,
+						from: "draft",
+						draftId: step.draftId,
+						name: draft?.name ?? step.name,
+						...draft?.ended && { ended: draft.ended }
+					});
+				}
 				endTurn();
-				answered = before;
-			}
-			break;
-		case "draft":
-			if (waiting === void 0 && messages.at(-1)?.from === "stopped") break;
-			{
-				const draft = drafts[step.draftId];
+				break;
+			case "continued":
+				if (!answered) break;
+				if (messages.at(-1)?.from === "agent") messages.pop();
+				waiting = answered.waiting;
+				status = answered.status === "fixing" ? "fixing" : void 0;
+				answered = void 0;
+				break;
+			case "build":
+				status = step.status;
+				break;
+			case "push":
 				messages.push({
 					id: step.id,
-					from: "draft",
-					draftId: step.draftId,
-					name: draft?.name ?? step.name,
-					...draft?.ended && { ended: draft.ended }
+					from: "push",
+					sender: step.pusher,
+					subjects: step.subjects,
+					outcome: step.outcome
 				});
-			}
-			endTurn();
-			break;
-		case "continued":
-			if (!answered) break;
-			if (messages.at(-1)?.from === "agent") messages.pop();
-			waiting = answered.waiting;
-			status = answered.status === "fixing" ? "fixing" : void 0;
-			answered = void 0;
-			break;
-		case "build":
-			status = step.status;
-			break;
-		case "push":
-			messages.push({
-				id: step.id,
-				from: "push",
-				sender: step.pusher,
-				subjects: step.subjects,
-				outcome: step.outcome
-			});
-			break;
-		case "tools":
-			unfinished = false;
-			status = void 0;
-			break;
-		case "unfinished": unfinished = true;
+				break;
+			case "tools":
+				unfinished = false;
+				status = void 0;
+				break;
+			case "unfinished": unfinished = true;
+		}
 	}
+	showBrief();
 	if (!running) fail();
 	if (!running) return {
 		messages,
@@ -607,7 +617,7 @@ const callsChangingTool = (block) => block.type === "toolCall" && changes(block.
 const callsLook = (block) => block.type === "toolCall" && block.name === "look";
 /**
 * Adds an entry to the thread's state as Pi places it. An entry heading a new context, such as
-* the card a Live thread starts afresh from, leaves out every step before its head, as Pi's
+* the one a Live thread starts afresh from, leaves out every step before its head, as Pi's
 * snapshots do.
 */
 const append = (state, entry) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camox/api-contract",
-  "version": "0.71.0",
+  "version": "0.72.0",
   "license": "MIT",
   "files": [
     "src",

package/src/drafts.ts

@@ -50,9 +50,9 @@ export const LOOK_LOCALE_PARAM = "locale";
 
 /**
  * The look document's Block Definition mode: instead of a page, the block of the Block Definition
- * `LOOK_BLOCK_DEFINITION_PARAM` names, alone in the site's shell, with its default content and
- * Block Settings and the overrides `LOOK_CONTENT_PARAM` and `LOOK_SETTINGS_PARAM` give as JSON, in
- * the shape the content tools take.
+ * `LOOK_BLOCK_DEFINITION_PARAM` names, alone in the site's shell, with empty fields and the
+ * content and Block Settings `LOOK_CONTENT_PARAM` and `LOOK_SETTINGS_PARAM` give as JSON merged
+ * on, in the shape the content tools take.
  */
 export const LOOK_BLOCK_DEFINITION_PARAM = "blockDefinition";
 export const LOOK_CONTENT_PARAM = "content";
@@ -60,8 +60,8 @@ export const LOOK_SETTINGS_PARAM = "settings";
 
 /**
  * The look document's Layout Definition mode: instead of a page, the curated Layout
- * `LOOK_LAYOUT_DEFINITION_PARAM` names, alone in the site's shell, its blocks with their default
- * content and Block Settings and the overrides `LOOK_BLOCKS_PARAM` gives as JSON, by Block
+ * `LOOK_LAYOUT_DEFINITION_PARAM` names, alone in the site's shell, its blocks with empty fields
+ * and the content and Block Settings `LOOK_BLOCKS_PARAM` gives as JSON merged on, by Block
  * Definition name (`{ navbar: { content, settings } }`), around a labelled placeholder where a
  * page's content goes, as tall as `LOOK_PLACEHOLDER_PARAM` says: one of `LOOK_PLACEHOLDER_HEIGHTS`,
  * the first without.

package/src/empty-values.ts

@@ -0,0 +1,52 @@
+/**
+ * What a field holds before anyone writes it: the empty value of its kind. Fields declare no
+ * default, so content missing a field, or holding a value of the wrong kind, reads as this.
+ * Shared by the SDK (rendering, new repeatable items, authoring forms) and the API (creating
+ * content, conforming it on read), so both agree on what an unset field is.
+ */
+
+/** A link that goes nowhere yet. */
+export const EMPTY_LINK = { type: "external", text: "", href: "", newTab: false } as const;
+
+function isObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+/**
+ * The empty value of a field, from its stored JSON Schema (`fieldType` and, for an enum, its
+ * options): `""` for text, a link to nowhere, `false`, an enum's first option, `null` for one
+ * asset or record, and `[]` for lists and repeaters. A fresh copy each call.
+ */
+export function emptyFieldValue(fieldSchema: unknown): unknown {
+  const schema = isObject(fieldSchema) ? fieldSchema : {};
+  switch (schema.fieldType) {
+    case "Link":
+      return { ...EMPTY_LINK };
+    case "Boolean":
+      return false;
+    case "Enum": {
+      const options = Array.isArray(schema.enum) ? schema.enum : [];
+      const first = options.find((option) => typeof option === "string");
+      return first ?? "";
+    }
+    case "Image":
+    case "File":
+    case "Reference":
+      return null;
+    case "ImageList":
+    case "FileList":
+    case "ReferenceList":
+    case "Repeater":
+      return [];
+    default:
+      return "";
+  }
+}
+
+/** The empty value of every field of a content or settings schema, by name. */
+export function emptyFieldValues(schema: unknown): Record<string, unknown> {
+  const properties = isObject(schema) && isObject(schema.properties) ? schema.properties : {};
+  return Object.fromEntries(
+    Object.entries(properties).map(([name, field]) => [name, emptyFieldValue(field)]),
+  );
+}

package/src/index.ts

@@ -1,4 +1,5 @@
 export * from "./artifact.ts";
+export * from "./empty-values.ts";
 export * from "./icons.ts";
 export * from "./ids.ts";
 export * from "./record-templates.ts";

package/src/threads.ts

@@ -44,8 +44,8 @@ export const RECONCILE_ENTRY = "camox.reconcile";
 
 /**
  * The kind of the transcript entry opening a draft's thread a Live thread handed a request off
- * to: the Brief, which the model reads and editors see as from Camox, ahead of the editor's
- * messages. In a draft Camox opened, such as its Patrol Draft, Camox's own messages are Briefs
+ * to: the Brief, which the model reads ahead of the editor's messages, and editors see collapsed
+ * after them, so the request reads on as they sent it. In a draft Camox opened, such as its Patrol Draft, Camox's own messages are Briefs
  * too, with their `operationId` as data, and start the agent's run, which acts for Camox.
  */
 export const BRIEF_ENTRY = "camox.brief";
@@ -60,8 +60,8 @@ export const DRAFT_ENDED_ENTRY = "camox.draft-ended";
 /**
  * The kind of the transcript entry a Live thread starts afresh from once its agent handed a
  * request off to a draft (ADR 0036): a reset of Pi's context, with a `startedDraftCardSchema` as
- * data. Editors see it as the draft's card, alone, and the model reads a note naming the draft.
- * Everything before it is left out of both.
+ * data. Editors see an empty thread, and the model reads a note naming the draft. Everything
+ * before it is left out of both.
  */
 export const DRAFT_CARD_ENTRY = "camox.draft-card";
 
@@ -302,6 +302,11 @@ export type ThreadMessage =
     }
   /** Camox's own message, starting a turn it began itself: why it did. */
   | { id: string; from: "camox"; text: string }
+  /**
+   * The Brief the agent on Live wrote as it handed the request off to the draft, shown after the
+   * editor's messages it opened the thread with, though the model reads it before them.
+   */
+  | { id: string; from: "brief"; text: string }
   /** The agent's final message of a turn, in Markdown. */
   | { id: string; from: "agent"; text: string }
   /**
@@ -406,6 +411,8 @@ type ThreadStep = { id: string } & (
   | { type: "connectedAgent"; member: ThreadSender; client: ConnectedAgentClient; text: string }
   /** Camox starting a turn of its own, saying why. */
   | { type: "camox"; text: string }
+  /** The Brief opening a draft's thread a Live thread handed a request off to. */
+  | { type: "brief"; text: string }
   | { type: "answer"; text: string }
   /** A round of tool calls, or their results: the run goes on after it. */
   | { type: "tools" }
@@ -560,11 +567,8 @@ function threadStepOf(entry: EntryRecord): ThreadStep | undefined {
     const push = pushDataSchema.safeParse(entry.data).data;
     return push && { id, type: "push", ...push };
   }
-  // The model reads a note: editors see the card it starts the Live thread afresh with.
-  if (entry.kind === DRAFT_CARD_ENTRY) {
-    const card = startedDraftCardSchema.safeParse(entry.data).data;
-    return card && { id, type: "draft", ...card };
-  }
+  // Only the model reads it, as a note naming the draft: editors see the Live thread start empty.
+  if (entry.kind === DRAFT_CARD_ENTRY) return undefined;
   const message = entry.model?.find((candidate) => candidate.role !== "system");
   if (!message) return undefined;
   if (message.role === "user") {
@@ -583,7 +587,12 @@ function threadStepOf(entry: EntryRecord): ThreadStep | undefined {
         }
       );
     }
-    if (entry.kind === BRIEF_ENTRY) return { id, type: "camox", text: textOf(message.content) };
+    if (entry.kind === BRIEF_ENTRY) {
+      // Only Camox's own messages, in a draft it opened, carry an operation id: a hand-off's
+      // Brief is written ahead of the editor's messages, which start the run.
+      const own = z.object({ operationId: z.string() }).safeParse(entry.data).success;
+      return { id, type: own ? "camox" : "brief", text: textOf(message.content) };
+    }
     if (entry.kind === RECONCILE_ENTRY) {
       const reconcile = reconcileDataSchema.safeParse(entry.data).data;
       return reconcile && { id, type: "camox", text: reconcile.message };
@@ -648,9 +657,19 @@ export function threadViewOf({
     if (waiting !== undefined) messages.push({ id: `${waiting}:failed`, from: "failed" });
     endTurn();
   };
+  /** A hand-off's Brief, shown once the editors' messages it opened the thread with are. */
+  let brief: Extract<ThreadMessage, { from: "brief" }> | undefined;
+  const showBrief = () => {
+    if (brief) messages.push(brief);
+    brief = undefined;
+  };
 
   for (const step of steps) {
+    if (step.type !== "editor" && step.type !== "connectedAgent") showBrief();
     switch (step.type) {
+      case "brief":
+        brief = { id: step.id, from: "brief", text: step.text };
+        break;
       case "editor":
         // Pi places a steering message only once a model call is settled: after a round of tool
         // calls, or with the answer ending the run. Never between a failed call and its retry, so
@@ -738,6 +757,7 @@ export function threadViewOf({
         break;
     }
   }
+  showBrief();
   if (!running) fail();
   if (!running) return { messages, running };
   return {
@@ -798,7 +818,7 @@ const callsLook = (block: AssistantMessage["content"][number]) =>
 
 /**
  * Adds an entry to the thread's state as Pi places it. An entry heading a new context, such as
- * the card a Live thread starts afresh from, leaves out every step before its head, as Pi's
+ * the one a Live thread starts afresh from, leaves out every step before its head, as Pi's
  * snapshots do.
  */
 const append = (state: ThreadState, entry: EntryRecord | undefined): ThreadState => {