every-plugin 2.10.0 → 3.0.0-rc.0

package/dist/runtime/errors.mjs

@@ -1,10 +1,27 @@
-import { ORPCError } from "@orpc/contract";
 import { Cause, Data } from "effect";
+import { ORPCError } from "@orpc/server";
 
 //#region src/runtime/errors.ts
-var PluginRuntimeError = class extends Data.TaggedError("PluginRuntimeError") {};
+var PluginRuntimeError = class extends Data.TaggedError("PluginRuntimeError") {
+	get message() {
+		return this.cause?.message ?? "Plugin operation failed";
+	}
+};
 var ModuleFederationError = class extends Data.TaggedError("ModuleFederationError") {};
 var ValidationError = class extends Data.TaggedError("ValidationError") {};
+const stringifyUnknown = (value) => {
+	if (value === null) return "null";
+	if (value === void 0) return "undefined";
+	if (value instanceof Error) return value.message;
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "bigint" || typeof value === "boolean") return `${value}`;
+	if (typeof value === "symbol") return value.description ?? "";
+	try {
+		return JSON.stringify(value) ?? "[Unserializable value]";
+	} catch {
+		return "[Unserializable value]";
+	}
+};
 const extractErrorMessage = (error) => {
 	if (!error) return "Unknown error";
 	if (error instanceof Error) {
@@ -13,7 +30,25 @@ const extractErrorMessage = (error) => {
 	}
 	if (error instanceof AggregateError && error.errors?.length) return error.errors.map((e) => extractErrorMessage(e)).join("; ");
 	if (typeof error === "object" && "message" in error) return String(error.message);
-	return String(error);
+	return stringifyUnknown(error);
+};
+/**
+* The deepest Error along the cause chain — the original throw site. Wrapper
+* errors (PluginRuntimeError, ModuleFederationError) carry their own stacks
+* (the wrapping frames); diagnosis needs the cause's stack (the actual
+* failing module inside the evaluated remote entry).
+*/
+const deepestErrorStack = (error) => {
+	let current = error;
+	let deepest;
+	let hops = 0;
+	while (current instanceof Error && hops < 8) {
+		if (current.stack) deepest = current.stack;
+		current = current.cause;
+		hops += 1;
+	}
+	if (current instanceof Error && current.stack) deepest = current.stack;
+	return deepest;
 };
 const formatValidationIssue = (issue, index, maxDisplay) => {
 	if (index >= maxDisplay) return "";
@@ -33,7 +68,7 @@ const formatDataPreview = (data, maxLength = 100) => {
 		}
 		return `${str.slice(0, maxLength)}...`;
 	} catch {
-		return String(data).slice(0, maxLength);
+		return stringifyUnknown(data).slice(0, maxLength);
 	}
 };
 const formatORPCValidationError = (error) => {
@@ -59,18 +94,31 @@ const formatORPCValidationError = (error) => {
 	lines.push(`╰${"─".repeat(50)}\n`);
 	return lines;
 };
+const formatUnknownError = (error) => {
+	if (!error) return null;
+	const message = extractErrorMessage(error);
+	const lines = [];
+	lines.push(`\n╭─ Unhandled error ${"─".repeat(37)}`);
+	for (const line of message.split("\n")) lines.push(`│  ${line}`);
+	const stack = error instanceof Error ? error.stack?.split("\n").slice(1, 6) : void 0;
+	if (stack && stack.length > 0) {
+		lines.push(`│`);
+		for (const line of stack) lines.push(`│  ${line.trim()}`);
+	}
+	lines.push(`╰${"─".repeat(50)}\n`);
+	return lines.join("\n");
+};
 const formatORPCError = (error) => {
-	if (!(error instanceof ORPCError)) return null;
+	if (!(error instanceof ORPCError)) return formatUnknownError(error);
 	const validationLines = formatORPCValidationError(error);
 	if (validationLines) return validationLines.join("\n");
 	const lines = [];
 	const code = error.code || "UNKNOWN";
-	const status = error.status || 500;
 	const message = error.message || "An error occurred";
 	lines.push(`\n╭─ oRPC Error ${"─".repeat(40)}`);
 	const messageLines = message.split("\n");
 	for (const line of messageLines) lines.push(`│  ${line}`);
-	lines.push(`│  Code: ${code} (${status})`);
+	lines.push(`│  Code: ${code}`);
 	lines.push(`│`);
 	if (error.data) {
 		if (typeof error.data === "object" && error.data !== null) {
@@ -95,38 +143,96 @@ const formatORPCError = (error) => {
 		case "GATEWAY_TIMEOUT":
 			lines.push(`│  → The service may be temporarily unavailable`);
 			break;
-		case "TIMEOUT":
-			lines.push(`│  → The operation took too long`);
-			break;
+		case "TIMEOUT": lines.push(`│  → The operation took too long`);
 	}
 	lines.push(`╰${"─".repeat(50)}\n`);
 	return lines.join("\n");
 };
-const isRetryableError = (message) => {
-	return [
-		"ETIMEDOUT",
-		"ECONNRESET",
-		"timeout",
-		"503",
-		"429"
-	].some((p) => message.toLowerCase().includes(p.toLowerCase()));
-};
-const isRetryableORPCCode = (code) => {
-	switch (code) {
-		case "TOO_MANY_REQUESTS":
-		case "SERVICE_UNAVAILABLE":
-		case "BAD_GATEWAY":
-		case "GATEWAY_TIMEOUT":
-		case "TIMEOUT": return true;
-		default: return false;
+const NETWORK_RETRYABLE_PATTERNS = [
+	"ETIMEDOUT",
+	"ECONNRESET",
+	"timeout",
+	"503",
+	"429"
+];
+const NETWORK_DEAD_PATTERNS = [
+	"ECONNREFUSED",
+	"ENOTFOUND",
+	"EHOSTUNREACH"
+];
+const RETRYABLE_ORPC_CODES = /* @__PURE__ */ new Set([
+	"TOO_MANY_REQUESTS",
+	"SERVICE_UNAVAILABLE",
+	"BAD_GATEWAY",
+	"GATEWAY_TIMEOUT",
+	"TIMEOUT"
+]);
+/**
+* One classification for plugin lifecycle failures across MF / validation /
+* network sources. This is the recovery policy — nothing in the runtime
+* retries on it today by design (the host degrades and runs without a failed
+* plugin); consumers (host bootstrap messages, the dev server retry loop)
+* read kind / retryable / suggestion to decide what to tell the author.
+*/
+const classifyPluginFailure = (error) => {
+	let current = extractFromFiberFailure(error);
+	let hops = 0;
+	while (current && typeof current === "object" && hops < 8) {
+		if (current instanceof ModuleFederationError) return {
+			kind: "mf",
+			retryable: false,
+			message: extractErrorMessage(current),
+			suggestion: "Run bos mf check — the deployed plugin bundle is likely stale (sharedDep / pluginVersion skew), then redeploy the plugin and bos publish --deploy --packages local"
+		};
+		if (current instanceof ValidationError) return {
+			kind: "validation",
+			retryable: false,
+			message: `${current.stage}: ${extractErrorMessage(current.zodError)}`,
+			suggestion: `Fix the plugin's ${current.stage} schema at plugins/${current.pluginId}`
+		};
+		if (current instanceof ORPCError) {
+			const retryableByCode = RETRYABLE_ORPC_CODES.has(current.code);
+			return {
+				kind: "network",
+				retryable: retryableByCode,
+				message: current.message,
+				suggestion: retryableByCode ? "The plugin procedure failed transiently — retry the call" : void 0
+			};
+		}
+		current = current.cause;
+		hops += 1;
 	}
+	const message = extractErrorMessage(error);
+	const lower = message.toLowerCase();
+	if (NETWORK_RETRYABLE_PATTERNS.some((p) => lower.includes(p.toLowerCase()))) return {
+		kind: "network",
+		retryable: true,
+		message,
+		suggestion: "The remote may be temporarily unavailable — retry after redeploying the plugin"
+	};
+	if (NETWORK_DEAD_PATTERNS.some((p) => lower.includes(p.toLowerCase()))) return {
+		kind: "network",
+		retryable: false,
+		message,
+		suggestion: "The plugin host is unreachable — check plugins.<id> entry URLs in bos.config.json"
+	};
+	if (lower.includes("integrity") || lower.includes("sri")) return {
+		kind: "integrity",
+		retryable: true,
+		message,
+		suggestion: "The deployed bundle content does not match its recorded integrity — redeploy the plugin so bos.config.json is republished with a fresh hash"
+	};
+	return {
+		kind: "unknown",
+		retryable: false,
+		message
+	};
 };
 const wrapORPCError = (orpcError, pluginId, procedureName, operation) => {
 	return new PluginRuntimeError({
 		pluginId,
 		operation,
 		procedureName,
-		retryable: isRetryableORPCCode(orpcError.code),
 		cause: orpcError
 	});
 };
@@ -148,18 +254,17 @@ const extractFromFiberFailure = (error) => {
 	}
 	return error;
 };
-const toPluginRuntimeError = (error, pluginId, procedureName, operation, defaultRetryable = false) => {
+const toPluginRuntimeError = (error, pluginId, procedureName, operation) => {
 	if (error instanceof ORPCError) return wrapORPCError(error, pluginId, procedureName, operation);
 	if (error instanceof PluginRuntimeError) return error;
 	return new PluginRuntimeError({
 		pluginId,
 		operation,
 		procedureName,
-		retryable: defaultRetryable || isRetryableError(extractErrorMessage(error)),
 		cause: error instanceof Error ? error : new Error(extractErrorMessage(error))
 	});
 };
 
 //#endregion
-export { ModuleFederationError, PluginRuntimeError, ValidationError, extractFromFiberFailure, formatORPCError, isRetryableORPCCode, toPluginRuntimeError, wrapORPCError };
+export { ModuleFederationError, PluginRuntimeError, ValidationError, classifyPluginFailure, deepestErrorStack, extractFromFiberFailure, formatORPCError, toPluginRuntimeError, wrapORPCError };
 //# sourceMappingURL=errors.mjs.map

package/dist/runtime/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/runtime/errors.ts"],"sourcesContent":["import { ORPCError } from \"@orpc/contract\";\nimport { Cause, Data } from \"effect\";\nimport type { z } from \"zod\";\n\nexport class PluginRuntimeError extends Data.TaggedError(\"PluginRuntimeError\")<{\n  readonly pluginId?: string;\n  readonly operation?: string;\n  readonly procedureName?: string;\n  readonly cause?: Error;\n  readonly retryable: boolean;\n}> {}\n\nexport class ModuleFederationError extends Data.TaggedError(\"ModuleFederationError\")<{\n  readonly pluginId: string;\n  readonly remoteUrl: string;\n  readonly cause?: Error;\n}> {}\n\nexport class ValidationError extends Data.TaggedError(\"ValidationError\")<{\n  readonly pluginId: string;\n  readonly stage: \"config\" | \"input\" | \"output\" | \"state\";\n  readonly zodError: z.ZodError;\n}> {}\n\nconst extractErrorMessage = (error: unknown): string => {\n  if (!error) return \"Unknown error\";\n\n  if (error instanceof Error) {\n    if (error.message) return error.message;\n    if ((error as any).cause instanceof Error) {\n      return extractErrorMessage((error as any).cause);\n    }\n  }\n\n  if (error instanceof AggregateError && error.errors?.length) {\n    return error.errors.map((e) => extractErrorMessage(e)).join(\"; \");\n  }\n\n  if (typeof error === \"object\" && \"message\" in error) {\n    return String((error as any).message);\n  }\n\n  return String(error);\n};\n\nconst formatValidationIssue = (issue: any, index: number, maxDisplay: number): string => {\n  if (index >= maxDisplay) return \"\";\n\n  const path =\n    Array.isArray(issue.path) && issue.path.length > 0\n      ? issue.path.join(\".\")\n      : issue.path || \"root\";\n\n  const message = issue.message || \"Validation failed\";\n\n  return `│    ${index + 1}. ${path}: ${message}`;\n};\n\nconst formatDataPreview = (data: unknown, maxLength = 100): string => {\n  if (!data) return \"undefined\";\n\n  try {\n    const str = JSON.stringify(data);\n    if (str.length <= maxLength) return str;\n\n    if (typeof data === \"object\" && data !== null) {\n      if (Array.isArray(data)) {\n        return `Array(${data.length}) [...]`;\n      }\n      const keys = Object.keys(data);\n      return `{ ${keys.slice(0, 3).join(\", \")}${keys.length > 3 ? \", ...\" : \"\"} }`;\n    }\n\n    return `${str.slice(0, maxLength)}...`;\n  } catch {\n    return String(data).slice(0, maxLength);\n  }\n};\n\nconst formatORPCValidationError = (error: any): string[] | null => {\n  const cause = error?.cause || error;\n\n  if (!cause?.issues || !Array.isArray(cause.issues) || cause.issues.length === 0) {\n    return null;\n  }\n\n  const lines: string[] = [];\n  const errorType = error?.message || cause?.message || \"Validation failed\";\n\n  lines.push(`\\n╭─ oRPC Validation Error ${\"─\".repeat(30)}`);\n  lines.push(`│  ${errorType}`);\n  lines.push(`│`);\n\n  const maxDisplay = 10;\n  const totalIssues = cause.issues.length;\n\n  lines.push(`│  Issues (${totalIssues}):`);\n\n  const displayedIssues = cause.issues.slice(0, maxDisplay);\n  displayedIssues.forEach((issue: any, idx: number) => {\n    const formatted = formatValidationIssue(issue, idx, maxDisplay);\n    if (formatted) lines.push(formatted);\n  });\n\n  if (totalIssues > maxDisplay) {\n    lines.push(`│    ... and ${totalIssues - maxDisplay} more`);\n  }\n\n  if (cause.data !== undefined) {\n    lines.push(`│`);\n    lines.push(`│  Data preview: ${formatDataPreview(cause.data, 80)}`);\n  }\n\n  lines.push(`╰${\"─\".repeat(50)}\\n`);\n\n  return lines;\n};\n\nexport const formatORPCError = (error: any): string | null => {\n  if (!(error instanceof ORPCError)) {\n    return null;\n  }\n\n  const validationLines = formatORPCValidationError(error);\n  if (validationLines) {\n    return validationLines.join(\"\\n\");\n  }\n\n  const lines: string[] = [];\n  const code = error.code || \"UNKNOWN\";\n  const status = error.status || 500;\n  const message = error.message || \"An error occurred\";\n\n  lines.push(`\\n╭─ oRPC Error ${\"─\".repeat(40)}`);\n  const messageLines = message.split(\"\\n\");\n  for (const line of messageLines) {\n    lines.push(`│  ${line}`);\n  }\n  lines.push(`│  Code: ${code} (${status})`);\n  lines.push(`│`);\n\n  if (error.data) {\n    const dataType = typeof error.data;\n    if (dataType === \"object\" && error.data !== null) {\n      if (\"retryAfter\" in error.data) {\n        lines.push(`│  Retry after: ${error.data.retryAfter} seconds`);\n      }\n      if (\"remainingRequests\" in error.data) {\n        lines.push(`│  Remaining: ${error.data.remainingRequests} requests`);\n      }\n      if (\"host\" in error.data) {\n        lines.push(`│  Host: ${error.data.host}`);\n      }\n      if (\"port\" in error.data) {\n        lines.push(`│  Port: ${error.data.port}`);\n      }\n      if (\"suggestion\" in error.data) {\n        lines.push(`│  → ${error.data.suggestion}`);\n      }\n      if (\"resource\" in error.data) {\n        lines.push(`│  Resource: ${error.data.resource}`);\n      }\n      if (\"resourceId\" in error.data) {\n        lines.push(`│  ID: ${error.data.resourceId}`);\n      }\n    }\n  }\n\n  switch (code) {\n    case \"UNAUTHORIZED\":\n      lines.push(`│  → Check your API key or credentials`);\n      break;\n    case \"TOO_MANY_REQUESTS\":\n      lines.push(`│  → Wait before retrying`);\n      break;\n    case \"SERVICE_UNAVAILABLE\":\n    case \"BAD_GATEWAY\":\n    case \"GATEWAY_TIMEOUT\":\n      lines.push(`│  → The service may be temporarily unavailable`);\n      break;\n    case \"TIMEOUT\":\n      lines.push(`│  → The operation took too long`);\n      break;\n  }\n\n  lines.push(`╰${\"─\".repeat(50)}\\n`);\n  return lines.join(\"\\n\");\n};\n\nconst isRetryableError = (message: string): boolean => {\n  const retryablePatterns = [\"ETIMEDOUT\", \"ECONNRESET\", \"timeout\", \"503\", \"429\"];\n  return retryablePatterns.some((p) => message.toLowerCase().includes(p.toLowerCase()));\n};\n\n// Helper to determine if an oRPC error code is retryable\nexport const isRetryableORPCCode = (code: string): boolean => {\n  switch (code) {\n    case \"TOO_MANY_REQUESTS\":\n    case \"SERVICE_UNAVAILABLE\":\n    case \"BAD_GATEWAY\":\n    case \"GATEWAY_TIMEOUT\":\n    case \"TIMEOUT\":\n      return true;\n    default:\n      return false;\n  }\n};\n\n// Convert ORPC errors from plugin procedures to PluginRuntimeError\nexport const wrapORPCError = (\n  orpcError: ORPCError<string, unknown>,\n  pluginId?: string,\n  procedureName?: string,\n  operation?: string,\n): PluginRuntimeError => {\n  return new PluginRuntimeError({\n    pluginId,\n    operation,\n    procedureName,\n    retryable: isRetryableORPCCode(orpcError.code),\n    cause: orpcError as Error,\n  });\n};\n\n/**\n * Extracts the underlying error from Effect's FiberFailure wrapper.\n * When Effect.runPromise rejects, errors are wrapped in FiberFailure.\n * This extracts the original error so oRPC can handle it properly.\n */\nexport const extractFromFiberFailure = (error: unknown): unknown => {\n  if (!error || typeof error !== \"object\") return error;\n\n  if (\"cause\" in error) {\n    const cause = (error as { cause?: unknown }).cause;\n\n    if (cause && typeof cause === \"object\" && \"_tag\" in cause) {\n      try {\n        const squashed = Cause.squash(cause as Cause.Cause<unknown>);\n        if (squashed instanceof ORPCError) {\n          return squashed;\n        }\n        return squashed;\n      } catch {\n        // Not a valid Cause\n      }\n    }\n\n    if (cause instanceof ORPCError) {\n      return cause;\n    }\n  }\n\n  return error;\n};\n\n// Universal error converter for the runtime\nexport const toPluginRuntimeError = (\n  error: unknown,\n  pluginId?: string,\n  procedureName?: string,\n  operation?: string,\n  defaultRetryable = false,\n): PluginRuntimeError => {\n  if (error instanceof ORPCError) {\n    return wrapORPCError(error, pluginId, procedureName, operation);\n  }\n\n  if (error instanceof PluginRuntimeError) {\n    return error;\n  }\n\n  return new PluginRuntimeError({\n    pluginId,\n    operation,\n    procedureName,\n    retryable: defaultRetryable || isRetryableError(extractErrorMessage(error)),\n    cause: error instanceof Error ? error : new Error(extractErrorMessage(error)),\n  });\n};\n"],"mappings":"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"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/runtime/errors.ts"],"sourcesContent":["import { ORPCError } from \"@orpc/server\";\nimport { Cause, Data } from \"effect\";\nimport type { z } from \"zod\";\n\nexport class PluginRuntimeError extends Data.TaggedError(\"PluginRuntimeError\")<{\n  readonly pluginId?: string;\n  readonly operation?: string;\n  readonly procedureName?: string;\n  readonly cause?: Error;\n}> {\n  override get message() {\n    return this.cause?.message ?? \"Plugin operation failed\";\n  }\n}\n\nexport class ModuleFederationError extends Data.TaggedError(\"ModuleFederationError\")<{\n  readonly pluginId: string;\n  readonly remoteUrl: string;\n  readonly cause?: Error;\n}> {}\n\nexport class ValidationError extends Data.TaggedError(\"ValidationError\")<{\n  readonly pluginId: string;\n  readonly stage: \"config\" | \"input\" | \"output\" | \"state\";\n  readonly zodError: z.ZodError;\n}> {}\n\nconst stringifyUnknown = (value: unknown): string => {\n  if (value === null) return \"null\";\n  if (value === undefined) return \"undefined\";\n  if (value instanceof Error) return value.message;\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"bigint\" || typeof value === \"boolean\") {\n    return `${value}`;\n  }\n  if (typeof value === \"symbol\") return value.description ?? \"\";\n  try {\n    return JSON.stringify(value) ?? \"[Unserializable value]\";\n  } catch {\n    return \"[Unserializable value]\";\n  }\n};\n\nconst extractErrorMessage = (error: unknown): string => {\n  if (!error) return \"Unknown error\";\n\n  if (error instanceof Error) {\n    if (error.message) return error.message;\n    if ((error as any).cause instanceof Error) {\n      return extractErrorMessage((error as any).cause);\n    }\n  }\n\n  if (error instanceof AggregateError && error.errors?.length) {\n    return error.errors.map((e) => extractErrorMessage(e)).join(\"; \");\n  }\n\n  if (typeof error === \"object\" && \"message\" in error) {\n    return String((error as any).message);\n  }\n\n  return stringifyUnknown(error);\n};\n\n/**\n * The deepest Error along the cause chain — the original throw site. Wrapper\n * errors (PluginRuntimeError, ModuleFederationError) carry their own stacks\n * (the wrapping frames); diagnosis needs the cause's stack (the actual\n * failing module inside the evaluated remote entry).\n */\nexport const deepestErrorStack = (error: unknown): string | undefined => {\n  let current = error;\n  let deepest: string | undefined;\n  let hops = 0;\n  while (current instanceof Error && hops < 8) {\n    if (current.stack) deepest = current.stack;\n    current = (current as { cause?: unknown }).cause as unknown;\n    hops += 1;\n  }\n  if (current instanceof Error && current.stack) deepest = current.stack;\n  return deepest;\n};\n\nconst formatValidationIssue = (issue: any, index: number, maxDisplay: number): string => {\n  if (index >= maxDisplay) return \"\";\n\n  const path =\n    Array.isArray(issue.path) && issue.path.length > 0\n      ? issue.path.join(\".\")\n      : issue.path || \"root\";\n\n  const message = issue.message || \"Validation failed\";\n\n  return `│    ${index + 1}. ${path}: ${message}`;\n};\n\nconst formatDataPreview = (data: unknown, maxLength = 100): string => {\n  if (!data) return \"undefined\";\n\n  try {\n    const str = JSON.stringify(data);\n    if (str.length <= maxLength) return str;\n\n    if (typeof data === \"object\" && data !== null) {\n      if (Array.isArray(data)) {\n        return `Array(${data.length}) [...]`;\n      }\n      const keys = Object.keys(data);\n      return `{ ${keys.slice(0, 3).join(\", \")}${keys.length > 3 ? \", ...\" : \"\"} }`;\n    }\n\n    return `${str.slice(0, maxLength)}...`;\n  } catch {\n    return stringifyUnknown(data).slice(0, maxLength);\n  }\n};\n\nconst formatORPCValidationError = (error: any): string[] | null => {\n  const cause = error?.cause || error;\n\n  if (!cause?.issues || !Array.isArray(cause.issues) || cause.issues.length === 0) {\n    return null;\n  }\n\n  const lines: string[] = [];\n  const errorType = error?.message || cause?.message || \"Validation failed\";\n\n  lines.push(`\\n╭─ oRPC Validation Error ${\"─\".repeat(30)}`);\n  lines.push(`│  ${errorType}`);\n  lines.push(`│`);\n\n  const maxDisplay = 10;\n  const totalIssues = cause.issues.length;\n\n  lines.push(`│  Issues (${totalIssues}):`);\n\n  const displayedIssues = cause.issues.slice(0, maxDisplay);\n  displayedIssues.forEach((issue: any, idx: number) => {\n    const formatted = formatValidationIssue(issue, idx, maxDisplay);\n    if (formatted) lines.push(formatted);\n  });\n\n  if (totalIssues > maxDisplay) {\n    lines.push(`│    ... and ${totalIssues - maxDisplay} more`);\n  }\n\n  if (cause.data !== undefined) {\n    lines.push(`│`);\n    lines.push(`│  Data preview: ${formatDataPreview(cause.data, 80)}`);\n  }\n\n  lines.push(`╰${\"─\".repeat(50)}\\n`);\n\n  return lines;\n};\n\nconst formatUnknownError = (error: any): string | null => {\n  if (!error) return null;\n  const message = extractErrorMessage(error);\n  const lines: string[] = [];\n  lines.push(`\\n╭─ Unhandled error ${\"─\".repeat(37)}`);\n  for (const line of message.split(\"\\n\")) {\n    lines.push(`│  ${line}`);\n  }\n  const stack = error instanceof Error ? error.stack?.split(\"\\n\").slice(1, 6) : undefined;\n  if (stack && stack.length > 0) {\n    lines.push(`│`);\n    for (const line of stack) {\n      lines.push(`│  ${line.trim()}`);\n    }\n  }\n  lines.push(`╰${\"─\".repeat(50)}\\n`);\n  return lines.join(\"\\n\");\n};\n\nexport const formatORPCError = (error: any): string | null => {\n  if (!(error instanceof ORPCError)) {\n    // Unknown errors used to return null, leaving internal failures (e.g. a\n    // storage backend throw) invisible in host logs while oRPC serialized\n    // them client-side as a bare INTERNAL_SERVER_ERROR.\n    return formatUnknownError(error);\n  }\n\n  const validationLines = formatORPCValidationError(error);\n  if (validationLines) {\n    return validationLines.join(\"\\n\");\n  }\n\n  const lines: string[] = [];\n  const code = error.code || \"UNKNOWN\";\n  const message = error.message || \"An error occurred\";\n\n  lines.push(`\\n╭─ oRPC Error ${\"─\".repeat(40)}`);\n  const messageLines = message.split(\"\\n\");\n  for (const line of messageLines) {\n    lines.push(`│  ${line}`);\n  }\n  lines.push(`│  Code: ${code}`);\n  lines.push(`│`);\n\n  if (error.data) {\n    const dataType = typeof error.data;\n    if (dataType === \"object\" && error.data !== null) {\n      if (\"retryAfter\" in error.data) {\n        lines.push(`│  Retry after: ${error.data.retryAfter} seconds`);\n      }\n      if (\"remainingRequests\" in error.data) {\n        lines.push(`│  Remaining: ${error.data.remainingRequests} requests`);\n      }\n      if (\"host\" in error.data) {\n        lines.push(`│  Host: ${error.data.host}`);\n      }\n      if (\"port\" in error.data) {\n        lines.push(`│  Port: ${error.data.port}`);\n      }\n      if (\"suggestion\" in error.data) {\n        lines.push(`│  → ${error.data.suggestion}`);\n      }\n      if (\"resource\" in error.data) {\n        lines.push(`│  Resource: ${error.data.resource}`);\n      }\n      if (\"resourceId\" in error.data) {\n        lines.push(`│  ID: ${error.data.resourceId}`);\n      }\n    }\n  }\n\n  switch (code) {\n    case \"UNAUTHORIZED\":\n      lines.push(`│  → Check your API key or credentials`);\n      break;\n    case \"TOO_MANY_REQUESTS\":\n      lines.push(`│  → Wait before retrying`);\n      break;\n    case \"SERVICE_UNAVAILABLE\":\n    case \"BAD_GATEWAY\":\n    case \"GATEWAY_TIMEOUT\":\n      lines.push(`│  → The service may be temporarily unavailable`);\n      break;\n    case \"TIMEOUT\":\n      lines.push(`│  → The operation took too long`);\n      break;\n  }\n\n  lines.push(`╰${\"─\".repeat(50)}\\n`);\n  return lines.join(\"\\n\");\n};\n\nexport type PluginFailureKind =\n  | \"mf\"\n  | \"integrity\"\n  | \"config\"\n  | \"validation\"\n  | \"network\"\n  | \"unknown\";\n\nexport interface PluginFailureClassification {\n  kind: PluginFailureKind;\n  retryable: boolean;\n  message: string;\n  suggestion?: string;\n}\n\n/**\n * Structured report of one plugin-load failure, built by a loader (the host's\n * plugin boot, the dev server) from a `PluginFailureClassification` plus\n * loader context. This is the shape health endpoints and dashboards consume —\n * keep it serializable.\n */\nexport interface PluginLoadFailureInfo {\n  /** loader-side key (host entry key, dev plugin id) */\n  pluginKey: string;\n  pluginUrl?: string;\n  /** failing runtime stage when the cause is stage-attributed */\n  operation?: string;\n  kind: string;\n  retryable: boolean;\n  message: string;\n  suggestion?: string;\n  /** loader context: which env secret the plugin's DB binding expects */\n  dbSecret?: string;\n  dbUrlMasked?: string;\n}\n\nconst NETWORK_RETRYABLE_PATTERNS = [\"ETIMEDOUT\", \"ECONNRESET\", \"timeout\", \"503\", \"429\"] as const;\nconst NETWORK_DEAD_PATTERNS = [\"ECONNREFUSED\", \"ENOTFOUND\", \"EHOSTUNREACH\"] as const;\nconst RETRYABLE_ORPC_CODES = new Set([\n  \"TOO_MANY_REQUESTS\",\n  \"SERVICE_UNAVAILABLE\",\n  \"BAD_GATEWAY\",\n  \"GATEWAY_TIMEOUT\",\n  \"TIMEOUT\",\n]);\n\n/**\n * One classification for plugin lifecycle failures across MF / validation /\n * network sources. This is the recovery policy — nothing in the runtime\n * retries on it today by design (the host degrades and runs without a failed\n * plugin); consumers (host bootstrap messages, the dev server retry loop)\n * read kind / retryable / suggestion to decide what to tell the author.\n */\nexport const classifyPluginFailure = (error: unknown): PluginFailureClassification => {\n  let current: unknown = extractFromFiberFailure(error);\n  let hops = 0;\n  while (current && typeof current === \"object\" && hops < 8) {\n    if (current instanceof ModuleFederationError) {\n      return {\n        kind: \"mf\",\n        retryable: false,\n        message: extractErrorMessage(current),\n        suggestion:\n          \"Run bos mf check — the deployed plugin bundle is likely stale (sharedDep / pluginVersion skew), then redeploy the plugin and bos publish --deploy --packages local\",\n      };\n    }\n    if (current instanceof ValidationError) {\n      return {\n        kind: \"validation\",\n        retryable: false,\n        message: `${current.stage}: ${extractErrorMessage(current.zodError)}`,\n        suggestion: `Fix the plugin's ${current.stage} schema at plugins/${current.pluginId}`,\n      };\n    }\n    if (current instanceof ORPCError) {\n      const retryableByCode = RETRYABLE_ORPC_CODES.has(current.code);\n      return {\n        kind: \"network\",\n        retryable: retryableByCode,\n        message: current.message,\n        suggestion: retryableByCode\n          ? \"The plugin procedure failed transiently — retry the call\"\n          : undefined,\n      };\n    }\n    current = (current as { cause?: unknown }).cause;\n    hops += 1;\n  }\n\n  const message = extractErrorMessage(error);\n  const lower = message.toLowerCase();\n\n  if (NETWORK_RETRYABLE_PATTERNS.some((p) => lower.includes(p.toLowerCase()))) {\n    return {\n      kind: \"network\",\n      retryable: true,\n      message,\n      suggestion: \"The remote may be temporarily unavailable — retry after redeploying the plugin\",\n    };\n  }\n  if (NETWORK_DEAD_PATTERNS.some((p) => lower.includes(p.toLowerCase()))) {\n    return {\n      kind: \"network\",\n      retryable: false,\n      message,\n      suggestion:\n        \"The plugin host is unreachable — check plugins.<id> entry URLs in bos.config.json\",\n    };\n  }\n  if (lower.includes(\"integrity\") || lower.includes(\"sri\")) {\n    return {\n      kind: \"integrity\",\n      retryable: true,\n      message,\n      suggestion:\n        \"The deployed bundle content does not match its recorded integrity — redeploy the plugin so bos.config.json is republished with a fresh hash\",\n    };\n  }\n\n  return { kind: \"unknown\", retryable: false, message };\n};\n\n// Convert ORPC errors from plugin procedures to PluginRuntimeError\nexport const wrapORPCError = (\n  orpcError: ORPCError<string, unknown>,\n  pluginId?: string,\n  procedureName?: string,\n  operation?: string,\n): PluginRuntimeError => {\n  return new PluginRuntimeError({\n    pluginId,\n    operation,\n    procedureName,\n    cause: orpcError as Error,\n  });\n};\n\n/**\n * Extracts the underlying error from Effect's FiberFailure wrapper.\n * When Effect.runPromise rejects, errors are wrapped in FiberFailure.\n * This extracts the original error so oRPC can handle it properly.\n */\nexport const extractFromFiberFailure = (error: unknown): unknown => {\n  if (!error || typeof error !== \"object\") return error;\n\n  if (\"cause\" in error) {\n    const cause = (error as { cause?: unknown }).cause;\n\n    if (cause && typeof cause === \"object\" && \"_tag\" in cause) {\n      try {\n        const squashed = Cause.squash(cause as unknown as Cause.Cause<unknown>);\n        if (squashed instanceof ORPCError) {\n          return squashed;\n        }\n        return squashed;\n      } catch {\n        // Not a valid Cause\n      }\n    }\n\n    if (cause instanceof ORPCError) {\n      return cause;\n    }\n  }\n\n  return error;\n};\n\n// Universal error converter for the runtime\nexport const toPluginRuntimeError = (\n  error: unknown,\n  pluginId?: string,\n  procedureName?: string,\n  operation?: string,\n): PluginRuntimeError => {\n  if (error instanceof ORPCError) {\n    return wrapORPCError(error, pluginId, procedureName, operation);\n  }\n\n  if (error instanceof PluginRuntimeError) {\n    return error;\n  }\n\n  return new PluginRuntimeError({\n    pluginId,\n    operation,\n    procedureName,\n    cause: error instanceof Error ? error : new Error(extractErrorMessage(error)),\n  });\n};\n"],"mappings":"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"}

package/dist/runtime/index.cjs

@@ -1,35 +1,85 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_errors = require('./errors.cjs');
+const require_build_artifact_names = require('../build/artifact-names.cjs');
 const require_plugin_service = require('./services/plugin.service.cjs');
+require("@orpc/openapi/extensions/route");
 let effect = require("effect");
 let _orpc_server = require("@orpc/server");
+require("@orpc/experimental-effect/extensions/effect");
 
 //#region src/runtime/index.ts
+const MAX_CACHE_KEY_DEPTH = 32;
 var PluginRuntime = class {
 	runtime;
 	registry;
 	__registryType;
 	pluginCache = /* @__PURE__ */ new Map();
+	routerCache = /* @__PURE__ */ new Map();
+	cacheLeafIds = /* @__PURE__ */ new WeakMap();
+	nextCacheLeafId = 0;
 	constructor(runtime, registry) {
 		this.runtime = runtime;
 		this.registry = registry;
 	}
+	/**
+	* Cache key for plugin instances: JSON-equal configs share one plugin
+	* instance (variables and secrets originate from bos.config.json, so they
+	* are JSON values). Values outside the JSON domain follow Effect's Hash
+	* semantics — symbols key by description, functions and class instances by
+	* reference identity — and the host creates its pluginsClient map once per
+	* boot, making identity the correct equivalence for function-bearing
+	* configs.
+	*/
 	generateCacheKey(pluginId, config) {
-		return `${pluginId}:${effect.Hash.structure(config).toString()}`;
+		return `${pluginId}:${this.canonicalizeConfig(config, 0, /* @__PURE__ */ new Set())}`;
+	}
+	canonicalizeConfig(value, depth, ancestors) {
+		switch (typeof value) {
+			case "undefined": return "undefined";
+			case "string": return `string:${JSON.stringify(value)}`;
+			case "number": return `number:${Object.is(value, -0) ? "-0" : String(value)}`;
+			case "bigint": return `bigint:${value.toString()}`;
+			case "boolean": return `boolean:${value}`;
+			case "symbol": return `symbol:${String(value)}`;
+			case "function": return `ref:${this.getCacheLeafId(value)}`;
+			case "object": {
+				if (value === null) return "null";
+				if (ancestors.has(value) || depth >= MAX_CACHE_KEY_DEPTH) return `ref:${this.getCacheLeafId(value)}`;
+				if (Array.isArray(value)) {
+					ancestors.add(value);
+					const serialized = `[${value.map((item) => this.canonicalizeConfig(item, depth + 1, ancestors)).join(",")}]`;
+					ancestors.delete(value);
+					return serialized;
+				}
+				const prototype = Object.getPrototypeOf(value);
+				if (prototype !== Object.prototype && prototype !== null) return `ref:${this.getCacheLeafId(value)}`;
+				const record = value;
+				ancestors.add(value);
+				const serialized = `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${this.canonicalizeConfig(record[key], depth + 1, ancestors)}`).join(",")}}`;
+				ancestors.delete(value);
+				return serialized;
+			}
+		}
+	}
+	getCacheLeafId(value) {
+		const existing = this.cacheLeafIds.get(value);
+		if (existing !== void 0) return existing;
+		const id = this.nextCacheLeafId++;
+		this.cacheLeafIds.set(value, id);
+		return id;
 	}
 	validatePluginId(pluginId) {
 		if (!(pluginId in this.registry)) return effect.Effect.fail(new require_errors.PluginRuntimeError({
 			pluginId: String(pluginId),
 			operation: "validate-plugin-id",
-			cause: /* @__PURE__ */ new Error(`Plugin ID '${String(pluginId)}' not found in registry.`),
-			retryable: false
+			cause: /* @__PURE__ */ new Error(`Plugin ID '${String(pluginId)}' not found in registry.`)
 		}));
 		return effect.Effect.succeed(String(pluginId));
 	}
 	async runPromise(effect$1) {
 		const exit = await this.runtime.runPromiseExit(effect$1);
 		if (effect.Exit.isFailure(exit)) {
-			const error = effect.Cause.failureOption(exit.cause);
+			const error = effect.Cause.findErrorOption(exit.cause);
 			if (effect.Option.isSome(error)) throw error.value;
 			throw effect.Cause.squash(exit.cause);
 		}
@@ -42,7 +92,7 @@ var PluginRuntime = class {
 		});
 		let cachedPlugin = this.pluginCache.get(cacheKey);
 		if (!cachedPlugin) {
-			const operation = effect.Effect.gen(this, function* () {
+			const operation = effect.Effect.gen({ self: this }, function* () {
 				const pluginService = yield* require_plugin_service.PluginService;
 				const validatedId = yield* this.validatePluginId(pluginId);
 				const ctor = yield* pluginService.loadPlugin(validatedId);
@@ -50,19 +100,32 @@ var PluginRuntime = class {
 				const initialized = yield* pluginService.initializePlugin(instance, config, plugins);
 				yield* pluginService.registerPlugin(initialized);
 				return initialized;
-			}).pipe(effect.Effect.annotateLogs({ plugin: pluginId }), effect.Effect.provide(this.runtime));
-			cachedPlugin = effect.Effect.cached(operation).pipe(effect.Effect.flatten);
+			});
+			cachedPlugin = this.runPromise(operation);
 			this.pluginCache.set(cacheKey, cachedPlugin);
 		}
 		let initialized;
 		try {
-			initialized = await this.runPromise(cachedPlugin);
+			initialized = await cachedPlugin;
 		} catch (error) {
-			this.pluginCache.delete(cacheKey);
+			if (this.pluginCache.get(cacheKey) === cachedPlugin) {
+				this.pluginCache.delete(cacheKey);
+				this.routerCache.delete(cacheKey);
+			}
 			throw error;
 		}
-		const router = initialized.plugin.createRouter(initialized.context);
-		const createClient = (context) => (0, _orpc_server.createRouterClient)(router, { context: context ?? {} });
+		let router = this.routerCache.get(cacheKey);
+		if (!router) try {
+			router = initialized.plugin.createRouter(plugins ?? {});
+			this.routerCache.set(cacheKey, router);
+		} catch (error) {
+			await this.evictPlugin(pluginId, config, plugins);
+			throw error;
+		}
+		const createClient = (context) => (0, _orpc_server.createRouterClient)(router, { context: {
+			...context,
+			"effect/context": initialized.effectContext
+		} });
 		return {
 			createClient,
 			router,
@@ -73,13 +136,13 @@ var PluginRuntime = class {
 	async loadPlugin(pluginId) {
 		const effect$2 = effect.Effect.gen(function* () {
 			return yield* (yield* require_plugin_service.PluginService).loadPlugin(pluginId);
-		}).pipe(effect.Effect.annotateLogs({ plugin: pluginId }));
+		});
 		return this.runPromise(effect$2);
 	}
 	async instantiatePlugin(pluginId, loadedPlugin) {
 		const effect$3 = effect.Effect.gen(function* () {
 			return yield* (yield* require_plugin_service.PluginService).instantiatePlugin(pluginId, loadedPlugin);
-		}).pipe(effect.Effect.annotateLogs({ plugin: pluginId }));
+		});
 		return this.runPromise(effect$3);
 	}
 	async initializePlugin(instance, config, plugins) {
@@ -88,30 +151,39 @@ var PluginRuntime = class {
 			const initialized = yield* pluginService.initializePlugin(instance, config, plugins);
 			yield* pluginService.registerPlugin(initialized);
 			return initialized;
-		}).pipe(effect.Effect.annotateLogs({ plugin: instance.plugin.id }));
+		});
 		return this.runPromise(effect$4);
 	}
 	async shutdown() {
 		const effect$5 = effect.Effect.gen(function* () {
-			yield* (yield* require_plugin_service.PluginService).cleanup();
+			yield* (yield* require_plugin_service.PluginService).cleanup;
 		});
-		await this.runPromise(effect$5);
-		await this.runtime.dispose();
+		try {
+			await this.runPromise(effect$5);
+		} finally {
+			this.pluginCache.clear();
+			this.routerCache.clear();
+			await this.runtime.dispose();
+		}
 	}
 	async evictPlugin(pluginId, config, plugins) {
 		const cacheKey = this.generateCacheKey(pluginId, {
 			...config,
 			__plugins: plugins ?? {}
 		});
-		const effect$6 = effect.Effect.gen(this, function* () {
+		const effect$6 = effect.Effect.gen({ self: this }, function* () {
 			const pluginService = yield* require_plugin_service.PluginService;
 			const cachedPlugin = this.pluginCache.get(cacheKey);
 			if (cachedPlugin) {
 				this.pluginCache.delete(cacheKey);
-				const pluginResult = yield* cachedPlugin.pipe(effect.Effect.catchAll(() => effect.Effect.succeed(null)));
-				if (pluginResult) yield* pluginService.shutdownPlugin(pluginResult).pipe(effect.Effect.catchAll((error) => effect.Effect.logWarning(`Failed to shutdown evicted plugin ${pluginId}`, error)));
+				this.routerCache.delete(cacheKey);
+				const pluginResult = yield* effect.Effect.tryPromise({
+					try: () => cachedPlugin,
+					catch: (error) => require_errors.toPluginRuntimeError(error, pluginId, void 0, "evict-plugin")
+				}).pipe(effect.Effect.orElseSucceed(() => null));
+				if (pluginResult) yield* pluginService.shutdownPlugin(pluginResult);
 			}
-		}).pipe(effect.Effect.catchAll((error) => effect.Effect.logWarning(`Plugin eviction failed for ${pluginId}`, error)));
+		});
 		return this.runPromise(effect$6);
 	}
 };
@@ -122,7 +194,7 @@ var PluginRuntime = class {
 function normalizeRemoteUrl(url) {
 	if (!url) return url;
 	if (url.endsWith(".js") || url.endsWith(".json")) return url;
-	return `${url.endsWith("/") ? url.slice(0, -1) : url}/remoteEntry.js`;
+	return `${url.endsWith("/") ? url.slice(0, -1) : url}/${require_build_artifact_names.DEV_ENTRY_FILENAME}`;
 }
 /**
 * Extract plugin map (module constructors) from registry entries
@@ -169,7 +241,7 @@ function createPluginRuntime(config) {
 	const secrets = config.secrets || {};
 	const normalizedRegistry = normalizeRegistry(config.registry);
 	const pluginMap = extractPluginMap(config.registry);
-	const layer = require_plugin_service.PluginService.Live(normalizedRegistry, secrets, pluginMap);
+	const layer = require_plugin_service.PluginServiceLive(normalizedRegistry, secrets, pluginMap);
 	const runtime = effect.ManagedRuntime.make(layer);
 	return new PluginRuntime(runtime, normalizedRegistry);
 }

package/dist/runtime/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["Hash","Effect","PluginRuntimeError","effect","Exit","Cause","Option","PluginService","ManagedRuntime"],"sources":["../../src/runtime/index.ts"],"sourcesContent":["import { createRouterClient } from \"@orpc/server\";\nimport { Cause, Effect, Exit, Hash, ManagedRuntime, Option } from \"effect\";\nimport type {\n  AnyPlugin,\n  AnyPluginConstructor,\n  InferRegistryFromEntries,\n  InitializedPlugin,\n  LoadedPlugin,\n  PluginConfigInput,\n  PluginInstance,\n  PluginRegistry,\n  PluginRegistryEntry,\n  PluginRouterType,\n  PluginRuntimeConfig,\n  RegisteredPlugin,\n  RegisteredPlugins,\n  UsePluginResult,\n} from \"../types\";\nimport { PluginRuntimeError } from \"./errors\";\nimport { PluginService } from \"./services/plugin.service\";\n\nexport class PluginRuntime<R = RegisteredPlugins> {\n  readonly __registryType?: R;\n\n  private pluginCache = new Map<\n    string,\n    Effect.Effect<InitializedPlugin<AnyPlugin>, PluginRuntimeError>\n  >();\n\n  constructor(\n    private runtime: ManagedRuntime.ManagedRuntime<PluginService, never>,\n    private registry: PluginRegistry,\n  ) {}\n\n  private generateCacheKey(pluginId: string, config: unknown): string {\n    const configHash = Hash.structure(config as object).toString();\n    return `${pluginId}:${configHash}`;\n  }\n\n  private validatePluginId(pluginId: string): Effect.Effect<string, PluginRuntimeError> {\n    if (!(pluginId in this.registry)) {\n      return Effect.fail(\n        new PluginRuntimeError({\n          pluginId: String(pluginId),\n          operation: \"validate-plugin-id\",\n          cause: new Error(`Plugin ID '${String(pluginId)}' not found in registry.`),\n          retryable: false,\n        }),\n      );\n    }\n    return Effect.succeed(String(pluginId));\n  }\n\n  private async runPromise<A, E>(effect: Effect.Effect<A, E, PluginService>): Promise<A> {\n    const exit = await this.runtime.runPromiseExit(effect);\n\n    if (Exit.isFailure(exit)) {\n      const error = Cause.failureOption(exit.cause);\n      if (Option.isSome(error)) {\n        throw error.value;\n      }\n      throw Cause.squash(exit.cause);\n    }\n\n    return exit.value;\n  }\n\n  async usePlugin<K extends keyof R & string>(\n    pluginId: K,\n    config: PluginConfigInput<R[K]>,\n    plugins?: Record<string, unknown>,\n  ): Promise<UsePluginResult<K, R>> {\n    const cacheKey = this.generateCacheKey(pluginId, { ...config, __plugins: plugins ?? {} });\n\n    let cachedPlugin = this.pluginCache.get(cacheKey);\n    if (!cachedPlugin) {\n      const operation = Effect.gen(this, function* () {\n        const pluginService = yield* PluginService;\n        const validatedId = yield* this.validatePluginId(pluginId);\n\n        // Load → Instantiate → Initialize → Register\n        const ctor = yield* pluginService.loadPlugin(validatedId);\n        const instance = yield* pluginService.instantiatePlugin(pluginId, ctor);\n        const initialized = yield* pluginService.initializePlugin(instance, config, plugins);\n        yield* pluginService.registerPlugin(initialized);\n\n        return initialized;\n      }).pipe(Effect.annotateLogs({ plugin: pluginId }), Effect.provide(this.runtime));\n\n      cachedPlugin = Effect.cached(operation).pipe(Effect.flatten);\n      this.pluginCache.set(cacheKey, cachedPlugin);\n    }\n\n    let initialized: InitializedPlugin<AnyPlugin>;\n    try {\n      initialized = await this.runPromise(cachedPlugin);\n    } catch (error) {\n      // Evict failed initializations so the next call retries instead\n      // of returning the permanently-cached failure from Effect.cached.\n      this.pluginCache.delete(cacheKey);\n      throw error;\n    }\n\n    // Construct the router once per plugin instance, not per client/request.\n    const router = initialized.plugin.createRouter(initialized.context) as PluginRouterType<R[K]>;\n\n    // Create client factory that accepts request context\n    const createClient = (context?: any) => createRouterClient(router, { context: context ?? {} });\n\n    return {\n      createClient: createClient as any,\n      router,\n      metadata: initialized.metadata,\n      initialized: initialized as InitializedPlugin<RegisteredPlugin<K, R>>,\n    } as UsePluginResult<K, R>;\n  }\n\n  async loadPlugin<K extends keyof R & string>(\n    pluginId: K,\n  ): Promise<LoadedPlugin<RegisteredPlugin<K, R>>> {\n    const effect = Effect.gen(function* () {\n      const pluginService = yield* PluginService;\n      return yield* pluginService.loadPlugin(pluginId);\n    }).pipe(Effect.annotateLogs({ plugin: pluginId }));\n    return this.runPromise(effect) as Promise<LoadedPlugin<RegisteredPlugin<K, R>>>;\n  }\n\n  async instantiatePlugin<K extends keyof R & string>(\n    pluginId: K,\n    loadedPlugin: LoadedPlugin<RegisteredPlugin<K, R>>,\n  ): Promise<PluginInstance<RegisteredPlugin<K, R>>> {\n    const effect = Effect.gen(function* () {\n      const pluginService = yield* PluginService;\n      return yield* pluginService.instantiatePlugin(pluginId, loadedPlugin);\n    }).pipe(Effect.annotateLogs({ plugin: pluginId }));\n    return this.runPromise(effect) as Promise<PluginInstance<RegisteredPlugin<K, R>>>;\n  }\n\n  async initializePlugin<T extends AnyPlugin>(\n    instance: PluginInstance<T>,\n    config: any,\n    plugins?: Record<string, unknown>,\n  ): Promise<InitializedPlugin<T>> {\n    const effect = Effect.gen(function* () {\n      const pluginService = yield* PluginService;\n      const initialized = yield* pluginService.initializePlugin(instance, config, plugins);\n      yield* pluginService.registerPlugin(initialized);\n      return initialized;\n    }).pipe(Effect.annotateLogs({ plugin: instance.plugin.id }));\n    return this.runPromise(effect);\n  }\n\n  async shutdown(): Promise<void> {\n    const effect = Effect.gen(function* () {\n      const pluginService = yield* PluginService;\n      yield* pluginService.cleanup();\n    });\n    await this.runPromise(effect);\n    await this.runtime.dispose();\n  }\n\n  async evictPlugin<K extends keyof R & string>(\n    pluginId: K,\n    config: PluginConfigInput<R[K]>,\n    plugins?: Record<string, unknown>,\n  ): Promise<void> {\n    const cacheKey = this.generateCacheKey(pluginId, { ...config, __plugins: plugins ?? {} });\n\n    const effect = Effect.gen(this, function* () {\n      const pluginService = yield* PluginService;\n      const cachedPlugin = this.pluginCache.get(cacheKey);\n\n      if (cachedPlugin) {\n        this.pluginCache.delete(cacheKey);\n\n        const pluginResult = yield* cachedPlugin.pipe(Effect.catchAll(() => Effect.succeed(null)));\n\n        if (pluginResult) {\n          yield* pluginService\n            .shutdownPlugin(pluginResult)\n            .pipe(\n              Effect.catchAll((error) =>\n                Effect.logWarning(`Failed to shutdown evicted plugin ${pluginId}`, error),\n              ),\n            );\n        }\n      }\n    }).pipe(\n      Effect.catchAll((error) =>\n        Effect.logWarning(`Plugin eviction failed for ${pluginId}`, error),\n      ),\n    );\n\n    return this.runPromise(effect);\n  }\n}\n\n/**\n * Normalizes a remote URL to ensure it points to remoteEntry.js\n * If the URL doesn't end with a file extension, appends /remoteEntry.js\n */\nfunction normalizeRemoteUrl(url: string): string {\n  if (!url) return url;\n  if (url.endsWith(\".js\") || url.endsWith(\".json\")) return url;\n  return `${url.endsWith(\"/\") ? url.slice(0, -1) : url}/remoteEntry.js`;\n}\n\n/**\n * Extract plugin map (module constructors) from registry entries\n */\nfunction extractPluginMap(\n  registry: Record<string, PluginRegistryEntry>,\n): Record<string, AnyPluginConstructor> {\n  const pluginMap: Record<string, AnyPluginConstructor> = {};\n\n  for (const [pluginId, entry] of Object.entries(registry)) {\n    if (\"module\" in entry && entry.module) {\n      pluginMap[pluginId] = entry.module;\n    }\n  }\n\n  return pluginMap;\n}\n\n/**\n * Normalize registry entries - ensure remote URLs are properly formatted\n */\nfunction normalizeRegistry(registry: Record<string, PluginRegistryEntry>): PluginRegistry {\n  const normalized: Record<string, PluginRegistryEntry> = {};\n\n  for (const [pluginId, entry] of Object.entries(registry)) {\n    if (\"module\" in entry) {\n      normalized[pluginId] = {\n        ...entry,\n        remote: entry.remote ? normalizeRemoteUrl(entry.remote) : undefined,\n      };\n    } else {\n      normalized[pluginId] = {\n        ...entry,\n        remote: normalizeRemoteUrl(entry.remote),\n      };\n    }\n  }\n\n  return normalized as PluginRegistry;\n}\n\n/**\n * Creates a plugin runtime with support for both module and remote plugin entries.\n *\n * @example\n * ```typescript\n * // With module entries (types inferred automatically)\n * const runtime = createPluginRuntime({\n *   registry: {\n *     telegram: { module: TelegramPlugin },\n *     gopher: { remote: \"https://cdn.example.com/gopher/remoteEntry.js\" }\n *   },\n *   secrets: { API_KEY: \"...\" }\n * });\n *\n * // Types are automatically inferred from module entries!\n * const { router } = await runtime.usePlugin(\"telegram\", config);\n * ```\n */\nexport function createPluginRuntime<TRegistry extends Record<string, PluginRegistryEntry>>(\n  config: PluginRuntimeConfig<TRegistry>,\n): PluginRuntime<InferRegistryFromEntries<TRegistry>> {\n  const secrets = config.secrets || {};\n  const normalizedRegistry = normalizeRegistry(config.registry);\n  const pluginMap = extractPluginMap(config.registry);\n\n  const layer = PluginService.Live(normalizedRegistry, secrets, pluginMap);\n  const runtime = ManagedRuntime.make(layer);\n\n  return new PluginRuntime(runtime, normalizedRegistry) as PluginRuntime<\n    InferRegistryFromEntries<TRegistry>\n  >;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["Effect","PluginRuntimeError","effect","Exit","Cause","Option","PluginService","createRouterClient","toPluginRuntimeError","DEV_ENTRY_FILENAME","PluginServiceLive","ManagedRuntime"],"sources":["../../src/runtime/index.ts"],"sourcesContent":["import \"@orpc/experimental-effect/extensions/effect\";\nimport \"@orpc/openapi/extensions/route\";\n\nimport { createRouterClient } from \"@orpc/server\";\nimport { Cause, Effect, Exit, ManagedRuntime, Option } from \"effect\";\nimport { DEV_ENTRY_FILENAME } from \"../build/artifact-names\";\nimport type {\n  AnyPlugin,\n  AnyPluginConstructor,\n  InferRegistryFromEntries,\n  InitializedPlugin,\n  LoadedPlugin,\n  PluginConfigInput,\n  PluginInstance,\n  PluginRegistry,\n  PluginRegistryEntry,\n  PluginRouterType,\n  PluginRuntimeConfig,\n  RegisteredPlugin,\n  RegisteredPlugins,\n  UsePluginResult,\n} from \"../types\";\nimport { PluginRuntimeError, toPluginRuntimeError } from \"./errors\";\nimport { PluginService, PluginServiceLive } from \"./services/plugin.service\";\n\nconst MAX_CACHE_KEY_DEPTH = 32;\n\nexport class PluginRuntime<R = RegisteredPlugins> {\n  readonly __registryType?: R;\n\n  private pluginCache = new Map<string, Promise<InitializedPlugin<AnyPlugin>>>();\n  private routerCache = new Map<string, PluginRouterType<any>>();\n  private cacheLeafIds = new WeakMap<object, number>();\n  private nextCacheLeafId = 0;\n\n  constructor(\n    private runtime: ManagedRuntime.ManagedRuntime<PluginService, never>,\n    private registry: PluginRegistry,\n  ) {}\n\n  /**\n   * Cache key for plugin instances: JSON-equal configs share one plugin\n   * instance (variables and secrets originate from bos.config.json, so they\n   * are JSON values). Values outside the JSON domain follow Effect's Hash\n   * semantics — symbols key by description, functions and class instances by\n   * reference identity — and the host creates its pluginsClient map once per\n   * boot, making identity the correct equivalence for function-bearing\n   * configs.\n   */\n  private generateCacheKey(pluginId: string, config: unknown): string {\n    return `${pluginId}:${this.canonicalizeConfig(config, 0, new Set())}`;\n  }\n\n  private canonicalizeConfig(value: unknown, depth: number, ancestors: Set<object>): string {\n    switch (typeof value) {\n      case \"undefined\":\n        return \"undefined\";\n      case \"string\":\n        return `string:${JSON.stringify(value)}`;\n      case \"number\":\n        return `number:${Object.is(value, -0) ? \"-0\" : String(value)}`;\n      case \"bigint\":\n        return `bigint:${value.toString()}`;\n      case \"boolean\":\n        return `boolean:${value}`;\n      case \"symbol\":\n        return `symbol:${String(value)}`;\n      case \"function\":\n        return `ref:${this.getCacheLeafId(value)}`;\n      case \"object\": {\n        if (value === null) return \"null\";\n        if (ancestors.has(value) || depth >= MAX_CACHE_KEY_DEPTH) {\n          return `ref:${this.getCacheLeafId(value)}`;\n        }\n\n        if (Array.isArray(value)) {\n          ancestors.add(value);\n          const serialized = `[${value\n            .map((item) => this.canonicalizeConfig(item, depth + 1, ancestors))\n            .join(\",\")}]`;\n          ancestors.delete(value);\n          return serialized;\n        }\n\n        const prototype = Object.getPrototypeOf(value);\n        if (prototype !== Object.prototype && prototype !== null) {\n          return `ref:${this.getCacheLeafId(value)}`;\n        }\n\n        const record = value as Record<string, unknown>;\n        ancestors.add(value);\n        const serialized = `{${Object.keys(record)\n          .sort()\n          .map(\n            (key) =>\n              `${JSON.stringify(key)}:${this.canonicalizeConfig(record[key], depth + 1, ancestors)}`,\n          )\n          .join(\",\")}}`;\n        ancestors.delete(value);\n        return serialized;\n      }\n    }\n  }\n\n  private getCacheLeafId(value: object): number {\n    const existing = this.cacheLeafIds.get(value);\n    if (existing !== undefined) return existing;\n    const id = this.nextCacheLeafId++;\n    this.cacheLeafIds.set(value, id);\n    return id;\n  }\n\n  private validatePluginId(pluginId: string): Effect.Effect<string, PluginRuntimeError> {\n    if (!(pluginId in this.registry)) {\n      return Effect.fail(\n        new PluginRuntimeError({\n          pluginId: String(pluginId),\n          operation: \"validate-plugin-id\",\n          cause: new Error(`Plugin ID '${String(pluginId)}' not found in registry.`),\n        }),\n      );\n    }\n    return Effect.succeed(String(pluginId));\n  }\n\n  private async runPromise<A, E>(effect: Effect.Effect<A, E, PluginService>): Promise<A> {\n    const exit = await this.runtime.runPromiseExit(effect);\n\n    if (Exit.isFailure(exit)) {\n      const error = Cause.findErrorOption(exit.cause);\n      if (Option.isSome(error)) {\n        throw error.value;\n      }\n      throw Cause.squash(exit.cause);\n    }\n\n    return exit.value;\n  }\n\n  async usePlugin<K extends keyof R & string>(\n    pluginId: K,\n    config: PluginConfigInput<R[K]>,\n    plugins?: Record<string, unknown>,\n  ): Promise<UsePluginResult<K, R>> {\n    const cacheKey = this.generateCacheKey(pluginId, { ...config, __plugins: plugins ?? {} });\n\n    let cachedPlugin = this.pluginCache.get(cacheKey);\n    if (!cachedPlugin) {\n      const operation = Effect.gen({ self: this }, function* () {\n        const pluginService = yield* PluginService;\n        const validatedId = yield* this.validatePluginId(pluginId);\n\n        // Load → Instantiate → Initialize → Register\n        const ctor = yield* pluginService.loadPlugin(validatedId);\n        const instance = yield* pluginService.instantiatePlugin(pluginId, ctor);\n        const initialized = yield* pluginService.initializePlugin(instance, config, plugins);\n        yield* pluginService.registerPlugin(initialized);\n\n        return initialized;\n      });\n\n      cachedPlugin = this.runPromise(operation);\n      this.pluginCache.set(cacheKey, cachedPlugin);\n    }\n\n    let initialized: InitializedPlugin<AnyPlugin>;\n    try {\n      initialized = await cachedPlugin;\n    } catch (error) {\n      if (this.pluginCache.get(cacheKey) === cachedPlugin) {\n        this.pluginCache.delete(cacheKey);\n        this.routerCache.delete(cacheKey);\n      }\n      throw error;\n    }\n\n    // Construct the router once per plugin instance, not per client/request.\n    let router = this.routerCache.get(cacheKey);\n    if (!router) {\n      try {\n        router = initialized.plugin.createRouter(plugins ?? {}) as PluginRouterType<R[K]>;\n        this.routerCache.set(cacheKey, router);\n      } catch (error) {\n        await this.evictPlugin(pluginId, config, plugins);\n        throw error;\n      }\n    }\n\n    // Create client factory that accepts request context. The plugin's\n    // Effect context is injected so `.effect()` handlers resolve services\n    // on in-process (server-side / SSR) calls.\n    const createClient = (context?: any) =>\n      createRouterClient(router, {\n        context: {\n          ...context,\n          \"effect/context\": initialized.effectContext,\n        },\n      });\n\n    return {\n      createClient: createClient as any,\n      router,\n      metadata: initialized.metadata,\n      initialized: initialized as InitializedPlugin<RegisteredPlugin<K, R>>,\n    } as UsePluginResult<K, R>;\n  }\n\n  async loadPlugin<K extends keyof R & string>(\n    pluginId: K,\n  ): Promise<LoadedPlugin<RegisteredPlugin<K, R>>> {\n    const effect = Effect.gen(function* () {\n      const pluginService = yield* PluginService;\n      return yield* pluginService.loadPlugin(pluginId);\n    });\n    return this.runPromise(effect) as Promise<LoadedPlugin<RegisteredPlugin<K, R>>>;\n  }\n\n  async instantiatePlugin<K extends keyof R & string>(\n    pluginId: K,\n    loadedPlugin: LoadedPlugin<RegisteredPlugin<K, R>>,\n  ): Promise<PluginInstance<RegisteredPlugin<K, R>>> {\n    const effect = Effect.gen(function* () {\n      const pluginService = yield* PluginService;\n      return yield* pluginService.instantiatePlugin(pluginId, loadedPlugin);\n    });\n    return this.runPromise(effect) as Promise<PluginInstance<RegisteredPlugin<K, R>>>;\n  }\n\n  async initializePlugin<T extends AnyPlugin>(\n    instance: PluginInstance<T>,\n    config: any,\n    plugins?: Record<string, unknown>,\n  ): Promise<InitializedPlugin<T>> {\n    const effect = Effect.gen(function* () {\n      const pluginService = yield* PluginService;\n      const initialized = yield* pluginService.initializePlugin(instance, config, plugins);\n      yield* pluginService.registerPlugin(initialized);\n      return initialized;\n    });\n    return this.runPromise(effect);\n  }\n\n  async shutdown(): Promise<void> {\n    const effect = Effect.gen(function* () {\n      const pluginService = yield* PluginService;\n      yield* pluginService.cleanup;\n    });\n    try {\n      await this.runPromise(effect);\n    } finally {\n      this.pluginCache.clear();\n      this.routerCache.clear();\n      await this.runtime.dispose();\n    }\n  }\n\n  async evictPlugin<K extends keyof R & string>(\n    pluginId: K,\n    config: PluginConfigInput<R[K]>,\n    plugins?: Record<string, unknown>,\n  ): Promise<void> {\n    const cacheKey = this.generateCacheKey(pluginId, { ...config, __plugins: plugins ?? {} });\n\n    const effect = Effect.gen({ self: this }, function* () {\n      const pluginService = yield* PluginService;\n      const cachedPlugin = this.pluginCache.get(cacheKey);\n\n      if (cachedPlugin) {\n        this.pluginCache.delete(cacheKey);\n        this.routerCache.delete(cacheKey);\n\n        const pluginResult = yield* Effect.tryPromise({\n          try: () => cachedPlugin,\n          catch: (error) => toPluginRuntimeError(error, pluginId, undefined, \"evict-plugin\"),\n        }).pipe(Effect.orElseSucceed(() => null));\n\n        if (pluginResult) {\n          yield* pluginService.shutdownPlugin(pluginResult);\n        }\n      }\n    });\n\n    return this.runPromise(effect);\n  }\n}\n\n/**\n * Normalizes a remote URL to ensure it points to remoteEntry.js\n * If the URL doesn't end with a file extension, appends /remoteEntry.js\n */\nfunction normalizeRemoteUrl(url: string): string {\n  if (!url) return url;\n  if (url.endsWith(\".js\") || url.endsWith(\".json\")) return url;\n  return `${url.endsWith(\"/\") ? url.slice(0, -1) : url}/${DEV_ENTRY_FILENAME}`;\n}\n\n/**\n * Extract plugin map (module constructors) from registry entries\n */\nfunction extractPluginMap(\n  registry: Record<string, PluginRegistryEntry>,\n): Record<string, AnyPluginConstructor> {\n  const pluginMap: Record<string, AnyPluginConstructor> = {};\n\n  for (const [pluginId, entry] of Object.entries(registry)) {\n    if (\"module\" in entry && entry.module) {\n      pluginMap[pluginId] = entry.module;\n    }\n  }\n\n  return pluginMap;\n}\n\n/**\n * Normalize registry entries - ensure remote URLs are properly formatted\n */\nfunction normalizeRegistry(registry: Record<string, PluginRegistryEntry>): PluginRegistry {\n  const normalized: Record<string, PluginRegistryEntry> = {};\n\n  for (const [pluginId, entry] of Object.entries(registry)) {\n    if (\"module\" in entry) {\n      normalized[pluginId] = {\n        ...entry,\n        remote: entry.remote ? normalizeRemoteUrl(entry.remote) : undefined,\n      };\n    } else {\n      normalized[pluginId] = {\n        ...entry,\n        remote: normalizeRemoteUrl(entry.remote),\n      };\n    }\n  }\n\n  return normalized as PluginRegistry;\n}\n\n/**\n * Creates a plugin runtime with support for both module and remote plugin entries.\n *\n * @example\n * ```typescript\n * // With module entries (types inferred automatically)\n * const runtime = createPluginRuntime({\n *   registry: {\n *     telegram: { module: TelegramPlugin },\n *     gopher: { remote: \"https://cdn.example.com/gopher/remoteEntry.js\" }\n *   },\n *   secrets: { API_KEY: \"...\" }\n * });\n *\n * // Types are automatically inferred from module entries!\n * const { router } = await runtime.usePlugin(\"telegram\", config);\n * ```\n */\nexport function createPluginRuntime<TRegistry extends Record<string, PluginRegistryEntry>>(\n  config: PluginRuntimeConfig<TRegistry>,\n): PluginRuntime<InferRegistryFromEntries<TRegistry>> {\n  const secrets = config.secrets || {};\n  const normalizedRegistry = normalizeRegistry(config.registry);\n  const pluginMap = extractPluginMap(config.registry);\n\n  const layer = PluginServiceLive(normalizedRegistry, secrets, pluginMap);\n  const runtime = ManagedRuntime.make(layer);\n\n  return new PluginRuntime(runtime, normalizedRegistry) as PluginRuntime<\n    InferRegistryFromEntries<TRegistry>\n  >;\n}\n"],"mappings":"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"}

package/dist/runtime/index.d.cts

@@ -1,14 +1,30 @@
 import { AnyPlugin, InferRegistryFromEntries, InitializedPlugin, LoadedPlugin, PluginConfigInput, PluginInstance, PluginRegistry, PluginRegistryEntry, PluginRuntimeConfig, RegisteredPlugin, RegisteredPlugins, UsePluginResult } from "../types.cjs";
 import { PluginService } from "./services/plugin.service.cjs";
 import { ManagedRuntime } from "effect";
+import "@orpc/openapi/extensions/route";
+import "@orpc/experimental-effect/extensions/effect";
 //#region src/runtime/index.d.ts
 declare class PluginRuntime<R = RegisteredPlugins> {
   private runtime;
   private registry;
   readonly __registryType?: R;
   private pluginCache;
+  private routerCache;
+  private cacheLeafIds;
+  private nextCacheLeafId;
   constructor(runtime: ManagedRuntime.ManagedRuntime<PluginService, never>, registry: PluginRegistry);
+  /**
+   * Cache key for plugin instances: JSON-equal configs share one plugin
+   * instance (variables and secrets originate from bos.config.json, so they
+   * are JSON values). Values outside the JSON domain follow Effect's Hash
+   * semantics — symbols key by description, functions and class instances by
+   * reference identity — and the host creates its pluginsClient map once per
+   * boot, making identity the correct equivalence for function-bearing
+   * configs.
+   */
   private generateCacheKey;
+  private canonicalizeConfig;
+  private getCacheLeafId;
   private validatePluginId;
   private runPromise;
   usePlugin<K extends keyof R & string>(pluginId: K, config: PluginConfigInput<R[K]>, plugins?: Record<string, unknown>): Promise<UsePluginResult<K, R>>;