@camox/api-contract 0.77.0 → 0.78.0

package/dist/drafts.js

@@ -225,6 +225,12 @@ const CONTENT_WRITES = {
 	locales: LOCALE_WRITES,
 	collectionDefinitions: COLLECTION_WRITES,
 	files: FILE_WRITES,
+	memories: {
+		list: false,
+		add: true,
+		change: true,
+		delete: true
+	},
 	pages: PAGE_WRITES,
 	specialists: SPECIALISTS_WRITES,
 	patrol: SPECIALISTS_WRITES,

package/dist/query-keys.d.ts

@@ -35,6 +35,9 @@ export declare const queryKeys: {
   layouts: {
     all: ["camox", string];
   };
+  memories: {
+    list: ["camox", string, string];
+  };
   drafts: {
     all: ["camox", string];
     list: ["camox", string, string];

package/dist/query-keys.js

@@ -86,6 +86,11 @@ const queryKeys = {
 		]
 	},
 	layouts: { all: ["camox", "layouts"] },
+	memories: { list: [
+		"camox",
+		"memories",
+		"list"
+	] },
 	drafts: {
 		all: ["camox", "drafts"],
 		list: [

package/dist/router.d.ts

@@ -1635,7 +1635,7 @@ type DraftRequest = {
 //#endregion
 //#region ../../apps/api/src/domains/drafts/overlay.d.ts
 /** The kinds of entity drafts hold: what changes and conflicts name. */
-declare const ENTITY_KINDS: readonly ["locale", "page", "block", "sharedContent", "repeatableItem", "file", "record", "exclusion"];
+declare const ENTITY_KINDS: readonly ["locale", "page", "block", "sharedContent", "repeatableItem", "file", "record", "exclusion", "memory"];
 type EntityKind = (typeof ENTITY_KINDS)[number];
 //#endregion
 //#region ../../apps/api/src/domains/revisions/schema.d.ts
@@ -10696,6 +10696,15 @@ type Field = FieldBase & ({
   kind: "Unknown";
 });
 //#endregion
+//#region ../../apps/api/src/lib/ai-model.d.ts
+/** A memory a draft adds, changes or deletes: what Camox's agent remembers about the website. */
+type OverviewMemoryChange = {
+  change: "added" | "changed" | "deleted";
+  text: string;
+  /** For a changed memory, its text on Live. */
+  before?: string;
+};
+//#endregion
 //#region ../../apps/api/src/domains/specialists/findings.d.ts
 /** One subject in one locale a check read. */
 type CheckedSubject = {
@@ -10806,22 +10815,14 @@ declare namespace worker_d_exports {
   export { AiJobScheduler, CamoxPreviews, DraftCode, EdgeCache, EdgeCachePurger, ProjectCode, ProjectCreationWorkflow, ProjectDeletionWorkflow, ProjectRoom, ProjectUpgradeWorkflow, PublishWorkflow, ReleaseWorkflow, Thread, UpgradeWorkflow, _default as default };
 }
 /**
- * What dispatch asks the API before it sends a request to a draft with code's revision, or to a
- * website's user Worker, over its `API` service binding (apps/dispatch/src/previews.ts,
- * apps/dispatch/src/live-script.ts). No public route reaches it.
+ * What dispatch asks the API before it sends a request to a draft with code's revision, over its
+ * `API` service binding (apps/dispatch/src/previews.ts). No public route reaches it.
  */
 declare class CamoxPreviews extends WorkerEntrypoint<Bindings> {
   /** The revision a draft previews, if the request's session can see the draft. */
   previewedRevision(question: PreviewQuestion): Promise<RevisionToLoad | null>;
   /** The revision a draft previews, for a look document carrying a look token for the draft. */
   lookedRevision(question: LookQuestion): Promise<RevisionToLoad | null>;
-  /**
-   * The user Worker serving the website of the project `project` (its Project ID): a publish's
-   * script, or null for the one named after its Project ID.
-   */
-  liveScript({ project }: {
-    project: string;
-  }): Promise<string | null>;
 }
 declare const _default: ExportedHandler<Bindings>;
 //#endregion
@@ -11047,6 +11048,38 @@ type Person = {
   name: string;
 };
 //#endregion
+//#region ../../apps/api/src/domains/memories/memory.d.ts
+/**
+ * Where a memory comes from, as members see it: for a member's words, whether the draft they were
+ * said in was published since, which takes its thread to its Publication (ADR 0045).
+ */
+type MemorySourceView = {
+  kind: "studio";
+} | {
+  kind: "thread";
+  quote: string;
+  draftId: string;
+  published: boolean;
+};
+/** One memory, as members and models see it. */
+type MemoryView = {
+  id: string;
+  text: string;
+  /** The member who taught it. */
+  author: Person;
+  source: MemorySourceView;
+  /** When it was taught. */
+  createdAt: number;
+  updatedAt: number;
+};
+/**
+ * A memory a draft adds, changes or deletes, as its review lists it: its text in the draft, or
+ * Live's for one it deletes, and Live's before a change.
+ */
+type MemoryChange = OverviewMemoryChange & {
+  id: string;
+};
+//#endregion
 //#region ../../apps/api/src/domains/drafts/list.d.ts
 type DraftSummary = {
   id: string;
@@ -11174,6 +11207,8 @@ type Problem = Subject & InLocale & ProblemPlace & {
 type PublishPreview = {
   blockers: Problem[];
   changes: Change[];
+  /** The memories among `changes`, with their text and Live's before a change (ADR 0049). */
+  memoryChanges: MemoryChange[];
   /** The tag of the default locale, which the others are translated from (null: none yet). */
   defaultLocale: string | null;
   /** The draft's overview: AI's headline and bullets about its changes. */
@@ -17062,6 +17097,351 @@ declare const router: {
       width: number | null;
     }> | undefined>, Record<never, never>, Record<never, never>>;
   };
+  memories: {
+    list: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<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("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+    }>>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+    }>, {
+      db: Database;
+      env: Bindings;
+      headers: Headers;
+      client: string;
+      telemetryDisabled: boolean;
+      waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string;
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+      user: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+      };
+      session: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        expiresAt: Date;
+        token: string;
+        ipAddress?: string | null | undefined;
+        userAgent?: string | null | undefined;
+        activeOrganizationId?: string | null | undefined;
+        local?: boolean | null | undefined;
+        studio?: boolean | null | undefined;
+      };
+    }>, import("zod").ZodObject<{
+      projectId: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<{
+      memories: MemoryView[];
+      usedWords: number;
+      limitWords: number;
+    }, {
+      memories: MemoryView[];
+      usedWords: number;
+      limitWords: number;
+    }>, Record<never, never>, Record<never, never>>;
+    add: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<import("@orpc/server").MergedInitialContext<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("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+    }>>, {
+      draft: DraftRequest | null;
+    } & Record<never, never>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+    }>, {
+      db: Database;
+      env: Bindings;
+      headers: Headers;
+      client: string;
+      telemetryDisabled: boolean;
+      waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string;
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+      user: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+      };
+      session: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        expiresAt: Date;
+        token: string;
+        ipAddress?: string | null | undefined;
+        userAgent?: string | null | undefined;
+        activeOrganizationId?: string | null | undefined;
+        local?: boolean | null | undefined;
+        studio?: boolean | null | undefined;
+      };
+    }>>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+    }>, {
+      db: Database;
+      env: Bindings;
+      headers: Headers;
+      client: string;
+      telemetryDisabled: boolean;
+      waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string;
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+      user: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+      };
+      session: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        expiresAt: Date;
+        token: string;
+        ipAddress?: string | null | undefined;
+        userAgent?: string | null | undefined;
+        activeOrganizationId?: string | null | undefined;
+        local?: boolean | null | undefined;
+        studio?: boolean | null | undefined;
+      };
+    }>, Record<never, never>>, import("zod").ZodObject<{
+      projectId: import("zod").ZodNumber;
+      text: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<MemoryView, MemoryView>, Record<never, never>, Record<never, never>>;
+    change: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<import("@orpc/server").MergedInitialContext<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("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+    }>>, {
+      draft: DraftRequest | null;
+    } & Record<never, never>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+    }>, {
+      db: Database;
+      env: Bindings;
+      headers: Headers;
+      client: string;
+      telemetryDisabled: boolean;
+      waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string;
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+      user: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+      };
+      session: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        expiresAt: Date;
+        token: string;
+        ipAddress?: string | null | undefined;
+        userAgent?: string | null | undefined;
+        activeOrganizationId?: string | null | undefined;
+        local?: boolean | null | undefined;
+        studio?: boolean | null | undefined;
+      };
+    }>>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+    }>, {
+      db: Database;
+      env: Bindings;
+      headers: Headers;
+      client: string;
+      telemetryDisabled: boolean;
+      waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string;
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+      user: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+      };
+      session: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        expiresAt: Date;
+        token: string;
+        ipAddress?: string | null | undefined;
+        userAgent?: string | null | undefined;
+        activeOrganizationId?: string | null | undefined;
+        local?: boolean | null | undefined;
+        studio?: boolean | null | undefined;
+      };
+    }>, Record<never, never>>, import("zod").ZodObject<{
+      projectId: import("zod").ZodNumber;
+      id: import("zod").ZodString;
+      text: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<MemoryView, MemoryView>, Record<never, never>, Record<never, never>>;
+    delete: import("@orpc/server").DecoratedProcedure<import("@orpc/server").MergedInitialContext<import("@orpc/server").MergedInitialContext<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("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+    }>>, {
+      draft: DraftRequest | null;
+    } & Record<never, never>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+    }>, {
+      db: Database;
+      env: Bindings;
+      headers: Headers;
+      client: string;
+      telemetryDisabled: boolean;
+      waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string;
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+      user: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+      };
+      session: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        expiresAt: Date;
+        token: string;
+        ipAddress?: string | null | undefined;
+        userAgent?: string | null | undefined;
+        activeOrganizationId?: string | null | undefined;
+        local?: boolean | null | undefined;
+        studio?: boolean | null | undefined;
+      };
+    }>>, import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<import("@orpc/server").MergedCurrentContext<BaseContext, Record<never, never>>, {
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+    }>, {
+      db: Database;
+      env: Bindings;
+      headers: Headers;
+      client: string;
+      telemetryDisabled: boolean;
+      waitUntil: (promise: Promise<unknown>) => void;
+      apiOrigin?: string;
+      draft: DraftRequest | null;
+      locale: string | undefined;
+      publishingDraft: string | undefined;
+      look: LookGrant | undefined;
+      user: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        email: string;
+        emailVerified: boolean;
+        name: string;
+        image?: string | null | undefined;
+      };
+      session: {
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        expiresAt: Date;
+        token: string;
+        ipAddress?: string | null | undefined;
+        userAgent?: string | null | undefined;
+        activeOrganizationId?: string | null | undefined;
+        local?: boolean | null | undefined;
+        studio?: boolean | null | undefined;
+      };
+    }>, Record<never, never>>, import("zod").ZodObject<{
+      projectId: import("zod").ZodNumber;
+      id: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>, import("@orpc/server").Schema<MemoryView, MemoryView>, Record<never, never>, Record<never, never>>;
+  };
   repeatableItems: {
     get: 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;
@@ -19311,6 +19691,7 @@ declare const router: {
       token: string;
       blockers: Problem[];
       changes: Change[];
+      memoryChanges: MemoryChange[];
       defaultLocale: string;
       overview: {
         status: "pending";
@@ -19336,6 +19717,7 @@ declare const router: {
       token: string;
       blockers: Problem[];
       changes: Change[];
+      memoryChanges: MemoryChange[];
       defaultLocale: string;
       overview: {
         status: "pending";
@@ -19740,6 +20122,7 @@ declare const router: {
         exclusion: "exclusion";
         file: "file";
         locale: "locale";
+        memory: "memory";
         page: "page";
         record: "record";
         repeatableItem: "repeatableItem";

package/dist/threads.d.ts

@@ -44,6 +44,11 @@ export declare const BRIEF_ENTRY = "camox.brief";
  * it at the end of the conversation; editors never see it, since the draft's card says so.
  */
 export declare const DRAFT_ENDED_ENTRY = "camox.draft-ended";
+/**
+ * The kind of the transcript entry holding Camox's note on memory, as it read when it changed
+ * since the model last saw it (ADR 0049). Only the model reads it.
+ */
+export declare const MEMORY_ENTRY = "camox.memory";
 /**
  * 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

package/dist/threads.js

@@ -43,6 +43,11 @@ const BRIEF_ENTRY = "camox.brief";
 */
 const DRAFT_ENDED_ENTRY = "camox.draft-ended";
 /**
+* The kind of the transcript entry holding Camox's note on memory, as it read when it changed
+* since the model last saw it (ADR 0049). Only the model reads it.
+*/
+const MEMORY_ENTRY = "camox.memory";
+/**
 * 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 an empty thread, and the model reads a note naming the draft. Everything
@@ -145,13 +150,16 @@ const handsOff = (name) => HANDING_OFF_TOOLS.has(name);
 const CHANGING_TOOLS = /* @__PURE__ */ new Set([
 	"addBackToLocale",
 	"addLocale",
+	"addMemory",
 	"applyFindingFix",
+	"changeMemory",
 	"copyFromPastWork",
 	"createBlock",
 	"createCollectionRecord",
 	"createPage",
 	"deleteBlock",
 	"deleteCollectionRecord",
+	"deleteMemory",
 	"deletePage",
 	"editBlock",
 	"editCollectionRecord",
@@ -425,7 +433,7 @@ function threadStepOf(entry) {
 			status: build.status
 		};
 	}
-	if (entry.kind === "camox.draft-ended") return void 0;
+	if (entry.kind === "camox.draft-ended" || entry.kind === "camox.memory") return void 0;
 	if (entry.kind === "camox.push") {
 		const push = pushDataSchema.safeParse(entry.data).data;
 		return push && {
@@ -801,4 +809,4 @@ function reduceThreadFrame(state, frame) {
 }
 
 //#endregion
-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, RESTORE_DRAFT_TOOL, RUN_STOPPED_ENTRY, START_DRAFT_TOOL, THREAD_ENDED_CLOSE_CODE, agentActivitySchema, artifactRequestDataSchema, buildStatusDataSchema, buildStatusSchema, codeRequestDataSchema, connectedAgentClientSchema, connectedAgentMessageDataSchema, editorMessageDataSchema, editorSelectionSchema, editorTextOf, editorWhereSchema, handOffDetailsSchema, handsOff, handsOffToDraft, isSender, messageAttachmentSchema, pushDataSchema, pushOutcomeSchema, questionsDataSchema, 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, MEMORY_ENTRY, PUSH_ENTRY, QUESTIONS_ENTRY, RECONCILE_ENTRY, RESTORE_DRAFT_TOOL, RUN_STOPPED_ENTRY, START_DRAFT_TOOL, THREAD_ENDED_CLOSE_CODE, agentActivitySchema, artifactRequestDataSchema, buildStatusDataSchema, buildStatusSchema, codeRequestDataSchema, connectedAgentClientSchema, connectedAgentMessageDataSchema, editorMessageDataSchema, editorSelectionSchema, editorTextOf, editorWhereSchema, handOffDetailsSchema, handsOff, handsOffToDraft, isSender, messageAttachmentSchema, pushDataSchema, pushOutcomeSchema, questionsDataSchema, reconcileDataSchema, reduceThreadEvents, reduceThreadFrame, reduceThreadState, startedDraftCardSchema, startedDraftSchema, textOf, threadClientMessageSchema, threadSenderSchema, threadViewOf, touchKindSchema, touchSchema, touchedBatchSchema };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@camox/api-contract",
-  "version": "0.77.0",
-  "license": "MIT",
+  "version": "0.78.0",
+  "license": "UNLICENSED",
   "files": [
     "src",
     "dist"

package/src/drafts.ts

@@ -335,12 +335,21 @@ const SPECIALISTS_WRITES: Record<keyof Router["specialists"], boolean> = {
   dismissFinding: false,
 };
 
+// Memory changes through drafts, like content (ADR 0049).
+const MEMORY_WRITES: Record<keyof Router["memories"], boolean> = {
+  list: false,
+  add: true,
+  change: true,
+  delete: true,
+};
+
 // `definitions` is absent: its sync is a release, never a studio content write.
 const CONTENT_WRITES: Partial<Record<keyof Router, Record<string, boolean>>> = {
   blocks: BLOCK_WRITES,
   locales: LOCALE_WRITES,
   collectionDefinitions: COLLECTION_WRITES,
   files: FILE_WRITES,
+  memories: MEMORY_WRITES,
   pages: PAGE_WRITES,
   specialists: SPECIALISTS_WRITES,
   // The old name of `specialists`, for studios not yet upgraded (ADR 0019).

package/src/query-keys.ts

@@ -52,6 +52,10 @@ export const queryKeys = {
   layouts: {
     all: ["camox", "layouts"],
   },
+  // A scope's memory (ADR 0049).
+  memories: {
+    list: ["camox", "memories", "list"],
+  },
   drafts: {
     all: ["camox", "drafts"],
     // Open drafts and Live's latest publish: the same for every viewer, whatever they're in.

package/src/threads.ts

@@ -56,6 +56,12 @@ export const BRIEF_ENTRY = "camox.brief";
  */
 export const DRAFT_ENDED_ENTRY = "camox.draft-ended";
 
+/**
+ * The kind of the transcript entry holding Camox's note on memory, as it read when it changed
+ * since the model last saw it (ADR 0049). Only the model reads it.
+ */
+export const MEMORY_ENTRY = "camox.memory";
+
 /**
  * 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
@@ -179,13 +185,16 @@ export const CHANGING_TOOLS: ReadonlySet<string> = new Set([
   // Content
   "addBackToLocale",
   "addLocale",
+  "addMemory",
   "applyFindingFix",
+  "changeMemory",
   "copyFromPastWork",
   "createBlock",
   "createCollectionRecord",
   "createPage",
   "deleteBlock",
   "deleteCollectionRecord",
+  "deleteMemory",
   "deletePage",
   "editBlock",
   "editCollectionRecord",
@@ -643,7 +652,7 @@ function threadStepOf(entry: EntryRecord): ThreadStep | undefined {
     return build && { id, type: "build", status: build.status };
   }
   // Only the model reads it: as a user message, it would otherwise read as Pi continuing a run.
-  if (entry.kind === DRAFT_ENDED_ENTRY) return undefined;
+  if (entry.kind === DRAFT_ENDED_ENTRY || entry.kind === MEMORY_ENTRY) return undefined;
   if (entry.kind === PUSH_ENTRY) {
     const push = pushDataSchema.safeParse(entry.data).data;
     return push && { id, type: "push", ...push };

package/LICENSE.md

@@ -1,21 +0,0 @@
-# MIT License
-
-Copyright 2026 Rémi de Juvigny
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
-of the Software, and to permit persons to whom the Software is furnished to do
-so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.