@gencode/server 0.3.7 → 0.3.8

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @gencode/server
 
+## 0.3.8
+
+### Patch Changes
+
+- c96335b: Container prestart deployments can now preload system plugins before the real user request arrives. Start `aimax-server` with `--plugins-config /path/to/plugins.json` or `AIMAX_SERVER_PLUGINS_CONFIG=/path/to/plugins.json`; the server reads that file during warmup and preloads the configured plugins. If a `/run` request does not provide its own `run.pluginsConfig` and does not override `AIMAX_PLUGINS_CONFIG` in request `env`, the run automatically inherits the startup plugins config path, so the CLI execution reuses the preloaded plugin registry. Plugin runtime values such as session env and LLM access remain bound to the actual run request.
+- Updated dependencies [c96335b]
+  - @gencode/agents@0.16.4
+  - @gencode/cli@0.14.5
+
 ## 0.3.7
 
 ### Patch Changes

package/README.md

@@ -5,3 +5,15 @@ One-shot AIMax container prestart server.
 This package starts a local HTTP process that warms system-level runtime state,
 accepts exactly one `/run` request, delegates execution to `@gencode/cli`, and
 exits when the agent loop finishes.
+
+## Usage
+
+```bash
+aimax-server --host 127.0.0.1 --port 0 --plugins-config /image/aimax/plugins.json
+```
+
+`--plugins-config` can also be supplied as `AIMAX_SERVER_PLUGINS_CONFIG`. The
+server reads that file during warmup and preloads the configured system plugins.
+If the accepted `/run` request does not provide `run.pluginsConfig` and does not
+override `AIMAX_PLUGINS_CONFIG` in request `env`, the run inherits the startup
+plugins config path so the CLI execution uses the preloaded plugin registry.

package/dist/bin.js

@@ -1,12 +1,13 @@
 #!/usr/bin/env node
-import{t as e}from"./server-BMS-TOVR.js";function t(e){let t=!1;return()=>{t||(t=!0,n(e))}}async function n(e){let t=e.exit??(e=>process.exit(e)),n=e.onLog??(()=>void 0),a=e.graceMs??3e4,o=e.server.getStatus();if(!r(o)){await e.server.stop().catch(e=>{n(`server shutdown stop failed`,{error:String(e),status:o})}),t(0);return}n(`server shutdown signal received; waiting for active run`,{status:o,graceMs:a}),await e.server.stop().catch(e=>{n(`server shutdown stop failed`,{error:String(e),status:o})});let s=await i(e.server.done,a);if(s.timedOut){n(`server shutdown grace period elapsed before run finished`,{status:o,graceMs:a}),t(1);return}n(`server shutdown completed after active run finished`,{status:o,exitCode:s.exitCode}),t(s.exitCode)}function r(e){return e===`running`||e===`draining`}async function i(e,t){let n,r=new Promise(e=>{n=setTimeout(()=>e({timedOut:!0}),t),n.unref?.()});try{return await Promise.race([e.then(e=>({timedOut:!1,exitCode:e.exitCode})),r])}finally{n&&clearTimeout(n)}}function a(e){let t={};for(let n=0;n<e.length;n+=1){let r=e[n];if(r===`--host`){t.host=e[++n];continue}if(r===`--port`){t.port=o(e[++n],`--port`);continue}if(r===`--request-timeout-ms`){t.requestTimeoutMs=s(e[++n],`--request-timeout-ms`);continue}if(r===`--shutdown-grace-ms`){t.shutdownGraceMs=s(e[++n],`--shutdown-grace-ms`);continue}throw(r===`--help`||r===`-h`)&&(c(),process.exit(0)),Error(`Unknown option: ${r}`)}return t}function o(e,t){let n=s(e,t);if(n>65535)throw Error(`Invalid ${t}: ${e}. Must be between 0 and 65535.`);return n}function s(e,t){if(e===void 0||e.trim()===``)throw Error(`Missing value for ${t}`);let n=Number(e);if(!Number.isInteger(n)||n<0)throw Error(`Invalid ${t}: ${e}. Must be a non-negative integer.`);return n}function c(){process.stdout.write(`AIMax one-shot prestart server
+import{t as e}from"./server-BWdQz0S2.js";function t(e){let t=!1;return()=>{t||(t=!0,n(e))}}async function n(e){let t=e.exit??(e=>process.exit(e)),n=e.onLog??(()=>void 0),a=e.graceMs??3e4,o=e.server.getStatus();if(!r(o)){await e.server.stop().catch(e=>{n(`server shutdown stop failed`,{error:String(e),status:o})}),t(0);return}n(`server shutdown signal received; waiting for active run`,{status:o,graceMs:a}),await e.server.stop().catch(e=>{n(`server shutdown stop failed`,{error:String(e),status:o})});let s=await i(e.server.done,a);if(s.timedOut){n(`server shutdown grace period elapsed before run finished`,{status:o,graceMs:a}),t(1);return}n(`server shutdown completed after active run finished`,{status:o,exitCode:s.exitCode}),t(s.exitCode)}function r(e){return e===`running`||e===`draining`}async function i(e,t){let n,r=new Promise(e=>{n=setTimeout(()=>e({timedOut:!0}),t),n.unref?.()});try{return await Promise.race([e.then(e=>({timedOut:!1,exitCode:e.exitCode})),r])}finally{n&&clearTimeout(n)}}function a(e){let t={};for(let n=0;n<e.length;n+=1){let r=e[n];if(r===`--host`){t.host=e[++n];continue}if(r===`--port`){t.port=o(e[++n],`--port`);continue}if(r===`--plugins-config`){t.pluginsConfig=s(e[++n],`--plugins-config`);continue}if(r===`--request-timeout-ms`){t.requestTimeoutMs=c(e[++n],`--request-timeout-ms`);continue}if(r===`--shutdown-grace-ms`){t.shutdownGraceMs=c(e[++n],`--shutdown-grace-ms`);continue}throw(r===`--help`||r===`-h`)&&(l(),process.exit(0)),Error(`Unknown option: ${r}`)}return t}function o(e,t){let n=c(e,t);if(n>65535)throw Error(`Invalid ${t}: ${e}. Must be between 0 and 65535.`);return n}function s(e,t){if(e===void 0||e.trim()===``)throw Error(`Missing value for ${t}`);return e}function c(e,t){if(e===void 0||e.trim()===``)throw Error(`Missing value for ${t}`);let n=Number(e);if(!Number.isInteger(n)||n<0)throw Error(`Invalid ${t}: ${e}. Must be a non-negative integer.`);return n}function l(){process.stdout.write(`AIMax one-shot prestart server
 
 Usage:
-  aimax-server [--host 127.0.0.1] [--port 0] [--request-timeout-ms 60000] [--shutdown-grace-ms 30000]
+  aimax-server [--host 127.0.0.1] [--port 0] [--plugins-config /image/plugins.json] [--request-timeout-ms 60000] [--shutdown-grace-ms 30000]
 
 Environment:
   AIMAX_SERVER_HOST
   AIMAX_SERVER_PORT
+  AIMAX_SERVER_PLUGINS_CONFIG
   AIMAX_SERVER_REQUEST_TIMEOUT_MS
   AIMAX_SERVER_SHUTDOWN_GRACE_MS
-`)}async function l(){let n=a(process.argv.slice(2)),r=e({host:n.host??process.env.AIMAX_SERVER_HOST,port:n.port??(process.env.AIMAX_SERVER_PORT?o(process.env.AIMAX_SERVER_PORT,`AIMAX_SERVER_PORT`):void 0),requestTimeoutMs:n.requestTimeoutMs??(process.env.AIMAX_SERVER_REQUEST_TIMEOUT_MS?s(process.env.AIMAX_SERVER_REQUEST_TIMEOUT_MS,`AIMAX_SERVER_REQUEST_TIMEOUT_MS`):void 0),onLog:(e,t)=>{process.stderr.write(`${JSON.stringify({level:`info`,message:e,...t})}\n`)}}),i=t({server:r,graceMs:n.shutdownGraceMs??(process.env.AIMAX_SERVER_SHUTDOWN_GRACE_MS?s(process.env.AIMAX_SERVER_SHUTDOWN_GRACE_MS,`AIMAX_SERVER_SHUTDOWN_GRACE_MS`):void 0),onLog:(e,t)=>{process.stderr.write(`${JSON.stringify({level:`info`,message:e,...t})}\n`)}});process.once(`SIGTERM`,i),process.once(`SIGINT`,i),await r.start(),process.stdout.write(`${JSON.stringify({type:`aimax_server_ready`,url:r.getUrl(),status:r.getStatus()})}\n`);let c=await r.done;process.exit(c.exitCode)}l().catch(e=>{process.stderr.write(`${JSON.stringify({level:`error`,message:e.message})}\n`),process.exit(1)});export{};
+`)}async function u(){let n=a(process.argv.slice(2)),r=e({host:n.host??process.env.AIMAX_SERVER_HOST,port:n.port??(process.env.AIMAX_SERVER_PORT?o(process.env.AIMAX_SERVER_PORT,`AIMAX_SERVER_PORT`):void 0),pluginsConfig:n.pluginsConfig??process.env.AIMAX_SERVER_PLUGINS_CONFIG,requestTimeoutMs:n.requestTimeoutMs??(process.env.AIMAX_SERVER_REQUEST_TIMEOUT_MS?c(process.env.AIMAX_SERVER_REQUEST_TIMEOUT_MS,`AIMAX_SERVER_REQUEST_TIMEOUT_MS`):void 0),onLog:(e,t)=>{process.stderr.write(`${JSON.stringify({level:`info`,message:e,...t})}\n`)}}),i=t({server:r,graceMs:n.shutdownGraceMs??(process.env.AIMAX_SERVER_SHUTDOWN_GRACE_MS?c(process.env.AIMAX_SERVER_SHUTDOWN_GRACE_MS,`AIMAX_SERVER_SHUTDOWN_GRACE_MS`):void 0),onLog:(e,t)=>{process.stderr.write(`${JSON.stringify({level:`info`,message:e,...t})}\n`)}});process.once(`SIGTERM`,i),process.once(`SIGINT`,i),await r.start(),process.stdout.write(`${JSON.stringify({type:`aimax_server_ready`,url:r.getUrl(),status:r.getStatus()})}\n`);let s=await r.done;process.exit(s.exitCode)}u().catch(e=>{process.stderr.write(`${JSON.stringify({level:`error`,message:e.message})}\n`),process.exit(1)});export{};

package/dist/index.d.ts

@@ -15,12 +15,16 @@ type SystemWarmState = {
 type AimaxServerOptions = {
   host?: string;
   port?: number;
+  pluginsConfig?: string;
   maxBodyBytes?: number;
   requestTimeoutMs?: number;
   executeRun?: (options: ServerRunOptions) => Promise<void>;
-  prepareSystemRuntime?: () => SystemWarmState | Promise<SystemWarmState>;
+  prepareSystemRuntime?: (options?: ServerWarmupOptions) => SystemWarmState | Promise<SystemWarmState>;
   onLog?: (message: string, details?: Record<string, unknown>) => void;
 };
+type ServerWarmupOptions = {
+  pluginsConfig?: unknown;
+};
 type AimaxServerHandle = {
   start: () => Promise<void>;
   stop: () => Promise<void>;

package/dist/index.js

@@ -1 +1 @@
-import{t as e}from"./server-BMS-TOVR.js";export{e as createAimaxServer};
+import{t as e}from"./server-BWdQz0S2.js";export{e as createAimaxServer};

package/dist/server-BWdQz0S2.js

@@ -0,0 +1 @@
+import e from"node:http";import t from"node:fs/promises";function n(t={}){let n=t.host??`127.0.0.1`,a=t.port??0,u=t.maxBodyBytes??1048576,p=t.executeRun??s,m=t.prepareSystemRuntime??c,h=t.onLog??(()=>void 0),g=t.pluginsConfig,_=`starting`,v,y,b=null,x=!1,S=()=>void 0,C=new Promise(e=>{S=e});function w(e){x||(x=!0,S(e))}function T(e){_=e,h(`server status changed`,{status:e})}async function E(){let e=b;b=null,!(!e||!e.listening)&&await new Promise((t,n)=>{e.close(e=>{e?n(e):t()})})}async function D(e,t){if(_===`starting`||_===`warming`){f(t,503,{status:_,error:`server is not ready`});return}if(_!==`ready`&&_!==`ready_degraded`){f(t,409,{status:_,error:`server already accepted a run`});return}let n;try{n=i(await d(e,u))}catch(e){f(t,400,{status:_,error:e.message});return}T(`running`),E().catch(e=>{h(`failed to close listener after accepting run`,{error:String(e)})}),f(t,202,{status:_,accepted:!0}),O(n)}async function O(e){let t=0;try{let n=r(e.run,e.env,y);await o(e.env,()=>p(n)),typeof process.exitCode==`number`&&process.exitCode!==0&&(t=process.exitCode),T(`draining`)}catch(e){t=1,h(`run failed`,{error:String(e)}),T(`draining`)}finally{await E().catch(e=>{h(`failed to stop server during drain`,{error:String(e)})}),T(`exiting`),w({exitCode:t})}}async function k(e,t){let r=new URL(e.url??`/`,`http://${n}`);if(e.method===`GET`&&r.pathname===`/healthz`){f(t,200,{status:_});return}if(e.method===`GET`&&r.pathname===`/readyz`){let e=_===`ready`||_===`ready_degraded`;f(t,e?200:503,{status:_,ready:e,degraded:_===`ready_degraded`,warmupError:v});return}if(e.method===`POST`&&r.pathname===`/run`){await D(e,t);return}f(t,404,{status:_,error:`not found`})}async function A(){if(!b){T(`warming`),b=e.createServer((e,t)=>{k(e,t).catch(e=>{f(t,500,{status:_,error:String(e)})})}),await new Promise((e,t)=>{b.once(`error`,t),b.listen(a,n,()=>{b.off(`error`,t),e()})});try{let e=g?await l(g):void 0;e!==void 0&&(y=g),await m({pluginsConfig:e}),_===`warming`&&T(`ready`)}catch(e){v=String(e),h(`system warmup failed; continuing with cold run path`,{error:v}),_===`warming`&&T(`ready_degraded`)}t.requestTimeoutMs&&t.requestTimeoutMs>0&&setTimeout(()=>{(_===`ready`||_===`ready_degraded`)&&E().finally(()=>{T(`exiting`),w({exitCode:1})})},t.requestTimeoutMs).unref()}}function j(){if(!b?.listening)return``;let e=b.address();return`http://${e.address}:${e.port}`}return{start:A,stop:E,done:C,getStatus:()=>_,getUrl:j}}function r(e,t,n){return!n||Object.prototype.hasOwnProperty.call(e,`pluginsConfig`)||t&&Object.prototype.hasOwnProperty.call(t,`AIMAX_PLUGINS_CONFIG`)?e:{...e,pluginsConfig:n}}function i(e){if(!e||typeof e!=`object`)throw Error(`request body must be an object`);let t=e.env;t!==void 0&&a(t);let n=e.run;if(!n||typeof n!=`object`||Array.isArray(n))throw Error(`request body must include run options`);return{env:t,run:n}}function a(e){if(!e||typeof e!=`object`||Array.isArray(e))throw Error(`request env must be an object when provided`);for(let[t,n]of Object.entries(e)){if(!t||t.includes(`=`))throw Error(`request env contains invalid key: ${t}`);if(n!==null&&typeof n!=`string`&&typeof n!=`number`&&typeof n!=`boolean`)throw Error(`request env value for ${t} must be string, number, boolean, or null`)}}async function o(e,t){if(!e||Object.keys(e).length===0)return t();let n=new Map;for(let[t,r]of Object.entries(e))n.set(t,process.env[t]),r===null?delete process.env[t]:process.env[t]=String(r);try{return await t()}finally{for(let[e,t]of n)t===void 0?delete process.env[e]:process.env[e]=t}}async function s(e){await(await u(`@gencode/cli`)).executeRun(e)}async function c(e={}){return(await u(`@gencode/agents/system-runtime`)).prepareSystemRuntime({config:e.pluginsConfig})}async function l(e){let n=await t.readFile(e,`utf-8`);return JSON.parse(n)}const u=Function(`specifier`,`return import(specifier)`);async function d(e,t){let n=[],r=0;for await(let i of e){let e=Buffer.isBuffer(i)?i:Buffer.from(i);if(r+=e.byteLength,r>t)throw Error(`request body is too large`);n.push(e)}let i=Buffer.concat(n).toString(`utf-8`);if(!i.trim())throw Error(`request body must not be empty`);try{return JSON.parse(i)}catch{throw Error(`request body must be valid JSON`)}}function f(e,t,n){e.headersSent||(e.writeHead(t,{"content-type":`application/json; charset=utf-8`}),e.end(`${JSON.stringify(n)}\n`))}export{n as t};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gencode/server",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "type": "module",
   "bin": {
     "aimax-server": "./dist/bin.js"
@@ -19,8 +19,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@gencode/agents": "0.16.3",
-    "@gencode/cli": "0.14.4"
+    "@gencode/agents": "0.16.4",
+    "@gencode/cli": "0.14.5"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/dist/server-BMS-TOVR.js

@@ -1 +0,0 @@
-import e from"node:http";function t(t={}){let r=t.host??`127.0.0.1`,s=t.port??0,u=t.maxBodyBytes??1048576,d=t.executeRun??a,f=t.prepareSystemRuntime??o,p=t.onLog??(()=>void 0),m=`starting`,h,g=null,_=!1,v=()=>void 0,y=new Promise(e=>{v=e});function b(e){_||(_=!0,v(e))}function x(e){m=e,p(`server status changed`,{status:e})}async function S(){let e=g;g=null,!(!e||!e.listening)&&await new Promise((t,n)=>{e.close(e=>{e?n(e):t()})})}async function C(e,t){if(m===`starting`||m===`warming`){l(t,503,{status:m,error:`server is not ready`});return}if(m!==`ready`&&m!==`ready_degraded`){l(t,409,{status:m,error:`server already accepted a run`});return}let r;try{r=n(await c(e,u))}catch(e){l(t,400,{status:m,error:e.message});return}x(`running`),S().catch(e=>{p(`failed to close listener after accepting run`,{error:String(e)})}),l(t,202,{status:m,accepted:!0}),w(r)}async function w(e){let t=0;try{await i(e.env,()=>d(e.run)),typeof process.exitCode==`number`&&process.exitCode!==0&&(t=process.exitCode),x(`draining`)}catch(e){t=1,p(`run failed`,{error:String(e)}),x(`draining`)}finally{await S().catch(e=>{p(`failed to stop server during drain`,{error:String(e)})}),x(`exiting`),b({exitCode:t})}}async function T(e,t){let n=new URL(e.url??`/`,`http://${r}`);if(e.method===`GET`&&n.pathname===`/healthz`){l(t,200,{status:m});return}if(e.method===`GET`&&n.pathname===`/readyz`){let e=m===`ready`||m===`ready_degraded`;l(t,e?200:503,{status:m,ready:e,degraded:m===`ready_degraded`,warmupError:h});return}if(e.method===`POST`&&n.pathname===`/run`){await C(e,t);return}l(t,404,{status:m,error:`not found`})}async function E(){if(!g){x(`warming`),g=e.createServer((e,t)=>{T(e,t).catch(e=>{l(t,500,{status:m,error:String(e)})})}),await new Promise((e,t)=>{g.once(`error`,t),g.listen(s,r,()=>{g.off(`error`,t),e()})});try{await f(),m===`warming`&&x(`ready`)}catch(e){h=String(e),p(`system warmup failed; continuing with cold run path`,{error:h}),m===`warming`&&x(`ready_degraded`)}t.requestTimeoutMs&&t.requestTimeoutMs>0&&setTimeout(()=>{(m===`ready`||m===`ready_degraded`)&&S().finally(()=>{x(`exiting`),b({exitCode:1})})},t.requestTimeoutMs).unref()}}function D(){if(!g?.listening)return``;let e=g.address();return`http://${e.address}:${e.port}`}return{start:E,stop:S,done:y,getStatus:()=>m,getUrl:D}}function n(e){if(!e||typeof e!=`object`)throw Error(`request body must be an object`);let t=e.env;t!==void 0&&r(t);let n=e.run;if(!n||typeof n!=`object`||Array.isArray(n))throw Error(`request body must include run options`);return{env:t,run:n}}function r(e){if(!e||typeof e!=`object`||Array.isArray(e))throw Error(`request env must be an object when provided`);for(let[t,n]of Object.entries(e)){if(!t||t.includes(`=`))throw Error(`request env contains invalid key: ${t}`);if(n!==null&&typeof n!=`string`&&typeof n!=`number`&&typeof n!=`boolean`)throw Error(`request env value for ${t} must be string, number, boolean, or null`)}}async function i(e,t){if(!e||Object.keys(e).length===0)return t();let n=new Map;for(let[t,r]of Object.entries(e))n.set(t,process.env[t]),r===null?delete process.env[t]:process.env[t]=String(r);try{return await t()}finally{for(let[e,t]of n)t===void 0?delete process.env[e]:process.env[e]=t}}async function a(e){await(await s(`@gencode/cli`)).executeRun(e)}async function o(){return(await s(`@gencode/agents/system-runtime`)).prepareSystemRuntime()}const s=Function(`specifier`,`return import(specifier)`);async function c(e,t){let n=[],r=0;for await(let i of e){let e=Buffer.isBuffer(i)?i:Buffer.from(i);if(r+=e.byteLength,r>t)throw Error(`request body is too large`);n.push(e)}let i=Buffer.concat(n).toString(`utf-8`);if(!i.trim())throw Error(`request body must not be empty`);try{return JSON.parse(i)}catch{throw Error(`request body must be valid JSON`)}}function l(e,t,n){e.headersSent||(e.writeHead(t,{"content-type":`application/json; charset=utf-8`}),e.end(`${JSON.stringify(n)}\n`))}export{t};