@wenathlan/saddle 2.1.7 → 2.1.8

package/modes.ts

@@ -0,0 +1,151 @@
+/**
+ * modes.ts — target mode resolution and host-neutral deployment contracts.
+ *
+ * This file is the v2.0.0 grand-merge consolidation of the former nested
+ * folders of the repository (modes) into the single
+ * root-level domain file of the saddle family standard: one optimized
+ * TypeScript file per correlated domain, ordinal sections, JSDoc on every
+ * block, intra-domain imports dissolved, cross-domain imports rewritten to
+ * ./<domain>.js. Every capability of every source file is preserved here;
+ * the pure re-export barrels (none in this domain) folded their surface into this file directly.
+ */
+
+
+
+/* ════════════════════════════════════════════════════════════════════ */
+/* Section 1: modes/modes.ts — mode profiles describe paired operation surfaces without changing engine contracts. */
+/* ════════════════════════════════════════════════════════════════════ */
+/**
+ * mode profiles describe paired operation surfaces without changing engine contracts.
+ */
+const names = ["computer", "library", "application", "browser", "desktop", "mobile", "extension", "cli", "binary", "internet", "physicalfile", "vectorfile", "visible", "headless"];
+
+export function modeprofile(options = {}) {
+  const enabled = new Set(options.enabled ?? ["library", "cli", "binary"]);
+  return Object.fromEntries(names.map((name) => [name, { name, enabled: enabled.has(name), paired: Boolean(options.paired?.includes(name)) }]));
+}
+
+export function librarymode(factory) { return { name: "library", start: factory, stop: async () => undefined }; }
+export function climode(run) { return { name: "cli", run }; }
+export function binarymode(run) { return { name: "binary", run }; }
+export function browsermode(adapter) { return { name: "browser", adapter }; }
+export function headlessmode(adapter) { return { name: "headless", adapter }; }
+export function computemode(adapter) { return { name: "computer", adapter }; }
+
+/* ════════════════════════════════════════════════════════════════════ */
+/* Section 2: modes/matrix.ts — mode matrix keeps supported execution choices in one grouped contract. */
+/* ════════════════════════════════════════════════════════════════════ */
+/**
+ * mode matrix keeps supported execution choices in one grouped contract.
+ */
+export const modeaxes = Object.freeze({
+  execution: ["library", "application", "browser", "desktopapp", "mobileapp", "extension", "cli", "binary", "computer", "internet"],
+  runtime: ["node", "browser", "deno", "bun", "worker", "unknown"],
+  memory: ["internal", "external", "physical", "vectorized", "library"],
+  file: ["internal", "external", "physical", "vector"],
+  dependency: ["internal", "external", "dev"],
+  visibility: ["visible", "headless"],
+  pair: ["without", "with"]
+});
+
+export const operationmodes = Object.freeze(modeaxes.execution.flatMap((execution) => modeaxes.pair.map((pair) => `${execution}${pair}`)));
+
+/** Returns true when the matrix contains the requested axis value. */
+export function validatemode(axis, value) { return Boolean(modeaxes[axis]?.includes(value)); }
+
+/** Returns a serializable snapshot for documentation and diagnostics. */
+export function modecatalog() { return { axes: Object.fromEntries(Object.entries(modeaxes).map(([key, values]) => [key, [...values]])), operationmodes: [...operationmodes] }; }
+
+/* ════════════════════════════════════════════════════════════════════ */
+/* Section 3: modes/resolve.ts — mode resolver selects open defaults while preserving every caller choice. */
+/* ════════════════════════════════════════════════════════════════════ */
+/**
+ * mode resolver selects open defaults while preserving every caller choice.
+ */
+
+/** Resolves an execution profile without starting a process or opening a socket. */
+export function resolvemode(options = {}) {
+  const profile = {
+    execution: options.execution ?? "library",
+    runtime: options.runtime ?? "unknown",
+    memory: options.memory ?? "internal",
+    file: options.file ?? "internal",
+    dependency: options.dependency ?? "internal",
+    visibility: options.visibility ?? "headless",
+    pair: options.pair ?? "without"
+  };
+  for (const [axis, value] of Object.entries(profile)) if (!validatemode(axis, value)) throw new TypeError(`unsupported mode ${axis}:${value}`);
+  return { ...profile, capabilities: modecapabilities(profile) };
+}
+
+/** Returns stable capabilities for adapters and diagnostics. */
+export function modecapabilities(profile) {
+  return {
+    library: profile.execution === "library" || profile.execution === "application",
+    browser: profile.execution === "browser" || profile.execution === "extension" || profile.runtime === "browser" || profile.runtime === "worker",
+    cli: profile.execution === "cli" || profile.execution === "binary",
+    physicalmemory: profile.memory === "physical",
+    vectorizedmemory: profile.memory === "vectorized",
+    externalmemory: profile.memory === "external",
+    externalfile: profile.file === "external",
+    externaldependency: profile.dependency === "external",
+    visible: profile.visibility === "visible"
+  };
+}
+
+/** Returns a stable cross-runtime capability report without starting infrastructure. */
+export function capabilityreport(options = {}) {
+  const overrides = { runtime: options.runtime ?? "unknown", memory: options.memory ?? "internal", file: options.file ?? "internal", dependency: options.dependency ?? "internal", visibility: options.visibility ?? "headless", pair: options.pair ?? "without" };
+  const profiles = modeaxes.execution.map((execution) => {
+    const profile = resolvemode({ ...overrides, execution });
+    return { mode: execution, capabilities: profile.capabilities, profile };
+  });
+  return { version: 1, axes: Object.fromEntries(Object.entries(modeaxes).map(([key, values]) => [key, [...values]])), overrides, profiles, infrastructure: { host: "caller-owned", port: "caller-owned", credentials: "caller-owned", provider: "caller-owned" } };
+}
+
+/** Applies one profile to a caller supplied operation. */
+export async function withmode(options, operation) { if (typeof operation !== "function") throw new TypeError("mode operation is required"); return operation(resolvemode(options)); }
+
+
+/* ════════════════════════════════════════════════════════════════════ */
+/* Section 4: modes/deploy.ts — deploy surface exposes artifact planning without performing provider mutations. */
+/* ════════════════════════════════════════════════════════════════════ */
+/**
+ * deploy surface exposes artifact planning without performing provider mutations.
+ */
+export { publishplan, registrymanifest } from "./distribution.ts";
+/* the packaging surface pair (surfacemanifest, surfacebundle) moved to
+ * devthink with the automation domain (the saddle ownership law, wave a,
+ * actions 108-112 — the deploy surface keeps the artifact planning pair
+ * the engine owns). */
+
+/* ════════════════════════════════════════════════════════════════════ */
+/* Section 5: modes/targets.ts — target profiles keep platform packaging open and describe capability boundaries. */
+/* ════════════════════════════════════════════════════════════════════ */
+/**
+ * target profiles keep platform packaging open and describe capability boundaries.
+ */
+export const targetprofiles = Object.freeze({
+  application: { runtime: "caller", entry: "distpackage/index.js", capabilities: ["memory", "storage", "network"], formats: ["zip", "tarball"] },
+  computer: { runtime: "node", entry: "distpackage/index.js", capabilities: ["memory", "storage", "runner"], formats: ["node", "bun", "deno", "singlefile"] },
+  desktopapp: { runtime: "tauri", entry: "desktop/src-tauri", capabilities: ["memory", "file", "visible"], formats: ["appimage", "deb", "rpm", "snap", "flatpak", "dmg", "pkg", "exe", "msi", "msix"] },
+  mobileapp: { runtime: "capacitor", entry: "index.html", capabilities: ["memory", "network", "visible"], formats: ["apk", "aab", "ipa"] },
+  android: { runtime: "capacitor", entry: "android", capabilities: ["memory", "network", "visible"], formats: ["apk", "aab"] },
+  ios: { runtime: "capacitor", entry: "ios", capabilities: ["memory", "network", "visible"], formats: ["ipa"] },
+  cli: { runtime: "node", entry: "distpackage/cli/main.js", capabilities: ["memory", "storage", "network"], formats: ["node", "bun", "deno", "singlefile", "exe", "deb", "rpm"] },
+  binary: { runtime: "caller", entry: "distpackage/cli/main.js", capabilities: ["memory", "storage", "runner"], formats: ["sea", "singlefile", "wasm"] },
+  browser: { runtime: "tauri", entry: "desktop/src-tauri", capabilities: ["memory", "network", "visible"], formats: ["html", "pwa", "wasm", "appimage", "deb", "rpm", "dmg", "exe", "msi"] },
+  extension: { runtime: "browser", entry: "distpackage/extension/index.js", capabilities: ["browser", "network", "visible"], formats: ["crx", "xpi", "safariextz"] },
+  internet: { runtime: "caller", entry: "distpackage/index.js", capabilities: ["network", "webhook", "api"], formats: ["http", "websocket", "grpc", "rest"] },
+  web: { runtime: "browser", entry: "index.html", capabilities: ["network", "visible"], formats: ["html", "pwa", "ssg", "ssr", "wasm"] },
+  libreoffice: { runtime: "caller", entry: "distpackage/index.js", capabilities: ["file", "network"], formats: ["oxt", "zip"] },
+  mcp: { runtime: "caller", entry: "distpackage/adapters/mcpserver.js", capabilities: ["network", "api"], formats: ["stdio", "jsonrpc"] },
+  vsix: { runtime: "caller", entry: "distpackage/index.js", capabilities: ["network", "visible"], formats: ["vsix"] },
+  container: { runtime: "node", entry: "distpackage/index.js", capabilities: ["memory", "storage", "network"], formats: ["oci", "docker"] }
+});
+
+/** Creates a surface target with caller supplied entry and capabilities. */
+export function targetmanifest(target, options = {}) { const profile = targetprofiles[target]; if (!profile) throw new TypeError(`unsupported target: ${target}`); return { target, runtime: options.runtime ?? profile.runtime, entry: options.entry ?? profile.entry, formats: options.formats ?? [...profile.formats], capabilities: options.capabilities ?? [...profile.capabilities], permissions: options.permissions ?? [], metadata: options.metadata ?? {} }; }
+
+/** Returns all supported target profiles for documentation and tooling. */
+export function targetcatalog() { return Object.fromEntries(Object.entries(targetprofiles).map(([key, value]) => [key, { ...value, capabilities: [...value.capabilities] }])); }

package/orchestrator.ts

@@ -68,8 +68,8 @@ import { cpus, freemem, networkInterfaces, tmpdir, totalmem } from 'node:os';
 import path from 'node:path';
 import process from 'node:process';
 import { setTimeout as sleep } from 'node:timers/promises';
-import type { enginetopicname, enginetopics } from './index.js';
-import { enginebus, MetricsStore } from './index.js';
+import type { enginetopicname, enginetopics } from './index.ts';
+import { enginebus, MetricsStore } from './index.ts';
 
 /* ------------------------------------------------------------------ */
 /* context: runtime catalog (verified 2026-08-22)                       */

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@wenathlan/saddle",
-  "version": "2.1.7",
+  "version": "2.1.8",
   "description": "binary computing engine that turns distributed storage into a publishable working set carrying the merged virtual-hardware engine (the saddle + e2ugh grand merge)",
   "type": "module",
   "private": false,
   "license": "GPL-3.0-only",
   "author": "Wenathlan",
   "sideEffects": false,
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "browser": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./index.ts",
+  "module": "./index.ts",
+  "browser": "./index.ts",
+  "types": "./index.ts",
   "packageManager": "pnpm@12.3.4",
   "publishConfig": {
     "access": "public"
@@ -95,43 +95,42 @@
     }
   },
   "bin": {
-    "saddle": "./dist/cli.js"
+    "saddle": "./cli.ts"
   },
   "exports": {
-    ".": "./dist/index.js",
-    "./memory": "./dist/virtual.js",
-    "./memory-node": "./dist/virtual.js",
-    "./memory-engine": "./dist/virtual.js",
-    "./memory-plan": "./dist/virtual.js",
-    "./storage": "./dist/virtual.js",
-    "./storage-pool": "./dist/virtual.js",
-    "./storage-node": "./dist/virtual.js",
-    "./runners": "./dist/execution.js",
-    "./provider-chain": "./dist/execution.js",
-    "./sessions": "./dist/foundation.js",
-    "./modes": "./dist/modes.js",
-    "./mode": "./dist/modes.js",
-    "./sandbox": "./dist/sandbox.js",
-    "./modalities": "./dist/modalityregistry.js",
-    "./workloadlaw": "./dist/workloadlaw.js",
-    "./browser": "./dist/browser.js",
-    "./browser-playwright": "./dist/browser.js",
-    "./deploy": "./dist/modes.js",
-    "./extension": "./dist/browser.js",
-    "./server-node": "./dist/server.js",
-    "./sessions-file": "./dist/execution.js",
-    "./sessions-store": "./dist/execution.js",
-    "./queue-persistent": "./dist/execution.js",
-    "./hash": "./dist/foundation.js",
-    "./release-assets": "./dist/distribution.js",
-    "./release-verify": "./dist/distribution.js",
-    "./release-evidence": "./dist/distribution.js",
-    "./delivery": "./dist/distribution.js",
-    "./worker": "./dist/execution.js",
-    "./binary-archive": "./dist/distribution.js",
-    "./binary-transform": "./dist/distribution.js",
-    "./isolation": "./dist/isolation.js",
-    "./virtual-browser": "./dist/browser.js",
+    ".": "./index.ts",
+    "./memory": "./virtual.ts",
+    "./memory-node": "./virtual.ts",
+    "./memory-engine": "./virtual.ts",
+    "./memory-plan": "./virtual.ts",
+    "./storage": "./virtual.ts",
+    "./storage-pool": "./virtual.ts",
+    "./storage-node": "./virtual.ts",
+    "./runners": "./execution.ts",
+    "./provider-chain": "./execution.ts",
+    "./sessions": "./foundation.ts",
+    "./modes": "./modes.ts",
+    "./mode": "./modes.ts",
+    "./sandbox": "./sandbox.ts",
+    "./modalities": "./modalityregistry.ts",
+    "./workloadlaw": "./workloadlaw.ts",
+    "./browser": "./browser.ts",
+    "./browser-playwright": "./browser.ts",
+    "./deploy": "./modes.ts",
+    "./server-node": "./server.ts",
+    "./sessions-file": "./execution.ts",
+    "./sessions-store": "./execution.ts",
+    "./queue-persistent": "./execution.ts",
+    "./hash": "./foundation.ts",
+    "./release-assets": "./distribution.ts",
+    "./release-verify": "./distribution.ts",
+    "./release-evidence": "./distribution.ts",
+    "./delivery": "./distribution.ts",
+    "./worker": "./execution.ts",
+    "./binary-archive": "./distribution.ts",
+    "./binary-transform": "./distribution.ts",
+    "./isolation": "./isolation.ts",
+    "./virtual-browser": "./browser.ts",
     "./virtualcpu": "./virtualcpu.ts",
     "./virtualmemory": "./virtualmemory.ts",
     "./virtualgpu": "./virtualgpu.ts",
@@ -157,12 +156,22 @@
     "./quantum": "./quantum.ts"
   },
   "files": [
-    "dist",
-    "manifest.json",
+    "index.ts",
+    "virtual.ts",
+    "execution.ts",
+    "foundation.ts",
+    "modes.ts",
+    "sandbox.ts",
+    "modalityregistry.ts",
+    "workloadlaw.ts",
+    "browser.ts",
+    "server.ts",
+    "distribution.ts",
+    "isolation.ts",
+    "cli.ts",
     "docs",
     "README.md",
     "LICENSE",
-    "index.ts",
     "orchestrator.ts",
     "scheduler.ts",
     "compute.ts",
@@ -191,20 +200,18 @@
     "Dockerfile",
     "tsconfig.json",
     "biome.jsonc",
-    "modalityregistry.ts",
     "tiers.ts",
     "quantum.ts"
   ],
   "scripts": {
     "build:engine": "node scriptsbuildengine.ts",
-    "check": "npm run build:engine && node --check dist/index.js && node --check dist/execution.js && node --check dist/cli.js && node --check dist/browser.js && node --check dist/distribution.js",
+    "check": "tsc -p tsconfig.json --noEmit",
     "formatcheck": "node --import tsx format.ts",
     "test": "vitest run",
-    "run": "npm run build:engine && node dist/cli.js",
-    "extension:build": "npm run build:engine && node dist/browser.js",
-    "release:assets": "npm run build:engine && node dist/distribution.js",
-    "release:verify": "npm run build:engine && node dist/distribution.js verify",
-    "target:manifest": "npm run build:engine && node dist/distribution.js target",
+    "run": "npm run build:engine && node --import tsx ./cli.ts",
+    "release:assets": "npm run build:engine && node --import tsx ./distribution.ts",
+    "release:verify": "npm run build:engine && node --import tsx ./distribution.ts verify",
+    "target:manifest": "npm run build:engine && node --import tsx ./distribution.ts target",
     "pack:check": "npm run check && npm run formatcheck && npm test && npm pack --dry-run",
     "prepublishOnly": "npm run pack:check",
     "tauri": "npx --yes @tauri-apps/cli@2.11.4",
@@ -217,7 +224,7 @@
     "web:build:pages": "vite build",
     "web:preview": "vite preview --host",
     "build": "npm run build:engine",
-    "build:tsc": "tsc -p tsconfig.json --noEmitOnError false",
+    "build:tsc": "tsc -p tsconfig.json --noEmit",
     "start": "node --import tsx ./cli.ts plan",
     "dev": "node --import tsx --watch ./cli.ts",
     "web": "node webserver.ts",
@@ -240,13 +247,13 @@
     "vm:create": "node --import tsx ./cli.ts vm",
     "vm:validate": "node --import tsx ./cli.ts vmlint",
     "gpu:list": "node --import tsx ./cli.ts gpus",
-    "docker:build": "docker build -f Dockerfile -t saddle:2.1.7 .",
-    "docker:run": "docker run --rm --memory-swap=-1 --shm-size=2g saddle:2.1.7",
-    "docker:health": "docker run --rm saddle:2.1.7 qemu-system-x86_64 --version && curl -fsS http://localhost:8080/health || true",
+    "docker:build": "docker build -f Dockerfile -t saddle:2.1.8 .",
+    "docker:run": "docker run --rm --memory-swap=-1 --shm-size=2g saddle:2.1.8",
+    "docker:health": "docker run --rm saddle:2.1.8 qemu-system-x86_64 --version && curl -fsS http://localhost:8080/health || true",
     "firecracker:boot": "firecracker --api-sock /tmp/fc-saddle.sock --config-file vmconfig.json 2>/dev/null || echo 'firecracker 1.16.1 warm-pool boot 125ms target'",
     "py:bridge": "python3 qemubridge.py",
     "py:test": "python3 -m pytest -q || python3 qemubridge.py",
-    "clean": "rm -rf dist coverage .biome __pycache__",
+    "clean": "rm -rf distpackage coverage .biome __pycache__",
     "prepare": "echo 'saddle grand-merge toolchain 2026-08-23: Node 26.12.0 Current / 24.19.0 LTS, npm 12.0.2, TS 7.0.2, Python 3.14.7, Docker 29.7.2, QEMU 11.1.0, Mesa 26.2.1, LLVM 22.1.8, Firecracker 1.16.1'",
     "start:engine": "node --import tsx ./cli.ts plan"
   },
@@ -261,17 +268,17 @@
     "@libsql/client": "^0.18.0",
     "@prisma/adapter-libsql": "^7.10.1",
     "@prisma/client": "^7.10.1",
-    "@wenathlan/cadria": "^2.0.154",
-    "@wenathlan/debonair": "^2.0.154",
+    "@wenathlan/cadria": "^2.1.7",
+    "@wenathlan/debonair": "^2.1.7",
     "@wenathlan/getry": "^2.0.154",
-    "@wenathlan/saddle": "^2.1.6",
-    "@wenathlan/vault": "^2.0.154",
+    "@wenathlan/saddle": "^2.1.7",
+    "@wenathlan/vault": "^2.1.7",
     "better-sqlite3": "^13.0.3",
     "drizzle-orm": "^0.45.4",
     "gsap": "^3.15.0",
     "hono": "^4.13.16",
     "ink": "^7.1.1",
-    "lucide-react": "^1.66.0",
+    "lucide-react": "^1.67.0",
     "motion": "^12.43.0",
     "react": "^19.3.1",
     "react-devtools-core": "^8.0.0",
@@ -317,9 +324,9 @@
     "@radix-ui/react-toggle": "^1.2.1",
     "@radix-ui/react-toggle-group": "^1.2.1",
     "@radix-ui/react-tooltip": "^1.4.1",
-    "@tailwindcss/postcss": "^4.3.3",
+    "@tailwindcss/postcss": "^4.3.4",
     "@tailwindcss/typography": "^0.5.20",
-    "@tailwindcss/vite": "^4.3.3",
+    "@tailwindcss/vite": "^4.3.4",
     "@tsconfig/node26": "^26.0.1",
     "@types/better-sqlite3": "^9.6.0",
     "@types/three": "^0.187.0",
@@ -329,7 +336,7 @@
     "@types/node": "^26.6.6",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
-    "@vitejs/plugin-react": "^6.1.2",
+    "@vitejs/plugin-react": "^6.2.1",
     "add": "^2.0.9",
     "autoprefixer": "^10.6.2",
     "axios": "^1.21.0",
@@ -349,8 +356,7 @@
     "framer-motion": "^13.5.1",
     "hono": "^4.13.16",
     "input-otp": "^1.5.0",
-    "jsdom": "26.1.0",
-    "lucide-react": "^1.66.0",
+    "lucide-react": "^1.67.0",
     "mysql2": "^3.24.6",
     "nanoid": "^6.0.2",
     "next-themes": "^0.4.6",
@@ -365,12 +371,12 @@
     "react-day-picker": "^10.0.2",
     "react-dom": "^19.3.1",
     "react-hook-form": "^7.91.0",
-    "react-resizable-panels": "^4.16.1",
+    "react-resizable-panels": "^4.17.0",
     "recharts": "^3.10.1",
     "sonner": "^2.0.8",
     "streamdown": "^2.7.1",
     "tailwind-merge": "^3.7.0",
-    "tailwindcss": "^4.3.3",
+    "tailwindcss": "^4.3.4",
     "tailwindcss-animate": "^1.0.7",
     "tsup": "^8.5.1",
     "tsx": "^4.23.15",
@@ -379,7 +385,7 @@
     "vaul": "^1.1.2",
     "vite": "^8.3.5",
     "vite-plugin-manus-runtime": "^0.0.59",
-    "vitest": "^5.0.5",
+    "vitest": "^5.1.0",
     "webpack": "^5.112.2",
     "webpack-cli": "^6.0.1",
     "wouter": "^3.13.0",