skein-js 0.3.0 → 0.4.0

package/README.md

@@ -67,8 +67,8 @@ All commands take `-c, --config <path>` (default `langgraph.json`).
 | ------------------ | -------------------- | ----------- | -------------------------------------------------------------- |
 | `-p, --port`       | number               | `2024`      | Port to listen on.                                             |
 | `--host`           | host                 | `127.0.0.1` | Interface to bind.                                             |
-| `--store <driver>` | `memory`, `postgres` | `memory`    | `postgres` reads `DATABASE_URL`; also selects `PostgresSaver`. |
-| `--queue <driver>` | `memory`, `redis`    | `memory`    | `redis` reads `REDIS_URL` (BullMQ queue + Redis Streams bus).  |
+| `--store <driver>` | `memory`, `postgres` | `memory`    | `postgres` reads `POSTGRES_URI`; also selects `PostgresSaver`. |
+| `--queue <driver>` | `memory`, `redis`    | `memory`    | `redis` reads `REDIS_URI` (BullMQ queue + Redis Streams bus).  |
 | `--no-persist`     | —                    | persists    | Don't snapshot dev state to `.skein/` across restarts.         |
 | `--no-reload`      | —                    | reloads     | Disable hot reload on source change.                           |
 | `-v, --verbose`    | —                    | off         | Log per-run activity (tool calls, interrupts, timing).         |

package/dist/index.js

@@ -137,7 +137,11 @@ async function applyProjectEnv(config, configDir) {
 
 // src/vite-graph-loader.ts
 import { createServer as createNetServer } from "net";
-import { createServer, createServerModuleRunner } from "vite";
+import {
+  createServer,
+  createServerModuleRunner,
+  searchForWorkspaceRoot
+} from "vite";
 function findFreePort() {
   return new Promise((resolve, reject) => {
     const probe = createNetServer();
@@ -150,9 +154,14 @@ function findFreePort() {
   });
 }
 async function createViteGraphLoader(root, ignored = []) {
+  const workspaceRoot = searchForWorkspaceRoot(root);
   const server = await createServer({
     root,
     configFile: false,
+    // Resolve tsconfig `paths` natively (vite 8+): vite reads the project's tsconfig, follows
+    // `extends` to a base tsconfig (e.g. `tsconfig.base.json`), and honors `baseUrl` + wildcard
+    // aliases — so graphs that import workspace packages through path aliases resolve.
+    resolve: { tsconfigPaths: true },
     appType: "custom",
     logLevel: "warn",
     server: {
@@ -162,7 +171,10 @@ async function createViteGraphLoader(root, ignored = []) {
       // "port 24678 already in use" error — when two `skein dev`s run at once. Give it an ephemeral
       // port so instances never clash.
       hmr: { port: await findFreePort() },
-      watch: { ignored: ["**/node_modules/**", "**/.git/**", "**/dist/**", ...ignored] }
+      watch: { ignored: ["**/node_modules/**", "**/.git/**", "**/dist/**", ...ignored] },
+      // Aliased lib sources resolve outside the app `root` (e.g. `../../libs/**`). Widen vite's
+      // file-serving allowlist to the workspace root so the module runner can transform them.
+      fs: { allow: [workspaceRoot] }
     },
     optimizeDeps: { noDiscovery: true }
   });
@@ -370,8 +382,8 @@ services:
       # The container CMD passes no --port; it binds $PORT (as a hosting platform would inject).
       # Set it here so the app listens on the port the mapping above publishes.
       PORT: "${options.containerPort}"
-      DATABASE_URL: postgresql://postgres:postgres@postgres:5432/skein
-      REDIS_URL: redis://redis:6379
+      POSTGRES_URI: postgresql://postgres:postgres@postgres:5432/skein
+      REDIS_URI: redis://redis:6379
     depends_on:
       postgres:
         condition: service_healthy
@@ -486,7 +498,7 @@ function generateDockerfile(options) {
     `USER node`,
     ...dockerfileLines,
     ``,
-    `# Serve the Agent Protocol against Postgres + Redis (DATABASE_URL / REDIS_URL from the environment).`,
+    `# Serve the Agent Protocol against Postgres + Redis (POSTGRES_URI / REDIS_URI from the environment).`,
     `# No --port: the server binds $PORT when the platform injects one (Railway/Fly/Render), else its`,
     `# default. Exec form keeps node as PID 1 so SIGTERM reaches skein's graceful-shutdown handler.`,
     `CMD ["npx", "skein", "dev", "--no-reload", "--no-persist", "--store", "postgres", "--queue", "redis", "--host", "0.0.0.0"]`
@@ -712,7 +724,7 @@ program.command("build").description("Build a deployable Docker image from the c
 program.command("dockerfile").description("Emit a standalone Dockerfile from the config.").option("-c, --config <path>", "Path to langgraph.json", "langgraph.json").option("-o, --output <path>", "Write the Dockerfile here instead of stdout").action((options) => runDockerfile(options));
 program.command("import-langgraph").description("Import an existing LangGraph in-memory dev state (.langgraph_api/) into skein.").option("-c, --config <path>", "Path to langgraph.json", "langgraph.json").option(
   "--store <driver>",
-  "Import target: memory (.skein/dev-state.json) | postgres (DATABASE_URL)",
+  "Import target: memory (.skein/dev-state.json) | postgres (POSTGRES_URI)",
   parseStore,
   "memory"
 ).option("--from <dir>", "Source .langgraph_api directory (defaults to alongside langgraph.json)").option("--force", "Overwrite an existing .skein/dev-state.json (memory target)", false).action((options) => runImportLanggraph(options));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skein-js",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "The skein-js CLI — a drop-in replacement for the LangGraph CLI (dev/up/build/dockerfile).",
   "license": "Apache-2.0",
   "author": "Maina Wycliffe <wmmaina7@gmail.com>",
@@ -48,10 +48,10 @@
     "@langchain/langgraph-checkpoint-postgres": "^1.0.4",
     "commander": "~13.1.0",
     "vite": "^8.1.0",
-    "@skein-js/core": "0.3.0",
-    "@skein-js/config": "0.3.0",
-    "@skein-js/express": "0.3.0",
-    "@skein-js/runtime": "0.3.0"
+    "@skein-js/core": "0.4.0",
+    "@skein-js/express": "0.4.0",
+    "@skein-js/config": "0.4.0",
+    "@skein-js/runtime": "0.4.0"
   },
   "peerDependencies": {
     "@langchain/langgraph": "^1.4.0"