@shogo-ai/core 1.10.0 → 2.4.1

package/dist/tech-stack-registry.d.cts

@@ -53,6 +53,37 @@ interface StackRegistryEntry {
      * bundled Vite template; everything else seeds itself.
      */
     seedsOwnTemplate?: boolean;
+    /**
+     * Metal VM class this stack requires. Mirrors `TechStackMeta.runtime.vmClass`
+     * (see `packages/agent-runtime/src/workspace-defaults.ts`) so `apps/api` —
+     * which does not bundle `tech-stacks/` and cannot read `stack.json` at
+     * runtime — can decide placement/gating without it. Omitted = `'standard'`,
+     * the default every non-Docker stack uses.
+     */
+    vmClass?: 'standard' | 'docker';
+    /**
+     * Smallest instance size (`apps/api/src/config/instance-sizes.ts`
+     * `InstanceSizeName`) this stack should be billed/provisioned at. Mirrors
+     * `TechStackMeta.runtime.minimumInstanceSize`. Unlike the mobile floor
+     * (`applyTechStackFloor`), this floor is BILLED, not just a free headroom
+     * bump — see `applyDockerStackFloor`.
+     */
+    minimumInstanceSize?: 'micro' | 'small' | 'medium' | 'large' | 'xlarge';
+    /**
+     * Ports the stack's services expose, mirroring
+     * `TechStackMeta.runtime.ports` (see `workspace-defaults.ts`) for the same
+     * reason `vmClass`/`minimumInstanceSize` are mirrored: apps/api can't read
+     * `stack.json` at runtime, but needs this to validate `PATCH .../ports/:port`
+     * (a project can only toggle visibility on a port its stack actually
+     * declares — never an arbitrary guest port) and to seed
+     * `Project.settings.exposedPorts` defaults.
+     */
+    ports?: Array<{
+        port: number;
+        label?: string;
+        protocol: 'http' | 'tcp';
+        defaultVisibility: 'tunnel' | 'preview';
+    }>;
 }
 /**
  * Canonical registry of every first-party tech stack we ship. Kept here in
@@ -84,5 +115,21 @@ declare function usesMetroBundler(techStackId: string | null | undefined): boole
  * adding a new stack doesn't accidentally break the default behaviour.
  */
 declare function stackSeedsItself(techStackId: string | null | undefined): boolean;
+/**
+ * True for any stack whose `vmClass` is `'docker'` — i.e. it needs the
+ * Docker-capable metal VM class (dockerd + a persistent data volume), not
+ * the default standard project VM. Callers must still check the platform
+ * gate (`runtime.docker_class_enabled`) before honouring this.
+ */
+declare function isDockerTechStack(techStackId: string | null | undefined): boolean;
+/** The stack's declared minimum instance size, or `null` if it doesn't set one. */
+declare function getMinimumInstanceSize(techStackId: string | null | undefined): StackRegistryEntry['minimumInstanceSize'] | null;
+/**
+ * The stack's declared ports (empty array if it declares none). This is the
+ * ONLY allowlist for both the client-side tunnel and the public per-port
+ * preview — a project can toggle visibility on a declared port, but can
+ * never expose a port its stack doesn't list.
+ */
+declare function getDeclaredPorts(techStackId: string | null | undefined): NonNullable<StackRegistryEntry['ports']>;
 
-export { type StackRegistryEntry, type StackTarget, TECH_STACK_REGISTRY, getStackEntry, isMobileTechStack, stackSeedsItself, usesMetroBundler };
+export { type StackRegistryEntry, type StackTarget, TECH_STACK_REGISTRY, getDeclaredPorts, getMinimumInstanceSize, getStackEntry, isDockerTechStack, isMobileTechStack, stackSeedsItself, usesMetroBundler };

package/dist/tech-stack-registry.d.ts

@@ -53,6 +53,37 @@ interface StackRegistryEntry {
      * bundled Vite template; everything else seeds itself.
      */
     seedsOwnTemplate?: boolean;
+    /**
+     * Metal VM class this stack requires. Mirrors `TechStackMeta.runtime.vmClass`
+     * (see `packages/agent-runtime/src/workspace-defaults.ts`) so `apps/api` —
+     * which does not bundle `tech-stacks/` and cannot read `stack.json` at
+     * runtime — can decide placement/gating without it. Omitted = `'standard'`,
+     * the default every non-Docker stack uses.
+     */
+    vmClass?: 'standard' | 'docker';
+    /**
+     * Smallest instance size (`apps/api/src/config/instance-sizes.ts`
+     * `InstanceSizeName`) this stack should be billed/provisioned at. Mirrors
+     * `TechStackMeta.runtime.minimumInstanceSize`. Unlike the mobile floor
+     * (`applyTechStackFloor`), this floor is BILLED, not just a free headroom
+     * bump — see `applyDockerStackFloor`.
+     */
+    minimumInstanceSize?: 'micro' | 'small' | 'medium' | 'large' | 'xlarge';
+    /**
+     * Ports the stack's services expose, mirroring
+     * `TechStackMeta.runtime.ports` (see `workspace-defaults.ts`) for the same
+     * reason `vmClass`/`minimumInstanceSize` are mirrored: apps/api can't read
+     * `stack.json` at runtime, but needs this to validate `PATCH .../ports/:port`
+     * (a project can only toggle visibility on a port its stack actually
+     * declares — never an arbitrary guest port) and to seed
+     * `Project.settings.exposedPorts` defaults.
+     */
+    ports?: Array<{
+        port: number;
+        label?: string;
+        protocol: 'http' | 'tcp';
+        defaultVisibility: 'tunnel' | 'preview';
+    }>;
 }
 /**
  * Canonical registry of every first-party tech stack we ship. Kept here in
@@ -84,5 +115,21 @@ declare function usesMetroBundler(techStackId: string | null | undefined): boole
  * adding a new stack doesn't accidentally break the default behaviour.
  */
 declare function stackSeedsItself(techStackId: string | null | undefined): boolean;
+/**
+ * True for any stack whose `vmClass` is `'docker'` — i.e. it needs the
+ * Docker-capable metal VM class (dockerd + a persistent data volume), not
+ * the default standard project VM. Callers must still check the platform
+ * gate (`runtime.docker_class_enabled`) before honouring this.
+ */
+declare function isDockerTechStack(techStackId: string | null | undefined): boolean;
+/** The stack's declared minimum instance size, or `null` if it doesn't set one. */
+declare function getMinimumInstanceSize(techStackId: string | null | undefined): StackRegistryEntry['minimumInstanceSize'] | null;
+/**
+ * The stack's declared ports (empty array if it declares none). This is the
+ * ONLY allowlist for both the client-side tunnel and the public per-port
+ * preview — a project can toggle visibility on a declared port, but can
+ * never expose a port its stack doesn't list.
+ */
+declare function getDeclaredPorts(techStackId: string | null | undefined): NonNullable<StackRegistryEntry['ports']>;
 
-export { type StackRegistryEntry, type StackTarget, TECH_STACK_REGISTRY, getStackEntry, isMobileTechStack, stackSeedsItself, usesMetroBundler };
+export { type StackRegistryEntry, type StackTarget, TECH_STACK_REGISTRY, getDeclaredPorts, getMinimumInstanceSize, getStackEntry, isDockerTechStack, isMobileTechStack, stackSeedsItself, usesMetroBundler };

package/dist/tech-stack-registry.js

@@ -1,13 +1,19 @@
 import {
   TECH_STACK_REGISTRY,
+  getDeclaredPorts,
+  getMinimumInstanceSize,
   getStackEntry,
+  isDockerTechStack,
   isMobileTechStack,
   stackSeedsItself,
   usesMetroBundler
-} from "./chunk-KTDDFWXM.js";
+} from "./chunk-NTAY4E43.js";
 export {
   TECH_STACK_REGISTRY,
+  getDeclaredPorts,
+  getMinimumInstanceSize,
   getStackEntry,
+  isDockerTechStack,
   isMobileTechStack,
   stackSeedsItself,
   usesMetroBundler

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shogo-ai/core",
-  "version": "1.10.0",
+  "version": "2.4.1",
   "description": "Shogo Core — generic utilities (logger, instrumentation, stream-buffer, chat-message). Zero required peers.",
   "license": "MIT",
   "type": "module",
@@ -64,8 +64,11 @@
   },
   "peerDependencies": {
     "@opentelemetry/api": ">=1.9.0",
+    "@opentelemetry/api-logs": ">=0.213.0",
     "@opentelemetry/sdk-node": ">=0.213.0",
     "@opentelemetry/exporter-trace-otlp-http": ">=0.213.0",
+    "@opentelemetry/exporter-logs-otlp-http": ">=0.213.0",
+    "@opentelemetry/sdk-logs": ">=0.213.0",
     "@opentelemetry/sdk-trace-base": ">=2.5.0",
     "@opentelemetry/resources": ">=2.5.0",
     "@opentelemetry/semantic-conventions": ">=1.39.0"
@@ -74,12 +77,21 @@
     "@opentelemetry/api": {
       "optional": true
     },
+    "@opentelemetry/api-logs": {
+      "optional": true
+    },
     "@opentelemetry/sdk-node": {
       "optional": true
     },
     "@opentelemetry/exporter-trace-otlp-http": {
       "optional": true
     },
+    "@opentelemetry/exporter-logs-otlp-http": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-logs": {
+      "optional": true
+    },
     "@opentelemetry/sdk-trace-base": {
       "optional": true
     },
@@ -92,9 +104,12 @@
   },
   "devDependencies": {
     "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/api-logs": "^0.213.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.213.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.213.0",
     "@opentelemetry/resources": "^2.5.1",
     "@opentelemetry/sdk-node": "^0.213.0",
+    "@opentelemetry/sdk-logs": "^0.213.0",
     "@opentelemetry/sdk-trace-base": "^2.5.1",
     "@opentelemetry/semantic-conventions": "^1.39.0",
     "@types/node": "^25.5.0",

package/dist/chunk-ELMG6OXT.js

@@ -1,236 +0,0 @@
-// src/stream-buffer.ts
-var CLEANUP_INTERVAL_MS = 6e4;
-var MAX_BUFFER_AGE_MS = 30 * 6e4;
-var COMPLETED_GRACE_MS = 3e4;
-var StreamBufferStore = class {
-  constructor() {
-    this.buffers = /* @__PURE__ */ new Map();
-    this.cleanupTimer = null;
-    this.cleanupTimer = setInterval(() => this.cleanup(), CLEANUP_INTERVAL_MS);
-    const handle = this.cleanupTimer;
-    if (handle && typeof handle.unref === "function") {
-      handle.unref();
-    }
-  }
-  /**
-   * Create (or replace) a buffer for the given key. Any existing active
-   * buffer is completed and discarded. Returns a writer bound to this
-   * specific buffer instance, including the new `turnId`.
-   */
-  create(key, opts) {
-    const existing = this.buffers.get(key);
-    if (existing && existing.status === "active") {
-      this.completeBuffer(existing, "replaced");
-    }
-    const now = Date.now();
-    const turnId = opts?.turnId || generateTurnId();
-    const buf = {
-      turnId,
-      frames: [],
-      subscribers: /* @__PURE__ */ new Set(),
-      status: "active",
-      terminal: null,
-      createdAt: now,
-      completedAt: null,
-      lastEventAt: now,
-      nextSeq: 1
-    };
-    this.buffers.set(key, buf);
-    return {
-      get turnId() {
-        return buf.turnId;
-      },
-      get lastSeq() {
-        return buf.nextSeq - 1;
-      },
-      append: (chunk) => {
-        if (buf.status !== "active") return -1;
-        const seq = buf.nextSeq++;
-        buf.frames.push({ seq, chunk });
-        buf.lastEventAt = Date.now();
-        for (const ctrl of buf.subscribers) {
-          try {
-            ctrl.enqueue(chunk);
-          } catch {
-            buf.subscribers.delete(ctrl);
-          }
-        }
-        return seq;
-      },
-      complete: (reason) => {
-        this.completeBuffer(buf, reason);
-      },
-      fail: (error) => {
-        this.failBuffer(buf, error);
-      }
-    };
-  }
-  /**
-   * Append a chunk by key (loose, untyped writer). Returns the seq assigned,
-   * or -1 if the buffer is unknown/inactive.
-   */
-  append(key, chunk) {
-    const buf = this.buffers.get(key);
-    if (!buf || buf.status !== "active") return -1;
-    const seq = buf.nextSeq++;
-    buf.frames.push({ seq, chunk });
-    buf.lastEventAt = Date.now();
-    for (const ctrl of buf.subscribers) {
-      try {
-        ctrl.enqueue(chunk);
-      } catch {
-        buf.subscribers.delete(ctrl);
-      }
-    }
-    return seq;
-  }
-  /** Mark a buffer as completed by key. Optional terminal reason. */
-  complete(key, reason) {
-    const buf = this.buffers.get(key);
-    if (!buf) return;
-    this.completeBuffer(buf, reason);
-  }
-  /**
-   * Abort a stream: complete subscribers and remove the buffer entirely.
-   * Future resume/replay requests for this key will return null (→ 204).
-   */
-  abort(key) {
-    const buf = this.buffers.get(key);
-    if (!buf) return;
-    this.completeBuffer(buf, "aborted");
-    buf.status = "aborted";
-    this.buffers.delete(key);
-  }
-  has(key) {
-    return this.buffers.has(key);
-  }
-  /** Read-only metadata about a buffered turn. Useful for resume responses. */
-  snapshot(key) {
-    const buf = this.buffers.get(key);
-    if (!buf) return null;
-    return {
-      turnId: buf.turnId,
-      status: buf.status,
-      lastSeq: buf.nextSeq - 1,
-      terminal: buf.terminal,
-      createdAt: buf.createdAt,
-      completedAt: buf.completedAt,
-      lastEventAt: buf.lastEventAt
-    };
-  }
-  /**
-   * Create a ReadableStream that first replays all buffered chunks past
-   * `opts.fromSeq` (default: 0 → replay everything), then subscribes for
-   * any further live chunks until the stream completes.
-   *
-   * Returns null if no buffer exists for the key.
-   */
-  createReplayStream(key, opts = {}) {
-    const buf = this.buffers.get(key);
-    if (!buf) return null;
-    const fromSeq = Math.max(0, opts.fromSeq ?? 0);
-    let subscribedController = null;
-    return new ReadableStream({
-      start(controller) {
-        for (const frame of buf.frames) {
-          if (frame.seq <= fromSeq) continue;
-          try {
-            controller.enqueue(frame.chunk);
-          } catch {
-            return;
-          }
-        }
-        if (buf.status !== "active") {
-          try {
-            controller.close();
-          } catch {
-          }
-          return;
-        }
-        subscribedController = controller;
-        buf.subscribers.add(controller);
-      },
-      cancel() {
-        if (subscribedController) {
-          buf.subscribers.delete(subscribedController);
-          subscribedController = null;
-        }
-      }
-    });
-  }
-  cleanup() {
-    const now = Date.now();
-    for (const [key, buf] of this.buffers) {
-      if (buf.status !== "active" && buf.completedAt && now - buf.completedAt > COMPLETED_GRACE_MS) {
-        this.buffers.delete(key);
-      } else if (now - buf.createdAt > MAX_BUFFER_AGE_MS && buf.subscribers.size === 0) {
-        this.completeBuffer(buf, "expired");
-        this.buffers.delete(key);
-      }
-    }
-  }
-  dispose() {
-    if (this.cleanupTimer) {
-      clearInterval(this.cleanupTimer);
-      this.cleanupTimer = null;
-    }
-    for (const buf of this.buffers.values()) {
-      this.completeBuffer(buf, "disposed");
-    }
-    this.buffers.clear();
-  }
-  completeBuffer(buf, reason) {
-    if (buf.status !== "active") return;
-    buf.status = "completed";
-    buf.terminal = { reason };
-    buf.completedAt = Date.now();
-    buf.lastEventAt = buf.completedAt;
-    for (const ctrl of buf.subscribers) {
-      try {
-        ctrl.close();
-      } catch {
-      }
-    }
-    buf.subscribers.clear();
-  }
-  failBuffer(buf, error) {
-    if (buf.status !== "active") return;
-    buf.status = "failed";
-    buf.terminal = { error };
-    buf.completedAt = Date.now();
-    buf.lastEventAt = buf.completedAt;
-    for (const ctrl of buf.subscribers) {
-      try {
-        ctrl.close();
-      } catch {
-      }
-    }
-    buf.subscribers.clear();
-  }
-};
-function generateTurnId() {
-  try {
-    if (typeof globalThis.crypto?.randomUUID === "function") {
-      return globalThis.crypto.randomUUID();
-    }
-  } catch {
-  }
-  return `turn_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
-}
-function createBufferingTransform(store, key) {
-  return new TransformStream({
-    transform(chunk, controller) {
-      store.append(key, chunk);
-      controller.enqueue(chunk);
-    },
-    flush() {
-      store.complete(key);
-    }
-  });
-}
-
-export {
-  StreamBufferStore,
-  createBufferingTransform
-};
-//# sourceMappingURL=chunk-ELMG6OXT.js.map

package/dist/chunk-HKX3MEJN.js

@@ -1,126 +0,0 @@
-// src/file-types.ts
-var BINARY_FILE_EXTENSIONS = /* @__PURE__ */ new Set([
-  // Images
-  "png",
-  "jpg",
-  "jpeg",
-  "gif",
-  "webp",
-  "bmp",
-  "ico",
-  "avif",
-  "apng",
-  "heic",
-  "heif",
-  "tiff",
-  "tif",
-  "jxl",
-  "cur",
-  // Archives
-  "zip",
-  "gz",
-  "tar",
-  "tgz",
-  "bz2",
-  "xz",
-  "7z",
-  "rar",
-  "zst",
-  "lz4",
-  // Audio / video / docs
-  "mp3",
-  "mp4",
-  "m4a",
-  "m4v",
-  "mov",
-  "avi",
-  "mkv",
-  "webm",
-  "wav",
-  "flac",
-  "ogg",
-  "oga",
-  "ogv",
-  "aac",
-  "opus",
-  "pdf",
-  // Fonts
-  "woff",
-  "woff2",
-  "ttf",
-  "otf",
-  "eot",
-  // Native / packed
-  "exe",
-  "dll",
-  "so",
-  "dylib",
-  "bin",
-  "class",
-  "jar",
-  "wasm",
-  // Databases
-  "db",
-  "sqlite",
-  "sqlite3",
-  "mdb",
-  "lmdb",
-  // Misc binary
-  "pack",
-  "idx",
-  "psd",
-  "ai",
-  "sketch",
-  "fig",
-  "blend",
-  "obj",
-  "fbx",
-  "pyc",
-  "pyo",
-  "pyd",
-  // 3D / scene / point cloud (binary variants — `.usda` and `.gltf` are
-  // text and intentionally NOT listed; users can still edit those)
-  "usd",
-  "usdc",
-  "usdz",
-  "glb",
-  "stl",
-  "ply",
-  // Robotics logs
-  "bag",
-  "mcap",
-  // ML weights / saved models / serialized arrays
-  "pt",
-  "pth",
-  "ckpt",
-  "safetensors",
-  "onnx",
-  "pb",
-  "tflite",
-  "mlmodel",
-  "npy",
-  "npz",
-  "joblib",
-  "pkl",
-  // Tabular / scientific containers
-  "parquet",
-  "arrow",
-  "feather",
-  "h5",
-  "hdf5",
-  "nc",
-  "tfrecord"
-]);
-function isBinaryFilePath(path) {
-  const dot = path.lastIndexOf(".");
-  if (dot < 0) return false;
-  const slash = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"));
-  if (dot < slash) return false;
-  return BINARY_FILE_EXTENSIONS.has(path.slice(dot + 1).toLowerCase());
-}
-
-export {
-  BINARY_FILE_EXTENSIONS,
-  isBinaryFilePath
-};
-//# sourceMappingURL=chunk-HKX3MEJN.js.map

package/dist/chunk-KTDDFWXM.js

@@ -1,39 +0,0 @@
-// src/tech-stack-registry.ts
-var TECH_STACK_REGISTRY = {
-  // Web (Vite-based) — share a bundled Vite template, so apps/api seeds them.
-  "react-app": { id: "react-app", target: "web" },
-  "threejs-game": { id: "threejs-game", target: "web" },
-  "phaser-game": { id: "phaser-game", target: "web" },
-  // Mobile (Metro/Expo) — agent-runtime owns the seed.
-  "expo-app": { id: "expo-app", target: "mobile", metro: true, seedsOwnTemplate: true },
-  "expo-three": { id: "expo-three", target: "mobile", metro: true, seedsOwnTemplate: true },
-  "react-native": { id: "react-native", target: "mobile", metro: true, seedsOwnTemplate: true },
-  // Data / scripting
-  "python-data": { id: "python-data", target: "data", seedsOwnTemplate: true },
-  // Native (full game engines)
-  "unity-game": { id: "unity-game", target: "native", seedsOwnTemplate: true },
-  // Bare / no-stack
-  none: { id: "none", target: "none", seedsOwnTemplate: true }
-};
-function getStackEntry(techStackId) {
-  if (!techStackId) return null;
-  return TECH_STACK_REGISTRY[techStackId] ?? null;
-}
-function isMobileTechStack(techStackId) {
-  return getStackEntry(techStackId)?.target === "mobile";
-}
-function usesMetroBundler(techStackId) {
-  return getStackEntry(techStackId)?.metro === true;
-}
-function stackSeedsItself(techStackId) {
-  return getStackEntry(techStackId)?.seedsOwnTemplate === true;
-}
-
-export {
-  TECH_STACK_REGISTRY,
-  getStackEntry,
-  isMobileTechStack,
-  usesMetroBundler,
-  stackSeedsItself
-};
-//# sourceMappingURL=chunk-KTDDFWXM.js.map