@makaio/framework 1.0.0-dev-1781022866275 → 1.0.0-dev-1781023871421

package/dist/index-Bh_Ne7LF.d.mts

@@ -0,0 +1,1008 @@
+import { z } from "zod";
+import * as _$_makaio_core0 from "@makaio/framework/core";
+import { ExtensionWarningEntry, ExtensionWarningEntrySchema } from "@makaio/framework/contracts/extension";
+
+//#region packages/kernel/src/observability/shared-schemas.d.ts
+/**
+ * Lifecycle states shared across all managed components (services and extensions).
+ *
+ * State machine:
+ * - `discovered`   — component is registered but not yet started
+ * - `initializing` — component startup is in progress
+ * - `active`       — component is running normally
+ * - `failed`       — component encountered a fatal error during startup or operation
+ * - `skipped`      — component was intentionally bypassed (e.g. feature-gated)
+ * - `stopped`      — component has been cleanly shut down
+ *
+ * Note: `importing` is intentionally absent — it is an internal coordinator
+ * detail, not an externally observable state.
+ */
+declare const ComponentStateSchema: z.ZodEnum<{
+  active: "active";
+  discovered: "discovered";
+  failed: "failed";
+  skipped: "skipped";
+  stopped: "stopped";
+  initializing: "initializing";
+}>;
+/** Inferred union of all valid component lifecycle states. */
+type ComponentState = z.infer<typeof ComponentStateSchema>;
+/**
+ * Shared identity fields present on every managed component.
+ *
+ * Both service info and extension info extend this schema so all
+ * observability consumers have a uniform identity contract.
+ */
+declare const ComponentIdentitySchema: z.ZodObject<{
+  name: z.ZodString;
+  displayName: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Full info shape shared by {@link ServiceInfoSchema} and
+ * {@link ExtensionInfoSchema} responses.
+ *
+ * Consumers that only need identity + state can accept this base type.
+ */
+declare const ComponentInfoSchema: z.ZodObject<{
+  name: z.ZodString;
+  displayName: z.ZodString;
+  state: z.ZodEnum<{
+    active: "active";
+    discovered: "discovered";
+    failed: "failed";
+    skipped: "skipped";
+    stopped: "stopped";
+    initializing: "initializing";
+  }>;
+  error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Inferred type for a generic managed component info record. */
+type ComponentInfo = z.infer<typeof ComponentInfoSchema>;
+/**
+ * Info shape for a managed service.
+ *
+ * Extends {@link ComponentInfoSchema} with a `critical` flag that signals
+ * whether a service failure should abort the boot sequence.
+ */
+declare const ServiceInfoSchema: z.ZodObject<{
+  name: z.ZodString;
+  displayName: z.ZodString;
+  state: z.ZodEnum<{
+    active: "active";
+    discovered: "discovered";
+    failed: "failed";
+    skipped: "skipped";
+    stopped: "stopped";
+    initializing: "initializing";
+  }>;
+  error: z.ZodOptional<z.ZodString>;
+  critical: z.ZodBoolean;
+}, z.core.$strip>;
+/** Inferred type for a platform service info record. */
+type ServiceInfo = z.infer<typeof ServiceInfoSchema>;
+/**
+ * Info shape for a managed extension.
+ *
+ * Extends {@link ComponentInfoSchema} with extension-specific fields for
+ * surface affinity and enable/disable state.
+ */
+declare const ExtensionInfoSchema: z.ZodObject<{
+  name: z.ZodString;
+  displayName: z.ZodString;
+  state: z.ZodEnum<{
+    active: "active";
+    discovered: "discovered";
+    failed: "failed";
+    skipped: "skipped";
+    stopped: "stopped";
+    initializing: "initializing";
+  }>;
+  error: z.ZodOptional<z.ZodString>;
+  surface: z.ZodOptional<z.ZodEnum<{
+    any: "any";
+    interactive: "interactive";
+    headless: "headless";
+  }>>;
+  enabled: z.ZodBoolean;
+  browser: z.ZodOptional<z.ZodObject<{
+    entrypoint: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Inferred type for a managed extension info record. */
+type ExtensionInfo = z.infer<typeof ExtensionInfoSchema>;
+//#endregion
+//#region packages/kernel/src/observability/extension-namespace.d.ts
+/**
+ * Extension namespace for bus operations.
+ */
+declare const ExtensionNamespace: _$_makaio_core0.BusNamespaceDefinition<"kernel:extension", {
+  /**
+   * Signal that an extension has transitioned between lifecycle states.
+   *
+   * Subject: `kernel:extension.stateChanged`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted by the ExtensionCoordinator whenever an extension moves
+   * from one lifecycle state to another. Observers (e.g. debug logging,
+   * boot progress UI, adapter subsystem) subscribe to track extension health.
+   * @param name - Unique machine-readable extension identifier.
+   * @param displayName - Human-readable extension label.
+   * @param from - Previous lifecycle state.
+   * @param to - New lifecycle state.
+   * @param error - Human-readable error message when transitioning to `'failed'`.
+   * @param contributes - Static flags indicating which contribution surfaces the
+   *   extension declares. Absent when the extension declares no contributions.
+   *   Subsystems use these flags as declarative bus filters to react only to
+   *   relevant extensions (e.g. `{ 'contributes.adapters': true, to: 'active' }`).
+   */
+  stateChanged: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    from: z.ZodEnum<{
+      active: "active";
+      discovered: "discovered";
+      failed: "failed";
+      skipped: "skipped";
+      stopped: "stopped";
+      initializing: "initializing";
+    }>;
+    to: z.ZodEnum<{
+      active: "active";
+      discovered: "discovered";
+      failed: "failed";
+      skipped: "skipped";
+      stopped: "stopped";
+      initializing: "initializing";
+    }>;
+    error: z.ZodOptional<z.ZodString>;
+    contributes: z.ZodOptional<z.ZodObject<{
+      adapters: z.ZodBoolean;
+      tools: z.ZodBoolean;
+      triggers: z.ZodBoolean;
+      providers: z.ZodBoolean;
+      clients: z.ZodBoolean;
+      ui: z.ZodBoolean;
+      storage: z.ZodBoolean;
+      sessionEventActions: z.ZodBoolean;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+  /**
+   * Request the current state of all registered extensions.
+   *
+   * Subject: `kernel:extension.list`
+   * Type: RPC (request/response)
+   * Purpose: Allows late subscribers (e.g. CLI status commands, debug panels)
+   * to retrieve the full extension list with current lifecycle states without
+   * waiting for incremental `stateChanged` events.
+   */
+  list: {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      extensions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        state: z.ZodEnum<{
+          active: "active";
+          discovered: "discovered";
+          failed: "failed";
+          skipped: "skipped";
+          stopped: "stopped";
+          initializing: "initializing";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodEnum<{
+          any: "any";
+          interactive: "interactive";
+          headless: "headless";
+        }>>;
+        enabled: z.ZodBoolean;
+        browser: z.ZodOptional<z.ZodObject<{
+          entrypoint: z.ZodString;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Request info for a single extension by name.
+   *
+   * Subject: `kernel:extension.get`
+   * Type: RPC (request/response)
+   * Purpose: Allows targeted lookup of a single extension's state and metadata.
+   * Returns `{ extension: null }` when no extension with the given name is registered.
+   * @param name - Unique extension identifier to look up.
+   */
+  get: {
+    request: z.ZodObject<{
+      name: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      extension: z.ZodNullable<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        state: z.ZodEnum<{
+          active: "active";
+          discovered: "discovered";
+          failed: "failed";
+          skipped: "skipped";
+          stopped: "stopped";
+          initializing: "initializing";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodEnum<{
+          any: "any";
+          interactive: "interactive";
+          headless: "headless";
+        }>>;
+        enabled: z.ZodBoolean;
+        browser: z.ZodOptional<z.ZodObject<{
+          entrypoint: z.ZodString;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Enable or disable an extension at runtime.
+   *
+   * Subject: `kernel:extension.setEnabled`
+   * Type: RPC (request/response)
+   * Purpose: Allows the user or platform config to toggle an extension without
+   * a full restart. The coordinator re-enters the load path on enable, or runs
+   * cleanup and transitions to `stopped` on disable.
+   * @param name - Unique extension identifier to toggle.
+   * @param enabled - Target enabled state.
+   */
+  setEnabled: {
+    request: z.ZodObject<{
+      name: z.ZodString;
+      enabled: z.ZodBoolean;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      success: z.ZodBoolean;
+    }, z.core.$strip>;
+  };
+  /**
+   * Request active extension-owned provider and client contributions.
+   *
+   * Subject: `kernel:extension.contributions.catalog`
+   * Type: RPC (request/response)
+   * Purpose: Exposes boot/runtime contribution metadata through a typed bus seam
+   * without passing the coordinator object through lifecycle phase payloads.
+   */
+  'contributions.catalog': {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      providers: z.ZodArray<z.ZodObject<{
+        packageName: z.ZodString;
+        definition: z.ZodObject<{
+          id: z.ZodString;
+          name: z.ZodString;
+          description: z.ZodOptional<z.ZodString>;
+          endpoints: z.ZodOptional<z.ZodObject<{
+            anthropic: z.ZodOptional<z.ZodString>;
+            openai: z.ZodOptional<z.ZodString>;
+          }, z.core.$strip>>;
+          defaultModel: z.ZodOptional<z.ZodString>;
+          fastModel: z.ZodOptional<z.ZodString>;
+          primaryTestModel: z.ZodOptional<z.ZodString>;
+          secondaryTestModel: z.ZodOptional<z.ZodString>;
+          availableModels: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            friendlyName: z.ZodOptional<z.ZodString>;
+            family: z.ZodOptional<z.ZodString>;
+            contextWindowSize: z.ZodNumber;
+            labId: z.ZodString;
+            supportedReasoningLevels: z.ZodOptional<z.ZodObject<{
+              none: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+              low: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+              medium: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+              high: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+              'extra-high': z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            }, z.core.$strip>>;
+            metadata: z.ZodOptional<z.ZodObject<{
+              maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+              capabilities: z.ZodOptional<z.ZodObject<{
+                vision: z.ZodOptional<z.ZodBoolean>;
+                toolCalling: z.ZodOptional<z.ZodBoolean>;
+                parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+                structuredOutput: z.ZodOptional<z.ZodBoolean>;
+                pdfUpload: z.ZodOptional<z.ZodBoolean>;
+                speechToText: z.ZodOptional<z.ZodObject<{
+                  modes: z.ZodArray<z.ZodEnum<{
+                    batch: "batch";
+                    streaming: "streaming";
+                  }>>;
+                  vocabularyBiasing: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>;
+                textToSpeech: z.ZodOptional<z.ZodObject<{
+                  modes: z.ZodArray<z.ZodEnum<{
+                    streaming: "streaming";
+                    buffered: "buffered";
+                  }>>;
+                  voiceSelection: z.ZodOptional<z.ZodBoolean>;
+                  voiceInstructions: z.ZodOptional<z.ZodBoolean>;
+                  outputFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>>;
+              }, z.core.$strip>>;
+              pricing: z.ZodOptional<z.ZodObject<{
+                token: z.ZodOptional<z.ZodObject<{
+                  inputPerMillion: z.ZodNumber;
+                  inputCachedPerMillion: z.ZodOptional<z.ZodNumber>;
+                  cacheWritePerMillion: z.ZodOptional<z.ZodNumber>;
+                  outputPerMillion: z.ZodNumber;
+                }, z.core.$strip>>;
+                request: z.ZodOptional<z.ZodObject<{
+                  multiplier: z.ZodNumber;
+                }, z.core.$strip>>;
+              }, z.core.$strip>>;
+              includedInSubscription: z.ZodOptional<z.ZodBoolean>;
+              description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>>;
+          defaultModelFilterMode: z.ZodOptional<z.ZodEnum<{
+            allowlist: "allowlist";
+            "show-all": "show-all";
+          }>>;
+          credentialEnvVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strip>;
+      }, z.core.$strip>>;
+      clients: z.ZodArray<z.ZodObject<{
+        packageName: z.ZodString;
+        definition: z.ZodObject<{
+          id: z.ZodString;
+          name: z.ZodString;
+          version: z.ZodString;
+          description: z.ZodOptional<z.ZodString>;
+          binary: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            supportedVersions: z.ZodString;
+          }, z.core.$strict>>;
+          nativeTools: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            friendlyName: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            category: z.ZodOptional<z.ZodString>;
+            capabilities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+              tag: z.ZodString;
+              description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+          }, z.core.$strip>>>;
+          defaultApprovalPolicy: z.ZodEnum<{
+            reject: "reject";
+            "always-ask": "always-ask";
+            "full-access": "full-access";
+          }>;
+          logSources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            glob: z.ZodOptional<z.ZodString>;
+          }, z.core.$strip>>>;
+          defaultProviderId: z.ZodOptional<z.ZodString>;
+          runtimeCapabilities: z.ZodPipe<z.ZodOptional<z.ZodObject<{
+            supportsHooks: z.ZodDefault<z.ZodBoolean>;
+            supportsStatusline: z.ZodDefault<z.ZodBoolean>;
+            supportsSupervisorLaunch: z.ZodDefault<z.ZodBoolean>;
+            supportsManagedBinary: z.ZodDefault<z.ZodBoolean>;
+            hookEvents: z.ZodDefault<z.ZodArray<z.ZodObject<{
+              name: z.ZodString;
+              frameworkSubject: z.ZodOptional<z.ZodString>;
+              mode: z.ZodDefault<z.ZodEnum<{
+                request: "request";
+                event: "event";
+              }>>;
+            }, z.core.$strip>>>;
+          }, z.core.$strip>>, z.ZodTransform<{
+            supportsHooks: boolean;
+            supportsStatusline: boolean;
+            supportsSupervisorLaunch: boolean;
+            supportsManagedBinary: boolean;
+            hookEvents: {
+              name: string;
+              mode: "request" | "event";
+              frameworkSubject?: string | undefined;
+            }[];
+          }, {
+            supportsHooks: boolean;
+            supportsStatusline: boolean;
+            supportsSupervisorLaunch: boolean;
+            supportsManagedBinary: boolean;
+            hookEvents: {
+              name: string;
+              mode: "request" | "event";
+              frameworkSubject?: string | undefined;
+            }[];
+          } | undefined>>;
+          managedInstall: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"npm">;
+            package: z.ZodString;
+            version: z.ZodString;
+          }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"signed-binary-bucket">;
+            version: z.ZodString;
+            config: z.ZodObject<{
+              baseUrl: z.ZodString;
+              manifestPathTemplate: z.ZodString;
+              manifestSignaturePathTemplate: z.ZodString;
+              publicKeyUrl: z.ZodString;
+              publicKeyFingerprint: z.ZodString;
+              binaryPathTemplate: z.ZodString;
+              platforms: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strip>;
+          }, z.core.$strip>], "type">>;
+          versionCommand: z.ZodOptional<z.ZodObject<{
+            executable: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+              default: z.ZodString;
+              darwin: z.ZodOptional<z.ZodString>;
+              linux: z.ZodOptional<z.ZodString>;
+              win32: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>;
+            args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+          }, z.core.$strict>>;
+          postInstall: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodString;
+            payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+          }, z.core.$strip>>;
+          configIsolation: z.ZodOptional<z.ZodObject<{
+            envVar: z.ZodString;
+            defaultPath: z.ZodString;
+            pathKind: z.ZodDefault<z.ZodEnum<{
+              file: "file";
+              directory: "directory";
+            }>>;
+          }, z.core.$strip>>;
+        }, z.core.$strict>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Signal that an extension's enabled state has changed.
+   *
+   * Subject: `kernel:extension.enabledChanged`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted after a successful `kernel:extension.setEnabled` call so
+   * observers can react to enable/disable changes without polling.
+   * @param name - Unique extension identifier.
+   * @param enabled - New enabled state.
+   */
+  enabledChanged: z.ZodObject<{
+    name: z.ZodString;
+    enabled: z.ZodBoolean;
+  }, z.core.$strip>;
+  /**
+   * Request the current health warnings for all (or a specific) extension.
+   *
+   * Subject: `kernel:extension.warnings.list`
+   * Type: RPC (request/response)
+   * Purpose: Allows late subscribers (e.g. notification panels, CLI health
+   * commands) to retrieve a snapshot of active extension warnings without
+   * waiting for incremental `warnings.changed` events.
+   * @param extensionName - Optional extension name to filter results.
+   *   When omitted, entries for all extensions with active warnings are returned.
+   */
+  'warnings.list': {
+    request: z.ZodObject<{
+      extensionName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      entries: z.ZodArray<z.ZodObject<{
+        extensionName: z.ZodString;
+        warnings: z.ZodArray<z.ZodObject<{
+          severity: z.ZodEnum<{
+            degraded: "degraded";
+            info: "info";
+            recommended: "recommended";
+          }>;
+          title: z.ZodString;
+          message: z.ZodString;
+          action: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"configure-integration">;
+            clientId: z.ZodString;
+            bundle: z.ZodString;
+          }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"install-extension">;
+            extensionName: z.ZodString;
+          }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"open-url">;
+            url: z.ZodString;
+          }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"run-command">;
+            command: z.ZodString;
+          }, z.core.$strip>], "kind">>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Snapshot of an extension's health warnings after a health-check run.
+   *
+   * Subject: `kernel:extension.warnings.changed`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted by the ExtensionCoordinator after every health-check run,
+   * regardless of whether the warning set actually changed. This unconditional
+   * emission simplifies subscriber logic — consumers always receive the latest
+   * snapshot without needing to diff against a prior state.
+   * @param extensionName - Unique machine-readable identifier of the extension.
+   * @param warnings - Full set of active health warnings; an empty array signals no active warnings.
+   */
+  'warnings.changed': z.ZodObject<{
+    extensionName: z.ZodString;
+    warnings: z.ZodArray<z.ZodObject<{
+      severity: z.ZodEnum<{
+        degraded: "degraded";
+        info: "info";
+        recommended: "recommended";
+      }>;
+      title: z.ZodString;
+      message: z.ZodString;
+      action: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"configure-integration">;
+        clientId: z.ZodString;
+        bundle: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"install-extension">;
+        extensionName: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"open-url">;
+        url: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"run-command">;
+        command: z.ZodString;
+      }, z.core.$strip>], "kind">>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+}>;
+/**
+ * Extension subjects for type-safe bus operations.
+ *
+ * Subjects:
+ * - `stateChanged`        — event: emitted when an extension transitions between lifecycle states
+ * - `list`                — RPC: retrieve all registered extensions and their current state
+ * - `get`                 — RPC: retrieve a single extension's info by name
+ * - `setEnabled`          — RPC: enable or disable an extension at runtime
+ * - `enabledChanged`      — event: emitted when an extension's enabled flag changes
+ * - `warnings.list`       — RPC: retrieve active health warnings for all (or one) extension
+ * - `warnings.changed`    — event: emitted after every health-check run with the latest warning snapshot
+ * @example
+ * ```typescript
+ * ExtensionSubjects.stateChanged
+ * ExtensionSubjects.list
+ * ExtensionSubjects.warnings.list
+ * ExtensionSubjects.warnings.changed
+ * ```
+ */
+declare const ExtensionSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"kernel:extension", {
+  /**
+   * Signal that an extension has transitioned between lifecycle states.
+   *
+   * Subject: `kernel:extension.stateChanged`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted by the ExtensionCoordinator whenever an extension moves
+   * from one lifecycle state to another. Observers (e.g. debug logging,
+   * boot progress UI, adapter subsystem) subscribe to track extension health.
+   * @param name - Unique machine-readable extension identifier.
+   * @param displayName - Human-readable extension label.
+   * @param from - Previous lifecycle state.
+   * @param to - New lifecycle state.
+   * @param error - Human-readable error message when transitioning to `'failed'`.
+   * @param contributes - Static flags indicating which contribution surfaces the
+   *   extension declares. Absent when the extension declares no contributions.
+   *   Subsystems use these flags as declarative bus filters to react only to
+   *   relevant extensions (e.g. `{ 'contributes.adapters': true, to: 'active' }`).
+   */
+  stateChanged: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    from: z.ZodEnum<{
+      active: "active";
+      discovered: "discovered";
+      failed: "failed";
+      skipped: "skipped";
+      stopped: "stopped";
+      initializing: "initializing";
+    }>;
+    to: z.ZodEnum<{
+      active: "active";
+      discovered: "discovered";
+      failed: "failed";
+      skipped: "skipped";
+      stopped: "stopped";
+      initializing: "initializing";
+    }>;
+    error: z.ZodOptional<z.ZodString>;
+    contributes: z.ZodOptional<z.ZodObject<{
+      adapters: z.ZodBoolean;
+      tools: z.ZodBoolean;
+      triggers: z.ZodBoolean;
+      providers: z.ZodBoolean;
+      clients: z.ZodBoolean;
+      ui: z.ZodBoolean;
+      storage: z.ZodBoolean;
+      sessionEventActions: z.ZodBoolean;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+  /**
+   * Request the current state of all registered extensions.
+   *
+   * Subject: `kernel:extension.list`
+   * Type: RPC (request/response)
+   * Purpose: Allows late subscribers (e.g. CLI status commands, debug panels)
+   * to retrieve the full extension list with current lifecycle states without
+   * waiting for incremental `stateChanged` events.
+   */
+  list: {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      extensions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        state: z.ZodEnum<{
+          active: "active";
+          discovered: "discovered";
+          failed: "failed";
+          skipped: "skipped";
+          stopped: "stopped";
+          initializing: "initializing";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodEnum<{
+          any: "any";
+          interactive: "interactive";
+          headless: "headless";
+        }>>;
+        enabled: z.ZodBoolean;
+        browser: z.ZodOptional<z.ZodObject<{
+          entrypoint: z.ZodString;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Request info for a single extension by name.
+   *
+   * Subject: `kernel:extension.get`
+   * Type: RPC (request/response)
+   * Purpose: Allows targeted lookup of a single extension's state and metadata.
+   * Returns `{ extension: null }` when no extension with the given name is registered.
+   * @param name - Unique extension identifier to look up.
+   */
+  get: {
+    request: z.ZodObject<{
+      name: z.ZodString;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      extension: z.ZodNullable<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        state: z.ZodEnum<{
+          active: "active";
+          discovered: "discovered";
+          failed: "failed";
+          skipped: "skipped";
+          stopped: "stopped";
+          initializing: "initializing";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodEnum<{
+          any: "any";
+          interactive: "interactive";
+          headless: "headless";
+        }>>;
+        enabled: z.ZodBoolean;
+        browser: z.ZodOptional<z.ZodObject<{
+          entrypoint: z.ZodString;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Enable or disable an extension at runtime.
+   *
+   * Subject: `kernel:extension.setEnabled`
+   * Type: RPC (request/response)
+   * Purpose: Allows the user or platform config to toggle an extension without
+   * a full restart. The coordinator re-enters the load path on enable, or runs
+   * cleanup and transitions to `stopped` on disable.
+   * @param name - Unique extension identifier to toggle.
+   * @param enabled - Target enabled state.
+   */
+  setEnabled: {
+    request: z.ZodObject<{
+      name: z.ZodString;
+      enabled: z.ZodBoolean;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      success: z.ZodBoolean;
+    }, z.core.$strip>;
+  };
+  /**
+   * Request active extension-owned provider and client contributions.
+   *
+   * Subject: `kernel:extension.contributions.catalog`
+   * Type: RPC (request/response)
+   * Purpose: Exposes boot/runtime contribution metadata through a typed bus seam
+   * without passing the coordinator object through lifecycle phase payloads.
+   */
+  'contributions.catalog': {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      providers: z.ZodArray<z.ZodObject<{
+        packageName: z.ZodString;
+        definition: z.ZodObject<{
+          id: z.ZodString;
+          name: z.ZodString;
+          description: z.ZodOptional<z.ZodString>;
+          endpoints: z.ZodOptional<z.ZodObject<{
+            anthropic: z.ZodOptional<z.ZodString>;
+            openai: z.ZodOptional<z.ZodString>;
+          }, z.core.$strip>>;
+          defaultModel: z.ZodOptional<z.ZodString>;
+          fastModel: z.ZodOptional<z.ZodString>;
+          primaryTestModel: z.ZodOptional<z.ZodString>;
+          secondaryTestModel: z.ZodOptional<z.ZodString>;
+          availableModels: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            friendlyName: z.ZodOptional<z.ZodString>;
+            family: z.ZodOptional<z.ZodString>;
+            contextWindowSize: z.ZodNumber;
+            labId: z.ZodString;
+            supportedReasoningLevels: z.ZodOptional<z.ZodObject<{
+              none: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+              low: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+              medium: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+              high: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+              'extra-high': z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            }, z.core.$strip>>;
+            metadata: z.ZodOptional<z.ZodObject<{
+              maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+              capabilities: z.ZodOptional<z.ZodObject<{
+                vision: z.ZodOptional<z.ZodBoolean>;
+                toolCalling: z.ZodOptional<z.ZodBoolean>;
+                parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+                structuredOutput: z.ZodOptional<z.ZodBoolean>;
+                pdfUpload: z.ZodOptional<z.ZodBoolean>;
+                speechToText: z.ZodOptional<z.ZodObject<{
+                  modes: z.ZodArray<z.ZodEnum<{
+                    batch: "batch";
+                    streaming: "streaming";
+                  }>>;
+                  vocabularyBiasing: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>;
+                textToSpeech: z.ZodOptional<z.ZodObject<{
+                  modes: z.ZodArray<z.ZodEnum<{
+                    streaming: "streaming";
+                    buffered: "buffered";
+                  }>>;
+                  voiceSelection: z.ZodOptional<z.ZodBoolean>;
+                  voiceInstructions: z.ZodOptional<z.ZodBoolean>;
+                  outputFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>>;
+              }, z.core.$strip>>;
+              pricing: z.ZodOptional<z.ZodObject<{
+                token: z.ZodOptional<z.ZodObject<{
+                  inputPerMillion: z.ZodNumber;
+                  inputCachedPerMillion: z.ZodOptional<z.ZodNumber>;
+                  cacheWritePerMillion: z.ZodOptional<z.ZodNumber>;
+                  outputPerMillion: z.ZodNumber;
+                }, z.core.$strip>>;
+                request: z.ZodOptional<z.ZodObject<{
+                  multiplier: z.ZodNumber;
+                }, z.core.$strip>>;
+              }, z.core.$strip>>;
+              includedInSubscription: z.ZodOptional<z.ZodBoolean>;
+              description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+          }, z.core.$strip>>>;
+          defaultModelFilterMode: z.ZodOptional<z.ZodEnum<{
+            allowlist: "allowlist";
+            "show-all": "show-all";
+          }>>;
+          credentialEnvVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strip>;
+      }, z.core.$strip>>;
+      clients: z.ZodArray<z.ZodObject<{
+        packageName: z.ZodString;
+        definition: z.ZodObject<{
+          id: z.ZodString;
+          name: z.ZodString;
+          version: z.ZodString;
+          description: z.ZodOptional<z.ZodString>;
+          binary: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            supportedVersions: z.ZodString;
+          }, z.core.$strict>>;
+          nativeTools: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            friendlyName: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            category: z.ZodOptional<z.ZodString>;
+            capabilities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+              tag: z.ZodString;
+              description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+          }, z.core.$strip>>>;
+          defaultApprovalPolicy: z.ZodEnum<{
+            reject: "reject";
+            "always-ask": "always-ask";
+            "full-access": "full-access";
+          }>;
+          logSources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            glob: z.ZodOptional<z.ZodString>;
+          }, z.core.$strip>>>;
+          defaultProviderId: z.ZodOptional<z.ZodString>;
+          runtimeCapabilities: z.ZodPipe<z.ZodOptional<z.ZodObject<{
+            supportsHooks: z.ZodDefault<z.ZodBoolean>;
+            supportsStatusline: z.ZodDefault<z.ZodBoolean>;
+            supportsSupervisorLaunch: z.ZodDefault<z.ZodBoolean>;
+            supportsManagedBinary: z.ZodDefault<z.ZodBoolean>;
+            hookEvents: z.ZodDefault<z.ZodArray<z.ZodObject<{
+              name: z.ZodString;
+              frameworkSubject: z.ZodOptional<z.ZodString>;
+              mode: z.ZodDefault<z.ZodEnum<{
+                request: "request";
+                event: "event";
+              }>>;
+            }, z.core.$strip>>>;
+          }, z.core.$strip>>, z.ZodTransform<{
+            supportsHooks: boolean;
+            supportsStatusline: boolean;
+            supportsSupervisorLaunch: boolean;
+            supportsManagedBinary: boolean;
+            hookEvents: {
+              name: string;
+              mode: "request" | "event";
+              frameworkSubject?: string | undefined;
+            }[];
+          }, {
+            supportsHooks: boolean;
+            supportsStatusline: boolean;
+            supportsSupervisorLaunch: boolean;
+            supportsManagedBinary: boolean;
+            hookEvents: {
+              name: string;
+              mode: "request" | "event";
+              frameworkSubject?: string | undefined;
+            }[];
+          } | undefined>>;
+          managedInstall: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"npm">;
+            package: z.ZodString;
+            version: z.ZodString;
+          }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"signed-binary-bucket">;
+            version: z.ZodString;
+            config: z.ZodObject<{
+              baseUrl: z.ZodString;
+              manifestPathTemplate: z.ZodString;
+              manifestSignaturePathTemplate: z.ZodString;
+              publicKeyUrl: z.ZodString;
+              publicKeyFingerprint: z.ZodString;
+              binaryPathTemplate: z.ZodString;
+              platforms: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strip>;
+          }, z.core.$strip>], "type">>;
+          versionCommand: z.ZodOptional<z.ZodObject<{
+            executable: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+              default: z.ZodString;
+              darwin: z.ZodOptional<z.ZodString>;
+              linux: z.ZodOptional<z.ZodString>;
+              win32: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>;
+            args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+          }, z.core.$strict>>;
+          postInstall: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodString;
+            payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+          }, z.core.$strip>>;
+          configIsolation: z.ZodOptional<z.ZodObject<{
+            envVar: z.ZodString;
+            defaultPath: z.ZodString;
+            pathKind: z.ZodDefault<z.ZodEnum<{
+              file: "file";
+              directory: "directory";
+            }>>;
+          }, z.core.$strip>>;
+        }, z.core.$strict>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Signal that an extension's enabled state has changed.
+   *
+   * Subject: `kernel:extension.enabledChanged`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted after a successful `kernel:extension.setEnabled` call so
+   * observers can react to enable/disable changes without polling.
+   * @param name - Unique extension identifier.
+   * @param enabled - New enabled state.
+   */
+  enabledChanged: z.ZodObject<{
+    name: z.ZodString;
+    enabled: z.ZodBoolean;
+  }, z.core.$strip>;
+  /**
+   * Request the current health warnings for all (or a specific) extension.
+   *
+   * Subject: `kernel:extension.warnings.list`
+   * Type: RPC (request/response)
+   * Purpose: Allows late subscribers (e.g. notification panels, CLI health
+   * commands) to retrieve a snapshot of active extension warnings without
+   * waiting for incremental `warnings.changed` events.
+   * @param extensionName - Optional extension name to filter results.
+   *   When omitted, entries for all extensions with active warnings are returned.
+   */
+  'warnings.list': {
+    request: z.ZodObject<{
+      extensionName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      entries: z.ZodArray<z.ZodObject<{
+        extensionName: z.ZodString;
+        warnings: z.ZodArray<z.ZodObject<{
+          severity: z.ZodEnum<{
+            degraded: "degraded";
+            info: "info";
+            recommended: "recommended";
+          }>;
+          title: z.ZodString;
+          message: z.ZodString;
+          action: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"configure-integration">;
+            clientId: z.ZodString;
+            bundle: z.ZodString;
+          }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"install-extension">;
+            extensionName: z.ZodString;
+          }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"open-url">;
+            url: z.ZodString;
+          }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"run-command">;
+            command: z.ZodString;
+          }, z.core.$strip>], "kind">>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Snapshot of an extension's health warnings after a health-check run.
+   *
+   * Subject: `kernel:extension.warnings.changed`
+   * Type: Event (fire-and-forget)
+   * Purpose: Emitted by the ExtensionCoordinator after every health-check run,
+   * regardless of whether the warning set actually changed. This unconditional
+   * emission simplifies subscriber logic — consumers always receive the latest
+   * snapshot without needing to diff against a prior state.
+   * @param extensionName - Unique machine-readable identifier of the extension.
+   * @param warnings - Full set of active health warnings; an empty array signals no active warnings.
+   */
+  'warnings.changed': z.ZodObject<{
+    extensionName: z.ZodString;
+    warnings: z.ZodArray<z.ZodObject<{
+      severity: z.ZodEnum<{
+        degraded: "degraded";
+        info: "info";
+        recommended: "recommended";
+      }>;
+      title: z.ZodString;
+      message: z.ZodString;
+      action: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"configure-integration">;
+        clientId: z.ZodString;
+        bundle: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"install-extension">;
+        extensionName: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"open-url">;
+        url: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"run-command">;
+        command: z.ZodString;
+      }, z.core.$strip>], "kind">>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+}>, "kernel:extension">;
+//#endregion
+export { ComponentInfoSchema as a, ExtensionInfo as c, ExtensionWarningEntrySchema as d, ServiceInfo as f, ComponentInfo as i, ExtensionInfoSchema as l, ExtensionSubjects as n, ComponentState as o, ServiceInfoSchema as p, ComponentIdentitySchema as r, ComponentStateSchema as s, ExtensionNamespace as t, ExtensionWarningEntry as u };