@intentic/sandbox-contract 1.225.0 → 1.226.1

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.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"}

package/dist/contracts/push.contract.js

@@ -1,9 +1,40 @@
 import { oc } from "@orpc/contract";
 import { OkSchema, PushChannelIdSchema, PushChannelSchema, PushConfigQuerySchema, PushConfigSchema, PushTestSchema } from "../schemas.js";
 export const pushContract = {
-    config: oc.route({ method: "GET", path: "/push/config" }).input(PushConfigQuerySchema).output(PushConfigSchema),
-    subscribe: oc.route({ method: "POST", path: "/push/subscribe" }).input(PushChannelSchema).output(OkSchema),
-    unsubscribe: oc.route({ method: "POST", path: "/push/unsubscribe" }).input(PushChannelIdSchema).output(OkSchema),
-    test: oc.route({ method: "POST", path: "/push/test" }).output(PushTestSchema),
+    config: oc
+        .route({
+        method: "GET",
+        path: "/push/config",
+        summary: "What a device needs to subscribe",
+        description: "The public key and settings a browser or app needs before it can register for notifications from this sandbox.",
+    })
+        .input(PushConfigQuerySchema)
+        .output(PushConfigSchema),
+    subscribe: oc
+        .route({
+        method: "POST",
+        path: "/push/subscribe",
+        summary: "Send notifications to this device",
+        description: "Registers one device. The sandbox only interrupts you on the three moments where attention is genuinely wanted: a turn has finished, the agent is stuck on a question, and something is waiting for approval.",
+    })
+        .input(PushChannelSchema)
+        .output(OkSchema),
+    unsubscribe: oc
+        .route({
+        method: "POST",
+        path: "/push/unsubscribe",
+        summary: "Stop notifying a device",
+        description: "Removes one registered device. Others keep receiving.",
+    })
+        .input(PushChannelIdSchema)
+        .output(OkSchema),
+    test: oc
+        .route({
+        method: "POST",
+        path: "/push/test",
+        summary: "Send a test notification",
+        description: "Proves the whole chain end to end. Worth having, because there are four separate places a notification can be lost that nobody can inspect from the outside: the device's permission, its registration, the sandbox's key, and the delivery service.",
+    })
+        .output(PushTestSchema),
 };
 //# sourceMappingURL=push.contract.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"push.contract.js","sourceRoot":"","sources":["../../src/contracts/push.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAW1I,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAC/G,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC1G,WAAW,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAChH,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;CAChF,CAAC"}
+{"version":3,"file":"push.contract.js","sourceRoot":"","sources":["../../src/contracts/push.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAW1I,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EAAE,gHAAgH;KAChI,CAAC;SACD,KAAK,CAAC,qBAAqB,CAAC;SAC5B,MAAM,CAAC,gBAAgB,CAAC;IAC7B,SAAS,EAAE,EAAE;SACR,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,mCAAmC;QAC5C,WAAW,EACP,+MAA+M;KACtN,CAAC;SACD,KAAK,CAAC,iBAAiB,CAAC;SACxB,MAAM,CAAC,QAAQ,CAAC;IACrB,WAAW,EAAE,EAAE;SACV,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,yBAAyB;QAClC,WAAW,EAAE,uDAAuD;KACvE,CAAC;SACD,KAAK,CAAC,mBAAmB,CAAC;SAC1B,MAAM,CAAC,QAAQ,CAAC;IACrB,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,0BAA0B;QACnC,WAAW,EACP,sPAAsP;KAC7P,CAAC;SACD,MAAM,CAAC,cAAc,CAAC;CAC9B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"secrets.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/secrets.contract.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,eAAe;IACxB,GAAG;;;;;;IACH,IAAI;;;IACJ,MAAM;;;;;IACN,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACT,MAAM;;;;;CACT,CAAC"}
+{"version":3,"file":"secrets.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/secrets.contract.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,eAAe;IACxB,GAAG;;;;;;IAUH,IAAI;;;IAQJ,MAAM;;;;;IASN,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAST,MAAM;;;;;CAUT,CAAC"}

package/dist/contracts/secrets.contract.js

@@ -1,10 +1,48 @@
 import { oc } from "@orpc/contract";
 import { OkSchema, SecretInventorySchema, SecretKeyParamSchema, SecretKeysSchema, SecretRevealSchema, SecretSetSchema } from "../schemas.js";
 export const secretsContract = {
-    set: oc.route({ method: "POST", path: "/secrets" }).input(SecretSetSchema).output(OkSchema),
-    list: oc.route({ method: "GET", path: "/secrets" }).output(SecretKeysSchema),
-    remove: oc.route({ method: "DELETE", path: "/secrets/{key}" }).input(SecretKeyParamSchema).output(OkSchema),
-    inventory: oc.route({ method: "GET", path: "/secrets/inventory" }).output(SecretInventorySchema),
-    reveal: oc.route({ method: "POST", path: "/secrets/reveal" }).input(SecretKeyParamSchema).output(SecretRevealSchema),
+    set: oc
+        .route({
+        method: "POST",
+        path: "/secrets",
+        summary: "Store a secret",
+        description: "Writes one name and value into the sandbox's own store, where running processes pick it up without a restart. Refused until the sandbox has somewhere to keep them.",
+    })
+        .input(SecretSetSchema)
+        .output(OkSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/secrets",
+        summary: "Names of the stored secrets",
+        description: "Which secrets exist here. Names only, never values.",
+    })
+        .output(SecretKeysSchema),
+    remove: oc
+        .route({
+        method: "DELETE",
+        path: "/secrets/{key}",
+        summary: "Delete a secret",
+        description: "Removes one by name.",
+    })
+        .input(SecretKeyParamSchema)
+        .output(OkSchema),
+    inventory: oc
+        .route({
+        method: "GET",
+        path: "/secrets/inventory",
+        summary: "Every secret this sandbox holds, from everywhere",
+        description: "One view across all the places secrets live here: what exists, where it came from and whether it is working. Never any values. This one always answers, even before there is a store to write to.",
+    })
+        .output(SecretInventorySchema),
+    reveal: oc
+        .route({
+        method: "POST",
+        path: "/secrets/reveal",
+        summary: "Show one secret's value",
+        description: "The only call that hands a value back, and it is for the owner alone. Sent as a body rather than in the address, so the name never ends up in a log or a browser's history.",
+    })
+        .input(SecretKeyParamSchema)
+        .output(SecretRevealSchema),
 };
 //# sourceMappingURL=secrets.contract.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"secrets.contract.js","sourceRoot":"","sources":["../../src/contracts/secrets.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAO7I,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC3F,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAC5E,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;IAC3G,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC;IAChG,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC;CACvH,CAAC"}
+{"version":3,"file":"secrets.contract.js","sourceRoot":"","sources":["../../src/contracts/secrets.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAO7I,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,GAAG,EAAE,EAAE;SACF,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,gBAAgB;QACzB,WAAW,EACP,qKAAqK;KAC5K,CAAC;SACD,KAAK,CAAC,eAAe,CAAC;SACtB,MAAM,CAAC,QAAQ,CAAC;IACrB,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,6BAA6B;QACtC,WAAW,EAAE,qDAAqD;KACrE,CAAC;SACD,MAAM,CAAC,gBAAgB,CAAC;IAC7B,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE,sBAAsB;KACtC,CAAC;SACD,KAAK,CAAC,oBAAoB,CAAC;SAC3B,MAAM,CAAC,QAAQ,CAAC;IACrB,SAAS,EAAE,EAAE;SACR,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,kDAAkD;QAC3D,WAAW,EACP,mMAAmM;KAC1M,CAAC;SACD,MAAM,CAAC,qBAAqB,CAAC;IAClC,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,yBAAyB;QAClC,WAAW,EACP,6KAA6K;KACpL,CAAC;SACD,KAAK,CAAC,oBAAoB,CAAC;SAC3B,MAAM,CAAC,kBAAkB,CAAC;CAClC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"sessions.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/sessions.contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,gBAAgB;IACzB,IAAI;;;;;;;;;;;;;;;;;IAIJ,GAAG;;;;;;;;;;;;;;;;;;;;;;CACN,CAAC"}
+{"version":3,"file":"sessions.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/sessions.contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,gBAAgB;IACzB,IAAI;;;;;;;;;;;;;;;;;IAUJ,GAAG;;;;;;;;;;;;;;;;;;;;;;CASN,CAAC"}

package/dist/contracts/sessions.contract.js

@@ -4,9 +4,22 @@ import { SessionTranscriptSchema } from "../events.js";
 import { SessionIdParamSchema, SessionsListSchema } from "../schemas.js";
 export const sessionsContract = {
     list: oc
-        .route({ method: "GET", path: "/sessions" })
+        .route({
+        method: "GET",
+        path: "/sessions",
+        summary: "Past conversations in this workspace",
+        description: "Summaries for a history menu, filtered when you pass a search. Covers conversations that worked in their own private copies too, so nothing is hidden just because it happened on a branch.",
+    })
         .input(z.object({ query: z.string().optional(), caseSensitive: z.stringbool().optional() }))
         .output(SessionsListSchema),
-    get: oc.route({ method: "GET", path: "/sessions/{id}" }).input(SessionIdParamSchema).output(SessionTranscriptSchema),
+    get: oc
+        .route({
+        method: "GET",
+        path: "/sessions/{id}",
+        summary: "Read one past conversation",
+        description: "The full record of a single conversation, restored for display.",
+    })
+        .input(SessionIdParamSchema)
+        .output(SessionTranscriptSchema),
 };
 //# sourceMappingURL=sessions.contract.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"sessions.contract.js","sourceRoot":"","sources":["../../src/contracts/sessions.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAUzE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;SAC3C,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;SAC3F,MAAM,CAAC,kBAAkB,CAAC;IAC/B,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,uBAAuB,CAAC;CACvH,CAAC"}
+{"version":3,"file":"sessions.contract.js","sourceRoot":"","sources":["../../src/contracts/sessions.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAUzE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,sCAAsC;QAC/C,WAAW,EACP,6LAA6L;KACpM,CAAC;SACD,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;SAC3F,MAAM,CAAC,kBAAkB,CAAC;IAC/B,GAAG,EAAE,EAAE;SACF,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,4BAA4B;QACrC,WAAW,EAAE,iEAAiE;KACjF,CAAC;SACD,KAAK,CAAC,oBAAoB,CAAC;SAC3B,MAAM,CAAC,uBAAuB,CAAC;CACvC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"settings.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/settings.contract.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,gBAAgB;IACzB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACH,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACP,aAAa;;;;;;;;;IAIb,OAAO;CACV,CAAC"}
+{"version":3,"file":"settings.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/settings.contract.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,gBAAgB;IACzB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQH,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUP,aAAa;;;;;;;;;IAab,OAAO;CASV,CAAC"}

package/dist/contracts/settings.contract.js

@@ -1,10 +1,48 @@
 import { oc } from "@orpc/contract";
 import { BuiltinPromptSchema, BuiltinPromptTextSchema, DayWindowQuerySchema, OkSchema, RuleFiringsSchema, SandboxSettingsSchema, SavingsReportSchema, } from "../schemas.js";
 export const settingsContract = {
-    get: oc.route({ method: "GET", path: "/settings" }).output(SandboxSettingsSchema),
-    set: oc.route({ method: "POST", path: "/settings" }).input(SandboxSettingsSchema).output(OkSchema),
-    savings: oc.route({ method: "GET", path: "/settings/savings" }).input(DayWindowQuerySchema).output(SavingsReportSchema),
-    builtinPrompt: oc.route({ method: "GET", path: "/settings/system-prompt/{base}" }).input(BuiltinPromptSchema).output(BuiltinPromptTextSchema),
-    firings: oc.route({ method: "GET", path: "/settings/rule-firings" }).output(RuleFiringsSchema),
+    get: oc
+        .route({
+        method: "GET",
+        path: "/settings",
+        summary: "How this sandbox is configured",
+        description: "Every setting that governs how agents behave here, with the defaults filled in for anything nobody has chosen.",
+    })
+        .output(SandboxSettingsSchema),
+    set: oc
+        .route({
+        method: "POST",
+        path: "/settings",
+        summary: "Change the sandbox settings",
+        description: "Writes the settings whole, so send the complete object rather than the fields you changed.",
+    })
+        .input(SandboxSettingsSchema)
+        .output(OkSchema),
+    savings: oc
+        .route({
+        method: "GET",
+        path: "/settings/savings",
+        summary: "What the token-saving measures were worth",
+        description: "Measured rather than estimated: what each mechanism actually saved over a range of days. The same day range the spending ledger takes, so one calendar filters both.",
+    })
+        .input(DayWindowQuerySchema)
+        .output(SavingsReportSchema),
+    builtinPrompt: oc
+        .route({
+        method: "GET",
+        path: "/settings/system-prompt/{base}",
+        summary: "Read a built-in system prompt",
+        description: "The actual text behind one of the built-in modes, so a settings screen can show the prompt instead of asking anyone to trust a description of it, and so either can be forked into a custom one.",
+    })
+        .input(BuiltinPromptSchema)
+        .output(BuiltinPromptTextSchema),
+    firings: oc
+        .route({
+        method: "GET",
+        path: "/settings/rule-firings",
+        summary: "When each rule last did something",
+        description: "A separate read rather than a field on the settings, because a rule firing is not somebody editing anything: folding it in would turn every firing into a settings write and put a self-changing value inside the object a screen edits.",
+    })
+        .output(RuleFiringsSchema),
 };
 //# sourceMappingURL=settings.contract.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"settings.contract.js","sourceRoot":"","sources":["../../src/contracts/settings.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EACH,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,QAAQ,EACR,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,eAAe,CAAC;AASvB,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC;IACjF,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAClG,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC;IACvH,aAAa,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gCAAgC,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,uBAAuB,CAAC;IAI7I,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;CACjG,CAAC"}
+{"version":3,"file":"settings.contract.js","sourceRoot":"","sources":["../../src/contracts/settings.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EACH,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,QAAQ,EACR,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,eAAe,CAAC;AASvB,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,GAAG,EAAE,EAAE;SACF,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,gCAAgC;QACzC,WAAW,EAAE,gHAAgH;KAChI,CAAC;SACD,MAAM,CAAC,qBAAqB,CAAC;IAClC,GAAG,EAAE,EAAE;SACF,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,6BAA6B;QACtC,WAAW,EAAE,4FAA4F;KAC5G,CAAC;SACD,KAAK,CAAC,qBAAqB,CAAC;SAC5B,MAAM,CAAC,QAAQ,CAAC;IACrB,OAAO,EAAE,EAAE;SACN,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,2CAA2C;QACpD,WAAW,EACP,sKAAsK;KAC7K,CAAC;SACD,KAAK,CAAC,oBAAoB,CAAC;SAC3B,MAAM,CAAC,mBAAmB,CAAC;IAChC,aAAa,EAAE,EAAE;SACZ,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,gCAAgC;QACtC,OAAO,EAAE,+BAA+B;QACxC,WAAW,EACP,kMAAkM;KACzM,CAAC;SACD,KAAK,CAAC,mBAAmB,CAAC;SAC1B,MAAM,CAAC,uBAAuB,CAAC;IAIpC,OAAO,EAAE,EAAE;SACN,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,mCAAmC;QAC5C,WAAW,EACP,0OAA0O;KACjP,CAAC;SACD,MAAM,CAAC,iBAAiB,CAAC;CACjC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"share.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/share.contract.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,aAAa;IACtB,IAAI;;;;;;;;;;;;;;IAEJ,MAAM;;;;;;;;;;;;;;;;;;;IAEN,MAAM;;;;;;;;;;;;;;IACN,MAAM;;;;;CACT,CAAC"}
+{"version":3,"file":"share.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/share.contract.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,aAAa;IACtB,IAAI;;;;;;;;;;;;;;IAUJ,MAAM;;;;;;;;;;;;;;;;;;;IAWN,MAAM;;;;;;;;;;;;;;IASN,MAAM;;;;;CAST,CAAC"}

package/dist/contracts/share.contract.js

@@ -1,9 +1,40 @@
 import { oc } from "@orpc/contract";
 import { OkSchema, ShareCreateSchema, ShareListSchema, ShareRemoveSchema, ShareUpdateSchema, SharedConversationSchema } from "../schemas.js";
 export const shareContract = {
-    list: oc.route({ method: "GET", path: "/share" }).output(ShareListSchema),
-    create: oc.route({ method: "POST", path: "/share" }).input(ShareCreateSchema).output(SharedConversationSchema),
-    update: oc.route({ method: "POST", path: "/share/update" }).input(ShareUpdateSchema).output(SharedConversationSchema),
-    remove: oc.route({ method: "POST", path: "/share/remove" }).input(ShareRemoveSchema).output(OkSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/share",
+        summary: "Conversations published as pages",
+        description: "Every conversation that has been turned into a read-only page, with its link. There is no call to read one back: the page itself is the read, and it answers to anyone who has the link.",
+    })
+        .output(ShareListSchema),
+    create: oc
+        .route({
+        method: "POST",
+        path: "/share",
+        summary: "Publish a conversation",
+        description: "Renders a conversation into a page anybody with the link can read, without signing in. Answers with the link, so nothing has to be listed again to find it.",
+    })
+        .input(ShareCreateSchema)
+        .output(SharedConversationSchema),
+    update: oc
+        .route({
+        method: "POST",
+        path: "/share/update",
+        summary: "Refresh a published page",
+        description: "Re-renders an existing page from the conversation as it stands now. Same link, newer contents.",
+    })
+        .input(ShareUpdateSchema)
+        .output(SharedConversationSchema),
+    remove: oc
+        .route({
+        method: "POST",
+        path: "/share/remove",
+        summary: "Unpublish a conversation",
+        description: "Takes the page down, so the link stops answering.",
+    })
+        .input(ShareRemoveSchema)
+        .output(OkSchema),
 };
 //# sourceMappingURL=share.contract.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"share.contract.js","sourceRoot":"","sources":["../../src/contracts/share.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAW7I,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;IAEzE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC;IAE9G,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC;IACrH,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CACxG,CAAC"}
+{"version":3,"file":"share.contract.js","sourceRoot":"","sources":["../../src/contracts/share.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAW7I,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EACP,0LAA0L;KACjM,CAAC;SACD,MAAM,CAAC,eAAe,CAAC;IAE5B,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,wBAAwB;QACjC,WAAW,EACP,6JAA6J;KACpK,CAAC;SACD,KAAK,CAAC,iBAAiB,CAAC;SACxB,MAAM,CAAC,wBAAwB,CAAC;IAErC,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,0BAA0B;QACnC,WAAW,EAAE,gGAAgG;KAChH,CAAC;SACD,KAAK,CAAC,iBAAiB,CAAC;SACxB,MAAM,CAAC,wBAAwB,CAAC;IACrC,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,0BAA0B;QACnC,WAAW,EAAE,mDAAmD;KACnE,CAAC;SACD,KAAK,CAAC,iBAAiB,CAAC;SACxB,MAAM,CAAC,QAAQ,CAAC;CACxB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"skills.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/skills.contract.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,cAAc;IACvB,IAAI;;;;;;;;;;;;;;;;;;;IACJ,IAAI;;;;;;;IAGJ,IAAI;;;;;;;IACJ,MAAM;;;;;CACT,CAAC"}
+{"version":3,"file":"skills.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/skills.contract.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,cAAc;IACvB,IAAI;;;;;;;;;;;;;;;;;;;IASJ,IAAI;;;;;;;IAYJ,IAAI;;;;;;;IAUJ,MAAM;;;;;CAUT,CAAC"}

package/dist/contracts/skills.contract.js

@@ -1,9 +1,40 @@
 import { oc } from "@orpc/contract";
 import { OkSchema, SkillBodySchema, SkillDraftSchema, SkillIdSchema, SkillRemoveSchema, SkillsListSchema } from "../schemas.js";
 export const skillsContract = {
-    list: oc.route({ method: "GET", path: "/skills" }).output(SkillsListSchema),
-    read: oc.route({ method: "GET", path: "/skills/read" }).input(SkillIdSchema).output(SkillBodySchema),
-    save: oc.route({ method: "POST", path: "/skills" }).input(SkillDraftSchema).output(OkSchema),
-    remove: oc.route({ method: "POST", path: "/skills/remove" }).input(SkillRemoveSchema).output(OkSchema),
+    list: oc
+        .route({
+        method: "GET",
+        path: "/skills",
+        summary: "What the agent knows how to do",
+        description: "Every skill available here and whether it is switched on, joined from all four places they come from: the owner's own, the settings, plugins a connection installed, and folders inside extensions.",
+    })
+        .output(SkillsListSchema),
+    read: oc
+        .route({
+        method: "GET",
+        path: "/skills/read",
+        summary: "Read one skill",
+        description: "The full text of a single skill. The name travels in the query rather than the address, because a name can carry the owner it came from and that will not fit in a path.",
+    })
+        .input(SkillIdSchema)
+        .output(SkillBodySchema),
+    save: oc
+        .route({
+        method: "POST",
+        path: "/skills",
+        summary: "Write a skill",
+        description: "Creates or rewrites a skill by name, and switches it on, because you wrote it in order to use it. Renaming is saving under the new name and deleting the old.",
+    })
+        .input(SkillDraftSchema)
+        .output(OkSchema),
+    remove: oc
+        .route({
+        method: "POST",
+        path: "/skills/remove",
+        summary: "Delete a skill",
+        description: "Removes the text and takes it off the enabled list in one step, so a screen never has to sequence two calls and never leaves one half done.",
+    })
+        .input(SkillRemoveSchema)
+        .output(OkSchema),
 };
 //# sourceMappingURL=skills.contract.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"skills.contract.js","sourceRoot":"","sources":["../../src/contracts/skills.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAehI,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,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC;IAGpG,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC5F,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CACzG,CAAC"}
+{"version":3,"file":"skills.contract.js","sourceRoot":"","sources":["../../src/contracts/skills.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAehI,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,gCAAgC;QACzC,WAAW,EACP,qMAAqM;KAC5M,CAAC;SACD,MAAM,CAAC,gBAAgB,CAAC;IAC7B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,gBAAgB;QACzB,WAAW,EACP,0KAA0K;KACjL,CAAC;SACD,KAAK,CAAC,aAAa,CAAC;SACpB,MAAM,CAAC,eAAe,CAAC;IAG5B,IAAI,EAAE,EAAE;SACH,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,eAAe;QACxB,WAAW,EACP,+JAA+J;KACtK,CAAC;SACD,KAAK,CAAC,gBAAgB,CAAC;SACvB,MAAM,CAAC,QAAQ,CAAC;IACrB,MAAM,EAAE,EAAE;SACL,KAAK,CAAC;QACH,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,gBAAgB;QACzB,WAAW,EACP,6IAA6I;KACpJ,CAAC;SACD,KAAK,CAAC,iBAAiB,CAAC;SACxB,MAAM,CAAC,QAAQ,CAAC;CACxB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"system.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/system.contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,eAAO,MAAM,cAAc;IACvB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;IAIJ,gBAAgB;;;;;;;;;;;;IAGhB,OAAO;;;;;IACP,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAKN,QAAQ;;;;;;;;;IAER,KAAK;;;;;;;;;;;;IAKL,SAAS;;;;;;;;;;;;;;;;;;;;;;;;IACT,YAAY;;;;;IAIZ,kBAAkB;;;;;;;;;IASlB,QAAQ;;;;;;;;;;;;;;;;;;;;;IACR,YAAY;;;;;IAQZ,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACT,kBAAkB;;;;;;;;;;;;;;;;;;;;;;IAWlB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIvB,CAAC"}
+{"version":3,"file":"system.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/system.contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,eAAO,MAAM,cAAc;IACvB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;IAYJ,gBAAgB;;;;;;;;;;;;IAWhB,OAAO;;;;;IASP,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWN,QAAQ;;;;;;;;;IAWR,KAAK;;;;;;;;;;;;IAYL,SAAS;;;;;;;;;;;;;;;;;;;;;;;;IAST,YAAY;;;;;IAYZ,kBAAkB;;;;;;;;;IAelB,QAAQ;;;;;;;;;;;;;;;;;;;;;IASR,YAAY;;;;;IAiBZ,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAST,kBAAkB;;;;;;;;;;;;;;;;;;;;;;IAiBlB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUvB,CAAC"}