@cuylabs/agent-core 4.9.0 → 5.0.0

package/dist/models/remote/types.d.ts

@@ -0,0 +1,28 @@
+export interface NetworkStatus {
+    online: boolean;
+    lastSuccess?: number;
+    lastError?: string;
+    failureCount: number;
+}
+export interface ModelsDevModel {
+    id: string;
+    name: string;
+    provider?: string;
+    reasoning?: boolean;
+    tool_call?: boolean;
+    temperature?: boolean;
+    attachment?: boolean;
+    modalities?: {
+        input?: string[];
+        output?: string[];
+    };
+    limit?: {
+        context?: number;
+        output?: number;
+    };
+    cost?: {
+        input?: number;
+        output?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/models/remote/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/models/remote/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE;QACX,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}

package/dist/models/resolver.d.ts

@@ -0,0 +1,26 @@
+import type { LanguageModel } from "ai";
+type AdapterKind = "openai" | "anthropic" | "google" | "openai-compatible" | "openrouter" | "azure" | "bedrock" | "vertex" | "xai" | "mistral" | "groq";
+export type AdapterSettings = {
+    apiKey?: string;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    extra?: Record<string, unknown>;
+};
+export type EngineSpec = {
+    adapter: AdapterKind | string;
+    settings?: AdapterSettings;
+    build?: (modelId: string, settings: AdapterSettings) => LanguageModel;
+};
+export type ModelSpec = {
+    engine: string;
+    id: string;
+    settings?: AdapterSettings;
+};
+export type Directory = {
+    engines: Record<string, EngineSpec>;
+    entries?: Record<string, ModelSpec>;
+};
+export type Resolver = (key: string) => Promise<LanguageModel>;
+export declare function createResolver(directory: Directory): Resolver;
+export {};
+//# sourceMappingURL=resolver.d.ts.map

package/dist/models/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/models/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,KAAK,WAAW,GACZ,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,mBAAmB,GACnB,YAAY,GACZ,OAAO,GACP,SAAS,GACT,QAAQ,GACR,KAAK,GACL,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,KAAK,aAAa,CAAC;CACvE,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAgM/D,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAiC7D"}

package/dist/models/types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Model Capability Types for @cuylabs/agent-core
+ *
+ * Defines the structure for model capabilities that can be sourced from
+ * static patterns, local cache, or remote APIs.
+ */
+/**
+ * Input modalities a model can accept
+ */
+export type InputModality = "text" | "image" | "audio" | "video" | "pdf";
+/**
+ * Output modalities a model can produce
+ */
+export type OutputModality = "text" | "image" | "audio" | "video";
+/**
+ * Comprehensive model capabilities
+ */
+export interface ModelCapabilities {
+    /** Model supports extended reasoning/thinking */
+    reasoning: boolean;
+    /** Model supports function/tool calling */
+    toolCalling: boolean;
+    /** Model supports temperature adjustment */
+    temperature: boolean;
+    /** Model supports file attachments */
+    attachments: boolean;
+    /** Model supports streaming responses */
+    streaming: boolean;
+    /** Supported input modalities */
+    inputModalities: InputModality[];
+    /** Supported output modalities */
+    outputModalities: OutputModality[];
+    /** Maximum context window in tokens */
+    contextWindow?: number;
+    /** Maximum output tokens */
+    maxOutput?: number;
+}
+/**
+ * Provider-specific compatibility flags
+ * These handle quirks in different provider implementations
+ */
+export interface ProviderCompatibility {
+    /** Supports OpenAI-style reasoning_effort parameter */
+    supportsReasoningEffort?: boolean;
+    /** Supports developer/system role distinction */
+    supportsDeveloperRole?: boolean;
+    /** Field name for max tokens (varies by provider) */
+    maxTokensField?: "max_tokens" | "max_completion_tokens";
+    /** Requires thinking as text tags vs structured */
+    requiresThinkingTags?: boolean;
+    /** Provider-specific thinking format */
+    thinkingFormat?: "openai" | "anthropic" | "google" | "zai";
+}
+/**
+ * Complete model entry with metadata
+ */
+export interface ModelEntry {
+    /** Model identifier (e.g., "gpt-4o", "claude-sonnet-4") */
+    id: string;
+    /** Human-readable model name */
+    name: string;
+    /** Provider identifier (e.g., "openai", "anthropic") */
+    provider: string;
+    /** Model capabilities */
+    capabilities: ModelCapabilities;
+    /** Provider-specific compatibility settings */
+    compatibility?: ProviderCompatibility;
+    /** Cost per million tokens (input) */
+    costInput?: number;
+    /** Cost per million tokens (output) */
+    costOutput?: number;
+    /** When this entry was last updated */
+    updatedAt?: string;
+}
+/**
+ * Priority levels for capability sources
+ */
+export declare enum SourcePriority {
+    /** User configuration overrides everything */
+    UserConfig = 0,
+    /** Local cache from previous fetch */
+    LocalCache = 1,
+    /** Bundled static data (build-time) */
+    BundledData = 2,
+    /** Pattern-based inference (fallback) */
+    PatternMatch = 3,
+    /** Remote API (if network available) */
+    RemoteAPI = 4
+}
+/**
+ * Result from a capability source lookup
+ */
+export interface SourceResult {
+    /** The model entry if found */
+    entry?: ModelEntry;
+    /** Which source provided this result */
+    source: SourcePriority;
+    /** Whether this is a confident match */
+    confident: boolean;
+    /** Error message if lookup failed */
+    error?: string;
+}
+/**
+ * Capability source interface
+ */
+export interface CapabilitySource {
+    /** Source priority (lower = higher priority) */
+    priority: SourcePriority;
+    /** Human-readable source name */
+    name: string;
+    /** Look up capabilities for a model */
+    lookup(modelId: string, provider?: string): Promise<SourceResult>;
+    /** Check if this source is available */
+    isAvailable(): Promise<boolean>;
+}
+/**
+ * Options for the capability resolver
+ */
+export interface ResolverOptions {
+    /** Enable remote API fetching (default: false) */
+    enableRemoteFetch?: boolean;
+    /** Remote API URL (default: https://models.dev) */
+    remoteApiUrl?: string;
+    /** Cache directory path */
+    cachePath?: string;
+    /** Cache TTL in milliseconds (default: 1 hour) */
+    cacheTtlMs?: number;
+    /** Network timeout in milliseconds (default: 10 seconds) */
+    networkTimeoutMs?: number;
+    /** Custom user overrides for specific models */
+    modelOverrides?: Record<string, Partial<ModelCapabilities>>;
+}
+/**
+ * Default resolver options
+ */
+export declare const DEFAULT_RESOLVER_OPTIONS: Required<ResolverOptions>;
+//# sourceMappingURL=types.d.ts.map

package/dist/models/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/models/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IAEnB,2CAA2C;IAC3C,WAAW,EAAE,OAAO,CAAC;IAErB,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;IAErB,sCAAsC;IACtC,WAAW,EAAE,OAAO,CAAC;IAErB,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IAEnB,iCAAiC;IACjC,eAAe,EAAE,aAAa,EAAE,CAAC;IAEjC,kCAAkC;IAClC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAEnC,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC,iDAAiD;IACjD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC,qDAAqD;IACrD,cAAc,CAAC,EAAE,YAAY,GAAG,uBAAuB,CAAC;IAExD,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B,wCAAwC;IACxC,cAAc,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IAEX,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IAEjB,yBAAyB;IACzB,YAAY,EAAE,iBAAiB,CAAC;IAEhC,+CAA+C;IAC/C,aAAa,CAAC,EAAE,qBAAqB,CAAC;IAEtC,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,oBAAY,cAAc;IACxB,8CAA8C;IAC9C,UAAU,IAAI;IACd,sCAAsC;IACtC,UAAU,IAAI;IACd,uCAAuC;IACvC,WAAW,IAAI;IACf,yCAAyC;IACzC,YAAY,IAAI;IAChB,wCAAwC;IACxC,SAAS,IAAI;CACd;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB,wCAAwC;IACxC,MAAM,EAAE,cAAc,CAAC;IAEvB,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IAEnB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,QAAQ,EAAE,cAAc,CAAC;IAEzB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAElE,wCAAwC;IACxC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;CAC7D;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,eAAe,CAO9D,CAAC"}

package/dist/plugin/compatibility.d.ts

@@ -0,0 +1,11 @@
+import type { PluginCompatibility } from "./types.js";
+export interface PluginCompatibilityContext {
+    apiVersion?: string;
+    nodeVersion?: string;
+}
+export declare function matchesVersionRequirement(version: string, requirement: string): boolean;
+export declare function validatePluginCompatibility(options: {
+    compatibility?: PluginCompatibility;
+    context: PluginCompatibilityContext;
+}): string | undefined;
+//# sourceMappingURL=compatibility.d.ts.map

package/dist/plugin/compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/plugin/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAiCD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAqCT;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,OAAO,EAAE,0BAA0B,CAAC;CACrC,GAAG,MAAM,GAAG,SAAS,CAuBrB"}

package/dist/plugin/define.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Declarative plugin authoring — `definePlugin()`.
+ *
+ * Converts a static plugin definition into a `PluginInit` function.
+ * The registry and imperative layer stay unchanged; this is sugar
+ * that makes plugins inspectable, type-safe, and easier to author.
+ */
+import type { AgentMiddleware } from "../middleware/types.js";
+import type { PromptSection } from "../prompt/types.js";
+import type { Tool } from "../tool/tool.js";
+import type { PluginCapabilityTag, PluginCompatibility, PluginCommand, PluginContext, PluginInit, PluginSurfaceContract, PluginSettingsDefinition, PluginSessionContext } from "./types.js";
+/** Declarative plugin definition passed to `definePlugin()`. */
+export interface PluginDefinition {
+    /** Unique plugin identifier. */
+    id: string;
+    /** Human-readable display name. */
+    name?: string;
+    /** Short description. */
+    description?: string;
+    /** SemVer string. */
+    version?: string;
+    /** Host/runtime compatibility validated before the plugin is committed. */
+    compatibility?: PluginCompatibility;
+    /** Host-readable business capability tags for catalogs and inventories. */
+    capabilities?: PluginCapabilityTag[];
+    /** Explicit contract for the host-owned surfaces this plugin contributes to. */
+    surfaces?: PluginSurfaceContract;
+    /** Optional settings schema to validate before the plugin is committed. */
+    settings?: PluginSettingsDefinition;
+    /** Tools the LLM can call. Statically declared — inspectable without execution. */
+    tools?: Tool.AnyInfo[];
+    /** Middleware hooks (model I/O, tool guards, prompt sections). */
+    middleware?: AgentMiddleware[];
+    /** User-facing commands. */
+    commands?: PluginCommand[];
+    /** Dynamic prompt sections injected at system-prompt build time. */
+    promptSections?: PromptSection[];
+    /**
+     * Imperative activation hook — runs when the agent session starts.
+     * Use for dynamic setup that can't be expressed declaratively
+     * (starting servers, loading config, managing state).
+     */
+    activate?: (ctx: PluginActivateContext) => Promise<void> | void;
+    /**
+     * Imperative deactivation hook — runs when the agent session ends.
+     */
+    deactivate?: () => Promise<void> | void;
+    /**
+     * Full imperative escape hatch — runs during plugin loading.
+     * Receives the raw PluginContext for anything the declarative
+     * fields can't express. Runs after all declarative contributions
+     * have been registered.
+     */
+    setup?: (ctx: PluginContext) => void | Promise<void>;
+}
+/** Context passed to the declarative `activate` hook. */
+export interface PluginActivateContext extends PluginSessionContext {
+    /** The plugin's own event bus. */
+    events: PluginContext["events"];
+    /** The plugin's settings provider. */
+    settings: PluginContext["settings"];
+}
+/**
+ * Create a plugin from a declarative definition.
+ *
+ * Returns a `PluginInit` function that the registry executes normally.
+ * The definition object is attached as `init.__definition` so the
+ * registry can inspect it without running the plugin.
+ */
+export declare function definePlugin(def: PluginDefinition): PluginInit;
+/** A PluginInit created by `definePlugin()` — carries the static definition. */
+export interface DefinePluginInit extends PluginInit {
+    __definition: PluginDefinition;
+}
+/** Type guard: check if a PluginInit was created by `definePlugin()`. */
+export declare function isDefinedPlugin(init: PluginInit): init is DefinePluginInit;
+//# sourceMappingURL=define.d.ts.map

package/dist/plugin/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/plugin/define.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAMpB,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAErC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAEjC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAEpC,mFAAmF;IACnF,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAEvB,kEAAkE;IAClE,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAE/B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAE3B,oEAAoE;IACpE,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IAEjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEhE;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAExC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,yDAAyD;AACzD,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,kCAAkC;IAClC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,sCAAsC;IACtC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACrC;AAMD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,UAAU,CAyC9D;AAED,gFAAgF;AAChF,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,IAAI,gBAAgB,CAE1E"}

package/dist/plugin/event-bus.d.ts

@@ -0,0 +1,31 @@
+/**
+ * PluginEventBus — string-keyed pub/sub for inter-plugin communication.
+ *
+ * Channel names are namespaced by convention:
+ * "finance:transaction-created", "crm:contact-updated".
+ */
+/** Remove a previously registered listener. */
+export type PluginUnsubscribe = () => void;
+/** Listener function for a specific channel. */
+export type PluginEventHandler = (data: unknown) => void;
+/**
+ * Minimal event bus interface. Plugins depend only on this.
+ */
+export interface PluginEventBusAPI {
+    emit(channel: string, data: unknown): void;
+    on(channel: string, handler: PluginEventHandler): PluginUnsubscribe;
+}
+/**
+ * In-process event bus. Dispatches synchronously.
+ * Listener errors are caught silently.
+ */
+export declare class PluginEventBus implements PluginEventBusAPI {
+    private readonly channels;
+    emit(channel: string, data: unknown): void;
+    on(channel: string, handler: PluginEventHandler): PluginUnsubscribe;
+    /** Number of active channels. */
+    get size(): number;
+    /** Remove all listeners. */
+    clear(): void;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/plugin/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/plugin/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC;AAE3C,gDAAgD;AAChD,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAAC;CACrE;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8C;IAEvE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAY1C,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,iBAAiB;IAcnE,iCAAiC;IACjC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,4BAA4B;IAC5B,KAAK,IAAI,IAAI;CAGd"}