@intentic/sandbox-contract 1.259.0 → 1.263.0

package/dist/schemas/personas.js

@@ -3,6 +3,7 @@ import { readyChain } from "../models/model-pins.js";
 import { ModelPinSchema } from "./agent.js";
 import { entryId } from "./internal.js";
 import { SkillDraftSchema, SkillNameSchema, SystemPromptModeSchema } from "./settings.js";
+import { TurnBriefingNoteIdSchema } from "./turn-briefing.js";
 export const PersonaPowersSchema = z.object({
     files: z
         .enum(["none", "read", "write"])
@@ -34,6 +35,12 @@ export const PersonaContextSchema = z.object({
         .max(50)
         .describe("Which nested repositories a conversation wearing this card carries, by workspace-relative path. The workspace itself is always carried; empty means the workspace alone."),
 });
+export const PersonaBriefingSchema = z.object({
+    omit: z
+        .array(TurnBriefingNoteIdSchema)
+        .max(20)
+        .describe("Which of the notes the sandbox prepends to each message a conversation wearing this card does NOT get. Everything not named here is sent as usual; the notes that keep a turn inside its own branch or explain a missing account cannot be named at all."),
+});
 export const PersonaSchema = z.object({
     id: entryId.describe("The persona's id."),
     label: z.string().max(60).optional().describe("What to call it on screen. Absent falls back to the id, which somebody chose anyway."),
@@ -49,6 +56,7 @@ export const PersonaSchema = z.object({
     powers: PersonaPowersSchema.optional().describe("What a conversation wearing it may do. Absent means the full toolbox, so a card written before this existed behaves exactly as it did."),
     workspace: PersonaWorkspaceSchema.optional().describe("Where it works. Absent means the whole workspace."),
     context: PersonaContextSchema.optional().describe("Which part of the workspace a conversation wearing it carries: the repositories its checkout holds. Absent means every repository."),
+    briefing: PersonaBriefingSchema.optional().describe("Which of the notes the sandbox prepends to every message this card's conversations do without. Absent means all of them, which is what a card written before this existed keeps."),
     models: z
         .array(ModelPinSchema)
         .max(10)

package/dist/schemas/personas.js.map

@@ -1 +1 @@
-{"version":3,"file":"personas.js","sourceRoot":"","sources":["../../src/schemas/personas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAiB,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAO1F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAExC,KAAK,EAAE,CAAC;SACH,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;SAC/B,OAAO,CAAC,OAAO,CAAC;SAChB,QAAQ,CAAC,iFAAiF,CAAC;IAChG,KAAK,EAAE,CAAC;SACH,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACL,wJAAwJ,CAC3J;IACL,IAAI,EAAE,CAAC;SACF,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACL,yRAAyR,CAC5R;IACL,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAEvF,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAElC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAGnC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAGlC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAChD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAE3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACzF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;CAC1I,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC;SACH,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CACL,0KAA0K,CAC7K;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sFAAsF,CAAC;IACrI,YAAY,EAAE,CAAC;SACV,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CACL,kRAAkR,CACrR;IAGL,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6IAA6I,CAAC;IAC5J,MAAM,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC3C,wIAAwI,CAC3I;IACD,SAAS,EAAE,sBAAsB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAC1G,OAAO,EAAE,oBAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC7C,oIAAoI,CACvI;IAGD,MAAM,EAAE,CAAC;SACJ,KAAK,CAAC,cAAc,CAAC;SACrB,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CACL,qLAAqL,CACxL;IAIL,gBAAgB,EAAE,sBAAsB,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAA6B,EAAE,OAA+B,EAAuB,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AAG7J,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC9F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yEAAyE,CAAC;IAC1H,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,gFAAgF,CAAC;CAC5J,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yGAAyG,CAAC;IAC/I,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IAE7G,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACL,wLAAwL,CAC3L;CACR,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAG/C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAgB,EAAU,EAAE;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,aAAa,CAAC;IACzB,CAAC;IACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,QAAQ,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC/C,OAAO,WAAW,CAAC;IACvB,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,UAAU,CAAC;IACtB,CAAC;IACD,MAAM,MAAM,GAAG;QACX,QAAQ,CAAC,KAAK,KAAK,MAAM;QACzB,CAAC,QAAQ,CAAC,IAAI;QACd,CAAC,QAAQ,CAAC,GAAG;QACb,CAAC,QAAQ,CAAC,OAAO;QACjB,CAAC,QAAQ,CAAC,QAAQ;QAClB,CAAC,QAAQ,CAAC,OAAO;QACjB,QAAQ,CAAC,UAAU,KAAK,SAAS;QACjC,QAAQ,CAAC,OAAO,KAAK,SAAS;QAC9B,QAAQ,CAAC,GAAG,KAAK,SAAS;KAC7B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACzB,OAAO,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACtF,CAAC,CAAC;AACF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;AAGzF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC9E,SAAS,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CACL,0JAA0J,CAC7J;CACR,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,qHAAqH,CAAC;IACpI,MAAM,EAAE,CAAC;SACJ,KAAK,CACF,CAAC,CAAC,MAAM,CAAC;QACL,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC9C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;KACtD,CAAC,CACL;SACA,QAAQ,CACL,wIAAwI,CAC3I;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAC3D,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,KAAK,CAAC;SACV,QAAQ,CACL,+JAA+J,CAClK;CACR,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;AAEtH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC9C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CAC1D,CAAC,CAAC"}
+{"version":3,"file":"personas.js","sourceRoot":"","sources":["../../src/schemas/personas.ts"],"names":[],"mappings":"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"}

package/dist/schemas/turn-briefing.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export declare const TurnBriefingNoteIdSchema: z.ZodEnum<{
+    checks: "checks";
+    context: "context";
+    delegation: "delegation";
+    dependencies: "dependencies";
+    handoff: "handoff";
+    map: "map";
+    repoSync: "repoSync";
+    search: "search";
+    skills: "skills";
+}>;
+export type TurnBriefingNoteId = z.infer<typeof TurnBriefingNoteIdSchema>;
+export interface TurnBriefingNote {
+    readonly id: TurnBriefingNoteId;
+    readonly label: string;
+    readonly when: string;
+    readonly cost: string;
+}
+export declare const TURN_BRIEFING_NOTES: readonly TurnBriefingNote[];
+export interface TurnBriefingFixture {
+    readonly label: string;
+    readonly why: string;
+}
+export declare const TURN_BRIEFING_FIXTURES: readonly TurnBriefingFixture[];
+//# sourceMappingURL=turn-briefing.d.ts.map

package/dist/schemas/turn-briefing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-briefing.d.ts","sourceRoot":"","sources":["../../src/schemas/turn-briefing.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,wBAAwB;;;;;;;;;;EAAgH,CAAC;AACtJ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAC;IAGhC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAGvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAID,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAuD1D,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACxB;AAKD,eAAO,MAAM,sBAAsB,EAAE,SAAS,mBAAmB,EAUhE,CAAC"}

package/dist/schemas/turn-briefing.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+export const TurnBriefingNoteIdSchema = z.enum(["map", "context", "skills", "search", "delegation", "checks", "dependencies", "repoSync", "handoff"]);
+export const TURN_BRIEFING_NOTES = [
+    {
+        id: "map",
+        label: "Map of this project",
+        when: "First message of a conversation, when the sandbox's own map setting is on.",
+        cost: "The agent finds the layout by listing directories instead, which costs tool calls on the first task.",
+    },
+    {
+        id: "context",
+        label: "Context of this session",
+        when: "First message, and again after a compaction, for a card that carries only some repositories.",
+        cost: "A repository this card leaves out of the checkout reads as deleted rather than absent, so the agent may try to restore it.",
+    },
+    {
+        id: "skills",
+        label: "Skills available in this workspace",
+        when: "First message, on a runtime that cannot read the skills folder for itself.",
+        cost: "On those runtimes the agent never learns its skills exist, so it will not load one.",
+    },
+    {
+        id: "search",
+        label: "Using iq for workspace search",
+        when: "First message, when the workspace search setting is on and the runtime has no plugin seam.",
+        cost: "The agent falls back to grep-style searching, which it can already do.",
+    },
+    {
+        id: "delegation",
+        label: "Spawning child agents",
+        when: "First message, on a shell-only runtime, for a card that may delegate.",
+        cost: "The agent does the work itself rather than handing parts of it to other conversations.",
+    },
+    {
+        id: "checks",
+        label: "Automatic end-of-turn checks",
+        when: "First message, and again after a compaction, when you have rules that run at the end of a turn.",
+        cost: "Your checks still run; the agent just does not know they are coming, so a failure arrives as a surprise it has to re-read the turn to understand.",
+    },
+    {
+        id: "dependencies",
+        label: "Dependencies aren't installed yet",
+        when: 'Any turn where a project under the workspace has dependencies missing, or behind what it pins — the second reads "Dependencies are behind" and this covers both.',
+        cost: "An unresolved import reads as broken code, and the agent may edit working source to satisfy it.",
+    },
+    {
+        id: "repoSync",
+        label: "Repos synced with their remotes",
+        when: "A turn on the shared tree where a repository actually moved.",
+        cost: "Files changed under the agent between turns with nothing saying so.",
+    },
+    {
+        id: "handoff",
+        label: "Where the work stands",
+        when: "A turn that starts a fresh session on an existing conversation: a runtime change, or a context limit.",
+        cost: "The largest of these. Without it a re-seeded session has the transcript but none of the sandbox's own readings of the tree, the proof and the checklist, so it re-derives them.",
+    },
+];
+export const TURN_BRIEFING_FIXTURES = [
+    { label: "Where this turn's files live", why: "Without it a runtime that is only cwd'd into its branch writes into the shared checkout." },
+    { label: "Who this turn is acting as", why: "The card's own identity, on the runtimes that have nowhere else to put it." },
+    { label: "Standing instructions for this workspace", why: "Your own AGENTS.md rules. Replace them by giving this card its own system prompt." },
+    {
+        label: "Some connected accounts need a person's approval",
+        why: "Names who to ask; without it a withheld account reads as simply not connected.",
+    },
+    { label: "This turn reaches no signed-in account", why: "The other reason an account can be missing, which nothing else says out loud." },
+    { label: "How to read this message", why: "Keeps a message that opens with a slash from being eaten by the runtime's own command parser." },
+];
+//# sourceMappingURL=turn-briefing.js.map

package/dist/schemas/turn-briefing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-briefing.js","sourceRoot":"","sources":["../../src/schemas/turn-briefing.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AAkBtJ,MAAM,CAAC,MAAM,mBAAmB,GAAgC;IAC5D;QACI,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,4EAA4E;QAClF,IAAI,EAAE,sGAAsG;KAC/G;IACD;QACI,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,yBAAyB;QAChC,IAAI,EAAE,8FAA8F;QACpG,IAAI,EAAE,4HAA4H;KACrI;IACD;QACI,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,oCAAoC;QAC3C,IAAI,EAAE,4EAA4E;QAClF,IAAI,EAAE,qFAAqF;KAC9F;IACD;QACI,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,+BAA+B;QACtC,IAAI,EAAE,4FAA4F;QAClG,IAAI,EAAE,wEAAwE;KACjF;IACD;QACI,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,uBAAuB;QAC9B,IAAI,EAAE,uEAAuE;QAC7E,IAAI,EAAE,wFAAwF;KACjG;IACD;QACI,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,8BAA8B;QACrC,IAAI,EAAE,iGAAiG;QACvG,IAAI,EAAE,mJAAmJ;KAC5J;IACD;QACI,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,mCAAmC;QAC1C,IAAI,EAAE,kKAAkK;QACxK,IAAI,EAAE,iGAAiG;KAC1G;IACD;QACI,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,iCAAiC;QACxC,IAAI,EAAE,8DAA8D;QACpE,IAAI,EAAE,qEAAqE;KAC9E;IACD;QACI,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,uBAAuB;QAC9B,IAAI,EAAE,uGAAuG;QAC7G,IAAI,EAAE,iLAAiL;KAC1L;CACJ,CAAC;AAWF,MAAM,CAAC,MAAM,sBAAsB,GAAmC;IAClE,EAAE,KAAK,EAAE,8BAA8B,EAAE,GAAG,EAAE,0FAA0F,EAAE;IAC1I,EAAE,KAAK,EAAE,4BAA4B,EAAE,GAAG,EAAE,4EAA4E,EAAE;IAC1H,EAAE,KAAK,EAAE,0CAA0C,EAAE,GAAG,EAAE,mFAAmF,EAAE;IAC/I;QACI,KAAK,EAAE,kDAAkD;QACzD,GAAG,EAAE,gFAAgF;KACxF;IACD,EAAE,KAAK,EAAE,wCAAwC,EAAE,GAAG,EAAE,+EAA+E,EAAE;IACzI,EAAE,KAAK,EAAE,0BAA0B,EAAE,GAAG,EAAE,+FAA+F,EAAE;CAC9I,CAAC"}

package/dist/schemas/workspace-tree.d.ts

@@ -83,6 +83,45 @@ export declare const WorkspaceFileSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     present: z.ZodLiteral<false>;
     path: z.ZodString;
 }, z.core.$strip>], "present">;
+export declare const WorkspaceDerivedQuerySchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+export declare const WorkspaceDerivedPresentSchema: z.ZodObject<{
+    present: z.ZodLiteral<true>;
+    path: z.ZodString;
+    content: z.ZodString;
+    deriver: z.ZodString;
+    derivedAt: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    notes: z.ZodArray<z.ZodString>;
+    tokens: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    stale: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const WorkspaceDerivedAbsentSchema: z.ZodObject<{
+    present: z.ZodLiteral<false>;
+    path: z.ZodString;
+    derivable: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const WorkspaceDerivedSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    present: z.ZodLiteral<true>;
+    path: z.ZodString;
+    content: z.ZodString;
+    deriver: z.ZodString;
+    derivedAt: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    notes: z.ZodArray<z.ZodString>;
+    tokens: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    stale: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    present: z.ZodLiteral<false>;
+    path: z.ZodString;
+    derivable: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "present">;
+export type WorkspaceDerived = z.infer<typeof WorkspaceDerivedSchema>;
 export declare const WorkspaceResolveQuerySchema: z.ZodObject<{
     agent: z.ZodOptional<z.ZodString>;
     path: z.ZodString;

package/dist/schemas/workspace-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-tree.d.ts","sourceRoot":"","sources":["../../src/schemas/workspace-tree.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,oBAAoB;;iBAI/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAOlE,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CACrD;AACD,eAAO,MAAM,mBAAmB;;;;;;iBAU9B,CAAC;AACH,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEvC,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAE1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,CAAC;CACjE;AACD,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAkBjE,CAAC;AACH,eAAO,MAAM,mBAAmB;;;;;iBAW9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAGhE,eAAO,MAAM,4BAA4B;;;;iBASvC,CAAC;AACH,eAAO,MAAM,uBAAuB;;;iBAOlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAGxE,eAAO,MAAM,wBAAwB;;iBAA6F,CAAC;AACnI,eAAO,MAAM,+BAA+B;;;iBAE1C,CAAC;AAGH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAGH,eAAO,MAAM,4BAA4B;;;;;iBAiBvC,CAAC;AAGH,eAAO,MAAM,0BAA0B;;;;;;;;iBAarC,CAAC;AAGH,eAAO,MAAM,yBAAyB;;;iBAOpC,CAAC;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;8BAA2F,CAAC;AAG5H,eAAO,MAAM,2BAA2B;;;iBAQtC,CAAC;AACH,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAGH,eAAO,MAAM,kBAAkB;;iBAAoH,CAAC;AACpJ,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAGH,eAAO,MAAM,qBAAqB;;;;;;EAAsE,CAAC;AACzG,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,eAAO,MAAM,6BAA6B;;;;;;;;;;;;iBAYxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}
+{"version":3,"file":"workspace-tree.d.ts","sourceRoot":"","sources":["../../src/schemas/workspace-tree.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,oBAAoB;;iBAI/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAOlE,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CACrD;AACD,eAAO,MAAM,mBAAmB;;;;;;iBAU9B,CAAC;AACH,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEvC,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAE1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,CAAC;CACjE;AACD,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAkBjE,CAAC;AACH,eAAO,MAAM,mBAAmB;;;;;iBAW9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAGhE,eAAO,MAAM,4BAA4B;;;;iBASvC,CAAC;AACH,eAAO,MAAM,uBAAuB;;;iBAOlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAGxE,eAAO,MAAM,wBAAwB;;iBAA6F,CAAC;AACnI,eAAO,MAAM,+BAA+B;;;iBAE1C,CAAC;AAGH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAGH,eAAO,MAAM,4BAA4B;;;;;iBAiBvC,CAAC;AAGH,eAAO,MAAM,0BAA0B;;;;;;;;iBAarC,CAAC;AAGH,eAAO,MAAM,yBAAyB;;;iBAOpC,CAAC;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;8BAA2F,CAAC;AAI5H,eAAO,MAAM,2BAA2B;;iBAKtC,CAAC;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;iBAmBxC,CAAC;AACH,eAAO,MAAM,4BAA4B;;;;;iBAUvC,CAAC;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;8BAAiG,CAAC;AACrI,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,eAAO,MAAM,2BAA2B;;;iBAQtC,CAAC;AACH,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAGH,eAAO,MAAM,kBAAkB;;iBAAoH,CAAC;AACpJ,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAGH,eAAO,MAAM,qBAAqB;;;;;;EAAsE,CAAC;AACzG,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,eAAO,MAAM,6BAA6B;;;;;;;;;;;;iBAYxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/schemas/workspace-tree.js

@@ -93,6 +93,40 @@ export const WorkspaceFileAbsentSchema = z.object({
     path: z.string().describe("The path, as asked for."),
 });
 export const WorkspaceFileSchema = z.discriminatedUnion("present", [WorkspaceFilePresentSchema, WorkspaceFileAbsentSchema]);
+export const WorkspaceDerivedQuerySchema = z.object({
+    path: z
+        .string()
+        .min(1)
+        .describe("The file you want the text of, as a workspace path. The real file, not its shadow: where the text is kept is this route's business."),
+});
+export const WorkspaceDerivedPresentSchema = z.object({
+    present: z.literal(true).describe("There is derived text for that file."),
+    path: z.string().describe("The file it was derived from, as asked for."),
+    content: z.string().describe("The text itself, as markdown."),
+    deriver: z.string().describe("Which reader wrote it, and at which version, such as `pdf+ocr v1`. A file re-derives when this changes."),
+    derivedAt: z.string().optional().describe("When it was written, as an ISO timestamp. Absent only for a shadow whose front matter was edited by hand."),
+    title: z.string().optional().describe("The title the format carried, where it carried one."),
+    notes: z
+        .array(z.string())
+        .describe("Every cap and degradation the derivation hit: a sheet cut to 200 rows, a book cut at 2 MB, a scan recognised rather than read. Show these with the text, since text that was cut reading as complete is the one failure this whole feature cannot afford."),
+    tokens: z.number().describe("Roughly what an agent spends reading it, by the same four-chars-a-token estimate every budget here uses."),
+    truncated: z.boolean().describe("Whether this is only the start of the shadow, cut to keep the response sendable. The file on disk holds the rest."),
+    stale: z
+        .boolean()
+        .describe("Whether the file has changed since this text was derived, compared by content rather than by clock. True means you are reading a rendering of an older version of the file, and deriving it again catches it up."),
+});
+export const WorkspaceDerivedAbsentSchema = z.object({
+    present: z.literal(false).describe("There is no derived text for that file, which is the ordinary answer while background derivation is switched off."),
+    path: z.string().describe("The file, as asked for."),
+    derivable: z
+        .boolean()
+        .describe("Whether this format can be turned into text at all. True means asking for it to be derived is worth offering; false means nothing here reads this format."),
+    reason: z
+        .string()
+        .optional()
+        .describe("Why there is none, when deriving was just attempted and produced nothing: the file is too large, corrupt, or of a format no reader claims."),
+});
+export const WorkspaceDerivedSchema = z.discriminatedUnion("present", [WorkspaceDerivedPresentSchema, WorkspaceDerivedAbsentSchema]);
 export const WorkspaceResolveQuerySchema = WorkspaceScopeSchema.extend({
     path: z
         .string()

package/dist/schemas/workspace-tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-tree.js","sourceRoot":"","sources":["../../src/schemas/workspace-tree.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workspace-tree.js","sourceRoot":"","sources":["../../src/schemas/workspace-tree.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentic/sandbox-contract",
-  "version": "1.259.0",
+  "version": "1.263.0",
   "description": "oRPC wire contract for the intentic sandbox daemon, shared by the daemon and its browser client",
   "license": "MIT",
   "type": "module",
@@ -95,6 +95,17 @@
         "default": "./dist/ids/tunnel-ids.js"
       }
     },
+    "./edge-verdict": {
+      "types": "./dist/protocol/edge-verdict.d.ts",
+      "import": {
+        "@intentic/src": "./src/protocol/edge-verdict.ts",
+        "default": "./dist/protocol/edge-verdict.js"
+      },
+      "require": {
+        "@intentic/src": "./src/protocol/edge-verdict.ts",
+        "default": "./dist/protocol/edge-verdict.js"
+      }
+    },
     "./ingress-contract": {
       "types": "./dist/protocol/ingress-contract.d.ts",
       "import": {
@@ -185,9 +196,9 @@
     }
   },
   "dependencies": {
-    "@intentic/constants": "1.259.0",
-    "@intentic/extension-manifest": "1.259.0",
-    "@intentic/registry": "1.259.0",
+    "@intentic/constants": "1.263.0",
+    "@intentic/extension-manifest": "1.263.0",
+    "@intentic/registry": "1.263.0",
     "@orpc/contract": "1.14.13",
     "tslib": "2.8.1",
     "zod": "4.5.4"

package/src/contracts/workspace.contract.ts

@@ -21,6 +21,8 @@ import {
     WorkspaceChildrenQuerySchema,
     WorkspaceChildrenSchema,
     WorkspaceClassificationSchema,
+    WorkspaceDerivedQuerySchema,
+    WorkspaceDerivedSchema,
     WorkspaceDirSchema,
     WorkspaceFileQuerySchema,
     WorkspaceFileReadQuerySchema,
@@ -71,6 +73,28 @@ export const workspaceContract = {
         })
         .input(WorkspaceFileReadQuerySchema)
         .output(WorkspaceFileSchema),
+    // The markdown shadow fileq keeps of a binary file; the read is a plain file read, no derivation triggered.
+    derived: oc
+        .route({
+            method: "GET",
+            path: "/workspace/derived",
+            summary: "Read a file's derived text",
+            description:
+                "What a document, picture, recording or archive says, as text, from the shadow the sandbox keeps beside it. This is the same rendering an agent reads instead of the bytes, so it is also the way to check what one is working from. Nothing is derived here: a file with no shadow yet answers that it has none, and whether it could have one.",
+        })
+        .input(WorkspaceDerivedQuerySchema)
+        .output(WorkspaceDerivedSchema),
+    // The lazy path, on demand: same convergence the background sweep runs, for one file someone is looking at.
+    derive: oc
+        .route({
+            method: "POST",
+            path: "/workspace/derive",
+            summary: "Derive a file's text now",
+            description:
+                "Renders one file to text and answers with the result, for when its shadow is missing or you want it rebuilt. The same work the background pass does when that setting is on, so this is how a reader gets the text without turning it on for the whole workspace. Costs a parse of exactly one file; a format nothing can read says so rather than failing.",
+        })
+        .input(WorkspaceDerivedQuerySchema)
+        .output(WorkspaceDerivedSchema),
     // Mints the ticket GET /workspace/media (a plain Hono byte-range route, no oRPC shape) requires to stream.
     mediaTicket: oc
         .route({

package/src/index.ts

@@ -65,6 +65,7 @@ export { inventoryContract } from "./contracts/inventory.contract.js";
 export { issuesContract } from "./contracts/issues.contract.js";
 export { logsContract } from "./contracts/logs.contract.js";
 export { REQUEST_ID_EVIDENCE_ROUTE, REQUEST_ID_HEADER } from "./protocol/request-id.js";
+export * from "./protocol/edge-verdict.js";
 export { loopsContract } from "./contracts/loops.contract.js";
 export { panelsContract } from "./contracts/panels.contract.js";
 export { portsContract } from "./contracts/ports.contract.js";
@@ -175,6 +176,7 @@ export * from "./schemas/share.js";
 export * from "./schemas/shared.js";
 export * from "./schemas/system.js";
 export * from "./schemas/terminal.js";
+export * from "./schemas/turn-briefing.js";
 export * from "./schemas/usage.js";
 export * from "./schemas/vpn.js";
 export * from "./schemas/webext.js";

package/src/protocol/edge-verdict.ts

@@ -0,0 +1,45 @@
+// Why the edge could not carry a request to a sandbox, in words a browser may read. The edge is the only party that
+// can tell "this box is not dialled in" from "your network is down", and a cross-origin error is invisible to
+// JavaScript unless the responder allows it — so the verdict rides an exposed header and the edge CORS-allows its own
+// errors. Ingress writes it, the editor's connection machine reads it; both sides import this file so they cannot drift.
+
+export const EDGE_VERDICT_HEADER = "x-intentic-edge";
+
+export type EdgeVerdict =
+    // No tunnel is registered for this sandbox: its container is not running, or the machine it runs on is off.
+    // Retrying is right — a container that comes back redials within seconds.
+    | "no-tunnel"
+    // The platform has no such sandbox. The row is deleted, no tunnel for this id will ever be accepted again, and
+    // nothing the reader waits for can change that.
+    | "unknown-sandbox"
+    // A tunnel was held and the forward failed mid-flight: the box went away between being routed to and answering.
+    | "dropped";
+
+const VERDICTS: ReadonlySet<string> = new Set(["no-tunnel", "unknown-sandbox", "dropped"]);
+
+// A header value only counts when it is one of ours: a 502 from anything else on the path (a corporate proxy, a CDN)
+// carries no verdict and must not be read as one.
+export const edgeVerdictOf = (value: string | null | undefined): EdgeVerdict | undefined =>
+    typeof value === "string" && VERDICTS.has(value) ? (value as EdgeVerdict) : undefined;
+
+// Whether a sandbox can still come back on its own, which decides whether the reader is told to wait or told to act.
+export const edgeVerdictIsFinal = (verdict: EdgeVerdict): boolean => verdict === "unknown-sandbox";
+
+// The edge's own error responses, and only those, are readable by any origin: each carries one constant sentence, no
+// credential is ever accepted on them, and nothing in them is per-reader — so `*` discloses nothing a stranger could
+// not get by dialling the hostname itself. A live sandbox's CORS still comes from the daemon, proxied untouched.
+export const edgeErrorHeaders = (verdict: EdgeVerdict): Readonly<Record<string, string>> => ({
+    [EDGE_VERDICT_HEADER]: verdict,
+    "access-control-allow-origin": "*",
+    "access-control-allow-methods": "*",
+    "access-control-allow-headers": "*",
+    // Without this the header above exists on the wire and is unreadable in the browser, which is the whole bug.
+    "access-control-expose-headers": EDGE_VERDICT_HEADER,
+    // A preflight is not an answer a browser may cache long: the sandbox this refuses is expected back.
+    "access-control-max-age": "60",
+});
+
+// Whether this request is a CORS preflight, which must be answered 2xx or the real request is never sent — and the real
+// request is the one that can carry the verdict to JavaScript.
+export const isCorsPreflight = (method: string | undefined, requestMethodHeader: string | string[] | undefined): boolean =>
+    method === "OPTIONS" && requestMethodHeader !== undefined;

package/src/protocol/ingress-contract.ts

@@ -99,5 +99,6 @@ export type StartIngressTunnel = (options: IngressTunnelOptions) => IngressTunne
 //   and cache the answer, failing open if the platform doesn't respond. A 404 refuses the tunnel.
 // - Displacement: a new tunnel for an id closes the old session (code 4001) and takes the registration.
 // - Liveness: WebSocket ping every 15s; a peer silent for 45s is unregistered.
-// - Routing: host maps via hostOwnerId to a registered tunnel; no tunnel answers 502 naming the sandbox label.
+// - Routing: host maps via hostOwnerId to a registered tunnel; no tunnel answers 502 naming the sandbox label, with
+//   the verdict header and CORS of edge-verdict.ts, and admits the preflight of the request it is about to refuse.
 // - The tunnel door and any host without a sandbox id are served directly by the ingress, never routed.

package/src/schemas/personas.ts

@@ -5,6 +5,7 @@ import { type ModelSource, readyChain } from "../models/model-pins.js";
 import { type ModelPin, ModelPinSchema } from "./agent.js";
 import { entryId } from "./internal.js";
 import { SkillDraftSchema, SkillNameSchema, SystemPromptModeSchema } from "./settings.js";
+import { TurnBriefingNoteIdSchema } from "./turn-briefing.js";
 // A named face the sandbox shows outward: who it speaks as, what it may do, where it works, what it's told, what it
 // runs on. No credential lives on the card; accounts stay private, per-sandbox. Not a security boundary for a watched
 // chat — a real fence only for an unattended turn, whose resolver defaults to nothing.
@@ -65,6 +66,18 @@ export const PersonaContextSchema = z.object({
         ),
 });
 export type PersonaContext = z.infer<typeof PersonaContextSchema>;
+// What the sandbox tells a turn before the user's own words (schemas/turn-briefing.ts). A deny list, not a pick list:
+// an id absent from `omit` is sent, so a note added later rides every card that never said otherwise. An object, like
+// `context`, for future sibling fields.
+export const PersonaBriefingSchema = z.object({
+    omit: z
+        .array(TurnBriefingNoteIdSchema)
+        .max(20)
+        .describe(
+            "Which of the notes the sandbox prepends to each message a conversation wearing this card does NOT get. Everything not named here is sent as usual; the notes that keep a turn inside its own branch or explain a missing account cannot be named at all.",
+        ),
+});
+export type PersonaBriefing = z.infer<typeof PersonaBriefingSchema>;
 export const PersonaSchema = z.object({
     id: entryId.describe("The persona's id."),
     label: z.string().max(60).optional().describe("What to call it on screen. Absent falls back to the id, which somebody chose anyway."),
@@ -88,6 +101,10 @@ export const PersonaSchema = z.object({
     context: PersonaContextSchema.optional().describe(
         "Which part of the workspace a conversation wearing it carries: the repositories its checkout holds. Absent means every repository.",
     ),
+    // Sits beside `context` on purpose: one says what the tree holds, the other what the turn is handed about it.
+    briefing: PersonaBriefingSchema.optional().describe(
+        "Which of the notes the sandbox prepends to every message this card's conversations do without. Absent means all of them, which is what a card written before this existed keeps.",
+    ),
     // Ladder shape (a single pin is a single point of failure); picking the card moves the composer's model pill to its
     // head, and it fills an unattended turn's silence before the run role's list.
     models: z

package/src/schemas/turn-briefing.ts

@@ -0,0 +1,103 @@
+// What the sandbox puts in front of a user's message before the model reads it — the rows the chat shows under "Sent
+// with your message" — and which of them a persona card may drop. The vocabulary lives here rather than in the daemon
+// because the card editor has to name the same rows the transcript does, and two lists would drift into two
+// vocabularies for one thing.
+import { z } from "zod";
+
+// Ids, not titles, are what a card stores: a title is display text and gets reworded, and a reworded title must not
+// silently switch a note back on. The daemon maps each id to the titles it covers (agent/prompt/turn-briefing.ts).
+export const TurnBriefingNoteIdSchema = z.enum(["map", "context", "skills", "search", "delegation", "checks", "dependencies", "repoSync", "handoff"]);
+export type TurnBriefingNoteId = z.infer<typeof TurnBriefingNoteIdSchema>;
+
+export interface TurnBriefingNote {
+    readonly id: TurnBriefingNoteId;
+    // Verbatim the row's own title in the chat's "Sent with your message" fold, so a card turns off the line its reader
+    // actually saw. A daemon-side test holds the two in step.
+    readonly label: string;
+    // When it rides at all. Most are once per conversation, and one whose condition never comes up costs nothing
+    // whether it is switched on or off.
+    readonly when: string;
+    // What the turn loses without it, as the consequence rather than the feature — the only thing that makes this a
+    // decision rather than a guess.
+    readonly cost: string;
+}
+
+// Ordered as a turn meets them: where it is, what it holds, what it can reach, what happens at the end, then the two
+// that report on state rather than teach.
+export const TURN_BRIEFING_NOTES: readonly TurnBriefingNote[] = [
+    {
+        id: "map",
+        label: "Map of this project",
+        when: "First message of a conversation, when the sandbox's own map setting is on.",
+        cost: "The agent finds the layout by listing directories instead, which costs tool calls on the first task.",
+    },
+    {
+        id: "context",
+        label: "Context of this session",
+        when: "First message, and again after a compaction, for a card that carries only some repositories.",
+        cost: "A repository this card leaves out of the checkout reads as deleted rather than absent, so the agent may try to restore it.",
+    },
+    {
+        id: "skills",
+        label: "Skills available in this workspace",
+        when: "First message, on a runtime that cannot read the skills folder for itself.",
+        cost: "On those runtimes the agent never learns its skills exist, so it will not load one.",
+    },
+    {
+        id: "search",
+        label: "Using iq for workspace search",
+        when: "First message, when the workspace search setting is on and the runtime has no plugin seam.",
+        cost: "The agent falls back to grep-style searching, which it can already do.",
+    },
+    {
+        id: "delegation",
+        label: "Spawning child agents",
+        when: "First message, on a shell-only runtime, for a card that may delegate.",
+        cost: "The agent does the work itself rather than handing parts of it to other conversations.",
+    },
+    {
+        id: "checks",
+        label: "Automatic end-of-turn checks",
+        when: "First message, and again after a compaction, when you have rules that run at the end of a turn.",
+        cost: "Your checks still run; the agent just does not know they are coming, so a failure arrives as a surprise it has to re-read the turn to understand.",
+    },
+    {
+        id: "dependencies",
+        label: "Dependencies aren't installed yet",
+        when: 'Any turn where a project under the workspace has dependencies missing, or behind what it pins — the second reads "Dependencies are behind" and this covers both.',
+        cost: "An unresolved import reads as broken code, and the agent may edit working source to satisfy it.",
+    },
+    {
+        id: "repoSync",
+        label: "Repos synced with their remotes",
+        when: "A turn on the shared tree where a repository actually moved.",
+        cost: "Files changed under the agent between turns with nothing saying so.",
+    },
+    {
+        id: "handoff",
+        label: "Where the work stands",
+        when: "A turn that starts a fresh session on an existing conversation: a runtime change, or a context limit.",
+        cost: "The largest of these. Without it a re-seeded session has the transcript but none of the sandbox's own readings of the tree, the proof and the checklist, so it re-derives them.",
+    },
+];
+
+export interface TurnBriefingFixture {
+    readonly label: string;
+    // Why it cannot be switched off, in the one line the card editor shows beside it.
+    readonly why: string;
+}
+
+// Deliberately not switchable, and listed so the checklist above reads as complete rather than arbitrary. Each of these
+// either keeps a turn from writing outside its own branch or explains why something the agent expected is missing —
+// saving a few hundred tokens is never worth either.
+export const TURN_BRIEFING_FIXTURES: readonly TurnBriefingFixture[] = [
+    { label: "Where this turn's files live", why: "Without it a runtime that is only cwd'd into its branch writes into the shared checkout." },
+    { label: "Who this turn is acting as", why: "The card's own identity, on the runtimes that have nowhere else to put it." },
+    { label: "Standing instructions for this workspace", why: "Your own AGENTS.md rules. Replace them by giving this card its own system prompt." },
+    {
+        label: "Some connected accounts need a person's approval",
+        why: "Names who to ask; without it a withheld account reads as simply not connected.",
+    },
+    { label: "This turn reaches no signed-in account", why: "The other reason an account can be missing, which nothing else says out loud." },
+    { label: "How to read this message", why: "Keeps a message that opens with a slash from being eaten by the runtime's own command parser." },
+];