@intentic/sandbox-contract 1.347.0 → 1.349.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentic/sandbox-contract",
-  "version": "1.347.0",
+  "version": "1.349.0",
   "description": "oRPC wire contract for the intentic sandbox daemon, shared by the daemon and its browser client",
   "license": "MIT",
   "type": "module",
@@ -362,10 +362,10 @@
     }
   },
   "dependencies": {
-    "@intentic/base": "1.347.0",
-    "@intentic/constants": "1.347.0",
-    "@intentic/extension-manifest": "1.347.0",
-    "@intentic/registry": "1.347.0",
+    "@intentic/base": "1.349.0",
+    "@intentic/constants": "1.349.0",
+    "@intentic/extension-manifest": "1.349.0",
+    "@intentic/registry": "1.349.0",
     "@orpc/contract": "1.15.4",
     "tslib": "2.8.1",
     "zod": "4.6.5"

package/src/events/agent-ui.ts

@@ -19,9 +19,17 @@ export const TranscriptAgentNoticeSchema = z.object({
         .string()
         .optional()
         .describe("Who said it, when the runtime named one: the extension or plugin, as the runtime spells it. Absent when the runtime's loop said it itself."),
+    sent: z
+        .string()
+        .optional()
+        .describe("What the model was told along with this notice, where that differs from the line itself: disclosed under the row."),
 });
 export type TranscriptAgentNotice = z.infer<typeof TranscriptAgentNoticeSchema>;
 
+// Who said the notice a turn's transcript carries where the repositories' end-of-turn checks were said back to the model
+// (the sandbox's agent/run/turn-checks.ts): a reader draws that row as the checks' own, its findings behind it.
+export const TURN_CHECKS_SOURCE = "turn checks";
+
 // The two frames, as members of AgentEventSchema.
 export const agentStatusEvent = {
     kind: z.literal("agent_status"),

package/src/schemas/device-folder.ts

@@ -42,6 +42,20 @@ export const clearableOnDevice = (conflict: DeviceConflict): boolean =>
 export const DeviceSyncHoldSchema = z.enum(["owner", "gone", "container-missing", "container-trashed", "swap", "unreachable", "low-disk", "transfer"]);
 export type DeviceSyncHold = z.infer<typeof DeviceSyncHoldSchema>;
 
+// HOW FAR A FOLDER'S COPY IS (2026-10-21), in Mutagen's own counts, so nothing walks the folder a second time to say
+// it: what the sending side's last scan holds (`files`, `bytes`, ignored paths left out as the sync leaves them), and
+// while the receiving side stages a pass, how many of that pass's files it has (`stagedFiles` of `stagingFiles`) and
+// how many bytes have crossed (`stagedBytes`). A folder's first copy is one such pass over everything. Each is absent
+// until Mutagen has said it; the whole is absent from an agent older than it, and from a pairing with no session.
+export const DeviceCopySchema = z.object({
+    files: z.number().int().nonnegative().optional(),
+    bytes: z.number().nonnegative().optional(),
+    stagedFiles: z.number().int().nonnegative().optional(),
+    stagingFiles: z.number().int().nonnegative().optional(),
+    stagedBytes: z.number().nonnegative().optional(),
+});
+export type DeviceCopy = z.infer<typeof DeviceCopySchema>;
+
 // The drive reading that paused a pairing for want of room: when (epoch ms), and how much was free of how much.
 export const DeviceLowDiskSchema = z.object({
     since: z.number(),

package/src/schemas/devices.ts

@@ -1,7 +1,7 @@
 // What one of the user's own machines is running.
 import { z } from "zod";
 import { PortNumberSchema } from "./device-commands.js";
-import { DeviceBridgeHoldSchema, DeviceConflictSchema, DeviceLowDiskSchema } from "./device-folder.js";
+import { DeviceBridgeHoldSchema, DeviceConflictSchema, DeviceCopySchema, DeviceLowDiskSchema } from "./device-folder.js";
 import { parseHostConnection, type DeviceFacts, DeviceFactsSchema, MachineIdentitySchema, MachineIdSchema, userDistrosOf, WslEnvironmentSchema } from "./hosts.js";
 import { RollbackTargetSchema, UpdateOutcomeSchema } from "./updates.js";
 import { DEV_VERSION } from "../state/versions.js";
@@ -249,15 +249,15 @@ export const DevicePairingSchema = z.object({
     remoteDir: z.string().optional(),
     // Whether landed work in this project folder is delivered to `localDir` by itself (`deliverProject`). A project
     // sandbox's folder says "auto"; absent means Bring back by hand, as before. (2026-10-21) The folderless
-    // `projectsHost` pairing of the desktop app's one sandbox per computer went with that sandbox; an older agent's report
-    // that still carries it parses, the key dropped.
+    // `projectsHost` pairing of the one sandbox per computer went with it; an older report carrying it parses, key dropped.
     deliver: z.enum(["auto", "off"]).optional(),
     // (2026-10-20) The slug this machine's ic knows the sandbox by: how the desktop app starts or forgets a folder's sandbox.
     slug: z.string().optional(),
     // Machine-owned switch (agent's own `sync mirror off`); absent reads as "on", not merely unknown.
     mirroring: z.enum(["on", "off"]).optional(),
-    // Mutagen's own status word, kept verbatim rather than reduced to a traffic light.
+    // Mutagen's own status word, kept verbatim rather than reduced to a traffic light, and how far its copy is.
     mutagenStatus: z.string().optional(),
+    copy: DeviceCopySchema.optional(),
     // Whole conflict count, including any Mutagen's own state truncates (`excludedConflicts`).
     conflicts: z.number().int().nonnegative().optional(),
     // Conflicted paths, capped at `CONFLICT_PATHS_MAX`; `conflicts` above is the true, uncapped count.

package/src/text/transcript-fold.test.ts

@@ -437,10 +437,12 @@ describe("foldTurn", () => {
             { kind: "agent_notice", level: "warning", text: "Command blocked by user", source: "guard-ext" },
             { kind: "agent_notice", level: "info", text: "Compacting soon" },
             { kind: "agent_notice", level: "error", text: "   " },
+            { kind: "agent_notice", level: "warning", text: "Checks found problems", source: "turn checks", sent: "lint: a.ts:1 unused" },
         ]);
         expect(rows.slice(1)).toEqual([
             { role: "notice", text: "Command blocked by user", agentNotice: { level: "warning", source: "guard-ext" } },
             { role: "notice", text: "Compacting soon", agentNotice: { level: "info" } },
+            { role: "notice", text: "Checks found problems", agentNotice: { level: "warning", source: "turn checks", sent: "lint: a.ts:1 unused" } },
         ]);
         expect(rows.slice(1).map((row) => TranscriptRowSchema.parse(row))).toEqual(rows.slice(1));
     });

package/src/text/transcript-fold.ts

@@ -268,7 +268,7 @@ export class TranscriptFold {
                     : this.pushRow({
                           role: "notice",
                           text: event.text,
-                          agentNotice: { level: event.level, ...(event.source === undefined ? {} : { source: event.source }) },
+                          agentNotice: { level: event.level, ...defined({ source: event.source, sent: event.sent }) },
                       });
             case "error":
                 // Keeps a refusal (no prose from the provider) from reading as a session that ended mid-question.