chore: Specify API host for runtime, deriving other addresses as needed (#1818)

chore: Specify API host for runtime, deriving other addresses as needed, and check in shell that runtime is live.

Currently, when the runtime connects to an incorrect/invalid server
(e.g. forgetting to run local server), the web socket connection retries
until success, leaving the runtime initialization hanging. A general
"API host" URL is needed for the runtime in order to ping the status,
which would circumvent this socket loop scenario and alert that the
server is invalid.

With an API host URL, other runtime values can be derived, removing
redundant params.

With static asset cache no longer explicit, and all but runtime usage of
StaticCache being in a Deno environment, the StaticCache functionality
now explicitly uses HTTP or the filesystem (StaticCacheHTTP and
StaticCacheFS).

Author: jsantell

packages/background-charm-service/cast-admin.ts

@@ -55,11 +55,11 @@ async function castRecipe() {
 
   // Create runtime with proper configuration
   const runtime = new Runtime({
+    apiUrl: new URL(toolshedUrl),
     storageManager: StorageManager.open({
       as: identity,
       address: new URL("/api/storage/memory", toolshedUrl),
     }),
-    blobbyServerUrl: toolshedUrl,
   });
 
   try {

packages/background-charm-service/src/main.ts

@@ -26,11 +26,11 @@ const workerTimeoutMs = (() => {
 
 const identity = await getIdentity(env.IDENTITY, env.OPERATOR_PASS);
 const runtime = new Runtime({
+  apiUrl: new URL(env.API_URL),
   storageManager: StorageManager.open({
     as: identity,
     address: new URL("/api/storage/memory", env.API_URL),
   }),
-  blobbyServerUrl: env.API_URL,
 });
 const service = new BackgroundCharmService({
   identity,

packages/background-charm-service/src/worker.ts

@@ -101,11 +101,11 @@ async function initialize(
 
   // Initialize runtime and charm manager
   runtime = new Runtime({
+    apiUrl: new URL(toolshedUrl),
     storageManager: StorageManager.open({
       as: identity,
       address: new URL("/api/storage/memory", toolshedUrl),
     }),
-    blobbyServerUrl: toolshedUrl,
     recipeEnvironment: { apiUrl },
     consoleHandler: consoleHandler,
     errorHandlers: [errorHandler],

packages/charm/src/ops/charms-controller.ts

@@ -120,11 +120,11 @@ export class CharmsController<T = unknown> {
     };
 
     const runtime = new Runtime({
+      apiUrl: new URL(apiUrl),
       storageManager: StorageManager.open({
         as: session.as,
         address: new URL("/api/storage/memory", apiUrl),
       }),
-      blobbyServerUrl: apiUrl.toString(),
     });
 
     const manager = new CharmManager(session, runtime);

packages/charm/test/iterate.test.ts

@@ -21,7 +21,7 @@ describe("scrub function", () => {
     // Create runtime with the shared storage provider
     // We need to bypass the URL-based configuration for this test
     runtime = new Runtime({
-      blobbyServerUrl: import.meta.url,
+      apiUrl: new URL(import.meta.url),
       storageManager,
     });
   });

packages/cli/commands/init.ts

@@ -2,7 +2,7 @@ import { Command } from "@cliffy/command";
 import { Engine } from "@commontools/runner";
 import { join } from "@std/path/join";
 import { getCompilerOptions } from "@commontools/js-runtime/typescript";
-import { StaticCache } from "@commontools/static";
+import { StaticCacheFS } from "@commontools/static";
 import { dirname } from "@std/path/dirname";
 
 export const init = new Command()
@@ -79,7 +79,7 @@ function createTsConfig() {
 //
 // Also copies recipe documentation from docs/common to .ct-docs for reference.
 async function initWorkspace(cwd: string) {
-  const cache = new StaticCache();
+  const cache = new StaticCacheFS();
   const runtimeModuleTypes = await Engine.getRuntimeModuleTypes(
     cache,
   );

packages/cli/lib/charm.ts

@@ -76,11 +76,11 @@ export async function loadManager(config: SpaceConfig): Promise<CharmManager> {
   // Use a const ref object so we can assign later while keeping const binding
   const charmManagerRef: { current?: CharmManager } = {};
   const runtime = new Runtime({
+    apiUrl: new URL(config.apiUrl),
     storageManager: StorageManager.open({
       as: session.as,
       address: new URL("/api/storage/memory", config.apiUrl),
     }),
-    blobbyServerUrl: config.apiUrl,
     navigateCallback: (target) => {
       try {
         const id = charmId(target);
@@ -110,6 +110,11 @@ export async function loadManager(config: SpaceConfig): Promise<CharmManager> {
       }
     },
   });
+
+  if (!(await runtime.healthCheck())) {
+    throw new Error(`Could not connect to "${config.apiUrl.toString()}".`);
+  }
+
   const charmManager = new CharmManager(session, runtime);
   charmManagerRef.current = charmManager;
   await charmManager.synced();

packages/cli/lib/dev.ts

@@ -11,7 +11,10 @@ async function createRuntime() {
   const storageManager = StorageManager.emulate({
     as: await Identity.fromPassphrase("builder"),
   });
-  return new Runtime({ storageManager, blobbyServerUrl: import.meta.url });
+  return new Runtime({
+    storageManager,
+    apiUrl: new URL(import.meta.url),
+  });
 }
 
 export interface ProcessOptions {

packages/generated-patterns/integration/pattern-harness.ts

@@ -82,7 +82,7 @@ function resolveModulePath(moduleRef: string | URL): string {
 export async function runPatternScenario(scenario: PatternIntegrationScenario) {
   const storageManager = StorageManager.emulate({ as: signer });
   const runtime = new Runtime({
-    blobbyServerUrl: import.meta.url,
+    apiUrl: new URL(import.meta.url),
     storageManager,
   });
 

packages/html/test/html-recipes.test.ts

@@ -36,7 +36,7 @@ describe("recipes with HTML", () => {
     // Create runtime with the shared storage provider
     // We need to bypass the URL-based configuration for this test
     runtime = new Runtime({
-      blobbyServerUrl: import.meta.url,
+      apiUrl: new URL(import.meta.url),
       storageManager,
     });