@axiom-lattice/microsandbox-service 0.0.1 → 0.0.3

package/.turbo/turbo-build.log

@@ -1,29 +1,37 @@
 
-> @axiom-lattice/microsandbox-service@0.0.1 build /home/runner/work/agentic/agentic/packages/microsandbox-service
-> tsup src/index.ts src/server.ts --format cjs,esm --dts --clean --sourcemap
+> @axiom-lattice/microsandbox-service@0.0.3 build /home/runner/work/agentic/agentic/packages/microsandbox-service
+> tsup src/index.ts src/server.ts src/cli.ts --format cjs,esm --dts --clean --sourcemap
 
-CLI Building entry: src/index.ts, src/server.ts
+CLI Building entry: src/cli.ts, src/index.ts, src/server.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.0
 CLI Target: es2020
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
+CJS dist/cli.js        25.40 KB
+CJS dist/index.js      24.26 KB
+CJS dist/server.js     25.71 KB
+CJS dist/cli.js.map    53.23 KB
+CJS dist/index.js.map  49.47 KB
+CJS dist/server.js.map 52.95 KB
+CJS ⚡️ Build success in 174ms
+ESM dist/cli.mjs                277.00 B
 ESM dist/index.mjs              206.00 B
-ESM dist/server.mjs             1.88 KB
-ESM dist/chunk-2W4CTYPX.mjs     14.49 KB
+ESM dist/server.mjs             146.00 B
+ESM dist/chunk-KRXZP6OH.mjs     1.71 KB
+ESM dist/chunk-VM3OJT5V.mjs     21.33 KB
+ESM dist/cli.mjs.map            389.00 B
 ESM dist/index.mjs.map          71.00 B
-ESM dist/server.mjs.map         4.06 KB
-ESM dist/chunk-2W4CTYPX.mjs.map 31.65 KB
-ESM ⚡️ Build success in 138ms
-CJS dist/index.js      16.81 KB
-CJS dist/server.js     18.43 KB
-CJS dist/index.js.map  32.19 KB
-CJS dist/server.js.map 35.96 KB
-CJS ⚡️ Build success in 139ms
+ESM dist/server.mjs.map         71.00 B
+ESM dist/chunk-KRXZP6OH.mjs.map 3.76 KB
+ESM dist/chunk-VM3OJT5V.mjs.map 48.91 KB
+ESM ⚡️ Build success in 177ms
 DTS Build start
-DTS ⚡️ Build success in 15934ms
-DTS dist/index.d.ts   6.30 KB
+DTS ⚡️ Build success in 21471ms
+DTS dist/cli.d.ts     20.00 B
 DTS dist/server.d.ts  281.00 B
-DTS dist/index.d.mts  6.30 KB
+DTS dist/index.d.ts   10.21 KB
+DTS dist/cli.d.mts    20.00 B
 DTS dist/server.d.mts 281.00 B
+DTS dist/index.d.mts  10.21 KB

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @axiom-lattice/microsandbox-service
 
+## 0.0.3
+
+### Patch Changes
+
+- fb974b7: fix sandbox service
+
+## 0.0.2
+
+### Patch Changes
+
+- 15808cd: update sandbox console
+
 ## 0.0.1
 
 ### Patch Changes

package/README.md

@@ -0,0 +1,130 @@
+# @axiom-lattice/microsandbox-service
+
+`@axiom-lattice/microsandbox-service` runs an HTTP service for managing microsandbox-backed sandbox lifecycle operations.
+
+This package is intended to be deployed as a long-running process. Its primary runtime entrypoint is the `lattice-microsandbox-service` CLI.
+
+## Install and Build
+
+Build the package from the monorepo root:
+
+```bash
+pnpm --filter @axiom-lattice/microsandbox-service build
+```
+
+After building, you can start the service through the package CLI or the package `start` script.
+
+## CLI Usage
+
+The package exposes this executable:
+
+```bash
+lattice-microsandbox-service
+```
+
+Supported flags:
+
+- `--host <string>`
+- `--port <number>`
+
+Example:
+
+```bash
+lattice-microsandbox-service --host 0.0.0.0 --port 4002
+```
+
+## Configuration
+
+Runtime configuration is resolved in this order:
+
+1. CLI arguments
+2. Environment variables
+3. Defaults
+
+Supported environment variables:
+
+- `HOST` default: `0.0.0.0`
+- `PORT` default: `4002`
+
+Example:
+
+```bash
+HOST=0.0.0.0 PORT=4002 lattice-microsandbox-service
+```
+
+## Startup Examples
+
+Start with CLI flags:
+
+```bash
+lattice-microsandbox-service --host 127.0.0.1 --port 4002
+```
+
+Start with environment variables:
+
+```bash
+HOST=127.0.0.1 PORT=4002 lattice-microsandbox-service
+```
+
+Start through the package script:
+
+```bash
+pnpm --filter @axiom-lattice/microsandbox-service start
+```
+
+Check service health:
+
+```bash
+curl http://127.0.0.1:4002/health
+```
+
+## Process Manager Examples
+
+### systemd
+
+```ini
+[Unit]
+Description=Axiom Lattice Microsandbox Service
+After=network.target
+
+[Service]
+ExecStart=/usr/local/bin/lattice-microsandbox-service --host 0.0.0.0 --port 4002
+Restart=on-failure
+Environment=HOST=0.0.0.0
+Environment=PORT=4002
+
+[Install]
+WantedBy=multi-user.target
+```
+
+### supervisor
+
+```ini
+[program:microsandbox-service]
+command=/usr/local/bin/lattice-microsandbox-service --host 0.0.0.0 --port 4002
+autostart=true
+autorestart=true
+environment=HOST="0.0.0.0",PORT="4002"
+```
+
+### docker
+
+```dockerfile
+CMD ["lattice-microsandbox-service", "--host", "0.0.0.0", "--port", "4002"]
+```
+
+## Local Development
+
+Run the package in watch mode from the monorepo root:
+
+```bash
+pnpm --filter @axiom-lattice/microsandbox-service dev
+```
+
+This command watches source files, rebuilds the package, and restarts the service automatically.
+
+## Operational Notes
+
+- Invalid startup configuration exits non-zero.
+- Startup failures exit non-zero.
+- `SIGINT` and `SIGTERM` trigger graceful shutdown.

package/dist/chunk-KRXZP6OH.mjs

@@ -0,0 +1,76 @@
+import {
+  buildApp
+} from "./chunk-VM3OJT5V.mjs";
+
+// src/lib/server-cli.ts
+function parsePort(raw, source) {
+  const value = Number(raw);
+  if (!Number.isInteger(value) || value <= 0) {
+    throw new Error(`Invalid value for ${source}: ${raw}`);
+  }
+  return value;
+}
+function parseServerArgs(argv) {
+  const parsed = {};
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (token === "--port") {
+      const raw = argv[index + 1];
+      if (!raw) {
+        throw new Error("Missing value for --port");
+      }
+      parsed.port = parsePort(raw, "--port");
+      index += 1;
+      continue;
+    }
+    if (token === "--host") {
+      const raw = argv[index + 1];
+      if (!raw) {
+        throw new Error("Missing value for --host");
+      }
+      parsed.host = raw;
+      index += 1;
+    }
+  }
+  return parsed;
+}
+function resolveServerConfig({
+  args,
+  env
+}) {
+  return {
+    host: args.host ?? env.HOST ?? "0.0.0.0",
+    port: args.port ?? (env.PORT ? parsePort(env.PORT, "PORT") : 4002)
+  };
+}
+
+// src/server.ts
+async function startServer({
+  argv = process.argv.slice(2),
+  env = process.env,
+  app = buildApp()
+} = {}) {
+  const config = resolveServerConfig({ args: parseServerArgs(argv), env });
+  const shutdown = async (code) => {
+    try {
+      await app.close();
+      process.exit(code);
+    } catch (error) {
+      console.error("Failed to shutdown microsandbox-service cleanly", error);
+      process.exit(1);
+    }
+  };
+  process.once("SIGINT", () => {
+    void shutdown(0);
+  });
+  process.once("SIGTERM", () => {
+    void shutdown(0);
+  });
+  await app.listen({ port: config.port, host: config.host });
+  return app;
+}
+
+export {
+  startServer
+};
+//# sourceMappingURL=chunk-KRXZP6OH.mjs.map

package/dist/chunk-KRXZP6OH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/server-cli.ts","../src/server.ts"],"sourcesContent":["export interface ParsedServerArgs {\n  host?: string;\n  port?: number;\n}\n\nexport interface ResolvedServerConfig {\n  host: string;\n  port: number;\n}\n\nfunction parsePort(raw: string, source: string): number {\n  const value = Number(raw);\n  if (!Number.isInteger(value) || value <= 0) {\n    throw new Error(`Invalid value for ${source}: ${raw}`);\n  }\n  return value;\n}\n\nexport function parseServerArgs(argv: string[]): ParsedServerArgs {\n  const parsed: ParsedServerArgs = {};\n\n  for (let index = 0; index < argv.length; index += 1) {\n    const token = argv[index];\n\n    if (token === \"--port\") {\n      const raw = argv[index + 1];\n      if (!raw) {\n        throw new Error(\"Missing value for --port\");\n      }\n      parsed.port = parsePort(raw, \"--port\");\n      index += 1;\n      continue;\n    }\n\n    if (token === \"--host\") {\n      const raw = argv[index + 1];\n      if (!raw) {\n        throw new Error(\"Missing value for --host\");\n      }\n      parsed.host = raw;\n      index += 1;\n    }\n  }\n\n  return parsed;\n}\n\nexport function resolveServerConfig({\n  args,\n  env,\n}: {\n  args: ParsedServerArgs;\n  env: NodeJS.ProcessEnv;\n}): ResolvedServerConfig {\n  return {\n    host: args.host ?? env.HOST ?? \"0.0.0.0\",\n    port: args.port ?? (env.PORT ? parsePort(env.PORT, \"PORT\") : 4002),\n  };\n}\n","import type { FastifyInstance } from \"fastify\";\nimport { buildApp } from \"./app\";\nimport { parseServerArgs, resolveServerConfig } from \"./lib/server-cli\";\n\nexport async function startServer({\n  argv = process.argv.slice(2),\n  env = process.env,\n  app = buildApp(),\n}: {\n  argv?: string[];\n  env?: NodeJS.ProcessEnv;\n  app?: Pick<FastifyInstance, \"listen\" | \"close\">;\n} = {}): Promise<Pick<FastifyInstance, \"listen\" | \"close\">> {\n  const config = resolveServerConfig({ args: parseServerArgs(argv), env });\n\n  const shutdown = async (code: number): Promise<void> => {\n    try {\n      await app.close();\n      process.exit(code);\n    } catch (error) {\n      console.error(\"Failed to shutdown microsandbox-service cleanly\", error);\n      process.exit(1);\n    }\n  };\n\n  process.once(\"SIGINT\", () => {\n    void shutdown(0);\n  });\n\n  process.once(\"SIGTERM\", () => {\n    void shutdown(0);\n  });\n\n  await app.listen({ port: config.port, host: config.host });\n  return app;\n}\n"],"mappings":";;;;;AAUA,SAAS,UAAU,KAAa,QAAwB;AACtD,QAAM,QAAQ,OAAO,GAAG;AACxB,MAAI,CAAC,OAAO,UAAU,KAAK,KAAK,SAAS,GAAG;AAC1C,UAAM,IAAI,MAAM,qBAAqB,MAAM,KAAK,GAAG,EAAE;AAAA,EACvD;AACA,SAAO;AACT;AAEO,SAAS,gBAAgB,MAAkC;AAChE,QAAM,SAA2B,CAAC;AAElC,WAAS,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,GAAG;AACnD,UAAM,QAAQ,KAAK,KAAK;AAExB,QAAI,UAAU,UAAU;AACtB,YAAM,MAAM,KAAK,QAAQ,CAAC;AAC1B,UAAI,CAAC,KAAK;AACR,cAAM,IAAI,MAAM,0BAA0B;AAAA,MAC5C;AACA,aAAO,OAAO,UAAU,KAAK,QAAQ;AACrC,eAAS;AACT;AAAA,IACF;AAEA,QAAI,UAAU,UAAU;AACtB,YAAM,MAAM,KAAK,QAAQ,CAAC;AAC1B,UAAI,CAAC,KAAK;AACR,cAAM,IAAI,MAAM,0BAA0B;AAAA,MAC5C;AACA,aAAO,OAAO;AACd,eAAS;AAAA,IACX;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AACF,GAGyB;AACvB,SAAO;AAAA,IACL,MAAM,KAAK,QAAQ,IAAI,QAAQ;AAAA,IAC/B,MAAM,KAAK,SAAS,IAAI,OAAO,UAAU,IAAI,MAAM,MAAM,IAAI;AAAA,EAC/D;AACF;;;ACtDA,eAAsB,YAAY;AAAA,EAChC,OAAO,QAAQ,KAAK,MAAM,CAAC;AAAA,EAC3B,MAAM,QAAQ;AAAA,EACd,MAAM,SAAS;AACjB,IAII,CAAC,GAAuD;AAC1D,QAAM,SAAS,oBAAoB,EAAE,MAAM,gBAAgB,IAAI,GAAG,IAAI,CAAC;AAEvE,QAAM,WAAW,OAAO,SAAgC;AACtD,QAAI;AACF,YAAM,IAAI,MAAM;AAChB,cAAQ,KAAK,IAAI;AAAA,IACnB,SAAS,OAAO;AACd,cAAQ,MAAM,mDAAmD,KAAK;AACtE,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AAEA,UAAQ,KAAK,UAAU,MAAM;AAC3B,SAAK,SAAS,CAAC;AAAA,EACjB,CAAC;AAED,UAAQ,KAAK,WAAW,MAAM;AAC5B,SAAK,SAAS,CAAC;AAAA,EACjB,CAAC;AAED,QAAM,IAAI,OAAO,EAAE,MAAM,OAAO,MAAM,MAAM,OAAO,KAAK,CAAC;AACzD,SAAO;AACT;","names":[]}