@intentic/sandbox-contract 1.226.0 → 1.227.0

package/dist/contracts/intentic.contract.js

@@ -2,8 +2,30 @@ import { eventIterator, oc } from "@orpc/contract";
 import { IntenticLineSchema } from "../events.js";
 import { IntenticRunSchema, OkSchema } from "../schemas.js";
 export const intenticContract = {
-    run: oc.route({ method: "POST", path: "/intentic" }).input(IntenticRunSchema).output(eventIterator(IntenticLineSchema)),
-    apply: oc.route({ method: "POST", path: "/intentic/apply" }).output(OkSchema),
-    applyEvents: oc.route({ method: "GET", path: "/intentic/apply/events" }).output(eventIterator(IntenticLineSchema)),
+    run: oc
+        .route({
+        method: "POST",
+        path: "/intentic",
+        summary: "Run an infrastructure command",
+        description: "Runs the sandbox's own command-line tool and streams its output as it arrives, so progress is visible rather than arriving all at once at the end. A failure surfaces once the stream closes.",
+    })
+        .input(IntenticRunSchema)
+        .output(eventIterator(IntenticLineSchema)),
+    apply: oc
+        .route({
+        method: "POST",
+        path: "/intentic/apply",
+        summary: "Bring the infrastructure into line",
+        description: "Starts the long reconcile that makes the running world match what was declared, and answers immediately. It takes minutes, so it runs in a terminal you attach to rather than on a held-open request.",
+    })
+        .output(OkSchema),
+    applyEvents: oc
+        .route({
+        method: "GET",
+        path: "/intentic/apply/events",
+        summary: "Follow the reconcile",
+        description: "The same progress the terminal shows, as structured events, kept on disk so a page refresh does not lose it. It replays from the start of the run and then follows live, closing when the run ends.",
+    })
+        .output(eventIterator(IntenticLineSchema)),
 };
 //# sourceMappingURL=intentic.contract.js.map

package/dist/contracts/intentic.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"intentic.contract.js","sourceRoot":"","sources":["../../src/contracts/intentic.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI5D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAGvH,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAK7E,WAAW,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;CACrH,CAAC"}
+{"version":3,"file":"intentic.contract.js","sourceRoot":"","sources":["../../src/contracts/intentic.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI5D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,GAAG,EAAE,EAAE;SACF,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,+BAA+B;QACxC,WAAW,EACP,+LAA+L;KACtM,CAAC;SACD,KAAK,CAAC,iBAAiB,CAAC;SACxB,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAG9C,KAAK,EAAE,EAAE;SACJ,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,oCAAoC;QAC7C,WAAW,EACP,uMAAuM;KAC9M,CAAC;SACD,MAAM,CAAC,QAAQ,CAAC;IAKrB,WAAW,EAAE,EAAE;SACV,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,sBAAsB;QAC/B,WAAW,EACP,qMAAqM;KAC5M,CAAC;SACD,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;CACjD,CAAC"}

package/dist/contracts/inventory.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inventory.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/inventory.contract.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,iBAAiB;IAC1B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACJ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CACT,CAAC"}
+{"version":3,"file":"inventory.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/inventory.contract.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,iBAAiB;IAC1B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQJ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAST,CAAC"}

package/dist/contracts/inventory.contract.js

@@ -1,8 +1,31 @@
 import { oc } from "@orpc/contract";
 import { AddInventoryInputSchema, InventoryListSchema, InventoryNameParamSchema } from "../schemas.js";
 export const inventoryContract = {
-    list: oc.route({ method: "GET", path: "/inventory" }).output(InventoryListSchema),
-    add: oc.route({ method: "POST", path: "/inventory" }).input(AddInventoryInputSchema).output(InventoryListSchema),
-    remove: oc.route({ method: "DELETE", path: "/inventory/{name}" }).input(InventoryNameParamSchema).output(InventoryListSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/inventory",
+        summary: "Machines and services you have declared",
+        description: "What the deployment configuration says this setup owns and what it wants provisioned.",
+    })
+        .output(InventoryListSchema),
+    add: oc
+        .route({
+        method: "POST",
+        path: "/inventory",
+        summary: "Declare a machine or service",
+        description: "Writes the entry into the configuration file and commits it, exactly as an agent editing that file by hand would. Answers with the whole updated list, so a screen redraws from one response.",
+    })
+        .input(AddInventoryInputSchema)
+        .output(InventoryListSchema),
+    remove: oc
+        .route({
+        method: "DELETE",
+        path: "/inventory/{name}",
+        summary: "Undeclare a machine or service",
+        description: "Takes the entry back out of the configuration and commits that too. Answers with the whole updated list.",
+    })
+        .input(InventoryNameParamSchema)
+        .output(InventoryListSchema),
 };
 //# sourceMappingURL=inventory.contract.js.map

package/dist/contracts/inventory.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"inventory.contract.js","sourceRoot":"","sources":["../../src/contracts/inventory.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAKvG,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC;IACjF,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC;IAChH,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC;CAChI,CAAC"}
+{"version":3,"file":"inventory.contract.js","sourceRoot":"","sources":["../../src/contracts/inventory.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAKvG,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,yCAAyC;QAClD,WAAW,EAAE,uFAAuF;KACvG,CAAC;SACD,MAAM,CAAC,mBAAmB,CAAC;IAChC,GAAG,EAAE,EAAE;SACF,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,8BAA8B;QACvC,WAAW,EACP,+LAA+L;KACtM,CAAC;SACD,KAAK,CAAC,uBAAuB,CAAC;SAC9B,MAAM,CAAC,mBAAmB,CAAC;IAChC,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,gCAAgC;QACzC,WAAW,EAAE,0GAA0G;KAC1H,CAAC;SACD,KAAK,CAAC,wBAAwB,CAAC;SAC/B,MAAM,CAAC,mBAAmB,CAAC;CACnC,CAAC"}

package/dist/contracts/logs.contract.d.ts

@@ -15,5 +15,22 @@ export declare const logsContract: {
         text: import("zod").ZodString;
         truncated: import("zod").ZodBoolean;
     }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
+    report: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+        events: import("zod").ZodArray<import("zod").ZodObject<{
+            seenAt: import("zod").ZodNumber;
+            level: import("zod").ZodEnum<{
+                error: "error";
+                warn: "warn";
+            }>;
+            event: import("zod").ZodString;
+            message: import("zod").ZodString;
+            route: import("zod").ZodOptional<import("zod").ZodString>;
+            requestId: import("zod").ZodOptional<import("zod").ZodString>;
+            build: import("zod").ZodOptional<import("zod").ZodString>;
+            fields: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber, import("zod").ZodBoolean]>>>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        recorded: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
 };
 //# sourceMappingURL=logs.contract.d.ts.map

package/dist/contracts/logs.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logs.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/logs.contract.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,YAAY;IACrB,IAAI;;;;;;;IACJ,IAAI;;;;;;;;;CACP,CAAC"}
+{"version":3,"file":"logs.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/logs.contract.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,YAAY;IACrB,IAAI;;;;;;;IASJ,IAAI;;;;;;;;;IAkBJ,MAAM;;;;;;;;;;;;;;;;;CAUT,CAAC"}

package/dist/contracts/logs.contract.js

@@ -1,7 +1,31 @@
 import { oc } from "@orpc/contract";
-import { LogReadQuerySchema, LogReadSchema, LogsListSchema } from "../schemas.js";
+import { ClientDiagnosticsAcceptedSchema, ClientDiagnosticsReportSchema, LogReadQuerySchema, LogReadSchema, LogsListSchema } from "../schemas.js";
 export const logsContract = {
-    list: oc.route({ method: "GET", path: "/logs" }).output(LogsListSchema),
-    read: oc.route({ method: "GET", path: "/logs/file" }).input(LogReadQuerySchema).output(LogReadSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/logs",
+        summary: "Logs the sandbox keeps",
+        description: "Every log file the daemon owns: captured terminal output, command runs, and the daemon's own log. Read-only, because only the sandbox writes them.",
+    })
+        .output(LogsListSchema),
+    read: oc
+        .route({
+        method: "GET",
+        path: "/logs/file",
+        summary: "Read part of a log",
+        description: "A window of one log file's text. A window rather than the whole thing, because a busy log outgrows any single answer.",
+    })
+        .input(LogReadQuerySchema)
+        .output(LogReadSchema),
+    report: oc
+        .route({
+        method: "POST",
+        path: "/logs/client",
+        summary: "Report what the browser saw",
+        description: "Errors the app caught, stalls it measured, and recoveries it performed, written to a log of their own. The browser is the only witness to these, so without it a bug someone hit in their own browser leaves no record at all.",
+    })
+        .input(ClientDiagnosticsReportSchema)
+        .output(ClientDiagnosticsAcceptedSchema),
 };
 //# sourceMappingURL=logs.contract.js.map

package/dist/contracts/logs.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"logs.contract.js","sourceRoot":"","sources":["../../src/contracts/logs.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIlF,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;IACvE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;CACxG,CAAC"}
+{"version":3,"file":"logs.contract.js","sourceRoot":"","sources":["../../src/contracts/logs.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,+BAA+B,EAAE,6BAA6B,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAMlJ,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,wBAAwB;QACjC,WAAW,EACP,oJAAoJ;KAC3J,CAAC;SACD,MAAM,CAAC,cAAc,CAAC;IAC3B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,oBAAoB;QAC7B,WAAW,EAAE,uHAAuH;KACvI,CAAC;SACD,KAAK,CAAC,kBAAkB,CAAC;SACzB,MAAM,CAAC,aAAa,CAAC;IAU1B,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,6BAA6B;QACtC,WAAW,EACP,gOAAgO;KACvO,CAAC;SACD,KAAK,CAAC,6BAA6B,CAAC;SACpC,MAAM,CAAC,+BAA+B,CAAC;CAC/C,CAAC"}

package/dist/contracts/loops.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loops.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/loops.contract.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,aAAa;IAGtB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOJ,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOL,IAAI;;;;;IAIJ,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAKP,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGV,YAAY;;;;;CACf,CAAC"}
+{"version":3,"file":"loops.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/loops.contract.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,aAAa;IAGtB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAeJ,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgBL,IAAI;;;;;IAaJ,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaP,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYV,YAAY;;;;;CAUf,CAAC"}

package/dist/contracts/loops.contract.js

@@ -1,11 +1,57 @@
 import { oc } from "@orpc/contract";
 import { LoopDesignIdParamSchema, LoopDesignSaveSchema, LoopDesignSchema, LoopDesignsListSchema, LoopIdParamSchema, LoopRecordSchema, LoopSchema, LoopsListSchema, OkSchema, } from "../schemas.js";
 export const loopsContract = {
-    list: oc.route({ method: "GET", path: "/loops" }).output(LoopsListSchema),
-    start: oc.route({ method: "POST", path: "/loops" }).input(LoopSchema).output(LoopRecordSchema),
-    stop: oc.route({ method: "POST", path: "/loops/{conversationId}/stop" }).input(LoopIdParamSchema).output(OkSchema),
-    designs: oc.route({ method: "GET", path: "/loops/designs" }).output(LoopDesignsListSchema),
-    saveDesign: oc.route({ method: "POST", path: "/loops/designs" }).input(LoopDesignSaveSchema).output(LoopDesignSchema),
-    removeDesign: oc.route({ method: "DELETE", path: "/loops/designs/{id}" }).input(LoopDesignIdParamSchema).output(OkSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/loops",
+        summary: "Every loop that has run",
+        description: "The loops this workspace has run, newest first, kept after they end. Why it stopped on the fourth round is the question a loop gets read for, and the round-by-round history is the answer.",
+    })
+        .output(LoopsListSchema),
+    start: oc
+        .route({
+        method: "POST",
+        path: "/loops",
+        summary: "Run a conversation until it is done",
+        description: "Starts repeating a conversation towards a goal and answers straight away with the loop as recorded; the work carries on without you. The conversation need not exist yet, so run this until it passes can be the first thing you ever say to a new agent. A conversation already looping is refused.",
+    })
+        .input(LoopSchema)
+        .output(LoopRecordSchema),
+    stop: oc
+        .route({
+        method: "POST",
+        path: "/loops/{conversationId}/stop",
+        summary: "Make this round the last",
+        description: "Means do not start another round, not stop what is running. Somebody watching the sixth round do good work can say this is the last one without throwing that work away. To cut the current round off as well, stop the conversation too.",
+    })
+        .input(LoopIdParamSchema)
+        .output(OkSchema),
+    designs: oc
+        .route({
+        method: "GET",
+        path: "/loops/designs",
+        summary: "Saved loop designs",
+        description: "Loops somebody authored once and can point at a different job each time. A saved loop is the same loop with its goal left blank until you type one, not a different feature.",
+    })
+        .output(LoopDesignsListSchema),
+    saveDesign: oc
+        .route({
+        method: "POST",
+        path: "/loops/designs",
+        summary: "Create or replace a saved loop",
+        description: "Say which of the two you mean, so a name that happens to collide cannot silently overwrite somebody's work. A design that could never finish, with nothing to produce and nothing to check, is refused in the same words an ad-hoc loop would be: catching that at save time is the whole advantage of saving.",
+    })
+        .input(LoopDesignSaveSchema)
+        .output(LoopDesignSchema),
+    removeDesign: oc
+        .route({
+        method: "DELETE",
+        path: "/loops/designs/{id}",
+        summary: "Delete a saved loop",
+        description: "Removes the design. A loop already running from it keeps going on its own terms, because it took a copy of what it needed when it started.",
+    })
+        .input(LoopDesignIdParamSchema)
+        .output(OkSchema),
 };
 //# sourceMappingURL=loops.contract.js.map

package/dist/contracts/loops.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"loops.contract.js","sourceRoot":"","sources":["../../src/contracts/loops.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EACH,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,QAAQ,GACX,MAAM,eAAe,CAAC;AAoBvB,MAAM,CAAC,MAAM,aAAa,GAAG;IAGzB,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC;IAOzE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAO9F,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAIlH,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC;IAK1F,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAGrH,YAAY,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CAC5H,CAAC"}
+{"version":3,"file":"loops.contract.js","sourceRoot":"","sources":["../../src/contracts/loops.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EACH,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,QAAQ,GACX,MAAM,eAAe,CAAC;AAoBvB,MAAM,CAAC,MAAM,aAAa,GAAG;IAGzB,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,yBAAyB;QAClC,WAAW,EACP,6LAA6L;KACpM,CAAC;SACD,MAAM,CAAC,eAAe,CAAC;IAO5B,KAAK,EAAE,EAAE;SACJ,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,qCAAqC;QAC9C,WAAW,EACP,sSAAsS;KAC7S,CAAC;SACD,KAAK,CAAC,UAAU,CAAC;SACjB,MAAM,CAAC,gBAAgB,CAAC;IAO7B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,8BAA8B;QACpC,OAAO,EAAE,0BAA0B;QACnC,WAAW,EACP,2OAA2O;KAClP,CAAC;SACD,KAAK,CAAC,iBAAiB,CAAC;SACxB,MAAM,CAAC,QAAQ,CAAC;IAIrB,OAAO,EAAE,EAAE;SACN,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,oBAAoB;QAC7B,WAAW,EACP,8KAA8K;KACrL,CAAC;SACD,MAAM,CAAC,qBAAqB,CAAC;IAKlC,UAAU,EAAE,EAAE;SACT,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,gCAAgC;QACzC,WAAW,EACP,gTAAgT;KACvT,CAAC;SACD,KAAK,CAAC,oBAAoB,CAAC;SAC3B,MAAM,CAAC,gBAAgB,CAAC;IAG7B,YAAY,EAAE,EAAE;SACX,KAAK,CAAC;QACH,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EACP,4IAA4I;KACnJ,CAAC;SACD,KAAK,CAAC,uBAAuB,CAAC;SAC9B,MAAM,CAAC,QAAQ,CAAC;CACxB,CAAC"}

package/dist/contracts/panels.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panels.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/panels.contract.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,cAAc;IACvB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;IACJ,KAAK;;;;;IACL,IAAI;;;;;CACP,CAAC"}
+{"version":3,"file":"panels.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/panels.contract.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,cAAc;IACvB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQJ,KAAK;;;;;IASL,IAAI;;;;;CASP,CAAC"}

package/dist/contracts/panels.contract.js

@@ -1,8 +1,31 @@
 import { oc } from "@orpc/contract";
 import { OkSchema, PanelRepoParamSchema, PanelsListSchema } from "../schemas.js";
 export const panelsContract = {
-    list: oc.route({ method: "GET", path: "/panels" }).output(PanelsListSchema),
-    start: oc.route({ method: "POST", path: "/panels/{repo}/start" }).input(PanelRepoParamSchema).output(OkSchema),
-    stop: oc.route({ method: "POST", path: "/panels/{repo}/stop" }).input(PanelRepoParamSchema).output(OkSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/panels",
+        summary: "Repos you can run and preview",
+        description: "Every repo with whether its dev server is up and what the sandbox worked out about its contents.",
+    })
+        .output(PanelsListSchema),
+    start: oc
+        .route({
+        method: "POST",
+        path: "/panels/{repo}/start",
+        summary: "Start a repo's dev server",
+        description: "Brings the repo's own runnable app up in a terminal you can attach to, so its preview address starts answering.",
+    })
+        .input(PanelRepoParamSchema)
+        .output(OkSchema),
+    stop: oc
+        .route({
+        method: "POST",
+        path: "/panels/{repo}/stop",
+        summary: "Stop a repo's dev server",
+        description: "Shuts it down and frees the port.",
+    })
+        .input(PanelRepoParamSchema)
+        .output(OkSchema),
 };
 //# sourceMappingURL=panels.contract.js.map

package/dist/contracts/panels.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"panels.contract.js","sourceRoot":"","sources":["../../src/contracts/panels.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAMjF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAC3E,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9G,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CAC/G,CAAC"}
+{"version":3,"file":"panels.contract.js","sourceRoot":"","sources":["../../src/contracts/panels.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAMjF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,+BAA+B;QACxC,WAAW,EAAE,kGAAkG;KAClH,CAAC;SACD,MAAM,CAAC,gBAAgB,CAAC;IAC7B,KAAK,EAAE,EAAE;SACJ,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,2BAA2B;QACpC,WAAW,EAAE,iHAAiH;KACjI,CAAC;SACD,KAAK,CAAC,oBAAoB,CAAC;SAC3B,MAAM,CAAC,QAAQ,CAAC;IACrB,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,0BAA0B;QACnC,WAAW,EAAE,mCAAmC;KACnD,CAAC;SACD,KAAK,CAAC,oBAAoB,CAAC;SAC3B,MAAM,CAAC,QAAQ,CAAC;CACxB,CAAC"}

package/dist/contracts/personas.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"personas.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/personas.contract.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,gBAAgB;IACzB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEJ,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASJ,MAAM;;;;;IAIN,GAAG;;;;;;;;;IAGH,UAAU;;;;;;IACV,SAAS;;;;;;;;IAGT,SAAS;;;;;;;;IACT,WAAW;;;;;;CACd,CAAC"}
+{"version":3,"file":"personas.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/personas.contract.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,gBAAgB;IACzB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUJ,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkBJ,MAAM;;;;;IAaN,GAAG;;;;;;;;;IAYH,UAAU;;;;;;IAUV,SAAS;;;;;;;;IAWT,SAAS;;;;;;;;IAUT,WAAW;;;;;;CASd,CAAC"}

package/dist/contracts/personas.contract.js

@@ -1,13 +1,76 @@
 import { oc } from "@orpc/contract";
 import { OkSchema, PersonaIdParamSchema, PersonaKitSchema, PersonaPromptSchema, PersonaSchema, PersonasListSchema, PersonaSkillBodySchema, PersonaSkillNameSchema, PersonaSkillSchema, } from "../schemas.js";
 export const personasContract = {
-    list: oc.route({ method: "GET", path: "/personas" }).output(PersonasListSchema),
-    save: oc.route({ method: "POST", path: "/personas" }).input(PersonaSchema).output(OkSchema),
-    remove: oc.route({ method: "DELETE", path: "/personas/{id}" }).input(PersonaIdParamSchema).output(OkSchema),
-    kit: oc.route({ method: "GET", path: "/personas/{id}/kit" }).input(PersonaIdParamSchema).output(PersonaKitSchema),
-    savePrompt: oc.route({ method: "POST", path: "/personas/{id}/prompt" }).input(PersonaPromptSchema).output(OkSchema),
-    readSkill: oc.route({ method: "GET", path: "/personas/{id}/skills/read" }).input(PersonaSkillNameSchema).output(PersonaSkillBodySchema),
-    saveSkill: oc.route({ method: "POST", path: "/personas/{id}/skills" }).input(PersonaSkillSchema).output(OkSchema),
-    removeSkill: oc.route({ method: "POST", path: "/personas/{id}/skills/remove" }).input(PersonaSkillNameSchema).output(OkSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/personas",
+        summary: "The characters an agent can wear",
+        description: "Each persona with the connected accounts it speaks for, what a conversation wearing it is allowed to do, and where it works.",
+    })
+        .output(PersonasListSchema),
+    save: oc
+        .route({
+        method: "POST",
+        path: "/personas",
+        summary: "Create or edit a persona",
+        description: "Writes the whole card; sending an id that exists edits it. Nothing is connected, installed or spent by saving one, because a persona only records a decision about accounts that already exist. It is stored as a file you can equally well edit by hand, which is why this writes the card whole rather than patching a field: a round trip through a screen should leave a change a reviewer recognises.",
+    })
+        .input(PersonaSchema)
+        .output(OkSchema),
+    remove: oc
+        .route({
+        method: "DELETE",
+        path: "/personas/{id}",
+        summary: "Delete a persona",
+        description: "Takes away the character, never the accounts: every login it named stays connected. Its own prompt and skills go with it, since a folder nothing can reach is worse than deleting what somebody just asked to delete. Anything still pointed at it goes quiet rather than falling back to speaking as everyone.",
+    })
+        .input(PersonaIdParamSchema)
+        .output(OkSchema),
+    kit: oc
+        .route({
+        method: "GET",
+        path: "/personas/{id}/kit",
+        summary: "What one persona carries",
+        description: "The instructions this persona is given and the skills only its conversations can reach. A different question from what the agent knows generally, with a different answer.",
+    })
+        .input(PersonaIdParamSchema)
+        .output(PersonaKitSchema),
+    savePrompt: oc
+        .route({
+        method: "POST",
+        path: "/personas/{id}/prompt",
+        summary: "Write a persona's instructions",
+        description: "Sets what this persona is told. Saving an empty one removes it entirely rather than storing a blank, so the persona simply falls back to the sandbox's own instructions.",
+    })
+        .input(PersonaPromptSchema)
+        .output(OkSchema),
+    readSkill: oc
+        .route({
+        method: "GET",
+        path: "/personas/{id}/skills/read",
+        summary: "Read one of a persona's skills",
+        description: "The full text of a single skill belonging to this persona.",
+    })
+        .input(PersonaSkillNameSchema)
+        .output(PersonaSkillBodySchema),
+    saveSkill: oc
+        .route({
+        method: "POST",
+        path: "/personas/{id}/skills",
+        summary: "Write one of a persona's skills",
+        description: "Creates or replaces a skill by name. There is nothing to switch on: a persona's skill is available exactly when that persona is worn, which is what belonging to it has to mean.",
+    })
+        .input(PersonaSkillSchema)
+        .output(OkSchema),
+    removeSkill: oc
+        .route({
+        method: "POST",
+        path: "/personas/{id}/skills/remove",
+        summary: "Delete one of a persona's skills",
+        description: "Removes a single skill from this persona and leaves the rest of its kit alone.",
+    })
+        .input(PersonaSkillNameSchema)
+        .output(OkSchema),
 };
 //# sourceMappingURL=personas.contract.js.map

package/dist/contracts/personas.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"personas.contract.js","sourceRoot":"","sources":["../../src/contracts/personas.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EACH,QAAQ,EACR,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,GACrB,MAAM,eAAe,CAAC;AAmBvB,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC;IAE/E,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAS3F,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAI3G,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAGjH,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACnH,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC;IAGvI,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACjH,WAAW,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CACjI,CAAC"}
+{"version":3,"file":"personas.contract.js","sourceRoot":"","sources":["../../src/contracts/personas.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EACH,QAAQ,EACR,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,GACrB,MAAM,eAAe,CAAC;AAmBvB,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EACP,8HAA8H;KACrI,CAAC;SACD,MAAM,CAAC,kBAAkB,CAAC;IAE/B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,0BAA0B;QACnC,WAAW,EACP,4YAA4Y;KACnZ,CAAC;SACD,KAAK,CAAC,aAAa,CAAC;SACpB,MAAM,CAAC,QAAQ,CAAC;IASrB,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EACP,iTAAiT;KACxT,CAAC;SACD,KAAK,CAAC,oBAAoB,CAAC;SAC3B,MAAM,CAAC,QAAQ,CAAC;IAIrB,GAAG,EAAE,EAAE;SACF,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,0BAA0B;QACnC,WAAW,EACP,4KAA4K;KACnL,CAAC;SACD,KAAK,CAAC,oBAAoB,CAAC;SAC3B,MAAM,CAAC,gBAAgB,CAAC;IAG7B,UAAU,EAAE,EAAE;SACT,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,gCAAgC;QACzC,WAAW,EACP,0KAA0K;KACjL,CAAC;SACD,KAAK,CAAC,mBAAmB,CAAC;SAC1B,MAAM,CAAC,QAAQ,CAAC;IACrB,SAAS,EAAE,EAAE;SACR,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,4BAA4B;QAClC,OAAO,EAAE,gCAAgC;QACzC,WAAW,EAAE,4DAA4D;KAC5E,CAAC;SACD,KAAK,CAAC,sBAAsB,CAAC;SAC7B,MAAM,CAAC,sBAAsB,CAAC;IAGnC,SAAS,EAAE,EAAE;SACR,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,iCAAiC;QAC1C,WAAW,EACP,kLAAkL;KACzL,CAAC;SACD,KAAK,CAAC,kBAAkB,CAAC;SACzB,MAAM,CAAC,QAAQ,CAAC;IACrB,WAAW,EAAE,EAAE;SACV,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,8BAA8B;QACpC,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EAAE,gFAAgF;KAChG,CAAC;SACD,KAAK,CAAC,sBAAsB,CAAC;SAC7B,MAAM,CAAC,QAAQ,CAAC;CACxB,CAAC"}

package/dist/contracts/ports.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ports.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/ports.contract.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa;IACtB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACJ,OAAO;;;;;IACP,SAAS;;;;;CACZ,CAAC"}
+{"version":3,"file":"ports.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/ports.contract.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa;IACtB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQJ,OAAO;;;;;IAUP,SAAS;;;;;CASZ,CAAC"}

package/dist/contracts/ports.contract.js

@@ -1,8 +1,31 @@
 import { oc } from "@orpc/contract";
 import { OkSchema, PortForwardResultSchema, PortParamSchema, PortsListSchema } from "../schemas.js";
 export const portsContract = {
-    list: oc.route({ method: "GET", path: "/ports" }).output(PortsListSchema),
-    forward: oc.route({ method: "POST", path: "/ports/forward" }).input(PortParamSchema).output(PortForwardResultSchema),
-    unforward: oc.route({ method: "POST", path: "/ports/unforward" }).input(PortParamSchema).output(OkSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/ports",
+        summary: "What is listening inside the sandbox",
+        description: "Every port something is answering on, and whether each one is reachable from outside.",
+    })
+        .output(PortsListSchema),
+    forward: oc
+        .route({
+        method: "POST",
+        path: "/ports/forward",
+        summary: "Make a port reachable",
+        description: "Gives one port an address on the outside. Asking twice is harmless: the second call hands back the address the first one made.",
+    })
+        .input(PortParamSchema)
+        .output(PortForwardResultSchema),
+    unforward: oc
+        .route({
+        method: "POST",
+        path: "/ports/unforward",
+        summary: "Stop exposing a port",
+        description: "Frees the slot at once. The address keeps resolving; it simply stops leading anywhere.",
+    })
+        .input(PortParamSchema)
+        .output(OkSchema),
 };
 //# sourceMappingURL=ports.contract.js.map

package/dist/contracts/ports.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"ports.contract.js","sourceRoot":"","sources":["../../src/contracts/ports.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKpG,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC;IACzE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,uBAAuB,CAAC;IACpH,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CAC5G,CAAC"}
+{"version":3,"file":"ports.contract.js","sourceRoot":"","sources":["../../src/contracts/ports.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKpG,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,sCAAsC;QAC/C,WAAW,EAAE,uFAAuF;KACvG,CAAC;SACD,MAAM,CAAC,eAAe,CAAC;IAC5B,OAAO,EAAE,EAAE;SACN,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,uBAAuB;QAChC,WAAW,EACP,gIAAgI;KACvI,CAAC;SACD,KAAK,CAAC,eAAe,CAAC;SACtB,MAAM,CAAC,uBAAuB,CAAC;IACpC,SAAS,EAAE,EAAE;SACR,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,sBAAsB;QAC/B,WAAW,EAAE,wFAAwF;KACxG,CAAC;SACD,KAAK,CAAC,eAAe,CAAC;SACtB,MAAM,CAAC,QAAQ,CAAC;CACxB,CAAC"}

package/dist/contracts/prepush.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepush.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/prepush.contract.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,eAAe;IACxB,KAAK;;;;;;;;;;;;;;;;;IACL,GAAG;;;IACH,MAAM;;;CACT,CAAC"}
+{"version":3,"file":"prepush.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/prepush.contract.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,eAAe;IACxB,KAAK;;;;;;;;;;;;;;;;;IASL,GAAG;;;IASH,MAAM;;;CAQT,CAAC"}

package/dist/contracts/prepush.contract.js

@@ -1,8 +1,29 @@
 import { oc } from "@orpc/contract";
 import { OkSchema, PrepushRunSchema } from "../schemas.js";
 export const prepushContract = {
-    state: oc.route({ method: "GET", path: "/prepush/state" }).output(PrepushRunSchema),
-    run: oc.route({ method: "POST", path: "/prepush/run" }).output(OkSchema),
-    cancel: oc.route({ method: "POST", path: "/prepush/cancel" }).output(OkSchema),
+    state: oc
+        .route({
+        method: "GET",
+        path: "/prepush/state",
+        summary: "How the pre-push check is going",
+        description: "The verdict, or the progress so far. Nothing is addressed by id here, because there is one working tree and so exactly one check.",
+    })
+        .output(PrepushRunSchema),
+    run: oc
+        .route({
+        method: "POST",
+        path: "/prepush/run",
+        summary: "Run the checks before pushing",
+        description: "Starts the suite the workspace runs before anything leaves the machine, and answers immediately. A suite takes minutes, and a request held open that long dies at the first proxy. It runs in a real terminal, so watch it there and poll for the verdict.",
+    })
+        .output(OkSchema),
+    cancel: oc
+        .route({
+        method: "POST",
+        path: "/prepush/cancel",
+        summary: "Stop the pre-push check",
+        description: "Kills the run. It settles as cancelled and the push it was gating does not go.",
+    })
+        .output(OkSchema),
 };
 //# sourceMappingURL=prepush.contract.js.map

package/dist/contracts/prepush.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepush.contract.js","sourceRoot":"","sources":["../../src/contracts/prepush.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAW3D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;IACnF,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACxE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CACjF,CAAC"}
+{"version":3,"file":"prepush.contract.js","sourceRoot":"","sources":["../../src/contracts/prepush.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAW3D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,KAAK,EAAE,EAAE;SACJ,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,iCAAiC;QAC1C,WAAW,EACP,mIAAmI;KAC1I,CAAC;SACD,MAAM,CAAC,gBAAgB,CAAC;IAC7B,GAAG,EAAE,EAAE;SACF,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,+BAA+B;QACxC,WAAW,EACP,4PAA4P;KACnQ,CAAC;SACD,MAAM,CAAC,QAAQ,CAAC;IACrB,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,yBAAyB;QAClC,WAAW,EAAE,gFAAgF;KAChG,CAAC;SACD,MAAM,CAAC,QAAQ,CAAC;CACxB,CAAC"}

package/dist/contracts/providers.contract.d.ts

@@ -17,6 +17,7 @@ export declare const providersContract: {
                 fast: "fast";
                 reasoning: "reasoning";
             }>>>;
+            contextWindow: import("zod").ZodOptional<import("zod").ZodNumber>;
         }, import("zod/v4/core").$strip>>;
         default: import("zod").ZodString;
     }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;

package/dist/contracts/providers.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"providers.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/providers.contract.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,iBAAiB;IAG1B,MAAM;;;;;;;;;;;;;;;;;;;;;CACT,CAAC"}
+{"version":3,"file":"providers.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/providers.contract.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,iBAAiB;IAG1B,MAAM;;;;;;;;;;;;;;;;;;;;;;CAUT,CAAC"}

package/dist/contracts/providers.contract.js

@@ -1,6 +1,14 @@
 import { oc } from "@orpc/contract";
 import { ModelsSchema, NativeProviderParamSchema } from "../schemas.js";
 export const providersContract = {
-    models: oc.route({ method: "GET", path: "/providers/{provider}/models" }).input(NativeProviderParamSchema).output(ModelsSchema),
+    models: oc
+        .route({
+        method: "GET",
+        path: "/providers/{provider}/models",
+        summary: "Models one provider offers",
+        description: "Every model this provider serves and which one it defaults to. Never empty: it is discovered live with a stored list behind it. The order is the provider's own preference and is not rearranged here.",
+    })
+        .input(NativeProviderParamSchema)
+        .output(ModelsSchema),
 };
 //# sourceMappingURL=providers.contract.js.map

package/dist/contracts/providers.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"providers.contract.js","sourceRoot":"","sources":["../../src/contracts/providers.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAiBxE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAG7B,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;CAClI,CAAC"}
+{"version":3,"file":"providers.contract.js","sourceRoot":"","sources":["../../src/contracts/providers.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAiBxE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAG7B,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,8BAA8B;QACpC,OAAO,EAAE,4BAA4B;QACrC,WAAW,EACP,wMAAwM;KAC/M,CAAC;SACD,KAAK,CAAC,yBAAyB,CAAC;SAChC,MAAM,CAAC,YAAY,CAAC;CAC5B,CAAC"}

package/dist/contracts/public.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/public.contract.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,cAAc;IACvB,IAAI;;;;;;;;;;IACJ,OAAO;;;;;;IACP,SAAS;;;;;CACZ,CAAC"}
+{"version":3,"file":"public.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/public.contract.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,cAAc;IACvB,IAAI;;;;;;;;;;IASJ,OAAO;;;;;;IAUP,SAAS;;;;;CAUZ,CAAC"}

package/dist/contracts/public.contract.js

@@ -1,8 +1,31 @@
 import { oc } from "@orpc/contract";
 import { OkSchema, PublicListSchema, PublishResultSchema, PublishSchema, UnpublishSchema } from "../schemas.js";
 export const publicContract = {
-    list: oc.route({ method: "GET", path: "/public" }).output(PublicListSchema),
-    publish: oc.route({ method: "POST", path: "/public/publish" }).input(PublishSchema).output(PublishResultSchema),
-    unpublish: oc.route({ method: "POST", path: "/public/unpublish" }).input(UnpublishSchema).output(OkSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/public",
+        summary: "What is published to the internet",
+        description: "Everything currently in the outbox and the address it answers on. There is no call to read a published file back: it is served openly to anyone with the link, which is the entire point of having put it there.",
+    })
+        .output(PublicListSchema),
+    publish: oc
+        .route({
+        method: "POST",
+        path: "/public/publish",
+        summary: "Put a file on the internet",
+        description: "Copies a workspace file or folder into the outbox, where it is served to anyone with the link and no sign-in. Answers with the address.",
+    })
+        .input(PublishSchema)
+        .output(PublishResultSchema),
+    unpublish: oc
+        .route({
+        method: "POST",
+        path: "/public/unpublish",
+        summary: "Take something off the internet",
+        description: "Withdraws one published entry. When the last one goes, the outbox goes with it, so its existing at all always means something is published.",
+    })
+        .input(UnpublishSchema)
+        .output(OkSchema),
 };
 //# sourceMappingURL=public.contract.js.map

package/dist/contracts/public.contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"public.contract.js","sourceRoot":"","sources":["../../src/contracts/public.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQhH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAC3E,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC;IAC/G,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CAC7G,CAAC"}
+{"version":3,"file":"public.contract.js","sourceRoot":"","sources":["../../src/contracts/public.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQhH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,mCAAmC;QAC5C,WAAW,EACP,kNAAkN;KACzN,CAAC;SACD,MAAM,CAAC,gBAAgB,CAAC;IAC7B,OAAO,EAAE,EAAE;SACN,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,4BAA4B;QACrC,WAAW,EACP,yIAAyI;KAChJ,CAAC;SACD,KAAK,CAAC,aAAa,CAAC;SACpB,MAAM,CAAC,mBAAmB,CAAC;IAChC,SAAS,EAAE,EAAE;SACR,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,iCAAiC;QAC1C,WAAW,EACP,6IAA6I;KACpJ,CAAC;SACD,KAAK,CAAC,eAAe,CAAC;SACtB,MAAM,CAAC,QAAQ,CAAC;CACxB,CAAC"}

package/dist/contracts/push.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"push.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/push.contract.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,YAAY;IACrB,MAAM;;;;;;IACN,SAAS;;;;;;;;;;;;;;;IACT,WAAW;;;;;IACX,IAAI;;;CACP,CAAC"}
+{"version":3,"file":"push.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/push.contract.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,YAAY;IACrB,MAAM;;;;;;IASN,SAAS;;;;;;;;;;;;;;;IAUT,WAAW;;;;;IASX,IAAI;;;CASP,CAAC"}