@forgeax/engine-remote 0.0.0-dev.8d955ade1c79

package/dist/introspect.mjs

@@ -0,0 +1,170 @@
+// src/error-messages.ts
+var REMOTE_ERROR_MESSAGES = {
+  "script-syntax-error": "Script syntax error",
+  "script-runtime-error": "Script runtime error",
+  "server-startup-failed": "Server startup failed",
+  "server-not-running": "Server not reachable",
+  "eval-result-not-serializable": "Eval result not serializable"
+};
+
+// src/errors.ts
+var REMOTE_ERROR_CODE_TO_JSONRPC = {
+  "script-syntax-error": -32001,
+  "script-runtime-error": -32002,
+  "server-startup-failed": -32003,
+  "server-not-running": -32004,
+  "eval-result-not-serializable": -32005
+};
+
+// src/introspect.ts
+function isProfilerRoot(value) {
+  if (value === null || typeof value !== "object") return false;
+  const root = value;
+  return typeof root.startCapture === "function" && typeof root.latestCapture === "function" && typeof root.activeSession === "function" && root.phaseCatalog !== void 0;
+}
+function isExecutionRoot(value) {
+  return value !== null && typeof value === "object" && typeof value.report === "function";
+}
+function profilerPhaseCatalog(value) {
+  if (value === null || typeof value !== "object") return void 0;
+  const catalog = value.phaseCatalog;
+  return catalog === void 0 ? void 0 : catalog;
+}
+function projectRoot(name, value) {
+  const descriptions = {
+    world: { type: "World", description: "The host World instance." },
+    renderer: { type: "Renderer", description: "The host Renderer instance." },
+    assets: { type: "AssetRegistry", description: "The host AssetRegistry instance." },
+    rhiCapture: {
+      type: "RhiCapture",
+      description: "The opt-in RHI frame capture capability."
+    },
+    profiler: {
+      type: "Profiler",
+      description: "The opt-in CPU profiler for bounded App and Render capture."
+    },
+    execution: {
+      type: "ExecutionReportProvider",
+      description: "The host execution report provider for tier, health, performance, and fault."
+    },
+    simulation: {
+      type: "SimulationInspection",
+      description: "A read-only World-owned simulation record, participant, trace, and report summary."
+    }
+  };
+  const descriptor = descriptions[name] ?? { type: "unknown", description: "A live eval root." };
+  return {
+    available: true,
+    ...descriptor,
+    ...name === "profiler" ? {
+      capability: "cpu-profile-v1",
+      operations: {
+        startCapture: "profiler.startCapture({ frameLimit, eventLimit })",
+        latestCapture: "profiler.latestCapture() after the host reaches the frame boundary"
+      },
+      ...profilerPhaseCatalog(value) === void 0 ? {} : { phaseCatalog: profilerPhaseCatalog(value) }
+    } : name === "execution" ? {
+      capability: "execution-report-v1"
+    } : name === "rhiCapture" ? {
+      capability: "rhi-capture-v1"
+    } : {}
+  };
+}
+function projectRoots(roots) {
+  const projected = {};
+  for (const [name, value] of Object.entries(roots)) {
+    if (value !== void 0 && (name !== "profiler" || isProfilerRoot(value)) && (name !== "execution" || isExecutionRoot(value))) {
+      projected[name] = projectRoot(name, value);
+    }
+  }
+  return projected;
+}
+function profilerCapability(roots) {
+  if (roots.profiler !== void 0) {
+    return {
+      enabled: true,
+      capability: "cpu-profile-v1",
+      limits: {
+        frameLimit: "positive-safe-integer",
+        eventLimit: "positive-safe-integer"
+      }
+    };
+  }
+  return {
+    enabled: false,
+    code: "profiler-not-enabled",
+    expected: "an explicitly opted-in profiler root",
+    hint: "Pass profiler: createProfiler() to createApp or startServer in development, then retry.",
+    detail: { enabled: false },
+    limits: {
+      frameLimit: "positive-safe-integer",
+      eventLimit: "positive-safe-integer"
+    }
+  };
+}
+function buildErrorProjection() {
+  const errors = {};
+  for (const [code, numericCode] of Object.entries(REMOTE_ERROR_CODE_TO_JSONRPC)) {
+    errors[code] = { code: numericCode, message: REMOTE_ERROR_MESSAGES[code] };
+  }
+  return errors;
+}
+function buildIntrospectDoc(host, port, roots) {
+  const projectedRoots = projectRoots(roots);
+  const schemas = {
+    World: { type: "object", description: "The host World instance." },
+    Renderer: { type: "object", description: "The host Renderer instance." },
+    Assets: { type: "object", description: "The host AssetRegistry instance." }
+  };
+  for (const [name, root] of Object.entries(projectedRoots)) {
+    schemas[root.type] = { type: "object", description: root.description };
+    if (name === "profiler") {
+      schemas.ProfilerCapture = {
+        type: "object",
+        description: "A bounded ProfileCapture v1 artifact returned through eval."
+      };
+    }
+  }
+  for (const descriptor of roots.introspection ?? []) {
+    schemas[descriptor.name] = descriptor;
+  }
+  return {
+    openrpc: "1.3.2",
+    info: {
+      title: "@forgeax/engine-remote remote eval",
+      version: "0.0.0",
+      description: "Remote eval server. Methods: eval / introspect. Errors map to JSON-RPC -32001..-32006."
+    },
+    servers: [{ name: "in-process", url: `ws://${host}:${port}/inspector` }],
+    methods: [
+      {
+        name: "eval",
+        summary: "Evaluate a JavaScript script against live eval roots.",
+        params: [
+          {
+            name: "script",
+            required: true,
+            schema: { type: "string" }
+          }
+        ],
+        result: { name: "value", schema: { type: "object" } }
+      },
+      {
+        name: "introspect",
+        summary: "Return this OpenRPC L2 subset document.",
+        params: [],
+        result: { name: "document", schema: { type: "object" } }
+      }
+    ],
+    roots: projectedRoots,
+    capabilities: { profiler: profilerCapability(projectedRoots) },
+    components: {
+      schemas,
+      errors: buildErrorProjection()
+    }
+  };
+}
+
+export { buildIntrospectDoc, isExecutionRoot, isProfilerRoot };
+//# sourceMappingURL=introspect.mjs.map
+//# sourceMappingURL=introspect.mjs.map

package/dist/introspect.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/error-messages.ts","../src/errors.ts","../src/introspect.ts"],"names":[],"mappings":"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","file":"introspect.mjs","sourcesContent":["import type { RemoteErrorCode } from './errors';\n\nexport const REMOTE_ERROR_MESSAGES: Readonly<Record<RemoteErrorCode, string>> = {\n  'script-syntax-error': 'Script syntax error',\n  'script-runtime-error': 'Script runtime error',\n  'server-startup-failed': 'Server startup failed',\n  'server-not-running': 'Server not reachable',\n  'eval-result-not-serializable': 'Eval result not serializable',\n};\n","// @forgeax/engine-remote/src/errors - RemoteError runtime class + re-export of\n// the closed `RemoteErrorCode` union; 5 members (feat-20260629-inspector-two-layer-model D-5).\n//\n// SSOT split: the **type alias** `RemoteErrorCode`\n// + **structural interface** `RemoteError` live in `@forgeax/engine-types`\n// (parallel to the existing `ShaderErrorCode` placement). This file owns\n// the **runtime class** (`extends Error` + `toJSON()`) only; the class\n// `implements` the type-side interface so the two sides cannot drift\n// (architecture-principles #1 SSOT).\n//\n// Shape (mirrors @forgeax/engine-rhi/src/errors.ts RhiError 4-field surface for\n// charter proposition 5 consistent abstraction):\n// - `RemoteErrorCode` = closed union 5 members (re-exported from types).\n//   tsc strict-mode guards exhaustive switch completeness (charter\n//   proposition 4); AI users consume via `switch (err.code) { case '...': ... }`\n//   with NO default branch.\n// - `RemoteError` class extends Error with three readonly fields .code /\n//   .expected / .hint (AGENTS.md \"Errors are structured\"). The constructor\n//   auto-composes a human-readable .message (`[RemoteError <code>]\n//   expected: <expected>; hint: <hint>`). The class implements the\n//   `RemoteError` interface from `@forgeax/engine-types` so callers may\n//   alternately type against the structural shape.\n// - `toJSON()` opts into JSON.stringify serialisation so the JSON-RPC 2.0\n//   `error.data` payload carries .code / .expected / .hint / .message\n//   verbatim through the WebSocket transport.\n\nimport type {\n  RemoteErrorCode,\n  RemoteErrorDetail,\n  RemoteError as RemoteErrorShape,\n} from '@forgeax/engine-types';\n\n// Re-export the type-side alias verbatim so existing\n// `import { type RemoteErrorCode } from '@forgeax/engine-remote'` call sites\n// keep working (charter proposition 1 progressive disclosure — single\n// entry point for AI users).\nexport type { RemoteErrorCode };\n\n/**\n * Structured remote error. Four core fields plus bounded detail, mirroring `@forgeax/engine-rhi`\n * `RhiError` (charter proposition 5 consistent abstraction; AGENTS.md\n * \"Errors are structured\"). The class `implements RemoteErrorShape`\n * (the structural interface re-exported from `@forgeax/engine-types`) so the type\n * SSOT and the runtime class cannot drift.\n *\n * - `.code`      closed union member (L1 key signal; switch-able).\n * - `.expected`  expected-state description (L2 detail; ai-user-charter\n *                proposition 4 requires expected-state copy).\n * - `.hint`      actionable recovery guidance (L2 detail; charter\n *                proposition 3 machine-readable hint > prose).\n * - `.message`   auto-composed `[RemoteError <code>] expected: <expected>;\n *                hint: <hint>` so human stack traces still surface the\n *                triple. AI users prefer property access (charter\n *                proposition 4: no string parsing).\n *\n * Per-code `.expected` + `.hint` templates (requirements §10.2 SSOT):\n *\n * | code | `.expected` | `.hint` |\n * |:--|:--|:--|\n * | `'script-syntax-error'` | `'script body is valid JavaScript'` | `'check syntax position in errMessage; fix and resubmit'` |\n * | `'script-runtime-error'` | `'script executes without throwing'` | `'inspect error; verify symbol availability; eval has full access to world/renderer/assets'` |\n * | `'server-startup-failed'` | `'server starts successfully on requested port'` | `'check if port is already in use (default 5732); pass different port; or kill existing process holding the port'` |\n * | `'server-not-running'` | `'server is reachable at ws://localhost:<port>'` | `'start the demo first; verify app.remote is wired; pass --port to override default 5732'` |\n * | `'eval-result-not-serializable'` | `'eval result is JSON-serializable'` | `'return a JSON-safe value; BigInt and cyclic objects are unsupported over JSON-RPC'` |\n *\n * JSON-RPC 2.0 transport contract: `toJSON()` returns the structured plain\n * object carried verbatim via `error.data` on the WebSocket envelope. The\n * JSON-RPC server-error `.code` numeric segment -32001 ~ -32005 maps 1:1\n * to the 5 members\n * at the dispatch layer.\n *\n * @example AI-user exhaustive switch on the 5 remote-domain alternatives (no default fallback)\n * ```ts\n * import { RemoteError, type RemoteErrorCode } from '@forgeax/engine-remote';\n *\n * function recover(code: RemoteErrorCode): string {\n *   switch (code) {\n *     case 'script-syntax-error':     return 'fix script body syntax and resubmit';\n *     case 'script-runtime-error':    return 'inspect stack trace; verify symbol availability';\n *     case 'server-startup-failed':   return 'pick a different port or free port 5732';\n *     case 'server-not-running':      return 'start demo dev or wire app.remote';\n *     case 'eval-result-not-serializable': return 'return a JSON-safe eval result';\n *   }\n * }\n * ```\n */\nexport class RemoteError extends Error implements RemoteErrorShape {\n  readonly code: RemoteErrorCode;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail?: RemoteErrorDetail;\n\n  constructor(args: {\n    code: RemoteErrorCode;\n    expected: string;\n    hint: string;\n    detail?: RemoteErrorDetail;\n  }) {\n    super(`[RemoteError ${args.code}] expected: ${args.expected}; hint: ${args.hint}`);\n    this.name = 'RemoteError';\n    this.code = args.code;\n    this.expected = args.expected;\n    this.hint = args.hint;\n    if (args.detail !== undefined) {\n      this.detail = args.detail;\n    }\n  }\n\n  toJSON(): {\n    readonly code: RemoteErrorCode;\n    readonly expected: string;\n    readonly hint: string;\n    readonly message: string;\n    readonly detail?: RemoteErrorDetail;\n  } {\n    const json = {\n      code: this.code,\n      expected: this.expected,\n      hint: this.hint,\n      message: this.message,\n    };\n    return this.detail === undefined ? json : { ...json, detail: this.detail };\n  }\n}\n\n/**\n * SSOT mapping `RemoteErrorCode` -> JSON-RPC `error.code` numeric segment\n * (feat-20260629-inspector-two-layer-model D-5). The 5 remote P0\n * members occupy the closed segment `-32001..-32005`.\n *\n * `server.ts` consumes this map at the JSON-RPC envelope edge so the wire\n * always carries the lock-in numeric and a future drift in either direction\n * raises a TypeScript completeness error (the `Record<RemoteErrorCode,\n * number>` type guard requires every closed-union member to have a\n * numeric).\n */\nexport const REMOTE_ERROR_CODE_TO_JSONRPC: Readonly<Record<RemoteErrorCode, number>> = {\n  'script-syntax-error': -32001,\n  'script-runtime-error': -32002,\n  'server-startup-failed': -32003,\n  'server-not-running': -32004,\n  'eval-result-not-serializable': -32005,\n};\n","import { REMOTE_ERROR_MESSAGES } from './error-messages';\nimport { REMOTE_ERROR_CODE_TO_JSONRPC, type RemoteErrorCode } from './errors';\n\nexport interface ComponentIntrospectionDescriptor {\n  readonly name: string;\n  readonly schema: Readonly<Record<string, string>>;\n  readonly fields: Readonly<Record<string, unknown>>;\n  readonly meta: Readonly<Record<string, unknown>>;\n}\n\nexport interface RemoteRootValues {\n  readonly world: unknown;\n  readonly renderer: unknown;\n  readonly assets: unknown;\n  readonly rhiCapture?: unknown;\n  readonly profiler?: unknown;\n  readonly execution?: unknown;\n  /** Read-only World-owned simulation summary; no restore/replay operation. */\n  readonly simulation?: unknown;\n  readonly introspection?: readonly ComponentIntrospectionDescriptor[];\n}\n\ntype RootProjection = {\n  readonly available: true;\n  readonly type: string;\n  readonly description: string;\n  readonly capability?: string;\n  readonly phaseCatalog?: unknown;\n  readonly operations?: {\n    readonly startCapture: string;\n    readonly latestCapture: string;\n  };\n};\n\nexport function isProfilerRoot(value: unknown): boolean {\n  if (value === null || typeof value !== 'object') return false;\n  const root = value as {\n    startCapture?: unknown;\n    latestCapture?: unknown;\n    activeSession?: unknown;\n    phaseCatalog?: unknown;\n  };\n  return (\n    typeof root.startCapture === 'function' &&\n    typeof root.latestCapture === 'function' &&\n    typeof root.activeSession === 'function' &&\n    root.phaseCatalog !== undefined\n  );\n}\n\nexport function isExecutionRoot(value: unknown): value is { report(): unknown } {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as { report?: unknown }).report === 'function'\n  );\n}\n\nfunction profilerPhaseCatalog(value: unknown): unknown {\n  if (value === null || typeof value !== 'object') return undefined;\n  const catalog = (value as { phaseCatalog?: unknown }).phaseCatalog;\n  return catalog === undefined ? undefined : catalog;\n}\n\nfunction projectRoot(name: string, value: unknown): RootProjection {\n  const descriptions: Record<string, { type: string; description: string }> = {\n    world: { type: 'World', description: 'The host World instance.' },\n    renderer: { type: 'Renderer', description: 'The host Renderer instance.' },\n    assets: { type: 'AssetRegistry', description: 'The host AssetRegistry instance.' },\n    rhiCapture: {\n      type: 'RhiCapture',\n      description: 'The opt-in RHI frame capture capability.',\n    },\n    profiler: {\n      type: 'Profiler',\n      description: 'The opt-in CPU profiler for bounded App and Render capture.',\n    },\n    execution: {\n      type: 'ExecutionReportProvider',\n      description: 'The host execution report provider for tier, health, performance, and fault.',\n    },\n    simulation: {\n      type: 'SimulationInspection',\n      description:\n        'A read-only World-owned simulation record, participant, trace, and report summary.',\n    },\n  };\n  const descriptor = descriptions[name] ?? { type: 'unknown', description: 'A live eval root.' };\n  return {\n    available: true,\n    ...descriptor,\n    ...(name === 'profiler'\n      ? {\n          capability: 'cpu-profile-v1',\n          operations: {\n            startCapture: 'profiler.startCapture({ frameLimit, eventLimit })',\n            latestCapture: 'profiler.latestCapture() after the host reaches the frame boundary',\n          },\n          ...(profilerPhaseCatalog(value) === undefined\n            ? {}\n            : { phaseCatalog: profilerPhaseCatalog(value) }),\n        }\n      : name === 'execution'\n        ? {\n            capability: 'execution-report-v1',\n          }\n        : name === 'rhiCapture'\n          ? {\n              capability: 'rhi-capture-v1',\n            }\n          : {}),\n  };\n}\n\nfunction projectRoots(roots: RemoteRootValues): Record<string, RootProjection> {\n  const projected: Record<string, RootProjection> = {};\n  for (const [name, value] of Object.entries(roots)) {\n    if (\n      value !== undefined &&\n      (name !== 'profiler' || isProfilerRoot(value)) &&\n      (name !== 'execution' || isExecutionRoot(value))\n    ) {\n      projected[name] = projectRoot(name, value);\n    }\n  }\n  return projected;\n}\n\nfunction profilerCapability(roots: Record<string, RootProjection>): Record<string, unknown> {\n  if (roots.profiler !== undefined) {\n    return {\n      enabled: true,\n      capability: 'cpu-profile-v1',\n      limits: {\n        frameLimit: 'positive-safe-integer',\n        eventLimit: 'positive-safe-integer',\n      },\n    };\n  }\n  return {\n    enabled: false,\n    code: 'profiler-not-enabled',\n    expected: 'an explicitly opted-in profiler root',\n    hint: 'Pass profiler: createProfiler() to createApp or startServer in development, then retry.',\n    detail: { enabled: false },\n    limits: {\n      frameLimit: 'positive-safe-integer',\n      eventLimit: 'positive-safe-integer',\n    },\n  };\n}\n\nfunction buildErrorProjection(): Record<string, { code: number; message: string }> {\n  const errors: Record<string, { code: number; message: string }> = {};\n  for (const [code, numericCode] of Object.entries(REMOTE_ERROR_CODE_TO_JSONRPC) as Array<\n    [RemoteErrorCode, number]\n  >) {\n    errors[code] = { code: numericCode, message: REMOTE_ERROR_MESSAGES[code] };\n  }\n  return errors;\n}\n\nexport function buildIntrospectDoc(host: string, port: number, roots: RemoteRootValues): unknown {\n  const projectedRoots = projectRoots(roots);\n  const schemas: Record<string, unknown> = {\n    World: { type: 'object', description: 'The host World instance.' },\n    Renderer: { type: 'object', description: 'The host Renderer instance.' },\n    Assets: { type: 'object', description: 'The host AssetRegistry instance.' },\n  };\n  for (const [name, root] of Object.entries(projectedRoots)) {\n    schemas[root.type] = { type: 'object', description: root.description };\n    if (name === 'profiler') {\n      schemas.ProfilerCapture = {\n        type: 'object',\n        description: 'A bounded ProfileCapture v1 artifact returned through eval.',\n      };\n    }\n  }\n  for (const descriptor of roots.introspection ?? []) {\n    schemas[descriptor.name] = descriptor;\n  }\n  return {\n    openrpc: '1.3.2',\n    info: {\n      title: '@forgeax/engine-remote remote eval',\n      version: '0.0.0',\n      description:\n        'Remote eval server. Methods: eval / introspect. Errors map to JSON-RPC -32001..-32006.',\n    },\n    servers: [{ name: 'in-process', url: `ws://${host}:${port}/inspector` }],\n    methods: [\n      {\n        name: 'eval',\n        summary: 'Evaluate a JavaScript script against live eval roots.',\n        params: [\n          {\n            name: 'script',\n            required: true,\n            schema: { type: 'string' },\n          },\n        ],\n        result: { name: 'value', schema: { type: 'object' } },\n      },\n      {\n        name: 'introspect',\n        summary: 'Return this OpenRPC L2 subset document.',\n        params: [],\n        result: { name: 'document', schema: { type: 'object' } },\n      },\n    ],\n    roots: projectedRoots,\n    capabilities: { profiler: profilerCapability(projectedRoots) },\n    components: {\n      schemas,\n      errors: buildErrorProjection(),\n    },\n  };\n}\n"]}

package/dist/server.d.ts

@@ -0,0 +1,35 @@
+import { type Result } from '@forgeax/engine-types';
+import { RemoteError } from './errors';
+import { type ComponentIntrospectionDescriptor } from './introspect';
+export type { ComponentIntrospectionDescriptor } from './introspect';
+export type { Result };
+export type ConsoleHandle = {
+    readonly port: number;
+    readonly close: () => Promise<void>;
+};
+export type StartServerOptions = {
+    readonly port: number;
+    readonly host?: string;
+    readonly world: unknown;
+    readonly renderer?: unknown;
+    readonly assets?: unknown;
+    /** JSON-safe host reflection; the remote package does not know component owners. */
+    readonly introspection?: readonly ComponentIntrospectionDescriptor[];
+    /** Explicit CPU profiler capability; omitted unless the host opts in. */
+    readonly profiler?: unknown;
+    /** Structural report provider; remote never imports the App owner. */
+    readonly execution?: unknown;
+    /** Read-only World-owned simulation inspection root. */
+    readonly simulation?: unknown;
+    /**
+     * Host-owned RHI capture capability for eval-scope injection (plan-strategy D-4).
+     * It is exposed as the single `rhiCapture` eval root.
+     * Undefined when FORGEAX_ENGINE_RHI_DEBUG !== '1'.
+     */
+    readonly rhiCapture?: unknown;
+};
+/**
+ * Start the remote eval WebSocket server.
+ */
+export declare function startServer(opts: StartServerOptions): Promise<Result<ConsoleHandle, RemoteError>>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAYA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAI7D,OAAO,EAAgC,WAAW,EAAE,MAAM,UAAU,CAAC;AAErE,OAAO,EAEL,KAAK,gCAAgC,EAGtC,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,gCAAgC,EAAE,MAAM,cAAc,CAAC;AAIrE,YAAY,EAAE,MAAM,EAAE,CAAC;AAEvB,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;IACrE,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAgIF;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAiGjG"}

package/dist/server.mjs

@@ -0,0 +1,435 @@
+import { err, ok } from '@forgeax/engine-types';
+import { WebSocketServer } from 'ws';
+
+// src/server.ts
+
+// src/error-messages.ts
+var REMOTE_ERROR_MESSAGES = {
+  "script-syntax-error": "Script syntax error",
+  "script-runtime-error": "Script runtime error",
+  "server-startup-failed": "Server startup failed",
+  "server-not-running": "Server not reachable",
+  "eval-result-not-serializable": "Eval result not serializable"
+};
+
+// src/errors.ts
+var RemoteError = class extends Error {
+  code;
+  expected;
+  hint;
+  detail;
+  constructor(args) {
+    super(`[RemoteError ${args.code}] expected: ${args.expected}; hint: ${args.hint}`);
+    this.name = "RemoteError";
+    this.code = args.code;
+    this.expected = args.expected;
+    this.hint = args.hint;
+    if (args.detail !== void 0) {
+      this.detail = args.detail;
+    }
+  }
+  toJSON() {
+    const json = {
+      code: this.code,
+      expected: this.expected,
+      hint: this.hint,
+      message: this.message
+    };
+    return this.detail === void 0 ? json : { ...json, detail: this.detail };
+  }
+};
+var REMOTE_ERROR_CODE_TO_JSONRPC = {
+  "script-syntax-error": -32001,
+  "script-runtime-error": -32002,
+  "server-startup-failed": -32003,
+  "server-not-running": -32004,
+  "eval-result-not-serializable": -32005
+};
+
+// src/execute.ts
+var AsyncFunction = Object.getPrototypeOf(async () => {
+}).constructor;
+var _import = async (specifier) => import(specifier);
+function compile(script) {
+  const params = [
+    "world",
+    "renderer",
+    "assets",
+    "rhiCapture",
+    "simulation",
+    "profiler",
+    "execution",
+    "_import"
+  ];
+  try {
+    const expr = script.replace(/[\s;]+$/, "");
+    return new AsyncFunction(...params, `return (${expr}
+)`);
+  } catch (e) {
+    if (!(e instanceof SyntaxError)) throw e;
+    return new AsyncFunction(...params, script);
+  }
+}
+async function executeScript(script, ctx) {
+  try {
+    const fn = compile(script);
+    const value = await fn(
+      ctx.world,
+      ctx.renderer,
+      ctx.assets,
+      ctx.rhiCapture,
+      ctx.simulation,
+      ctx.profiler,
+      ctx.execution,
+      ctx.importModule ?? _import
+    );
+    return { ok: true, value };
+  } catch (e) {
+    if (e instanceof RemoteError) {
+      return { ok: false, error: e };
+    }
+    if (e instanceof SyntaxError) {
+      const msg = e.message;
+      return {
+        ok: false,
+        error: new RemoteError({
+          code: "script-syntax-error",
+          expected: "script body is valid JavaScript",
+          hint: `check syntax near: ${msg}; fix and resubmit`
+        })
+      };
+    }
+    const rawMessage = e instanceof Error ? e.message : String(e);
+    return {
+      ok: false,
+      error: new RemoteError({
+        code: "script-runtime-error",
+        expected: "script executes without throwing",
+        hint: `inspect error; verify symbol availability; eval has full access to world/renderer/assets (errMessage: ${rawMessage})`
+      })
+    };
+  }
+}
+
+// src/introspect.ts
+function isProfilerRoot(value) {
+  if (value === null || typeof value !== "object") return false;
+  const root = value;
+  return typeof root.startCapture === "function" && typeof root.latestCapture === "function" && typeof root.activeSession === "function" && root.phaseCatalog !== void 0;
+}
+function isExecutionRoot(value) {
+  return value !== null && typeof value === "object" && typeof value.report === "function";
+}
+function profilerPhaseCatalog(value) {
+  if (value === null || typeof value !== "object") return void 0;
+  const catalog = value.phaseCatalog;
+  return catalog === void 0 ? void 0 : catalog;
+}
+function projectRoot(name, value) {
+  const descriptions = {
+    world: { type: "World", description: "The host World instance." },
+    renderer: { type: "Renderer", description: "The host Renderer instance." },
+    assets: { type: "AssetRegistry", description: "The host AssetRegistry instance." },
+    rhiCapture: {
+      type: "RhiCapture",
+      description: "The opt-in RHI frame capture capability."
+    },
+    profiler: {
+      type: "Profiler",
+      description: "The opt-in CPU profiler for bounded App and Render capture."
+    },
+    execution: {
+      type: "ExecutionReportProvider",
+      description: "The host execution report provider for tier, health, performance, and fault."
+    },
+    simulation: {
+      type: "SimulationInspection",
+      description: "A read-only World-owned simulation record, participant, trace, and report summary."
+    }
+  };
+  const descriptor = descriptions[name] ?? { type: "unknown", description: "A live eval root." };
+  return {
+    available: true,
+    ...descriptor,
+    ...name === "profiler" ? {
+      capability: "cpu-profile-v1",
+      operations: {
+        startCapture: "profiler.startCapture({ frameLimit, eventLimit })",
+        latestCapture: "profiler.latestCapture() after the host reaches the frame boundary"
+      },
+      ...profilerPhaseCatalog(value) === void 0 ? {} : { phaseCatalog: profilerPhaseCatalog(value) }
+    } : name === "execution" ? {
+      capability: "execution-report-v1"
+    } : name === "rhiCapture" ? {
+      capability: "rhi-capture-v1"
+    } : {}
+  };
+}
+function projectRoots(roots) {
+  const projected = {};
+  for (const [name, value] of Object.entries(roots)) {
+    if (value !== void 0 && (name !== "profiler" || isProfilerRoot(value)) && (name !== "execution" || isExecutionRoot(value))) {
+      projected[name] = projectRoot(name, value);
+    }
+  }
+  return projected;
+}
+function profilerCapability(roots) {
+  if (roots.profiler !== void 0) {
+    return {
+      enabled: true,
+      capability: "cpu-profile-v1",
+      limits: {
+        frameLimit: "positive-safe-integer",
+        eventLimit: "positive-safe-integer"
+      }
+    };
+  }
+  return {
+    enabled: false,
+    code: "profiler-not-enabled",
+    expected: "an explicitly opted-in profiler root",
+    hint: "Pass profiler: createProfiler() to createApp or startServer in development, then retry.",
+    detail: { enabled: false },
+    limits: {
+      frameLimit: "positive-safe-integer",
+      eventLimit: "positive-safe-integer"
+    }
+  };
+}
+function buildErrorProjection() {
+  const errors = {};
+  for (const [code, numericCode] of Object.entries(REMOTE_ERROR_CODE_TO_JSONRPC)) {
+    errors[code] = { code: numericCode, message: REMOTE_ERROR_MESSAGES[code] };
+  }
+  return errors;
+}
+function buildIntrospectDoc(host, port, roots) {
+  const projectedRoots = projectRoots(roots);
+  const schemas = {
+    World: { type: "object", description: "The host World instance." },
+    Renderer: { type: "object", description: "The host Renderer instance." },
+    Assets: { type: "object", description: "The host AssetRegistry instance." }
+  };
+  for (const [name, root] of Object.entries(projectedRoots)) {
+    schemas[root.type] = { type: "object", description: root.description };
+    if (name === "profiler") {
+      schemas.ProfilerCapture = {
+        type: "object",
+        description: "A bounded ProfileCapture v1 artifact returned through eval."
+      };
+    }
+  }
+  for (const descriptor of roots.introspection ?? []) {
+    schemas[descriptor.name] = descriptor;
+  }
+  return {
+    openrpc: "1.3.2",
+    info: {
+      title: "@forgeax/engine-remote remote eval",
+      version: "0.0.0",
+      description: "Remote eval server. Methods: eval / introspect. Errors map to JSON-RPC -32001..-32006."
+    },
+    servers: [{ name: "in-process", url: `ws://${host}:${port}/inspector` }],
+    methods: [
+      {
+        name: "eval",
+        summary: "Evaluate a JavaScript script against live eval roots.",
+        params: [
+          {
+            name: "script",
+            required: true,
+            schema: { type: "string" }
+          }
+        ],
+        result: { name: "value", schema: { type: "object" } }
+      },
+      {
+        name: "introspect",
+        summary: "Return this OpenRPC L2 subset document.",
+        params: [],
+        result: { name: "document", schema: { type: "object" } }
+      }
+    ],
+    roots: projectedRoots,
+    capabilities: { profiler: profilerCapability(projectedRoots) },
+    components: {
+      schemas,
+      errors: buildErrorProjection()
+    }
+  };
+}
+
+// src/server.ts
+var REMOTE_TO_JSONRPC = REMOTE_ERROR_CODE_TO_JSONRPC;
+function inspectorErrorToJsonRpc(e) {
+  const detail = e.detail;
+  const data = {
+    code: e.code,
+    expected: e.expected,
+    hint: e.hint,
+    message: e.message
+  };
+  if (detail !== void 0) data.detail = detail;
+  return {
+    code: REMOTE_TO_JSONRPC[e.code],
+    message: REMOTE_ERROR_MESSAGES[e.code],
+    data
+  };
+}
+function respondError(id, code, message, data) {
+  const error = { code, message };
+  return { jsonrpc: "2.0", id, error };
+}
+function respondOk(id, result) {
+  return { jsonrpc: "2.0", id, result };
+}
+function isValidId(v) {
+  return typeof v === "number" || typeof v === "string" || v === null;
+}
+async function handleEnvelope(raw, ctx) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return respondError(null, -32700, "Parse error");
+  }
+  if (typeof parsed.method !== "string") {
+    const id2 = isValidId(parsed.id) ? parsed.id : null;
+    return respondError(id2, -32600, "Invalid Request");
+  }
+  const isNotification = !("id" in parsed);
+  const id = isValidId(parsed.id) ? parsed.id : null;
+  let response;
+  if (parsed.method === "introspect") {
+    response = respondOk(
+      id,
+      buildIntrospectDoc(ctx.host, ctx.port, {
+        world: ctx.world,
+        renderer: ctx.renderer,
+        assets: ctx.assets,
+        ...ctx.rhiCapture !== void 0 ? { rhiCapture: ctx.rhiCapture } : {},
+        ...ctx.profiler !== void 0 ? { profiler: ctx.profiler } : {},
+        ...ctx.execution !== void 0 ? { execution: ctx.execution } : {},
+        ...ctx.simulation !== void 0 ? { simulation: ctx.simulation } : {},
+        ...ctx.introspection.length > 0 ? { introspection: ctx.introspection } : {}
+      })
+    );
+  } else if (parsed.method === "eval") {
+    const params = parsed.params;
+    const script = params?.script;
+    if (typeof script !== "string") {
+      response = respondError(id, -32602, "Invalid params: eval requires { script: string }");
+    } else {
+      const result = await executeScript(script, {
+        world: ctx.world,
+        renderer: ctx.renderer,
+        assets: ctx.assets,
+        rhiCapture: ctx.rhiCapture,
+        profiler: ctx.profiler,
+        execution: ctx.execution,
+        simulation: ctx.simulation
+      });
+      if (result.ok) {
+        response = respondOk(id, result.value);
+      } else {
+        response = { jsonrpc: "2.0", id, error: inspectorErrorToJsonRpc(result.error) };
+      }
+    }
+  } else {
+    response = respondError(id, -32601, `Method not found: ${parsed.method}`);
+  }
+  return isNotification ? null : response;
+}
+function startServer(opts) {
+  return new Promise((resolve) => {
+    const host = opts.host ?? "127.0.0.1";
+    if (host !== "127.0.0.1" && host !== "localhost") {
+      console.warn(
+        `[@forgeax/engine-remote] WARNING: binding on non-loopback host '${host}'. P0 trusts localhost only.`
+      );
+    }
+    const wss = new WebSocketServer({
+      host,
+      port: opts.port,
+      path: "/inspector",
+      maxPayload: 1 << 20,
+      perMessageDeflate: false
+    });
+    const world = opts.world;
+    const renderer = opts.renderer ?? {};
+    const assets = opts.assets ?? {};
+    const rhiCapture = opts.rhiCapture;
+    const introspection = opts.introspection ?? [];
+    const profiler = isProfilerRoot(opts.profiler) ? opts.profiler : void 0;
+    const execution = isExecutionRoot(opts.execution) ? opts.execution : void 0;
+    const simulation = opts.simulation;
+    let settled = false;
+    let boundPort = opts.port;
+    wss.on("error", (e) => {
+      if (settled) {
+        console.error("[@forgeax/engine-remote] post-startup error:", e);
+        return;
+      }
+      settled = true;
+      const errno = e.code ?? "unknown";
+      resolve(
+        err(
+          new RemoteError({
+            code: "server-startup-failed",
+            expected: "server starts successfully on requested port",
+            hint: errno === "EADDRINUSE" ? `port ${opts.port} is already in use; lsof -i :${opts.port} or pick a different port` : `listen failed with errno ${errno}; check host '${host}' on this machine; port=${opts.port}`
+          })
+        )
+      );
+    });
+    wss.on("connection", (ws) => {
+      ws.on("message", (raw) => {
+        const text = typeof raw === "string" ? raw : raw.toString();
+        handleEnvelope(text, {
+          world,
+          renderer,
+          assets,
+          rhiCapture,
+          introspection,
+          profiler,
+          execution,
+          simulation,
+          host,
+          port: boundPort
+        }).then((response) => {
+          if (response !== null && ws.readyState === ws.OPEN) {
+            ws.send(JSON.stringify(response));
+          }
+        }).catch((e) => {
+          if (ws.readyState === ws.OPEN) {
+            ws.send(JSON.stringify(respondError(null, -32603, `Internal error: ${String(e)}`)));
+          }
+        });
+      });
+    });
+    wss.on("listening", () => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      const address = wss.address();
+      const port = typeof address === "object" && address !== null ? address.port : opts.port;
+      boundPort = port;
+      const handle = {
+        port,
+        close: () => new Promise((closeResolve) => {
+          for (const client of wss.clients) {
+            client.terminate();
+          }
+          wss.close(() => closeResolve());
+        })
+      };
+      resolve(ok(handle));
+    });
+  });
+}
+
+export { startServer };
+//# sourceMappingURL=server.mjs.map
+//# sourceMappingURL=server.mjs.map