@owlmeans/server-app 0.1.18-rc.33 → 0.1.18-rc.35

package/README.md

@@ -13,7 +13,7 @@ target. Do not use it in a shared `common` package that only declares protocols
 ## Installation
 
 ```bash
-bun add @owlmeans/server-app@^0.1.18-rc.33
+bun add @owlmeans/server-app@^0.1.18-rc.35
 ```
 
 ## Concepts
@@ -310,7 +310,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.28
+npx @owlmeans/agent-skills@^0.1.18-rc.31
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/server-app",
-  "version": "0.1.18-rc.33",
-  "generatedAt": "2026-09-17T08:16:11.229Z",
+  "version": "0.1.18-rc.35",
+  "generatedAt": "2026-09-21T21:54:22.961Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/server-app/SKILL.md

@@ -6,7 +6,7 @@ description: Build OwlMeans server applications from immutable entrypoint protoc
 
 # Server application entrypoints
 
-**Install:** `bun add @owlmeans/server-app@^0.1.18-rc.33`
+**Install:** `bun add @owlmeans/server-app@^0.1.18-rc.35`
 
 Declare routes and request/response contracts in a shared package with `protocol()` or
 `openProtocol()`. A server package supplies local implementations with `bind()` and `handlers()`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/server-app",
-  "version": "0.1.18-rc.33",
+  "version": "0.1.18-rc.35",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,21 +21,21 @@
     }
   },
   "dependencies": {
-    "@owlmeans/api": "^0.1.18-rc.29",
-    "@owlmeans/client-config": "^0.1.18-rc.29",
-    "@owlmeans/client-entrypoint": "^0.1.18-rc.29",
-    "@owlmeans/config": "^0.1.18-rc.29",
-    "@owlmeans/context": "^0.1.18-rc.25",
-    "@owlmeans/kluster": "^0.1.18-rc.28",
-    "@owlmeans/entrypoint": "^0.1.18-rc.28",
-    "@owlmeans/route": "^0.1.18-rc.26",
-    "@owlmeans/server-api": "^0.1.18-rc.33",
-    "@owlmeans/server-auth": "^0.1.18-rc.35",
-    "@owlmeans/server-context": "^0.1.18-rc.28",
-    "@owlmeans/server-entrypoint": "^0.1.18-rc.27",
-    "@owlmeans/server-route": "^0.1.18-rc.25",
-    "@owlmeans/server-socket": "^0.1.18-rc.35",
-    "@owlmeans/static-resource": "^0.1.18-rc.25"
+    "@owlmeans/api": "^0.1.18-rc.31",
+    "@owlmeans/client-config": "^0.1.18-rc.31",
+    "@owlmeans/client-entrypoint": "^0.1.18-rc.31",
+    "@owlmeans/config": "^0.1.18-rc.31",
+    "@owlmeans/context": "^0.1.18-rc.27",
+    "@owlmeans/kluster": "^0.1.18-rc.30",
+    "@owlmeans/entrypoint": "^0.1.18-rc.30",
+    "@owlmeans/route": "^0.1.18-rc.28",
+    "@owlmeans/server-api": "^0.1.18-rc.35",
+    "@owlmeans/server-auth": "^0.1.18-rc.37",
+    "@owlmeans/server-context": "^0.1.18-rc.30",
+    "@owlmeans/server-entrypoint": "^0.1.18-rc.29",
+    "@owlmeans/server-route": "^0.1.18-rc.27",
+    "@owlmeans/server-socket": "^0.1.18-rc.37",
+    "@owlmeans/static-resource": "^0.1.18-rc.27"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/build/boot-state.d.ts

@@ -1,55 +0,0 @@
-import type { ApiPortHoldOptions } from '@owlmeans/server-api';
-/**
- * Boot phase of the process.
- *
- * An app binds its port before it initializes, so that a failure has somewhere to be reported
- * from. Without a listener the only thing anyone sees is a connection refused at the edge — an
- * opaque 503 that names neither the app nor the cause. This phase is what the health path answers
- * with, and what the platform reads to tell "still starting" from "gave up, and here is why".
- */
-export type BootPhase = 'initializing' | 'ready' | 'failed';
-export interface BootHealth extends Record<string, unknown> {
-    status: 'OK' | 'FAILED';
-    phase: BootPhase;
-    ok: boolean;
-    /** Whatever `setBootPhase` was given — the failure message, or the step being waited on. */
-    reason?: string;
-    /**
-     * Identity, not health: a supervisor passes the id to the child it spawns and compares it
-     * here, so an answer carrying another id means the port is held by a leftover process and the
-     * health it reports describes code nobody asked for. Empty when nothing supplied one.
-     */
-    bootId: string;
-    pid: number;
-}
-/** Env var a supervisor stamps the spawned process with; surfaced as `bootId`. */
-export declare const BOOT_ID_ENV = "OWLMEANS_BOOT_ID";
-export declare const getBootPhase: () => BootPhase;
-export declare const getBootDetail: () => string | undefined;
-/**
- * `detail` is free text, and is kept for every phase — a boot that is merely slow is as worth
- * explaining as one that failed.
- */
-export declare const setBootPhase: (phase: BootPhase, detail?: string) => void;
-/**
- * The body the health path answers with, from either server.
- *
- * The port hold and the app's own handler both build it here, so a consumer polling through the
- * handover never sees the shape change under it — which is why the keys are unconditional and
- * only `reason` comes and goes with the state it describes.
- */
-export declare const bootHealthPayload: () => BootHealth;
-/**
- * Hold options wired to this module — the bind-first boot in one line:
- *
- *     const hold = await holdApiPort(ctx.cfg, bootHold(HEALTH_PATH))
- *     try { await init() } catch (e) { setBootPhase('failed', message); return }
- *     await hold.release()
- *     setBootPhase('ready')
- *     await ctx.getApiServer().listen()
- *
- * The hold evaluates `payload` per request, so the phase set after a failure is reported live by
- * the listener that is already bound rather than needing a server that will never start.
- */
-export declare const bootHold: (okPath?: string) => ApiPortHoldOptions;
-//# sourceMappingURL=boot-state.d.ts.map

package/build/boot-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"boot-state.d.ts","sourceRoot":"","sources":["../src/boot-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE3D,MAAM,WAAW,UAAW,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAA;IACvB,KAAK,EAAE,SAAS,CAAA;IAChB,EAAE,EAAE,OAAO,CAAA;IACX,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,kFAAkF;AAClF,eAAO,MAAM,WAAW,qBAAqB,CAAA;AAK7C,eAAO,MAAM,YAAY,QAAO,SAAmB,CAAA;AAEnD,eAAO,MAAM,aAAa,QAAO,MAAM,GAAG,SAAoB,CAAA;AAE9D;;;GAGG;AACH,eAAO,MAAM,YAAY,UAAW,SAAS,WAAW,MAAM,KAAG,IAGhE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,QAAO,UAOnC,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,YAAa,MAAM,KAAG,kBAGzC,CAAA"}

package/build/boot-state.js

@@ -1,46 +0,0 @@
-/** Env var a supervisor stamps the spawned process with; surfaced as `bootId`. */
-export const BOOT_ID_ENV = 'OWLMEANS_BOOT_ID';
-let _phase = 'initializing';
-let _detail;
-export const getBootPhase = () => _phase;
-export const getBootDetail = () => _detail;
-/**
- * `detail` is free text, and is kept for every phase — a boot that is merely slow is as worth
- * explaining as one that failed.
- */
-export const setBootPhase = (phase, detail) => {
-    _phase = phase;
-    _detail = detail;
-};
-/**
- * The body the health path answers with, from either server.
- *
- * The port hold and the app's own handler both build it here, so a consumer polling through the
- * handover never sees the shape change under it — which is why the keys are unconditional and
- * only `reason` comes and goes with the state it describes.
- */
-export const bootHealthPayload = () => ({
-    status: _phase === 'failed' ? 'FAILED' : 'OK',
-    phase: _phase,
-    ok: _phase === 'ready',
-    ...(_detail != null ? { reason: _detail } : {}),
-    bootId: process.env[BOOT_ID_ENV] ?? '',
-    pid: process.pid
-});
-/**
- * Hold options wired to this module — the bind-first boot in one line:
- *
- *     const hold = await holdApiPort(ctx.cfg, bootHold(HEALTH_PATH))
- *     try { await init() } catch (e) { setBootPhase('failed', message); return }
- *     await hold.release()
- *     setBootPhase('ready')
- *     await ctx.getApiServer().listen()
- *
- * The hold evaluates `payload` per request, so the phase set after a failure is reported live by
- * the listener that is already bound rather than needing a server that will never start.
- */
-export const bootHold = (okPath) => ({
-    ...(okPath != null ? { okPath } : {}),
-    payload: bootHealthPayload
-});
-//# sourceMappingURL=boot-state.js.map

package/build/boot-state.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"boot-state.js","sourceRoot":"","sources":["../src/boot-state.ts"],"names":[],"mappings":"AA2BA,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAA;AAE7C,IAAI,MAAM,GAAc,cAAc,CAAA;AACtC,IAAI,OAA2B,CAAA;AAE/B,MAAM,CAAC,MAAM,YAAY,GAAG,GAAc,EAAE,CAAC,MAAM,CAAA;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG,GAAuB,EAAE,CAAC,OAAO,CAAA;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAgB,EAAE,MAAe,EAAQ,EAAE;IACtE,MAAM,GAAG,KAAK,CAAA;IACd,OAAO,GAAG,MAAM,CAAA;AAClB,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAe,EAAE,CAAC,CAAC;IAClD,MAAM,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;IAC7C,KAAK,EAAE,MAAM;IACb,EAAE,EAAE,MAAM,KAAK,OAAO;IACtB,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,OAAO,CAAC,GAAG;CACjB,CAAC,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAe,EAAsB,EAAE,CAAC,CAAC;IAChE,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrC,OAAO,EAAE,iBAAiB;CAC3B,CAAC,CAAA"}