@objectstack/runtime 6.3.0 → 6.4.0

package/dist/index.d.cts

@@ -1964,6 +1964,62 @@ declare class MarketplaceInstallLocalPlugin implements Plugin {
     private readAll;
 }
 
+/**
+ * RuntimeConfigPlugin
+ *
+ * Serves `GET /api/v1/runtime/config` (and the legacy alias
+ * `GET /api/v1/studio/runtime-config`) from a tenant ObjectOS runtime so
+ * the Console / Studio SPA can learn the upstream cloud URL and capability
+ * flags **at boot time**, instead of sniffing `window.location.hostname`
+ * or reading Vite-time env vars.
+ *
+ * Response shape (mirrors cloud's `createStudioRuntimeConfigPlugin`):
+ *
+ *   {
+ *     cloudUrl: string,            // base URL of the upstream cloud
+ *     singleEnvironment: false,    // multi-tenant runtime
+ *     features: {
+ *       installLocal: boolean,     // false here — install-local is owned
+ *                                  // by CLI `serve` (single-tenant), not
+ *                                  // by createObjectOSStack
+ *       marketplace: boolean,      // true — MarketplaceProxyPlugin mounts
+ *                                  // /api/v1/marketplace/*
+ *     }
+ *   }
+ *
+ * Registers its routes on the Hono raw app, parallel to MarketplaceProxy /
+ * AuthProxy / MarketplaceInstallLocal plugins.
+ */
+
+interface RuntimeConfigPluginConfig {
+    /**
+     * Upstream cloud base URL. Falls back to `resolveCloudUrl()` (reads
+     * `OS_CLOUD_URL` / built-in default) when omitted. Pass an explicit
+     * empty string to declare "this runtime IS the cloud" (same-origin
+     * for marketplace + install).
+     */
+    controlPlaneUrl?: string;
+    /** Override the `features.installLocal` flag. Default: false. */
+    installLocal?: boolean;
+    /**
+     * Report this runtime as a single-environment deployment (CLI
+     * `objectstack dev` / `os serve`). Defaults to `false` for
+     * multi-tenant ObjectOS.
+     */
+    singleEnvironment?: boolean;
+}
+declare class RuntimeConfigPlugin implements Plugin {
+    readonly name = "com.objectstack.runtime.runtime-config";
+    readonly version = "1.0.0";
+    private readonly cloudUrl;
+    private readonly installLocal;
+    private readonly singleEnvironment;
+    constructor(config?: RuntimeConfigPluginConfig);
+    init: (_ctx: PluginContext) => Promise<void>;
+    start: (ctx: PluginContext) => Promise<void>;
+    destroy: () => Promise<void>;
+}
+
 /**
  * Shared marketplace / cloud control-plane defaults.
  *
@@ -2465,4 +2521,4 @@ declare function actionBodyRunnerFactory(runner: ScriptRunner, opts: FactoryOpti
     timeoutMs?: number;
 }) => ((actionCtx: any) => Promise<unknown>) | undefined;
 
-export { AppPlugin, ArtifactApiClient, type ArtifactApiClientConfig, ArtifactEnvironmentRegistry, type ArtifactEnvironmentRegistryConfig, ArtifactKernelFactory, type ArtifactKernelFactoryConfig, AuthProxyPlugin, type BackfillPlatformSsoClientsOptions, DEFAULT_CLOUD_URL, DEFAULT_RATE_LIMITS, type DefaultHostConfigOptions, type DefaultHostConfigResult, type DispatcherPluginConfig, DriverPlugin, type EnvironmentArtifactResponse, type EnvironmentDriverRegistry, type EnvironmentKernelFactory, type EnvironmentRuntimeConfig, FileArtifactApiClient, type FileArtifactApiClientConfig, HttpDispatcher, type HttpDispatcherResult, type HttpProtocolContext, HttpServer, KernelManager, type KernelManagerConfig, type LoadArtifactBundleOptions, MarketplaceInstallLocalPlugin, type MarketplaceInstallLocalPluginConfig, MarketplaceProxyPlugin, type MarketplaceProxyPluginConfig, MiddlewareManager, type ObjectOSStackConfig, type ObjectOSStackResult, ObservabilityServicePlugin, type ObservabilityServicePluginOptions, PLATFORM_SSO_PROVIDER_ID, QuickJSScriptRunner, type QuickJSScriptRunnerOptions, type RateLimitBucketConfig, type RateLimitDecision, type RateLimitDefaults, type RateLimitStore, RateLimiter, type ResolvedHostname, Runtime, type RuntimeConfig, SYSTEM_ENVIRONMENT_ID, SandboxError, type ScriptContext, type ScriptOrigin, type ScriptResult, type ScriptRunOptions, type ScriptRunner, type SecurityHeadersOptions, SeedLoaderService, type SeedPlatformSsoClientOptions, type StandaloneStackConfig, type StandaloneStackResult, type SystemEnvironmentPluginConfig, type TraceContext, UnimplementedScriptRunner, actionBodyRunnerFactory, backfillPlatformSsoClients, buildPlatformSsoRedirectUri, buildSecurityHeaders, collectBundleActions, collectBundleFunctions, collectBundleHooks, createDefaultHostConfig, createDispatcherPlugin, createObjectOSStack, createStandaloneStack, createSystemEnvironmentPlugin, derivePlatformSsoClientId, derivePlatformSsoClientSecret, extractRequestId, formatTraceparent, generateRequestId, hookBodyRunnerFactory, isHttpUrl, loadArtifactBundle, mergeRuntimeModule, parseTraceparent, readArtifactSource, resolveCloudUrl, resolveDefaultArtifactPath, resolveErrorReporter, resolveMetrics, resolveRequestId, seedPlatformSsoClient };
+export { AppPlugin, ArtifactApiClient, type ArtifactApiClientConfig, ArtifactEnvironmentRegistry, type ArtifactEnvironmentRegistryConfig, ArtifactKernelFactory, type ArtifactKernelFactoryConfig, AuthProxyPlugin, type BackfillPlatformSsoClientsOptions, DEFAULT_CLOUD_URL, DEFAULT_RATE_LIMITS, type DefaultHostConfigOptions, type DefaultHostConfigResult, type DispatcherPluginConfig, DriverPlugin, type EnvironmentArtifactResponse, type EnvironmentDriverRegistry, type EnvironmentKernelFactory, type EnvironmentRuntimeConfig, FileArtifactApiClient, type FileArtifactApiClientConfig, HttpDispatcher, type HttpDispatcherResult, type HttpProtocolContext, HttpServer, KernelManager, type KernelManagerConfig, type LoadArtifactBundleOptions, MarketplaceInstallLocalPlugin, type MarketplaceInstallLocalPluginConfig, MarketplaceProxyPlugin, type MarketplaceProxyPluginConfig, MiddlewareManager, type ObjectOSStackConfig, type ObjectOSStackResult, ObservabilityServicePlugin, type ObservabilityServicePluginOptions, PLATFORM_SSO_PROVIDER_ID, QuickJSScriptRunner, type QuickJSScriptRunnerOptions, type RateLimitBucketConfig, type RateLimitDecision, type RateLimitDefaults, type RateLimitStore, RateLimiter, type ResolvedHostname, Runtime, type RuntimeConfig, RuntimeConfigPlugin, type RuntimeConfigPluginConfig, SYSTEM_ENVIRONMENT_ID, SandboxError, type ScriptContext, type ScriptOrigin, type ScriptResult, type ScriptRunOptions, type ScriptRunner, type SecurityHeadersOptions, SeedLoaderService, type SeedPlatformSsoClientOptions, type StandaloneStackConfig, type StandaloneStackResult, type SystemEnvironmentPluginConfig, type TraceContext, UnimplementedScriptRunner, actionBodyRunnerFactory, backfillPlatformSsoClients, buildPlatformSsoRedirectUri, buildSecurityHeaders, collectBundleActions, collectBundleFunctions, collectBundleHooks, createDefaultHostConfig, createDispatcherPlugin, createObjectOSStack, createStandaloneStack, createSystemEnvironmentPlugin, derivePlatformSsoClientId, derivePlatformSsoClientSecret, extractRequestId, formatTraceparent, generateRequestId, hookBodyRunnerFactory, isHttpUrl, loadArtifactBundle, mergeRuntimeModule, parseTraceparent, readArtifactSource, resolveCloudUrl, resolveDefaultArtifactPath, resolveErrorReporter, resolveMetrics, resolveRequestId, seedPlatformSsoClient };

package/dist/index.d.ts

@@ -1964,6 +1964,62 @@ declare class MarketplaceInstallLocalPlugin implements Plugin {
     private readAll;
 }
 
+/**
+ * RuntimeConfigPlugin
+ *
+ * Serves `GET /api/v1/runtime/config` (and the legacy alias
+ * `GET /api/v1/studio/runtime-config`) from a tenant ObjectOS runtime so
+ * the Console / Studio SPA can learn the upstream cloud URL and capability
+ * flags **at boot time**, instead of sniffing `window.location.hostname`
+ * or reading Vite-time env vars.
+ *
+ * Response shape (mirrors cloud's `createStudioRuntimeConfigPlugin`):
+ *
+ *   {
+ *     cloudUrl: string,            // base URL of the upstream cloud
+ *     singleEnvironment: false,    // multi-tenant runtime
+ *     features: {
+ *       installLocal: boolean,     // false here — install-local is owned
+ *                                  // by CLI `serve` (single-tenant), not
+ *                                  // by createObjectOSStack
+ *       marketplace: boolean,      // true — MarketplaceProxyPlugin mounts
+ *                                  // /api/v1/marketplace/*
+ *     }
+ *   }
+ *
+ * Registers its routes on the Hono raw app, parallel to MarketplaceProxy /
+ * AuthProxy / MarketplaceInstallLocal plugins.
+ */
+
+interface RuntimeConfigPluginConfig {
+    /**
+     * Upstream cloud base URL. Falls back to `resolveCloudUrl()` (reads
+     * `OS_CLOUD_URL` / built-in default) when omitted. Pass an explicit
+     * empty string to declare "this runtime IS the cloud" (same-origin
+     * for marketplace + install).
+     */
+    controlPlaneUrl?: string;
+    /** Override the `features.installLocal` flag. Default: false. */
+    installLocal?: boolean;
+    /**
+     * Report this runtime as a single-environment deployment (CLI
+     * `objectstack dev` / `os serve`). Defaults to `false` for
+     * multi-tenant ObjectOS.
+     */
+    singleEnvironment?: boolean;
+}
+declare class RuntimeConfigPlugin implements Plugin {
+    readonly name = "com.objectstack.runtime.runtime-config";
+    readonly version = "1.0.0";
+    private readonly cloudUrl;
+    private readonly installLocal;
+    private readonly singleEnvironment;
+    constructor(config?: RuntimeConfigPluginConfig);
+    init: (_ctx: PluginContext) => Promise<void>;
+    start: (ctx: PluginContext) => Promise<void>;
+    destroy: () => Promise<void>;
+}
+
 /**
  * Shared marketplace / cloud control-plane defaults.
  *
@@ -2465,4 +2521,4 @@ declare function actionBodyRunnerFactory(runner: ScriptRunner, opts: FactoryOpti
     timeoutMs?: number;
 }) => ((actionCtx: any) => Promise<unknown>) | undefined;
 
-export { AppPlugin, ArtifactApiClient, type ArtifactApiClientConfig, ArtifactEnvironmentRegistry, type ArtifactEnvironmentRegistryConfig, ArtifactKernelFactory, type ArtifactKernelFactoryConfig, AuthProxyPlugin, type BackfillPlatformSsoClientsOptions, DEFAULT_CLOUD_URL, DEFAULT_RATE_LIMITS, type DefaultHostConfigOptions, type DefaultHostConfigResult, type DispatcherPluginConfig, DriverPlugin, type EnvironmentArtifactResponse, type EnvironmentDriverRegistry, type EnvironmentKernelFactory, type EnvironmentRuntimeConfig, FileArtifactApiClient, type FileArtifactApiClientConfig, HttpDispatcher, type HttpDispatcherResult, type HttpProtocolContext, HttpServer, KernelManager, type KernelManagerConfig, type LoadArtifactBundleOptions, MarketplaceInstallLocalPlugin, type MarketplaceInstallLocalPluginConfig, MarketplaceProxyPlugin, type MarketplaceProxyPluginConfig, MiddlewareManager, type ObjectOSStackConfig, type ObjectOSStackResult, ObservabilityServicePlugin, type ObservabilityServicePluginOptions, PLATFORM_SSO_PROVIDER_ID, QuickJSScriptRunner, type QuickJSScriptRunnerOptions, type RateLimitBucketConfig, type RateLimitDecision, type RateLimitDefaults, type RateLimitStore, RateLimiter, type ResolvedHostname, Runtime, type RuntimeConfig, SYSTEM_ENVIRONMENT_ID, SandboxError, type ScriptContext, type ScriptOrigin, type ScriptResult, type ScriptRunOptions, type ScriptRunner, type SecurityHeadersOptions, SeedLoaderService, type SeedPlatformSsoClientOptions, type StandaloneStackConfig, type StandaloneStackResult, type SystemEnvironmentPluginConfig, type TraceContext, UnimplementedScriptRunner, actionBodyRunnerFactory, backfillPlatformSsoClients, buildPlatformSsoRedirectUri, buildSecurityHeaders, collectBundleActions, collectBundleFunctions, collectBundleHooks, createDefaultHostConfig, createDispatcherPlugin, createObjectOSStack, createStandaloneStack, createSystemEnvironmentPlugin, derivePlatformSsoClientId, derivePlatformSsoClientSecret, extractRequestId, formatTraceparent, generateRequestId, hookBodyRunnerFactory, isHttpUrl, loadArtifactBundle, mergeRuntimeModule, parseTraceparent, readArtifactSource, resolveCloudUrl, resolveDefaultArtifactPath, resolveErrorReporter, resolveMetrics, resolveRequestId, seedPlatformSsoClient };
+export { AppPlugin, ArtifactApiClient, type ArtifactApiClientConfig, ArtifactEnvironmentRegistry, type ArtifactEnvironmentRegistryConfig, ArtifactKernelFactory, type ArtifactKernelFactoryConfig, AuthProxyPlugin, type BackfillPlatformSsoClientsOptions, DEFAULT_CLOUD_URL, DEFAULT_RATE_LIMITS, type DefaultHostConfigOptions, type DefaultHostConfigResult, type DispatcherPluginConfig, DriverPlugin, type EnvironmentArtifactResponse, type EnvironmentDriverRegistry, type EnvironmentKernelFactory, type EnvironmentRuntimeConfig, FileArtifactApiClient, type FileArtifactApiClientConfig, HttpDispatcher, type HttpDispatcherResult, type HttpProtocolContext, HttpServer, KernelManager, type KernelManagerConfig, type LoadArtifactBundleOptions, MarketplaceInstallLocalPlugin, type MarketplaceInstallLocalPluginConfig, MarketplaceProxyPlugin, type MarketplaceProxyPluginConfig, MiddlewareManager, type ObjectOSStackConfig, type ObjectOSStackResult, ObservabilityServicePlugin, type ObservabilityServicePluginOptions, PLATFORM_SSO_PROVIDER_ID, QuickJSScriptRunner, type QuickJSScriptRunnerOptions, type RateLimitBucketConfig, type RateLimitDecision, type RateLimitDefaults, type RateLimitStore, RateLimiter, type ResolvedHostname, Runtime, type RuntimeConfig, RuntimeConfigPlugin, type RuntimeConfigPluginConfig, SYSTEM_ENVIRONMENT_ID, SandboxError, type ScriptContext, type ScriptOrigin, type ScriptResult, type ScriptRunOptions, type ScriptRunner, type SecurityHeadersOptions, SeedLoaderService, type SeedPlatformSsoClientOptions, type StandaloneStackConfig, type StandaloneStackResult, type SystemEnvironmentPluginConfig, type TraceContext, UnimplementedScriptRunner, actionBodyRunnerFactory, backfillPlatformSsoClients, buildPlatformSsoRedirectUri, buildSecurityHeaders, collectBundleActions, collectBundleFunctions, collectBundleHooks, createDefaultHostConfig, createDispatcherPlugin, createObjectOSStack, createStandaloneStack, createSystemEnvironmentPlugin, derivePlatformSsoClientId, derivePlatformSsoClientSecret, extractRequestId, formatTraceparent, generateRequestId, hookBodyRunnerFactory, isHttpUrl, loadArtifactBundle, mergeRuntimeModule, parseTraceparent, readArtifactSource, resolveCloudUrl, resolveDefaultArtifactPath, resolveErrorReporter, resolveMetrics, resolveRequestId, seedPlatformSsoClient };

package/dist/index.js

@@ -8026,6 +8026,52 @@ var MarketplaceProxyPlugin = class _MarketplaceProxyPlugin {
   }
 };
 
+// src/cloud/runtime-config-plugin.ts
+var RuntimeConfigPlugin = class {
+  constructor(config = {}) {
+    this.name = "com.objectstack.runtime.runtime-config";
+    this.version = "1.0.0";
+    this.init = async (_ctx) => {
+    };
+    this.start = async (ctx) => {
+      ctx.hook("kernel:ready", async () => {
+        let httpServer;
+        try {
+          httpServer = ctx.getService("http-server");
+        } catch {
+          ctx.logger?.warn?.("[RuntimeConfigPlugin] http-server not available \u2014 runtime/config not mounted");
+          return;
+        }
+        if (!httpServer || typeof httpServer.getRawApp !== "function") {
+          ctx.logger?.warn?.("[RuntimeConfigPlugin] http-server missing getRawApp() \u2014 runtime/config not mounted");
+          return;
+        }
+        const rawApp = httpServer.getRawApp();
+        const payload = {
+          cloudUrl: this.cloudUrl,
+          singleEnvironment: this.singleEnvironment,
+          features: {
+            installLocal: this.installLocal,
+            marketplace: true
+          }
+        };
+        const handler = (c) => c.json(payload);
+        rawApp.get("/api/v1/runtime/config", handler);
+        rawApp.get("/api/v1/studio/runtime-config", handler);
+        ctx.logger?.info?.("[RuntimeConfigPlugin] mounted /api/v1/runtime/config", {
+          cloudUrl: this.cloudUrl || "(empty)",
+          installLocal: this.installLocal
+        });
+      });
+    };
+    this.destroy = async () => {
+    };
+    this.cloudUrl = config.controlPlaneUrl === "" ? "" : resolveCloudUrl(config.controlPlaneUrl) ?? "";
+    this.installLocal = !!config.installLocal;
+    this.singleEnvironment = !!config.singleEnvironment;
+  }
+};
+
 // src/cloud/file-artifact-api-client.ts
 import { readFile as readFile2, stat } from "fs/promises";
 import { resolve as resolvePath4 } from "path";
@@ -8252,7 +8298,7 @@ async function createObjectOSStack(config) {
   };
   const enginePlugins = await createHostEnginePlugins();
   return {
-    plugins: [...enginePlugins, new ObjectOSEnvironmentPlugin(merged), new AuthProxyPlugin(), new MarketplaceProxyPlugin({ controlPlaneUrl: merged.controlPlaneUrl === "file" ? void 0 : merged.controlPlaneUrl })],
+    plugins: [...enginePlugins, new ObjectOSEnvironmentPlugin(merged), new AuthProxyPlugin(), new MarketplaceProxyPlugin({ controlPlaneUrl: merged.controlPlaneUrl === "file" ? void 0 : merged.controlPlaneUrl }), new RuntimeConfigPlugin({ controlPlaneUrl: merged.controlPlaneUrl === "file" ? void 0 : merged.controlPlaneUrl, installLocal: false })],
     api: {
       enableProjectScoping: true,
       projectResolution: "auto",
@@ -8787,6 +8833,7 @@ export {
   RouteGroupBuilder,
   RouteManager,
   Runtime,
+  RuntimeConfigPlugin,
   SYSTEM_ENVIRONMENT_ID,
   SandboxError,
   SeedLoaderService,