@noego/wood 0.4.9 → 0.5.0

package/dist/client/renderer_log_transport.js

@@ -0,0 +1,123 @@
+import { createLogPipe } from "@noego/logger";
+import { createRecordBatch } from "@noego/trace/stream";
+const TRANSPORT_SYMBOL = /* @__PURE__ */ Symbol.for("@noego/wood.client.renderer-log-transport");
+const DEFAULT_BUFFER = { mode: "buffered", intervalMs: 500, maxRecords: 500 };
+function randomSuffix() {
+  return Math.random().toString(36).slice(2, 10);
+}
+class RendererLogTransport {
+  constructor(config = {}) {
+    this.sequence = 0;
+    this.sender = null;
+    this.fallback = null;
+    const c = globalThis.crypto;
+    this.producerId = `renderer:${c && typeof c.randomUUID === "function" ? c.randomUUID() : randomSuffix()}`;
+    this.config = config;
+    this.pipe = this.buildPipe();
+  }
+  /** Rebuilds the pipe with new buffering config; pending records are flushed first. */
+  configure(config) {
+    this.pipe.flush();
+    void this.pipe.close();
+    this.config = config;
+    this.pipe = this.buildPipe();
+  }
+  /** Installs the batch sender (the preload bridge's __logBatch). */
+  setSender(sender) {
+    this.sender = sender;
+  }
+  /** Installs the per-record fallback used when no batch sender is available. */
+  setFallback(fallback) {
+    this.fallback = fallback;
+  }
+  /** Admits one renderer log call: stamps identity + time, enters the pipe. */
+  admit(level, logger, message, context) {
+    const record = Object.freeze({
+      id: this.nextId(),
+      occurredAtMs: Date.now(),
+      producerId: this.producerId,
+      sequence: ++this.sequence,
+      level,
+      logger,
+      message,
+      service: "renderer",
+      environment: "renderer",
+      ...context !== void 0 ? { context: sanitizeContext(context) } : {}
+    });
+    this.pipe.accept(record);
+    return record;
+  }
+  /** Drains buffered records across the boundary now. */
+  flush() {
+    this.pipe.flush();
+  }
+  buildPipe() {
+    const pipe = createLogPipe({
+      buffer: this.config.buffer ?? DEFAULT_BUFFER,
+      flushOnLevels: this.config.flushOnLevels ?? ["error"],
+      name: "renderer-log-ipc"
+    });
+    pipe.to((records) => this.send(records));
+    return pipe;
+  }
+  send(records) {
+    if (this.sender) {
+      try {
+        this.sender(createRecordBatch(records));
+        return;
+      } catch {
+      }
+    }
+    if (this.fallback) {
+      for (const record of records) this.fallback(record);
+    }
+  }
+  nextId() {
+    const c = globalThis.crypto;
+    if (c && typeof c.randomUUID === "function") return c.randomUUID();
+    return `${this.producerId}-${this.sequence + 1}-${randomSuffix()}`;
+  }
+}
+function sanitizeContext(value) {
+  const seen = /* @__PURE__ */ new WeakSet();
+  try {
+    const json = JSON.stringify(value, (_key, val) => {
+      if (typeof val === "bigint") return val.toString();
+      if (typeof val === "object" && val !== null) {
+        if (seen.has(val)) return "[Circular]";
+        seen.add(val);
+      }
+      if (val instanceof Error) {
+        return { name: val.name, message: val.message, stack: val.stack };
+      }
+      return val;
+    });
+    return json === void 0 ? void 0 : JSON.parse(json);
+  } catch {
+    return "[Unserializable]";
+  }
+}
+function getRendererLogTransport() {
+  const globalObj = globalThis;
+  if (!globalObj[TRANSPORT_SYMBOL]) {
+    globalObj[TRANSPORT_SYMBOL] = new RendererLogTransport();
+  }
+  return globalObj[TRANSPORT_SYMBOL];
+}
+function configureRendererLogTransport(config) {
+  getRendererLogTransport().configure(config);
+}
+function flushRendererLogs() {
+  getRendererLogTransport().flush();
+}
+function clearRendererLogTransportForTests() {
+  delete globalThis[TRANSPORT_SYMBOL];
+}
+export {
+  RendererLogTransport,
+  clearRendererLogTransportForTests,
+  configureRendererLogTransport,
+  flushRendererLogs,
+  getRendererLogTransport
+};
+//# sourceMappingURL=renderer_log_transport.js.map

package/dist/client/renderer_log_transport.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/renderer_log_transport.ts"],"sourcesContent":["import { createLogPipe, type LogPipe, type LogPipeBuffer, type LogRecord } from '@noego/logger';\nimport { createRecordBatch } from '@noego/trace/stream';\n\nconst TRANSPORT_SYMBOL = Symbol.for('@noego/wood.client.renderer-log-transport');\n\n/**\n * Per-pipe buffering configuration for renderer logs crossing the IPC\n * boundary. Batching is a property of the pipe, not of the record: records\n * are admitted (identity + occurredAtMs stamped) the moment they are logged,\n * and buffering only affects when they travel.\n */\nexport interface RendererLogTransportConfig {\n  buffer?: LogPipeBuffer;\n  /** Levels that flush the pipe immediately (default ['error']). */\n  flushOnLevels?: readonly string[];\n}\n\nexport type RendererLogBatchSender = (batch: unknown) => void;\n\ntype FallbackWriter = (record: LogRecord) => void;\n\nconst DEFAULT_BUFFER: LogPipeBuffer = { mode: 'buffered', intervalMs: 500, maxRecords: 500 };\n\nfunction randomSuffix(): string {\n  return Math.random().toString(36).slice(2, 10);\n}\n\n/**\n * The renderer's admission point and IPC-facing pipe.\n *\n * Admission happens here, in the renderer, at creation time: each record gets\n * this window's producerId, a strictly increasing sequence, and occurredAtMs\n * stamped when the log call ran. Everything downstream — the pipe's buffer,\n * the batch envelope, the main-process receiver, the database — transports\n * the frozen record unchanged.\n */\nexport class RendererLogTransport {\n  private readonly producerId: string;\n  private sequence = 0;\n  private pipe: LogPipe;\n  private sender: RendererLogBatchSender | null = null;\n  private fallback: FallbackWriter | null = null;\n  private config: RendererLogTransportConfig;\n\n  constructor(config: RendererLogTransportConfig = {}) {\n    const c = globalThis.crypto;\n    this.producerId = `renderer:${c && typeof c.randomUUID === 'function' ? c.randomUUID() : randomSuffix()}`;\n    this.config = config;\n    this.pipe = this.buildPipe();\n  }\n\n  /** Rebuilds the pipe with new buffering config; pending records are flushed first. */\n  configure(config: RendererLogTransportConfig): void {\n    this.pipe.flush();\n    void this.pipe.close();\n    this.config = config;\n    this.pipe = this.buildPipe();\n  }\n\n  /** Installs the batch sender (the preload bridge's __logBatch). */\n  setSender(sender: RendererLogBatchSender | null): void {\n    this.sender = sender;\n  }\n\n  /** Installs the per-record fallback used when no batch sender is available. */\n  setFallback(fallback: FallbackWriter | null): void {\n    this.fallback = fallback;\n  }\n\n  /** Admits one renderer log call: stamps identity + time, enters the pipe. */\n  admit(level: string, logger: string, message: string, context?: unknown): LogRecord {\n    const record = Object.freeze({\n      id: this.nextId(),\n      occurredAtMs: Date.now(),\n      producerId: this.producerId,\n      sequence: ++this.sequence,\n      level,\n      logger,\n      message,\n      service: 'renderer',\n      environment: 'renderer',\n      ...(context !== undefined ? { context: sanitizeContext(context) } : {}),\n    });\n    this.pipe.accept(record);\n    return record;\n  }\n\n  /** Drains buffered records across the boundary now. */\n  flush(): void {\n    this.pipe.flush();\n  }\n\n  private buildPipe(): LogPipe {\n    const pipe = createLogPipe({\n      buffer: this.config.buffer ?? DEFAULT_BUFFER,\n      flushOnLevels: this.config.flushOnLevels ?? ['error'],\n      name: 'renderer-log-ipc',\n    });\n    pipe.to((records) => this.send(records));\n    return pipe;\n  }\n\n  private send(records: readonly LogRecord[]): void {\n    if (this.sender) {\n      try {\n        this.sender(createRecordBatch(records));\n        return;\n      } catch {\n        // Fall through to per-record fallback below.\n      }\n    }\n    if (this.fallback) {\n      for (const record of records) this.fallback(record);\n    }\n  }\n\n  private nextId(): string {\n    const c = globalThis.crypto;\n    if (c && typeof c.randomUUID === 'function') return c.randomUUID();\n    return `${this.producerId}-${this.sequence + 1}-${randomSuffix()}`;\n  }\n}\n\n/**\n * Context crossing IPC must survive structured clone: snapshot through JSON\n * with circular/bigint/Error handling. The original object stays untouched.\n */\nfunction sanitizeContext(value: unknown): unknown {\n  const seen = new WeakSet<object>();\n  try {\n    const json = JSON.stringify(value, (_key, val: unknown) => {\n      if (typeof val === 'bigint') return val.toString();\n      if (typeof val === 'object' && val !== null) {\n        if (seen.has(val)) return '[Circular]';\n        seen.add(val);\n      }\n      if (val instanceof Error) {\n        return { name: val.name, message: val.message, stack: val.stack };\n      }\n      return val;\n    });\n    return json === undefined ? undefined : JSON.parse(json);\n  } catch {\n    return '[Unserializable]';\n  }\n}\n\ntype GlobalWithTransport = typeof globalThis & {\n  [TRANSPORT_SYMBOL]?: RendererLogTransport;\n};\n\nexport function getRendererLogTransport(): RendererLogTransport {\n  const globalObj = globalThis as GlobalWithTransport;\n  if (!globalObj[TRANSPORT_SYMBOL]) {\n    globalObj[TRANSPORT_SYMBOL] = new RendererLogTransport();\n  }\n  return globalObj[TRANSPORT_SYMBOL];\n}\n\n/** Reconfigures the renderer→main log pipe (buffer interval, flush levels). */\nexport function configureRendererLogTransport(config: RendererLogTransportConfig): void {\n  getRendererLogTransport().configure(config);\n}\n\n/** Flushes all buffered renderer logs across the IPC boundary now. */\nexport function flushRendererLogs(): void {\n  getRendererLogTransport().flush();\n}\n\nexport function clearRendererLogTransportForTests(): void {\n  delete (globalThis as GlobalWithTransport)[TRANSPORT_SYMBOL];\n}\n"],"mappings":"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","names":[]}

package/dist/codegen/controller_registration_generator.cjs

@@ -28,7 +28,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var controller_registration_generator_exports = {};
 __export(controller_registration_generator_exports, {
-  generateControllerRegistration: () => generateControllerRegistration
+  controllerFileCandidates: () => controllerFileCandidates,
+  generateControllerRegistration: () => generateControllerRegistration,
+  resolveControllerFile: () => resolveControllerFile
 });
 module.exports = __toCommonJS(controller_registration_generator_exports);
 var import_fs = require("fs");
@@ -48,6 +50,13 @@ const INDEX_CANDIDATES = [
   "index.ts",
   "index.js"
 ];
+function controllerFileCandidates(controllerName, controllersDir) {
+  const basePath = import_path.default.resolve(controllersDir, controllerName);
+  return [
+    ...CANDIDATE_SUFFIXES.map((suffix) => basePath + suffix),
+    ...INDEX_CANDIDATES.map((indexFile) => import_path.default.resolve(controllersDir, controllerName, indexFile))
+  ];
+}
 function resolveControllerFile(controllerName, controllersDir) {
   const basePath = import_path.default.resolve(controllersDir, controllerName);
   for (const suffix of CANDIDATE_SUFFIXES) {
@@ -138,6 +147,8 @@ Ensure each controller file exists with one of these suffixes: .ts, .controller.
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  generateControllerRegistration
+  controllerFileCandidates,
+  generateControllerRegistration,
+  resolveControllerFile
 });
 //# sourceMappingURL=controller_registration_generator.cjs.map

package/dist/codegen/controller_registration_generator.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/controller_registration_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { OperationDef } from '../types/index.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nconst CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS = [\n  'To change controller registration, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and the matching controller files.',\n] as const;\n\n/**\n * Candidate file extensions to search when resolving a controller name to a file.\n * Matches the order used by ControllerResolver.resolveClass().\n */\nconst CANDIDATE_SUFFIXES = [\n  '.ts',\n  '.controller.ts',\n  '.js',\n  '.controller.js',\n] as const;\n\nconst INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\n/**\n * Resolve a controller name to a file path on disk.\n * Returns the first candidate that exists, or undefined if none match.\n */\nfunction resolveControllerFile(controllerName: string, controllersDir: string): string | undefined {\n  const basePath = path.resolve(controllersDir, controllerName);\n\n  for (const suffix of CANDIDATE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) return candidate;\n  }\n\n  for (const indexFile of INDEX_CANDIDATES) {\n    const candidate = path.resolve(controllersDir, controllerName, indexFile);\n    if (existsSync(candidate)) return candidate;\n  }\n\n  return undefined;\n}\n\n/**\n * Compute a relative import path from the generated file's directory to the\n * resolved controller file. Strips `.ts` extensions since TypeScript imports\n * should not include them.\n */\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  // Ensure the path starts with ./ or ../\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  // Strip .ts extension (TypeScript convention)\n  if (rel.endsWith('.ts')) {\n    rel = rel.slice(0, -3);\n  }\n\n  // Normalize path separators to forward slashes (Windows compat)\n  return rel.replace(/\\\\/g, '/');\n}\n\n/**\n * Convert a controller name to a valid PascalCase identifier for the import.\n * e.g. \"chat\" -> \"ChatController\", \"multi_agent\" -> \"MultiAgentController\"\n */\nfunction toControllerClassName(controllerName: string): string {\n  const pascal = controllerName\n    .split(/[_\\-.]/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return pascal + 'Controller';\n}\n\n/**\n * Extract all unique controller names from a set of parsed operations.\n */\nfunction extractControllerNames(operations: Map<string, OperationDef>): string[] {\n  const names = new Set<string>();\n\n  operations.forEach((op) => {\n    names.add(op.controller);\n  });\n\n  return Array.from(names).sort();\n}\n\nexport interface ControllerRegistrationOptions {\n  /** Directory where controller source files live */\n  controllersDir: string;\n  /** Directory where the generated file will be written */\n  outDir: string;\n  /** If true, unresolved controllers emit a warning comment instead of throwing. Default: false. */\n  allowUnresolved?: boolean;\n}\n\n/**\n * Generate a TypeScript registration file that statically imports every\n * controller referenced in operations and exports a function to register\n * them with a WoodRouter.\n */\nexport function generateControllerRegistration(\n  operations: Map<string, OperationDef>,\n  options: ControllerRegistrationOptions,\n): string {\n  const controllerNames = extractControllerNames(operations);\n  const outDirResolved = path.resolve(options.outDir);\n\n  const imports: string[] = [];\n  const registrations: string[] = [];\n  const unresolved: string[] = [];\n\n  for (const name of controllerNames) {\n    const filePath = resolveControllerFile(name, options.controllersDir);\n\n    if (!filePath) {\n      unresolved.push(name);\n      continue;\n    }\n\n    const importPath = computeImportPath(outDirResolved, filePath);\n    const className = toControllerClassName(name);\n\n    imports.push(`import ${className} from '${importPath}';`);\n    registrations.push(`  router.registerController('${name}', ${className});`);\n  }\n\n  // Fail by default when controllers cannot be resolved\n  if (unresolved.length > 0 && !options.allowUnresolved) {\n    throw new Error(\n      `Controller registration codegen failed: ${unresolved.length} controller(s) not found on disk:\\n` +\n      unresolved.map(name => `  - \"${name}\" (searched in ${options.controllersDir})`).join('\\n') +\n      `\\n\\nEnsure each controller file exists with one of these suffixes: .ts, .controller.ts, .js, .controller.js`\n    );\n  }\n\n  const lines: string[] = [\n    generatedFileNotice(CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS),\n    '//',\n    '// Static imports ensure all controllers are bundled and available at startup.',\n    '// registerController() puts each class directly in the router\\'s cache.',\n  ];\n\n  if (unresolved.length > 0) {\n    lines.push(\n      '',\n      '// WARNING: The following controllers could not be resolved on disk:',\n      ...unresolved.map((name) => `//   - ${name}`),\n    );\n  }\n\n  // Static imports\n  lines.push('');\n  for (const imp of imports) {\n    lines.push(imp);\n  }\n\n  // Registration function\n  lines.push(\n    '',\n    'export function registerControllers(router: { registerController(name: string, cls: any): void }) {',\n  );\n  for (const reg of registrations) {\n    lines.push(reg);\n  }\n  lines.push(\n    '}',\n    '',\n  );\n\n  return lines.join('\\n');\n}\n"],"mappings":"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","names":["path"]}
+{"version":3,"sources":["../../src/codegen/controller_registration_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { OperationDef } from '../types/index.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nconst CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS = [\n  'To change controller registration, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and the matching controller files.',\n] as const;\n\n/**\n * Candidate file extensions to search when resolving a controller name to a file.\n * Matches the order used by ControllerResolver.resolveClass().\n */\nconst CANDIDATE_SUFFIXES = [\n  '.ts',\n  '.controller.ts',\n  '.js',\n  '.controller.js',\n] as const;\n\nconst INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\n/**\n * Every file a controller identity may live at, in resolution order —\n * shared by codegen and by test-time auto-binding so both agree on where an\n * identity resolves and on what to report when it does not.\n */\nexport function controllerFileCandidates(controllerName: string, controllersDir: string): string[] {\n  const basePath = path.resolve(controllersDir, controllerName);\n  return [\n    ...CANDIDATE_SUFFIXES.map((suffix) => basePath + suffix),\n    ...INDEX_CANDIDATES.map((indexFile) => path.resolve(controllersDir, controllerName, indexFile)),\n  ];\n}\n\n/**\n * Resolve a controller name to a file path on disk.\n * Returns the first candidate that exists, or undefined if none match.\n */\nexport function resolveControllerFile(controllerName: string, controllersDir: string): string | undefined {\n  const basePath = path.resolve(controllersDir, controllerName);\n\n  for (const suffix of CANDIDATE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) return candidate;\n  }\n\n  for (const indexFile of INDEX_CANDIDATES) {\n    const candidate = path.resolve(controllersDir, controllerName, indexFile);\n    if (existsSync(candidate)) return candidate;\n  }\n\n  return undefined;\n}\n\n/**\n * Compute a relative import path from the generated file's directory to the\n * resolved controller file. Strips `.ts` extensions since TypeScript imports\n * should not include them.\n */\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  // Ensure the path starts with ./ or ../\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  // Strip .ts extension (TypeScript convention)\n  if (rel.endsWith('.ts')) {\n    rel = rel.slice(0, -3);\n  }\n\n  // Normalize path separators to forward slashes (Windows compat)\n  return rel.replace(/\\\\/g, '/');\n}\n\n/**\n * Convert a controller name to a valid PascalCase identifier for the import.\n * e.g. \"chat\" -> \"ChatController\", \"multi_agent\" -> \"MultiAgentController\"\n */\nfunction toControllerClassName(controllerName: string): string {\n  const pascal = controllerName\n    .split(/[_\\-.]/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return pascal + 'Controller';\n}\n\n/**\n * Extract all unique controller names from a set of parsed operations.\n */\nfunction extractControllerNames(operations: Map<string, OperationDef>): string[] {\n  const names = new Set<string>();\n\n  operations.forEach((op) => {\n    names.add(op.controller);\n  });\n\n  return Array.from(names).sort();\n}\n\nexport interface ControllerRegistrationOptions {\n  /** Directory where controller source files live */\n  controllersDir: string;\n  /** Directory where the generated file will be written */\n  outDir: string;\n  /** If true, unresolved controllers emit a warning comment instead of throwing. Default: false. */\n  allowUnresolved?: boolean;\n}\n\n/**\n * Generate a TypeScript registration file that statically imports every\n * controller referenced in operations and exports a function to register\n * them with a WoodRouter.\n */\nexport function generateControllerRegistration(\n  operations: Map<string, OperationDef>,\n  options: ControllerRegistrationOptions,\n): string {\n  const controllerNames = extractControllerNames(operations);\n  const outDirResolved = path.resolve(options.outDir);\n\n  const imports: string[] = [];\n  const registrations: string[] = [];\n  const unresolved: string[] = [];\n\n  for (const name of controllerNames) {\n    const filePath = resolveControllerFile(name, options.controllersDir);\n\n    if (!filePath) {\n      unresolved.push(name);\n      continue;\n    }\n\n    const importPath = computeImportPath(outDirResolved, filePath);\n    const className = toControllerClassName(name);\n\n    imports.push(`import ${className} from '${importPath}';`);\n    registrations.push(`  router.registerController('${name}', ${className});`);\n  }\n\n  // Fail by default when controllers cannot be resolved\n  if (unresolved.length > 0 && !options.allowUnresolved) {\n    throw new Error(\n      `Controller registration codegen failed: ${unresolved.length} controller(s) not found on disk:\\n` +\n      unresolved.map(name => `  - \"${name}\" (searched in ${options.controllersDir})`).join('\\n') +\n      `\\n\\nEnsure each controller file exists with one of these suffixes: .ts, .controller.ts, .js, .controller.js`\n    );\n  }\n\n  const lines: string[] = [\n    generatedFileNotice(CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS),\n    '//',\n    '// Static imports ensure all controllers are bundled and available at startup.',\n    '// registerController() puts each class directly in the router\\'s cache.',\n  ];\n\n  if (unresolved.length > 0) {\n    lines.push(\n      '',\n      '// WARNING: The following controllers could not be resolved on disk:',\n      ...unresolved.map((name) => `//   - ${name}`),\n    );\n  }\n\n  // Static imports\n  lines.push('');\n  for (const imp of imports) {\n    lines.push(imp);\n  }\n\n  // Registration function\n  lines.push(\n    '',\n    'export function registerControllers(router: { registerController(name: string, cls: any): void }) {',\n  );\n  for (const reg of registrations) {\n    lines.push(reg);\n  }\n  lines.push(\n    '}',\n    '',\n  );\n\n  return lines.join('\\n');\n}\n"],"mappings":"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","names":["path"]}

package/dist/codegen/controller_registration_generator.d.cts

@@ -1,5 +1,16 @@
 import { OperationDef } from '../types/operations.cjs';
 
+/**
+ * Every file a controller identity may live at, in resolution order —
+ * shared by codegen and by test-time auto-binding so both agree on where an
+ * identity resolves and on what to report when it does not.
+ */
+declare function controllerFileCandidates(controllerName: string, controllersDir: string): string[];
+/**
+ * Resolve a controller name to a file path on disk.
+ * Returns the first candidate that exists, or undefined if none match.
+ */
+declare function resolveControllerFile(controllerName: string, controllersDir: string): string | undefined;
 interface ControllerRegistrationOptions {
     /** Directory where controller source files live */
     controllersDir: string;
@@ -15,4 +26,4 @@ interface ControllerRegistrationOptions {
  */
 declare function generateControllerRegistration(operations: Map<string, OperationDef>, options: ControllerRegistrationOptions): string;
 
-export { type ControllerRegistrationOptions, generateControllerRegistration };
+export { type ControllerRegistrationOptions, controllerFileCandidates, generateControllerRegistration, resolveControllerFile };

package/dist/codegen/controller_registration_generator.d.ts

@@ -1,5 +1,16 @@
 import { OperationDef } from '../types/operations.js';
 
+/**
+ * Every file a controller identity may live at, in resolution order —
+ * shared by codegen and by test-time auto-binding so both agree on where an
+ * identity resolves and on what to report when it does not.
+ */
+declare function controllerFileCandidates(controllerName: string, controllersDir: string): string[];
+/**
+ * Resolve a controller name to a file path on disk.
+ * Returns the first candidate that exists, or undefined if none match.
+ */
+declare function resolveControllerFile(controllerName: string, controllersDir: string): string | undefined;
 interface ControllerRegistrationOptions {
     /** Directory where controller source files live */
     controllersDir: string;
@@ -15,4 +26,4 @@ interface ControllerRegistrationOptions {
  */
 declare function generateControllerRegistration(operations: Map<string, OperationDef>, options: ControllerRegistrationOptions): string;
 
-export { type ControllerRegistrationOptions, generateControllerRegistration };
+export { type ControllerRegistrationOptions, controllerFileCandidates, generateControllerRegistration, resolveControllerFile };

package/dist/codegen/controller_registration_generator.js

@@ -15,6 +15,13 @@ const INDEX_CANDIDATES = [
   "index.ts",
   "index.js"
 ];
+function controllerFileCandidates(controllerName, controllersDir) {
+  const basePath = path.resolve(controllersDir, controllerName);
+  return [
+    ...CANDIDATE_SUFFIXES.map((suffix) => basePath + suffix),
+    ...INDEX_CANDIDATES.map((indexFile) => path.resolve(controllersDir, controllerName, indexFile))
+  ];
+}
 function resolveControllerFile(controllerName, controllersDir) {
   const basePath = path.resolve(controllersDir, controllerName);
   for (const suffix of CANDIDATE_SUFFIXES) {
@@ -104,6 +111,8 @@ Ensure each controller file exists with one of these suffixes: .ts, .controller.
   return lines.join("\n");
 }
 export {
-  generateControllerRegistration
+  controllerFileCandidates,
+  generateControllerRegistration,
+  resolveControllerFile
 };
 //# sourceMappingURL=controller_registration_generator.js.map

package/dist/codegen/controller_registration_generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/controller_registration_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { OperationDef } from '../types/index.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nconst CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS = [\n  'To change controller registration, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and the matching controller files.',\n] as const;\n\n/**\n * Candidate file extensions to search when resolving a controller name to a file.\n * Matches the order used by ControllerResolver.resolveClass().\n */\nconst CANDIDATE_SUFFIXES = [\n  '.ts',\n  '.controller.ts',\n  '.js',\n  '.controller.js',\n] as const;\n\nconst INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\n/**\n * Resolve a controller name to a file path on disk.\n * Returns the first candidate that exists, or undefined if none match.\n */\nfunction resolveControllerFile(controllerName: string, controllersDir: string): string | undefined {\n  const basePath = path.resolve(controllersDir, controllerName);\n\n  for (const suffix of CANDIDATE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) return candidate;\n  }\n\n  for (const indexFile of INDEX_CANDIDATES) {\n    const candidate = path.resolve(controllersDir, controllerName, indexFile);\n    if (existsSync(candidate)) return candidate;\n  }\n\n  return undefined;\n}\n\n/**\n * Compute a relative import path from the generated file's directory to the\n * resolved controller file. Strips `.ts` extensions since TypeScript imports\n * should not include them.\n */\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  // Ensure the path starts with ./ or ../\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  // Strip .ts extension (TypeScript convention)\n  if (rel.endsWith('.ts')) {\n    rel = rel.slice(0, -3);\n  }\n\n  // Normalize path separators to forward slashes (Windows compat)\n  return rel.replace(/\\\\/g, '/');\n}\n\n/**\n * Convert a controller name to a valid PascalCase identifier for the import.\n * e.g. \"chat\" -> \"ChatController\", \"multi_agent\" -> \"MultiAgentController\"\n */\nfunction toControllerClassName(controllerName: string): string {\n  const pascal = controllerName\n    .split(/[_\\-.]/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return pascal + 'Controller';\n}\n\n/**\n * Extract all unique controller names from a set of parsed operations.\n */\nfunction extractControllerNames(operations: Map<string, OperationDef>): string[] {\n  const names = new Set<string>();\n\n  operations.forEach((op) => {\n    names.add(op.controller);\n  });\n\n  return Array.from(names).sort();\n}\n\nexport interface ControllerRegistrationOptions {\n  /** Directory where controller source files live */\n  controllersDir: string;\n  /** Directory where the generated file will be written */\n  outDir: string;\n  /** If true, unresolved controllers emit a warning comment instead of throwing. Default: false. */\n  allowUnresolved?: boolean;\n}\n\n/**\n * Generate a TypeScript registration file that statically imports every\n * controller referenced in operations and exports a function to register\n * them with a WoodRouter.\n */\nexport function generateControllerRegistration(\n  operations: Map<string, OperationDef>,\n  options: ControllerRegistrationOptions,\n): string {\n  const controllerNames = extractControllerNames(operations);\n  const outDirResolved = path.resolve(options.outDir);\n\n  const imports: string[] = [];\n  const registrations: string[] = [];\n  const unresolved: string[] = [];\n\n  for (const name of controllerNames) {\n    const filePath = resolveControllerFile(name, options.controllersDir);\n\n    if (!filePath) {\n      unresolved.push(name);\n      continue;\n    }\n\n    const importPath = computeImportPath(outDirResolved, filePath);\n    const className = toControllerClassName(name);\n\n    imports.push(`import ${className} from '${importPath}';`);\n    registrations.push(`  router.registerController('${name}', ${className});`);\n  }\n\n  // Fail by default when controllers cannot be resolved\n  if (unresolved.length > 0 && !options.allowUnresolved) {\n    throw new Error(\n      `Controller registration codegen failed: ${unresolved.length} controller(s) not found on disk:\\n` +\n      unresolved.map(name => `  - \"${name}\" (searched in ${options.controllersDir})`).join('\\n') +\n      `\\n\\nEnsure each controller file exists with one of these suffixes: .ts, .controller.ts, .js, .controller.js`\n    );\n  }\n\n  const lines: string[] = [\n    generatedFileNotice(CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS),\n    '//',\n    '// Static imports ensure all controllers are bundled and available at startup.',\n    '// registerController() puts each class directly in the router\\'s cache.',\n  ];\n\n  if (unresolved.length > 0) {\n    lines.push(\n      '',\n      '// WARNING: The following controllers could not be resolved on disk:',\n      ...unresolved.map((name) => `//   - ${name}`),\n    );\n  }\n\n  // Static imports\n  lines.push('');\n  for (const imp of imports) {\n    lines.push(imp);\n  }\n\n  // Registration function\n  lines.push(\n    '',\n    'export function registerControllers(router: { registerController(name: string, cls: any): void }) {',\n  );\n  for (const reg of registrations) {\n    lines.push(reg);\n  }\n  lines.push(\n    '}',\n    '',\n  );\n\n  return lines.join('\\n');\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/codegen/controller_registration_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { OperationDef } from '../types/index.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nconst CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS = [\n  'To change controller registration, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and the matching controller files.',\n] as const;\n\n/**\n * Candidate file extensions to search when resolving a controller name to a file.\n * Matches the order used by ControllerResolver.resolveClass().\n */\nconst CANDIDATE_SUFFIXES = [\n  '.ts',\n  '.controller.ts',\n  '.js',\n  '.controller.js',\n] as const;\n\nconst INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\n/**\n * Every file a controller identity may live at, in resolution order —\n * shared by codegen and by test-time auto-binding so both agree on where an\n * identity resolves and on what to report when it does not.\n */\nexport function controllerFileCandidates(controllerName: string, controllersDir: string): string[] {\n  const basePath = path.resolve(controllersDir, controllerName);\n  return [\n    ...CANDIDATE_SUFFIXES.map((suffix) => basePath + suffix),\n    ...INDEX_CANDIDATES.map((indexFile) => path.resolve(controllersDir, controllerName, indexFile)),\n  ];\n}\n\n/**\n * Resolve a controller name to a file path on disk.\n * Returns the first candidate that exists, or undefined if none match.\n */\nexport function resolveControllerFile(controllerName: string, controllersDir: string): string | undefined {\n  const basePath = path.resolve(controllersDir, controllerName);\n\n  for (const suffix of CANDIDATE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) return candidate;\n  }\n\n  for (const indexFile of INDEX_CANDIDATES) {\n    const candidate = path.resolve(controllersDir, controllerName, indexFile);\n    if (existsSync(candidate)) return candidate;\n  }\n\n  return undefined;\n}\n\n/**\n * Compute a relative import path from the generated file's directory to the\n * resolved controller file. Strips `.ts` extensions since TypeScript imports\n * should not include them.\n */\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  // Ensure the path starts with ./ or ../\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  // Strip .ts extension (TypeScript convention)\n  if (rel.endsWith('.ts')) {\n    rel = rel.slice(0, -3);\n  }\n\n  // Normalize path separators to forward slashes (Windows compat)\n  return rel.replace(/\\\\/g, '/');\n}\n\n/**\n * Convert a controller name to a valid PascalCase identifier for the import.\n * e.g. \"chat\" -> \"ChatController\", \"multi_agent\" -> \"MultiAgentController\"\n */\nfunction toControllerClassName(controllerName: string): string {\n  const pascal = controllerName\n    .split(/[_\\-.]/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return pascal + 'Controller';\n}\n\n/**\n * Extract all unique controller names from a set of parsed operations.\n */\nfunction extractControllerNames(operations: Map<string, OperationDef>): string[] {\n  const names = new Set<string>();\n\n  operations.forEach((op) => {\n    names.add(op.controller);\n  });\n\n  return Array.from(names).sort();\n}\n\nexport interface ControllerRegistrationOptions {\n  /** Directory where controller source files live */\n  controllersDir: string;\n  /** Directory where the generated file will be written */\n  outDir: string;\n  /** If true, unresolved controllers emit a warning comment instead of throwing. Default: false. */\n  allowUnresolved?: boolean;\n}\n\n/**\n * Generate a TypeScript registration file that statically imports every\n * controller referenced in operations and exports a function to register\n * them with a WoodRouter.\n */\nexport function generateControllerRegistration(\n  operations: Map<string, OperationDef>,\n  options: ControllerRegistrationOptions,\n): string {\n  const controllerNames = extractControllerNames(operations);\n  const outDirResolved = path.resolve(options.outDir);\n\n  const imports: string[] = [];\n  const registrations: string[] = [];\n  const unresolved: string[] = [];\n\n  for (const name of controllerNames) {\n    const filePath = resolveControllerFile(name, options.controllersDir);\n\n    if (!filePath) {\n      unresolved.push(name);\n      continue;\n    }\n\n    const importPath = computeImportPath(outDirResolved, filePath);\n    const className = toControllerClassName(name);\n\n    imports.push(`import ${className} from '${importPath}';`);\n    registrations.push(`  router.registerController('${name}', ${className});`);\n  }\n\n  // Fail by default when controllers cannot be resolved\n  if (unresolved.length > 0 && !options.allowUnresolved) {\n    throw new Error(\n      `Controller registration codegen failed: ${unresolved.length} controller(s) not found on disk:\\n` +\n      unresolved.map(name => `  - \"${name}\" (searched in ${options.controllersDir})`).join('\\n') +\n      `\\n\\nEnsure each controller file exists with one of these suffixes: .ts, .controller.ts, .js, .controller.js`\n    );\n  }\n\n  const lines: string[] = [\n    generatedFileNotice(CONTROLLER_REGISTRATION_SOURCE_INSTRUCTIONS),\n    '//',\n    '// Static imports ensure all controllers are bundled and available at startup.',\n    '// registerController() puts each class directly in the router\\'s cache.',\n  ];\n\n  if (unresolved.length > 0) {\n    lines.push(\n      '',\n      '// WARNING: The following controllers could not be resolved on disk:',\n      ...unresolved.map((name) => `//   - ${name}`),\n    );\n  }\n\n  // Static imports\n  lines.push('');\n  for (const imp of imports) {\n    lines.push(imp);\n  }\n\n  // Registration function\n  lines.push(\n    '',\n    'export function registerControllers(router: { registerController(name: string, cls: any): void }) {',\n  );\n  for (const reg of registrations) {\n    lines.push(reg);\n  }\n  lines.push(\n    '}',\n    '',\n  );\n\n  return lines.join('\\n');\n}\n"],"mappings":"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","names":[]}

package/dist/codegen/index.d.cts

@@ -7,5 +7,6 @@ export { RuntimeGeneratorOptions, generateRuntime } from './runtime_generator.cj
 export { RendererViewManifestGeneratorOptions, generateRendererViewManifest } from './renderer_view_manifest_generator.cjs';
 export { RendererControllerRegistrationOptions, generateRendererControllerRegistration } from './renderer_controller_registration_generator.cjs';
 export { RendererAppGeneratorOptions, generateRendererApp } from './renderer_app_generator.cjs';
+import '../types/config.cjs';
 import '../types/operations.cjs';
 import '../types/views.cjs';

package/dist/codegen/index.d.ts

@@ -7,5 +7,6 @@ export { RuntimeGeneratorOptions, generateRuntime } from './runtime_generator.js
 export { RendererViewManifestGeneratorOptions, generateRendererViewManifest } from './renderer_view_manifest_generator.js';
 export { RendererControllerRegistrationOptions, generateRendererControllerRegistration } from './renderer_controller_registration_generator.js';
 export { RendererAppGeneratorOptions, generateRendererApp } from './renderer_app_generator.js';
+import '../types/config.js';
 import '../types/operations.js';
 import '../types/views.js';

package/dist/codegen/preload_generator.cjs

@@ -21,6 +21,7 @@ __export(preload_generator_exports, {
   generatePreload: () => generatePreload
 });
 module.exports = __toCommonJS(preload_generator_exports);
+var import_config_parser = require("../config/config_parser.cjs");
 var import_generated_file_notice = require("./generated_file_notice.cjs");
 const PRELOAD_SOURCE_INSTRUCTIONS = [
   "To change IPC channels or preload bridge methods, edit the operations YAML configured by",
@@ -83,10 +84,11 @@ ${entries.join("\n")}
 ];`;
 }
 const INTERNAL_BRIDGE_GLOBAL_KEY = "__NOEGO_WOOD_BRIDGE__";
-function generatePreload(operations) {
+function generatePreload(operations, options = {}) {
   const tree = buildNestedTree(operations);
   const operationsCode = generateTreeCode(tree);
   const rpcManifestCode = generateRpcManifestCode(operations);
+  const traceBatching = options.traceBatching ?? import_config_parser.RENDERER_TRACE_BATCHING_DEFAULTS;
   return `${(0, import_generated_file_notice.generatedFileNotice)(PRELOAD_SOURCE_INSTRUCTIONS)}
 import { contextBridge, ipcRenderer } from 'electron';
 import {
@@ -159,6 +161,9 @@ ${operationsCode}
   __log: (level: string, logger: string, message: string, context?: unknown) => {
     ipcRenderer.send('__log', { level, logger, message, context });
   },
+  __logBatch: (batch: unknown) => {
+    ipcRenderer.send('__log_batch', batch);
+  },
 });
 
 // Trace transport via MessagePort (activated when main process sends a port)
@@ -228,13 +233,15 @@ const __traceBatchPort: WoodTraceBatchPort = {
   },
 };
 
+// Batching policy resolved from wood.config.yml observability configuration
+// at generation time; this file embeds but does not own it.
 const __traceBatchTransport = new RendererTraceBatchTransport({
   producerId: __traceBatchProducerId,
-  maxQueuedEvents: 256,
-  maxBatchEvents: 32,
-  acknowledgementTimeoutMs: 1_000,
-  retryLimit: 3,
-  retryBaseDelayMs: 25,
+  maxQueuedEvents: ${traceBatching.maxQueuedEvents},
+  maxBatchEvents: ${traceBatching.maxBatchEvents},
+  acknowledgementTimeoutMs: ${traceBatching.acknowledgementTimeoutMs},
+  retryLimit: ${traceBatching.retryLimit},
+  retryBaseDelayMs: ${traceBatching.retryBaseDelayMs},
   now: () => Date.now(),
   schedule: (work: () => void) => queueMicrotask(work),
   delay: (durationMs: number) => new Promise((resolve) => setTimeout(resolve, durationMs)),

package/dist/codegen/preload_generator.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/preload_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nconst PRELOAD_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels or preload bridge methods, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`.',\n] as const;\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys((op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {}).length > 0,\n  );\n}\n\n/**\n * Build a nested object tree from dot-path operation channels.\n * \"chat.message.send\" -> { chat: { message: { send: ... } } }\n */\nfunction buildNestedTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) current[parts[i]] = {};\n      current = current[parts[i]] as Record<string, unknown>;\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = { __operation: op };\n  }\n\n  return tree;\n}\n\n/**\n * Generate TypeScript code for a nested tree node.\n */\nfunction generateTreeCode(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(node)) {\n    const entry = value as Record<string, unknown>;\n    if (entry.__operation) {\n      const op = entry.__operation as OperationDef;\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${key}: (data: unknown) =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}', data),`);\n      } else {\n        lines.push(`${indent}${key}: () =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}'),`);\n      }\n    } else {\n      lines.push(`${indent}${key}: {`);\n      lines.push(generateTreeCode(entry, indent + '  '));\n      lines.push(`${indent}},`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nfunction generateRpcManifestCode(operations: Map<string, OperationDef>): string {\n  const entries = Array.from(operations.values())\n    .sort((a, b) => a.channel.localeCompare(b.channel))\n    .map((op) => {\n      const payload = {\n        channel: op.channel,\n        controller: op.controller,\n        action: op.action,\n        path: op.channel.split('.'),\n        hasInput: operationHasInput(op),\n      };\n      return `  ${JSON.stringify(payload)},`;\n    });\n\n  return `const __WOOD_RPC_MANIFEST = [\n${entries.join('\\n')}\n];`;\n}\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\n/**\n * Generate a complete preload.ts file from operations.\n */\nexport function generatePreload(operations: Map<string, OperationDef>): string {\n  const tree = buildNestedTree(operations);\n  const operationsCode = generateTreeCode(tree);\n  const rpcManifestCode = generateRpcManifestCode(operations);\n\n  return `${generatedFileNotice(PRELOAD_SOURCE_INSTRUCTIONS)}\nimport { contextBridge, ipcRenderer } from 'electron';\nimport {\n  RendererTraceBatchTransport,\n  type WoodRendererTraceInput,\n  type WoodTraceBatch,\n  type WoodTraceBatchAcknowledgement,\n  type WoodTraceBatchPort,\n} from '@noego/wood/trace-transport';\n\n${rpcManifestCode}\n\nconst __WOOD_INTERNAL_BRIDGE_KEY = '${INTERNAL_BRIDGE_GLOBAL_KEY}';\n\ncontextBridge.exposeInMainWorld(__WOOD_INTERNAL_BRIDGE_KEY, {\n${operationsCode}\n\n  // Internal: backend controller/action RPC map for @Inject(App)\n  __rpcManifest: __WOOD_RPC_MANIFEST,\n\n  // Internal: loader data requests\n  __load: (route: string, params: Record<string, string>) =>\n    ipcRenderer.invoke('__load', { route, params }),\n\n  // Internal: cross-window navigation\n  __navigate: (windowId: string, route: string) =>\n    ipcRenderer.invoke('__navigate', { windowId, route }),\n\n  // Internal: window management\n  __window: {\n    current: () =>\n      ipcRenderer.invoke('__window', { action: 'current' }),\n    open: (windowId: string, options?: Record<string, unknown>) =>\n      ipcRenderer.invoke('__window', { action: 'open', windowId, options }),\n    close: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'close', windowId }),\n    focus: (windowId: string) =>\n      ipcRenderer.invoke('__window', { action: 'focus', windowId }),\n    minimize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'minimize', windowId }),\n    maximize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'maximize', windowId }),\n  },\n\n  // Internal: framework config (trace min level, etc)\n  __woodConfig: () =>\n    ipcRenderer.invoke('__woodConfig'),\n\n  // Internal: debug metadata\n  __debug: {\n    current: () =>\n      ipcRenderer.invoke('__debug', { action: 'current' }),\n  },\n\n  // Internal: context menu\n  __contextMenu: {\n    show: (data: unknown) =>\n      ipcRenderer.invoke('__contextMenu', { action: 'show', ...data as Record<string, unknown> }),\n  },\n\n  // Push events from main process\n  on: (channel: string, callback: (...args: unknown[]) => void) => {\n    const subscription = (_event: unknown, ...args: unknown[]) => callback(...args);\n    ipcRenderer.on(\\`__event:\\${channel}\\`, subscription);\n    return () => ipcRenderer.removeListener(\\`__event:\\${channel}\\`, subscription);\n  },\n  __trace: (event: unknown) => {\n    ipcRenderer.send('__trace', event);\n  },\n  __log: (level: string, logger: string, message: string, context?: unknown) => {\n    ipcRenderer.send('__log', { level, logger, message, context });\n  },\n});\n\n// Trace transport via MessagePort (activated when main process sends a port)\nlet __tracePort: MessagePort | null = null;\nconst __traceBuffer: unknown[] = [];\nconst __TRACE_BUFFER_CAPACITY = 256;\nlet __traceDroppedCapacity = 0;\n\nfunction __traceFlush(): void {\n  while (__traceBuffer.length > 0 && __tracePort) {\n    __tracePort.postMessage(__traceBuffer.shift());\n  }\n}\n\nipcRenderer.on('__trace-port', (event) => {\n  __tracePort = event.ports[0];\n  __tracePort.start();\n  __traceFlush();\n});\n\ncontextBridge.exposeInMainWorld('__NOEGO_TRACE__', {\n  send: (data: unknown) => {\n    if (__tracePort) {\n      __tracePort.postMessage(data);\n    } else if (__traceBuffer.length >= __TRACE_BUFFER_CAPACITY) {\n      __traceDroppedCapacity += 1;\n    } else {\n      __traceBuffer.push(data);\n    }\n  },\n  status: () => ({\n    queuedEvents: __traceBuffer.length,\n    droppedCapacity: __traceDroppedCapacity,\n  }),\n});\n\nconst __traceBatchProducerId = typeof globalThis.crypto?.randomUUID === 'function'\n  ? globalThis.crypto.randomUUID()\n  : \\`wood-renderer-\\${Date.now()}-\\${Math.random().toString(16).slice(2)}\\`;\nlet __traceBatchListener: ((message: unknown) => void) | null = null;\n\nconst __traceBatchPort: WoodTraceBatchPort = {\n  postMessage: (batch: WoodTraceBatch) => {\n    void ipcRenderer.invoke('__traceBatch', batch)\n      .then((acknowledgement: WoodTraceBatchAcknowledgement) => {\n        __traceBatchListener?.(acknowledgement);\n      })\n      .catch((error: unknown) => {\n        __traceBatchListener?.({\n          kind: 'retryable',\n          batchId: batch.batchId,\n          reason: error instanceof Error ? error.message : String(error),\n          retryAfterMs: 100,\n        });\n      });\n  },\n  subscribe: (listener: (message: unknown) => void) => {\n    __traceBatchListener = listener;\n    return () => {\n      if (__traceBatchListener === listener) {\n        __traceBatchListener = null;\n      }\n    };\n  },\n  close: () => {\n    __traceBatchListener = null;\n  },\n};\n\nconst __traceBatchTransport = new RendererTraceBatchTransport({\n  producerId: __traceBatchProducerId,\n  maxQueuedEvents: 256,\n  maxBatchEvents: 32,\n  acknowledgementTimeoutMs: 1_000,\n  retryLimit: 3,\n  retryBaseDelayMs: 25,\n  now: () => Date.now(),\n  schedule: (work: () => void) => queueMicrotask(work),\n  delay: (durationMs: number) => new Promise((resolve) => setTimeout(resolve, durationMs)),\n});\n__traceBatchTransport.attachPort(__traceBatchPort);\n\ncontextBridge.exposeInMainWorld('__NOEGO_WOOD_TRACE_BATCH__', {\n  send: (event: WoodRendererTraceInput) => __traceBatchTransport.admit(event),\n  status: () => __traceBatchTransport.status(),\n  flush: (deadlineMs: number) => __traceBatchTransport.flush(deadlineMs),\n  close: (deadlineMs: number) => __traceBatchTransport.close(deadlineMs),\n});\n\nipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {\n  if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {\n    return;\n  }\n  const requestId = Reflect.get(payload, 'requestId');\n  const deadlineMs = Reflect.get(payload, 'deadlineMs');\n  if (typeof requestId !== 'string'\n    || typeof deadlineMs !== 'number'\n    || !Number.isFinite(deadlineMs)) {\n    return;\n  }\n  void __traceBatchTransport.close(deadlineMs).finally(() => {\n    ipcRenderer.send('__woodTraceDrainAck', {\n      requestId,\n      status: __traceBatchTransport.status(),\n    });\n  });\n});\n\nglobalThis.addEventListener?.('pagehide', () => {\n  void __traceBatchTransport.flush(Date.now() + 100);\n});\n`;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/codegen/preload_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.cjs';\nimport type { RendererTraceBatchingConfig } from '../types/config.cjs';\nimport { RENDERER_TRACE_BATCHING_DEFAULTS } from '../config/config_parser.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nexport type GeneratePreloadOptions = {\n  /**\n   * Renderer→main IPC trace batching policy resolved from\n   * wood.config.yml `observability.trace.rendererToMain.batching`.\n   * The generated preload embeds these values but does not own them.\n   */\n  traceBatching?: RendererTraceBatchingConfig;\n};\n\nconst PRELOAD_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels or preload bridge methods, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`.',\n] as const;\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys((op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {}).length > 0,\n  );\n}\n\n/**\n * Build a nested object tree from dot-path operation channels.\n * \"chat.message.send\" -> { chat: { message: { send: ... } } }\n */\nfunction buildNestedTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) current[parts[i]] = {};\n      current = current[parts[i]] as Record<string, unknown>;\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = { __operation: op };\n  }\n\n  return tree;\n}\n\n/**\n * Generate TypeScript code for a nested tree node.\n */\nfunction generateTreeCode(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(node)) {\n    const entry = value as Record<string, unknown>;\n    if (entry.__operation) {\n      const op = entry.__operation as OperationDef;\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${key}: (data: unknown) =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}', data),`);\n      } else {\n        lines.push(`${indent}${key}: () =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}'),`);\n      }\n    } else {\n      lines.push(`${indent}${key}: {`);\n      lines.push(generateTreeCode(entry, indent + '  '));\n      lines.push(`${indent}},`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nfunction generateRpcManifestCode(operations: Map<string, OperationDef>): string {\n  const entries = Array.from(operations.values())\n    .sort((a, b) => a.channel.localeCompare(b.channel))\n    .map((op) => {\n      const payload = {\n        channel: op.channel,\n        controller: op.controller,\n        action: op.action,\n        path: op.channel.split('.'),\n        hasInput: operationHasInput(op),\n      };\n      return `  ${JSON.stringify(payload)},`;\n    });\n\n  return `const __WOOD_RPC_MANIFEST = [\n${entries.join('\\n')}\n];`;\n}\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\n/**\n * Generate a complete preload.ts file from operations.\n */\nexport function generatePreload(\n  operations: Map<string, OperationDef>,\n  options: GeneratePreloadOptions = {},\n): string {\n  const tree = buildNestedTree(operations);\n  const operationsCode = generateTreeCode(tree);\n  const rpcManifestCode = generateRpcManifestCode(operations);\n  const traceBatching = options.traceBatching ?? RENDERER_TRACE_BATCHING_DEFAULTS;\n\n  return `${generatedFileNotice(PRELOAD_SOURCE_INSTRUCTIONS)}\nimport { contextBridge, ipcRenderer } from 'electron';\nimport {\n  RendererTraceBatchTransport,\n  type WoodRendererTraceInput,\n  type WoodTraceBatch,\n  type WoodTraceBatchAcknowledgement,\n  type WoodTraceBatchPort,\n} from '@noego/wood/trace-transport';\n\n${rpcManifestCode}\n\nconst __WOOD_INTERNAL_BRIDGE_KEY = '${INTERNAL_BRIDGE_GLOBAL_KEY}';\n\ncontextBridge.exposeInMainWorld(__WOOD_INTERNAL_BRIDGE_KEY, {\n${operationsCode}\n\n  // Internal: backend controller/action RPC map for @Inject(App)\n  __rpcManifest: __WOOD_RPC_MANIFEST,\n\n  // Internal: loader data requests\n  __load: (route: string, params: Record<string, string>) =>\n    ipcRenderer.invoke('__load', { route, params }),\n\n  // Internal: cross-window navigation\n  __navigate: (windowId: string, route: string) =>\n    ipcRenderer.invoke('__navigate', { windowId, route }),\n\n  // Internal: window management\n  __window: {\n    current: () =>\n      ipcRenderer.invoke('__window', { action: 'current' }),\n    open: (windowId: string, options?: Record<string, unknown>) =>\n      ipcRenderer.invoke('__window', { action: 'open', windowId, options }),\n    close: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'close', windowId }),\n    focus: (windowId: string) =>\n      ipcRenderer.invoke('__window', { action: 'focus', windowId }),\n    minimize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'minimize', windowId }),\n    maximize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'maximize', windowId }),\n  },\n\n  // Internal: framework config (trace min level, etc)\n  __woodConfig: () =>\n    ipcRenderer.invoke('__woodConfig'),\n\n  // Internal: debug metadata\n  __debug: {\n    current: () =>\n      ipcRenderer.invoke('__debug', { action: 'current' }),\n  },\n\n  // Internal: context menu\n  __contextMenu: {\n    show: (data: unknown) =>\n      ipcRenderer.invoke('__contextMenu', { action: 'show', ...data as Record<string, unknown> }),\n  },\n\n  // Push events from main process\n  on: (channel: string, callback: (...args: unknown[]) => void) => {\n    const subscription = (_event: unknown, ...args: unknown[]) => callback(...args);\n    ipcRenderer.on(\\`__event:\\${channel}\\`, subscription);\n    return () => ipcRenderer.removeListener(\\`__event:\\${channel}\\`, subscription);\n  },\n  __trace: (event: unknown) => {\n    ipcRenderer.send('__trace', event);\n  },\n  __log: (level: string, logger: string, message: string, context?: unknown) => {\n    ipcRenderer.send('__log', { level, logger, message, context });\n  },\n  __logBatch: (batch: unknown) => {\n    ipcRenderer.send('__log_batch', batch);\n  },\n});\n\n// Trace transport via MessagePort (activated when main process sends a port)\nlet __tracePort: MessagePort | null = null;\nconst __traceBuffer: unknown[] = [];\nconst __TRACE_BUFFER_CAPACITY = 256;\nlet __traceDroppedCapacity = 0;\n\nfunction __traceFlush(): void {\n  while (__traceBuffer.length > 0 && __tracePort) {\n    __tracePort.postMessage(__traceBuffer.shift());\n  }\n}\n\nipcRenderer.on('__trace-port', (event) => {\n  __tracePort = event.ports[0];\n  __tracePort.start();\n  __traceFlush();\n});\n\ncontextBridge.exposeInMainWorld('__NOEGO_TRACE__', {\n  send: (data: unknown) => {\n    if (__tracePort) {\n      __tracePort.postMessage(data);\n    } else if (__traceBuffer.length >= __TRACE_BUFFER_CAPACITY) {\n      __traceDroppedCapacity += 1;\n    } else {\n      __traceBuffer.push(data);\n    }\n  },\n  status: () => ({\n    queuedEvents: __traceBuffer.length,\n    droppedCapacity: __traceDroppedCapacity,\n  }),\n});\n\nconst __traceBatchProducerId = typeof globalThis.crypto?.randomUUID === 'function'\n  ? globalThis.crypto.randomUUID()\n  : \\`wood-renderer-\\${Date.now()}-\\${Math.random().toString(16).slice(2)}\\`;\nlet __traceBatchListener: ((message: unknown) => void) | null = null;\n\nconst __traceBatchPort: WoodTraceBatchPort = {\n  postMessage: (batch: WoodTraceBatch) => {\n    void ipcRenderer.invoke('__traceBatch', batch)\n      .then((acknowledgement: WoodTraceBatchAcknowledgement) => {\n        __traceBatchListener?.(acknowledgement);\n      })\n      .catch((error: unknown) => {\n        __traceBatchListener?.({\n          kind: 'retryable',\n          batchId: batch.batchId,\n          reason: error instanceof Error ? error.message : String(error),\n          retryAfterMs: 100,\n        });\n      });\n  },\n  subscribe: (listener: (message: unknown) => void) => {\n    __traceBatchListener = listener;\n    return () => {\n      if (__traceBatchListener === listener) {\n        __traceBatchListener = null;\n      }\n    };\n  },\n  close: () => {\n    __traceBatchListener = null;\n  },\n};\n\n// Batching policy resolved from wood.config.yml observability configuration\n// at generation time; this file embeds but does not own it.\nconst __traceBatchTransport = new RendererTraceBatchTransport({\n  producerId: __traceBatchProducerId,\n  maxQueuedEvents: ${traceBatching.maxQueuedEvents},\n  maxBatchEvents: ${traceBatching.maxBatchEvents},\n  acknowledgementTimeoutMs: ${traceBatching.acknowledgementTimeoutMs},\n  retryLimit: ${traceBatching.retryLimit},\n  retryBaseDelayMs: ${traceBatching.retryBaseDelayMs},\n  now: () => Date.now(),\n  schedule: (work: () => void) => queueMicrotask(work),\n  delay: (durationMs: number) => new Promise((resolve) => setTimeout(resolve, durationMs)),\n});\n__traceBatchTransport.attachPort(__traceBatchPort);\n\ncontextBridge.exposeInMainWorld('__NOEGO_WOOD_TRACE_BATCH__', {\n  send: (event: WoodRendererTraceInput) => __traceBatchTransport.admit(event),\n  status: () => __traceBatchTransport.status(),\n  flush: (deadlineMs: number) => __traceBatchTransport.flush(deadlineMs),\n  close: (deadlineMs: number) => __traceBatchTransport.close(deadlineMs),\n});\n\nipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {\n  if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {\n    return;\n  }\n  const requestId = Reflect.get(payload, 'requestId');\n  const deadlineMs = Reflect.get(payload, 'deadlineMs');\n  if (typeof requestId !== 'string'\n    || typeof deadlineMs !== 'number'\n    || !Number.isFinite(deadlineMs)) {\n    return;\n  }\n  void __traceBatchTransport.close(deadlineMs).finally(() => {\n    ipcRenderer.send('__woodTraceDrainAck', {\n      requestId,\n      status: __traceBatchTransport.status(),\n    });\n  });\n});\n\nglobalThis.addEventListener?.('pagehide', () => {\n  void __traceBatchTransport.flush(Date.now() + 100);\n});\n`;\n}\n"],"mappings":"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","names":[]}

package/dist/codegen/preload_generator.d.cts

@@ -1,8 +1,17 @@
+import { RendererTraceBatchingConfig } from '../types/config.cjs';
 import { OperationDef } from '../types/operations.cjs';
 
+type GeneratePreloadOptions = {
+    /**
+     * Renderer→main IPC trace batching policy resolved from
+     * wood.config.yml `observability.trace.rendererToMain.batching`.
+     * The generated preload embeds these values but does not own them.
+     */
+    traceBatching?: RendererTraceBatchingConfig;
+};
 /**
  * Generate a complete preload.ts file from operations.
  */
-declare function generatePreload(operations: Map<string, OperationDef>): string;
+declare function generatePreload(operations: Map<string, OperationDef>, options?: GeneratePreloadOptions): string;
 
-export { generatePreload };
+export { type GeneratePreloadOptions, generatePreload };

package/dist/codegen/preload_generator.d.ts

@@ -1,8 +1,17 @@
+import { RendererTraceBatchingConfig } from '../types/config.js';
 import { OperationDef } from '../types/operations.js';
 
+type GeneratePreloadOptions = {
+    /**
+     * Renderer→main IPC trace batching policy resolved from
+     * wood.config.yml `observability.trace.rendererToMain.batching`.
+     * The generated preload embeds these values but does not own them.
+     */
+    traceBatching?: RendererTraceBatchingConfig;
+};
 /**
  * Generate a complete preload.ts file from operations.
  */
-declare function generatePreload(operations: Map<string, OperationDef>): string;
+declare function generatePreload(operations: Map<string, OperationDef>, options?: GeneratePreloadOptions): string;
 
-export { generatePreload };
+export { type GeneratePreloadOptions, generatePreload };

package/dist/codegen/preload_generator.js

@@ -1,3 +1,4 @@
+import { RENDERER_TRACE_BATCHING_DEFAULTS } from "../config/config_parser.js";
 import { generatedFileNotice } from "./generated_file_notice.js";
 const PRELOAD_SOURCE_INSTRUCTIONS = [
   "To change IPC channels or preload bridge methods, edit the operations YAML configured by",
@@ -60,10 +61,11 @@ ${entries.join("\n")}
 ];`;
 }
 const INTERNAL_BRIDGE_GLOBAL_KEY = "__NOEGO_WOOD_BRIDGE__";
-function generatePreload(operations) {
+function generatePreload(operations, options = {}) {
   const tree = buildNestedTree(operations);
   const operationsCode = generateTreeCode(tree);
   const rpcManifestCode = generateRpcManifestCode(operations);
+  const traceBatching = options.traceBatching ?? RENDERER_TRACE_BATCHING_DEFAULTS;
   return `${generatedFileNotice(PRELOAD_SOURCE_INSTRUCTIONS)}
 import { contextBridge, ipcRenderer } from 'electron';
 import {
@@ -136,6 +138,9 @@ ${operationsCode}
   __log: (level: string, logger: string, message: string, context?: unknown) => {
     ipcRenderer.send('__log', { level, logger, message, context });
   },
+  __logBatch: (batch: unknown) => {
+    ipcRenderer.send('__log_batch', batch);
+  },
 });
 
 // Trace transport via MessagePort (activated when main process sends a port)
@@ -205,13 +210,15 @@ const __traceBatchPort: WoodTraceBatchPort = {
   },
 };
 
+// Batching policy resolved from wood.config.yml observability configuration
+// at generation time; this file embeds but does not own it.
 const __traceBatchTransport = new RendererTraceBatchTransport({
   producerId: __traceBatchProducerId,
-  maxQueuedEvents: 256,
-  maxBatchEvents: 32,
-  acknowledgementTimeoutMs: 1_000,
-  retryLimit: 3,
-  retryBaseDelayMs: 25,
+  maxQueuedEvents: ${traceBatching.maxQueuedEvents},
+  maxBatchEvents: ${traceBatching.maxBatchEvents},
+  acknowledgementTimeoutMs: ${traceBatching.acknowledgementTimeoutMs},
+  retryLimit: ${traceBatching.retryLimit},
+  retryBaseDelayMs: ${traceBatching.retryBaseDelayMs},
   now: () => Date.now(),
   schedule: (work: () => void) => queueMicrotask(work),
   delay: (durationMs: number) => new Promise((resolve) => setTimeout(resolve, durationMs)),

package/dist/codegen/preload_generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/preload_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nconst PRELOAD_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels or preload bridge methods, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`.',\n] as const;\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys((op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {}).length > 0,\n  );\n}\n\n/**\n * Build a nested object tree from dot-path operation channels.\n * \"chat.message.send\" -> { chat: { message: { send: ... } } }\n */\nfunction buildNestedTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) current[parts[i]] = {};\n      current = current[parts[i]] as Record<string, unknown>;\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = { __operation: op };\n  }\n\n  return tree;\n}\n\n/**\n * Generate TypeScript code for a nested tree node.\n */\nfunction generateTreeCode(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(node)) {\n    const entry = value as Record<string, unknown>;\n    if (entry.__operation) {\n      const op = entry.__operation as OperationDef;\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${key}: (data: unknown) =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}', data),`);\n      } else {\n        lines.push(`${indent}${key}: () =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}'),`);\n      }\n    } else {\n      lines.push(`${indent}${key}: {`);\n      lines.push(generateTreeCode(entry, indent + '  '));\n      lines.push(`${indent}},`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nfunction generateRpcManifestCode(operations: Map<string, OperationDef>): string {\n  const entries = Array.from(operations.values())\n    .sort((a, b) => a.channel.localeCompare(b.channel))\n    .map((op) => {\n      const payload = {\n        channel: op.channel,\n        controller: op.controller,\n        action: op.action,\n        path: op.channel.split('.'),\n        hasInput: operationHasInput(op),\n      };\n      return `  ${JSON.stringify(payload)},`;\n    });\n\n  return `const __WOOD_RPC_MANIFEST = [\n${entries.join('\\n')}\n];`;\n}\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\n/**\n * Generate a complete preload.ts file from operations.\n */\nexport function generatePreload(operations: Map<string, OperationDef>): string {\n  const tree = buildNestedTree(operations);\n  const operationsCode = generateTreeCode(tree);\n  const rpcManifestCode = generateRpcManifestCode(operations);\n\n  return `${generatedFileNotice(PRELOAD_SOURCE_INSTRUCTIONS)}\nimport { contextBridge, ipcRenderer } from 'electron';\nimport {\n  RendererTraceBatchTransport,\n  type WoodRendererTraceInput,\n  type WoodTraceBatch,\n  type WoodTraceBatchAcknowledgement,\n  type WoodTraceBatchPort,\n} from '@noego/wood/trace-transport';\n\n${rpcManifestCode}\n\nconst __WOOD_INTERNAL_BRIDGE_KEY = '${INTERNAL_BRIDGE_GLOBAL_KEY}';\n\ncontextBridge.exposeInMainWorld(__WOOD_INTERNAL_BRIDGE_KEY, {\n${operationsCode}\n\n  // Internal: backend controller/action RPC map for @Inject(App)\n  __rpcManifest: __WOOD_RPC_MANIFEST,\n\n  // Internal: loader data requests\n  __load: (route: string, params: Record<string, string>) =>\n    ipcRenderer.invoke('__load', { route, params }),\n\n  // Internal: cross-window navigation\n  __navigate: (windowId: string, route: string) =>\n    ipcRenderer.invoke('__navigate', { windowId, route }),\n\n  // Internal: window management\n  __window: {\n    current: () =>\n      ipcRenderer.invoke('__window', { action: 'current' }),\n    open: (windowId: string, options?: Record<string, unknown>) =>\n      ipcRenderer.invoke('__window', { action: 'open', windowId, options }),\n    close: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'close', windowId }),\n    focus: (windowId: string) =>\n      ipcRenderer.invoke('__window', { action: 'focus', windowId }),\n    minimize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'minimize', windowId }),\n    maximize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'maximize', windowId }),\n  },\n\n  // Internal: framework config (trace min level, etc)\n  __woodConfig: () =>\n    ipcRenderer.invoke('__woodConfig'),\n\n  // Internal: debug metadata\n  __debug: {\n    current: () =>\n      ipcRenderer.invoke('__debug', { action: 'current' }),\n  },\n\n  // Internal: context menu\n  __contextMenu: {\n    show: (data: unknown) =>\n      ipcRenderer.invoke('__contextMenu', { action: 'show', ...data as Record<string, unknown> }),\n  },\n\n  // Push events from main process\n  on: (channel: string, callback: (...args: unknown[]) => void) => {\n    const subscription = (_event: unknown, ...args: unknown[]) => callback(...args);\n    ipcRenderer.on(\\`__event:\\${channel}\\`, subscription);\n    return () => ipcRenderer.removeListener(\\`__event:\\${channel}\\`, subscription);\n  },\n  __trace: (event: unknown) => {\n    ipcRenderer.send('__trace', event);\n  },\n  __log: (level: string, logger: string, message: string, context?: unknown) => {\n    ipcRenderer.send('__log', { level, logger, message, context });\n  },\n});\n\n// Trace transport via MessagePort (activated when main process sends a port)\nlet __tracePort: MessagePort | null = null;\nconst __traceBuffer: unknown[] = [];\nconst __TRACE_BUFFER_CAPACITY = 256;\nlet __traceDroppedCapacity = 0;\n\nfunction __traceFlush(): void {\n  while (__traceBuffer.length > 0 && __tracePort) {\n    __tracePort.postMessage(__traceBuffer.shift());\n  }\n}\n\nipcRenderer.on('__trace-port', (event) => {\n  __tracePort = event.ports[0];\n  __tracePort.start();\n  __traceFlush();\n});\n\ncontextBridge.exposeInMainWorld('__NOEGO_TRACE__', {\n  send: (data: unknown) => {\n    if (__tracePort) {\n      __tracePort.postMessage(data);\n    } else if (__traceBuffer.length >= __TRACE_BUFFER_CAPACITY) {\n      __traceDroppedCapacity += 1;\n    } else {\n      __traceBuffer.push(data);\n    }\n  },\n  status: () => ({\n    queuedEvents: __traceBuffer.length,\n    droppedCapacity: __traceDroppedCapacity,\n  }),\n});\n\nconst __traceBatchProducerId = typeof globalThis.crypto?.randomUUID === 'function'\n  ? globalThis.crypto.randomUUID()\n  : \\`wood-renderer-\\${Date.now()}-\\${Math.random().toString(16).slice(2)}\\`;\nlet __traceBatchListener: ((message: unknown) => void) | null = null;\n\nconst __traceBatchPort: WoodTraceBatchPort = {\n  postMessage: (batch: WoodTraceBatch) => {\n    void ipcRenderer.invoke('__traceBatch', batch)\n      .then((acknowledgement: WoodTraceBatchAcknowledgement) => {\n        __traceBatchListener?.(acknowledgement);\n      })\n      .catch((error: unknown) => {\n        __traceBatchListener?.({\n          kind: 'retryable',\n          batchId: batch.batchId,\n          reason: error instanceof Error ? error.message : String(error),\n          retryAfterMs: 100,\n        });\n      });\n  },\n  subscribe: (listener: (message: unknown) => void) => {\n    __traceBatchListener = listener;\n    return () => {\n      if (__traceBatchListener === listener) {\n        __traceBatchListener = null;\n      }\n    };\n  },\n  close: () => {\n    __traceBatchListener = null;\n  },\n};\n\nconst __traceBatchTransport = new RendererTraceBatchTransport({\n  producerId: __traceBatchProducerId,\n  maxQueuedEvents: 256,\n  maxBatchEvents: 32,\n  acknowledgementTimeoutMs: 1_000,\n  retryLimit: 3,\n  retryBaseDelayMs: 25,\n  now: () => Date.now(),\n  schedule: (work: () => void) => queueMicrotask(work),\n  delay: (durationMs: number) => new Promise((resolve) => setTimeout(resolve, durationMs)),\n});\n__traceBatchTransport.attachPort(__traceBatchPort);\n\ncontextBridge.exposeInMainWorld('__NOEGO_WOOD_TRACE_BATCH__', {\n  send: (event: WoodRendererTraceInput) => __traceBatchTransport.admit(event),\n  status: () => __traceBatchTransport.status(),\n  flush: (deadlineMs: number) => __traceBatchTransport.flush(deadlineMs),\n  close: (deadlineMs: number) => __traceBatchTransport.close(deadlineMs),\n});\n\nipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {\n  if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {\n    return;\n  }\n  const requestId = Reflect.get(payload, 'requestId');\n  const deadlineMs = Reflect.get(payload, 'deadlineMs');\n  if (typeof requestId !== 'string'\n    || typeof deadlineMs !== 'number'\n    || !Number.isFinite(deadlineMs)) {\n    return;\n  }\n  void __traceBatchTransport.close(deadlineMs).finally(() => {\n    ipcRenderer.send('__woodTraceDrainAck', {\n      requestId,\n      status: __traceBatchTransport.status(),\n    });\n  });\n});\n\nglobalThis.addEventListener?.('pagehide', () => {\n  void __traceBatchTransport.flush(Date.now() + 100);\n});\n`;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/codegen/preload_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.js';\nimport type { RendererTraceBatchingConfig } from '../types/config.js';\nimport { RENDERER_TRACE_BATCHING_DEFAULTS } from '../config/config_parser.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nexport type GeneratePreloadOptions = {\n  /**\n   * Renderer→main IPC trace batching policy resolved from\n   * wood.config.yml `observability.trace.rendererToMain.batching`.\n   * The generated preload embeds these values but does not own them.\n   */\n  traceBatching?: RendererTraceBatchingConfig;\n};\n\nconst PRELOAD_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels or preload bridge methods, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`.',\n] as const;\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys((op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {}).length > 0,\n  );\n}\n\n/**\n * Build a nested object tree from dot-path operation channels.\n * \"chat.message.send\" -> { chat: { message: { send: ... } } }\n */\nfunction buildNestedTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) current[parts[i]] = {};\n      current = current[parts[i]] as Record<string, unknown>;\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = { __operation: op };\n  }\n\n  return tree;\n}\n\n/**\n * Generate TypeScript code for a nested tree node.\n */\nfunction generateTreeCode(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(node)) {\n    const entry = value as Record<string, unknown>;\n    if (entry.__operation) {\n      const op = entry.__operation as OperationDef;\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${key}: (data: unknown) =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}', data),`);\n      } else {\n        lines.push(`${indent}${key}: () =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}'),`);\n      }\n    } else {\n      lines.push(`${indent}${key}: {`);\n      lines.push(generateTreeCode(entry, indent + '  '));\n      lines.push(`${indent}},`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nfunction generateRpcManifestCode(operations: Map<string, OperationDef>): string {\n  const entries = Array.from(operations.values())\n    .sort((a, b) => a.channel.localeCompare(b.channel))\n    .map((op) => {\n      const payload = {\n        channel: op.channel,\n        controller: op.controller,\n        action: op.action,\n        path: op.channel.split('.'),\n        hasInput: operationHasInput(op),\n      };\n      return `  ${JSON.stringify(payload)},`;\n    });\n\n  return `const __WOOD_RPC_MANIFEST = [\n${entries.join('\\n')}\n];`;\n}\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\n/**\n * Generate a complete preload.ts file from operations.\n */\nexport function generatePreload(\n  operations: Map<string, OperationDef>,\n  options: GeneratePreloadOptions = {},\n): string {\n  const tree = buildNestedTree(operations);\n  const operationsCode = generateTreeCode(tree);\n  const rpcManifestCode = generateRpcManifestCode(operations);\n  const traceBatching = options.traceBatching ?? RENDERER_TRACE_BATCHING_DEFAULTS;\n\n  return `${generatedFileNotice(PRELOAD_SOURCE_INSTRUCTIONS)}\nimport { contextBridge, ipcRenderer } from 'electron';\nimport {\n  RendererTraceBatchTransport,\n  type WoodRendererTraceInput,\n  type WoodTraceBatch,\n  type WoodTraceBatchAcknowledgement,\n  type WoodTraceBatchPort,\n} from '@noego/wood/trace-transport';\n\n${rpcManifestCode}\n\nconst __WOOD_INTERNAL_BRIDGE_KEY = '${INTERNAL_BRIDGE_GLOBAL_KEY}';\n\ncontextBridge.exposeInMainWorld(__WOOD_INTERNAL_BRIDGE_KEY, {\n${operationsCode}\n\n  // Internal: backend controller/action RPC map for @Inject(App)\n  __rpcManifest: __WOOD_RPC_MANIFEST,\n\n  // Internal: loader data requests\n  __load: (route: string, params: Record<string, string>) =>\n    ipcRenderer.invoke('__load', { route, params }),\n\n  // Internal: cross-window navigation\n  __navigate: (windowId: string, route: string) =>\n    ipcRenderer.invoke('__navigate', { windowId, route }),\n\n  // Internal: window management\n  __window: {\n    current: () =>\n      ipcRenderer.invoke('__window', { action: 'current' }),\n    open: (windowId: string, options?: Record<string, unknown>) =>\n      ipcRenderer.invoke('__window', { action: 'open', windowId, options }),\n    close: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'close', windowId }),\n    focus: (windowId: string) =>\n      ipcRenderer.invoke('__window', { action: 'focus', windowId }),\n    minimize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'minimize', windowId }),\n    maximize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'maximize', windowId }),\n  },\n\n  // Internal: framework config (trace min level, etc)\n  __woodConfig: () =>\n    ipcRenderer.invoke('__woodConfig'),\n\n  // Internal: debug metadata\n  __debug: {\n    current: () =>\n      ipcRenderer.invoke('__debug', { action: 'current' }),\n  },\n\n  // Internal: context menu\n  __contextMenu: {\n    show: (data: unknown) =>\n      ipcRenderer.invoke('__contextMenu', { action: 'show', ...data as Record<string, unknown> }),\n  },\n\n  // Push events from main process\n  on: (channel: string, callback: (...args: unknown[]) => void) => {\n    const subscription = (_event: unknown, ...args: unknown[]) => callback(...args);\n    ipcRenderer.on(\\`__event:\\${channel}\\`, subscription);\n    return () => ipcRenderer.removeListener(\\`__event:\\${channel}\\`, subscription);\n  },\n  __trace: (event: unknown) => {\n    ipcRenderer.send('__trace', event);\n  },\n  __log: (level: string, logger: string, message: string, context?: unknown) => {\n    ipcRenderer.send('__log', { level, logger, message, context });\n  },\n  __logBatch: (batch: unknown) => {\n    ipcRenderer.send('__log_batch', batch);\n  },\n});\n\n// Trace transport via MessagePort (activated when main process sends a port)\nlet __tracePort: MessagePort | null = null;\nconst __traceBuffer: unknown[] = [];\nconst __TRACE_BUFFER_CAPACITY = 256;\nlet __traceDroppedCapacity = 0;\n\nfunction __traceFlush(): void {\n  while (__traceBuffer.length > 0 && __tracePort) {\n    __tracePort.postMessage(__traceBuffer.shift());\n  }\n}\n\nipcRenderer.on('__trace-port', (event) => {\n  __tracePort = event.ports[0];\n  __tracePort.start();\n  __traceFlush();\n});\n\ncontextBridge.exposeInMainWorld('__NOEGO_TRACE__', {\n  send: (data: unknown) => {\n    if (__tracePort) {\n      __tracePort.postMessage(data);\n    } else if (__traceBuffer.length >= __TRACE_BUFFER_CAPACITY) {\n      __traceDroppedCapacity += 1;\n    } else {\n      __traceBuffer.push(data);\n    }\n  },\n  status: () => ({\n    queuedEvents: __traceBuffer.length,\n    droppedCapacity: __traceDroppedCapacity,\n  }),\n});\n\nconst __traceBatchProducerId = typeof globalThis.crypto?.randomUUID === 'function'\n  ? globalThis.crypto.randomUUID()\n  : \\`wood-renderer-\\${Date.now()}-\\${Math.random().toString(16).slice(2)}\\`;\nlet __traceBatchListener: ((message: unknown) => void) | null = null;\n\nconst __traceBatchPort: WoodTraceBatchPort = {\n  postMessage: (batch: WoodTraceBatch) => {\n    void ipcRenderer.invoke('__traceBatch', batch)\n      .then((acknowledgement: WoodTraceBatchAcknowledgement) => {\n        __traceBatchListener?.(acknowledgement);\n      })\n      .catch((error: unknown) => {\n        __traceBatchListener?.({\n          kind: 'retryable',\n          batchId: batch.batchId,\n          reason: error instanceof Error ? error.message : String(error),\n          retryAfterMs: 100,\n        });\n      });\n  },\n  subscribe: (listener: (message: unknown) => void) => {\n    __traceBatchListener = listener;\n    return () => {\n      if (__traceBatchListener === listener) {\n        __traceBatchListener = null;\n      }\n    };\n  },\n  close: () => {\n    __traceBatchListener = null;\n  },\n};\n\n// Batching policy resolved from wood.config.yml observability configuration\n// at generation time; this file embeds but does not own it.\nconst __traceBatchTransport = new RendererTraceBatchTransport({\n  producerId: __traceBatchProducerId,\n  maxQueuedEvents: ${traceBatching.maxQueuedEvents},\n  maxBatchEvents: ${traceBatching.maxBatchEvents},\n  acknowledgementTimeoutMs: ${traceBatching.acknowledgementTimeoutMs},\n  retryLimit: ${traceBatching.retryLimit},\n  retryBaseDelayMs: ${traceBatching.retryBaseDelayMs},\n  now: () => Date.now(),\n  schedule: (work: () => void) => queueMicrotask(work),\n  delay: (durationMs: number) => new Promise((resolve) => setTimeout(resolve, durationMs)),\n});\n__traceBatchTransport.attachPort(__traceBatchPort);\n\ncontextBridge.exposeInMainWorld('__NOEGO_WOOD_TRACE_BATCH__', {\n  send: (event: WoodRendererTraceInput) => __traceBatchTransport.admit(event),\n  status: () => __traceBatchTransport.status(),\n  flush: (deadlineMs: number) => __traceBatchTransport.flush(deadlineMs),\n  close: (deadlineMs: number) => __traceBatchTransport.close(deadlineMs),\n});\n\nipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {\n  if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {\n    return;\n  }\n  const requestId = Reflect.get(payload, 'requestId');\n  const deadlineMs = Reflect.get(payload, 'deadlineMs');\n  if (typeof requestId !== 'string'\n    || typeof deadlineMs !== 'number'\n    || !Number.isFinite(deadlineMs)) {\n    return;\n  }\n  void __traceBatchTransport.close(deadlineMs).finally(() => {\n    ipcRenderer.send('__woodTraceDrainAck', {\n      requestId,\n      status: __traceBatchTransport.status(),\n    });\n  });\n});\n\nglobalThis.addEventListener?.('pagehide', () => {\n  void __traceBatchTransport.flush(Date.now() + 100);\n});\n`;\n}\n"],"mappings":"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","names":[]}