@intentic/sandbox-contract 1.290.0 → 1.291.0

package/src/schemas/diff.ts

@@ -0,0 +1,72 @@
+// diff: one side of a file diff named by its source, for the routes that answer with something other than the text
+// diff itself (bytes on /diff/raw, derived text on /diff/derived).
+import { z } from "zod";
+import { GitDiffSideSchema } from "./git/git.js";
+
+const path = z.string().min(1).describe("The file, relative to the repo or scope the diff belongs to.");
+const repo = z.string().min(1).describe('Which repository: "root" for the workspace itself, otherwise a repo id.');
+
+// The four pairings a review surface lists a row under; every field is a string, so the same shape rides a query string
+// and the JSON body of a typed call alike.
+export const DiffSourceQuerySchema = z.discriminatedUnion("source", [
+    z
+        .object({
+            source: z.literal("working"),
+            repo,
+            side: GitDiffSideSchema.describe("Which git side the row came from; a half-staged file is two different diffs."),
+            path,
+        })
+        .describe("Uncommitted work in a workspace repo, what the Changes panel lists."),
+    z
+        .object({
+            source: z.literal("agent"),
+            agent: z.string().min(1).describe("The conversation whose work is under review."),
+            repo,
+            path,
+        })
+        .describe("One agent's work against the base its review is listed against."),
+    z
+        .object({
+            source: z.literal("commit"),
+            repo,
+            sha: z
+                .string()
+                .regex(/^[0-9a-f]{4,64}$/)
+                .describe("The commit, compared against its first parent."),
+            path,
+        })
+        .describe("A commit against its first parent."),
+    z
+        .object({
+            source: z.literal("checkpoint"),
+            snapshot: z.string().min(1).describe("Which saved point."),
+            scope: z.string().min(1).describe("Which part of the workspace the path belongs to."),
+            path,
+        })
+        .describe("A saved point in the timeline, against the visible one before it."),
+]);
+export type DiffSourceQuery = z.infer<typeof DiffSourceQuerySchema>;
+
+// One side of a document rendered to text, or why it could not be. The text is fileq's rendering, the same one an
+// agent reads instead of the bytes, so what a reviewer compares here is what the agent worked from.
+export const DerivedSideSchema = z.discriminatedUnion("present", [
+    z.object({
+        present: z.literal(true),
+        content: z.string().describe("The side as markdown."),
+        deriver: z.string().describe("Which reader made this text, with its version."),
+        notes: z.array(z.string()).describe("Every cap and degradation the conversion hit, one line each."),
+        truncated: z.boolean().describe("The rendering was longer than this response carries; only its start is here."),
+    }),
+    z.object({
+        present: z.literal(false),
+        reason: z.string().describe("Why this side has no text: a format nothing reads, a broken file, a sandbox with no reader."),
+    }),
+]);
+export type DerivedSide = z.infer<typeof DerivedSideSchema>;
+
+// Both sides as text; an absent side is a side the diff does not have (an added file has no before).
+export const DerivedDiffSchema = z.object({
+    before: DerivedSideSchema.optional().describe("The file as it was, rendered to text. Absent when it did not exist yet."),
+    after: DerivedSideSchema.optional().describe("The file as it is now, rendered to text. Absent when it was deleted."),
+});
+export type DerivedDiff = z.infer<typeof DerivedDiffSchema>;

package/src/schemas/terminal.ts

@@ -106,6 +106,17 @@ export const BrowserSessionSchema = z.object({
         .describe(
             "The agent has hit something only a person can clear: a captcha, a password it does not hold, a check on your phone. Present only while it is waiting.",
         ),
+    // A JavaScript dialog a page has open; held by the daemon for whoever answers first, the owner over the live view
+    // or the agent through its tool. Present only while open.
+    dialog: z
+        .object({
+            pageId: z.string().describe("Which page opened it."),
+            kind: z.enum(["alert", "confirm", "prompt", "beforeunload"]).describe("What it asks: an alert wants dismissing, a confirm a yes or no, a prompt a text."),
+            message: z.string().describe("What the page says."),
+            defaultValue: z.string().optional().describe("A prompt's prefilled answer."),
+        })
+        .optional()
+        .describe("A dialog a page has open and is waiting on. You or the agent answers it; present only while it is open."),
     pages: z
         .array(BrowserPageSchema)
         .describe("Every page it has open. A browser holds several at once, which is the reason it is listed apart from the terminals."),

package/src/state/history-state.ts

@@ -26,6 +26,9 @@ export const HISTORY_STATE_FILES: readonly StateFile[] = [
     { path: "activity.jsonl", portability: "carry" },
     { path: "usage.jsonl", portability: "carry" },
     { path: "account-usage.json", portability: "carry" },
+    // Per-account stay-away for a provider's usage endpoint. Carried, not re-earned: earning one costs the very read it
+    // holds off, and is answered with a deadline measured from that moment. Entries past their instant are inert.
+    { path: "usage-parks.json", portability: "carry" },
     { path: "provider-refusals.json", portability: "carry" },
     // Models refused to this sandbox's credentials; expires daily, same subscriptions apply elsewhere.
     { path: "model-refusals.json", portability: "carry" },