@intentic/sandbox-contract 1.226.0 → 1.227.0

package/dist/contracts/translator.contract.js

@@ -2,14 +2,39 @@ import { oc } from "@orpc/contract";
 import { z } from "zod";
 import { KeyedProviderSchema, OkSchema, TranslatorAccountsSchema, TranslatorCompleteSchema, TranslatorStartSchema } from "../schemas.js";
 export const translatorContract = {
-    accounts: oc.route({ method: "GET", path: "/translator/accounts" }).output(TranslatorAccountsSchema),
+    accounts: oc
+        .route({
+        method: "GET",
+        path: "/translator/accounts",
+        summary: "Subscriptions connected through the translator",
+        description: "What is signed in per provider. Each provider can hold several accounts at once, and the translator spreads work across them.",
+    })
+        .output(TranslatorAccountsSchema),
     connect: oc
-        .route({ method: "POST", path: "/translator/{provider}/connect" })
+        .route({
+        method: "POST",
+        path: "/translator/{provider}/connect",
+        summary: "Start connecting a subscription",
+        description: "Begins the sign-in for one provider and says which of the two shapes it is: a code you type into a device page, which finishes by itself in the background, or a redirect whose landing address you hand back afterwards.",
+    })
         .input(z.object({ provider: KeyedProviderSchema }))
         .output(TranslatorStartSchema),
-    complete: oc.route({ method: "POST", path: "/translator/{provider}/complete" }).input(TranslatorCompleteSchema).output(OkSchema),
+    complete: oc
+        .route({
+        method: "POST",
+        path: "/translator/{provider}/complete",
+        summary: "Finish a redirect sign-in",
+        description: "For the providers that redirect somewhere this sandbox cannot receive: hand back the address you landed on and the connection completes.",
+    })
+        .input(TranslatorCompleteSchema)
+        .output(OkSchema),
     disconnect: oc
-        .route({ method: "POST", path: "/translator/{provider}/disconnect" })
+        .route({
+        method: "POST",
+        path: "/translator/{provider}/disconnect",
+        summary: "Disconnect one subscription",
+        description: "Clears a single account by name. Any others under the same provider stay connected.",
+    })
         .input(z.object({ provider: KeyedProviderSchema, name: z.string().min(1) }))
         .output(OkSchema),
 };

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

@@ -1 +1 @@
-{"version":3,"file":"translator.contract.js","sourceRoot":"","sources":["../../src/contracts/translator.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAWzI,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC;IACpG,OAAO,EAAE,EAAE;SACN,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gCAAgC,EAAE,CAAC;SACjE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAC;SAClD,MAAM,CAAC,qBAAqB,CAAC;IAClC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAChI,UAAU,EAAE,EAAE;SACT,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mCAAmC,EAAE,CAAC;SACpE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC3E,MAAM,CAAC,QAAQ,CAAC;CACxB,CAAC"}
+{"version":3,"file":"translator.contract.js","sourceRoot":"","sources":["../../src/contracts/translator.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAWzI,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,QAAQ,EAAE,EAAE;SACP,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,gDAAgD;QACzD,WAAW,EACP,+HAA+H;KACtI,CAAC;SACD,MAAM,CAAC,wBAAwB,CAAC;IACrC,OAAO,EAAE,EAAE;SACN,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,gCAAgC;QACtC,OAAO,EAAE,iCAAiC;QAC1C,WAAW,EACP,2NAA2N;KAClO,CAAC;SACD,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAC;SAClD,MAAM,CAAC,qBAAqB,CAAC;IAClC,QAAQ,EAAE,EAAE;SACP,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iCAAiC;QACvC,OAAO,EAAE,2BAA2B;QACpC,WAAW,EACP,0IAA0I;KACjJ,CAAC;SACD,KAAK,CAAC,wBAAwB,CAAC;SAC/B,MAAM,CAAC,QAAQ,CAAC;IACrB,UAAU,EAAE,EAAE;SACT,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,mCAAmC;QACzC,OAAO,EAAE,6BAA6B;QACtC,WAAW,EAAE,qFAAqF;KACrG,CAAC;SACD,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC3E,MAAM,CAAC,QAAQ,CAAC;CACxB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"usage.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/usage.contract.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,aAAa;IACtB,MAAM;;;;;;;;;;;;;;;;;;;;CACT,CAAC"}
+{"version":3,"file":"usage.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/usage.contract.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,aAAa;IACtB,MAAM;;;;;;;;;;;;;;;;;;;;CAUT,CAAC"}

package/dist/contracts/usage.contract.js

@@ -1,6 +1,14 @@
 import { oc } from "@orpc/contract";
 import { DayWindowQuerySchema, UsageRollupSchema } from "../schemas.js";
 export const usageContract = {
-    rollup: oc.route({ method: "GET", path: "/usage/rollup" }).input(DayWindowQuerySchema).output(UsageRollupSchema),
+    rollup: oc
+        .route({
+        method: "GET",
+        path: "/usage/rollup",
+        summary: "What was spent, grouped",
+        description: "The spending record over a range of days, grouped by day, provider, account and model. Everything a cost screen shows is a rearrangement of this one answer, so nothing needs a second call. Read-only: rows are written by the sandbox as turns end, which is what makes it worth trusting.",
+    })
+        .input(DayWindowQuerySchema)
+        .output(UsageRollupSchema),
 };
 //# sourceMappingURL=usage.contract.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"usage.contract.js","sourceRoot":"","sources":["../../src/contracts/usage.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAMxE,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;CACnH,CAAC"}
+{"version":3,"file":"usage.contract.js","sourceRoot":"","sources":["../../src/contracts/usage.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAMxE,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,yBAAyB;QAClC,WAAW,EACP,8RAA8R;KACrS,CAAC;SACD,KAAK,CAAC,oBAAoB,CAAC;SAC3B,MAAM,CAAC,iBAAiB,CAAC;CACjC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"vpn.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/vpn.contract.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,WAAW;IAEpB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;IAIJ,OAAO;;;;;;;;;;IAEP,UAAU;;;;;IAGV,iBAAiB;;;;;;;;;;;;;;;;;;;;;;CAIpB,CAAC"}
+{"version":3,"file":"vpn.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/vpn.contract.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,WAAW;IAEpB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;IAYJ,OAAO;;;;;;;;;;IAWP,UAAU;;;;;IAWV,iBAAiB;;;;;;;;;;;;;;;;;;;;;;CAUpB,CAAC"}

package/dist/contracts/vpn.contract.js

@@ -2,11 +2,39 @@ import { eventIterator, oc } from "@orpc/contract";
 import { IntenticLineSchema } from "../events.js";
 import { ForticlientImportInputSchema, ForticlientImportSchema, OkSchema, VpnConnectInputSchema, VpnIdParamSchema, VpnListSchema, } from "../schemas.js";
 export const vpnContract = {
-    list: oc.route({ method: "GET", path: "/vpn" }).output(VpnListSchema),
-    connect: oc.route({ method: "POST", path: "/vpn/{id}/connect" }).input(VpnConnectInputSchema).output(eventIterator(IntenticLineSchema)),
-    disconnect: oc.route({ method: "POST", path: "/vpn/{id}/disconnect" }).input(VpnIdParamSchema).output(OkSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/vpn",
+        summary: "Configured tunnels and which are up",
+        description: "Every stored VPN with its live link state, read back from the operating system rather than from memory, so a tunnel dropped from a shell and one dropped from a screen look the same here.",
+    })
+        .output(VpnListSchema),
+    connect: oc
+        .route({
+        method: "POST",
+        path: "/vpn/{id}/connect",
+        summary: "Dial a VPN",
+        description: "Brings a stored tunnel up, streaming the client's progress as it authenticates and then sets up routing. Streamed because a dial takes seconds and can fail with something you have to read: a wrong password, a gateway certificate nobody trusts, a code it wants. Connecting one that is already up simply says so.",
+    })
+        .input(VpnConnectInputSchema)
+        .output(eventIterator(IntenticLineSchema)),
+    disconnect: oc
+        .route({
+        method: "POST",
+        path: "/vpn/{id}/disconnect",
+        summary: "Drop a tunnel",
+        description: "Takes the tunnel down. One that was already down is fine: the promise is that it is not up afterwards.",
+    })
+        .input(VpnIdParamSchema)
+        .output(OkSchema),
     importForticlient: oc
-        .route({ method: "POST", path: "/vpn/import-forticlient" })
+        .route({
+        method: "POST",
+        path: "/vpn/import-forticlient",
+        summary: "Read connections out of an exported config",
+        description: "Turns an exported FortiClient configuration into a list of connections you can add, so somebody holding that file picks from a list instead of retyping a host and port for every tunnel.",
+    })
         .input(ForticlientImportInputSchema)
         .output(ForticlientImportSchema),
 };

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

@@ -1 +1 @@
-{"version":3,"file":"vpn.contract.js","sourceRoot":"","sources":["../../src/contracts/vpn.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACH,4BAA4B,EAC5B,uBAAuB,EACvB,QAAQ,EACR,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,GAChB,MAAM,eAAe,CAAC;AAUvB,MAAM,CAAC,MAAM,WAAW,GAAG;IAEvB,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;IAIrE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAEvI,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAG/G,iBAAiB,EAAE,EAAE;SAChB,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC;SAC1D,KAAK,CAAC,4BAA4B,CAAC;SACnC,MAAM,CAAC,uBAAuB,CAAC;CACvC,CAAC"}
+{"version":3,"file":"vpn.contract.js","sourceRoot":"","sources":["../../src/contracts/vpn.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACH,4BAA4B,EAC5B,uBAAuB,EACvB,QAAQ,EACR,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,GAChB,MAAM,eAAe,CAAC;AAUvB,MAAM,CAAC,MAAM,WAAW,GAAG;IAEvB,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,qCAAqC;QAC9C,WAAW,EACP,4LAA4L;KACnM,CAAC;SACD,MAAM,CAAC,aAAa,CAAC;IAI1B,OAAO,EAAE,EAAE;SACN,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,YAAY;QACrB,WAAW,EACP,wTAAwT;KAC/T,CAAC;SACD,KAAK,CAAC,qBAAqB,CAAC;SAC5B,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAE9C,UAAU,EAAE,EAAE;SACT,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,wGAAwG;KACxH,CAAC;SACD,KAAK,CAAC,gBAAgB,CAAC;SACvB,MAAM,CAAC,QAAQ,CAAC;IAGrB,iBAAiB,EAAE,EAAE;SAChB,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,4CAA4C;QACrD,WAAW,EACP,2LAA2L;KAClM,CAAC;SACD,KAAK,CAAC,4BAA4B,CAAC;SACnC,MAAM,CAAC,uBAAuB,CAAC;CACvC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"workflows.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/workflows.contract.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,iBAAiB;IAG1B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMJ,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGJ,MAAM;;;;;IAMN,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGH,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAcJ,OAAO;;;;;IAaP,UAAU;;;;;IAGV,YAAY;;;;;CACf,CAAC"}
+{"version":3,"file":"workflows.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/workflows.contract.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,iBAAiB;IAG1B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAcJ,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYJ,MAAM;;;;;IAeN,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYH,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsBJ,OAAO;;;;;IAsBP,UAAU;;;;;IAYV,YAAY;;;;;CASf,CAAC"}

package/dist/contracts/workflows.contract.js

@@ -1,13 +1,75 @@
 import { oc } from "@orpc/contract";
 import { OkSchema, WorkflowIdParamSchema, WorkflowRunIdParamSchema, WorkflowRunSchema, WorkflowRunsListSchema, WorkflowRunStartSchema, WorkflowSaveSchema, WorkflowSchema, WorkflowsListSchema, } from "../schemas.js";
 export const workflowsContract = {
-    list: oc.route({ method: "GET", path: "/workflows" }).output(WorkflowsListSchema),
-    save: oc.route({ method: "POST", path: "/workflows" }).input(WorkflowSaveSchema).output(WorkflowSchema),
-    remove: oc.route({ method: "DELETE", path: "/workflows/{id}" }).input(WorkflowIdParamSchema).output(OkSchema),
-    run: oc.route({ method: "POST", path: "/workflows/{id}/run" }).input(WorkflowRunStartSchema).output(WorkflowRunSchema),
-    runs: oc.route({ method: "GET", path: "/workflows/runs" }).output(WorkflowRunsListSchema),
-    stopRun: oc.route({ method: "POST", path: "/workflows/runs/{runId}/stop" }).input(WorkflowRunIdParamSchema).output(OkSchema),
-    archiveRun: oc.route({ method: "POST", path: "/workflows/runs/{runId}/archive" }).input(WorkflowRunIdParamSchema).output(OkSchema),
-    unarchiveRun: oc.route({ method: "POST", path: "/workflows/runs/{runId}/unarchive" }).input(WorkflowRunIdParamSchema).output(OkSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/workflows",
+        summary: "Saved workflows and their runs",
+        description: "Every workflow somebody has designed, each with its own run history, newest first. One answer rather than two, because a workflow that has never been run is the interesting case rather than a mistake.",
+    })
+        .output(WorkflowsListSchema),
+    save: oc
+        .route({
+        method: "POST",
+        path: "/workflows",
+        summary: "Create or replace a workflow",
+        description: "Writes a workflow design. Say which of the two you mean, so an id that happens to collide cannot silently overwrite somebody's work. A design that could never run is refused, in the same words the editor shows while you type: a loop in the steps, a step waiting on one that is not there, a step with no way of knowing it is finished.",
+    })
+        .input(WorkflowSaveSchema)
+        .output(WorkflowSchema),
+    remove: oc
+        .route({
+        method: "DELETE",
+        path: "/workflows/{id}",
+        summary: "Delete a workflow",
+        description: "Removes the design. A run of it that is already going keeps going and stays readable and stoppable, because a run takes its own copy of the design when it starts.",
+    })
+        .input(WorkflowIdParamSchema)
+        .output(OkSchema),
+    run: oc
+        .route({
+        method: "POST",
+        path: "/workflows/{id}/run",
+        summary: "Start a workflow",
+        description: "Kicks a workflow off and answers immediately with the run as recorded; the work carries on without you. Point it at a question and every step gets that on top of its own instructions. Every step is written down as waiting up front, so the picture is complete from the first frame. Several runs of one design can be in flight at once without colliding.",
+    })
+        .input(WorkflowRunStartSchema)
+        .output(WorkflowRunSchema),
+    runs: oc
+        .route({
+        method: "GET",
+        path: "/workflows/runs",
+        summary: "Every workflow run",
+        description: "All runs across all workflows, newest first. This is also the only place the runs of a deleted workflow are still reachable.",
+    })
+        .output(WorkflowRunsListSchema),
+    stopRun: oc
+        .route({
+        method: "POST",
+        path: "/workflows/runs/{runId}/stop",
+        summary: "Stop a run now",
+        description: "Nothing further starts, and the steps already going are cut off where they stand. Whatever they had written stays on their branches. Deliberately abrupt rather than letting the current step finish: a step is a whole agent turn, and a stop that kept spending for minutes afterwards is indistinguishable from a button that does nothing. It always ends the run, including one left stranded by a daemon that was replaced mid-flight.",
+    })
+        .input(WorkflowRunIdParamSchema)
+        .output(OkSchema),
+    archiveRun: oc
+        .route({
+        method: "POST",
+        path: "/workflows/runs/{runId}/archive",
+        summary: "Take a finished run off the board",
+        description: "Nothing is lost and the working copies are reclaimed. Every conversation the run started is put away with it, which is what makes this an archive rather than a dismissal: a step has no card of its own, so merely dropping the run would spill its conversations onto the board at the moment somebody said they were done. Refused while the run is still going.",
+    })
+        .input(WorkflowRunIdParamSchema)
+        .output(OkSchema),
+    unarchiveRun: oc
+        .route({
+        method: "POST",
+        path: "/workflows/runs/{runId}/unarchive",
+        summary: "Bring an archived run back",
+        description: "Puts a run and every conversation it started back on the board.",
+    })
+        .input(WorkflowRunIdParamSchema)
+        .output(OkSchema),
 };
 //# sourceMappingURL=workflows.contract.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"workflows.contract.js","sourceRoot":"","sources":["../../src/contracts/workflows.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EACH,QAAQ,EACR,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,GACtB,MAAM,eAAe,CAAC;AAcvB,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAG7B,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC;IAMjF,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;IAGvG,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAM7G,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;IAGtH,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC;IAczF,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAa5H,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAGlI,YAAY,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mCAAmC,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CACzI,CAAC"}
+{"version":3,"file":"workflows.contract.js","sourceRoot":"","sources":["../../src/contracts/workflows.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EACH,QAAQ,EACR,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,GACtB,MAAM,eAAe,CAAC;AAcvB,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAG7B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,gCAAgC;QACzC,WAAW,EACP,0MAA0M;KACjN,CAAC;SACD,MAAM,CAAC,mBAAmB,CAAC;IAMhC,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,8BAA8B;QACvC,WAAW,EACP,+UAA+U;KACtV,CAAC;SACD,KAAK,CAAC,kBAAkB,CAAC;SACzB,MAAM,CAAC,cAAc,CAAC;IAG3B,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,mBAAmB;QAC5B,WAAW,EACP,oKAAoK;KAC3K,CAAC;SACD,KAAK,CAAC,qBAAqB,CAAC;SAC5B,MAAM,CAAC,QAAQ,CAAC;IAMrB,GAAG,EAAE,EAAE;SACF,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EACP,iWAAiW;KACxW,CAAC;SACD,KAAK,CAAC,sBAAsB,CAAC;SAC7B,MAAM,CAAC,iBAAiB,CAAC;IAG9B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,oBAAoB;QAC7B,WAAW,EACP,8HAA8H;KACrI,CAAC;SACD,MAAM,CAAC,sBAAsB,CAAC;IAcnC,OAAO,EAAE,EAAE;SACN,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,8BAA8B;QACpC,OAAO,EAAE,gBAAgB;QACzB,WAAW,EACP,8aAA8a;KACrb,CAAC;SACD,KAAK,CAAC,wBAAwB,CAAC;SAC/B,MAAM,CAAC,QAAQ,CAAC;IAarB,UAAU,EAAE,EAAE;SACT,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iCAAiC;QACvC,OAAO,EAAE,mCAAmC;QAC5C,WAAW,EACP,qWAAqW;KAC5W,CAAC;SACD,KAAK,CAAC,wBAAwB,CAAC;SAC/B,MAAM,CAAC,QAAQ,CAAC;IAGrB,YAAY,EAAE,EAAE;SACX,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,mCAAmC;QACzC,OAAO,EAAE,4BAA4B;QACrC,WAAW,EAAE,iEAAiE;KACjF,CAAC;SACD,KAAK,CAAC,wBAAwB,CAAC;SAC/B,MAAM,CAAC,QAAQ,CAAC;CACxB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"workspace.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/workspace.contract.ts"],"names":[],"mappings":"AAyCA,eAAO,MAAM,iBAAiB;IAI1B,IAAI;;;;;;;IAGJ,QAAQ;;;;;;;IAGR,IAAI;;;;;;;;;;;;;;;;;IAKJ,WAAW;;;;;;;IAOX,OAAO;;;;;;IAGP,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIN,QAAQ;;;;;;;;;;;;;IAIR,KAAK;;;;;IACL,MAAM;;;;;IACN,IAAI;;;;;;IACJ,IAAI;;;;;;IAKJ,KAAK;;;;;;;;;;;;;;;;;;;;IACL,OAAO;;;;;IACP,KAAK;;;IACL,OAAO;;;;;;;;IAGP,IAAI;;;;;;;;;;;;;;;;;;IAGJ,SAAS;;;;;;;IAMT,OAAO;;;;;;;;;IACP,QAAQ;;;;;;;;;;;IAGR,YAAY;;;;;;;;;;;;;;;;;;IAIZ,OAAO;;;;;;;;;IACP,QAAQ;;;;;;IACR,OAAO;;;;;;IAIP,QAAQ;;;;;;;CACX,CAAC"}
+{"version":3,"file":"workspace.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/workspace.contract.ts"],"names":[],"mappings":"AAyCA,eAAO,MAAM,iBAAiB;IAI1B,IAAI;;;;;;;IAYJ,QAAQ;;;;;;;IAYR,IAAI;;;;;;;;;;;;;;;;;IAcJ,WAAW;;;;;;;IAaX,OAAO;;;;;;IAYP,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaN,QAAQ;;;;;;;;;;;;;IAYR,KAAK;;;;;IASL,MAAM;;;;;IAUN,IAAI;;;;;;IASJ,IAAI;;;;;;IAaJ,KAAK;;;;;;;;;;;;;;;;;;;;IASL,OAAO;;;;;IAUP,KAAK;;;IAQL,OAAO;;;;;;;;IAWP,IAAI;;;;;;;;;;;;;;;;;;IAWJ,SAAS;;;;;;;IAaT,OAAO;;;;;;;;;IAUP,QAAQ;;;;;;;;;;;IAWR,YAAY;;;;;;;;;;;;;;;;;;IAYZ,OAAO;;;;;;;;;IASP,QAAQ;;;;;;IASR,OAAO;;;;;;IAYP,QAAQ;;;;;;;CAUX,CAAC"}

package/dist/contracts/workspace.contract.js

@@ -1,33 +1,224 @@
 import { oc } from "@orpc/contract";
 import { AddAppsSchema, AppParamSchema, AppsListSchema, CloneRepoSchema, CloneResultSchema, WorkspaceSearchResultSchema, WorkspaceSearchQuerySchema, OkSchema, RepoAppsParamSchema, ReposListSchema, RunTestsSchema, TemplatesListSchema, WorkspaceChildrenQuerySchema, WorkspaceChildrenSchema, WorkspaceClassificationSchema, WorkspaceDirSchema, WorkspaceFileQuerySchema, WorkspaceFileReadQuerySchema, WorkspaceFileSchema, WorkspaceGraphSchema, WorkspaceHealthQuerySchema, WorkspaceHealthSchema, WorkspaceInstallResultSchema, WorkspaceInstallSchema, WorkspaceMediaTicketQuerySchema, WorkspaceMediaTicketSchema, WorkspaceModulesSchema, WorkspaceMoveSchema, WorkspaceResolveQuerySchema, WorkspaceResolveSchema, WorkspaceScopeSchema, WorkspaceSetupSchema, WorkspaceSyncSchema, WorkspaceTreeSchema, } from "../schemas.js";
 export const workspaceContract = {
-    tree: oc.route({ method: "GET", path: "/workspace/tree" }).input(WorkspaceScopeSchema).output(WorkspaceTreeSchema),
-    children: oc.route({ method: "GET", path: "/workspace/children" }).input(WorkspaceChildrenQuerySchema).output(WorkspaceChildrenSchema),
-    file: oc.route({ method: "GET", path: "/workspace/file" }).input(WorkspaceFileReadQuerySchema).output(WorkspaceFileSchema),
+    tree: oc
+        .route({
+        method: "GET",
+        path: "/workspace/tree",
+        summary: "The workspace file tree",
+        description: "Every folder and file under the workspace root, as one walk. Name a conversation to read its own private copy of the tree instead of the shared one. Folders the daemon skips, such as installed packages, come back without their contents; ask for those separately.",
+    })
+        .input(WorkspaceScopeSchema)
+        .output(WorkspaceTreeSchema),
+    children: oc
+        .route({
+        method: "GET",
+        path: "/workspace/children",
+        summary: "One folder's contents",
+        description: "The entries directly inside a single folder. This is how you open a folder the full tree walk deliberately left closed, such as an installed-packages directory with a hundred thousand files in it.",
+    })
+        .input(WorkspaceChildrenQuerySchema)
+        .output(WorkspaceChildrenSchema),
+    file: oc
+        .route({
+        method: "GET",
+        path: "/workspace/file",
+        summary: "Read part of a text file",
+        description: "A window of one file's text, plus how large the whole file is. Never the entire file: an unbounded read is how a single enormous log stalls the daemon for everyone, so ask for the slice you mean to show and page through if you need more.",
+    })
+        .input(WorkspaceFileReadQuerySchema)
+        .output(WorkspaceFileSchema),
     mediaTicket: oc
-        .route({ method: "POST", path: "/workspace/media-ticket" })
+        .route({
+        method: "POST",
+        path: "/workspace/media-ticket",
+        summary: "Get a pass for streaming a media file",
+        description: "Mints the short-lived ticket a video or audio element hands to the streaming route, which serves byte ranges and so cannot carry an ordinary header. Minting it here means a caller can tell whether this sandbox streams media at all, rather than discovering it mid-playback.",
+    })
         .input(WorkspaceMediaTicketQuerySchema)
         .output(WorkspaceMediaTicketSchema),
-    resolve: oc.route({ method: "GET", path: "/workspace/resolve" }).input(WorkspaceResolveQuerySchema).output(WorkspaceResolveSchema),
-    search: oc.route({ method: "GET", path: "/workspace/search" }).input(WorkspaceSearchQuerySchema).output(WorkspaceSearchResultSchema),
-    health: oc.route({ method: "GET", path: "/workspace/health" }).input(WorkspaceHealthQuerySchema).output(WorkspaceHealthSchema),
-    classify: oc.route({ method: "GET", path: "/workspace/classify" }).output(WorkspaceClassificationSchema),
-    mkdir: oc.route({ method: "POST", path: "/workspace/dir" }).input(WorkspaceDirSchema).output(OkSchema),
-    delete: oc.route({ method: "DELETE", path: "/workspace/entry" }).input(WorkspaceFileQuerySchema).output(OkSchema),
-    move: oc.route({ method: "POST", path: "/workspace/move" }).input(WorkspaceMoveSchema).output(OkSchema),
-    copy: oc.route({ method: "POST", path: "/workspace/copy" }).input(WorkspaceMoveSchema).output(OkSchema),
-    setup: oc.route({ method: "GET", path: "/workspace/setup" }).output(WorkspaceSetupSchema),
-    install: oc.route({ method: "POST", path: "/workspace/setup/install" }).input(WorkspaceInstallSchema).output(WorkspaceInstallResultSchema),
-    repos: oc.route({ method: "GET", path: "/workspace/repos" }).output(ReposListSchema),
-    addRepo: oc.route({ method: "POST", path: "/workspace/repos" }).input(CloneRepoSchema).output(CloneResultSchema),
-    sync: oc.route({ method: "POST", path: "/workspace/sync" }).output(WorkspaceSyncSchema),
-    templates: oc.route({ method: "GET", path: "/workspace/templates" }).output(TemplatesListSchema),
-    addApps: oc.route({ method: "POST", path: "/workspace/repos/{repo}/apps" }).input(AddAppsSchema).output(OkSchema),
-    appsList: oc.route({ method: "GET", path: "/workspace/repos/{repo}/apps" }).input(RepoAppsParamSchema).output(AppsListSchema),
-    packageGraph: oc.route({ method: "GET", path: "/workspace/repos/{repo}/graph" }).input(RepoAppsParamSchema).output(WorkspaceGraphSchema),
-    modules: oc.route({ method: "GET", path: "/workspace/modules" }).output(WorkspaceModulesSchema),
-    startApp: oc.route({ method: "POST", path: "/workspace/repos/{repo}/apps/{app}/start" }).input(AppParamSchema).output(OkSchema),
-    stopApp: oc.route({ method: "POST", path: "/workspace/repos/{repo}/apps/{app}/stop" }).input(AppParamSchema).output(OkSchema),
-    runTests: oc.route({ method: "POST", path: "/workspace/repos/{repo}/tests" }).input(RunTestsSchema).output(OkSchema),
+    resolve: oc
+        .route({
+        method: "GET",
+        path: "/workspace/resolve",
+        summary: "Turn a written path into a real file",
+        description: "Matches a path somebody wrote in prose against the real tree and says which file it means. A path mentioned in a message is often only the tail of the real one, so this is the lookup behind every clickable file reference rather than a plain existence check.",
+    })
+        .input(WorkspaceResolveQuerySchema)
+        .output(WorkspaceResolveSchema),
+    search: oc
+        .route({
+        method: "GET",
+        path: "/workspace/search",
+        summary: "Search the code",
+        description: "Ranked results across the whole workspace, grouped, each carrying why it matched and how fresh it is. Left alone it blends plain text, structure, meaning and history in one pass; narrow it to a single kind of search when you already know which you want. Long result sets resume from the cursor it hands back.",
+    })
+        .input(WorkspaceSearchQuerySchema)
+        .output(WorkspaceSearchResultSchema),
+    health: oc
+        .route({
+        method: "GET",
+        path: "/workspace/health",
+        summary: "A repo's shape in numbers",
+        description: "Where one repo's risk sits: the files that change often and are complicated at once, what the index holds, and which modules the rest of the code leans on most. Scoped to a repo, because a codebase is a repo rather than the whole drop.",
+    })
+        .input(WorkspaceHealthQuerySchema)
+        .output(WorkspaceHealthSchema),
+    classify: oc
+        .route({
+        method: "GET",
+        path: "/workspace/classify",
+        summary: "Sort a messy drop into buckets",
+        description: "Proposes which of the loose things in the workspace are code, documents, media or archives. A read-only suggestion by fixed rules, with no model involved: nothing moves until a caller applies the moves it likes through the move call.",
+    })
+        .output(WorkspaceClassificationSchema),
+    mkdir: oc
+        .route({
+        method: "POST",
+        path: "/workspace/dir",
+        summary: "Create a folder",
+        description: "Makes a folder, and any missing folders above it.",
+    })
+        .input(WorkspaceDirSchema)
+        .output(OkSchema),
+    delete: oc
+        .route({
+        method: "DELETE",
+        path: "/workspace/entry",
+        summary: "Delete a file or folder",
+        description: "Removes one entry and everything under it. The path travels in the body rather than the address, the same as every other write in this group.",
+    })
+        .input(WorkspaceFileQuerySchema)
+        .output(OkSchema),
+    move: oc
+        .route({
+        method: "POST",
+        path: "/workspace/move",
+        summary: "Move or rename something",
+        description: "Moves one entry to a new path, which is also how you rename it.",
+    })
+        .input(WorkspaceMoveSchema)
+        .output(OkSchema),
+    copy: oc
+        .route({
+        method: "POST",
+        path: "/workspace/copy",
+        summary: "Copy a file or folder",
+        description: "Duplicates one entry at a new path, recursively for a folder.",
+    })
+        .input(WorkspaceMoveSchema)
+        .output(OkSchema),
+    setup: oc
+        .route({
+        method: "GET",
+        path: "/workspace/setup",
+        summary: "Which projects have their dependencies installed",
+        description: "Per project, whether its dependencies are actually present. A project that arrives by import comes without them, so files landing is not the same as the project working: until this says a project is ready, its type checks and tests can only mislead you.",
+    })
+        .output(WorkspaceSetupSchema),
+    install: oc
+        .route({
+        method: "POST",
+        path: "/workspace/setup/install",
+        summary: "Install a project's dependencies",
+        description: "Starts the install for one or more projects in a terminal you can attach to, and answers immediately. The run survives a page reload and its output stays in the terminal history.",
+    })
+        .input(WorkspaceInstallSchema)
+        .output(WorkspaceInstallResultSchema),
+    repos: oc
+        .route({
+        method: "GET",
+        path: "/workspace/repos",
+        summary: "Repos in the workspace",
+        description: "Every git repo the daemon found in the workspace, with where each one sits and what it is called.",
+    })
+        .output(ReposListSchema),
+    addRepo: oc
+        .route({
+        method: "POST",
+        path: "/workspace/repos",
+        summary: "Clone a repo in",
+        description: "Clones a repository into the workspace beside the others, using whatever forge credentials the sandbox already holds.",
+    })
+        .input(CloneRepoSchema)
+        .output(CloneResultSchema),
+    sync: oc
+        .route({
+        method: "POST",
+        path: "/workspace/sync",
+        summary: "Pull every repo up to date",
+        description: "Fetches every repo that has a remote and fast-forwards the ones that can move safely, reporting what happened to each. This runs by itself at the start of a turn; call it directly to refresh on demand, or to re-sync a repo that had drifted.",
+    })
+        .output(WorkspaceSyncSchema),
+    templates: oc
+        .route({
+        method: "GET",
+        path: "/workspace/templates",
+        summary: "App templates you can add",
+        description: "The kinds of app the configured source repo knows how to scaffold, which is what an add-app picker lists.",
+    })
+        .output(TemplatesListSchema),
+    addApps: oc
+        .route({
+        method: "POST",
+        path: "/workspace/repos/{repo}/apps",
+        summary: "Scaffold new apps into a repo",
+        description: "Starts scaffolding one or more apps inside an existing multi-package repo and answers straight away. Watch the terminal it opens for progress and for anything that goes wrong.",
+    })
+        .input(AddAppsSchema)
+        .output(OkSchema),
+    appsList: oc
+        .route({
+        method: "GET",
+        path: "/workspace/repos/{repo}/apps",
+        summary: "Apps inside a repo",
+        description: "The apps in one multi-package repo, each with its preview address and whether its dev server is up.",
+    })
+        .input(RepoAppsParamSchema)
+        .output(AppsListSchema),
+    packageGraph: oc
+        .route({
+        method: "GET",
+        path: "/workspace/repos/{repo}/graph",
+        summary: "How a repo's packages depend on each other",
+        description: "Every package in one multi-package repo and which of its siblings each one uses, which is what a dependency view draws.",
+    })
+        .input(RepoAppsParamSchema)
+        .output(WorkspaceGraphSchema),
+    modules: oc
+        .route({
+        method: "GET",
+        path: "/workspace/modules",
+        summary: "Every package across every repo",
+        description: "The named packages in the whole workspace, which is what a review list groups changed files under when a reader wants packages rather than paths. Whole-workspace in one answer, because a review spans repos and asking per repo would be a fan-out on every open.",
+    })
+        .output(WorkspaceModulesSchema),
+    startApp: oc
+        .route({
+        method: "POST",
+        path: "/workspace/repos/{repo}/apps/{app}/start",
+        summary: "Start an app's dev server",
+        description: "Brings up one app's preview server in an attachable terminal, so its address starts answering.",
+    })
+        .input(AppParamSchema)
+        .output(OkSchema),
+    stopApp: oc
+        .route({
+        method: "POST",
+        path: "/workspace/repos/{repo}/apps/{app}/stop",
+        summary: "Stop an app's dev server",
+        description: "Shuts one app's preview server down and frees its port.",
+    })
+        .input(AppParamSchema)
+        .output(OkSchema),
+    runTests: oc
+        .route({
+        method: "POST",
+        path: "/workspace/repos/{repo}/tests",
+        summary: "Run a project's tests",
+        description: "Starts the test run for the projects you name in an attachable terminal and answers straight away. The terminal is where the results appear.",
+    })
+        .input(RunTestsSchema)
+        .output(OkSchema),
 };
 //# sourceMappingURL=workspace.contract.js.map

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

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