jev-layer 0.1.0 → 0.2.0

package/src/cli.mjs

@@ -1,33 +1,33 @@
-#!/usr/bin/env node
-import { readFile } from "node:fs/promises";
-import { createInterface } from "node:readline";
-import { configuredProvider, loadConfig } from "./config.mjs";
-import { routeRequest } from "./route.mjs";
-
-const args = parseArgs(process.argv.slice(2));
-const { config } = await loadConfig();
-const input = args.input ? await readFile(args.input, "utf8") : null;
-const lines = input === null ? createInterface({ input: process.stdin, crlfDelay: Infinity }) : [input];
-
-for await (const line of lines) {
-  if (!line.trim()) continue;
-  try {
-    const request = JSON.parse(line);
-    const { provider = args.provider ?? configuredProvider(config), engine = args.engine ?? "native", ...payload } = request;
-    const decision = await routeRequest(payload, { provider, engine });
-    process.stdout.write(`${JSON.stringify(decision)}\n`);
-  } catch (error) {
-    process.stdout.write(`${JSON.stringify({ status: "error", reason: error instanceof Error ? error.message : String(error), execution: { enabled: false, status: "not_started" } })}\n`);
-  }
-}
-
-function parseArgs(argv) {
-  const result = {};
-  for (let index = 0; index < argv.length; index += 1) {
-    const value = argv[index];
-    if (value === "--input") result.input = argv[++index];
-    else if (value === "--provider") result.provider = argv[++index];
-    else if (value === "--engine") result.engine = argv[++index];
-  }
-  return result;
-}
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import { createInterface } from "node:readline";
+import { configuredProvider, loadConfig } from "./config.mjs";
+import { routeRequest } from "./route.mjs";
+
+const args = parseArgs(process.argv.slice(2));
+const { config } = await loadConfig();
+const input = args.input ? await readFile(args.input, "utf8") : null;
+const lines = input === null ? createInterface({ input: process.stdin, crlfDelay: Infinity }) : [input];
+
+for await (const line of lines) {
+  if (!line.trim()) continue;
+  try {
+    const request = JSON.parse(line);
+    const { provider = args.provider ?? configuredProvider(config), engine = args.engine ?? "native", ...payload } = request;
+    const decision = await routeRequest(payload, { provider, engine, config });
+    process.stdout.write(`${JSON.stringify(decision)}\n`);
+  } catch (error) {
+    process.stdout.write(`${JSON.stringify({ status: "error", reason: error instanceof Error ? error.message : String(error), execution: { enabled: false, status: "not_started" } })}\n`);
+  }
+}
+
+function parseArgs(argv) {
+  const result = {};
+  for (let index = 0; index < argv.length; index += 1) {
+    const value = argv[index];
+    if (value === "--input") result.input = argv[++index];
+    else if (value === "--provider") result.provider = argv[++index];
+    else if (value === "--engine") result.engine = argv[++index];
+  }
+  return result;
+}

package/src/config.mjs

@@ -1,75 +1,85 @@
-import { access, readFile } from "node:fs/promises";
-import { join, resolve } from "node:path";
-
-export const DEFAULT_CONFIG = Object.freeze({
-  schema_version: 1,
-  provider: "demo",
-  replay_cases: ".jev/replay/cases.jsonl",
-  features: {
-    browser_fast_path: false,
-    supervision: false,
-    context_filter: null,
-  },
-  providers: {
-    openrouter: {
-      api_key_env: "OPENROUTER_API_KEY",
-      endpoint_env: "OPENROUTER_DECISIONS_ENDPOINT",
-      model_env: "OPENROUTER_DECISIONS_MODEL",
-    },
-    typesafe: {
-      api_key_env: "TYPESAFE_API_KEY",
-      endpoint_env: "TYPESAFE_ENDPOINT",
-      model_env: "TYPESAFE_MODEL",
-    },
-  },
-});
-
-export async function loadConfig({ cwd = process.cwd(), path = process.env.JEV_CONFIG } = {}) {
-  const configPath = resolve(path || join(cwd, ".jev", "config.json"));
-  try {
-    const parsed = JSON.parse(await readFile(configPath, "utf8"));
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      return { config: { ...DEFAULT_CONFIG }, path: configPath, error: "config must be a JSON object" };
-    }
-    return {
-      config: mergeConfig(parsed),
-      path: configPath,
-      error: null,
-    };
-  } catch (error) {
-    if (error?.code === "ENOENT") return { config: { ...DEFAULT_CONFIG }, path: configPath, error: null };
-    return { config: { ...DEFAULT_CONFIG }, path: configPath, error: error instanceof Error ? error.message : String(error) };
-  }
-}
-
-export function configuredProvider(config, explicitProvider) {
-  return explicitProvider ?? process.env.JEV_LAYER_PROVIDER ?? config?.provider ?? DEFAULT_CONFIG.provider;
-}
-
-export function configuredReplayPath(config) {
-  return process.env.JEV_REPLAY_CASES ?? config?.replay_cases ?? DEFAULT_CONFIG.replay_cases;
-}
-
-export async function pathExists(path) {
-  try {
-    await access(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function mergeConfig(parsed) {
-  return {
-    ...DEFAULT_CONFIG,
-    ...parsed,
-    features: {
-      ...DEFAULT_CONFIG.features,
-      ...(parsed.features && typeof parsed.features === "object" ? parsed.features : {}),
-    },
-    providers: {
-      ...DEFAULT_CONFIG.providers,
-      ...(parsed.providers && typeof parsed.providers === "object" ? parsed.providers : {}),
-    },
-  };
-}
+import { access, readFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+
+export const DEFAULT_CONFIG = Object.freeze({
+  schema_version: 1,
+  provider: "demo",
+  replay_cases: ".jev/replay/cases.jsonl",
+  features: {
+    browser_fast_path: false,
+    supervision: false,
+    context_filter: null,
+  },
+  providers: {
+    openrouter: {
+      api_key_env: "OPENROUTER_API_KEY",
+      endpoint_env: "OPENROUTER_DECISIONS_ENDPOINT",
+      model_env: "OPENROUTER_DECISIONS_MODEL",
+    },
+    typesafe: {
+      api_key_env: "TYPESAFE_API_KEY",
+      endpoint_env: "TYPESAFE_ENDPOINT",
+      model_env: "TYPESAFE_MODEL",
+    },
+  },
+});
+
+export async function loadConfig({ cwd = process.cwd(), path = process.env.JEV_CONFIG } = {}) {
+  const configPath = resolve(path || join(cwd, ".jev", "config.json"));
+  try {
+    const parsed = JSON.parse(await readFile(configPath, "utf8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return { config: { ...DEFAULT_CONFIG }, path: configPath, error: "config must be a JSON object" };
+    }
+    return {
+      config: mergeConfig(parsed),
+      path: configPath,
+      error: null,
+    };
+  } catch (error) {
+    if (error?.code === "ENOENT") return { config: { ...DEFAULT_CONFIG }, path: configPath, error: null };
+    return { config: { ...DEFAULT_CONFIG }, path: configPath, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
+export function configuredProvider(config, explicitProvider) {
+  return explicitProvider ?? process.env.JEV_LAYER_PROVIDER ?? config?.provider ?? DEFAULT_CONFIG.provider;
+}
+
+export function configuredProviderOptions(config, provider) {
+  if (!config?.providers?.[provider]) return {};
+  const names = { ...DEFAULT_CONFIG.providers[provider], ...config.providers[provider] };
+  return {
+    apiKey: process.env[names.api_key_env] ?? "",
+    endpoint: process.env[names.endpoint_env],
+    model: process.env[names.model_env],
+  };
+}
+
+export function configuredReplayPath(config) {
+  return process.env.JEV_REPLAY_CASES ?? config?.replay_cases ?? DEFAULT_CONFIG.replay_cases;
+}
+
+export async function pathExists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function mergeConfig(parsed) {
+  return {
+    ...DEFAULT_CONFIG,
+    ...parsed,
+    features: {
+      ...DEFAULT_CONFIG.features,
+      ...(parsed.features && typeof parsed.features === "object" ? parsed.features : {}),
+    },
+    providers: {
+      ...DEFAULT_CONFIG.providers,
+      ...(parsed.providers && typeof parsed.providers === "object" ? parsed.providers : {}),
+    },
+  };
+}

package/src/context-filter.mjs

@@ -1,56 +1,56 @@
-import { byteLength, stableJson } from "./contract.mjs";
-import { filterContext, normalizeRelevanceMode } from "./relevance-filter.mjs";
-const SECRET_KEY = /(token|secret|password|passwd|api[_-]?key|authorization|cookie|credential|private[_-]?key|session)/i;
-const MAX_STRING = 2_000;
-const MAX_DEPTH = 4;
-
-export function sanitizeContext(value, depth = 0, key = "") {
-  if (SECRET_KEY.test(key)) return "[REDACTED]";
-  if (depth > MAX_DEPTH) return "[DEPTH_LIMIT]";
-  if (typeof value === "string") return value.length > MAX_STRING ? `${value.slice(0, MAX_STRING)}…` : value;
-  if (value === null || typeof value === "number" || typeof value === "boolean") return value;
-  if (Array.isArray(value)) return value.slice(0, 32).map((item) => sanitizeContext(item, depth + 1, key));
-  if (value && typeof value === "object") {
-    return Object.fromEntries(Object.entries(value).slice(0, 64).map(([childKey, childValue]) => [childKey, sanitizeContext(childValue, depth + 1, childKey)]));
-  }
-  return String(value);
-}
-
-export function projectState(request, capabilities, maxBytes = 6_000, options = {}) {
-  const configuredMode = options.mode ?? request.policy?.context_filter_mode ?? process.env.JEV_CONTEXT_FILTER;
-  const relevanceMode = normalizeRelevanceMode(configuredMode);
-  const relevance = filterContext(request.context, { mode: configuredMode, recent: options.recent });
-  const state = {
-    intent: request.intent.length > MAX_STRING ? `${request.intent.slice(0, MAX_STRING)}…` : request.intent,
-    context: sanitizeContext(relevance.context),
-    capabilities: capabilities.map((capability) => ({
-      id: capability.id,
-      kind: capability.kind,
-      name: capability.name,
-      description: capability.description,
-      risk: capability.risk,
-    })),
-  };
-  if (relevanceMode) state.context_filter = relevance.report;
-
-  let encoded = stableJson(state);
-  if (byteLength(encoded) <= maxBytes) return { state, context_bytes: byteLength(encoded), truncated: false };
-  if (relevanceMode) {
-    state.context_filter = { ...state.context_filter, over_budget: true };
-    return { state, context_bytes: byteLength(encoded), truncated: true };
-  }
-
-  state.context = {};
-  state.context_truncated = true;
-  encoded = stableJson(state);
-  if (byteLength(encoded) <= maxBytes) return { state, context_bytes: byteLength(encoded), truncated: true };
-
-  state.capabilities = state.capabilities.map(({ id, kind, name, risk }) => ({ id, kind, name, risk }));
-  encoded = stableJson(state);
-  if (byteLength(encoded) <= maxBytes) return { state, context_bytes: byteLength(encoded), truncated: true };
-
-  state.capabilities = state.capabilities.slice(0, 32);
-  state.capabilities_truncated = true;
-  state.intent = state.intent.slice(0, Math.max(128, maxBytes - byteLength(stableJson(state))));
-  return { state, context_bytes: byteLength(stableJson(state)), truncated: true };
-}
+import { byteLength, stableJson } from "./contract.mjs";
+import { filterContext, normalizeRelevanceMode } from "./relevance-filter.mjs";
+const SECRET_KEY = /(token|secret|password|passwd|api[_-]?key|authorization|cookie|credential|private[_-]?key|session)/i;
+const MAX_STRING = 2_000;
+const MAX_DEPTH = 4;
+
+export function sanitizeContext(value, depth = 0, key = "") {
+  if (SECRET_KEY.test(key)) return "[REDACTED]";
+  if (depth > MAX_DEPTH) return "[DEPTH_LIMIT]";
+  if (typeof value === "string") return value.length > MAX_STRING ? `${value.slice(0, MAX_STRING)}…` : value;
+  if (value === null || typeof value === "number" || typeof value === "boolean") return value;
+  if (Array.isArray(value)) return value.slice(0, 32).map((item) => sanitizeContext(item, depth + 1, key));
+  if (value && typeof value === "object") {
+    return Object.fromEntries(Object.entries(value).slice(0, 64).map(([childKey, childValue]) => [childKey, sanitizeContext(childValue, depth + 1, childKey)]));
+  }
+  return String(value);
+}
+
+export function projectState(request, capabilities, maxBytes = 6_000, options = {}) {
+  const configuredMode = options.mode ?? request.policy?.context_filter_mode ?? process.env.JEV_CONTEXT_FILTER;
+  const relevanceMode = normalizeRelevanceMode(configuredMode);
+  const relevance = filterContext(request.context, { mode: configuredMode, recent: options.recent });
+  const state = {
+    intent: request.intent.length > MAX_STRING ? `${request.intent.slice(0, MAX_STRING)}…` : request.intent,
+    context: sanitizeContext(relevance.context),
+    capabilities: capabilities.map((capability) => ({
+      id: capability.id,
+      kind: capability.kind,
+      name: capability.name,
+      description: capability.description,
+      risk: capability.risk,
+    })),
+  };
+  if (relevanceMode) state.context_filter = relevance.report;
+
+  let encoded = stableJson(state);
+  if (byteLength(encoded) <= maxBytes) return { state, context_bytes: byteLength(encoded), truncated: false };
+  if (relevanceMode) {
+    state.context_filter = { ...state.context_filter, over_budget: true };
+    return { state, context_bytes: byteLength(encoded), truncated: true };
+  }
+
+  state.context = {};
+  state.context_truncated = true;
+  encoded = stableJson(state);
+  if (byteLength(encoded) <= maxBytes) return { state, context_bytes: byteLength(encoded), truncated: true };
+
+  state.capabilities = state.capabilities.map(({ id, kind, name, risk }) => ({ id, kind, name, risk }));
+  encoded = stableJson(state);
+  if (byteLength(encoded) <= maxBytes) return { state, context_bytes: byteLength(encoded), truncated: true };
+
+  state.capabilities = state.capabilities.slice(0, 32);
+  state.capabilities_truncated = true;
+  state.intent = state.intent.slice(0, Math.max(128, maxBytes - byteLength(stableJson(state))));
+  return { state, context_bytes: byteLength(stableJson(state)), truncated: true };
+}

package/src/contract.mjs

@@ -1,72 +1,72 @@
-import { createHash, randomUUID } from "node:crypto";
-
-export const RISK_ORDER = Object.freeze({ low: 0, medium: 1, high: 2, critical: 3 });
-export const CAPABILITY_KINDS = new Set(["skill", "tool", "mcp", "cli", "dsh", "subagent", "model"]);
-
-export function stableJson(value) {
-  return JSON.stringify(sortJson(value));
-}
-
-function sortJson(value) {
-  if (Array.isArray(value)) return value.map(sortJson);
-  if (value && typeof value === "object") {
-    return Object.fromEntries(Object.keys(value).sort().map((key) => [key, sortJson(value[key])]));
-  }
-  return value;
-}
-
-export function sha256(value) {
-  return `sha256:${createHash("sha256").update(typeof value === "string" ? value : stableJson(value)).digest("hex")}`;
-}
-
-export function byteLength(value) {
-  return Buffer.byteLength(typeof value === "string" ? value : stableJson(value), "utf8");
-}
-
-export function normalizeRequest(input) {
-  if (!input || typeof input !== "object" || Array.isArray(input)) {
-    throw new TypeError("route request must be an object");
-  }
-  const intent = typeof input.intent === "string" ? input.intent : input.request;
-  if (typeof intent !== "string" || intent.trim() === "") {
-    throw new TypeError("route request requires a non-empty intent");
-  }
-  if (!Array.isArray(input.capabilities)) {
-    throw new TypeError("route request requires capabilities[]");
-  }
-  return {
-    schema_version: input.schema_version ?? 1,
-    harness: typeof input.harness === "string" ? input.harness : "unknown",
-    intent: intent.trim(),
-    context: input.context && typeof input.context === "object" ? input.context : {},
-    actor: typeof input.actor === "string" ? input.actor : undefined,
-    actor_permissions: Array.isArray(input.actor_permissions) ? input.actor_permissions.filter((value) => typeof value === "string") : undefined,
-    capabilities: input.capabilities,
-    policy: input.policy && typeof input.policy === "object" ? input.policy : {},
-  };
-}
-
-export function decisionEnvelope({ status, selected, reason, provider, latencyMs, candidateCount, contextBytes, candidates = [], probabilities = {}, confidence = null, rawJev = null, fallback = null, requestId = randomUUID(), correlationId = requestId, costUsd = rawJev?.usage?.cost ?? null }) {
-  return {
-    schema_version: 1,
-    correlation_id: correlationId,
-    status,
-    selected: selected ?? null,
-    confidence,
-    probabilities,
-    reason,
-    candidates,
-    fallback,
-    execution: { enabled: false, status: "not_started" },
-    raw_jev: rawJev,
-    receipt: {
-      correlation_id: correlationId,
-      request_id: requestId,
-      provider,
-      latency_ms: latencyMs,
-      cost_usd: costUsd,
-      candidate_count: candidateCount,
-      context_bytes: contextBytes,
-    },
-  };
-}
+import { createHash, randomUUID } from "node:crypto";
+
+export const RISK_ORDER = Object.freeze({ low: 0, medium: 1, high: 2, critical: 3 });
+export const CAPABILITY_KINDS = new Set(["skill", "tool", "mcp", "cli", "dsh", "subagent", "model"]);
+
+export function stableJson(value) {
+  return JSON.stringify(sortJson(value));
+}
+
+function sortJson(value) {
+  if (Array.isArray(value)) return value.map(sortJson);
+  if (value && typeof value === "object") {
+    return Object.fromEntries(Object.keys(value).sort().map((key) => [key, sortJson(value[key])]));
+  }
+  return value;
+}
+
+export function sha256(value) {
+  return `sha256:${createHash("sha256").update(typeof value === "string" ? value : stableJson(value)).digest("hex")}`;
+}
+
+export function byteLength(value) {
+  return Buffer.byteLength(typeof value === "string" ? value : stableJson(value), "utf8");
+}
+
+export function normalizeRequest(input) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
+    throw new TypeError("route request must be an object");
+  }
+  const intent = typeof input.intent === "string" ? input.intent : input.request;
+  if (typeof intent !== "string" || intent.trim() === "") {
+    throw new TypeError("route request requires a non-empty intent");
+  }
+  if (!Array.isArray(input.capabilities)) {
+    throw new TypeError("route request requires capabilities[]");
+  }
+  return {
+    schema_version: input.schema_version ?? 1,
+    harness: typeof input.harness === "string" ? input.harness : "unknown",
+    intent: intent.trim(),
+    context: input.context && typeof input.context === "object" ? input.context : {},
+    actor: typeof input.actor === "string" ? input.actor : undefined,
+    actor_permissions: Array.isArray(input.actor_permissions) ? input.actor_permissions.filter((value) => typeof value === "string") : undefined,
+    capabilities: input.capabilities,
+    policy: input.policy && typeof input.policy === "object" ? input.policy : {},
+  };
+}
+
+export function decisionEnvelope({ status, selected, reason, provider, latencyMs, candidateCount, contextBytes, candidates = [], probabilities = {}, confidence = null, rawJev = null, fallback = null, requestId = randomUUID(), correlationId = requestId, costUsd = rawJev?.usage?.cost ?? null }) {
+  return {
+    schema_version: 1,
+    correlation_id: correlationId,
+    status,
+    selected: selected ?? null,
+    confidence,
+    probabilities,
+    reason,
+    candidates,
+    fallback,
+    execution: { enabled: false, status: "not_started" },
+    raw_jev: rawJev,
+    receipt: {
+      correlation_id: correlationId,
+      request_id: requestId,
+      provider,
+      latency_ms: latencyMs,
+      cost_usd: costUsd,
+      candidate_count: candidateCount,
+      context_bytes: contextBytes,
+    },
+  };
+}

package/src/discovery.mjs

@@ -1,65 +1,65 @@
-import { readFile } from "node:fs/promises";
-
-const DISCOVERY_SOURCES = Object.freeze([
-  ["skills", "skill"],
-  ["mcp", "mcp"],
-  ["cli", "cli"],
-  ["dsh", "dsh"],
-  ["tools", "tool"],
-  ["subagents", "subagent"],
-  ["models", "model"],
-]);
-
-export function discoverCapabilities(input = {}) {
-  const entries = [];
-  for (const [field, kind] of DISCOVERY_SOURCES) {
-    const values = Array.isArray(input[field]) ? input[field] : [];
-    for (const value of values) entries.push(normalizeDiscovered(value, kind, input.source ?? `${kind}-discovery`));
-  }
-  const manifests = Array.isArray(input.manifests) ? input.manifests : [];
-  for (const manifest of manifests) {
-    const values = Array.isArray(manifest?.capabilities) ? manifest.capabilities : [manifest];
-    for (const value of values) {
-      const kind = value?.kind ?? value?.type ?? manifest?.kind ?? "tool";
-      entries.push(normalizeDiscovered(value, kind, value?.source ?? manifest?.source ?? "manifest"));
-    }
-  }
-  const seen = new Set();
-  return entries.filter((entry) => {
-    if (seen.has(entry.id)) return false;
-    seen.add(entry.id);
-    return true;
-  });
-}
-
-export async function loadCapabilityManifest(path, options = {}) {
-  const parsed = JSON.parse(await readFile(path, "utf8"));
-  const manifest = Array.isArray(parsed) ? { capabilities: parsed } : parsed;
-  return discoverCapabilities({ manifests: [{ ...manifest, source: options.source ?? manifest.source ?? "manifest" }] });
-}
-
-function normalizeDiscovered(value, kind, source) {
-  if (!value || typeof value !== "object") throw new TypeError("discovered capability must be an object");
-  const id = stringValue(value.id ?? value.name, `${kind}-capability`);
-  const name = stringValue(value.name ?? value.id, id);
-  const description = stringValue(value.description ?? value.summary, `${kind} capability ${name}`);
-  const metadata = {
-    ...(value.metadata && typeof value.metadata === "object" ? value.metadata : {}),
-    [kind]: stringValue(value.target ?? value.command ?? value.name, name),
-  };
-  return {
-    ...value,
-    id,
-    kind,
-    name,
-    description,
-    source: stringValue(value.source, source),
-    verified: value.verified === true,
-    metadata,
-    available: value.available !== false && value.availability?.available !== false,
-  };
-}
-
-function stringValue(value, fallback) {
-  return typeof value === "string" && value.trim() ? value.trim() : fallback;
-}
+import { readFile } from "node:fs/promises";
+
+const DISCOVERY_SOURCES = Object.freeze([
+  ["skills", "skill"],
+  ["mcp", "mcp"],
+  ["cli", "cli"],
+  ["dsh", "dsh"],
+  ["tools", "tool"],
+  ["subagents", "subagent"],
+  ["models", "model"],
+]);
+
+export function discoverCapabilities(input = {}) {
+  const entries = [];
+  for (const [field, kind] of DISCOVERY_SOURCES) {
+    const values = Array.isArray(input[field]) ? input[field] : [];
+    for (const value of values) entries.push(normalizeDiscovered(value, kind, input.source ?? `${kind}-discovery`));
+  }
+  const manifests = Array.isArray(input.manifests) ? input.manifests : [];
+  for (const manifest of manifests) {
+    const values = Array.isArray(manifest?.capabilities) ? manifest.capabilities : [manifest];
+    for (const value of values) {
+      const kind = value?.kind ?? value?.type ?? manifest?.kind ?? "tool";
+      entries.push(normalizeDiscovered(value, kind, value?.source ?? manifest?.source ?? "manifest"));
+    }
+  }
+  const seen = new Set();
+  return entries.filter((entry) => {
+    if (seen.has(entry.id)) return false;
+    seen.add(entry.id);
+    return true;
+  });
+}
+
+export async function loadCapabilityManifest(path, options = {}) {
+  const parsed = JSON.parse(await readFile(path, "utf8"));
+  const manifest = Array.isArray(parsed) ? { capabilities: parsed } : parsed;
+  return discoverCapabilities({ manifests: [{ ...manifest, source: options.source ?? manifest.source ?? "manifest" }] });
+}
+
+function normalizeDiscovered(value, kind, source) {
+  if (!value || typeof value !== "object") throw new TypeError("discovered capability must be an object");
+  const id = stringValue(value.id ?? value.name, `${kind}-capability`);
+  const name = stringValue(value.name ?? value.id, id);
+  const description = stringValue(value.description ?? value.summary, `${kind} capability ${name}`);
+  const metadata = {
+    ...(value.metadata && typeof value.metadata === "object" ? value.metadata : {}),
+    [kind]: stringValue(value.target ?? value.command ?? value.name, name),
+  };
+  return {
+    ...value,
+    id,
+    kind,
+    name,
+    description,
+    source: stringValue(value.source, source),
+    verified: value.verified === true,
+    metadata,
+    available: value.available !== false && value.availability?.available !== false,
+  };
+}
+
+function stringValue(value, fallback) {
+  return typeof value === "string" && value.trim() ? value.trim() : fallback;
+}