@blxzer/cursor-trellis-core 0.4.2 → 0.5.0-beta.0

package/dist/index.d.ts

@@ -1,4 +1,3 @@
 export * from "./channel/index.js";
 export * from "./task/index.js";
-export * from "./rpc/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,8 +1,7 @@
-// Root barrel — re-exports the channel, task, and rpc public APIs so callers
+// Root barrel — re-exports the channel and task public APIs so callers
 // can `import { ... } from "@blxzer/cursor-trellis-core"`. Sub-path
-// imports (`@blxzer/cursor-trellis-core/channel`, `/task`, `/rpc`) remain the
+// imports (`@blxzer/cursor-trellis-core/channel`, `/task`) remain the
 // recommended form for tree-shake-friendly consumption.
 export * from "./channel/index.js";
 export * from "./task/index.js";
-export * from "./rpc/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,oEAAoE;AACpE,8EAA8E;AAC9E,wDAAwD;AAExD,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,oEAAoE;AACpE,sEAAsE;AACtE,wDAAwD;AAExD,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/task/adapter-middleware.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Stage 6 Cursor Adapter + Middleware (P27 Middleware, P29 Adapter/Profile,
+ * P30 Stage 6).
+ *
+ * Pure helpers persisted through existing create extras / patch. Does not
+ * write Kernel store or task.json. Field names here are an implementation
+ * choice — not a frozen Manifest / Event ABI schema.
+ */
+export declare const STAGE6_SOURCE = "stage6-adapter-middleware";
+export declare const STAGE6_SCHEMA_VERSION: 1;
+export declare const STAGE6_HOOK_EVENTS: readonly ["sessionStart", "preToolUse", "beforeSubmitPrompt", "beforeShellExecution", "afterShellExecution", "stop"];
+export type Stage6HookEvent = (typeof STAGE6_HOOK_EVENTS)[number];
+export declare const RETRIEVAL_INTENTS: readonly ["exact", "semantic", "structural", "external"];
+export type RetrievalIntent = (typeof RETRIEVAL_INTENTS)[number];
+export type MiddlewareProbeKind = "cli" | "mcp" | "host";
+export declare const SHIPPED_MIDDLEWARE_PROVIDERS: readonly ["smart-search", "codegraph", "fast-context", "chrome-cdp", "playwright", "github", "cursor-ide-browser"];
+export type ShippedMiddlewareProvider = (typeof SHIPPED_MIDDLEWARE_PROVIDERS)[number];
+/** Default `registered` catalog (Protocol v1 shipped table). */
+export declare const DEFAULT_MIDDLEWARE_PROVIDERS: readonly ["smart-search", "codegraph", "fast-context", "chrome-cdp", "playwright", "github", "cursor-ide-browser"];
+export declare const DEFAULT_REQUIRED_MIDDLEWARE_PROVIDERS: readonly ["smart-search"];
+export declare const OPTIONAL_CODE_INTEL_PROVIDERS: readonly ["codegraph", "fast-context"];
+export declare const SMART_SEARCH_PROVIDER = "smart-search";
+export declare const EXTERNAL_KNOWLEDGE_CAPABILITY = "external-knowledge";
+export declare const SHIPPED_PROVIDER_CAPABILITY: Record<ShippedMiddlewareProvider, string>;
+export declare const SHIPPED_PROVIDER_PROBE: Record<ShippedMiddlewareProvider, MiddlewareProbeKind>;
+export type Stage6CommandPhase = "create" | "start" | "archive" | "patch";
+export type ProviderReadinessStatus = "ready" | "missing" | "failed" | "unknown";
+export interface EventSubscription {
+    event: string;
+    module: string;
+}
+export interface EventBridgeLastEvent {
+    event: string;
+    at: string;
+    source: string;
+    delivered: string[];
+    skipped: string[];
+}
+export interface EventBridgeState {
+    schema_version: typeof STAGE6_SCHEMA_VERSION;
+    source: typeof STAGE6_SOURCE;
+    subscriptions: EventSubscription[];
+    last_event?: EventBridgeLastEvent;
+}
+export interface ProviderReadiness {
+    status: ProviderReadinessStatus;
+    capability: string;
+    evidence?: string | null;
+}
+export interface MiddlewareProviders {
+    schema_version: typeof STAGE6_SCHEMA_VERSION;
+    source: typeof STAGE6_SOURCE;
+    registered: string[];
+    required: string[];
+    active: string[];
+    degraded: string[];
+    readiness: Record<string, ProviderReadiness>;
+}
+export interface CapabilityRouter {
+    schema_version: typeof STAGE6_SCHEMA_VERSION;
+    source: typeof STAGE6_SOURCE;
+    exact?: true;
+    semantic?: true;
+    structural?: true;
+    external?: true;
+}
+export interface DispatchHookEventInput {
+    event: string;
+    source?: string;
+    at?: string;
+}
+export declare function defaultEventBridge(): EventBridgeState;
+export declare function defaultMiddlewareProviders(): MiddlewareProviders;
+export declare function defaultCapabilityRouter(): CapabilityRouter;
+export declare function subscribeEvent(extras: Record<string, unknown>, event: string, moduleName: string): EventBridgeState;
+/**
+ * Record and dispatch one hook event. Unsubscribed modules are skipped and
+ * never fail the hook.
+ */
+export declare function recordHookEvent(extras: Record<string, unknown>, input: DispatchHookEventInput): EventBridgeLastEvent;
+export declare function shippedProviderCapability(id: string): string;
+export declare function shippedProviderProbeKind(id: string): MiddlewareProbeKind | null;
+export declare function classifyTransportProbe(input: {
+    kind?: MiddlewareProbeKind;
+    present?: boolean;
+    reachable?: boolean;
+    available?: boolean;
+    status?: ProviderReadinessStatus;
+    evidence?: string | null;
+}): Pick<ProviderReadiness, "status" | "evidence">;
+export declare function mcpServerIdsFromConfig(raw: unknown): string[];
+export declare function selectRegisteredMcpServers(configuredServerIds: readonly string[], registered?: readonly string[]): string[];
+export declare function probeShippedProviderReadiness(id: string, input?: {
+    present?: boolean;
+    reachable?: boolean;
+    available?: boolean;
+    status?: ProviderReadinessStatus;
+    evidence?: string | null;
+}): ProviderReadiness;
+export declare function probeSmartSearchReadiness(input?: {
+    available?: boolean;
+    status?: ProviderReadinessStatus;
+    evidence?: string | null;
+}): ProviderReadiness;
+export declare function applyShippedProviderReadiness(extras: Record<string, unknown>, id: string, readiness: ProviderReadiness): MiddlewareProviders;
+export declare function applySmartSearchReadiness(extras: Record<string, unknown>, readiness: ProviderReadiness): MiddlewareProviders;
+export declare function normalizeEventBridge(raw: unknown): EventBridgeState;
+export declare function normalizeMiddlewareProviders(raw: unknown): MiddlewareProviders;
+export declare function normalizeCapabilityRouter(raw: unknown): CapabilityRouter;
+export declare function readEventBridge(extras: Record<string, unknown>): EventBridgeState;
+export declare function readMiddlewareProviders(extras: Record<string, unknown>): MiddlewareProviders;
+export declare function readCapabilityRouter(extras: Record<string, unknown>): CapabilityRouter;
+export declare function requiredCapabilities(extras: Record<string, unknown>): string[];
+export declare function externalKnowledgeReady(providers: MiddlewareProviders): boolean;
+export declare function normalizeStage6InExtras(extras: Record<string, unknown>): void;
+export declare function assertStage6ForPhase(extras: Record<string, unknown>, phase: Stage6CommandPhase): void;
+export declare function normalizeStage6InExtrasAndAssert(extras: Record<string, unknown>, phase: Stage6CommandPhase): void;
+//# sourceMappingURL=adapter-middleware.d.ts.map

package/dist/task/adapter-middleware.d.ts.map

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

package/dist/task/adapter-middleware.js

@@ -0,0 +1,508 @@
+/**
+ * Stage 6 Cursor Adapter + Middleware (P27 Middleware, P29 Adapter/Profile,
+ * P30 Stage 6).
+ *
+ * Pure helpers persisted through existing create extras / patch. Does not
+ * write Kernel store or task.json. Field names here are an implementation
+ * choice — not a frozen Manifest / Event ABI schema.
+ */
+import { KernelError } from "./kernel-contract.js";
+import { isPlainObject } from "./schema.js";
+export const STAGE6_SOURCE = "stage6-adapter-middleware";
+export const STAGE6_SCHEMA_VERSION = 1;
+export const STAGE6_HOOK_EVENTS = [
+    "sessionStart",
+    "preToolUse",
+    "beforeSubmitPrompt",
+    "beforeShellExecution",
+    "afterShellExecution",
+    "stop",
+];
+export const RETRIEVAL_INTENTS = [
+    "exact",
+    "semantic",
+    "structural",
+    "external",
+];
+export const SHIPPED_MIDDLEWARE_PROVIDERS = [
+    "smart-search",
+    "codegraph",
+    "fast-context",
+    "chrome-cdp",
+    "playwright",
+    "github",
+    "cursor-ide-browser",
+];
+/** Default `registered` catalog (Protocol v1 shipped table). */
+export const DEFAULT_MIDDLEWARE_PROVIDERS = SHIPPED_MIDDLEWARE_PROVIDERS;
+export const DEFAULT_REQUIRED_MIDDLEWARE_PROVIDERS = [
+    "smart-search",
+];
+export const OPTIONAL_CODE_INTEL_PROVIDERS = [
+    "codegraph",
+    "fast-context",
+];
+export const SMART_SEARCH_PROVIDER = "smart-search";
+export const EXTERNAL_KNOWLEDGE_CAPABILITY = "external-knowledge";
+export const SHIPPED_PROVIDER_CAPABILITY = {
+    "smart-search": EXTERNAL_KNOWLEDGE_CAPABILITY,
+    codegraph: "structural",
+    "fast-context": "semantic",
+    "chrome-cdp": "browser-session",
+    playwright: "browser-automation",
+    github: "vcs-host",
+    "cursor-ide-browser": "ide-browser",
+};
+export const SHIPPED_PROVIDER_PROBE = {
+    "smart-search": "cli",
+    codegraph: "mcp",
+    "fast-context": "mcp",
+    "chrome-cdp": "cli",
+    playwright: "mcp",
+    github: "mcp",
+    "cursor-ide-browser": "host",
+};
+export function defaultEventBridge() {
+    return {
+        schema_version: STAGE6_SCHEMA_VERSION,
+        source: STAGE6_SOURCE,
+        subscriptions: [],
+    };
+}
+function defaultReadinessMap() {
+    const readiness = {};
+    for (const id of SHIPPED_MIDDLEWARE_PROVIDERS) {
+        readiness[id] = {
+            status: "unknown",
+            capability: SHIPPED_PROVIDER_CAPABILITY[id],
+            evidence: null,
+        };
+    }
+    return readiness;
+}
+export function defaultMiddlewareProviders() {
+    return {
+        schema_version: STAGE6_SCHEMA_VERSION,
+        source: STAGE6_SOURCE,
+        registered: [...SHIPPED_MIDDLEWARE_PROVIDERS],
+        required: [...DEFAULT_REQUIRED_MIDDLEWARE_PROVIDERS],
+        active: [],
+        degraded: [],
+        readiness: defaultReadinessMap(),
+    };
+}
+export function defaultCapabilityRouter() {
+    return {
+        schema_version: STAGE6_SCHEMA_VERSION,
+        source: STAGE6_SOURCE,
+        exact: true,
+        semantic: true,
+        structural: true,
+        external: true,
+    };
+}
+export function subscribeEvent(extras, event, moduleName) {
+    const current = readEventBridge(extras);
+    const eventName = requireId(event, "event_bridge.subscriptions[].event");
+    const module = requireId(moduleName, "event_bridge.subscriptions[].module");
+    const subscriptions = [...current.subscriptions];
+    if (!subscriptions.some((item) => item.event === eventName && item.module === module)) {
+        subscriptions.push({ event: eventName, module });
+    }
+    const next = { ...current, subscriptions };
+    extras.event_bridge = next;
+    return next;
+}
+/**
+ * Record and dispatch one hook event. Unsubscribed modules are skipped and
+ * never fail the hook.
+ */
+export function recordHookEvent(extras, input) {
+    const current = readEventBridge(extras);
+    const event = requireId(input.event, "event_bridge.last_event.event");
+    const delivered = [];
+    const skipped = [];
+    for (const sub of current.subscriptions) {
+        if (sub.event !== event) {
+            skipped.push(sub.module);
+            continue;
+        }
+        if (!delivered.includes(sub.module))
+            delivered.push(sub.module);
+    }
+    const lastEvent = {
+        event,
+        at: typeof input.at === "string" && input.at.trim() !== ""
+            ? input.at
+            : new Date().toISOString(),
+        source: typeof input.source === "string" && input.source.trim() !== ""
+            ? input.source
+            : "cursor-hooks",
+        delivered,
+        skipped,
+    };
+    extras.event_bridge = { ...current, last_event: lastEvent };
+    return lastEvent;
+}
+export function shippedProviderCapability(id) {
+    if (id in SHIPPED_PROVIDER_CAPABILITY) {
+        return SHIPPED_PROVIDER_CAPABILITY[id];
+    }
+    return id === SMART_SEARCH_PROVIDER
+        ? EXTERNAL_KNOWLEDGE_CAPABILITY
+        : "unknown";
+}
+export function shippedProviderProbeKind(id) {
+    if (id in SHIPPED_PROVIDER_PROBE) {
+        return SHIPPED_PROVIDER_PROBE[id];
+    }
+    return null;
+}
+export function classifyTransportProbe(input) {
+    if (input.status === "ready" ||
+        input.status === "missing" ||
+        input.status === "failed" ||
+        input.status === "unknown") {
+        return { status: input.status, evidence: input.evidence ?? null };
+    }
+    const present = input.present ?? input.available;
+    if (present === false) {
+        return { status: "missing", evidence: input.evidence ?? null };
+    }
+    if (present === true && input.reachable === false) {
+        return { status: "failed", evidence: input.evidence ?? null };
+    }
+    if (present === true) {
+        return { status: "ready", evidence: input.evidence ?? null };
+    }
+    return { status: "unknown", evidence: input.evidence ?? null };
+}
+export function mcpServerIdsFromConfig(raw) {
+    if (!isPlainObject(raw))
+        return [];
+    const servers = raw.mcpServers;
+    if (!isPlainObject(servers))
+        return [];
+    return Object.keys(servers);
+}
+export function selectRegisteredMcpServers(configuredServerIds, registered = SHIPPED_MIDDLEWARE_PROVIDERS) {
+    return uniqueStrings(configuredServerIds).filter((id) => registered.includes(id));
+}
+export function probeShippedProviderReadiness(id, input = {}) {
+    const classified = classifyTransportProbe({
+        kind: shippedProviderProbeKind(id) ?? undefined,
+        ...input,
+    });
+    return {
+        status: classified.status,
+        capability: shippedProviderCapability(id),
+        evidence: classified.evidence ?? null,
+    };
+}
+export function probeSmartSearchReadiness(input = {}) {
+    return probeShippedProviderReadiness(SMART_SEARCH_PROVIDER, input);
+}
+export function applyShippedProviderReadiness(extras, id, readiness) {
+    const current = readMiddlewareProviders(extras);
+    if (!current.registered.includes(id)) {
+        extras.middleware_providers = applyProviderHealth(current, extras);
+        return extras.middleware_providers;
+    }
+    const next = {
+        ...current,
+        readiness: {
+            ...current.readiness,
+            [id]: {
+                ...readiness,
+                capability: shippedProviderCapability(id),
+            },
+        },
+    };
+    extras.middleware_providers = applyProviderHealth(next, extras);
+    return extras.middleware_providers;
+}
+export function applySmartSearchReadiness(extras, readiness) {
+    return applyShippedProviderReadiness(extras, SMART_SEARCH_PROVIDER, readiness);
+}
+export function normalizeEventBridge(raw) {
+    if (raw === undefined || raw === null)
+        return defaultEventBridge();
+    if (!isPlainObject(raw)) {
+        throw new KernelError("INVALID_REQUEST", "event_bridge must be a JSON object");
+    }
+    const subscriptionsIn = raw.subscriptions;
+    const subscriptions = [];
+    if (subscriptionsIn !== undefined && subscriptionsIn !== null) {
+        if (!Array.isArray(subscriptionsIn)) {
+            throw new KernelError("INVALID_REQUEST", "event_bridge.subscriptions must be an array");
+        }
+        for (const item of subscriptionsIn) {
+            if (!isPlainObject(item)) {
+                throw new KernelError("INVALID_REQUEST", "event_bridge.subscriptions[] must be objects");
+            }
+            const sub = {
+                event: requireId(item.event, "event_bridge.subscriptions[].event"),
+                module: requireId(item.module, "event_bridge.subscriptions[].module"),
+            };
+            if (!subscriptions.some((existing) => existing.event === sub.event && existing.module === sub.module)) {
+                subscriptions.push(sub);
+            }
+        }
+    }
+    const lastRaw = raw.last_event;
+    let lastEvent;
+    if (lastRaw !== undefined && lastRaw !== null) {
+        if (!isPlainObject(lastRaw)) {
+            throw new KernelError("INVALID_REQUEST", "event_bridge.last_event must be an object");
+        }
+        lastEvent = {
+            event: requireId(lastRaw.event, "event_bridge.last_event.event"),
+            at: typeof lastRaw.at === "string" && lastRaw.at.trim() !== ""
+                ? lastRaw.at
+                : new Date().toISOString(),
+            source: typeof lastRaw.source === "string" && lastRaw.source.trim() !== ""
+                ? lastRaw.source
+                : "cursor-hooks",
+            delivered: uniqueStrings(asStringArray(lastRaw.delivered)),
+            skipped: uniqueStrings(asStringArray(lastRaw.skipped)),
+        };
+    }
+    return {
+        schema_version: STAGE6_SCHEMA_VERSION,
+        source: STAGE6_SOURCE,
+        subscriptions,
+        ...(lastEvent ? { last_event: lastEvent } : {}),
+    };
+}
+export function normalizeMiddlewareProviders(raw) {
+    if (raw === undefined || raw === null)
+        return defaultMiddlewareProviders();
+    if (!isPlainObject(raw)) {
+        throw new KernelError("INVALID_REQUEST", "middleware_providers must be a JSON object");
+    }
+    const defaults = defaultMiddlewareProviders();
+    const registered = uniqueStrings([
+        ...defaults.registered,
+        ...asStringArray(raw.registered),
+    ]);
+    const required = uniqueStrings(asStringArray(raw.required)).filter((name) => registered.includes(name));
+    const active = uniqueStrings(asStringArray(raw.active)).filter((name) => registered.includes(name));
+    const degraded = uniqueStrings(asStringArray(raw.degraded));
+    const readiness = {
+        ...defaults.readiness,
+    };
+    if (isPlainObject(raw.readiness)) {
+        for (const [name, value] of Object.entries(raw.readiness)) {
+            if (!isPlainObject(value))
+                continue;
+            const status = parseReadinessStatus(value.status);
+            readiness[name] = {
+                status,
+                capability: typeof value.capability === "string" && value.capability.trim() !== ""
+                    ? value.capability
+                    : name === SMART_SEARCH_PROVIDER
+                        ? EXTERNAL_KNOWLEDGE_CAPABILITY
+                        : "unknown",
+                evidence: typeof value.evidence === "string" ? value.evidence : null,
+            };
+        }
+    }
+    return {
+        schema_version: STAGE6_SCHEMA_VERSION,
+        source: STAGE6_SOURCE,
+        registered,
+        required: required.length > 0 ? required : [...defaults.required],
+        active,
+        degraded,
+        readiness,
+    };
+}
+export function normalizeCapabilityRouter(raw) {
+    if (raw === undefined || raw === null)
+        return defaultCapabilityRouter();
+    if (!isPlainObject(raw)) {
+        throw new KernelError("INVALID_REQUEST", "capability_router must be a JSON object");
+    }
+    const forbidden = [
+        ...OPTIONAL_CODE_INTEL_PROVIDERS,
+        "fast_context_search",
+        "codegraph_explore",
+        "codegraph_search",
+        "codegraph_callers",
+    ];
+    for (const key of Object.keys(raw)) {
+        if (forbidden.includes(key)) {
+            throw new KernelError("INVALID_REQUEST", "capability_router must not bind Optional tool names");
+        }
+    }
+    const next = {
+        schema_version: STAGE6_SCHEMA_VERSION,
+        source: STAGE6_SOURCE,
+    };
+    for (const intent of RETRIEVAL_INTENTS) {
+        if (raw[intent] !== false) {
+            next[intent] = true;
+        }
+    }
+    return next;
+}
+export function readEventBridge(extras) {
+    return normalizeEventBridge(extras.event_bridge);
+}
+export function readMiddlewareProviders(extras) {
+    return normalizeMiddlewareProviders(extras.middleware_providers);
+}
+export function readCapabilityRouter(extras) {
+    return normalizeCapabilityRouter(extras.capability_router);
+}
+export function requiredCapabilities(extras) {
+    return uniqueStrings(asStringArray(extras.required_capabilities));
+}
+export function externalKnowledgeReady(providers) {
+    const readiness = providers.readiness[SMART_SEARCH_PROVIDER];
+    return readiness?.status === "ready";
+}
+export function normalizeStage6InExtras(extras) {
+    extras.event_bridge = normalizeEventBridge(extras.event_bridge);
+    extras.capability_router = normalizeCapabilityRouter(extras.capability_router);
+    const incoming = extras.hook_event;
+    if (isPlainObject(incoming) && typeof incoming.event === "string") {
+        recordHookEvent(extras, {
+            event: incoming.event,
+            source: typeof incoming.source === "string" ? incoming.source : undefined,
+            at: typeof incoming.at === "string" ? incoming.at : undefined,
+        });
+        delete extras.hook_event;
+    }
+    extras.middleware_providers = normalizeMiddlewareProviders(extras.middleware_providers);
+    if (isPlainObject(extras.middleware_probes)) {
+        applyMiddlewareProbes(extras, extras.middleware_probes);
+        delete extras.middleware_probes;
+    }
+    if (isPlainObject(extras.smart_search_probe)) {
+        const probeStatus = extras.smart_search_probe.status;
+        applySmartSearchReadiness(extras, probeSmartSearchReadiness({
+            available: extras.smart_search_probe.available === true
+                ? true
+                : extras.smart_search_probe.available === false
+                    ? false
+                    : undefined,
+            status: probeStatus === "ready" ||
+                probeStatus === "missing" ||
+                probeStatus === "failed" ||
+                probeStatus === "unknown"
+                ? probeStatus
+                : undefined,
+            evidence: typeof extras.smart_search_probe.evidence === "string"
+                ? extras.smart_search_probe.evidence
+                : null,
+        }));
+        delete extras.smart_search_probe;
+    }
+    extras.middleware_providers = applyProviderHealth(extras.middleware_providers, extras);
+}
+export function assertStage6ForPhase(extras, phase) {
+    if (phase === "create" || phase === "patch")
+        return;
+    const providers = readMiddlewareProviders(extras);
+    const needsExternal = requiredCapabilities(extras).includes(EXTERNAL_KNOWLEDGE_CAPABILITY);
+    if (!needsExternal)
+        return;
+    if (externalKnowledgeReady(providers))
+        return;
+    if (extras.external_knowledge_policy === "degrade") {
+        extras.profile_health = "degraded";
+        return;
+    }
+    throw new KernelError("INVALID_TRANSITION", "external-knowledge required but smart-search Provider is not ready");
+}
+export function normalizeStage6InExtrasAndAssert(extras, phase) {
+    normalizeStage6InExtras(extras);
+    assertStage6ForPhase(extras, phase);
+}
+function applyMiddlewareProbes(extras, probes) {
+    const current = readMiddlewareProviders(extras);
+    for (const [id, value] of Object.entries(probes)) {
+        if (!current.registered.includes(id))
+            continue;
+        if (!isPlainObject(value))
+            continue;
+        applyShippedProviderReadiness(extras, id, probeShippedProviderReadiness(id, {
+            available: value.available === true
+                ? true
+                : value.available === false
+                    ? false
+                    : undefined,
+            present: value.present === true
+                ? true
+                : value.present === false
+                    ? false
+                    : undefined,
+            reachable: value.reachable === true
+                ? true
+                : value.reachable === false
+                    ? false
+                    : undefined,
+            status: value.status === "ready" ||
+                value.status === "missing" ||
+                value.status === "failed" ||
+                value.status === "unknown"
+                ? value.status
+                : undefined,
+            evidence: typeof value.evidence === "string" ? value.evidence : null,
+        }));
+    }
+}
+function applyProviderHealth(providers, extras) {
+    const degraded = uniqueStrings([...providers.degraded]);
+    for (const id of providers.required) {
+        const row = providers.readiness[id];
+        if (row && row.status !== "ready" && row.status !== "unknown") {
+            if (!degraded.includes(id))
+                degraded.push(id);
+            extras.profile_health = "degraded";
+        }
+    }
+    const missing = uniqueStrings(asStringArray(extras.ondemand_required_missing));
+    if (missing.includes(EXTERNAL_KNOWLEDGE_CAPABILITY) ||
+        missing.includes(SMART_SEARCH_PROVIDER)) {
+        if (!degraded.includes(SMART_SEARCH_PROVIDER)) {
+            degraded.push(SMART_SEARCH_PROVIDER);
+        }
+        extras.profile_health = "degraded";
+    }
+    return { ...providers, degraded };
+}
+function parseReadinessStatus(value) {
+    if (value === "ready" ||
+        value === "missing" ||
+        value === "failed" ||
+        value === "unknown") {
+        return value;
+    }
+    return "unknown";
+}
+function asStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => typeof item === "string");
+}
+function uniqueStrings(values) {
+    const out = [];
+    for (const value of values) {
+        if (typeof value !== "string")
+            continue;
+        const id = value.trim();
+        if (!id || out.includes(id))
+            continue;
+        out.push(id);
+    }
+    return out;
+}
+function requireId(value, field) {
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new KernelError("INVALID_REQUEST", `${field} must be a non-empty string`);
+    }
+    return value.trim();
+}
+//# sourceMappingURL=adapter-middleware.js.map