@camox/api-contract 0.71.0 → 0.74.1

package/dist/{patrol.d.ts → specialists.d.ts}

@@ -1,13 +1,13 @@
-//#region src/patrol.d.ts
+//#region src/specialists.d.ts
 /**
- * The Patrol (ADR 0024): every patroller of a project, the work each did as reports, as the
+ * The Specialists (ADR 0024): every specialist of a project, the work each did as reports, as the
  * studio shows it at the top of the Agent Sidebar. The API reads it for one scope, a draft or
  * 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"];
-/** A patroller's stable id. */
-export type PatrollerId = (typeof PATROLLER_IDS)[number];
+/** Every specialist's stable id. The registry in the API lists them all. */
+export declare const SPECIALIST_IDS: readonly ["translator", "seoManager", "linkChecker"];
+/** A specialist's stable id. */
+export type SpecialistId = (typeof SPECIALIST_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.
@@ -15,7 +15,7 @@ export type PatrollerId = (typeof PATROLLER_IDS)[number];
 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. */
+/** A report's subject, named as the Canvas names it, read when the Specialists is. */
 export type ReportSubject = {
   entity: ReportEntity;
   id: string;
@@ -44,10 +44,10 @@ export declare const reportLocale: (summary: {
 /** Whether the work was done, or failed. A failure shows in its report only. */
 export type ReportOutcome = "done" | "failed";
 /**
- * Where a patroller is on duty, in drafts or on Live: it works as you go, checks when you
- * publish, or is off there (ADR 0034).
+ * Where a specialist is on duty, in drafts or on Live: it works as you go, or is off there (ADR
+ * 0034). None checks when you publish: publishing never waits on Camox (ADR 0043).
  */
-export type PatrollerDuty = "asYouGo" | "atPublish" | "off";
+export type SpecialistDuty = "asYouGo" | "off";
 /**
  * Where the studio shows a report's subject: a page on the Canvas, with the block and repeatable
  * item to select on it, a collection record, or a file.
@@ -66,7 +66,7 @@ export type ReportPlace = {
   fileId: string;
 };
 export type ReportView = {
-  /** Unique among the patroller's reports in the view. */
+  /** Unique among the specialist's reports in the view. */
   id: string;
   summary: ReportSummary;
   outcome: ReportOutcome;
@@ -84,6 +84,7 @@ 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.
+ * - `missingMetaTitle`: a page whose meta title is written by hand, and empty.
  * A link's `url` is as content stores it: a page link's is `camox:page:<id>`, and `text` is what
  * the link reads.
  */
@@ -97,6 +98,8 @@ export type FindingAbout = {
   url: string;
   text: string;
   failure: LinkFailure;
+} | {
+  kind: "missingMetaTitle";
 };
 /** How a link failed: an HTTP error status, no connection (DNS included), or no answer in time. */
 export type LinkFailure = {
@@ -129,14 +132,17 @@ export type FindingView = {
   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. */
+  /**
+   * Whether it's Live's. A draft shows Live's findings on the content it still holds, and fixes
+   * them there.
+   */
   live: boolean;
   /** Where its content shows, as for reports. */
   place: ReportPlace | null;
 };
 /**
  * A finding as one sentence, as the studio, emails, Briefs and refusals word it: "“About us” in
- * Footer links to About, a page that no longer exists".
+ * Footer links to About, a page that no longer exists", or "Pricing has no meta title".
  */
 export declare function findingSentence(finding: Pick<FindingView, "about" | "subject">): string;
 /**
@@ -159,27 +165,27 @@ export type DismissalView = {
 export type ApplyResult = {
   applied: boolean;
 };
-/** How many subjects a patroller is on in one locale, a locale's tag. */
+/** How many subjects a specialist is on in one locale, a locale's tag. */
 export type LocaleCount = {
   locale: string;
   count: number;
 };
 /**
- * What a patroller is on: the one subject when there's one, and how many subjects in each
+ * What a specialist is on: the one subject when there's one, and how many subjects in each
  * locale, the most first. A subject in several locales counts in each.
  */
-export type PatrollerWorking = {
+export type SpecialistWorking = {
   subject: ReportSubject | null;
   locales: LocaleCount[];
 };
-export type PatrollerView = {
-  id: PatrollerId;
+export type SpecialistView = {
+  id: SpecialistId;
   /** Its role, as editors know it: "Translator", "SEO manager". */
   role: string;
   /** Its duty in the scope viewed. Off there, it still has its reports. */
-  duty: PatrollerDuty;
+  duty: SpecialistDuty;
   /** Null when it isn't working in the scope. */
-  working: PatrollerWorking | null;
+  working: SpecialistWorking | null;
   /**
    * When it last finished a check in the scope, whether it found anything or not, or null when it
    * never checked there.
@@ -202,17 +208,15 @@ export type PatrollerView = {
   /** The project's dismissals of its findings, the newest first. */
   dismissals: DismissalView[];
 };
+/** Every specialist of the registry, the latest activity first; never-worked ones last. */
+export type SpecialistsView = {
+  specialists: SpecialistView[];
+};
 /**
- * Every patroller of the registry, the latest activity first; never-worked ones last. With the
- * project's open Patrol Draft, where Live's findings are fixed, if any.
+ * URL search param the studio opens a specialist's findings from, by its id, as the email about
+ * Live's new findings links to them. The studio drops it once opened.
  */
-export type PatrolView = {
-  patrollers: PatrollerView[];
-  patrolDraft: {
-    id: string;
-    name: string | null;
-  } | null;
-};
-/** How many reports the Patrol shows of each patroller; the rest are counted. */
+export declare const SPECIALIST_SEARCH_PARAM = "camox-specialist";
+/** How many reports the Specialists shows of each specialist; the rest are counted. */
 export declare const REPORTS_SHOWN = 5;
 //#endregion

package/dist/{patrol.js → specialists.js}

@@ -1,19 +1,19 @@
-//#region src/patrol.ts
+//#region src/specialists.ts
 /**
-* The Patrol (ADR 0024): every patroller of a project, the work each did as reports, as the
+* The Specialists (ADR 0024): every specialist of a project, the work each did as reports, as the
 * studio shows it at the top of the Agent Sidebar. The API reads it for one scope, a draft or
 * 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. */
-const PATROLLER_IDS = [
+/** Every specialist's stable id. The registry in the API lists them all. */
+const SPECIALIST_IDS = [
 	"translator",
 	"seoManager",
 	"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;
-/** What a finding is about, after where it is: "links to About, a page that no longer exists". */
-function aboutSentence(about) {
+/** What a link finding is about, after where it is: "links to About, a page that no longer exists". */
+function linkSentence(about) {
 	switch (about.kind) {
 		case "missingPage": return about.page === null ? "links to a page that no longer exists" : `links to ${about.page}, a page that no longer exists`;
 		case "brokenLink": {
@@ -25,20 +25,29 @@ function aboutSentence(about) {
 }
 /**
 * A finding as one sentence, as the studio, emails, Briefs and refusals word it: "“About us” in
-* Footer links to About, a page that no longer exists".
+* Footer links to About, a page that no longer exists", or "Pricing has no meta title".
 */
 function findingSentence(finding) {
-	return `“${finding.about.text}” in ${finding.subject.name} ${aboutSentence(finding.about)}`;
+	const { about, subject } = finding;
+	if (about.kind === "missingMetaTitle") return `${subject.name} has no meta title`;
+	return `“${about.text}” in ${subject.name} ${linkSentence(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)}`;
+	const { about } = finding;
+	if (about.kind === "missingMetaTitle") return "The page has no meta title";
+	return `“${about.text}” ${linkSentence(about)}`;
 }
-/** How many reports the Patrol shows of each patroller; the rest are counted. */
+/**
+* URL search param the studio opens a specialist's findings from, by its id, as the email about
+* Live's new findings links to them. The studio drops it once opened.
+*/
+const SPECIALIST_SEARCH_PARAM = "camox-specialist";
+/** How many reports the Specialists shows of each specialist; the rest are counted. */
 const REPORTS_SHOWN = 5;
 
 //#endregion
-export { PATROLLER_IDS, REPORTS_SHOWN, findingSentence, findingSentenceInPlace, reportLocale };
+export { REPORTS_SHOWN, SPECIALIST_IDS, SPECIALIST_SEARCH_PARAM, findingSentence, findingSentenceInPlace, reportLocale };

package/dist/threads.d.ts

@@ -34,9 +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
- * too, with their `operationId` as data, and start the agent's run, which acts for Camox.
+ * 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.
  */
 export declare const BRIEF_ENTRY = "camox.brief";
 /**
@@ -48,8 +47,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";
 /**
@@ -109,6 +108,30 @@ export declare const codeRequestDataSchema: z.ZodObject<{
   reconciling: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type CodeRequestData = z.infer<typeof codeRequestDataSchema>;
+/**
+ * The draft thread's agent's tool asking the Connected Agents following its turn questions, which
+ * their waiting calls come back with as the agent works on (ADR 0042). The model calls it itself,
+ * never from a script.
+ */
+export declare const ASK_TOOL = "askConnectedAgent";
+/**
+ * The kind of the transcript entry recording questions the agent asked the Connected Agents
+ * following its turn, with a `questionsDataSchema` as data. Neither the model nor editors read
+ * it: questions are never a thread's messages, and never end its turn.
+ */
+export declare const QUESTIONS_ENTRY = "camox.questions";
+/**
+ * What a questions entry records: the questions, in the order the agent asked them, and the
+ * Connected Agents they were asked of, each by its member's id and client id.
+ */
+export declare const questionsDataSchema: z.ZodObject<{
+  questions: z.ZodArray<z.ZodString>;
+  to: z.ZodArray<z.ZodObject<{
+    memberId: z.ZodString;
+    clientId: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type QuestionsData = z.infer<typeof questionsDataSchema>;
 /** Whether `name` is a tool handing work to an agent of its own (`HANDING_OFF_TOOLS`). */
 export declare const handsOff: (name: string) => boolean;
 /**
@@ -168,8 +191,8 @@ export declare const connectedAgentClientSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ConnectedAgentClient = z.infer<typeof connectedAgentClientSchema>;
 /**
- * What a Connected Agent's message entry records: the member it acts as, its client, and the
- * operation id it was sent with.
+ * What a Connected Agent's message entry records: the member it acts as, its client, the
+ * operation id it was sent with, and whether it answers the agent's questions (ADR 0042).
  */
 export declare const connectedAgentMessageDataSchema: z.ZodObject<{
   member: z.ZodObject<{
@@ -182,6 +205,7 @@ export declare const connectedAgentMessageDataSchema: z.ZodObject<{
     verified: z.ZodBoolean;
   }, z.core.$strip>;
   operationId: z.ZodOptional<z.ZodString>;
+  answer: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type ConnectedAgentMessageData = z.infer<typeof connectedAgentMessageDataSchema>;
 /** What a push's entry records: who pushed, their commits' subjects, oldest first, and the build. */
@@ -315,7 +339,9 @@ export type ThreadMessage = {
 } |
 /**
  * A member's Connected Agent's message: the member's own AI, in its client, writing as itself.
- * Never shown as the member's own words.
+ * Never shown as the member's own words. An answer to the agent's questions shows as the
+ * context the draft was built on, collapsed, as a Brief does, rather than as a request
+ * (ADR 0042).
  */
 {
   id: string;
@@ -323,6 +349,7 @@ export type ThreadMessage = {
   member: ThreadSender;
   client: ConnectedAgentClient;
   text: string;
+  answer: boolean;
 } |
 /** Camox's own message, starting a turn it began itself: why it did. */
 {
@@ -330,6 +357,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;
@@ -465,11 +501,17 @@ type ThreadStep = {
   member: ThreadSender;
   client: ConnectedAgentClient;
   text: string;
+  answer: boolean;
 } |
 /** 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;

package/dist/threads.js

@@ -32,9 +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
-* too, with their `operationId` as data, and start the agent's run, which acts for Camox.
+* 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.
 */
 const BRIEF_ENTRY = "camox.brief";
 /**
@@ -46,8 +45,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";
 /**
@@ -101,6 +100,29 @@ 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 draft thread's agent's tool asking the Connected Agents following its turn questions, which
+* their waiting calls come back with as the agent works on (ADR 0042). The model calls it itself,
+* never from a script.
+*/
+const ASK_TOOL = "askConnectedAgent";
+/**
+* The kind of the transcript entry recording questions the agent asked the Connected Agents
+* following its turn, with a `questionsDataSchema` as data. Neither the model nor editors read
+* it: questions are never a thread's messages, and never end its turn.
+*/
+const QUESTIONS_ENTRY = "camox.questions";
+/**
+* What a questions entry records: the questions, in the order the agent asked them, and the
+* Connected Agents they were asked of, each by its member's id and client id.
+*/
+const questionsDataSchema = z.object({
+	questions: z.array(z.string()).min(1),
+	to: z.array(z.object({
+		memberId: z.string(),
+		clientId: z.string()
+	}))
+});
+/**
 * 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.
 */
@@ -161,13 +183,14 @@ const connectedAgentClientSchema = z.object({
 	verified: z.boolean()
 });
 /**
-* What a Connected Agent's message entry records: the member it acts as, its client, and the
-* operation id it was sent with.
+* What a Connected Agent's message entry records: the member it acts as, its client, the
+* operation id it was sent with, and whether it answers the agent's questions (ADR 0042).
 */
 const connectedAgentMessageDataSchema = z.object({
 	member: threadSenderSchema,
 	client: connectedAgentClientSchema,
-	operationId: z.string().optional()
+	operationId: z.string().optional(),
+	answer: z.boolean().optional()
 });
 /** What a push's entry records: who pushed, their commits' subjects, oldest first, and the build. */
 const pushDataSchema = z.object({
@@ -375,14 +398,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") {
@@ -402,12 +418,13 @@ function threadStepOf(entry) {
 					name: data.client.name,
 					verified: data.client.verified
 				},
-				text: editorTextOf(message.content)
+				text: editorTextOf(message.content),
+				answer: data.answer ?? false
 			};
 		}
 		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 +491,119 @@ 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,
+					answer: step.answer
+				});
+				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();
-				answered = before;
-			}
-			break;
-		case "draft":
-			if (waiting === void 0 && messages.at(-1)?.from === "stopped") break;
-			{
-				const draft = drafts[step.draftId];
+				break;
+			case "answer":
+				if (waiting === void 0 && messages.at(-1)?.from === "stopped") break;
 				messages.push({
 					id: step.id,
-					from: "draft",
-					draftId: step.draftId,
-					name: draft?.name ?? step.name,
-					...draft?.ended && { ended: draft.ended }
+					from: "agent",
+					text: step.text
 				});
-			}
-			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;
+				{
+					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();
+				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;
+		}
 	}
+	showBrief();
 	if (!running) fail();
 	if (!running) return {
 		messages,
@@ -607,7 +642,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) => {
@@ -726,4 +761,4 @@ function reduceThreadFrame(state, frame) {
 }
 
 //#endregion
-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 };
+export { ARTIFACT_REQUEST_ENTRY, ARTIFACT_TOOL, ASK_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, QUESTIONS_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, questionsDataSchema, reconcileDataSchema, reduceThreadEvents, reduceThreadFrame, reduceThreadState, startedDraftCardSchema, startedDraftSchema, textOf, threadClientMessageSchema, threadSenderSchema, threadViewOf, touchKindSchema, touchSchema, touchedBatchSchema };