@makaio/framework 1.0.0-dev-1785409369816 → 1.0.0-dev-1786014320559

package/dist/{hook-responses-Dh1PWXqJ.d.mts → hook-responses-CQZIv3L3.d.mts}

@@ -1,5 +1,5 @@
+import { t as ExtensionContext } from "./extension-context-CqfddWXs.mjs";
 import { z } from "zod";
-import { MakaioBusLike } from "@makaio/framework/core";
 
 //#region core/contracts/src/version/primitives.d.ts
 /**
@@ -413,297 +413,6 @@ declare const ClientDefinitionSchema: z.ZodObject<{
 type ClientDefinitionInput = z.input<typeof ClientDefinitionSchema>;
 type ClientDefinition = z.infer<typeof ClientDefinitionSchema>;
 //#endregion
-//#region core/contracts/src/extension/extension-token.d.ts
-/**
- * Typed extension service tokens.
- *
- * Extension tokens pair a runtime extension name with the service type the
- * extension exposes. Consumers import an extension-owned token instead of
- * repeating string literals at service lookup call sites.
- */
-/**
- * Typed token for retrieving an extension service from an extension context.
- *
- * The type parameter is intentionally phantom: the runtime uses {@link name}
- * while TypeScript carries the expected service type through `getService`.
- * @typeParam T - Service type exposed by the extension.
- */
-interface ExtensionToken<T = unknown> {
-  /** Extension name registered with the runtime coordinator. */
-  readonly name: string;
-  /** Phantom marker for the token's service type. */
-  readonly __service?: T;
-}
-/**
- * Create a typed extension service token.
- * @param name - Extension name registered with the runtime coordinator.
- * @returns Frozen token carrying the extension name and service type.
- */
-declare function extensionToken<T>(name: string): ExtensionToken<T>;
-//#endregion
-//#region core/contracts/src/extension/extension-warning.d.ts
-/**
- * Discriminated union of actionable responses to an extension warning.
- *
- * Each variant carries the data the host needs to execute the action without
- * further round-trips to the extension.
- *
- * - `configure-integration` — open the integration settings for a client.
- * - `install-extension`    — prompt the user to install another extension.
- * - `open-url`             — navigate to an external or internal URL.
- * - `run-command`          — invoke a registered bus command by name.
- */
-declare const ExtensionWarningActionSchema: 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">;
-/**
- * Severity levels for an {@link ExtensionWarning}.
- *
- * - `'info'`        — informational note; the extension functions normally.
- * - `'recommended'` — a recommended configuration is missing; functionality is reduced.
- * - `'degraded'`    — the extension is operating in a degraded fallback mode.
- */
-declare const ExtensionWarningSeveritySchema: z.ZodEnum<{
-  info: "info";
-  degraded: "degraded";
-  recommended: "recommended";
-}>;
-/**
- * A single health warning emitted by a package's `checkHealth` hook.
- *
- * The host collects these after startup and may display them in the UI as
- * notification toasts or persistent status indicators.
- */
-declare const ExtensionWarningSchema: z.ZodObject<{
-  severity: z.ZodEnum<{
-    info: "info";
-    degraded: "degraded";
-    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>;
-/** Inferred TypeScript type for {@link ExtensionWarningSchema}. */
-type ExtensionWarning = z.infer<typeof ExtensionWarningSchema>;
-/** Inferred TypeScript type for {@link ExtensionWarningActionSchema}. */
-type ExtensionWarningAction = z.infer<typeof ExtensionWarningActionSchema>;
-/** Inferred TypeScript type for {@link ExtensionWarningSeveritySchema}. */
-type ExtensionWarningSeverity = z.infer<typeof ExtensionWarningSeveritySchema>;
-/**
- * Return the default user-facing label for an extension warning action.
- *
- * Kept with the action contract so every surface labels the same action kind
- * consistently without duplicating switch statements.
- * @param action - Extension warning action to label.
- * @returns Short button label for the action kind.
- */
-declare function getExtensionWarningActionLabel(action: ExtensionWarningAction): string;
-/**
- * Aggregated warning entry grouping all health warnings for a single extension.
- *
- * Used as the payload shape for `kernel:extension.warnings.list` responses and
- * `kernel:extension.warnings.changed` events so consumers receive extension identity
- * alongside the full warning array in one atomic value.
- */
-declare const ExtensionWarningEntrySchema: z.ZodObject<{
-  extensionName: z.ZodString;
-  warnings: z.ZodArray<z.ZodObject<{
-    severity: z.ZodEnum<{
-      info: "info";
-      degraded: "degraded";
-      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>;
-/** Inferred TypeScript type for {@link ExtensionWarningEntrySchema}. */
-type ExtensionWarningEntry = z.infer<typeof ExtensionWarningEntrySchema>;
-//#endregion
-//#region core/contracts/src/extension/extension-lifecycle.d.ts
-declare const extensionIdentityBrand: unique symbol;
-/**
- * Opaque extension identity minted by the runtime coordinator.
- *
- * This identity proves which loaded extension is calling runtime-owned seams
- * such as future direct channels. Extension code receives it through
- * {@link ExtensionContext.identity}; external callers cannot construct one
- * without a type assertion.
- */
-interface ExtensionIdentity {
-  /** Extension name associated with this identity. */
-  readonly extensionName: string;
-  /** Opaque brand preventing structural construction. */
-  readonly [extensionIdentityBrand]: true;
-}
-/**
- * Minimal lifecycle shape accepted as an extension service.
- *
- * BaseService satisfies this interface, but plain service classes can also
- * participate in extension startup when they expose the same lifecycle.
- */
-interface ExtensionServiceLifecycle {
-  /** Initialize the service when startup work is not constructor-owned. */
-  init?(): Promise<void> | void;
-  /** Destroy the service and release resources when teardown is required. */
-  destroy?(): Promise<void> | void;
-  /**
-   * Called after the extension reaches active state.
-   *
-   * Returns zero or more {@link ExtensionWarning} entries describing integration
-   * health issues the user may want to act on. An empty array (or omitting the
-   * hook entirely) signals that the extension is fully healthy.
-   * @returns Active health warnings, or an empty array when the extension is healthy.
-   */
-  checkHealth?(): Promise<ExtensionWarning[]> | ExtensionWarning[];
-}
-/**
- * Service shape returned by {@link MakaioExtension.create}.
- *
- * Any class that extends `BaseService` satisfies this interface structurally
- * because `BaseService` exposes the same lifecycle methods.
- */
-type ExtensionService = ExtensionServiceLifecycle;
-//#endregion
-//#region core/contracts/src/extension/extension-context.d.ts
-/**
- * Generic context provided by a host runtime when creating an extension's service.
- *
- * Contains host-agnostic runtime seams: the bus instance, extension identity,
- * extension-local data directory, machine identity, config, service lookup, and
- * lifecycle controls. Host-specific environment details belong on explicit
- * context extensions such as {@link NodeExtensionContext}.
- */
-interface ExtensionContext<TBus extends MakaioBusLike = MakaioBusLike> {
-  /** Bus instance for registering handlers and emitting events. */
-  readonly bus: TBus;
-  /** Coordinator-minted identity for the extension being created. */
-  readonly identity: ExtensionIdentity;
-  /**
-   * Per-extension writable data directory resolved by the host runtime.
-   *
-   * Use this for extension-local persistence (caches, state files, etc.).
-   */
-  readonly dataDir: string;
-  /**
-   * Stable machine identifier used for machine-scoped persistence and
-   * encryption key derivation.
-   *
-   * Resolved by the composition root (e.g., `node-machine-id`) before
-   * extensions are started.
-   */
-  readonly machineId: string;
-  /**
-   * Resolved configuration for this extension, merged from stored values and
-   * descriptor defaults. Present only when the extension declared a
-   * `configSchema` on its {@link MakaioExtension}.
-   *
-   * Extensions should parse this with their Zod schema to get typed config:
-   * ```ts
-   * const config = parseExtensionConfig(MyConfigSchema, ctx.config);
-   * ```
-   */
-  readonly config?: unknown;
-  /**
-   * Retrieve a service exposed by another active extension.
-   * @param token - Extension-owned token identifying the desired service.
-   * @returns The active service instance, or `undefined` when unavailable.
-   */
-  getService<T>(token: ExtensionToken<T>): T | undefined;
-  /**
-   * Attempt a dynamic import, returning `null` when the package is not installed.
-   *
-   * Only swallows errors caused by the package itself being absent. Transitive
-   * dependency failures and module evaluation errors are re-thrown.
-   * @typeParam T - Expected module shape (caller-asserted, not runtime-verified).
-   * @param specifier - Package specifier to import.
-   * @returns The imported module cast to `T`, or `null` when the package is not installed.
-   */
-  readonly tryImport: <T>(specifier: string) => Promise<T | null>;
-  /**
-   * Abort signal triggered during graceful shutdown.
-   *
-   * Extensions can pass this to long-running operations (fetch, timers, streams)
-   * so they cancel promptly when the runtime is stopping.
-   */
-  readonly signal: AbortSignal;
-  /**
-   * Check whether an extension with the given name is active.
-   *
-   * Returns `true` when the named extension has been loaded and reached
-   * `active` state. Use this for optional integration checks without
-   * requiring an ExtensionToken.
-   * @param name - Extension name to check.
-   * @returns `true` when the extension is active.
-   */
-  readonly hasExtension: (name: string) => boolean;
-}
-/**
- * Node.js host extension context.
- *
- * Adds the OS and filesystem fields supplied by Node-based composition roots.
- * Extensions that need these fields should opt into this context explicitly;
- * host-agnostic extensions can type themselves against {@link ExtensionContext}.
- */
-interface NodeExtensionContext<TBus extends MakaioBusLike = MakaioBusLike> extends ExtensionContext<TBus> {
-  /** Working directory selected by the Node host for relative filesystem operations. */
-  readonly cwd?: string;
-  /** Current platform identifier (e.g., `'darwin'`, `'linux'`, `'win32'`). */
-  readonly platform: NodeJS.Platform;
-  /** User's home directory path. */
-  readonly homedir: string;
-  /** Resolved `.makaio` directory root (e.g., `~/.makaio`). */
-  readonly makaioHome: string;
-  /** Current OS username. */
-  readonly username: string;
-  /**
-   * WebSocket URL for the host bus, when the runtime exposes one.
-   *
-   * Detached `bus-websocket` extensions use this to connect back to the host.
-   * Hosts without a WebSocket bus omit it.
-   */
-  readonly busUrl?: string;
-}
-//#endregion
 //#region core/contracts/src/client/hook-responses.d.ts
 /**
  * A canonical `context.append` effect — a simple string-append that works
@@ -1109,4 +818,4 @@ declare function isValidTimeoutMs(timeoutMs: number): boolean;
  */
 declare function validateClosedPolicy(selectors: readonly InteractionSelector[], catalog: ProviderContractCatalogEntry): string[];
 //#endregion
-export { ConfigIsolation as $, ExtensionWarningAction as A, ClientBinaryCompatibility as B, validateClosedPolicy as C, ExtensionService as D, ExtensionIdentity as E, ExtensionWarningSeverity as F, ClientHookEventDeclaration as G, ClientDefinition as H, ExtensionWarningSeveritySchema as I, ClientRuntimeCapabilitiesSchema as J, ClientHookEventDeclarationSchema as K, getExtensionWarningActionLabel as L, ExtensionWarningEntry as M, ExtensionWarningEntrySchema as N, ExtensionServiceLifecycle as O, ExtensionWarningSchema as P, ClientToolDefinitionSchema as Q, ExtensionToken as R, isValidTimeoutMs as S, NodeExtensionContext as T, ClientDefinitionInput as U, ClientBinaryCompatibilitySchema as V, ClientDefinitionSchema as W, ClientToolCapabilityAnnotationSchema as X, ClientToolCapabilityAnnotation as Y, ClientToolDefinition as Z, ProviderContributionEnvelope as _, VersionRangeSchema as _t, CapabilitySelector as a, NpmInstallDescriptor as at, createAppendEffect as b, ContributorDefinition as c, PostInstallDescriptorSchema as ct, EventNameSelector as d, VersionCommand as dt, ConfigIsolationSchema as et, ExtensionClientHookResponsesContribution as f, VersionCommandSchema as ft, ProviderContractCatalogEntry as g, VersionRange as gt, InteractionSelector as h, VersionLiteralSchema as ht, CanonicalEffect as i, ManagedInstallDescriptorSchema as it, ExtensionWarningActionSchema as j, ExtensionWarning as k, ContributorResponse as l, SignedBinaryBucketInstallDescriptor as lt, InteractionBlockability as m, VersionLiteral as mt, ActivationValidationError as n, LogSourceDefinitionSchema as nt, ContributorActivationContext as o, NpmInstallDescriptorSchema as ot, FailurePolicy as p, deriveHookEventTransportMode as pt, ClientRuntimeCapabilities as q, CanonicalAppendEffect as r, ManagedInstallDescriptor as rt, ContributorCallbackContext as s, PostInstallDescriptor as st, ActivationErrorCode as t, LogSourceDefinition as tt, DEFAULT_FAILURE_POLICY as u, SignedBinaryBucketInstallDescriptorSchema as ut, RuntimeOutcome as v, isUniversalRange as vt, ExtensionContext as w, isValidContributorId as x, RuntimeOutcomeCode as y, versionSatisfies as yt, extensionToken as z };
+export { VersionLiteralSchema as $, ClientHookEventDeclarationSchema as A, LogSourceDefinitionSchema as B, validateClosedPolicy as C, ClientDefinitionInput as D, ClientDefinition as E, ClientToolDefinition as F, PostInstallDescriptor as G, ManagedInstallDescriptorSchema as H, ClientToolDefinitionSchema as I, SignedBinaryBucketInstallDescriptorSchema as J, PostInstallDescriptorSchema as K, ConfigIsolation as L, ClientRuntimeCapabilitiesSchema as M, ClientToolCapabilityAnnotation as N, ClientDefinitionSchema as O, ClientToolCapabilityAnnotationSchema as P, VersionLiteral as Q, ConfigIsolationSchema as R, isValidTimeoutMs as S, ClientBinaryCompatibilitySchema as T, NpmInstallDescriptor as U, ManagedInstallDescriptor as V, NpmInstallDescriptorSchema as W, VersionCommandSchema as X, VersionCommand as Y, deriveHookEventTransportMode as Z, ProviderContributionEnvelope as _, CapabilitySelector as a, createAppendEffect as b, ContributorDefinition as c, EventNameSelector as d, VersionRange as et, ExtensionClientHookResponsesContribution as f, ProviderContractCatalogEntry as g, InteractionSelector as h, CanonicalEffect as i, ClientRuntimeCapabilities as j, ClientHookEventDeclaration as k, ContributorResponse as l, InteractionBlockability as m, ActivationValidationError as n, isUniversalRange as nt, ContributorActivationContext as o, FailurePolicy as p, SignedBinaryBucketInstallDescriptor as q, CanonicalAppendEffect as r, versionSatisfies as rt, ContributorCallbackContext as s, ActivationErrorCode as t, VersionRangeSchema as tt, DEFAULT_FAILURE_POLICY as u, RuntimeOutcome as v, ClientBinaryCompatibility as w, isValidContributorId as x, RuntimeOutcomeCode as y, LogSourceDefinition as z };