@camox/api-contract 0.66.0 → 0.67.0

package/dist/drafts.d.ts

@@ -49,6 +49,20 @@ export declare const LOOK_LOCALE_PARAM = "locale";
 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
+ * 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.
+ */
+export declare const LOOK_LAYOUT_DEFINITION_PARAM = "layoutDefinition";
+export declare const LOOK_BLOCKS_PARAM = "blocks";
+export declare const LOOK_PLACEHOLDER_PARAM = "placeholder";
+/** A short placeholder shows whether the footer rises up the screen; a tall one, scrolling. */
+export declare const LOOK_PLACEHOLDER_HEIGHTS: readonly ["short", "tall"];
+export type LookPlaceholderHeight = (typeof LOOK_PLACEHOLDER_HEIGHTS)[number];
 /**
  * The id of a block shown without being placed, as the look document's Block Definition mode
  * shows it: never a stored block's, which are UUIDs. Its element is

package/dist/drafts.js

@@ -50,6 +50,19 @@ 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
+* 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.
+*/
+const LOOK_LAYOUT_DEFINITION_PARAM = "layoutDefinition";
+const LOOK_BLOCKS_PARAM = "blocks";
+const LOOK_PLACEHOLDER_PARAM = "placeholder";
+/** A short placeholder shows whether the footer rises up the screen; a tall one, scrolling. */
+const LOOK_PLACEHOLDER_HEIGHTS = ["short", "tall"];
+/**
 * The id of a block shown without being placed, as the look document's Block Definition mode
 * shows it: never a stored block's, which are UUIDs. Its element is
 * `[data-camox-viewport-block="unplaced"]`.
@@ -223,4 +236,4 @@ function isContentWrite(path) {
 }
 
 //#endregion
-export { CAMOX_ACTOR, CAMOX_NAME, CHECKS_RUNNING_ERROR, CONFLICTS_CHANGED_ERROR, DRAFT_CREATE_HEADER, DRAFT_ENDED_ERROR_CODE, DRAFT_HEADER, DRAFT_SEARCH_PARAM, FINDINGS_OPEN_ERROR, LIVE_READ_ONLY_ERROR, LOCALE_HEADER, LOOK_BLOCK_DEFINITION_PARAM, LOOK_CONTENT_PARAM, LOOK_DOCUMENT_PATH, LOOK_LOCALE_PARAM, LOOK_PATH_PARAM, LOOK_SETTINGS_PARAM, LOOK_TOKEN_COOKIE, LOOK_TOKEN_HEADER, NOT_PUBLISHED_CODES, PUBLISHING_DRAFT_HEADER, PUBLISHING_DRAFT_VAR, PUBLISH_ABORT_REASONS, PUBLISH_BLOCKED_ERROR, REVISION_CHANGED_ERROR, TRANSLATIONS_PENDING_ERROR, UNPLACED_BLOCK_ID, isContentWrite };
+export { CAMOX_ACTOR, CAMOX_NAME, CHECKS_RUNNING_ERROR, CONFLICTS_CHANGED_ERROR, DRAFT_CREATE_HEADER, DRAFT_ENDED_ERROR_CODE, DRAFT_HEADER, DRAFT_SEARCH_PARAM, FINDINGS_OPEN_ERROR, LIVE_READ_ONLY_ERROR, LOCALE_HEADER, LOOK_BLOCKS_PARAM, LOOK_BLOCK_DEFINITION_PARAM, LOOK_CONTENT_PARAM, LOOK_DOCUMENT_PATH, LOOK_LAYOUT_DEFINITION_PARAM, LOOK_LOCALE_PARAM, LOOK_PATH_PARAM, LOOK_PLACEHOLDER_HEIGHTS, LOOK_PLACEHOLDER_PARAM, LOOK_SETTINGS_PARAM, LOOK_TOKEN_COOKIE, LOOK_TOKEN_HEADER, NOT_PUBLISHED_CODES, PUBLISHING_DRAFT_HEADER, PUBLISHING_DRAFT_VAR, PUBLISH_ABORT_REASONS, PUBLISH_BLOCKED_ERROR, REVISION_CHANGED_ERROR, TRANSLATIONS_PENDING_ERROR, UNPLACED_BLOCK_ID, isContentWrite };

package/dist/patrol.d.ts

@@ -5,14 +5,14 @@
  * Live, and names each report's subject, so the studio needs no entity loaded to show it.
  */
 /** Every patroller's stable id. The registry in the API lists them all. */
-export declare const PATROLLER_IDS: readonly ["translator", "seoManager", "linkChecker", "proofreader"];
+export declare const PATROLLER_IDS: readonly ["translator", "seoManager", "linkChecker"];
 /** A patroller's stable id. */
 export type PatrollerId = (typeof PATROLLER_IDS)[number];
 /**
  * What a structured report says was done. Each has a failed form, by the report's outcome. A
  * merge with Live's localization reads as a translation.
  */
-export type ReportVerb = "translated" | "mergedWithLive" | "wroteSeo" | "describedFile" | "publishedCatchUp" | "removedLink" | "fixedLink" | "fixedMistake";
+export type ReportVerb = "translated" | "mergedWithLive" | "wroteSeo" | "describedFile" | "publishedCatchUp" | "removedLink" | "fixedLink";
 /** What a report can be about. */
 export type ReportEntity = "page" | "block" | "sharedContent" | "repeatableItem" | "record" | "file";
 /** A report's subject, named as the Canvas names it, read when the Patrol is. */
@@ -84,7 +84,6 @@ export type ReportView = {
  * What a finding is about (ADR 0034), by its kind:
  * - `missingPage`: a link to a page that doesn't exist, the page's name as it was last known.
  * - `brokenLink`: an external link that failed, and how.
- * - `misspelling`, `grammar`: the flagged text, in the sentence it's in.
  * A link's `url` is as content stores it: a page link's is `camox:page:<id>`, and `text` is what
  * the link reads.
  */
@@ -98,10 +97,6 @@ export type FindingAbout = {
   url: string;
   text: string;
   failure: LinkFailure;
-} | {
-  kind: "misspelling" | "grammar";
-  text: string;
-  sentence: string;
 };
 /** How a link failed: an HTTP error status, no connection (DNS included), or no answer in time. */
 export type LinkFailure = {
@@ -113,15 +108,9 @@ export type LinkFailure = {
   kind: "timeout";
 };
 export type FindingKind = FindingAbout["kind"];
-/**
- * The fix a finding suggests, which applying makes: removing the link, keeping its text, or
- * replacing the flagged text with `replacement` in its sentence, keeping its formatting.
- */
+/** The fix a finding suggests, which applying makes: removing the link, keeping its text. */
 export type FindingFix = {
   kind: "removeLink";
-} | {
-  kind: "replaceText";
-  replacement: string;
 };
 /** A finding, open, in the scope viewed. */
 export type FindingView = {
@@ -136,6 +125,8 @@ export type FindingView = {
   locale: string;
   /** The content field it's in, by name. */
   field: string;
+  /** That field's kind, such as "String" or "Link", or null when unknown. */
+  fieldKind: string | null;
   /** When it was first raised, in milliseconds since the epoch. */
   raisedAt: number;
   /** Whether it's Live's. Live's are fixed in the Patrol Draft. */
@@ -148,6 +139,11 @@ export type FindingView = {
  * Footer links to About, a page that no longer exists".
  */
 export declare function findingSentence(finding: Pick<FindingView, "about" | "subject">): string;
+/**
+ * A finding as one sentence where its content is already shown, as the studio's sidebar shows it
+ * by its field: "“About us” links to About, a page that no longer exists".
+ */
+export declare function findingSentenceInPlace(finding: Pick<FindingView, "about">): string;
 /** A member's dismissal of what a finding was about: no finding like it is raised again. */
 export type DismissalView = {
   id: number;

package/dist/patrol.js

@@ -8,8 +8,7 @@
 const PATROLLER_IDS = [
 	"translator",
 	"seoManager",
-	"linkChecker",
-	"proofreader"
+	"linkChecker"
 ];
 /** The locale a summary's work was in: a structured summary's, if any. A text summary has none. */
 const reportLocale = (summary) => summary.kind === "structured" ? summary.locale : null;
@@ -22,8 +21,6 @@ function aboutSentence(about) {
 			const how = failure.kind === "status" ? `answers with an error (${failure.status})` : failure.kind === "timeout" ? "doesn't answer in time" : "can't be reached";
 			return `links to ${about.url}, which ${how}`;
 		}
-		case "misspelling": return "may be misspelled";
-		case "grammar": return "may be a grammar mistake";
 	}
 }
 /**
@@ -33,8 +30,15 @@ function aboutSentence(about) {
 function findingSentence(finding) {
 	return `“${finding.about.text}” in ${finding.subject.name} ${aboutSentence(finding.about)}`;
 }
+/**
+* A finding as one sentence where its content is already shown, as the studio's sidebar shows it
+* by its field: "“About us” links to About, a page that no longer exists".
+*/
+function findingSentenceInPlace(finding) {
+	return `“${finding.about.text}” ${aboutSentence(finding.about)}`;
+}
 /** How many reports the Patrol shows of each patroller; the rest are counted. */
 const REPORTS_SHOWN = 5;
 
 //#endregion
-export { PATROLLER_IDS, REPORTS_SHOWN, findingSentence, reportLocale };
+export { PATROLLER_IDS, REPORTS_SHOWN, findingSentence, findingSentenceInPlace, reportLocale };

package/dist/router.d.ts

@@ -9967,9 +9967,9 @@ type CheckJob = {
 };
 /**
  * A run of patrollers' patrols of a project's Live content (ADR 0034), keyed by project: the cron
- * trigger requests one of every patroller patrolling Live for every project every 6 hours, and a
- * release no draft published requests the Proofreader's. Requesting one while another is pending
- * joins it: one run patrols for both, so its new findings are told of once.
+ * trigger requests one of every patroller patrolling Live for every project every 6 hours.
+ * Requesting one while another is pending joins it: one run patrols for both, so its new findings
+ * are told of once.
  */
 type PatrolJob = {
   kind: "patrol";
@@ -14514,6 +14514,177 @@ declare const router: {
       structuredData: BlockStructuredData;
       recordStructuredData: import("@camox/api-contract").RecordStructuredData;
     }>, Record<never, never>, Record<never, never>>;
+    getUnplaced: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<import("@orpc/server").MergedInitialContext<BaseContext & Record<never, never>, BaseContext, BaseContext>, import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+    }>, import("zod").ZodObject<{
+      projectUuid: import("zod").ZodUUID;
+      layoutId: import("zod").ZodString;
+      blocks: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+        content: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        settings: import("zod").ZodOptional<import("zod").ZodUnknown>;
+      }, import("zod/v4/core").$strip>>>;
+    }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
+      projectName: string;
+      project: {
+        id: number;
+        updatedAt: number;
+        analytics: AnalyticsProviders;
+        socialProfiles: string[];
+      };
+      layout: {
+        layoutId: string;
+        contentUpdatedAt: number;
+        updatedAt: number;
+        beforeBlockIds: string[];
+        afterBlockIds: string[];
+      };
+      blocks: (Omit<{
+        baseVersion: number | null;
+        content: unknown;
+        createdAt: number;
+        deleted: boolean;
+        draftId: string | null;
+        firstPublishedAt: number | null;
+        id: string;
+        layoutId: string | null;
+        locale: string;
+        pageId: string | null;
+        position: string;
+        projectId: number;
+        publishedAt: number | null;
+        publishedBy: string | null;
+        rowId: number;
+        settings: unknown;
+        slot: "after" | "before" | null;
+        type: string;
+        updatedAt: number;
+        version: number;
+      }, "content"> & {
+        content: Record<string, unknown>;
+      } & {
+        summary: string;
+        title: string;
+        artifactHashes: Record<string, string>;
+      } & {
+        references: ResolvedReferences;
+      })[];
+      repeatableItems: (Omit<{
+        baseVersion: number | null;
+        blockId: string | null;
+        content: unknown;
+        createdAt: number;
+        deleted: boolean;
+        draftId: string | null;
+        fieldName: string;
+        firstPublishedAt: number | null;
+        id: string;
+        locale: string;
+        parentItemId: string | null;
+        position: string;
+        projectId: number | null;
+        publishedAt: number | null;
+        publishedBy: string | null;
+        rowId: number;
+        settings: unknown;
+        sharedContentType: string | null;
+        updatedAt: number;
+        version: number;
+      }, "content"> & {
+        content: Record<string, unknown>;
+      } & {
+        blockId: string;
+        summary: string;
+        title: string;
+        artifactHashes: Record<string, string>;
+      } & {
+        references: ResolvedReferences;
+      })[];
+      files: FileView[];
+      structuredData: BlockStructuredData;
+      recordStructuredData: import("@camox/api-contract").RecordStructuredData;
+    }, {
+      projectName: string;
+      project: {
+        id: number;
+        updatedAt: number;
+        analytics: AnalyticsProviders;
+        socialProfiles: string[];
+      };
+      layout: {
+        layoutId: string;
+        contentUpdatedAt: number;
+        updatedAt: number;
+        beforeBlockIds: string[];
+        afterBlockIds: string[];
+      };
+      blocks: (Omit<{
+        baseVersion: number | null;
+        content: unknown;
+        createdAt: number;
+        deleted: boolean;
+        draftId: string | null;
+        firstPublishedAt: number | null;
+        id: string;
+        layoutId: string | null;
+        locale: string;
+        pageId: string | null;
+        position: string;
+        projectId: number;
+        publishedAt: number | null;
+        publishedBy: string | null;
+        rowId: number;
+        settings: unknown;
+        slot: "after" | "before" | null;
+        type: string;
+        updatedAt: number;
+        version: number;
+      }, "content"> & {
+        content: Record<string, unknown>;
+      } & {
+        summary: string;
+        title: string;
+        artifactHashes: Record<string, string>;
+      } & {
+        references: ResolvedReferences;
+      })[];
+      repeatableItems: (Omit<{
+        baseVersion: number | null;
+        blockId: string | null;
+        content: unknown;
+        createdAt: number;
+        deleted: boolean;
+        draftId: string | null;
+        fieldName: string;
+        firstPublishedAt: number | null;
+        id: string;
+        locale: string;
+        parentItemId: string | null;
+        position: string;
+        projectId: number | null;
+        publishedAt: number | null;
+        publishedBy: string | null;
+        rowId: number;
+        settings: unknown;
+        sharedContentType: string | null;
+        updatedAt: number;
+        version: number;
+      }, "content"> & {
+        content: Record<string, unknown>;
+      } & {
+        blockId: string;
+        summary: string;
+        title: string;
+        artifactHashes: Record<string, string>;
+      } & {
+        references: ResolvedReferences;
+      })[];
+      files: FileView[];
+      structuredData: BlockStructuredData;
+      recordStructuredData: import("@camox/api-contract").RecordStructuredData;
+    }>, Record<never, never>, Record<never, never>>;
     list: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<import("@orpc/server").MergedInitialContext<BaseContext & Record<never, never>, BaseContext, BaseContext>, import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
       draft: DraftRequest | null;
       locale: string | undefined;
@@ -18124,16 +18295,17 @@ declare const router: {
         subject: import("@camox/api-contract/patrol").ReportSubject;
         locale: string;
         field: string;
+        fieldKind: string | null;
         raisedAt: number;
         live: boolean;
         place: import("@camox/api-contract/patrol").ReportPlace | null;
         patroller: {
-          id: "linkChecker" | "proofreader" | "seoManager" | "translator";
+          id: "linkChecker" | "seoManager" | "translator";
           role: string;
         };
       }[];
       checking: {
-        id: "linkChecker" | "proofreader" | "seoManager" | "translator";
+        id: "linkChecker" | "seoManager" | "translator";
         role: string;
       }[];
       defaultLocale: string | null;
@@ -18166,16 +18338,17 @@ declare const router: {
         subject: import("@camox/api-contract/patrol").ReportSubject;
         locale: string;
         field: string;
+        fieldKind: string | null;
         raisedAt: number;
         live: boolean;
         place: import("@camox/api-contract/patrol").ReportPlace | null;
         patroller: {
-          id: "linkChecker" | "proofreader" | "seoManager" | "translator";
+          id: "linkChecker" | "seoManager" | "translator";
           role: string;
         };
       }[];
       checking: {
-        id: "linkChecker" | "proofreader" | "seoManager" | "translator";
+        id: "linkChecker" | "seoManager" | "translator";
         role: string;
       }[];
       defaultLocale: string | null;

package/dist/threads.d.ts

@@ -91,6 +91,26 @@ export declare const artifactRequestDataSchema: z.ZodObject<{
   operationIds: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
 export type ArtifactRequestData = z.infer<typeof artifactRequestDataSchema>;
+/**
+ * The agent's tool handing code work to the draft thread's Code Agent, which reads and writes the
+ * website's code in a conversation of its own and answers the agent.
+ */
+export declare const CODE_TOOL = "code";
+/**
+ * The kind of the entry recording a request the agent sent the Code Agent, in the Code Agent's
+ * own conversation, which editors never see: who the run acts for, the operation ids of its
+ * messages, and whether it's Camox's reconcile turn, as data (`codeRequestDataSchema`).
+ */
+export declare const CODE_REQUEST_ENTRY = "camox.code-request";
+/** What a Code Agent's request records: as an Artifact Agent's, and whether Camox reconciles. */
+export declare const codeRequestDataSchema: z.ZodObject<{
+  member: z.ZodString;
+  operationIds: z.ZodArray<z.ZodString>;
+  reconciling: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CodeRequestData = z.infer<typeof codeRequestDataSchema>;
+/** Whether `name` is a tool handing work to an agent of its own (`HANDING_OFF_TOOLS`). */
+export declare const handsOff: (name: string) => boolean;
 /**
  * The tools whose calls change a draft: the content tools that write, and the code tools that
  * write files. The model calls the code tools, and code mode scripts call both. A test in the API
@@ -375,11 +395,11 @@ export declare const agentActivitySchema: z.ZodEnum<{
 }>;
 export type AgentActivity = z.infer<typeof agentActivitySchema>;
 /**
- * What an `artifact` call's result carries for the studio: the Artifact Agent's answer, whether
- * it's the agent's answer to the turn too, which then ends on it, and while it works, what the
- * Artifact Agent is doing.
+ * What the result of a call handing work off (`handsOff`), such as `artifact` or `code`, carries
+ * for the studio: the other agent's answer, whether it's the agent's answer to the turn too,
+ * which then ends on it, and while it works, what the other agent is doing.
  */
-export declare const artifactDetailsSchema: z.ZodObject<{
+export declare const handOffDetailsSchema: z.ZodObject<{
   answer: z.ZodOptional<z.ZodString>;
   final: z.ZodOptional<z.ZodBoolean>;
   activity: z.ZodOptional<z.ZodEnum<{
@@ -392,7 +412,7 @@ export declare const artifactDetailsSchema: z.ZodObject<{
     thinking: "thinking";
   }>>;
 }, z.core.$strip>;
-export type ArtifactDetails = z.infer<typeof artifactDetailsSchema>;
+export type HandOffDetails = z.infer<typeof handOffDetailsSchema>;
 /** Everything the studio shows for a thread. */
 export type ThreadView = {
   messages: readonly ThreadMessage[];
@@ -424,8 +444,11 @@ export type ThreadState = {
   changing?: boolean;
   /** Whether the model's latest round calls `look`: from writing the call until it's called again. */
   checking?: boolean;
-  /** What the Artifact Agent the running `artifact` call waits for is doing, as it last said. */
-  artifactActivity?: AgentActivity;
+  /**
+   * What the agent a running call handing work off (`handsOff`) waits for is doing, as it last
+   * said.
+   */
+  handedOffActivity?: AgentActivity;
   /** The drafts the thread's cards name, as the thread last looked them up. */
   drafts?: DraftCardStates;
 };
@@ -614,7 +637,7 @@ export declare const editorTextOf: (content: Message["content"]) => string;
  * run is over, or a later message started another run after its last model call came back
  * unfinished. While Pi retries a failed call, the run goes on, so the turn shows as working.
  */
-export declare function threadViewOf({ steps, running, toolCalls, callingTools, changing, checking, artifactActivity, drafts }: ThreadState): ThreadView;
+export declare function threadViewOf({ steps, running, toolCalls, callingTools, changing, checking, handedOffActivity, drafts }: ThreadState): ThreadView;
 /** Folds one of Pi's agent events into the thread's state. */
 export declare function reduceThreadState(state: ThreadState, event: AgentEvent): ThreadState;
 /** Folds a batch of Pi's agent events into the thread's state. */

package/dist/threads.js

@@ -88,6 +88,26 @@ const artifactRequestDataSchema = z.object({
 	operationIds: z.array(z.string())
 });
 /**
+* The agent's tool handing code work to the draft thread's Code Agent, which reads and writes the
+* website's code in a conversation of its own and answers the agent.
+*/
+const CODE_TOOL = "code";
+/**
+* The kind of the entry recording a request the agent sent the Code Agent, in the Code Agent's
+* own conversation, which editors never see: who the run acts for, the operation ids of its
+* messages, and whether it's Camox's reconcile turn, as data (`codeRequestDataSchema`).
+*/
+const CODE_REQUEST_ENTRY = "camox.code-request";
+/** What a Code Agent's request records: as an Artifact Agent's, and whether Camox reconciles. */
+const codeRequestDataSchema = artifactRequestDataSchema.extend({ reconciling: z.boolean().optional() });
+/**
+* The agent's tools handing work to an agent of its own, in a conversation beside the thread's,
+* whose answer they return: editors see what that agent does as the agent's.
+*/
+const HANDING_OFF_TOOLS = /* @__PURE__ */ new Set([ARTIFACT_TOOL, CODE_TOOL]);
+/** Whether `name` is a tool handing work to an agent of its own (`HANDING_OFF_TOOLS`). */
+const handsOff = (name) => HANDING_OFF_TOOLS.has(name);
+/**
 * The tools whose calls change a draft: the content tools that write, and the code tools that
 * write files. The model calls the code tools, and code mode scripts call both. A test in the API
 * keeps this in step with the tools themselves.
@@ -232,11 +252,11 @@ const agentActivitySchema = z.enum([
 	"startingDraft"
 ]);
 /**
-* What an `artifact` call's result carries for the studio: the Artifact Agent's answer, whether
-* it's the agent's answer to the turn too, which then ends on it, and while it works, what the
-* Artifact Agent is doing.
+* What the result of a call handing work off (`handsOff`), such as `artifact` or `code`, carries
+* for the studio: the other agent's answer, whether it's the agent's answer to the turn too,
+* which then ends on it, and while it works, what the other agent is doing.
 */
-const artifactDetailsSchema = z.object({
+const handOffDetailsSchema = z.object({
 	answer: z.string().optional(),
 	final: z.boolean().optional(),
 	activity: agentActivitySchema.optional()
@@ -405,8 +425,8 @@ function threadStepOf(entry) {
 	}
 	if (message.role === "assistant") return assistantStep(id, message);
 	if (message.role === "toolResult") {
-		if (message.toolName === "artifact" && !message.isError) {
-			const details = artifactDetailsSchema.safeParse(message.details).data;
+		if (handsOff(message.toolName) && !message.isError) {
+			const details = handOffDetailsSchema.safeParse(message.details).data;
 			if (details?.final && details.answer) return {
 				id,
 				type: "answer",
@@ -433,7 +453,7 @@ function threadStepOf(entry) {
 * run is over, or a later message started another run after its last model call came back
 * unfinished. While Pi retries a failed call, the run goes on, so the turn shows as working.
 */
-function threadViewOf({ steps, running, toolCalls = [], callingTools = false, changing = false, checking = false, artifactActivity, drafts = {} }) {
+function threadViewOf({ steps, running, toolCalls = [], callingTools = false, changing = false, checking = false, handedOffActivity, drafts = {} }) {
 	const messages = [];
 	let waiting;
 	let unfinished = false;
@@ -545,6 +565,7 @@ function threadViewOf({ steps, running, toolCalls = [], callingTools = false, ch
 			break;
 		case "tools":
 			unfinished = false;
+			status = void 0;
 			break;
 		case "unfinished": unfinished = true;
 	}
@@ -562,17 +583,17 @@ function threadViewOf({ steps, running, toolCalls = [], callingTools = false, ch
 			callingTools,
 			changing,
 			checking,
-			artifactActivity
+			handedOffActivity
 		})
 	};
 }
 /** What the agent is doing during a run, from where the turn's build stands and its tool calls. */
-function activityOf({ status, toolCalls, callingTools, changing, checking, artifactActivity }) {
+function activityOf({ status, toolCalls, callingTools, changing, checking, handedOffActivity }) {
 	const calling = (name) => toolCalls.some((call) => call.name === name);
 	if (status === "building" || calling("build")) return "building";
-	if (calling("artifact")) return artifactActivity ?? "changing";
-	if (checking) return "checking";
 	if (status === "fixing") return "fixing";
+	if (toolCalls.some((call) => handsOff(call.name))) return handedOffActivity ?? "changing";
+	if (checking) return "checking";
 	if (calling("startDraft")) return "startingDraft";
 	if (changing) return "changing";
 	if (callingTools || toolCalls.length > 0) return "exploring";
@@ -615,11 +636,11 @@ function reduceThreadState(state, event) {
 				name: tool.name
 			}]);
 			const generated = event.generation?.message?.content ?? [];
-			const artifact = event.tools.find((tool) => tool.name === "artifact" && tool.status !== "done");
+			const handingOff = event.tools.find((tool) => handsOff(tool.name) && tool.status !== "done");
 			return {
 				...state,
 				steps: event.entries.flatMap((entry) => threadStepOf(entry) ?? []),
-				artifactActivity: artifactDetailsSchema.safeParse(artifact?.details).data?.activity,
+				handedOffActivity: handOffDetailsSchema.safeParse(handingOff?.details).data?.activity,
 				running: event.run !== void 0,
 				toolCalls,
 				callingTools: generated.some((part) => part.type === "toolCall"),
@@ -638,7 +659,7 @@ function reduceThreadState(state, event) {
 			callingTools: false,
 			changing: false,
 			checking: false,
-			artifactActivity: void 0
+			handedOffActivity: void 0
 		};
 		case "message_start": return event.message.role === "assistant" ? {
 			...state,
@@ -673,17 +694,17 @@ function reduceThreadState(state, event) {
 			};
 		}
 		case "tool_execution_update": {
-			if (event.toolName !== "artifact" || event.parentToolCallId !== void 0) return state;
-			const activity = artifactDetailsSchema.safeParse(event.details).data?.activity;
+			if (!handsOff(event.toolName) || event.parentToolCallId !== void 0) return state;
+			const activity = handOffDetailsSchema.safeParse(event.details).data?.activity;
 			return activity ? {
 				...state,
-				artifactActivity: activity
+				handedOffActivity: activity
 			} : state;
 		}
 		case "tool_execution_end": return append({
 			...state,
 			toolCalls: state.toolCalls?.filter((call) => call.callId !== event.toolCallId),
-			...event.toolName === "artifact" && event.parentToolCallId === void 0 && { artifactActivity: void 0 }
+			...handsOff(event.toolName) && event.parentToolCallId === void 0 && { handedOffActivity: void 0 }
 		}, event.entry);
 		case "message_end":
 		case "entry_appended": return append(state, event.entry);
@@ -705,4 +726,4 @@ function reduceThreadFrame(state, frame) {
 }
 
 //#endregion
-export { ARTIFACT_REQUEST_ENTRY, ARTIFACT_TOOL, BRIEF_ENTRY, BUILD_STATUS_ENTRY, BUILD_TOOL, CHANGING_TOOLS, CONNECTED_AGENT_MESSAGE_ENTRY, DRAFT_CARD_ENTRY, DRAFT_ENDED_ENTRY, EDITOR_MESSAGE_ENTRY, EMPTY_THREAD_STATE, EMPTY_THREAD_VIEW, LOOK_TOOL, PUSH_ENTRY, RECONCILE_ENTRY, RUN_STOPPED_ENTRY, START_DRAFT_TOOL, THREAD_ENDED_CLOSE_CODE, agentActivitySchema, artifactDetailsSchema, artifactRequestDataSchema, buildStatusDataSchema, buildStatusSchema, connectedAgentClientSchema, connectedAgentMessageDataSchema, editorMessageDataSchema, editorSelectionSchema, editorTextOf, editorWhereSchema, isSender, pushDataSchema, pushOutcomeSchema, reconcileDataSchema, reduceThreadEvents, reduceThreadFrame, reduceThreadState, startedDraftCardSchema, startedDraftSchema, textOf, threadClientMessageSchema, threadSenderSchema, threadViewOf, touchKindSchema, touchSchema, touchedBatchSchema };
+export { ARTIFACT_REQUEST_ENTRY, ARTIFACT_TOOL, BRIEF_ENTRY, BUILD_STATUS_ENTRY, BUILD_TOOL, CHANGING_TOOLS, CODE_REQUEST_ENTRY, CODE_TOOL, CONNECTED_AGENT_MESSAGE_ENTRY, DRAFT_CARD_ENTRY, DRAFT_ENDED_ENTRY, EDITOR_MESSAGE_ENTRY, EMPTY_THREAD_STATE, EMPTY_THREAD_VIEW, LOOK_TOOL, PUSH_ENTRY, RECONCILE_ENTRY, RUN_STOPPED_ENTRY, START_DRAFT_TOOL, THREAD_ENDED_CLOSE_CODE, agentActivitySchema, artifactRequestDataSchema, buildStatusDataSchema, buildStatusSchema, codeRequestDataSchema, connectedAgentClientSchema, connectedAgentMessageDataSchema, editorMessageDataSchema, editorSelectionSchema, editorTextOf, editorWhereSchema, handOffDetailsSchema, handsOff, isSender, pushDataSchema, pushOutcomeSchema, reconcileDataSchema, reduceThreadEvents, reduceThreadFrame, reduceThreadState, startedDraftCardSchema, startedDraftSchema, textOf, threadClientMessageSchema, threadSenderSchema, threadViewOf, touchKindSchema, touchSchema, touchedBatchSchema };

package/package.json

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

package/src/drafts.ts

@@ -58,6 +58,21 @@ export const LOOK_BLOCK_DEFINITION_PARAM = "blockDefinition";
 export const LOOK_CONTENT_PARAM = "content";
 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
+ * 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.
+ */
+export const LOOK_LAYOUT_DEFINITION_PARAM = "layoutDefinition";
+export const LOOK_BLOCKS_PARAM = "blocks";
+export const LOOK_PLACEHOLDER_PARAM = "placeholder";
+/** A short placeholder shows whether the footer rises up the screen; a tall one, scrolling. */
+export const LOOK_PLACEHOLDER_HEIGHTS = ["short", "tall"] as const;
+export type LookPlaceholderHeight = (typeof LOOK_PLACEHOLDER_HEIGHTS)[number];
+
 /**
  * The id of a block shown without being placed, as the look document's Block Definition mode
  * shows it: never a stored block's, which are UUIDs. Its element is

package/src/patrol.ts

@@ -5,7 +5,7 @@
  */
 
 /** Every patroller's stable id. The registry in the API lists them all. */
-export const PATROLLER_IDS = ["translator", "seoManager", "linkChecker", "proofreader"] as const;
+export const PATROLLER_IDS = ["translator", "seoManager", "linkChecker"] as const;
 
 /** A patroller's stable id. */
 export type PatrollerId = (typeof PATROLLER_IDS)[number];
@@ -21,8 +21,7 @@ export type ReportVerb =
   | "describedFile"
   | "publishedCatchUp"
   | "removedLink"
-  | "fixedLink"
-  | "fixedMistake";
+  | "fixedLink";
 
 /** What a report can be about. */
 export type ReportEntity =
@@ -92,14 +91,12 @@ export type ReportView = {
  * What a finding is about (ADR 0034), by its kind:
  * - `missingPage`: a link to a page that doesn't exist, the page's name as it was last known.
  * - `brokenLink`: an external link that failed, and how.
- * - `misspelling`, `grammar`: the flagged text, in the sentence it's in.
  * A link's `url` is as content stores it: a page link's is `camox:page:<id>`, and `text` is what
  * the link reads.
  */
 export type FindingAbout =
   | { kind: "missingPage"; url: string; text: string; page: string | null }
-  | { kind: "brokenLink"; url: string; text: string; failure: LinkFailure }
-  | { kind: "misspelling" | "grammar"; text: string; sentence: string };
+  | { kind: "brokenLink"; url: string; text: string; failure: LinkFailure };
 
 /** How a link failed: an HTTP error status, no connection (DNS included), or no answer in time. */
 export type LinkFailure =
@@ -109,11 +106,8 @@ export type LinkFailure =
 
 export type FindingKind = FindingAbout["kind"];
 
-/**
- * The fix a finding suggests, which applying makes: removing the link, keeping its text, or
- * replacing the flagged text with `replacement` in its sentence, keeping its formatting.
- */
-export type FindingFix = { kind: "removeLink" } | { kind: "replaceText"; replacement: string };
+/** The fix a finding suggests, which applying makes: removing the link, keeping its text. */
+export type FindingFix = { kind: "removeLink" };
 
 /** A finding, open, in the scope viewed. */
 export type FindingView = {
@@ -128,6 +122,8 @@ export type FindingView = {
   locale: string;
   /** The content field it's in, by name. */
   field: string;
+  /** That field's kind, such as "String" or "Link", or null when unknown. */
+  fieldKind: string | null;
   /** When it was first raised, in milliseconds since the epoch. */
   raisedAt: number;
   /** Whether it's Live's. Live's are fixed in the Patrol Draft. */
@@ -153,10 +149,6 @@ function aboutSentence(about: FindingAbout): string {
             : "can't be reached";
       return `links to ${about.url}, which ${how}`;
     }
-    case "misspelling":
-      return "may be misspelled";
-    case "grammar":
-      return "may be a grammar mistake";
   }
 }
 
@@ -168,6 +160,14 @@ export function findingSentence(finding: Pick<FindingView, "about" | "subject">)
   return `“${finding.about.text}” in ${finding.subject.name} ${aboutSentence(finding.about)}`;
 }
 
+/**
+ * A finding as one sentence where its content is already shown, as the studio's sidebar shows it
+ * by its field: "“About us” links to About, a page that no longer exists".
+ */
+export function findingSentenceInPlace(finding: Pick<FindingView, "about">): string {
+  return `“${finding.about.text}” ${aboutSentence(finding.about)}`;
+}
+
 /** A member's dismissal of what a finding was about: no finding like it is raised again. */
 export type DismissalView = {
   id: number;

package/src/threads.ts

@@ -108,6 +108,34 @@ export const artifactRequestDataSchema = z.object({
 });
 export type ArtifactRequestData = z.infer<typeof artifactRequestDataSchema>;
 
+/**
+ * The agent's tool handing code work to the draft thread's Code Agent, which reads and writes the
+ * website's code in a conversation of its own and answers the agent.
+ */
+export const CODE_TOOL = "code";
+
+/**
+ * The kind of the entry recording a request the agent sent the Code Agent, in the Code Agent's
+ * own conversation, which editors never see: who the run acts for, the operation ids of its
+ * messages, and whether it's Camox's reconcile turn, as data (`codeRequestDataSchema`).
+ */
+export const CODE_REQUEST_ENTRY = "camox.code-request";
+
+/** What a Code Agent's request records: as an Artifact Agent's, and whether Camox reconciles. */
+export const codeRequestDataSchema = artifactRequestDataSchema.extend({
+  reconciling: z.boolean().optional(),
+});
+export type CodeRequestData = z.infer<typeof codeRequestDataSchema>;
+
+/**
+ * The agent's tools handing work to an agent of its own, in a conversation beside the thread's,
+ * whose answer they return: editors see what that agent does as the agent's.
+ */
+const HANDING_OFF_TOOLS: ReadonlySet<string> = new Set([ARTIFACT_TOOL, CODE_TOOL]);
+
+/** Whether `name` is a tool handing work to an agent of its own (`HANDING_OFF_TOOLS`). */
+export const handsOff = (name: string) => HANDING_OFF_TOOLS.has(name);
+
 /**
  * The tools whose calls change a draft: the content tools that write, and the code tools that
  * write files. The model calls the code tools, and code mode scripts call both. A test in the API
@@ -320,16 +348,16 @@ export const agentActivitySchema = z.enum([
 export type AgentActivity = z.infer<typeof agentActivitySchema>;
 
 /**
- * What an `artifact` call's result carries for the studio: the Artifact Agent's answer, whether
- * it's the agent's answer to the turn too, which then ends on it, and while it works, what the
- * Artifact Agent is doing.
+ * What the result of a call handing work off (`handsOff`), such as `artifact` or `code`, carries
+ * for the studio: the other agent's answer, whether it's the agent's answer to the turn too,
+ * which then ends on it, and while it works, what the other agent is doing.
  */
-export const artifactDetailsSchema = z.object({
+export const handOffDetailsSchema = z.object({
   answer: z.string().optional(),
   final: z.boolean().optional(),
   activity: agentActivitySchema.optional(),
 });
-export type ArtifactDetails = z.infer<typeof artifactDetailsSchema>;
+export type HandOffDetails = z.infer<typeof handOffDetailsSchema>;
 
 /** Everything the studio shows for a thread. */
 export type ThreadView = {
@@ -361,8 +389,11 @@ export type ThreadState = {
   changing?: boolean;
   /** Whether the model's latest round calls `look`: from writing the call until it's called again. */
   checking?: boolean;
-  /** What the Artifact Agent the running `artifact` call waits for is doing, as it last said. */
-  artifactActivity?: AgentActivity;
+  /**
+   * What the agent a running call handing work off (`handsOff`) waits for is doing, as it last
+   * said.
+   */
+  handedOffActivity?: AgentActivity;
   /** The drafts the thread's cards name, as the thread last looked them up. */
   drafts?: DraftCardStates;
 };
@@ -563,9 +594,10 @@ function threadStepOf(entry: EntryRecord): ThreadStep | undefined {
   }
   if (message.role === "assistant") return assistantStep(id, message);
   if (message.role === "toolResult") {
-    // An Artifact Agent's answer that ends the turn is the agent's: editors never see it apart.
-    if (message.toolName === ARTIFACT_TOOL && !message.isError) {
-      const details = artifactDetailsSchema.safeParse(message.details).data;
+    // An Artifact Agent's or the Code Agent's answer that ends the turn is the agent's: editors
+    // never see it apart.
+    if (handsOff(message.toolName) && !message.isError) {
+      const details = handOffDetailsSchema.safeParse(message.details).data;
       if (details?.final && details.answer) return { id, type: "answer", text: details.answer };
     }
     const card =
@@ -593,7 +625,7 @@ export function threadViewOf({
   callingTools = false,
   changing = false,
   checking = false,
-  artifactActivity,
+  handedOffActivity,
   drafts = {},
 }: ThreadState): ThreadView {
   const messages: ThreadMessage[] = [];
@@ -698,6 +730,8 @@ export function threadViewOf({
         break;
       case "tools":
         unfinished = false;
+        // The Code Agent's build status ends with its request, whose answer is a tool result.
+        status = undefined;
         break;
       case "unfinished":
         unfinished = true;
@@ -709,7 +743,14 @@ export function threadViewOf({
   return {
     messages,
     running,
-    activity: activityOf({ status, toolCalls, callingTools, changing, checking, artifactActivity }),
+    activity: activityOf({
+      status,
+      toolCalls,
+      callingTools,
+      changing,
+      checking,
+      handedOffActivity,
+    }),
   };
 }
 
@@ -720,23 +761,24 @@ function activityOf({
   callingTools,
   changing,
   checking,
-  artifactActivity,
+  handedOffActivity,
 }: {
   status: BuildStatus | undefined;
   toolCalls: NonNullable<ThreadState["toolCalls"]>;
   callingTools: boolean;
   changing: boolean;
   checking: boolean;
-  artifactActivity: AgentActivity | undefined;
+  handedOffActivity: AgentActivity | undefined;
 }): AgentActivity {
   const calling = (name: string) => toolCalls.some((call) => call.name === name);
   // Fixing a build error takes thinking, reading and writing, which all read as fixing, but its
   // builds show as building.
   if (status === "building" || calling(BUILD_TOOL)) return "building";
-  // An Artifact Agent works on the agent's behalf: editors see what it does as the agent's.
-  if (calling(ARTIFACT_TOOL)) return artifactActivity ?? "changing";
-  if (checking) return "checking";
   if (status === "fixing") return "fixing";
+  // An Artifact Agent or the Code Agent works on the agent's behalf: editors see what it does as
+  // the agent's.
+  if (toolCalls.some((call) => handsOff(call.name))) return handedOffActivity ?? "changing";
+  if (checking) return "checking";
   if (calling(START_DRAFT_TOOL)) return "startingDraft";
   if (changing) return "changing";
   if (callingTools || toolCalls.length > 0) return "exploring";
@@ -781,13 +823,11 @@ export function reduceThreadState(state: ThreadState, event: AgentEvent): Thread
         tool.status === "done" ? [] : [{ callId: tool.callId, name: tool.name }],
       );
       const generated = event.generation?.message?.content ?? [];
-      const artifact = event.tools.find(
-        (tool) => tool.name === ARTIFACT_TOOL && tool.status !== "done",
-      );
+      const handingOff = event.tools.find((tool) => handsOff(tool.name) && tool.status !== "done");
       return {
         ...state,
         steps: event.entries.flatMap((entry) => threadStepOf(entry) ?? []),
-        artifactActivity: artifactDetailsSchema.safeParse(artifact?.details).data?.activity,
+        handedOffActivity: handOffDetailsSchema.safeParse(handingOff?.details).data?.activity,
         running: event.run !== undefined,
         toolCalls,
         callingTools: generated.some((part) => part.type === "toolCall"),
@@ -817,7 +857,7 @@ export function reduceThreadState(state: ThreadState, event: AgentEvent): Thread
         callingTools: false,
         changing: false,
         checking: false,
-        artifactActivity: undefined,
+        handedOffActivity: undefined,
       };
     case "message_start":
       // The model is called again: it thinks until it writes a tool call.
@@ -852,17 +892,17 @@ export function reduceThreadState(state: ThreadState, event: AgentEvent): Thread
       };
     }
     case "tool_execution_update": {
-      if (event.toolName !== ARTIFACT_TOOL || event.parentToolCallId !== undefined) return state;
-      const activity = artifactDetailsSchema.safeParse(event.details).data?.activity;
-      return activity ? { ...state, artifactActivity: activity } : state;
+      if (!handsOff(event.toolName) || event.parentToolCallId !== undefined) return state;
+      const activity = handOffDetailsSchema.safeParse(event.details).data?.activity;
+      return activity ? { ...state, handedOffActivity: activity } : state;
     }
     case "tool_execution_end":
       return append(
         {
           ...state,
           toolCalls: state.toolCalls?.filter((call) => call.callId !== event.toolCallId),
-          ...(event.toolName === ARTIFACT_TOOL &&
-            event.parentToolCallId === undefined && { artifactActivity: undefined }),
+          ...(handsOff(event.toolName) &&
+            event.parentToolCallId === undefined && { handedOffActivity: undefined }),
         },
         event.entry,
       );