@skaile/workspaces 0.8.5

package/dist/chunk-XEGHWFAX.js

@@ -0,0 +1,174 @@
+import { resolveSkWorkspaceConfig, readLinks } from './chunk-CSUBFKAN.js';
+import { scanDirectory } from './chunk-BVHFSUFM.js';
+import { existsSync, readFileSync, lstatSync } from 'fs';
+import { resolve, join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+
+var BASE_ASSETS_REPO_NAME = "base-assets";
+async function resolveRuntimeAssets(projectDir) {
+  const result = {
+    catalogEntries: [],
+    implicitRefs: [],
+    requiredNpmDeps: { required: [], optional: [] },
+    warnings: [],
+    refresh: async () => {
+      await populate(projectDir, result);
+    },
+    findEntry: (query) => findCatalogEntry(result.catalogEntries, query)
+  };
+  await populate(projectDir, result);
+  return result;
+}
+function resolveBaseAssetsRoot() {
+  const envDir = process.env.SKAILE_BASE_ASSETS_DIR;
+  if (envDir && existsSync(envDir)) return resolve(envDir);
+  try {
+    const require2 = createRequire(import.meta.url);
+    const pkgJson = require2.resolve("@skaile/workspaces/package.json");
+    const candidate = join(dirname(pkgJson), "base-assets");
+    if (existsSync(candidate)) return candidate;
+  } catch {
+  }
+  const workspaceHit = findInWorkspace(import.meta.url);
+  if (workspaceHit) return workspaceHit;
+  throw new Error(
+    `Cannot resolve the base-assets directory. Set SKAILE_BASE_ASSETS_DIR to the on-disk path, ensure @skaile/workspaces is installed, or run from within the @skaile/workspaces package tree.`
+  );
+}
+function findInWorkspace(startUrl) {
+  let dir;
+  try {
+    dir = dirname(fileURLToPath(startUrl));
+  } catch {
+    return null;
+  }
+  for (let i = 0; i < 8; i++) {
+    const pkgPath = join(dir, "package.json");
+    const baseAssets = join(dir, "base-assets");
+    if (existsSync(pkgPath) && existsSync(baseAssets)) {
+      try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        if (pkg.name === "@skaile/workspaces") return baseAssets;
+      } catch {
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+async function populate(projectDir, target) {
+  target.catalogEntries = [];
+  target.implicitRefs = [];
+  target.requiredNpmDeps = { required: [], optional: [] };
+  target.warnings = [];
+  const config = resolveSkWorkspaceConfig(projectDir);
+  const repositories = buildEffectiveRepositories(config.repositories);
+  const links = readLinks(projectDir);
+  for (const [name, decl] of Object.entries(repositories)) {
+    const repoDir = resolveRepoDir(name, decl, projectDir, links);
+    if (!repoDir) {
+      target.warnings.push({
+        code: "repo_unavailable",
+        name,
+        message: repoUnavailableMessage(name, decl)
+      });
+      continue;
+    }
+    try {
+      const entries = scanDirectory(repoDir, name).filter(
+        (e) => e.kind === "mount" || e.kind === "connector"
+      );
+      target.catalogEntries.push(...entries);
+    } catch (err) {
+      target.warnings.push({
+        code: "repo_unavailable",
+        name,
+        message: `Failed to scan repository "${name}" at ${repoDir}: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  for (const m of config.mounts ?? []) {
+    target.implicitRefs.push({ kind: "mount", name: m.driver, declarationId: m.id });
+  }
+  for (const c of config.connectors ?? []) {
+    target.implicitRefs.push({ kind: "connector", name: c.driver, declarationId: c.id });
+  }
+  const requiredSet = /* @__PURE__ */ new Set();
+  const optionalSet = /* @__PURE__ */ new Set();
+  for (const ref of target.implicitRefs) {
+    const entry = findCatalogEntry(target.catalogEntries, ref);
+    if (!entry) {
+      target.warnings.push({
+        code: "missing_driver",
+        declarationId: ref.declarationId,
+        name: ref.name,
+        message: `Unknown ${ref.kind} driver "${ref.name}" referenced by ${ref.kind} "${ref.declarationId}". Run \`skaile ${ref.kind} catalog\` to see available drivers, or declare a repository in skaile.yaml that provides this driver.`
+      });
+      continue;
+    }
+    const npm = entry.metadata?.npm_deps ?? {};
+    for (const p of npm.required ?? []) requiredSet.add(p);
+    for (const p of npm.optional ?? []) optionalSet.add(p);
+  }
+  target.requiredNpmDeps.required = [...requiredSet];
+  target.requiredNpmDeps.optional = [...optionalSet];
+}
+function buildEffectiveRepositories(declared) {
+  const result = { ...declared ?? {} };
+  if (!result[BASE_ASSETS_REPO_NAME]) {
+    try {
+      const baseDir = resolveBaseAssetsRoot();
+      result[BASE_ASSETS_REPO_NAME] = { path: baseDir };
+    } catch (err) {
+      result[BASE_ASSETS_REPO_NAME] = { path: "" };
+    }
+  }
+  return result;
+}
+function resolveRepoDir(name, decl, projectDir, links) {
+  const linked = links[name];
+  if (linked && existsSync(linked)) return linked;
+  if (decl.path) {
+    const resolved = resolve(projectDir, decl.path);
+    return existsSync(resolved) ? resolved : null;
+  }
+  if (decl.url) {
+    const projectDest = join(projectDir, ".skaile", "repos", name);
+    if (existsSync(projectDest)) {
+      try {
+        return lstatSync(projectDest).isSymbolicLink() ? projectDest : projectDest;
+      } catch {
+        return null;
+      }
+    }
+    return null;
+  }
+  return null;
+}
+function repoUnavailableMessage(name, decl) {
+  if (name === BASE_ASSETS_REPO_NAME && !decl.path && !decl.url) {
+    return `Cannot resolve @skaile/base-assets. Set SKAILE_BASE_ASSETS_DIR or ensure the package is installed.`;
+  }
+  if (decl.url) {
+    return `Repository "${name}" (${decl.url}) is not available. Register it as a Library Source via \`skaile source add\`.`;
+  }
+  if (decl.path) {
+    return `Repository "${name}" path not found: ${decl.path}`;
+  }
+  return `Repository "${name}" has neither url nor path.`;
+}
+function findCatalogEntry(entries, query) {
+  if (query.kind) {
+    return entries.find((e) => e.kind === query.kind && e.name === query.name);
+  }
+  const matches = entries.filter((e) => e.name === query.name);
+  if (matches.length === 1) return matches[0];
+  return void 0;
+}
+
+export { BASE_ASSETS_REPO_NAME, resolveBaseAssetsRoot, resolveRuntimeAssets };
+//# sourceMappingURL=chunk-XEGHWFAX.js.map
+//# sourceMappingURL=chunk-XEGHWFAX.js.map

package/dist/chunk-XEGHWFAX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../core/src/runtime-assets.ts"],"names":["resolvePath","require"],"mappings":"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","file":"chunk-XEGHWFAX.js","sourcesContent":["/**\n * Runtime asset resolution — read `skaile.yaml`, scan all declared repositories\n * (including the built-in `base-assets/` directory as an implicit default), and\n * produce a unified view of mount/connector catalog entries plus the implicit\n * refs that `skaile.yaml` `mounts:` and `connectors:` sections add to the\n * dependency graph.\n *\n * This module is the single source of truth for \"which mounts/connectors does\n * this project see at runtime, and where do their implementations live on\n * disk\". Both the runner (serve, REPL, flow) and the platform's mid-session\n * `add_resource` flow consume `RuntimeAssetsResult.catalogEntries` and pass\n * it into `MountManager` / `ConnectorManager` for catalog-based resolution.\n *\n * `base-assets/` is a subdirectory of the single published `@skaile/workspaces`\n * package — not a standalone package. Its on-disk path is resolved with this\n * precedence:\n *   1. `process.env.SKAILE_BASE_ASSETS_DIR` — set by the agent container at\n *      runtime to point at `/app/base-assets/`.\n *   2. `require.resolve('@skaile/workspaces/package.json')` + `base-assets/` —\n *      works when `@skaile/workspaces` is installed as a dependency.\n *   3. Walk upward from this module's location for the `@skaile/workspaces`\n *      package root (a `package.json` whose `name` is `@skaile/workspaces`)\n *      that contains a `base-assets/` subdirectory. This is the dev-workspace\n *      fallback — it is bounded and works regardless of where the consumer\n *      lives in the tree.\n */\n\nimport { existsSync, lstatSync, readFileSync } from \"node:fs\";\nimport { dirname, join, resolve as resolvePath } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { createRequire } from \"node:module\";\nimport type { CatalogEntry } from \"./models.js\";\nimport { scanDirectory } from \"./manifest.js\";\nimport type { RepositoryDeclaration } from \"./workspace-config.js\";\nimport { resolveSkWorkspaceConfig } from \"./workspace-config.js\";\nimport { readLinks } from \"./repo-manager.js\";\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\n/**\n * Catalog entry filtered to mount/connector kinds. Same shape as `CatalogEntry`.\n * @docLink packages/core/concepts#runtime-catalog-entry\n */\nexport type RuntimeCatalogEntry = CatalogEntry;\n\n/**\n * Implicit catalog reference derived from a `mounts:` or `connectors:` declaration in `skaile.yaml`.\n * Each mount/connector driver becomes an implicit ref that must be resolved in the catalog.\n * @docLink packages/core/concepts#runtime-asset-ref\n */\nexport interface RuntimeAssetRef {\n  kind: \"mount\" | \"connector\";\n  /** Driver name — matches `RuntimeCatalogEntry.name`. */\n  name: string;\n  /** Source declaration id from `skaile.yaml`. */\n  declarationId: string;\n}\n\n/**\n * Aggregated npm packages required by all resolved mount/connector adapters.\n * Populated from `metadata.npm_deps` in each matched catalog entry.\n * @docLink packages/core/concepts#runtime-npm-deps\n */\nexport interface RuntimeNpmDeps {\n  required: string[];\n  optional: string[];\n}\n\n/**\n * Non-fatal warning emitted during `resolveRuntimeAssets` when a repo is unavailable\n * or a driver is not found in any catalog.\n * @docLink packages/core/concepts#runtime-asset-warning\n */\nexport interface RuntimeAssetWarning {\n  /** Stable code for filtering / structured logging. */\n  code: \"missing_driver\" | \"repo_unavailable\" | \"invalid_repo_decl\";\n  message: string;\n  /** Declaration id when applicable. */\n  declarationId?: string;\n  /** Driver / repository name when applicable. */\n  name?: string;\n}\n\n/**\n * Repository name used for the implicit `@skaile/base-assets` catalog entry.\n * Callers can override this repo by declaring `repositories: { base-assets: ... }` in `skaile.yaml`.\n * @docLink packages/core/concepts#base-assets-repo-name\n */\nexport const BASE_ASSETS_REPO_NAME = \"base-assets\";\n\n/**\n * Result of `resolveRuntimeAssets`.\n * The same object is mutated in place by `refresh()`, allowing callers to hold\n * a stable reference and observe updates after a new repository is cloned or\n * a driver is installed mid-session.\n * @docLink packages/core/concepts#runtime-assets-result\n */\nexport interface RuntimeAssetsResult {\n  catalogEntries: RuntimeCatalogEntry[];\n  implicitRefs: RuntimeAssetRef[];\n  requiredNpmDeps: RuntimeNpmDeps;\n  warnings: RuntimeAssetWarning[];\n  /** Re-scan repositories and re-derive implicit refs. Mutates in place. */\n  refresh(): Promise<void>;\n  /**\n   * Catalog lookup. When `kind` is omitted and both `mount:<name>` and\n   * `connector:<name>` exist, returns `undefined` (caller must disambiguate).\n   */\n  findEntry(query: { kind?: \"mount\" | \"connector\"; name: string }): RuntimeCatalogEntry | undefined;\n}\n\n// ─── Public API ───────────────────────────────────────────────────────────────\n\n/**\n * Resolve all runtime assets visible to a project by scanning declared repositories.\n *\n * Reads `skaile.yaml`, scans every declared repository (plus the implicit\n * `@skaile/base-assets` repo), and derives implicit refs from `mounts:` /\n * `connectors:` declarations. Does not clone or install anything — purely a\n * read-only scan of what is already on disk. URL-only repositories that have\n * not been cloned yet are reported as `repo_unavailable` warnings.\n *\n * @param projectDir - Absolute path to the project workspace root\n * @returns `RuntimeAssetsResult` with catalog entries, implicit refs, npm deps, and warnings\n * @docLink packages/core/concepts#resolve-runtime-assets\n */\nexport async function resolveRuntimeAssets(projectDir: string): Promise<RuntimeAssetsResult> {\n  const result: RuntimeAssetsResult = {\n    catalogEntries: [],\n    implicitRefs: [],\n    requiredNpmDeps: { required: [], optional: [] },\n    warnings: [],\n    refresh: async () => {\n      await populate(projectDir, result);\n    },\n    findEntry: (query) => findCatalogEntry(result.catalogEntries, query),\n  };\n\n  await populate(projectDir, result);\n  return result;\n}\n\n/**\n * Resolve the on-disk root of `@skaile/base-assets`.\n *\n * Resolution tiers:\n * 1. `SKAILE_BASE_ASSETS_DIR` env var\n * 2. `require.resolve('@skaile/workspaces/base-assets/package.json')` (npm install / hoisted)\n * 3. Walk upward from this module looking for `base-assets/package.json` or\n *    `ai-assets-skaile/package.json` (legacy shell-repo layout)\n *\n * @returns Absolute path to the `@skaile/base-assets` package directory\n * @throws When none of the three tiers can locate the package\n * @docLink packages/core/concepts#resolve-base-assets-root\n */\nexport function resolveBaseAssetsRoot(): string {\n  const envDir = process.env.SKAILE_BASE_ASSETS_DIR;\n  if (envDir && existsSync(envDir)) return resolvePath(envDir);\n\n  try {\n    const require = createRequire(import.meta.url);\n    const pkgJson = require.resolve(\"@skaile/workspaces/package.json\");\n    const candidate = join(dirname(pkgJson), \"base-assets\");\n    if (existsSync(candidate)) return candidate;\n  } catch {\n    // Fall through to workspace walk.\n  }\n\n  const workspaceHit = findInWorkspace(import.meta.url);\n  if (workspaceHit) return workspaceHit;\n\n  throw new Error(\n    `Cannot resolve the base-assets directory. ` +\n      `Set SKAILE_BASE_ASSETS_DIR to the on-disk path, ` +\n      `ensure @skaile/workspaces is installed, ` +\n      `or run from within the @skaile/workspaces package tree.`,\n  );\n}\n\n/**\n * Walk upward from `startUrl` looking for the `@skaile/workspaces` package\n * root — a directory whose `package.json` `name` is `@skaile/workspaces` and\n * which contains a `base-assets/` subdirectory. Bounded to 8 levels.\n */\nfunction findInWorkspace(startUrl: string): string | null {\n  let dir: string;\n  try {\n    dir = dirname(fileURLToPath(startUrl));\n  } catch {\n    return null;\n  }\n  for (let i = 0; i < 8; i++) {\n    const pkgPath = join(dir, \"package.json\");\n    const baseAssets = join(dir, \"base-assets\");\n    if (existsSync(pkgPath) && existsSync(baseAssets)) {\n      try {\n        const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\")) as { name?: string };\n        if (pkg.name === \"@skaile/workspaces\") return baseAssets;\n      } catch {\n        // Ignore malformed package.json and keep walking.\n      }\n    }\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return null;\n}\n\n// ─── Internals ────────────────────────────────────────────────────────────────\n\nasync function populate(projectDir: string, target: RuntimeAssetsResult): Promise<void> {\n  target.catalogEntries = [];\n  target.implicitRefs = [];\n  target.requiredNpmDeps = { required: [], optional: [] };\n  target.warnings = [];\n\n  const config = resolveSkWorkspaceConfig(projectDir);\n  const repositories = buildEffectiveRepositories(config.repositories);\n  const links = readLinks(projectDir);\n\n  // Scan each repository for mount + connector entries.\n  for (const [name, decl] of Object.entries(repositories)) {\n    const repoDir = resolveRepoDir(name, decl, projectDir, links);\n    if (!repoDir) {\n      target.warnings.push({\n        code: \"repo_unavailable\",\n        name,\n        message: repoUnavailableMessage(name, decl),\n      });\n      continue;\n    }\n    try {\n      const entries = scanDirectory(repoDir, name).filter(\n        (e) => e.kind === \"mount\" || e.kind === \"connector\",\n      );\n      target.catalogEntries.push(...entries);\n    } catch (err) {\n      target.warnings.push({\n        code: \"repo_unavailable\",\n        name,\n        message: `Failed to scan repository \"${name}\" at ${repoDir}: ${\n          err instanceof Error ? err.message : String(err)\n        }`,\n      });\n    }\n  }\n\n  // Derive implicit refs from skaile.yaml mounts/connectors.\n  for (const m of config.mounts ?? []) {\n    target.implicitRefs.push({ kind: \"mount\", name: m.driver, declarationId: m.id });\n  }\n  for (const c of config.connectors ?? []) {\n    target.implicitRefs.push({ kind: \"connector\", name: c.driver, declarationId: c.id });\n  }\n\n  // Validate refs and aggregate npm deps.\n  const requiredSet = new Set<string>();\n  const optionalSet = new Set<string>();\n  for (const ref of target.implicitRefs) {\n    const entry = findCatalogEntry(target.catalogEntries, ref);\n    if (!entry) {\n      target.warnings.push({\n        code: \"missing_driver\",\n        declarationId: ref.declarationId,\n        name: ref.name,\n        message:\n          `Unknown ${ref.kind} driver \"${ref.name}\" referenced by ${ref.kind} \"${ref.declarationId}\". ` +\n          `Run \\`skaile ${ref.kind} catalog\\` to see available drivers, ` +\n          `or declare a repository in skaile.yaml that provides this driver.`,\n      });\n      continue;\n    }\n    const npm = (entry.metadata?.npm_deps ?? {}) as { required?: string[]; optional?: string[] };\n    for (const p of npm.required ?? []) requiredSet.add(p);\n    for (const p of npm.optional ?? []) optionalSet.add(p);\n  }\n  target.requiredNpmDeps.required = [...requiredSet];\n  target.requiredNpmDeps.optional = [...optionalSet];\n}\n\n/**\n * Build the effective `repositories` map: caller's declarations first, then\n * the implicit `base-assets` repo if absent. Caller's entries always win — an\n * org can override the default by declaring `repositories: { base-assets: {...} }`.\n */\nfunction buildEffectiveRepositories(\n  declared: Record<string, RepositoryDeclaration> | undefined,\n): Record<string, RepositoryDeclaration> {\n  const result: Record<string, RepositoryDeclaration> = { ...(declared ?? {}) };\n  if (!result[BASE_ASSETS_REPO_NAME]) {\n    try {\n      const baseDir = resolveBaseAssetsRoot();\n      result[BASE_ASSETS_REPO_NAME] = { path: baseDir };\n    } catch (err) {\n      // Surface as a warning during scan rather than throwing here — let the\n      // caller decide whether base-assets is required for this project.\n      // We re-discover the failure in resolveRepoDir() and emit there.\n      result[BASE_ASSETS_REPO_NAME] = { path: \"\" };\n    }\n  }\n  return result;\n}\n\n/**\n * Resolve a repository declaration to an on-disk directory. Order:\n *   1. Linked override (`.skaile/links.yaml`).\n *   2. Local `path` — relative to `projectDir`.\n *   3. Cloned URL repo at `.skaile/repos/<name>/` (must already exist).\n *\n * Returns `null` when none of these resolve. Does not clone.\n */\nfunction resolveRepoDir(\n  name: string,\n  decl: RepositoryDeclaration,\n  projectDir: string,\n  links: Record<string, string>,\n): string | null {\n  // 1. Linked override\n  const linked = links[name];\n  if (linked && existsSync(linked)) return linked;\n\n  // 2. Local path\n  if (decl.path) {\n    const resolved = resolvePath(projectDir, decl.path);\n    return existsSync(resolved) ? resolved : null;\n  }\n\n  // 3. URL repo cloned to project's .skaile/repos/<name>\n  if (decl.url) {\n    const projectDest = join(projectDir, \".skaile\", \"repos\", name);\n    if (existsSync(projectDest)) {\n      // Either a real directory or a symlink to the global cache.\n      try {\n        return lstatSync(projectDest).isSymbolicLink() ? projectDest : projectDest;\n      } catch {\n        return null;\n      }\n    }\n    return null;\n  }\n\n  return null;\n}\n\nfunction repoUnavailableMessage(name: string, decl: RepositoryDeclaration): string {\n  if (name === BASE_ASSETS_REPO_NAME && !decl.path && !decl.url) {\n    return (\n      `Cannot resolve @skaile/base-assets. ` +\n      `Set SKAILE_BASE_ASSETS_DIR or ensure the package is installed.`\n    );\n  }\n  if (decl.url) {\n    return `Repository \"${name}\" (${decl.url}) is not available. Register it as a Library Source via \\`skaile source add\\`.`;\n  }\n  if (decl.path) {\n    return `Repository \"${name}\" path not found: ${decl.path}`;\n  }\n  return `Repository \"${name}\" has neither url nor path.`;\n}\n\nfunction findCatalogEntry(\n  entries: RuntimeCatalogEntry[],\n  query: { kind?: \"mount\" | \"connector\"; name: string },\n): RuntimeCatalogEntry | undefined {\n  if (query.kind) {\n    return entries.find((e) => e.kind === query.kind && e.name === query.name);\n  }\n  const matches = entries.filter((e) => e.name === query.name);\n  if (matches.length === 1) return matches[0];\n  // 0 or >1 with no kind — caller must disambiguate.\n  return undefined;\n}\n"]}

package/dist/chunk-XOSBNBB6.js

@@ -0,0 +1,155 @@
+// transport/src/ws/server.ts
+function validateSessionInitShape(cmd) {
+  if (cmd.type !== "session_init") return "type must be 'session_init'";
+  const identity = cmd.identity;
+  if (!identity || typeof identity !== "object" || Array.isArray(identity)) {
+    return "identity must be an object";
+  }
+  if (typeof identity.containerId !== "string") return "identity.containerId must be a string";
+  if (typeof identity.sessionId !== "string") return "identity.sessionId must be a string";
+  if (typeof identity.projectId !== "string") return "identity.projectId must be a string";
+  const protocolVersion = cmd.protocolVersion;
+  if (!protocolVersion || typeof protocolVersion !== "object" || Array.isArray(protocolVersion)) {
+    return "protocolVersion must be an object";
+  }
+  if (typeof protocolVersion.major !== "number") return "protocolVersion.major must be a number";
+  if (typeof protocolVersion.minor !== "number") return "protocolVersion.minor must be a number";
+  if (typeof protocolVersion.patch !== "number") return "protocolVersion.patch must be a number";
+  if (!cmd.resolvedConfig || typeof cmd.resolvedConfig !== "object" || Array.isArray(cmd.resolvedConfig)) {
+    return "resolvedConfig must be an object";
+  }
+  if (!cmd.credentials || typeof cmd.credentials !== "object" || Array.isArray(cmd.credentials)) {
+    return "credentials must be an object";
+  }
+  return null;
+}
+var WebSocketServerTransport = class {
+  server = null;
+  activeClient = null;
+  port;
+  log;
+  commandHandlers = /* @__PURE__ */ new Set();
+  connectHandlers = /* @__PURE__ */ new Set();
+  disconnectHandlers = /* @__PURE__ */ new Set();
+  constructor(options) {
+    this.port = options.port;
+    this.log = options.onLog ?? console.log;
+  }
+  /** Start the server and accept connections. */
+  async listen() {
+    this.server = Bun.serve({
+      port: this.port,
+      fetch: (req, server) => {
+        if (server.upgrade(req, { data: {} })) return;
+        return new Response("skaile agent server", { status: 200 });
+      },
+      websocket: {
+        open: (ws) => {
+          if (this.activeClient) {
+            this.log("[ws-server] replacing previous connection");
+            try {
+              this.activeClient.close?.(
+                4001,
+                "Replaced by new connection"
+              );
+            } catch {
+            }
+          }
+          this.log("[ws-server] client connected");
+          this.activeClient = ws;
+          for (const handler of this.connectHandlers) {
+            handler();
+          }
+        },
+        message: (_ws, data) => {
+          try {
+            const parsed = JSON.parse(String(data));
+            if (parsed && typeof parsed === "object" && parsed.type === "session_init") {
+              const reason = validateSessionInitShape(parsed);
+              if (reason !== null) {
+                this.log(`[ws-server] rejecting invalid session_init: ${reason}`);
+                this.sendRaw({
+                  type: "error",
+                  message: `Invalid session_init: ${reason}`,
+                  fatal: false
+                });
+                return;
+              }
+            }
+            const cmd = parsed;
+            for (const handler of this.commandHandlers) {
+              handler(cmd);
+            }
+          } catch (err) {
+            this.sendRaw({
+              type: "error",
+              message: `Invalid message: ${err instanceof Error ? err.message : String(err)}`,
+              fatal: false
+            });
+          }
+        },
+        close: (ws) => {
+          this.log("[ws-server] client disconnected");
+          if (this.activeClient === ws) {
+            this.activeClient = null;
+            for (const handler of this.disconnectHandlers) {
+              handler();
+            }
+          }
+        }
+      }
+    });
+    this.log(`[ws-server] listening on port ${this.server.port}`);
+  }
+  /**
+   * Stop the server.
+   *
+   * Passes `true` to `Bun.serve.stop()` so active WebSocket connections are
+   * closed immediately — otherwise a still-connected client would keep the
+   * event loop alive and block process shutdown.
+   */
+  async close() {
+    if (this.server) {
+      this.server.stop(true);
+      this.server = null;
+      this.activeClient = null;
+    }
+  }
+  send(event) {
+    this.sendRaw(event);
+  }
+  onCommand(handler) {
+    this.commandHandlers.add(handler);
+    return () => {
+      this.commandHandlers.delete(handler);
+    };
+  }
+  onConnect(handler) {
+    this.connectHandlers.add(handler);
+    return () => {
+      this.connectHandlers.delete(handler);
+    };
+  }
+  onDisconnect(handler) {
+    this.disconnectHandlers.add(handler);
+    return () => {
+      this.disconnectHandlers.delete(handler);
+    };
+  }
+  get connected() {
+    return this.activeClient !== null;
+  }
+  sendRaw(data) {
+    try {
+      const client = this.activeClient;
+      if (client?.readyState === 1 && client.send) {
+        client.send(JSON.stringify(data));
+      }
+    } catch {
+    }
+  }
+};
+
+export { WebSocketServerTransport };
+//# sourceMappingURL=chunk-XOSBNBB6.js.map
+//# sourceMappingURL=chunk-XOSBNBB6.js.map

package/dist/chunk-XOSBNBB6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../transport/src/ws/server.ts"],"names":[],"mappings":"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","file":"chunk-XOSBNBB6.js","sourcesContent":["/**\n * WebSocketServerTransport — Bun.serve-based WebSocket server.\n *\n * Accepts one client at a time. Implements ServerTransport from @skaile/workspaces/types.\n */\n\nimport type { AgentCommand, AgentEvent, ServerTransport } from \"@skaile/workspaces/types\";\n\n/**\n * Options for {@link WebSocketServerTransport}.\n *\n * @param port - TCP port to bind to.\n * @param onLog - Optional callback for internal log lines (client connect/disconnect events).\n *\n * @docLink packages/transport/dev-guide#websocket-server-transport\n */\nexport interface WebSocketServerOptions {\n  port: number;\n  onLog?: (line: string) => void;\n}\n\n/**\n * Shape-validate a `session_init` frame at ingress before forwarding to the\n * runner. Protocol v3 requires the deterministic bootstrap envelope to carry\n * an identity tuple, a semver-shaped `protocolVersion`, a resolved config\n * object, and a `credentials` map keyed by `mounts` / `connectors`. Frames\n * that fail the guard are rejected on the wire so the runner never sees a\n * malformed boot envelope.\n *\n * Returns `null` when the frame is well-formed, or a human-readable reason\n * when it should be rejected.\n *\n * Spec: `_devlog/specs/2026-05-10-deterministic-session-bootstrap.md`\n * § \"SessionInitCommand schema\".\n *\n * @internal\n */\nfunction validateSessionInitShape(cmd: Record<string, unknown>): string | null {\n  if (cmd.type !== \"session_init\") return \"type must be 'session_init'\";\n\n  const identity = cmd.identity as Record<string, unknown> | undefined;\n  if (!identity || typeof identity !== \"object\" || Array.isArray(identity)) {\n    return \"identity must be an object\";\n  }\n  if (typeof identity.containerId !== \"string\") return \"identity.containerId must be a string\";\n  if (typeof identity.sessionId !== \"string\") return \"identity.sessionId must be a string\";\n  if (typeof identity.projectId !== \"string\") return \"identity.projectId must be a string\";\n\n  const protocolVersion = cmd.protocolVersion as Record<string, unknown> | undefined;\n  if (!protocolVersion || typeof protocolVersion !== \"object\" || Array.isArray(protocolVersion)) {\n    return \"protocolVersion must be an object\";\n  }\n  if (typeof protocolVersion.major !== \"number\") return \"protocolVersion.major must be a number\";\n  if (typeof protocolVersion.minor !== \"number\") return \"protocolVersion.minor must be a number\";\n  if (typeof protocolVersion.patch !== \"number\") return \"protocolVersion.patch must be a number\";\n\n  if (\n    !cmd.resolvedConfig ||\n    typeof cmd.resolvedConfig !== \"object\" ||\n    Array.isArray(cmd.resolvedConfig)\n  ) {\n    return \"resolvedConfig must be an object\";\n  }\n\n  if (!cmd.credentials || typeof cmd.credentials !== \"object\" || Array.isArray(cmd.credentials)) {\n    return \"credentials must be an object\";\n  }\n\n  return null;\n}\n\n/**\n * `ServerTransport` implementation backed by `Bun.serve` with WebSocket upgrade.\n *\n * Enforces a single-client policy: if a new connection arrives while a client is\n * already connected, the stale connection is closed with code 4001 and replaced.\n * Incoming frames are parsed as JSON `AgentCommand` messages and fanned out to\n * registered `onCommand` handlers; outgoing `AgentEvent` objects are JSON-serialised\n * before sending. Call `listen()` to start accepting connections and `close()` to\n * shut down cleanly — `close()` passes `true` to `Bun.serve.stop()` so active\n * WebSocket connections are terminated immediately rather than keeping the event loop alive.\n *\n * @example\n * ```ts\n * const server = new WebSocketServerTransport({ port: 8080 });\n * await server.listen();\n * server.onCommand((cmd) => console.log(cmd));\n * server.send({ type: 'agent_end' });\n * await server.close();\n * ```\n *\n * @docLink packages/transport/dev-guide#websocket-server-transport\n */\nexport class WebSocketServerTransport implements ServerTransport {\n  private server: ReturnType<typeof Bun.serve> | null = null;\n  private activeClient: unknown = null;\n  private readonly port: number;\n  private readonly log: (line: string) => void;\n\n  private readonly commandHandlers = new Set<(command: AgentCommand) => void>();\n  private readonly connectHandlers = new Set<() => void>();\n  private readonly disconnectHandlers = new Set<() => void>();\n\n  constructor(options: WebSocketServerOptions) {\n    this.port = options.port;\n    this.log = options.onLog ?? console.log;\n  }\n\n  /** Start the server and accept connections. */\n  async listen(): Promise<void> {\n    this.server = Bun.serve({\n      port: this.port,\n      fetch: (req, server) => {\n        if (server.upgrade(req, { data: {} })) return;\n        return new Response(\"skaile agent server\", { status: 200 });\n      },\n      websocket: {\n        open: (ws) => {\n          if (this.activeClient) {\n            // Close the stale connection instead of rejecting the new one.\n            // This handles the race where waitForWsReady's probe hasn't\n            // fully disconnected before the real gateway client connects.\n            this.log(\"[ws-server] replacing previous connection\");\n            try {\n              (this.activeClient as { close?: (code: number, reason: string) => void }).close?.(\n                4001,\n                \"Replaced by new connection\",\n              );\n            } catch {\n              // already closed\n            }\n          }\n          this.log(\"[ws-server] client connected\");\n          this.activeClient = ws;\n          for (const handler of this.connectHandlers) {\n            handler();\n          }\n        },\n        message: (_ws, data) => {\n          try {\n            const parsed = JSON.parse(String(data)) as Record<string, unknown>;\n            // Protocol v3: shape-validate `session_init` at ingress so the\n            // runner never receives a malformed boot envelope. Other command\n            // shapes pass through unchanged — invalid `AgentCommand`s surface\n            // through the existing per-command handlers in serve.ts.\n            if (parsed && typeof parsed === \"object\" && parsed.type === \"session_init\") {\n              const reason = validateSessionInitShape(parsed);\n              if (reason !== null) {\n                this.log(`[ws-server] rejecting invalid session_init: ${reason}`);\n                this.sendRaw({\n                  type: \"error\",\n                  message: `Invalid session_init: ${reason}`,\n                  fatal: false,\n                });\n                return;\n              }\n            }\n            const cmd = parsed as unknown as AgentCommand;\n            for (const handler of this.commandHandlers) {\n              handler(cmd);\n            }\n          } catch (err) {\n            this.sendRaw({\n              type: \"error\",\n              message: `Invalid message: ${err instanceof Error ? err.message : String(err)}`,\n              fatal: false,\n            });\n          }\n        },\n        close: (ws) => {\n          this.log(\"[ws-server] client disconnected\");\n          if (this.activeClient === ws) {\n            this.activeClient = null;\n            for (const handler of this.disconnectHandlers) {\n              handler();\n            }\n          }\n        },\n      },\n    });\n\n    this.log(`[ws-server] listening on port ${this.server.port}`);\n  }\n\n  /**\n   * Stop the server.\n   *\n   * Passes `true` to `Bun.serve.stop()` so active WebSocket connections are\n   * closed immediately — otherwise a still-connected client would keep the\n   * event loop alive and block process shutdown.\n   */\n  async close(): Promise<void> {\n    if (this.server) {\n      this.server.stop(true);\n      this.server = null;\n      this.activeClient = null;\n    }\n  }\n\n  send(event: AgentEvent): void {\n    this.sendRaw(event);\n  }\n\n  onCommand(handler: (command: AgentCommand) => void): () => void {\n    this.commandHandlers.add(handler);\n    return () => {\n      this.commandHandlers.delete(handler);\n    };\n  }\n\n  onConnect(handler: () => void): () => void {\n    this.connectHandlers.add(handler);\n    return () => {\n      this.connectHandlers.delete(handler);\n    };\n  }\n\n  onDisconnect(handler: () => void): () => void {\n    this.disconnectHandlers.add(handler);\n    return () => {\n      this.disconnectHandlers.delete(handler);\n    };\n  }\n\n  get connected(): boolean {\n    return this.activeClient !== null;\n  }\n\n  private sendRaw(data: unknown): void {\n    try {\n      const client = this.activeClient as {\n        readyState?: number;\n        send?: (data: string) => void;\n      } | null;\n      if (client?.readyState === 1 && client.send) {\n        client.send(JSON.stringify(data));\n      }\n    } catch {\n      // Silently ignore send failures\n    }\n  }\n}\n"]}

package/dist/chunk-Y46TBPLI.js

@@ -0,0 +1,97 @@
+import { randomUUID } from 'crypto';
+
+// telemetry/src/noop.ts
+var noopSpan = (traceId) => ({
+  spanId: randomUUID().slice(0, 16),
+  traceId
+});
+var NoopTelemetryProvider = class {
+  startTrace(opts) {
+    const traceId = randomUUID().replace(/-/g, "");
+    return { traceId, rootSpan: noopSpan(traceId) };
+  }
+  endTrace(_trace, _result) {
+  }
+  startSpan(parent, _opts) {
+    return noopSpan(parent.traceId);
+  }
+  endSpan(_span, _result) {
+  }
+  addEvent(_span, _name, _attrs) {
+  }
+  logGeneration(_span, _generation) {
+  }
+  recordMetric(_name, _value, _tags) {
+  }
+  async flush() {
+  }
+  async shutdown() {
+  }
+};
+
+// telemetry/src/config.ts
+var DEFAULT_CAPTURE = {
+  llm_generations: true,
+  tool_calls: true,
+  connector_ops: true,
+  mount_ops: true,
+  flow_state_changes: true,
+  prompt_content: false
+};
+var DEFAULT_TELEMETRY_CONFIG = {
+  provider: "none",
+  samplingRate: 1,
+  batchSize: 100,
+  exportIntervalMs: 5e3,
+  capture: { ...DEFAULT_CAPTURE }
+};
+function resolveTelemetryConfig(raw) {
+  const envProvider = process.env.SKAILE_TELEMETRY_PROVIDER;
+  const envEndpoint = process.env.SKAILE_TELEMETRY_ENDPOINT;
+  const envAuth = process.env.LANGFUSE_PUBLIC_KEY;
+  const envSecret = process.env.LANGFUSE_SECRET_KEY;
+  const rawCapture = raw.capture ?? {};
+  const provider = envProvider === "otel" || envProvider === "none" ? envProvider : raw.provider === "otel" ? "otel" : DEFAULT_TELEMETRY_CONFIG.provider;
+  return {
+    provider,
+    endpoint: envEndpoint ?? raw.endpoint ?? DEFAULT_TELEMETRY_CONFIG.endpoint,
+    auth: envAuth ?? raw.auth ?? DEFAULT_TELEMETRY_CONFIG.auth,
+    secretKey: envSecret ?? raw.secret_key ?? DEFAULT_TELEMETRY_CONFIG.secretKey,
+    samplingRate: raw.sampling_rate ?? DEFAULT_TELEMETRY_CONFIG.samplingRate,
+    batchSize: raw.batch_size ?? DEFAULT_TELEMETRY_CONFIG.batchSize,
+    exportIntervalMs: raw.export_interval_ms ?? DEFAULT_TELEMETRY_CONFIG.exportIntervalMs,
+    capture: {
+      ...DEFAULT_CAPTURE,
+      ...rawCapture
+    }
+  };
+}
+
+// telemetry/src/context.ts
+var _provider = new NoopTelemetryProvider();
+var _config;
+async function initTelemetry(rawConfig) {
+  const config = resolveTelemetryConfig(rawConfig ?? {});
+  _config = config;
+  if (config.provider === "none") {
+    _provider = new NoopTelemetryProvider();
+    return _provider;
+  }
+  if (config.provider === "otel") {
+    const { OtelTelemetryProvider } = await import('./provider-QXKEDXWJ.js');
+    _provider = await OtelTelemetryProvider.create(config);
+    return _provider;
+  }
+  _provider = new NoopTelemetryProvider();
+  return _provider;
+}
+function getTelemetry() {
+  return _provider;
+}
+function getTelemetryConfig() {
+  return _config;
+}
+
+export { DEFAULT_TELEMETRY_CONFIG, NoopTelemetryProvider, getTelemetry, getTelemetryConfig, initTelemetry, resolveTelemetryConfig };
+//# sourceMappingURL=chunk-Y46TBPLI.js.map
+//# sourceMappingURL=chunk-Y46TBPLI.js.map

package/dist/chunk-Y46TBPLI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../telemetry/src/noop.ts","../telemetry/src/config.ts","../telemetry/src/context.ts"],"names":[],"mappings":"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","file":"chunk-Y46TBPLI.js","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type {\n  Attributes,\n  GenerationEvent,\n  Span,\n  SpanOptions,\n  SpanResult,\n  TelemetryProvider,\n  Trace,\n  TraceOptions,\n} from \"./types.js\";\n\nconst noopSpan = (traceId: string): Span => ({\n  spanId: randomUUID().slice(0, 16),\n  traceId,\n});\n\n/**\n * Zero-cost telemetry provider. All methods are stubs that return\n * valid objects but perform no I/O. Used when telemetry is disabled\n * (the default).\n *\n * `initTelemetry()` installs this provider when `provider: \"none\"` (the default)\n * or when no config is supplied. Bridge, runner, and connector packages receive\n * it via constructor injection and call its methods without any guard — every\n * call is a no-op with negligible overhead.\n *\n * @docLink packages/telemetry/concepts#noop-telemetry-provider\n */\nexport class NoopTelemetryProvider implements TelemetryProvider {\n  startTrace(opts: TraceOptions): Trace {\n    const traceId = randomUUID().replace(/-/g, \"\");\n    return { traceId, rootSpan: noopSpan(traceId) };\n  }\n\n  endTrace(_trace: Trace, _result?: SpanResult): void {}\n\n  startSpan(parent: Trace | Span, _opts: SpanOptions): Span {\n    return noopSpan(parent.traceId);\n  }\n\n  endSpan(_span: Span, _result?: SpanResult): void {}\n\n  addEvent(_span: Span, _name: string, _attrs?: Attributes): void {}\n\n  logGeneration(_span: Span, _generation: GenerationEvent): void {}\n\n  recordMetric(_name: string, _value: number, _tags?: Record<string, string>): void {}\n\n  async flush(): Promise<void> {}\n\n  async shutdown(): Promise<void> {}\n}\n","import type { TelemetryCaptureConfig, TelemetryConfig } from \"./types.js\";\n\nconst DEFAULT_CAPTURE: TelemetryCaptureConfig = {\n  llm_generations: true,\n  tool_calls: true,\n  connector_ops: true,\n  mount_ops: true,\n  flow_state_changes: true,\n  prompt_content: false,\n};\n\n/**\n * Baseline {@link TelemetryConfig} used when no `telemetry:` block is present\n * in `skaile.yaml` and no environment variables are set. Provider is `\"none\"`,\n * so no I/O occurs. All capture flags except `prompt_content` are enabled so\n * that switching to `\"otel\"` produces useful traces without further config.\n *\n * @docLink packages/telemetry/concepts#configuration\n */\nexport const DEFAULT_TELEMETRY_CONFIG: TelemetryConfig = {\n  provider: \"none\",\n  samplingRate: 1.0,\n  batchSize: 100,\n  exportIntervalMs: 5000,\n  capture: { ...DEFAULT_CAPTURE },\n};\n\n/**\n * Resolve telemetry configuration from a partial config object (typically\n * the `telemetry:` section of skaile.yaml) plus environment variable\n * overrides.\n *\n * Precedence (highest first):\n * 1. Environment variables (`SKAILE_TELEMETRY_PROVIDER`, `SKAILE_TELEMETRY_ENDPOINT`,\n *    `LANGFUSE_PUBLIC_KEY`, `LANGFUSE_SECRET_KEY`)\n * 2. Fields in `raw` (from `skaile.yaml`)\n * 3. {@link DEFAULT_TELEMETRY_CONFIG} fallbacks\n *\n * @param raw - Unvalidated object from the `telemetry:` YAML section. Pass `{}`\n *   when no config file is present.\n * @returns A fully-resolved {@link TelemetryConfig} with all fields present.\n * @docLink packages/telemetry/concepts#configuration\n */\nexport function resolveTelemetryConfig(raw: Record<string, unknown>): TelemetryConfig {\n  const envProvider = process.env.SKAILE_TELEMETRY_PROVIDER;\n  const envEndpoint = process.env.SKAILE_TELEMETRY_ENDPOINT;\n  const envAuth = process.env.LANGFUSE_PUBLIC_KEY;\n  const envSecret = process.env.LANGFUSE_SECRET_KEY;\n\n  const rawCapture = (raw.capture ?? {}) as Partial<TelemetryCaptureConfig>;\n\n  const provider =\n    envProvider === \"otel\" || envProvider === \"none\"\n      ? envProvider\n      : raw.provider === \"otel\"\n        ? \"otel\"\n        : DEFAULT_TELEMETRY_CONFIG.provider;\n\n  return {\n    provider,\n    endpoint:\n      envEndpoint ?? (raw.endpoint as string | undefined) ?? DEFAULT_TELEMETRY_CONFIG.endpoint,\n    auth: envAuth ?? (raw.auth as string | undefined) ?? DEFAULT_TELEMETRY_CONFIG.auth,\n    secretKey:\n      envSecret ?? (raw.secret_key as string | undefined) ?? DEFAULT_TELEMETRY_CONFIG.secretKey,\n    samplingRate:\n      (raw.sampling_rate as number | undefined) ?? DEFAULT_TELEMETRY_CONFIG.samplingRate,\n    batchSize: (raw.batch_size as number | undefined) ?? DEFAULT_TELEMETRY_CONFIG.batchSize,\n    exportIntervalMs:\n      (raw.export_interval_ms as number | undefined) ?? DEFAULT_TELEMETRY_CONFIG.exportIntervalMs,\n    capture: {\n      ...DEFAULT_CAPTURE,\n      ...rawCapture,\n    },\n  };\n}\n","import type { TelemetryConfig, TelemetryProvider } from \"./types.js\";\nimport { NoopTelemetryProvider } from \"./noop.js\";\nimport { resolveTelemetryConfig } from \"./config.js\";\n\nlet _provider: TelemetryProvider = new NoopTelemetryProvider();\nlet _config: TelemetryConfig | undefined;\n\n/**\n * Initialize the global telemetry provider. Called once at the entry point\n * (CLI command, startAgentServer, startAgentRepl). Lazy-loads the OTEL\n * provider when configured.\n *\n * This is the ONLY module-level state in the telemetry package. Packages\n * like bridge and connectors receive the provider via constructor injection\n * from the runner — they never call this function.\n *\n * @param rawConfig - The unvalidated `telemetry:` section of `skaile.yaml`, or\n *   `undefined` to use defaults (noop, no I/O).\n * @returns The initialized {@link TelemetryProvider} (noop or OTEL).\n * @docLink packages/telemetry/concepts#init-telemetry\n */\nexport async function initTelemetry(\n  rawConfig?: Record<string, unknown>,\n): Promise<TelemetryProvider> {\n  const config = resolveTelemetryConfig(rawConfig ?? {});\n  _config = config;\n\n  if (config.provider === \"none\") {\n    _provider = new NoopTelemetryProvider();\n    return _provider;\n  }\n\n  if (config.provider === \"otel\") {\n    const { OtelTelemetryProvider } = await import(\"./otel/provider.js\");\n    _provider = await OtelTelemetryProvider.create(config);\n    return _provider;\n  }\n\n  _provider = new NoopTelemetryProvider();\n  return _provider;\n}\n\n/**\n * Get the current telemetry provider. Returns the {@link NoopTelemetryProvider}\n * if {@link initTelemetry} has not yet been called.\n *\n * Bridge, runner, and connector packages use this only during construction —\n * they store the result and never call `getTelemetry()` on every span.\n *\n * @returns The active {@link TelemetryProvider}.\n * @docLink packages/telemetry/concepts#init-telemetry\n */\nexport function getTelemetry(): TelemetryProvider {\n  return _provider;\n}\n\n/**\n * Get the resolved {@link TelemetryConfig}. Returns `undefined` before\n * {@link initTelemetry} is called.\n *\n * @returns The resolved config, or `undefined` if not yet initialized.\n * @docLink packages/telemetry/concepts#init-telemetry\n */\nexport function getTelemetryConfig(): TelemetryConfig | undefined {\n  return _config;\n}\n"]}