@dxos/config 0.9.1-main.c7dcc2e112 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/config",
-  "version": "0.9.1-main.c7dcc2e112",
+  "version": "0.10.0",
   "description": "Config utilities",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -77,20 +77,20 @@
     "src"
   ],
   "dependencies": {
-    "@effect/platform": "0.96.1",
-    "effect": "3.21.3",
+    "@effect/platform": "0.96.2",
+    "effect": "3.21.4",
     "localforage": "^1.10.0",
     "lodash.defaultsdeep": "^4.6.1",
     "lodash.ismatch": "^4.4.0",
     "pkg-up": "^3.1.0",
     "yaml": "^2.8.2",
-    "@dxos/client-protocol": "0.9.1-main.c7dcc2e112",
-    "@dxos/invariant": "0.9.1-main.c7dcc2e112",
-    "@dxos/log": "0.9.1-main.c7dcc2e112",
-    "@dxos/protocols": "0.9.1-main.c7dcc2e112",
-    "@dxos/tracing": "0.9.1-main.c7dcc2e112",
-    "@dxos/node-std": "0.9.1-main.c7dcc2e112",
-    "@dxos/util": "0.9.1-main.c7dcc2e112"
+    "@dxos/client-protocol": "0.10.0",
+    "@dxos/invariant": "0.10.0",
+    "@dxos/log": "0.10.0",
+    "@dxos/node-std": "0.10.0",
+    "@dxos/protocols": "0.10.0",
+    "@dxos/util": "0.10.0",
+    "@dxos/tracing": "0.10.0"
   },
   "devDependencies": {
     "@types/lodash.defaultsdeep": "^4.6.6",

package/src/edge-services.ts

@@ -0,0 +1,49 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { type Config } from './config';
+
+/**
+ * Canonical names for EDGE (Cloudflare Worker) services.
+ * Used as keys into `runtime.services.edgeServices` and {@link EDGE_SERVICE_DEFAULTS}.
+ */
+export const EdgeServiceName = Object.freeze({
+  Calls: 'calls',
+  Image: 'image',
+  Transcription: 'transcription',
+  Discord: 'discord',
+  CorsProxy: 'cors-proxy',
+  ApiProxy: 'api-proxy',
+  Introspect: 'introspect',
+  ChatAgent: 'chat-agent',
+} as const);
+
+export type EdgeServiceName = (typeof EdgeServiceName)[keyof typeof EdgeServiceName];
+
+/**
+ * Canonical dev/test default endpoints for EDGE services.
+ * Single source of truth for the URLs previously hard-coded across plugins.
+ * Production values are supplied per-app via `dx.yml` (`runtime.services.edgeServices`).
+ */
+export const EDGE_SERVICE_DEFAULTS: Readonly<Record<EdgeServiceName, string>> = Object.freeze({
+  [EdgeServiceName.Calls]: 'https://calls-service.dxos.workers.dev',
+  [EdgeServiceName.Image]: 'https://image-service-main.dxos.workers.dev',
+  [EdgeServiceName.Transcription]: 'https://calls-service.dxos.workers.dev',
+  [EdgeServiceName.Discord]: 'https://discord-service.dxos.workers.dev',
+  [EdgeServiceName.CorsProxy]: 'https://cors-proxy.dxos.workers.dev',
+  [EdgeServiceName.ApiProxy]: 'https://api-proxy.dxos.workers.dev',
+  [EdgeServiceName.Introspect]: 'https://introspect-service-labs.dxos.workers.dev/mcp',
+  [EdgeServiceName.ChatAgent]: 'wss://chat-agent-labs.dxos.workers.dev',
+});
+
+/**
+ * Resolve the endpoint for an EDGE service.
+ * Prefers the matching `runtime.services.edgeServices` entry, falling back to the canonical
+ * {@link EDGE_SERVICE_DEFAULTS} entry.
+ * `name` is expected to be unique; on duplicates the last entry wins so a later override is
+ * not silently shadowed by an earlier one (proto cannot enforce uniqueness on a repeated field).
+ */
+export const getEdgeServiceEndpoint = (config: Config, name: EdgeServiceName): string =>
+  config.values.runtime?.services?.edgeServices?.findLast((service) => service.name === name)?.endpoint ??
+  EDGE_SERVICE_DEFAULTS[name];

package/src/index.ts

@@ -9,6 +9,7 @@ export { type Config as ConfigProto } from '@dxos/protocols/proto/dxos/config';
 
 export * from './config';
 export * from './config-service';
+export * from './edge-services';
 export * from '#loaders';
 export * from '#savers';
 export * from '#plugin';

package/src/preset.ts

@@ -12,9 +12,33 @@ export type ConfigPresetOptions = {
    * @default main
    */
   edge?: 'local' | 'dev' | 'main' | 'production';
+
+  /**
+   * Sandbox service (standalone worker; API at /api/sandbox).
+   */
+  sandbox?: 'local' | 'dev' | 'main' | 'production';
 };
 
-export const configPreset = ({ edge = 'main' }: ConfigPresetOptions = {}) =>
+const edgeUrl = (edge: NonNullable<ConfigPresetOptions['edge']>) =>
+  Match.value(edge).pipe(
+    Match.when('local', () => 'http://localhost:8787'),
+    Match.when('dev', () => 'https://edge.dxos.workers.dev'),
+    Match.when('main', () => 'https://edge-main.dxos.workers.dev'),
+    Match.when('production', () => 'https://edge-production.dxos.workers.dev'),
+    Match.exhaustive,
+  );
+
+// TODO(burdon): Hosted environments share a single worker until per-env deployments exist.
+const sandboxUrl = (sandbox: NonNullable<ConfigPresetOptions['sandbox']>) =>
+  Match.value(sandbox).pipe(
+    Match.when('local', () => 'http://localhost:8792'),
+    Match.when('dev', () => 'https://sandbox-service.dxos.workers.dev'),
+    Match.when('main', () => 'https://sandbox-service.dxos.workers.dev'),
+    Match.when('production', () => 'https://sandbox-service.dxos.workers.dev'),
+    Match.exhaustive,
+  );
+
+export const configPreset = ({ edge = 'main', sandbox }: ConfigPresetOptions = {}) =>
   new Config({
     version: 1,
     runtime: {
@@ -27,14 +51,9 @@ export const configPreset = ({ edge = 'main' }: ConfigPresetOptions = {}) =>
       },
       services: {
         edge: {
-          url: Match.value(edge).pipe(
-            Match.when('local', () => 'http://localhost:8787'),
-            Match.when('dev', () => 'https://edge.dxos.workers.dev'),
-            Match.when('main', () => 'https://edge-main.dxos.workers.dev'),
-            Match.when('production', () => 'https://edge-production.dxos.workers.dev'),
-            Match.exhaustive,
-          ),
+          url: edgeUrl(edge),
         },
+        ...(sandbox ? { sandbox: { url: sandboxUrl(sandbox) } } : {}),
       },
     },
   });