@lunora/container 1.0.0-alpha.30 → 1.0.0-alpha.32

package/dist/bridge.d.mts

@@ -1,7 +1,6 @@
 import { LunoraError } from '@lunora/errors';
 /**
  * A `fetch` implementation — defaults to the runtime global.
- * @experimental
  */
 type FetchLike = (input: string, init: {
   body: string;
@@ -15,7 +14,6 @@ type FetchLike = (input: string, init: {
 }>;
 /**
  * `ContainerBridgeOptions` is part of the experimental `@lunora/container` API and may change without a major version bump.
- * @experimental
  */
 interface ContainerBridgeOptions {
   /**
@@ -35,7 +33,6 @@ interface ContainerBridgeOptions {
 }
 /**
  * Thrown when a Lunora function returns an error envelope. A `LunoraError` subclass carrying the wire `code`.
- * @experimental
  */
 declare class ContainerBridgeError extends LunoraError {
   constructor(code: string, message: string);
@@ -46,7 +43,6 @@ declare class ContainerBridgeError extends LunoraError {
  * imported) so the bridge stays dependency-free and its `.d.ts` is
  * self-contained; the `__lunoraPhantom` shape matches, so a real `api.x.y`
  * reference is assignable and its arg/return types are inferable.
- * @experimental
  */
 interface BridgeFunctionReference<Args = unknown, Result = unknown> {
   readonly __lunoraPhantom?: {
@@ -69,7 +65,6 @@ type ResultOfReference<Reference> = Reference extends {
 } ? Result : never;
 /**
  * `ContainerBridge` is part of the experimental `@lunora/container` API and may change without a major version bump.
- * @experimental
  */
 interface ContainerBridge {
   /** Call an `action` by `namespace:fn` path. Alias of {@link ContainerBridge.call} for intent. */
@@ -100,7 +95,6 @@ interface ContainerBridge {
  * `query`/`mutation`/`action` are intent-revealing aliases of one `call` — the
  * wire is identical and the server dispatches by the function's registered
  * kind, so a query path called via `.mutation(...)` still runs as a query.
- * @experimental
  */
 declare const createContainerBridge: (options: ContainerBridgeOptions) => ContainerBridge;
 export { type BridgeFunctionReference, type ContainerBridge, ContainerBridgeError, type ContainerBridgeOptions, type FetchLike, createContainerBridge };

package/dist/bridge.d.ts

@@ -1,7 +1,6 @@
 import { LunoraError } from '@lunora/errors';
 /**
  * A `fetch` implementation — defaults to the runtime global.
- * @experimental
  */
 type FetchLike = (input: string, init: {
   body: string;
@@ -15,7 +14,6 @@ type FetchLike = (input: string, init: {
 }>;
 /**
  * `ContainerBridgeOptions` is part of the experimental `@lunora/container` API and may change without a major version bump.
- * @experimental
  */
 interface ContainerBridgeOptions {
   /**
@@ -35,7 +33,6 @@ interface ContainerBridgeOptions {
 }
 /**
  * Thrown when a Lunora function returns an error envelope. A `LunoraError` subclass carrying the wire `code`.
- * @experimental
  */
 declare class ContainerBridgeError extends LunoraError {
   constructor(code: string, message: string);
@@ -46,7 +43,6 @@ declare class ContainerBridgeError extends LunoraError {
  * imported) so the bridge stays dependency-free and its `.d.ts` is
  * self-contained; the `__lunoraPhantom` shape matches, so a real `api.x.y`
  * reference is assignable and its arg/return types are inferable.
- * @experimental
  */
 interface BridgeFunctionReference<Args = unknown, Result = unknown> {
   readonly __lunoraPhantom?: {
@@ -69,7 +65,6 @@ type ResultOfReference<Reference> = Reference extends {
 } ? Result : never;
 /**
  * `ContainerBridge` is part of the experimental `@lunora/container` API and may change without a major version bump.
- * @experimental
  */
 interface ContainerBridge {
   /** Call an `action` by `namespace:fn` path. Alias of {@link ContainerBridge.call} for intent. */
@@ -100,7 +95,6 @@ interface ContainerBridge {
  * `query`/`mutation`/`action` are intent-revealing aliases of one `call` — the
  * wire is identical and the server dispatches by the function's registered
  * kind, so a query path called via `.mutation(...)` still runs as a query.
- * @experimental
  */
 declare const createContainerBridge: (options: ContainerBridgeOptions) => ContainerBridge;
 export { type BridgeFunctionReference, type ContainerBridge, ContainerBridgeError, type ContainerBridgeOptions, type FetchLike, createContainerBridge };

package/dist/bridge.mjs

@@ -1 +1 @@
-import{LunoraError as f}from"@lunora/errors";const g="/_lunora/rpc";class y extends f{constructor(r,e){super(r,e,{name:"ContainerBridgeError"})}}const w=(t,r)=>{let e=t;for(;e.endsWith("/");)e=e.slice(0,-1);return`${e}${r}`},d=(t,r)=>new Error(`createContainerBridge: request to "${t}" failed (status ${String(r.status)}${r.statusText?` ${r.statusText}`:""})`),m=async(t,r)=>{try{return await t.json()}catch{throw t.ok?new f("INTERNAL",`createContainerBridge: request to "${r}" returned a non-JSON response (status ${String(t.status)})`):d(r,t)}},b=t=>{if(typeof t.baseUrl!="string"||t.baseUrl.length===0)throw new TypeError("createContainerBridge: `baseUrl` must be a non-empty Worker URL (e.g. https://my-app.workers.dev) — is the URL env var set?");const r=t.fetch??globalThis.fetch,e=async(n,i={},c)=>{if(typeof r!="function")throw new TypeError("createContainerBridge: no `fetch` available — pass `fetch` in options for this runtime.");const l={"content-type":"application/json"};t.token!==void 0&&(l.authorization=`Bearer ${t.token}`);const s=await r(w(t.baseUrl,g),{body:JSON.stringify({args:i,functionPath:n,shardKey:c}),headers:l,method:"POST"}),o=await m(s,n);if(typeof o=="object"&&o!==null&&"error"in o){const{error:a}=o;if(typeof a=="object"&&a!==null){const{code:h,message:p}=a;if(typeof h=="string"&&typeof p=="string")throw new y(h,p)}let u;try{u=JSON.stringify(a)}catch{u=String(a)}throw new f("INTERNAL",`createContainerBridge: request to "${n}" returned a malformed error envelope (status ${String(s.status)}): ${u}`)}if(!s.ok)throw d(n,s);return o.result};return{action:e,call:e,mutation:e,query:e,run:async(n,i,c)=>e(n.__lunoraRef,i,c)}};export{y as ContainerBridgeError,b as createContainerBridge};
+import{LunoraError as u}from"@lunora/errors";const h="/_lunora/rpc";class w extends u{constructor(r,e){super(r,e,{name:"ContainerBridgeError"})}}const p=(t,r)=>{let e=t;for(;e.endsWith("/");)e=e.slice(0,-1);return`${e}${r}`},g=(t,r)=>new Error(`createContainerBridge: request to "${t}" failed (status ${String(r.status)}${r.statusText?` ${r.statusText}`:""})`),m=async(t,r)=>{try{return await t.json()}catch{throw t.ok?new u("INTERNAL",`createContainerBridge: request to "${r}" returned a non-JSON response (status ${String(t.status)})`):g(r,t)}},B=t=>{if(typeof t.baseUrl!="string"||t.baseUrl.length===0)throw new TypeError("createContainerBridge: `baseUrl` must be a non-empty Worker URL (e.g. https://my-app.workers.dev) — is the URL env var set?");const r=t.fetch??globalThis.fetch,e=async(n,i={},c)=>{if(typeof r!="function")throw new TypeError("createContainerBridge: no `fetch` available — pass `fetch` in options for this runtime.");const d={"content-type":"application/json"};t.token!==void 0&&(d.authorization=`Bearer ${t.token}`);const s=await r(p(t.baseUrl,h),{body:JSON.stringify({args:i,functionPath:n,shardKey:c}),headers:d,method:"POST"}),o=await m(s,n);if(typeof o=="object"&&o!==null&&"error"in o){const{error:a}=o;if(typeof a=="object"&&a!==null){const{code:f,message:y}=a;if(typeof f=="string"&&typeof y=="string")throw new w(f,y)}let l;try{l=JSON.stringify(a)}catch{l=String(a)}throw new u("INTERNAL",`createContainerBridge: request to "${n}" returned a malformed error envelope (status ${String(s.status)}): ${l}`)}if(!s.ok)throw g(n,s);return o.result};return{action:e,call:e,mutation:e,query:e,run:async(n,i,c)=>e(n.__lunoraRef,i,c)}};export{w as ContainerBridgeError,B as createContainerBridge};

package/dist/do/index.d.mts

@@ -1,5 +1,5 @@
+import { C as ContainerDefinition, D as DurableObjectJurisdiction } from "../packem_shared/jurisdiction.d-KcQu2ZT_.mjs";
 import { DurableObject, WorkerEntrypoint } from 'cloudflare:workers';
-import { a as ContainerDefinition, D as DurableObjectJurisdiction } from "../packem_shared/jurisdiction.d-DeQ3rtYK.mjs";
 /**
  * ContainerStartOptions as they come from worker types
  */
@@ -500,7 +500,6 @@ type DurableObjectContext = ConstructorParameters<typeof Container>[0];
  *     }
  * }
  * ```
- * @experimental
  */
 declare class LunoraContainer<Env = unknown> extends Container<Env> {
   /**

package/dist/do/index.d.ts

@@ -1,5 +1,5 @@
+import { C as ContainerDefinition, D as DurableObjectJurisdiction } from "../packem_shared/jurisdiction.d-KcQu2ZT_.js";
 import { DurableObject, WorkerEntrypoint } from 'cloudflare:workers';
-import { a as ContainerDefinition, D as DurableObjectJurisdiction } from "../packem_shared/jurisdiction.d-DeQ3rtYK.js";
 /**
  * ContainerStartOptions as they come from worker types
  */
@@ -500,7 +500,6 @@ type DurableObjectContext = ConstructorParameters<typeof Container>[0];
  *     }
  * }
  * ```
- * @experimental
  */
 declare class LunoraContainer<Env = unknown> extends Container<Env> {
   /**

package/dist/do/index.mjs

@@ -1 +1 @@
-import{Container as S}from"../packem_shared/ContainerProxy-BsQAwSNX.mjs";import{ContainerProxy as O,outboundParams as L}from"../packem_shared/ContainerProxy-BsQAwSNX.mjs";import{LunoraError as u}from"@lunora/errors";import{resolveContainerEnvVars as g,parseDurationSeconds as v}from"../packem_shared/containerBindingName-CP4v-2Cw.mjs";import{e as y}from"../packem_shared/jurisdiction-BKRNOTip.mjs";const w="lunora",N=(i,t,n,e)=>({container:i,event:n,instance:t,level:n==="error"?"error":"info",message:e,source:w,ts:Date.now(),type:"container"}),a=(i,t,n,e)=>{const o=N(i,t,n,e),r=JSON.stringify(o);return n==="error"?console.error(r):console.log(r),o},$="__lunora_admin__:recordContainerEvent",h="__root__",E=i=>{if(i===null||typeof i!="object")return!1;const t=i;return typeof t.get=="function"&&typeof t.idFromName=="function"},I=(i,t)=>{const n=y(i,t);return typeof n.getByName=="function"?n.getByName(h):n.get(n.idFromName(h))},T=async(i,t,n)=>{try{const e=i??{},o=e.SHARD;if(!E(o))return;const r=typeof e.LUNORA_ADMIN_TOKEN=="string"?e.LUNORA_ADMIN_TOKEN:void 0;if(!r||r.length===0)return;const s=new Request("https://shard.internal/rpc",{body:JSON.stringify({args:{event:t},functionPath:$}),headers:{authorization:`Bearer ${r}`,"content-type":"application/json"},method:"POST"});await I(o,n).fetch(s)}catch{}},l=500,p=3e4,d="__lunoraHardTimeoutGeneration";class _ extends S{lunoraJurisdiction;lunoraName;lunoraDefaultPort;lunoraHardTimeoutSeconds;lunoraReadyOn;lunoraSecretsStore;lunoraSecretsStoreResolved;constructor(t,n,e,o,r){super(t,n,{defaultPort:e.defaultPort,entrypoint:e.entrypoint?[...e.entrypoint]:void 0,envVars:g(e,n,o),sleepAfter:e.sleepAfter}),e.enableInternet!==void 0&&(this.enableInternet=e.enableInternet),e.requiredPorts!==void 0&&(this.requiredPorts=[...e.requiredPorts]),e.interceptHttps!==void 0&&(this.interceptHttps=e.interceptHttps),e.allowedHosts!==void 0&&(this.allowedHosts=[...e.allowedHosts]),e.deniedHosts!==void 0&&(this.deniedHosts=[...e.deniedHosts]),e.pingEndpoint!==void 0&&(this.pingEndpoint=e.pingEndpoint),e.labels!==void 0&&(this.labels={...e.labels}),this.lunoraName=o??"container",this.lunoraJurisdiction=r,this.lunoraDefaultPort=e.defaultPort,this.lunoraReadyOn=e.readyOn?[...e.readyOn]:[],this.lunoraHardTimeoutSeconds=e.hardTimeout===void 0?void 0:v(e.hardTimeout),this.lunoraSecretsStore=e.secretsStore}async containerFetch(...t){return await this.resolveSecretsStoreEnv(),super.containerFetch(...t)}async start(...t){const[n]=t;return n?.envVars===void 0&&await this.resolveSecretsStoreEnv(),super.start(...t)}async onActivityExpired(){const t=a(this.lunoraName,this.instanceId(),"sleep");this.surfaceInStudioLogs(t),await super.onActivityExpired()}onError(t){const n=a(this.lunoraName,this.instanceId(),"error",t instanceof Error?t.message:String(t));return this.surfaceInStudioLogs(n),super.onError(t)}async onStart(){const t=a(this.lunoraName,this.instanceId(),"start");this.surfaceInStudioLogs(t),await super.onStart(),await this.armHardTimeout(),await this.awaitContainerReadiness()}async onHardTimeoutExpired(t){const n=await this.ctx.storage.get(d);if(t?.generation!==void 0&&t.generation!==n||this.ctx.container?.running!==!0)return;const e=a(this.lunoraName,this.instanceId(),"stop","hard timeout reached");this.surfaceInStudioLogs(e),await this.stop()}async onStop(t){const n=a(this.lunoraName,this.instanceId(),"stop",`${t.reason} (exit ${String(t.exitCode)})`);this.surfaceInStudioLogs(n),await super.onStop(t)}async armHardTimeout(){if(this.lunoraHardTimeoutSeconds===void 0)return;const t=(await this.ctx.storage.get(d)??0)+1;await this.ctx.storage.put(d,t),await this.schedule(this.lunoraHardTimeoutSeconds,"onHardTimeoutExpired",{generation:t})}async resolveSecretsStoreEnv(){const t=this.lunoraSecretsStore;t!==void 0&&(this.lunoraSecretsStoreResolved??=(async()=>{const n=this.env,e={};for(const[o,r]of Object.entries(t)){const s=n[r];if(s===void 0||typeof s.get!="function")throw new u("INTERNAL",`container "${this.lunoraName}": secretsStore env "${o}" points at binding "${r}", which is not a Secrets Store binding on the Worker env. Add a \`secrets_store_secrets\` entry binding "${r}".`);const c=await s.get();if(typeof c!="string")throw new TypeError(`container "${this.lunoraName}": Secrets Store binding "${r}" (env "${o}") did not resolve to a string value.`);e[o]=c}this.envVars={...this.envVars,...e}})().catch(n=>{throw this.lunoraSecretsStoreResolved=void 0,n}),await this.lunoraSecretsStoreResolved)}async awaitContainerReadiness(){if(this.lunoraReadyOn.length===0)return;const{container:t}=this.ctx;if(t===void 0)return;const n=Date.now()+p;await Promise.all(this.lunoraReadyOn.map(async e=>this.awaitReadinessCheck(t,e,n)))}async awaitReadinessCheck(t,n,e){const o=n.port??this.lunoraDefaultPort;if(o===void 0)throw new u("INTERNAL",`container "${this.lunoraName}": readyOn check "${n.path}" has no port — set the check's \`port\` or the container \`defaultPort\`.`);const r=n.status??200,s=n.path.startsWith("/")?n.path:`/${n.path}`,c=t.getTcpPort(o);for(;;){const f=Math.max(l,e-Date.now());try{if((await c.fetch(`http://container${s}`,{signal:AbortSignal.timeout(f)})).status===r)return}catch{}if(Date.now()>=e)throw new u("INTERNAL",`container "${this.lunoraName}": readiness check "${n.path}" (port ${String(o)}) did not return ${String(r)} within ${String(p)}ms`);await new Promise(m=>{setTimeout(m,l)})}}surfaceInStudioLogs(t){T(this.env,t,this.lunoraJurisdiction).catch(()=>{})}instanceId(){try{const{id:t}=this.ctx;return typeof t?.toString=="function"?t.toString():"unknown"}catch{return"unknown"}}}export{O as ContainerProxy,_ as LunoraContainer,L as outboundParams};
+import{LunoraError as u}from"@lunora/errors";import{resolveContainerEnvVars as m,parseDurationSeconds as y}from"../packem_shared/containerBindingName-D01FopQt.mjs";import{a as g}from"../packem_shared/jurisdiction-DtE9s70w.mjs";import{Container as f}from"../packem_shared/ContainerProxy-fTW_pXWY.mjs";import{ContainerProxy as b,outboundParams as x}from"../packem_shared/ContainerProxy-fTW_pXWY.mjs";const w="lunora",E=(s,t,r,e)=>({container:s,event:r,instance:t,level:r==="error"?"error":"info",message:e,source:w,ts:Date.now(),type:"container"}),i=(s,t,r,e)=>{const o=E(s,t,r,e),n=JSON.stringify(o);return r==="error"?console.error(n):console.log(n),o},N="__lunora_admin__:recordContainerEvent",d="__root__",R=s=>{if(s===null||typeof s!="object")return!1;const t=s;return typeof t.get=="function"&&typeof t.idFromName=="function"},_=(s,t)=>{const r=g(s,t);return typeof r.getByName=="function"?r.getByName(d):r.get(r.idFromName(d))},T=async(s,t,r)=>{try{const e=s??{},o=e.SHARD;if(!R(o))return;const n=typeof e.LUNORA_ADMIN_TOKEN=="string"?e.LUNORA_ADMIN_TOKEN:void 0;if(!n||n.length===0)return;const a=new Request("https://shard.internal/rpc",{body:JSON.stringify({args:{event:t},functionPath:N}),headers:{authorization:`Bearer ${n}`,"content-type":"application/json"},method:"POST"});await _(o,r).fetch(a)}catch{}},p=500,S=3e4,h="__lunoraHardTimeoutGeneration";class L extends f{lunoraJurisdiction;lunoraName;lunoraDefaultPort;lunoraHardTimeoutSeconds;lunoraReadyOn;lunoraSecretsStore;lunoraSecretsStoreResolved;constructor(t,r,e,o,n){super(t,r,{defaultPort:e.defaultPort,entrypoint:e.entrypoint?[...e.entrypoint]:void 0,envVars:m(e,r,o),sleepAfter:e.sleepAfter}),e.enableInternet!==void 0&&(this.enableInternet=e.enableInternet),e.requiredPorts!==void 0&&(this.requiredPorts=[...e.requiredPorts]),e.interceptHttps!==void 0&&(this.interceptHttps=e.interceptHttps),e.allowedHosts!==void 0&&(this.allowedHosts=[...e.allowedHosts]),e.deniedHosts!==void 0&&(this.deniedHosts=[...e.deniedHosts]),e.pingEndpoint!==void 0&&(this.pingEndpoint=e.pingEndpoint),e.labels!==void 0&&(this.labels={...e.labels}),this.lunoraName=o??"container",this.lunoraJurisdiction=n,this.lunoraDefaultPort=e.defaultPort,this.lunoraReadyOn=e.readyOn?[...e.readyOn]:[],this.lunoraHardTimeoutSeconds=e.hardTimeout===void 0?void 0:y(e.hardTimeout),this.lunoraSecretsStore=e.secretsStore}async containerFetch(...t){return await this.resolveSecretsStoreEnv(),super.containerFetch(...t)}async start(...t){const[r]=t;return r?.envVars===void 0&&await this.resolveSecretsStoreEnv(),super.start(...t)}async onActivityExpired(){const t=i(this.lunoraName,this.instanceId(),"sleep");this.surfaceInStudioLogs(t),await super.onActivityExpired()}onError(t){const r=i(this.lunoraName,this.instanceId(),"error",t instanceof Error?t.message:String(t));return this.surfaceInStudioLogs(r),super.onError(t)}async onStart(){const t=i(this.lunoraName,this.instanceId(),"start");this.surfaceInStudioLogs(t),await super.onStart(),await this.armHardTimeout(),await this.awaitContainerReadiness()}async onHardTimeoutExpired(t){const r=await this.ctx.storage.get(h);if(t?.generation!==void 0&&t.generation!==r||this.ctx.container?.running!==!0)return;const e=i(this.lunoraName,this.instanceId(),"stop","hard timeout reached");this.surfaceInStudioLogs(e),await this.stop()}async onStop(t){const r=i(this.lunoraName,this.instanceId(),"stop",`${t.reason} (exit ${String(t.exitCode)})`);this.surfaceInStudioLogs(r),await super.onStop(t)}async armHardTimeout(){if(this.lunoraHardTimeoutSeconds===void 0)return;const t=(await this.ctx.storage.get(h)??0)+1;await this.ctx.storage.put(h,t),await this.schedule(this.lunoraHardTimeoutSeconds,"onHardTimeoutExpired",{generation:t})}async resolveSecretsStoreEnv(){const t=this.lunoraSecretsStore;t!==void 0&&(this.lunoraSecretsStoreResolved??=(async()=>{const r=this.env,e={};for(const[o,n]of Object.entries(t)){const a=r[n];if(a===void 0||typeof a.get!="function")throw new u("INTERNAL",`container "${this.lunoraName}": secretsStore env "${o}" points at binding "${n}", which is not a Secrets Store binding on the Worker env. Add a \`secrets_store_secrets\` entry binding "${n}".`);const c=await a.get();if(typeof c!="string")throw new TypeError(`container "${this.lunoraName}": Secrets Store binding "${n}" (env "${o}") did not resolve to a string value.`);e[o]=c}this.envVars={...this.envVars,...e}})().catch(r=>{throw this.lunoraSecretsStoreResolved=void 0,r}),await this.lunoraSecretsStoreResolved)}async awaitContainerReadiness(){if(this.lunoraReadyOn.length===0)return;const{container:t}=this.ctx;if(t===void 0)return;const r=Date.now()+S;await Promise.all(this.lunoraReadyOn.map(async e=>this.awaitReadinessCheck(t,e,r)))}async awaitReadinessCheck(t,r,e){const o=r.port??this.lunoraDefaultPort;if(o===void 0)throw new u("INTERNAL",`container "${this.lunoraName}": readyOn check "${r.path}" has no port — set the check's \`port\` or the container \`defaultPort\`.`);const n=r.status??200,a=r.path.startsWith("/")?r.path:`/${r.path}`,c=t.getTcpPort(o);for(;;){const v=Math.max(p,e-Date.now());try{if((await c.fetch(`http://container${a}`,{signal:AbortSignal.timeout(v)})).status===n)return}catch{}if(Date.now()>=e)throw new u("INTERNAL",`container "${this.lunoraName}": readiness check "${r.path}" (port ${String(o)}) did not return ${String(n)} within ${String(S)}ms`);await new Promise(l=>{setTimeout(l,p)})}}surfaceInStudioLogs(t){T(this.env,t,this.lunoraJurisdiction).catch(()=>{})}instanceId(){try{const{id:t}=this.ctx;return typeof t?.toString=="function"?t.toString():"unknown"}catch{return"unknown"}}}export{b as ContainerProxy,L as LunoraContainer,x as outboundParams};

package/dist/index.d.mts

@@ -1,8 +1,74 @@
-import { D as DurableObjectJurisdiction, C as ContainerConfig, a as ContainerDefinition, b as ContainerImageSource, N as NormalizedContainerImage } from "./packem_shared/jurisdiction.d-DeQ3rtYK.mjs";
-export type { B as BuildImageSource, c as ContainerInstanceType, d as ContainerReadinessCheck, e as ContainerRollout, f as CustomContainerInstanceType, g as NamedContainerInstanceType, R as RegistryImageSource } from "./packem_shared/jurisdiction.d-DeQ3rtYK.mjs";
+import { D as DurableObjectJurisdiction, a as ContainerConfig, C as ContainerDefinition, b as ContainerImageSource, N as NormalizedContainerImage } from "./packem_shared/jurisdiction.d-KcQu2ZT_.mjs";
+export type { B as BuildImageSource, c as ContainerInstanceType, d as ContainerReadinessCheck, e as ContainerRollout, f as CustomContainerInstanceType, g as NamedContainerInstanceType, R as RegistryImageSource } from "./packem_shared/jurisdiction.d-KcQu2ZT_.mjs";
+/**
+ * Per-call options for `ContainerHandle.exec`.
+ */
+interface ContainerExecOptions {
+  /** Arguments passed to `command`, unshelled — the container must not concatenate them into a shell string. */
+  args?: ReadonlyArray<string>;
+  /** Working directory for the command, relative to the container's own root. */
+  cwd?: string;
+  /** Extra environment for this command only, merged over the container's env. */
+  env?: Readonly<Record<string, string>>;
+  /**
+   * Cap on the response body, in bytes. The whole `{code,stdout,stderr}`
+   * document has to be held in memory to be parsed, and a build box or job
+   * runner routinely writes tens of megabytes — a single unbounded `exec`
+   * that returns more than the isolate's memory limit kills the isolate and
+   * every other in-flight request sharing it, not just this call. So a
+   * runner that overruns the cap fails the call loudly rather than taking
+   * the shard down with it; raise this (or have the runner cap its own
+   * output) when a command legitimately produces more.
+   *
+   * Default {@link DEFAULT_EXEC_MAX_OUTPUT_BYTES} (1MB).
+   */
+  maxOutputBytes?: number;
+  /**
+   * Abort the call. Composed with {@link ContainerExecOptions.timeoutMs} when
+   * both are given — whichever fires first wins.
+   */
+  signal?: AbortSignal;
+  /**
+   * Give up after this many ms. Covers the whole call — the request *and*
+   * reading the response body, since `fetch` resolves on headers and a
+   * runner that answers `200` and then stalls mid-body would otherwise sit
+   * past the deadline. Sent to the container as well, so a well-behaved
+   * runner can kill the process rather than leak it when the caller walks
+   * away.
+   */
+  timeoutMs?: number;
+}
+/**
+ * The outcome of a `ContainerHandle.exec` call.
+ *
+ * A non-zero `code` is **not** an error: a command that ran and failed is a
+ * result, and the caller decides what to do with it. Only a failure to *run*
+ * the command — transport, a non-2xx from the runner, an unparseable body —
+ * throws.
+ */
+interface ContainerExecResult {
+  /** Process exit code. Non-zero means the command ran and failed. */
+  code: number;
+  /** Everything the command wrote to stderr. */
+  stderr: string;
+  /** Everything the command wrote to stdout. */
+  stdout: string;
+}
+/**
+ * The route `ContainerHandle.exec` POSTs to. Namespaced under
+ * `/__lunora/` so it cannot collide with an application route the container
+ * already serves — the previous ad-hoc convention was a bare `/exec`, which an
+ * app could plausibly own for its own purposes.
+ *
+ * Exported because it is a *contract*, not an implementation detail: a
+ * container image has to serve exactly this route, and `@lunora/agent`'s
+ * human-in-the-loop gate has to recognise it. Both had it hard-coded as a
+ * second literal, which drifts silently — and on the gate's side, drift
+ * un-gates model-chosen command execution.
+ */
+declare const CONTAINER_EXEC_PATH = "/__lunora/exec";
 /**
  * Options for explicitly starting an instance (mirrors `@cloudflare/containers`).
- * @experimental
  */
 interface ContainerStartOptions {
   /** Override outbound internet access for this start. */
@@ -16,7 +82,6 @@ interface ContainerStartOptions {
 }
 /**
  * A container instance's runtime state, as returned by `getState()`. Structural — the platform adds fields over time.
- * @experimental
  */
 interface ContainerInstanceState {
   [key: string]: unknown;
@@ -44,7 +109,6 @@ interface ContainerStubLike {
 }
 /**
  * What the client needs from a Durable Object namespace binding.
- * @experimental
  */
 interface ContainerNamespaceLike {
   get: (id: unknown) => ContainerStubLike;
@@ -57,9 +121,24 @@ interface ContainerNamespaceLike {
 }
 /**
  * A handle on one container instance (one Durable Object).
- * @experimental
  */
 interface ContainerHandle {
+  /**
+   * Run a command inside the container and return its exit code and output.
+   *
+   * A container is an HTTP server, so there is no platform-level exec to call:
+   * the command is POSTed to `/__lunora/exec` and the container app
+   * serves that route. What this method adds over hand-rolling that fetch is
+   * the **contract** — a pinned path, a typed request and response, and the
+   * distinction between "the command failed" (a `code`) and "the command could
+   * not be run" (a throw). Before it existed every caller invented its own
+   * `/exec` convention and read the raw body back as if it were output, which
+   * silently turned a runner's 500 into a successful-looking result.
+   *
+   * The container side must accept `{ args, command, cwd, env, timeoutMs }`
+   * and answer `{ code, stdout, stderr }` as JSON.
+   */
+  exec: (command: string, options?: ContainerExecOptions) => Promise<ContainerExecResult>;
   /**
    * Send an HTTP (or WebSocket-upgrade) request to the container. A path
    * string (`"/transcode"`) is resolved against a synthetic origin; a full
@@ -82,7 +161,6 @@ interface ContainerHandle {
  * game, a job runner per id) often needs to tear down or inspect the instance
  * rather than wait for `sleepAfter`, so these wrap the container DO's
  * `start`/`stop`/`destroy`/`getState`.
- * @experimental
  */
 interface ContainerInstanceHandle extends ContainerHandle {
   /** Stop and discard the instance (its ephemeral disk is lost). */
@@ -117,7 +195,6 @@ interface ContainerInstanceHandle extends ContainerHandle {
  * Each maps to the corresponding `@cloudflare/containers` `Container` RPC, so
  * an app can tighten or relax a single instance's allowed/denied hosts after
  * start without redeploying.
- * @experimental
  */
 interface ContainerEgressControls {
   /** Add one hostname (or glob) to the allow-list. */
@@ -135,7 +212,6 @@ interface ContainerEgressControls {
 }
 /**
  * The per-definition accessor exposed as `ctx.containers.<exportName>`.
- * @experimental
  */
 interface ContainerAccessor {
   /**
@@ -178,7 +254,6 @@ interface ContainerAccessor {
 }
 /**
  * Tuning for a pooled, retrying container handle. See {@link ContainerAccessor.pool}.
- * @experimental
  */
 interface PoolOptions {
   /** Total attempts before giving up (each on a freshly-picked instance). Default 3. */
@@ -195,6 +270,10 @@ interface PoolOptions {
    * Whether a *returned* response should be retried on another instance.
    * Defaults to retrying any `5xx`. A thrown error (network/start failure) is
    * always retried regardless of this predicate.
+   *
+   * Applies to `fetch` only. `exec` retries on the cold-start transients
+   * alone, because its caller never chose the request and a command that
+   * already ran must not be re-run just because the runner failed afterwards.
    */
   retryOn?: (response: Response) => boolean;
   /** Pool size to spread picks across. Defaults to the definition's `maxInstances`, else 3. */
@@ -205,7 +284,6 @@ interface PoolOptions {
  * only on the platform's provisioning transients (no-instance / not-listening /
  * rate-limited — see {@link isColdStartTransient}), which is why it's safe by
  * default: those responses mean the request never reached the container.
- * @experimental
  */
 interface InstanceRetryOptions {
   /**
@@ -221,7 +299,6 @@ interface InstanceRetryOptions {
 }
 /**
  * Wiring info for one definition, emitted by codegen into the generated DO.
- * @experimental
  */
 interface ContainerBindingSpec {
   /** Durable Object binding name, e.g. `CONTAINER_TRANSCODER`. */
@@ -240,12 +317,10 @@ interface ContainerBindingSpec {
  * `traceparent` (the inbound RPC's W3C trace context, forwarded by the runtime
  * and read off the request by the DO) is stamped onto every outbound container
  * `fetch`, so the container's own spans stitch under the Worker's trace.
- * @experimental
  */
 declare const createContainerContext: (env: Record<string, unknown>, specs: ReadonlyArray<ContainerBindingSpec>, jurisdiction?: DurableObjectJurisdiction, traceparent?: string) => Record<string, ContainerAccessor>;
 /**
  * A test handler: receives the request plus the targeted instance name.
- * @experimental
  */
 type ContainerTestHandler = (request: Request, instance: {
   name: string;
@@ -260,7 +335,6 @@ type ContainerTestHandler = (request: Request, instance: {
  *     transcoder: (request) => new Response("ok"),
  * });
  * ```
- * @experimental
  */
 declare const createContainerTestContext: (handlers: Record<string, ContainerTestHandler>) => Record<string, ContainerAccessor>;
 /**
@@ -272,7 +346,6 @@ declare const createContainerTestContext: (handlers: Record<string, ContainerTes
  * `Dockerfile.dev` also counts) is used as-is with its directory as the build
  * context; any other path is treated as the build-context directory and the
  * Dockerfile is expected at `<dir>/Dockerfile`.
- * @experimental
  */
 declare const normalizeContainerImage: (image: ContainerImageSource) => NormalizedContainerImage;
 /**
@@ -280,7 +353,6 @@ declare const normalizeContainerImage: (image: ContainerImageSource) => Normaliz
  * `transcoder` → `TranscoderContainer`. wrangler's `containers[].class_name`
  * and the Durable Object binding's `class_name` both reference it, so codegen
  * and the config layer MUST derive it identically — always via this helper.
- * @experimental
  */
 declare const containerClassName: (exportName: string) => string;
 /**
@@ -288,7 +360,6 @@ declare const containerClassName: (exportName: string) => string;
  * `CONTAINER_TRANSCODER`, `imageResizer` → `CONTAINER_IMAGE_RESIZER`. The
  * `CONTAINER_` prefix namespaces these away from `SHARD`/`SESSION`/`SCHEDULER`
  * so a container export can never collide with the built-in bindings.
- * @experimental
  */
 declare const containerBindingName: (exportName: string) => string;
 /**
@@ -297,17 +368,14 @@ declare const containerBindingName: (exportName: string) => string;
  * it as the wrangler `containers[].image`, and `lunora deploy` builds that tag
  * with Railpack and `wrangler containers push`es it before deploying — so all
  * three derive the tag from this one helper and can never disagree.
- * @experimental
  */
 declare const containerBuildTag: (exportName: string) => string;
 /**
  * `defineContainer` is part of the experimental `@lunora/container` API and may change without a major version bump.
- * @experimental
  */
 declare const defineContainer: (config: ContainerConfig) => ContainerDefinition;
 /**
  * True when a value is a `defineContainer` result (the runtime brand check).
- * @experimental
  */
 declare const isContainerDefinition: (value: unknown) => value is ContainerDefinition;
 /**
@@ -315,7 +383,138 @@ declare const isContainerDefinition: (value: unknown) => value is ContainerDefin
  * plus every declared secret resolved from the Worker `env`. A declared secret
  * missing from the Worker env fails fast — starting the container without a
  * credential it was promised yields far worse errors downstream.
- * @experimental
  */
 declare const resolveContainerEnvVariables: (definition: ContainerDefinition, workerEnv: Record<string, unknown>, exportName?: string) => Record<string, string>;
-export { type ContainerAccessor, type ContainerBindingSpec, type ContainerConfig, type ContainerDefinition, type ContainerEgressControls, type ContainerHandle, type ContainerImageSource, type ContainerInstanceHandle, type ContainerInstanceState, type ContainerNamespaceLike, type ContainerStartOptions, type ContainerTestHandler, type DurableObjectJurisdiction, type InstanceRetryOptions, type NormalizedContainerImage, type PoolOptions, containerBindingName, containerBuildTag, containerClassName, createContainerContext, createContainerTestContext, defineContainer, isContainerDefinition, normalizeContainerImage, resolveContainerEnvVariables as resolveContainerEnvVars };
+export { CONTAINER_EXEC_PATH,
+/**
+ * `@lunora/container` — Cloudflare Containers for Lunora.
+ *
+ * This root export is Node-safe (no Cloudflare runtime imports): the
+ * `defineContainer` authoring surface, the naming/normalization helpers
+ * codegen and `@lunora/config` share, the `ctx.containers` client wiring, and
+ * a Docker-free test double. The workerd-only `LunoraContainer` base class
+ * (which pulls in `@cloudflare/containers` → `cloudflare:workers`) lives
+ * behind the `@lunora/container/do` subpath.
+ */
+type ContainerAccessor,
+/**
+ * `@lunora/container` — Cloudflare Containers for Lunora.
+ *
+ * This root export is Node-safe (no Cloudflare runtime imports): the
+ * `defineContainer` authoring surface, the naming/normalization helpers
+ * codegen and `@lunora/config` share, the `ctx.containers` client wiring, and
+ * a Docker-free test double. The workerd-only `LunoraContainer` base class
+ * (which pulls in `@cloudflare/containers` → `cloudflare:workers`) lives
+ * behind the `@lunora/container/do` subpath.
+ */
+type ContainerBindingSpec, type ContainerConfig, type ContainerDefinition,
+/**
+ * `@lunora/container` — Cloudflare Containers for Lunora.
+ *
+ * This root export is Node-safe (no Cloudflare runtime imports): the
+ * `defineContainer` authoring surface, the naming/normalization helpers
+ * codegen and `@lunora/config` share, the `ctx.containers` client wiring, and
+ * a Docker-free test double. The workerd-only `LunoraContainer` base class
+ * (which pulls in `@cloudflare/containers` → `cloudflare:workers`) lives
+ * behind the `@lunora/container/do` subpath.
+ */
+type ContainerEgressControls, type ContainerExecOptions, type ContainerExecResult,
+/**
+ * `@lunora/container` — Cloudflare Containers for Lunora.
+ *
+ * This root export is Node-safe (no Cloudflare runtime imports): the
+ * `defineContainer` authoring surface, the naming/normalization helpers
+ * codegen and `@lunora/config` share, the `ctx.containers` client wiring, and
+ * a Docker-free test double. The workerd-only `LunoraContainer` base class
+ * (which pulls in `@cloudflare/containers` → `cloudflare:workers`) lives
+ * behind the `@lunora/container/do` subpath.
+ */
+type ContainerHandle, type ContainerImageSource,
+/**
+ * `@lunora/container` — Cloudflare Containers for Lunora.
+ *
+ * This root export is Node-safe (no Cloudflare runtime imports): the
+ * `defineContainer` authoring surface, the naming/normalization helpers
+ * codegen and `@lunora/config` share, the `ctx.containers` client wiring, and
+ * a Docker-free test double. The workerd-only `LunoraContainer` base class
+ * (which pulls in `@cloudflare/containers` → `cloudflare:workers`) lives
+ * behind the `@lunora/container/do` subpath.
+ */
+type ContainerInstanceHandle,
+/**
+ * `@lunora/container` — Cloudflare Containers for Lunora.
+ *
+ * This root export is Node-safe (no Cloudflare runtime imports): the
+ * `defineContainer` authoring surface, the naming/normalization helpers
+ * codegen and `@lunora/config` share, the `ctx.containers` client wiring, and
+ * a Docker-free test double. The workerd-only `LunoraContainer` base class
+ * (which pulls in `@cloudflare/containers` → `cloudflare:workers`) lives
+ * behind the `@lunora/container/do` subpath.
+ */
+type ContainerInstanceState,
+/**
+ * `@lunora/container` — Cloudflare Containers for Lunora.
+ *
+ * This root export is Node-safe (no Cloudflare runtime imports): the
+ * `defineContainer` authoring surface, the naming/normalization helpers
+ * codegen and `@lunora/config` share, the `ctx.containers` client wiring, and
+ * a Docker-free test double. The workerd-only `LunoraContainer` base class
+ * (which pulls in `@cloudflare/containers` → `cloudflare:workers`) lives
+ * behind the `@lunora/container/do` subpath.
+ */
+type ContainerNamespaceLike,
+/**
+ * `@lunora/container` — Cloudflare Containers for Lunora.
+ *
+ * This root export is Node-safe (no Cloudflare runtime imports): the
+ * `defineContainer` authoring surface, the naming/normalization helpers
+ * codegen and `@lunora/config` share, the `ctx.containers` client wiring, and
+ * a Docker-free test double. The workerd-only `LunoraContainer` base class
+ * (which pulls in `@cloudflare/containers` → `cloudflare:workers`) lives
+ * behind the `@lunora/container/do` subpath.
+ */
+type ContainerStartOptions,
+/**
+ * `@lunora/container` — Cloudflare Containers for Lunora.
+ *
+ * This root export is Node-safe (no Cloudflare runtime imports): the
+ * `defineContainer` authoring surface, the naming/normalization helpers
+ * codegen and `@lunora/config` share, the `ctx.containers` client wiring, and
+ * a Docker-free test double. The workerd-only `LunoraContainer` base class
+ * (which pulls in `@cloudflare/containers` → `cloudflare:workers`) lives
+ * behind the `@lunora/container/do` subpath.
+ */
+type ContainerTestHandler,
+/**
+ * `@lunora/container` — Cloudflare Containers for Lunora.
+ *
+ * This root export is Node-safe (no Cloudflare runtime imports): the
+ * `defineContainer` authoring surface, the naming/normalization helpers
+ * codegen and `@lunora/config` share, the `ctx.containers` client wiring, and
+ * a Docker-free test double. The workerd-only `LunoraContainer` base class
+ * (which pulls in `@cloudflare/containers` → `cloudflare:workers`) lives
+ * behind the `@lunora/container/do` subpath.
+ */
+type DurableObjectJurisdiction,
+/**
+ * `@lunora/container` — Cloudflare Containers for Lunora.
+ *
+ * This root export is Node-safe (no Cloudflare runtime imports): the
+ * `defineContainer` authoring surface, the naming/normalization helpers
+ * codegen and `@lunora/config` share, the `ctx.containers` client wiring, and
+ * a Docker-free test double. The workerd-only `LunoraContainer` base class
+ * (which pulls in `@cloudflare/containers` → `cloudflare:workers`) lives
+ * behind the `@lunora/container/do` subpath.
+ */
+type InstanceRetryOptions, type NormalizedContainerImage,
+/**
+ * `@lunora/container` — Cloudflare Containers for Lunora.
+ *
+ * This root export is Node-safe (no Cloudflare runtime imports): the
+ * `defineContainer` authoring surface, the naming/normalization helpers
+ * codegen and `@lunora/config` share, the `ctx.containers` client wiring, and
+ * a Docker-free test double. The workerd-only `LunoraContainer` base class
+ * (which pulls in `@cloudflare/containers` → `cloudflare:workers`) lives
+ * behind the `@lunora/container/do` subpath.
+ */
+type PoolOptions, containerBindingName, containerBuildTag, containerClassName, createContainerContext, createContainerTestContext, defineContainer, isContainerDefinition, normalizeContainerImage, resolveContainerEnvVariables as resolveContainerEnvVars };