apps 0.0.1-beta.91 → 0.0.1-beta.92

package/types/apps/src/contracts/app.d.ts

@@ -60,7 +60,7 @@ export type BoundAccounts<Slots extends AccountSlots> = {
 export interface InvocationServices {
     /** Explicit app/build-scoped caching. Account-specific loaders opt into forAccount. */
     readonly cache: import("./cache.js").AppCache;
-    /** Text files retained in this deployment. Paths are package-relative, never host filesystem paths. */
+    /** Text files retained in this version. Paths are package-relative, never host filesystem paths. */
     readonly files: readonly SkillFile[];
     /** Read-only run management, bound to this configured app. */
     readonly workflows: WorkflowReads;

package/types/apps/src/contracts/openapi-document.d.ts

@@ -1,4 +1,4 @@
-/** OpenAPI boundary parsing. Unsupported transport/auth features fail before deployment. */
+/** OpenAPI boundary parsing. Unsupported transport/auth features fail before deploying. */
 import { Schema } from "effect";
 /** Parsed OpenAPI 3 source; individual operation references are resolved separately. */
 export declare const Specification: Schema.Struct<{

package/types/apps/src/contracts/ui.d.ts

@@ -1,13 +1,12 @@
 /** Browser-to-host operations bind identity and authentication outside authored app code. */
 import { Schema, type Effect, type Stream } from "effect";
 import { HttpApi, HttpApiEndpoint, HttpApiGroup, HttpApiSchema } from "effect/http-api";
-/**
- * Non-secret page context injected by the serving host. `accounts` names the account IDs the page
- * runs with, by requirement, when the app has requirements.
- */
-export declare const UiContext: Schema.Struct<{
-    readonly deployment: Schema.NonEmptyString;
+import { withLegacyKeys } from "../../../utils/src/legacy-keys.js";
+export declare const UiContext: withLegacyKeys<Schema.Struct<{
+    readonly version: Schema.NonEmptyString;
     readonly accounts: Schema.optional<Schema.$Record<Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>>>;
+}>, {
+    readonly version: "deployment";
 }>;
 /** A problem with one of the page's accounts, from stored state. Labels are the owner's own names. */
 export type UiAccountProblem = {
@@ -36,7 +35,7 @@ export interface AppUiRange {
     readonly length: number;
 }
 /**
- * A public file the deployment's source served from `ui/public/`, which the host copied to its
+ * A public file the version's source served from `ui/public/`, which the host copied to its
  * own store. `etag` names its exact bytes. Hosts authorize access before reading it.
  */
 export interface AppUiStoredFile {
@@ -46,12 +45,14 @@ export interface AppUiStoredFile {
     readonly read: (range: AppUiRange | undefined) => Effect.Effect<Stream.Stream<Uint8Array, UiFailed>, UiFailed>;
 }
 export type AppUiAsset = AppUiFile | AppUiStoredFile;
-/** Requests name an operation on this app and the page's deployment, never another app or account. */
-export declare const UiOperation: Schema.Struct<{
+/** Requests name an operation on this app and the page's version, never another app or account. */
+export declare const UiOperation: withLegacyKeys<Schema.Struct<{
     readonly name: Schema.NonEmptyString;
     readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
-    readonly deployment: Schema.NonEmptyString;
+    readonly version: Schema.NonEmptyString;
     readonly accounts: Schema.optional<Schema.$Record<Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>>>;
+}>, {
+    readonly version: "deployment";
 }>;
 declare const UiUnauthorized_base: Schema.Class<UiUnauthorized, Schema.TaggedStruct<"UiUnauthorized", {}>, import("effect/Cause").YieldableError>;
 /** The app session is absent or its parent login was revoked. */
@@ -61,9 +62,12 @@ declare const UiForbidden_base: Schema.Class<UiForbidden, Schema.TaggedStruct<"U
 /** The request did not originate from the configured app. */
 export declare class UiForbidden extends UiForbidden_base {
 }
-declare const UiDeploymentChanged_base: Schema.Class<UiDeploymentChanged, Schema.TaggedStruct<"UiDeploymentChanged", {}>, import("effect/Cause").YieldableError>;
-/** The page should reload before starting another operation. */
-export declare class UiDeploymentChanged extends UiDeploymentChanged_base {
+declare const UiVersionChanged_base: Schema.Class<UiVersionChanged, Schema.TaggedStruct<"UiDeploymentChanged", {}>, import("effect/Cause").YieldableError>;
+/**
+ * The page should reload before starting another operation. The tag keeps its former name: pages
+ * built with earlier framework releases reload on it.
+ */
+export declare class UiVersionChanged extends UiVersionChanged_base {
 }
 declare const UiFailed_base: Schema.Class<UiFailed, Schema.TaggedStruct<"UiFailed", {
     readonly reason: Schema.Literals<readonly ["unavailable", "operation_failed", "account_required"]>;
@@ -83,21 +87,27 @@ export declare const UiSnapshot: Schema.Union<readonly [Schema.Struct<{
     readonly type: Schema.Literal<"heartbeat">;
 }>]>;
 /** Portable serving contract; the host authenticates and resolves the configured app. */
-export declare const AppUiApi: HttpApi.HttpApi<"app-ui", HttpApiGroup.HttpApiGroup<"ui", HttpApiEndpoint.HttpApiEndpoint<"query", "POST", "/_executor/api/query", never, never, Schema.toCodecJson<Schema.Struct<{
+export declare const AppUiApi: HttpApi.HttpApi<"app-ui", HttpApiGroup.HttpApiGroup<"ui", HttpApiEndpoint.HttpApiEndpoint<"query", "POST", "/_executor/api/query", never, never, Schema.toCodecJson<withLegacyKeys<Schema.Struct<{
     readonly name: Schema.NonEmptyString;
     readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
-    readonly deployment: Schema.NonEmptyString;
+    readonly version: Schema.NonEmptyString;
     readonly accounts: Schema.optional<Schema.$Record<Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>>>;
-}>>, never, Schema.toCodecJson<Schema.Codec<Schema.Json, Schema.Json, never, never>>, Schema.toCodecJson<typeof UiUnauthorized | typeof UiForbidden | typeof UiDeploymentChanged | typeof UiFailed>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"mutate", "POST", "/_executor/api/mutate", never, never, Schema.toCodecJson<Schema.Struct<{
+}>, {
+    readonly version: "deployment";
+}>>, never, Schema.toCodecJson<Schema.Codec<Schema.Json, Schema.Json, never, never>>, Schema.toCodecJson<typeof UiUnauthorized | typeof UiForbidden | typeof UiVersionChanged | typeof UiFailed>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"mutate", "POST", "/_executor/api/mutate", never, never, Schema.toCodecJson<withLegacyKeys<Schema.Struct<{
     readonly name: Schema.NonEmptyString;
     readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
-    readonly deployment: Schema.NonEmptyString;
+    readonly version: Schema.NonEmptyString;
     readonly accounts: Schema.optional<Schema.$Record<Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>>>;
-}>>, never, Schema.toCodecJson<Schema.Codec<Schema.Json, Schema.Json, never, never>>, Schema.toCodecJson<typeof UiUnauthorized | typeof UiForbidden | typeof UiDeploymentChanged | typeof UiFailed>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"subscribe", "POST", "/_executor/api/subscribe", never, never, Schema.toCodecJson<Schema.Struct<{
+}>, {
+    readonly version: "deployment";
+}>>, never, Schema.toCodecJson<Schema.Codec<Schema.Json, Schema.Json, never, never>>, Schema.toCodecJson<typeof UiUnauthorized | typeof UiForbidden | typeof UiVersionChanged | typeof UiFailed>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"subscribe", "POST", "/_executor/api/subscribe", never, never, Schema.toCodecJson<withLegacyKeys<Schema.Struct<{
     readonly name: Schema.NonEmptyString;
     readonly input: Schema.Codec<Schema.Json, Schema.Json, never, never>;
-    readonly deployment: Schema.NonEmptyString;
+    readonly version: Schema.NonEmptyString;
     readonly accounts: Schema.optional<Schema.$Record<Schema.NonEmptyString, Schema.$Array<Schema.NonEmptyString>>>;
+}>, {
+    readonly version: "deployment";
 }>>, never, HttpApiSchema.StreamSse<HttpApiSchema.SseEventFromData<Schema.Union<readonly [Schema.Struct<{
     readonly type: Schema.Literal<"snapshot">;
     readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
@@ -107,7 +117,7 @@ export declare const AppUiApi: HttpApi.HttpApi<"app-ui", HttpApiGroup.HttpApiGro
     readonly error: typeof UiFailed;
 }>, Schema.Struct<{
     readonly type: Schema.Literal<"heartbeat">;
-}>]>>, Schema.Union<readonly [typeof UiUnauthorized, typeof UiForbidden, typeof UiDeploymentChanged, typeof UiFailed]>, {
+}>]>>, Schema.Union<readonly [typeof UiUnauthorized, typeof UiForbidden, typeof UiVersionChanged, typeof UiFailed]>, {
     readonly value: Schema.Json;
     readonly type: "snapshot";
     readonly trace?: unknown;
@@ -116,5 +126,5 @@ export declare const AppUiApi: HttpApi.HttpApi<"app-ui", HttpApiGroup.HttpApiGro
     readonly error: UiFailed;
 } | {
     readonly type: "heartbeat";
-}>, Schema.toCodecJson<typeof UiUnauthorized | typeof UiForbidden | typeof UiDeploymentChanged | typeof UiFailed>, never, never>, false>>;
+}>, Schema.toCodecJson<typeof UiUnauthorized | typeof UiForbidden | typeof UiVersionChanged | typeof UiFailed>, never, never>, false>>;
 export {};

package/types/apps/src/contracts/workflows.d.ts

@@ -1,4 +1,5 @@
 /** Portable workflow declarations, run views and durable execution capabilities. */
+import { withLegacyKeys } from "../../../utils/src/legacy-keys.js";
 import { Schema, type Effect } from "effect";
 import { RecordedMessage } from "../../../utils/src/recorded-message.js";
 import { JsonValue } from "./schema.js";
@@ -71,23 +72,30 @@ export declare const HostedWorkflow: Schema.Struct<{
     readonly outputSchema: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
 }>;
 export type HostedWorkflow = typeof HostedWorkflow.Type;
-/** Results are available only on completed runs; failures carry a reason code and app error detail. */
-export declare const WorkflowRun: Schema.Union<readonly [Schema.Struct<{
+/**
+ * Results are available only on completed runs; failures carry a reason code and app error detail.
+ * Runs name their version under its former name too, for apps and callers written before the rename.
+ */
+export declare const WorkflowRun: Schema.Union<readonly [withLegacyKeys<Schema.Struct<{
     readonly status: Schema.Literals<readonly ["queued", "running", "waiting", "paused", "waitingForPause"]>;
     readonly id: Schema.brand<Schema.NonEmptyString, "wfr">;
     readonly app: Schema.NonEmptyString;
-    readonly deployment: Schema.NonEmptyString;
+    readonly version: Schema.NonEmptyString;
     readonly workflow: Schema.NonEmptyString;
     readonly createdAt: Schema.String;
-}>, Schema.Struct<{
+}>, {
+    readonly version: "deployment";
+}>, withLegacyKeys<Schema.Struct<{
     readonly status: Schema.Literal<"complete">;
     readonly output: Schema.Codec<Schema.Json, Schema.Json, never, never>;
     readonly id: Schema.brand<Schema.NonEmptyString, "wfr">;
     readonly app: Schema.NonEmptyString;
-    readonly deployment: Schema.NonEmptyString;
+    readonly version: Schema.NonEmptyString;
     readonly workflow: Schema.NonEmptyString;
     readonly createdAt: Schema.String;
-}>, Schema.Struct<{
+}>, {
+    readonly version: "deployment";
+}>, withLegacyKeys<Schema.Struct<{
     readonly status: Schema.Literal<"errored">;
     readonly error: Schema.Literals<readonly ["unavailable", "not_found", "input", "output", "operation", "approval", "credentials", "terminated", "execution", "conflict", "engine"]>;
     /** The failing step and the app's own error, when the run recorded them. */
@@ -98,36 +106,44 @@ export declare const WorkflowRun: Schema.Union<readonly [Schema.Struct<{
     }>>;
     readonly id: Schema.brand<Schema.NonEmptyString, "wfr">;
     readonly app: Schema.NonEmptyString;
-    readonly deployment: Schema.NonEmptyString;
+    readonly version: Schema.NonEmptyString;
     readonly workflow: Schema.NonEmptyString;
     readonly createdAt: Schema.String;
-}>, Schema.Struct<{
+}>, {
+    readonly version: "deployment";
+}>, withLegacyKeys<Schema.Struct<{
     readonly status: Schema.Literal<"terminated">;
     readonly id: Schema.brand<Schema.NonEmptyString, "wfr">;
     readonly app: Schema.NonEmptyString;
-    readonly deployment: Schema.NonEmptyString;
+    readonly version: Schema.NonEmptyString;
     readonly workflow: Schema.NonEmptyString;
     readonly createdAt: Schema.String;
+}>, {
+    readonly version: "deployment";
 }>]>;
 export type WorkflowRun = typeof WorkflowRun.Type;
 /** A bounded run-history page, already scoped to an authorized configured app. */
 export declare const WorkflowRunPage: Schema.Struct<{
-    readonly items: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Union<readonly [withLegacyKeys<Schema.Struct<{
         readonly status: Schema.Literals<readonly ["queued", "running", "waiting", "paused", "waitingForPause"]>;
         readonly id: Schema.brand<Schema.NonEmptyString, "wfr">;
         readonly app: Schema.NonEmptyString;
-        readonly deployment: Schema.NonEmptyString;
+        readonly version: Schema.NonEmptyString;
         readonly workflow: Schema.NonEmptyString;
         readonly createdAt: Schema.String;
-    }>, Schema.Struct<{
+    }>, {
+        readonly version: "deployment";
+    }>, withLegacyKeys<Schema.Struct<{
         readonly status: Schema.Literal<"complete">;
         readonly output: Schema.Codec<Schema.Json, Schema.Json, never, never>;
         readonly id: Schema.brand<Schema.NonEmptyString, "wfr">;
         readonly app: Schema.NonEmptyString;
-        readonly deployment: Schema.NonEmptyString;
+        readonly version: Schema.NonEmptyString;
         readonly workflow: Schema.NonEmptyString;
         readonly createdAt: Schema.String;
-    }>, Schema.Struct<{
+    }>, {
+        readonly version: "deployment";
+    }>, withLegacyKeys<Schema.Struct<{
         readonly status: Schema.Literal<"errored">;
         readonly error: Schema.Literals<readonly ["unavailable", "not_found", "input", "output", "operation", "approval", "credentials", "terminated", "execution", "conflict", "engine"]>;
         /** The failing step and the app's own error, when the run recorded them. */
@@ -138,16 +154,20 @@ export declare const WorkflowRunPage: Schema.Struct<{
         }>>;
         readonly id: Schema.brand<Schema.NonEmptyString, "wfr">;
         readonly app: Schema.NonEmptyString;
-        readonly deployment: Schema.NonEmptyString;
+        readonly version: Schema.NonEmptyString;
         readonly workflow: Schema.NonEmptyString;
         readonly createdAt: Schema.String;
-    }>, Schema.Struct<{
+    }>, {
+        readonly version: "deployment";
+    }>, withLegacyKeys<Schema.Struct<{
         readonly status: Schema.Literal<"terminated">;
         readonly id: Schema.brand<Schema.NonEmptyString, "wfr">;
         readonly app: Schema.NonEmptyString;
-        readonly deployment: Schema.NonEmptyString;
+        readonly version: Schema.NonEmptyString;
         readonly workflow: Schema.NonEmptyString;
         readonly createdAt: Schema.String;
+    }>, {
+        readonly version: "deployment";
     }>]>>;
     readonly next: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "wfr">>;
 }>;

package/types/apps/src/implementation/browser-scripts.gen.d.ts

@@ -1,5 +1,5 @@
 /** Compiled from src/browser/app-watch.ts. */
-export declare const appWatchSource = "\"use strict\";(()=>{var s=()=>{let i=document.getElementById(\"executor-context\")?.textContent;if(!i)return;let n=JSON.parse(i);if(typeof n!=\"object\"||n===null||!(\"deployment\"in n))return;let r=n.deployment;if(typeof r!=\"string\"||r.length===0)return;let t=new EventSource(\"/_executor/version\"),l=!1,o=()=>{l||(l=!0,t.close(),location.reload())};t.addEventListener(\"version\",d=>{let e=JSON.parse(d.data);typeof e==\"object\"&&e!==null&&\"deployment\"in e&&(e.deployment===null||typeof e.deployment==\"string\")&&e.deployment!==r&&o()}),t.addEventListener(\"revoked\",o),window.addEventListener(\"executor:deployment-changed\",o),window.addEventListener(\"pagehide\",()=>t.close(),{once:!0}),window.addEventListener(\"pageshow\",d=>{d.persisted&&o()})};s();})();";
+export declare const appWatchSource = "\"use strict\";(()=>{var c=()=>{let s=document.getElementById(\"executor-context\")?.textContent;if(!s)return;let n=JSON.parse(s);if(typeof n!=\"object\"||n===null||!(\"version\"in n))return;let r=n.version;if(typeof r!=\"string\"||r.length===0)return;let t=new EventSource(\"/_executor/version\"),d=!1,o=()=>{d||(d=!0,t.close(),location.reload())};t.addEventListener(\"version\",i=>{let e=JSON.parse(i.data);typeof e==\"object\"&&e!==null&&\"version\"in e&&(e.version===null||typeof e.version==\"string\")&&e.version!==r&&o()}),t.addEventListener(\"revoked\",o),window.addEventListener(\"executor:deployment-changed\",o),window.addEventListener(\"pagehide\",()=>t.close(),{once:!0}),window.addEventListener(\"pageshow\",i=>{i.persisted&&o()})};c();})();";
 /** Compiled from src/browser/app-failure.ts. */
 export declare const appFailureSource = "\"use strict\";(()=>{var M=()=>{let d,w=Date.now(),m=0,g=0,f=new Map,v=/^(?:chrome|moz|safari-web)-extension:/,A=new Set([\"ResizeObserver loop completed with undelivered notifications.\",\"ResizeObserver loop limit exceeded\"]),V=new Set([\"Error\",\"TypeError\",\"ReferenceError\",\"SyntaxError\",\"RangeError\",\"URIError\",\"EvalError\",\"AggregateError\"]),b=(e,t=0,i=0)=>{let r=[];if(!URL.canParse(e))return r;let a=new URL(e);return a.origin!==location.origin||!a.pathname.startsWith(\"/_executor/assets/\")||!a.pathname.endsWith(\".js\")||(r.push({key:\"code.file.path\",value:{stringValue:a.pathname}}),Number.isSafeInteger(t)&&t>0&&r.push({key:\"code.line.number\",value:{intValue:String(t)}}),Number.isSafeInteger(i)&&i>0&&r.push({key:\"code.column.number\",value:{intValue:String(i)}})),r},h=(e,t,i=[])=>{let r=Date.now();r-w>=6e4&&(w=r,m=0,f.clear());let a=`${e}:${t.slice(0,2e3)}`,x=f.get(a);if(x!==void 0&&r-x<1e3||m>=20){g++;return}f.set(a,r),m++,i.push({key:\"executor.ui.failure.suppressed\",value:{intValue:String(g)}}),g=0;let E=Array.from(crypto.getRandomValues(new Uint8Array(16)),s=>s.toString(16).padStart(2,\"0\")).join(\"\"),S=`${Date.now()}000000`,n,l=\"Sending error report\\u2026\",k=()=>{if(d?.open)return;let s=document.createElement(\"div\"),D=s.attachShadow({mode:\"open\"}),o=document.createElement(\"dialog\");d=o,o.setAttribute(\"aria-labelledby\",\"executor-failure-title\");let y=document.createElement(\"h2\");y.id=\"executor-failure-title\",y.textContent=e===\"script\"?\"This app could not load\":\"This app stopped working\";let C=document.createElement(\"p\");C.textContent=e===\"script\"?\"A file needed by this page did not load. Reload the page to try again.\":\"The app encountered an unexpected error. Reload the page to try again.\";let L=document.createElement(\"p\");L.textContent=\"Copy any unsaved work before reloading.\";let R=document.createElement(\"details\"),T=document.createElement(\"summary\");T.textContent=\"Error details\";let c=document.createElement(\"textarea\");c.readOnly=!0,c.rows=10,c.cols=36,c.setAttribute(\"aria-label\",\"Error details\"),c.value=`${t.slice(0,12e3)}\n\nDiagnostic ID: ${E}`,R.append(T,c),n=document.createElement(\"p\"),n.setAttribute(\"role\",\"status\"),n.textContent=l;let u=document.createElement(\"button\");u.type=\"button\",u.textContent=\"Reload page\",u.addEventListener(\"click\",()=>location.reload());let p=document.createElement(\"button\");p.type=\"button\",p.textContent=\"Close\",p.addEventListener(\"click\",()=>o.close()),o.addEventListener(\"close\",()=>{d===o&&(d=void 0),s.remove()}),o.append(y,C,L,R,n,u,p),D.append(o),document.documentElement.append(s),o.showModal()};document.readyState===\"loading\"?document.addEventListener(\"DOMContentLoaded\",k,{once:!0}):k(),fetch(\"/_executor/api/telemetry/traces\",{method:\"POST\",headers:{\"content-type\":\"application/json\"},credentials:\"same-origin\",keepalive:!0,body:JSON.stringify({resourceSpans:[{scopeSpans:[{spans:[{traceId:E,spanId:E.slice(0,16),name:\"ui.app.failure\",kind:1,startTimeUnixNano:S,endTimeUnixNano:S,status:{code:2},attributes:[{key:\"executor.ui.failure.kind\",value:{stringValue:e}},...i]}]}]}]})}).then(s=>{l=s.ok?\"Error report sent.\":\"Could not send the error report. You can copy the error details.\",n&&(n.textContent=l)},()=>{l=\"Could not send the error report. You can copy the error details.\",n&&(n.textContent=l)})};window.addEventListener(\"error\",e=>{if(e instanceof ErrorEvent){if(v.test(e.filename)||e.error===null&&e.lineno===0&&A.has(e.message))return;let t=b(e.filename,e.lineno,e.colno);e.error instanceof Error&&V.has(e.error.name)&&t.push({key:\"exception.type\",value:{stringValue:e.error.name}}),h(\"runtime\",e.error instanceof Error?e.error.stack??e.message:e.message,t)}else e.target instanceof HTMLScriptElement&&h(\"script\",`Could not load script: ${e.target.src}`,b(e.target.src))},!0),window.addEventListener(\"unhandledrejection\",e=>{let t=e.reason;h(\"rejection\",t instanceof Error?t.stack??t.message:\"An app operation failed without handling its error.\")})};M();})();";
 /** Compiled from src/browser/account-notice.ts. */

package/types/apps/src/implementation/openapi-source.d.ts

@@ -49,7 +49,7 @@ export declare const liveOpenapiRouter: (options: OpenapiSourceOptions) => Route
 export type OpenapiToolNamesOptions = Omit<OpenapiSourceOptions, "cache" | "account" | "parameterDefaults" | "freshFor" | "staleFor">;
 /**
  * The tools `liveOpenapiRouter` with the same options exposes, from the definition alone: no
- * account, cache or deployment. Each tool says which `methods` and `oauth` entries expose it, so
+ * account, cache or deployed version. Each tool says which `methods` and `oauth` entries expose it, so
  * an author can check the names a `withApprovals` policy matches before any account connects.
  * `skipped` lists only the operations the compiler left out and why. An operation no configured
  * `methods` or `oauth` entry can authorize is missing from `tools` and not listed in `skipped`.

package/types/apps/src/implementation/sql.d.ts

@@ -61,7 +61,7 @@ export declare const hasMigrations: (files: readonly {
 }[]) => boolean;
 /**
  * Apply the build's pending migrations and report which ran. Every pending migration runs in one
- * transaction, so a failing one leaves the database exactly as the active deployment knows it. The
+ * transaction, so a failing one leaves the database exactly as the active version knows it. The
  * migrations already applied must still be the build's first ones, byte for byte.
  */
 export declare const migrate: (storage: AppSqlStorage, files: readonly SkillFile[]) => Effect.Effect<{

package/types/apps/src/implementation/ui-client.d.ts

@@ -1,7 +1,7 @@
 import { AsyncResult, Atom } from "effect/reactivity";
 import { type OperationReference } from "../contracts/live.js";
 import { type Schema } from "./schema.js";
-/** A scoped page client. Host-injected context carries only the deployment, never credentials. */
+/** A scoped page client. Host-injected context carries only the version, never credentials. */
 export declare const createAppClient: () => {
     /** Close this client when its page or embedding owner is removed. */
     dispose: () => Promise<void>;

package/types/apps/src/implementation/ui-document.d.ts

@@ -1,5 +1,5 @@
 /**
- * Retained files sit at the deployment's asset root. Resolving path-relative resource URLs there,
+ * Retained files sit at the version's asset root. Resolving path-relative resource URLs there,
  * instead of with `<base>`, leaves the document base as the page URL for links, history and forms.
  */
-export declare const deploymentDocument: (html: string, deployment: string) => string;
+export declare const versionDocument: (html: string, version: string) => string;

package/types/apps/src/implementation/ui-serving.d.ts

@@ -2,11 +2,11 @@ import { Effect, Option, Stream } from "effect";
 import { HttpServerRequest, HttpServerResponse } from "effect/http";
 import { UiFailed, UiForbidden, type AppUiAsset, type AppUiRange, type AppUiStoredFile, type UiAccountNotice } from "../contracts/ui.js";
 /**
- * Render an authorized deployment with a host-owned deployment watcher. Account problems that stop
+ * Render an authorized version with a host-owned version watcher. Account problems that stop
  * the app replace its document with a page that links to their fix; others add a dismissible card.
  */
 export declare const appDocument: <E, R>(options: {
-    readonly deployment: string;
+    readonly version: string;
     /** The account IDs the page runs with, by requirement. */
     readonly accountIds?: Readonly<Record<string, readonly string[]>> | undefined;
     readonly origin: string;
@@ -14,7 +14,7 @@ export declare const appDocument: <E, R>(options: {
     readonly asset: (path: string) => Effect.Effect<AppUiAsset | undefined, E, R>;
 }) => Effect.Effect<HttpServerResponse.HttpServerResponse, UiFailed | UiForbidden | E, HttpServerRequest.HttpServerRequest | R>;
 /**
- * A deployment's public file, read from the host's store. The deployment lists it, so bytes that
+ * A version's public file, read from the host's store. The version lists it, so bytes that
  * are gone are a storage fault, never a missing page.
  */
 export declare const storedAppFile: <E1, E2>(stored: {
@@ -27,7 +27,7 @@ export declare const storedAppFile: <E1, E2>(stored: {
 /** The file a URL path names: each segment percent-decoded, or none when one does not decode. */
 export declare const assetPath: (path: string) => Option.Option<string>;
 /** Serve an asset only after the host has checked current access and file existence.
- * Asset URLs name their deployment, so their bytes never change: the browser keeps them for a year
+ * Asset URLs name their version, so their bytes never change: the browser keeps them for a year
  * and does not ask again. Shared proxies never store them. Revoking access stops every new request
  * and all app data, while bytes a browser already downloaded stay in its cache.
  * HTML remains an uncached host-rendered entry point; other HTML files are served as they are.

package/types/apps/src/implementation/ui-watch.d.ts

@@ -1,2 +1,2 @@
 /** Dependency-free browser source served by each host after app authorization. */
-export declare const appWatchScript = "\"use strict\";(()=>{var s=()=>{let i=document.getElementById(\"executor-context\")?.textContent;if(!i)return;let n=JSON.parse(i);if(typeof n!=\"object\"||n===null||!(\"deployment\"in n))return;let r=n.deployment;if(typeof r!=\"string\"||r.length===0)return;let t=new EventSource(\"/_executor/version\"),l=!1,o=()=>{l||(l=!0,t.close(),location.reload())};t.addEventListener(\"version\",d=>{let e=JSON.parse(d.data);typeof e==\"object\"&&e!==null&&\"deployment\"in e&&(e.deployment===null||typeof e.deployment==\"string\")&&e.deployment!==r&&o()}),t.addEventListener(\"revoked\",o),window.addEventListener(\"executor:deployment-changed\",o),window.addEventListener(\"pagehide\",()=>t.close(),{once:!0}),window.addEventListener(\"pageshow\",d=>{d.persisted&&o()})};s();})();";
+export declare const appWatchScript = "\"use strict\";(()=>{var c=()=>{let s=document.getElementById(\"executor-context\")?.textContent;if(!s)return;let n=JSON.parse(s);if(typeof n!=\"object\"||n===null||!(\"version\"in n))return;let r=n.version;if(typeof r!=\"string\"||r.length===0)return;let t=new EventSource(\"/_executor/version\"),d=!1,o=()=>{d||(d=!0,t.close(),location.reload())};t.addEventListener(\"version\",i=>{let e=JSON.parse(i.data);typeof e==\"object\"&&e!==null&&\"version\"in e&&(e.version===null||typeof e.version==\"string\")&&e.version!==r&&o()}),t.addEventListener(\"revoked\",o),window.addEventListener(\"executor:deployment-changed\",o),window.addEventListener(\"pagehide\",()=>t.close(),{once:!0}),window.addEventListener(\"pageshow\",i=>{i.persisted&&o()})};c();})();";

package/types/utils/src/legacy-keys.d.ts

@@ -0,0 +1,20 @@
+import { Schema } from "effect";
+type Mapping<S extends Schema.Struct<Schema.Struct.Fields>> = {
+    readonly [K in keyof S["fields"]]?: string;
+};
+type LegacyEncoded<S extends Schema.Struct<Schema.Struct.Fields>, M extends Mapping<S>> = Omit<S["Encoded"], keyof M> & {
+    readonly [K in keyof M & keyof S["Encoded"]]?: S["Encoded"][K];
+} & {
+    readonly [K in keyof M as M[K] extends string ? M[K] : never]?: K extends keyof S["Encoded"] ? S["Encoded"][K] : never;
+};
+/** A struct whose renamed fields also travel under their former names. */
+export interface withLegacyKeys<S extends Schema.Struct<Schema.Struct.Fields>, M extends Mapping<S>> extends Schema.decodeTo<S, Schema.Codec<LegacyEncoded<S, M>>> {
+}
+/**
+ * Keep renamed fields readable by callers that still use their former names. `{ version:
+ * "deployment" }` decodes `version`, or `deployment` when `version` is absent, and encodes the
+ * value under both keys. Clients, stored values and app bundles written before a rename keep
+ * working, while the decoded type has only the new name.
+ */
+export declare const withLegacyKeys: <S extends Schema.Struct<Schema.Struct.Fields>, const M extends Mapping<S>>(mapping: M) => (self: S) => withLegacyKeys<S, M>;
+export {};