@fluojs/runtime 1.1.1 → 1.1.3

package/README.ko.md

@@ -80,6 +80,12 @@ await userService.doWork();
 await context.close();
 ```
 
+### Studio Devtools Bridge
+
+`@fluojs/runtime`은 live Studio snapshot과 request trace를 publish할 수 있지만 `process.env`를 직접 읽지 않습니다. `fluo dev --studio`가 애플리케이션 경계에서 sidecar를 시작하고 tokenized Studio config를 만든 뒤, 앱이 runtime을 import하기 전에 해당 명시적 config를 Node 앱 child에 주입합니다. CLI가 제공한 config가 없거나 잘못되었거나 tokenized endpoint가 없으면 Studio instrumentation은 no-op이며 bootstrap 동작은 바뀌지 않습니다.
+
+이 MVP에서 전체 지원 대상은 Node dev runner 프로젝트입니다. Bun, Deno, Cloudflare Workers의 live Studio는 dedicated bridge를 구현하고 검증하기 전까지 unsupported입니다. 해당 런타임에서도 Studio config가 없으면 bootstrap은 no-op이어야 합니다. Request trace는 body, cookie, 전체 header를 의도적으로 제외하며, runtime은 local token이 Studio event history에 남지 않도록 publish 전에 trace `url`에서 query string과 fragment를 제거합니다.
+
 ### 전역 예외 필터
 
 부트스트랩 시 필터를 등록하여 횡단 관심사 에러를 처리합니다.
@@ -144,6 +150,8 @@ class UsersModule {}
 - 런타임 health module readiness check는 현재 `RequestContext`를 받으므로, public integration이 internal runtime token을 import하지 않고도 runtime-exposed status provider를 해석할 수 있습니다.
 - 시그널 기반 종료 헬퍼는 bounded drain semantics를 유지하면서 timeout/실패 상황을 로그와 `process.exitCode`로 보고하지만, 최종 프로세스 종료 소유권은 주변 호스트 런타임에 남겨 둡니다.
 - 플랫폼 snapshot 및 diagnostic issue 생산은 런타임에 남아 있고, 그래프 보기, filtering 표현, Mermaid 렌더링은 CLI 및 자동화 호출자가 소비하는 Studio 소유 계약입니다.
+- Runtime-connected Studio instrumentation은 명시적인 CLI 주입 Studio config로만 활성화되며 runtime package source에서 `process.env`를 직접 읽지 않습니다. 유효한 config와 tokenized endpoint가 없으면 non-Node 런타임을 포함해 Studio 관점의 runtime bootstrap은 no-op입니다.
+- Studio request trace는 request/response body, cookie, 전체 header를 제외합니다. Trace `url`은 publish 전에 path-only 형태로 sanitize되어 query token과 fragment가 local Studio event history에 남지 않습니다.
 - 플랫폼 component snapshot은 런타임 소유 계약 payload입니다. 각 component는 `readiness`, `health`, dependency id, telemetry tag, diagnostic issue, 그리고 `ownership.ownsResources` / `ownership.externallyManaged`를 통해 리소스 소유권을 보고합니다. Runtime은 shell snapshot에서 이 ownership flag를 보존하므로 adapter와 package integration이 fluo가 종료해야 하는 리소스와 host가 소유한 외부 관리 리소스를 구분할 수 있습니다.
 - 모듈 그래프 컴파일 결과 캐시는 `moduleGraphCache: true`를 통한 opt-in입니다. 캐시 항목은 root module identity, runtime provider, validation token, core metadata version, compile algorithm version으로 식별되며, 성공한 컴파일만 저장하고 호출자 mutation이 이후 bootstrap을 오염시키지 않도록 격리된 그래프 복사본을 반환합니다.
 

package/README.md

@@ -80,6 +80,12 @@ await userService.doWork();
 await context.close();
 ```
 
+### Studio Devtools Bridge
+
+`@fluojs/runtime` can publish live Studio snapshots and request traces, but it does not read `process.env` directly. `fluo dev --studio` is the application boundary that starts the sidecar, creates the tokenized Studio config, and injects that explicit config into the Node app child before the app imports runtime. If that CLI-provided config is absent, malformed, or missing a tokenized endpoint, Studio instrumentation is a no-op and bootstrap behavior remains unchanged.
+
+For this MVP, Node dev runner projects are the full support target. Bun, Deno, and Cloudflare Workers remain unsupported for live Studio until a dedicated bridge is implemented and verified; their runtime bootstraps still no-op when Studio config is absent. Request traces intentionally omit bodies, cookies, and full headers, and runtime strips query strings/fragments from the trace `url` before publishing events so local tokens are not copied into Studio event history.
+
 ### Global Exception Filters
 
 Handle cross-cutting errors by registering filters during bootstrap.
@@ -144,6 +150,8 @@ class UsersModule {}
 - Runtime health module readiness checks receive the current `RequestContext`, allowing public integrations to resolve runtime-exposed status providers without importing internal runtime tokens.
 - Signal-driven shutdown helpers preserve bounded drain semantics, log timeout/failure conditions, and set `process.exitCode` when shutdown does not finish cleanly, but they leave final process termination ownership to the surrounding host runtime.
 - Platform snapshot and diagnostic issue production stay in runtime; graph viewing, filtering presentation, and Mermaid rendering are Studio-owned contracts consumed by CLI and automation callers.
+- Runtime-connected Studio instrumentation is activated only by explicit CLI-injected Studio config, never by direct `process.env` reads inside runtime package source. Without valid config and tokenized endpoint, runtime bootstrap is a no-op for Studio, including non-Node runtimes.
+- Studio request traces omit request/response bodies, cookies, and full headers; the trace `url` is sanitized to path-only form before publish so query tokens and fragments are not retained in local Studio event history.
 - Platform component snapshots are runtime-owned contract payloads: each component reports `readiness`, `health`, dependency ids, telemetry tags, diagnostic issues, and resource ownership through `ownership.ownsResources` / `ownership.externallyManaged`. Runtime preserves those ownership flags in shell snapshots so adapters and package integrations can distinguish resources fluo must stop from externally managed resources the host owns.
 - Module graph compile-result caching is opt-in through `moduleGraphCache: true`; it keys entries by root module identity, runtime providers, validation tokens, core metadata versions, and the compile algorithm version, caches only successful compilations, and returns isolated graph copies so caller mutations cannot poison later bootstraps.
 

package/dist/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EAEX,uBAAuB,EAGvB,2BAA2B,EAC3B,sBAAsB,EACtB,eAAe,EAGf,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,EAEzB,gBAAgB,EAChB,UAAU,EAMX,MAAM,YAAY,CAAC;AA6dpB;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,gBAAgB,GAAG,CAAC,CAIjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,sBAA2B,GAAG,eAAe,CA+B7G;AAo0BD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,WAAW,CAAC,CAqIrG;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;;;OAOG;WACU,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,WAAW,CAAC;IAOzG;;;;;;;OAOG;WACU,wBAAwB,CACnC,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,kBAAkB,CAAC;IA6G9B;;;;;;;;OAQG;WACU,kBAAkB,CAC7B,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC;CA+BpC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,oBAAc,CAAC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EAEX,uBAAuB,EAGvB,2BAA2B,EAC3B,sBAAsB,EACtB,eAAe,EAGf,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,EAEzB,gBAAgB,EAChB,UAAU,EAMX,MAAM,YAAY,CAAC;AA6dpB;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,gBAAgB,GAAG,CAAC,CAIjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,sBAA2B,GAAG,eAAe,CA+B7G;AAo0BD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,WAAW,CAAC,CAiJrG;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;;;OAOG;WACU,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,WAAW,CAAC;IAOzG;;;;;;;OAOG;WACU,wBAAwB,CACnC,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,kBAAkB,CAAC;IAwH9B;;;;;;;;OAQG;WACU,kBAAkB,CAC7B,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC;CA+BpC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,oBAAc,CAAC"}

package/dist/bootstrap.js

@@ -3,9 +3,10 @@ import { InvariantError } from '@fluojs/core';
 import { createDispatcher, createHandlerMapping } from '@fluojs/http';
 import { DuplicateProviderError } from './errors.js';
 import { createBootstrapTimingDiagnostics } from './health/diagnostics.js';
+import { applyStudioDevtoolsApplicationOptions, applyStudioDevtoolsContextOptions, createStudioDevtoolsRuntimeFromConfig, publishStudioBootstrapSnapshot } from './devtools/studio-runtime.js';
 import { defineRuntimeModuleMetadata, getRuntimeClassDiMetadata } from './internal/core-metadata.js';
 import { RuntimeDefaultBinder } from './internal/http-runtime.js';
-import { createConsoleApplicationLogger } from './logging/logger.js';
+import { createDefaultApplicationLogger } from './logging/default-logger.js';
 import { compileModuleGraph, providerToken } from './module-graph.js';
 import { createRuntimePlatformShell } from './platform-shell.js';
 import { APPLICATION_LOGGER, BOOTSTRAP_READY_SIGNAL, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, PLATFORM_SHELL, RUNTIME_CLEANUP_REGISTRATION, RUNTIME_CONTAINER } from './tokens.js';
@@ -994,29 +995,34 @@ function createRuntimeDispatcher(bootstrapped, options, logger) {
  * @throws {Error} Propagates module-graph, lifecycle, or runtime initialization failures.
  */
 export async function bootstrapApplication(options) {
-  const logger = options.logger ?? createConsoleApplicationLogger();
+  const studioDevtools = createStudioDevtoolsRuntimeFromConfig();
+  const effectiveOptions = applyStudioDevtoolsApplicationOptions(options, studioDevtools);
+  const logger = effectiveOptions.logger ?? createDefaultApplicationLogger();
   let lifecycleInstances = [];
   let bootstrappedContainer;
   let bootstrappedModules = [];
-  const hasHttpAdapter = options.adapter !== undefined;
-  const adapter = options.adapter ?? {
+  const hasHttpAdapter = effectiveOptions.adapter !== undefined;
+  const adapter = effectiveOptions.adapter ?? {
     async close() {},
     async listen() {}
   };
   const runtimeCleanup = [];
+  if (studioDevtools) {
+    runtimeCleanup.push(() => studioDevtools.close());
+  }
   const bootstrapReadySignal = createBootstrapReadySignal();
-  const platformShell = createRuntimePlatformShell(options.platform?.components);
-  const timingEnabled = options.diagnostics?.timing === true;
+  const platformShell = createRuntimePlatformShell(effectiveOptions.platform?.components);
+  const timingEnabled = effectiveOptions.diagnostics?.timing === true;
   const timingStart = timingEnabled ? runtimePerformance.now() : 0;
   const timingPhases = [];
   try {
     logger.log('Starting fluo application...', 'FluoFactory');
-    const runtimeProviders = createRuntimeProviders(options, logger);
+    const runtimeProviders = createRuntimeProviders(effectiveOptions, logger);
     const moduleBootstrapStart = timingEnabled ? runtimePerformance.now() : 0;
-    const bootstrapped = bootstrapModule(options.rootModule, {
-      duplicateProviderPolicy: options.duplicateProviderPolicy,
+    const bootstrapped = bootstrapModule(effectiveOptions.rootModule, {
+      duplicateProviderPolicy: effectiveOptions.duplicateProviderPolicy,
       logger,
-      moduleGraphCache: options.moduleGraphCache,
+      moduleGraphCache: effectiveOptions.moduleGraphCache,
       providers: runtimeProviders,
       validationTokens: [RUNTIME_CONTAINER, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, RUNTIME_CLEANUP_REGISTRATION, BOOTSTRAP_READY_SIGNAL]
     });
@@ -1058,7 +1064,7 @@ export async function bootstrapApplication(options) {
       });
     }
     const dispatcherStart = timingEnabled ? runtimePerformance.now() : 0;
-    const dispatcher = createRuntimeDispatcher(bootstrapped, options, logger);
+    const dispatcher = createRuntimeDispatcher(bootstrapped, effectiveOptions, logger);
     if (timingEnabled) {
       timingPhases.push({
         durationMs: runtimePerformance.now() - dispatcherStart,
@@ -1066,7 +1072,13 @@ export async function bootstrapApplication(options) {
       });
     }
     const bootstrapTiming = timingEnabled ? createBootstrapTimingDiagnostics(timingPhases, runtimePerformance.now() - timingStart) : undefined;
-    return new FluoApplication(bootstrapped.container, bootstrapped.modules, options.rootModule, dispatcher, bootstrapTiming, adapter, hasHttpAdapter, platformShell, lifecycleInstances, logger, runtimeCleanup, createContextCacheableTokenSet(bootstrapped.effectiveProviders, [RUNTIME_CONTAINER, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, PLATFORM_SHELL, RUNTIME_CLEANUP_REGISTRATION, BOOTSTRAP_READY_SIGNAL]));
+    publishStudioBootstrapSnapshot(studioDevtools, {
+      modules: bootstrapped.modules,
+      rootModule: effectiveOptions.rootModule,
+      routes: dispatcher.describeRoutes?.() ?? [],
+      timing: bootstrapTiming
+    });
+    return new FluoApplication(bootstrapped.container, bootstrapped.modules, effectiveOptions.rootModule, dispatcher, bootstrapTiming, adapter, hasHttpAdapter, platformShell, lifecycleInstances, logger, runtimeCleanup, createContextCacheableTokenSet(bootstrapped.effectiveProviders, [RUNTIME_CONTAINER, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, PLATFORM_SHELL, RUNTIME_CLEANUP_REGISTRATION, BOOTSTRAP_READY_SIGNAL]));
   } catch (error) {
     bootstrapReadySignal.markFailed(error);
     logger.error('Failed to bootstrap the fluo application. Check the error below for what failed and how to fix it.', error, 'FluoFactory');
@@ -1110,24 +1122,29 @@ export class FluoFactory {
    * @throws {Error} Propagates module-graph, lifecycle, and context bootstrap failures.
    */
   static async createApplicationContext(rootModule, options = {}) {
-    const logger = options.logger ?? createConsoleApplicationLogger();
+    const studioDevtools = createStudioDevtoolsRuntimeFromConfig();
+    const effectiveOptions = applyStudioDevtoolsContextOptions(options, studioDevtools);
+    const logger = effectiveOptions.logger ?? createDefaultApplicationLogger();
     let lifecycleInstances = [];
     let bootstrappedContainer;
     let bootstrappedModules = [];
     const runtimeCleanup = [];
+    if (studioDevtools) {
+      runtimeCleanup.push(() => studioDevtools.close());
+    }
     const bootstrapReadySignal = createBootstrapReadySignal();
-    const platformShell = createRuntimePlatformShell(options.platform?.components);
-    const timingEnabled = options.diagnostics?.timing === true;
+    const platformShell = createRuntimePlatformShell(effectiveOptions.platform?.components);
+    const timingEnabled = effectiveOptions.diagnostics?.timing === true;
     const timingStart = timingEnabled ? runtimePerformance.now() : 0;
     const timingPhases = [];
     try {
       logger.log('Starting fluo application context...', 'FluoFactory');
-      const runtimeProviders = createRuntimeProviders(options, logger);
+      const runtimeProviders = createRuntimeProviders(effectiveOptions, logger);
       const moduleBootstrapStart = timingEnabled ? runtimePerformance.now() : 0;
       const bootstrapped = bootstrapModule(rootModule, {
-        duplicateProviderPolicy: options.duplicateProviderPolicy,
+        duplicateProviderPolicy: effectiveOptions.duplicateProviderPolicy,
         logger,
-        moduleGraphCache: options.moduleGraphCache,
+        moduleGraphCache: effectiveOptions.moduleGraphCache,
         providers: runtimeProviders,
         validationTokens: [RUNTIME_CONTAINER, COMPILED_MODULES, RUNTIME_CLEANUP_REGISTRATION, BOOTSTRAP_READY_SIGNAL]
       });
@@ -1169,6 +1186,11 @@ export class FluoFactory {
         });
       }
       const bootstrapTiming = timingEnabled ? createBootstrapTimingDiagnostics(timingPhases, runtimePerformance.now() - timingStart) : undefined;
+      publishStudioBootstrapSnapshot(studioDevtools, {
+        modules: bootstrapped.modules,
+        rootModule,
+        timing: bootstrapTiming
+      });
       return new FluoApplicationContext(bootstrapped.container, bootstrapped.modules, rootModule, bootstrapTiming, lifecycleInstances, runtimeCleanup, createContextCacheableTokenSet(bootstrapped.effectiveProviders, [RUNTIME_CONTAINER, COMPILED_MODULES, PLATFORM_SHELL, RUNTIME_CLEANUP_REGISTRATION, BOOTSTRAP_READY_SIGNAL]));
     } catch (error) {
       bootstrapReadySignal.markFailed(error);
@@ -1195,7 +1217,7 @@ export class FluoFactory {
    * @throws {Error} Propagates application-context bootstrap or runtime-resolution failures.
    */
   static async createMicroservice(rootModule, options = {}) {
-    const logger = options.logger ?? createConsoleApplicationLogger();
+    const logger = options.logger ?? createDefaultApplicationLogger();
     const microserviceToken = options.microserviceToken ?? DEFAULT_MICROSERVICE_TOKEN;
     const context = await FluoFactory.createApplicationContext(rootModule, options);
     try {

package/dist/devtools/contracts.d.ts

@@ -0,0 +1,138 @@
+import type { BootstrapTimingDiagnostics } from '../health/diagnostics.js';
+/**
+ * Defines Studio Graph Node Kind values used by the Studio devtool.
+ */
+export type StudioGraphNodeKind = 'module' | 'provider' | 'controller' | 'route' | 'platform' | 'external';
+/**
+ * Defines Studio Graph Edge Kind values used by the Studio devtool.
+ */
+export type StudioGraphEdgeKind = 'imports' | 'owns_provider' | 'owns_controller' | 'exposes_route' | 'depends_on' | 'exports';
+/**
+ * Describes Studio Graph Node data used by the Studio devtool.
+ */
+export interface StudioGraphNode {
+    id: string;
+    kind: StudioGraphNodeKind;
+    label: string;
+    metadata?: Record<string, unknown>;
+    status?: 'active' | 'idle' | 'warning' | 'error';
+}
+/**
+ * Describes Studio Graph Edge data used by the Studio devtool.
+ */
+export interface StudioGraphEdge {
+    from: string;
+    id: string;
+    kind: StudioGraphEdgeKind;
+    label?: string;
+    metadata?: Record<string, unknown>;
+    to: string;
+}
+/**
+ * Describes Studio Route Descriptor data used by the Studio devtool.
+ */
+export interface StudioRouteDescriptor {
+    controller: string;
+    handler: string;
+    id: string;
+    method: string;
+    module?: string;
+    path: string;
+    version?: string;
+}
+/**
+ * Defines Studio Request Status values used by the Studio devtool.
+ */
+export type StudioRequestStatus = 'started' | 'matched' | 'succeeded' | 'failed' | 'finished';
+/**
+ * Describes Studio Request Trace data used by the Studio devtool.
+ */
+export interface StudioRequestTrace {
+    controller?: string;
+    durationMs?: number;
+    error?: {
+        message: string;
+        name?: string;
+    };
+    finishedAt?: string;
+    handler?: string;
+    method: string;
+    path: string;
+    requestId: string;
+    routeId?: string;
+    startedAt: string;
+    status: StudioRequestStatus;
+    statusCode?: number;
+    url: string;
+}
+/**
+ * Describes Studio Live Diagnostic data used by the Studio devtool.
+ */
+export interface StudioLiveDiagnostic {
+    code: string;
+    fixHint?: string;
+    message: string;
+    scope?: string;
+    severity: 'error' | 'warning' | 'info';
+    targetId?: string;
+}
+/**
+ * Describes Studio Live Snapshot data used by the Studio devtool.
+ */
+export interface StudioLiveSnapshot {
+    appId: string;
+    diagnostics: StudioLiveDiagnostic[];
+    generatedAt: string;
+    graph: {
+        edges: StudioGraphEdge[];
+        nodes: StudioGraphNode[];
+    };
+    requests: StudioRequestTrace[];
+    routes: StudioRouteDescriptor[];
+    timing?: BootstrapTimingDiagnostics;
+    version: 1;
+}
+/**
+ * Describes Studio Live Event Source data used by the Studio devtool.
+ */
+export interface StudioLiveEventSource {
+    appId: string;
+    runtime: 'node' | 'bun' | 'deno' | 'worker' | 'unknown';
+}
+/**
+ * Describes Studio Live Event Base data used by the Studio devtool.
+ */
+export interface StudioLiveEventBase<TType extends string, TPayload> {
+    emittedAt: string;
+    epoch: string;
+    eventId: string;
+    payload: TPayload;
+    sequence: number;
+    source: StudioLiveEventSource;
+    type: TType;
+    version: 1;
+}
+/**
+ * Defines Studio Heartbeat Payload values used by the Studio devtool.
+ */
+export type StudioHeartbeatPayload = {
+    uptimeMs?: number;
+};
+/**
+ * Describes Studio Restart Payload data used by the Studio devtool.
+ */
+export interface StudioRestartPayload {
+    phase: 'scheduled' | 'starting' | 'started' | 'stopping' | 'stopped';
+    reason?: string;
+}
+/**
+ * Describes Studio Disconnect Payload data used by the Studio devtool.
+ */
+export interface StudioDisconnectPayload {
+    reason?: string;
+}
+/**
+ * Defines Studio Live Event values used by the Studio devtool.
+ */
+export type StudioLiveEvent = StudioLiveEventBase<'disconnect', StudioDisconnectPayload> | StudioLiveEventBase<'diagnostic', StudioLiveDiagnostic> | StudioLiveEventBase<'heartbeat', StudioHeartbeatPayload> | StudioLiveEventBase<'request', StudioRequestTrace> | StudioLiveEventBase<'restart', StudioRestartPayload> | StudioLiveEventBase<'snapshot', StudioLiveSnapshot> | StudioLiveEventBase<'timing', BootstrapTimingDiagnostics>;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/devtools/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/devtools/contracts.ts"],"names":[],"mappings":"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"}

package/dist/devtools/contracts.js

@@ -0,0 +1 @@
+export {};

package/dist/devtools/index.d.ts

@@ -0,0 +1,4 @@
+export type { StudioGraphEdge, StudioGraphEdgeKind, StudioGraphNode, StudioGraphNodeKind, StudioHeartbeatPayload, StudioLiveDiagnostic, StudioLiveEvent, StudioLiveEventBase, StudioLiveEventSource, StudioLiveSnapshot, StudioRequestStatus, StudioRequestTrace, StudioRouteDescriptor, } from './contracts.js';
+export { createStudioLiveSnapshot, createStudioRouteId, handlerToStudioRouteDescriptor, type StudioLiveSnapshotInput, } from './snapshot.js';
+export { StudioDevtoolsRuntime, applyStudioDevtoolsApplicationOptions, applyStudioDevtoolsContextOptions, createStudioDevtoolsRuntimeFromConfig, createStudioDevtoolsRuntimeFromEnv, publishStudioBootstrapSnapshot, type StudioBootstrapSnapshotInput, type StudioDevtoolsConfig, type StudioDevtoolsRuntimeOptions, type StudioDevtoolsRuntimeTransport, } from './studio-runtime.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/devtools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/devtools/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,8BAA8B,EAC9B,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,qCAAqC,EACrC,iCAAiC,EACjC,qCAAqC,EACrC,kCAAkC,EAClC,8BAA8B,EAC9B,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,8BAA8B,GACpC,MAAM,qBAAqB,CAAC"}

package/dist/devtools/index.js

@@ -0,0 +1,2 @@
+export { createStudioLiveSnapshot, createStudioRouteId, handlerToStudioRouteDescriptor } from './snapshot.js';
+export { StudioDevtoolsRuntime, applyStudioDevtoolsApplicationOptions, applyStudioDevtoolsContextOptions, createStudioDevtoolsRuntimeFromConfig, createStudioDevtoolsRuntimeFromEnv, publishStudioBootstrapSnapshot } from './studio-runtime.js';

package/dist/devtools/snapshot.d.ts

@@ -0,0 +1,39 @@
+import type { HandlerDescriptor } from '@fluojs/http';
+import { type BootstrapTimingDiagnostics } from '../health/diagnostics.js';
+import type { CompiledModule, ModuleType } from '../types.js';
+import type { StudioLiveDiagnostic, StudioLiveSnapshot, StudioRouteDescriptor } from './contracts.js';
+/**
+ * Describes Studio Live Snapshot Input data used by the Studio devtool.
+ */
+export interface StudioLiveSnapshotInput {
+    appId: string;
+    diagnostics?: readonly StudioLiveDiagnostic[];
+    generatedAt?: string;
+    modules: readonly CompiledModule[];
+    requests?: readonly StudioLiveSnapshot['requests'][number][];
+    rootModule: ModuleType;
+    routes?: readonly HandlerDescriptor[];
+    timing?: BootstrapTimingDiagnostics;
+}
+/**
+ * Creates a stable route id shared by runtime request traces and Studio graph snapshots.
+ *
+ * @param descriptor HTTP handler descriptor to identify.
+ * @returns Stable Studio route id for the handler.
+ */
+export declare function createStudioRouteId(descriptor: HandlerDescriptor): string;
+/**
+ * Converts an HTTP handler descriptor into the live Studio route contract.
+ *
+ * @param descriptor HTTP handler descriptor to expose to Studio.
+ * @returns Route descriptor consumed by the Studio UI and request traces.
+ */
+export declare function handlerToStudioRouteDescriptor(descriptor: HandlerDescriptor): StudioRouteDescriptor;
+/**
+ * Builds the runtime-connected Studio snapshot from compiled modules and HTTP route descriptors.
+ *
+ * @param input Runtime module graph, route, diagnostic, and timing inputs.
+ * @returns Live Studio snapshot for graph, routes, diagnostics, requests, and timing.
+ */
+export declare function createStudioLiveSnapshot(input: StudioLiveSnapshotInput): StudioLiveSnapshot;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/devtools/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/devtools/snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAiC,KAAK,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAG1G,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAIV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,SAAS,kBAAkB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7D,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC;AA8KD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAOzE;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,iBAAiB,GAAG,qBAAqB,CAoBnG;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CA6L3F"}