@soederpop/luca 0.1.2 → 0.2.1

package/dist/agi/features/skills-library.d.ts

@@ -0,0 +1,167 @@
+import { z } from 'zod';
+import { Feature } from '../feature.js';
+import type { DocsReader } from './docs-reader.js';
+import Assistant from './assistant.js';
+declare module '@soederpop/luca/feature' {
+    interface AvailableFeatures {
+        skillsLibrary: typeof SkillsLibrary;
+    }
+}
+export interface SkillInfo {
+    /** Skill name derived from folder name or frontmatter */
+    name: string;
+    /** Description from frontmatter */
+    description: string;
+    /** Absolute path to the skill folder (dirname of SKILL.md) */
+    path: string;
+    /** Absolute path to SKILL.md */
+    skillFilePath: string;
+    /** Which location this skill was found in */
+    locationPath: string;
+    /** All frontmatter metadata */
+    meta: Record<string, unknown>;
+}
+export declare const SkillsLibraryStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    loaded: z.ZodBoolean;
+    locations: z.ZodArray<z.ZodString>;
+    skillCount: z.ZodNumber;
+    skills: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$loose>;
+export declare const SkillsLibraryOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    configPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SkillsLibraryEventsSchema: z.ZodObject<{
+    stateChange: z.ZodTuple<[z.ZodAny], null>;
+    enabled: z.ZodTuple<[], null>;
+    started: z.ZodTuple<[], null>;
+    locationAdded: z.ZodTuple<[z.ZodString], null>;
+    skillDiscovered: z.ZodTuple<[z.ZodAny], null>;
+}, z.core.$strip>;
+export type SkillsLibraryState = z.infer<typeof SkillsLibraryStateSchema>;
+export type SkillsLibraryOptions = z.infer<typeof SkillsLibraryOptionsSchema>;
+/**
+ * Manages a registry of skill locations — folders containing SKILL.md files.
+ *
+ * Persists known locations to ~/.luca/skills.json and scans them on start.
+ * Each skill folder can be opened as a DocsReader for AI-assisted Q&A.
+ * Exposes tools for assistant integration via assistant.use(skillsLibrary).
+ *
+ * @extends Feature
+ * @example
+ * ```typescript
+ * const lib = container.feature('skillsLibrary')
+ * await lib.start()
+ * await lib.addLocation('~/.claude/skills')
+ * lib.list() // => SkillInfo[]
+ * const reader = lib.createSkillReader('my-skill')
+ * ```
+ */
+export declare class SkillsLibrary extends Feature<SkillsLibraryState, SkillsLibraryOptions> {
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        loaded: z.ZodBoolean;
+        locations: z.ZodArray<z.ZodString>;
+        skillCount: z.ZodNumber;
+        skills: z.ZodRecord<z.ZodString, z.ZodAny>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+        configPath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+        started: z.ZodTuple<[], null>;
+        locationAdded: z.ZodTuple<[z.ZodString], null>;
+        skillDiscovered: z.ZodTuple<[z.ZodAny], null>;
+    }, z.core.$strip>;
+    static shortcut: "features.skillsLibrary";
+    /** Tools for assistant integration via assistant.use(skillsLibrary). */
+    static tools: Record<string, {
+        schema: z.ZodType;
+        handler?: Function;
+    }>;
+    /** @returns Default state. */
+    get initialState(): SkillsLibraryState;
+    setupToolsConsumer(assistant: Assistant): Assistant;
+    /** Discovered skills keyed by name. */
+    get skills(): Record<string, SkillInfo>;
+    get availableSkills(): string[];
+    get skillsTable(): Record<string, string>;
+    /** Resolved path to the skills.json config file. */
+    get configPath(): string;
+    /** Whether the library has been loaded. */
+    get isStarted(): boolean;
+    /** Expand ~ to home directory in a path. */
+    private expandHome;
+    /** Read the persisted config, creating it if it doesn't exist. */
+    private readConfig;
+    /** Write the config back to disk. */
+    private writeConfig;
+    /**
+     * Start the skills library: read config, scan all locations.
+     *
+     * @returns This instance for chaining
+     */
+    start(): Promise<SkillsLibrary>;
+    /**
+     * Add a new skill location folder and scan it for skills.
+     *
+     * @param locationPath - Path to a directory containing skill subfolders with SKILL.md
+     */
+    addLocation(locationPath: string): Promise<void>;
+    /**
+     * Remove a skill location and its skills from the library.
+     *
+     * @param locationPath - The location path to remove
+     */
+    removeLocation(locationPath: string): Promise<void>;
+    /**
+     * Scan a location folder for skill subfolders containing SKILL.md.
+     *
+     * @param locationPath - Absolute path to scan
+     */
+    scanLocation(locationPath: string): Promise<void>;
+    /** Return all discovered skills. */
+    list(): SkillInfo[];
+    /** Find a skill by name. */
+    find(skillName: string): SkillInfo | undefined;
+    /**
+     * Create a DocsReader for a skill's folder, enabling AI-assisted Q&A.
+     *
+     * @param skillName - Name of the skill to create a reader for
+     * @returns A DocsReader instance rooted at the skill's folder
+     */
+    createSkillReader(skillName: string): DocsReader;
+    /**
+     * Create a tmp directory containing symlinked/copied skill folders by name,
+     * suitable for passing to claude --add-dir.
+     *
+     * @param skillNames - Array of skill names to include
+     * @returns Absolute path to the created directory
+     */
+    ensureFolderCreatedWithSkillsByName(skillNames: string[]): string;
+    /** Search available skills, optionally filtered by a query string. */
+    searchAvailableSkills({ query }?: {
+        query?: string;
+    }): Promise<string>;
+    /** Load a skill's full SKILL.md content and metadata. */
+    loadSkill({ skillName }: {
+        skillName: string;
+    }): Promise<string>;
+    /** Ask a question about a specific skill using a DocsReader. */
+    askSkillBasedQuestion({ skillName, question }: {
+        skillName: string;
+        question: string;
+    }): Promise<string>;
+}
+export default SkillsLibrary;
+//# sourceMappingURL=skills-library.d.ts.map

package/dist/agi/features/skills-library.d.ts.map

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

package/dist/agi/index.d.ts

@@ -0,0 +1,5 @@
+import type { AGIContainer } from './container.server';
+export * from './container.server';
+declare const _default: AGIContainer;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/agi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agi/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,cAAc,oBAAoB,CAAA;wBAEN,YAAY;AAAxC,wBAAwC"}

package/dist/agi/lib/interceptor-chain.d.ts

@@ -0,0 +1,44 @@
+/**
+ * A composable middleware chain. Each interceptor receives a mutable
+ * context and a `next` function. Calling `next()` continues the chain;
+ * skipping it short-circuits.
+ */
+export type InterceptorFn<T> = (ctx: T, next: () => Promise<void>) => Promise<void>;
+export declare class InterceptorChain<T> {
+    private fns;
+    add(fn: InterceptorFn<T>): void;
+    remove(fn: InterceptorFn<T>): void;
+    get hasInterceptors(): boolean;
+    get size(): number;
+    run(ctx: T, final: () => Promise<void>): Promise<void>;
+}
+export interface BeforeAskCtx {
+    question: string | any[];
+    options?: any;
+    result?: string;
+}
+export interface ToolCallCtx {
+    name: string;
+    args: Record<string, any>;
+    result?: string;
+    error?: any;
+    skip?: boolean;
+}
+export interface BeforeResponseCtx {
+    text: string;
+}
+export interface BeforeTurnCtx {
+    turn: number;
+    isFollowUp: boolean;
+    messages: any[];
+    skip?: boolean;
+}
+export interface InterceptorPoints {
+    beforeAsk: BeforeAskCtx;
+    beforeTurn: BeforeTurnCtx;
+    beforeToolCall: ToolCallCtx;
+    afterToolCall: ToolCallCtx;
+    beforeResponse: BeforeResponseCtx;
+}
+export type InterceptorPoint = keyof InterceptorPoints;
+//# sourceMappingURL=interceptor-chain.d.ts.map

package/dist/agi/lib/interceptor-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor-chain.d.ts","sourceRoot":"","sources":["../../../src/agi/lib/interceptor-chain.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEnF,qBAAa,gBAAgB,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAyB;IAEpC,GAAG,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAI/B,MAAM,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAKlC,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAe5D;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,MAAM,GAAG,GAAG,EAAE,CAAA;IACxB,OAAO,CAAC,EAAE,GAAG,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,GAAG,CAAA;IACX,IAAI,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,GAAG,EAAE,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,YAAY,CAAA;IACvB,UAAU,EAAE,aAAa,CAAA;IACzB,cAAc,EAAE,WAAW,CAAA;IAC3B,aAAa,EAAE,WAAW,CAAA;IAC1B,cAAc,EAAE,iBAAiB,CAAA;CACjC;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,iBAAiB,CAAA"}

package/dist/agi/lib/token-counter.d.ts

@@ -0,0 +1,13 @@
+import type { Tiktoken } from 'js-tiktoken';
+/** Look up the context window size for a model name (exact then prefix match). */
+export declare function getContextWindow(model: string): number;
+/** Get a cached tiktoken encoder for a model (falls back to o200k_base). */
+export declare function getEncoder(model: string): Tiktoken;
+/** Count tokens in a plain string. */
+export declare function countTokens(text: string, model: string): number;
+/**
+ * Estimate the total input token count for a messages array.
+ * Follows the OpenAI token counting recipe with per-message overhead.
+ */
+export declare function countMessageTokens(messages: any[], model: string): number;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/agi/lib/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../../src/agi/lib/token-counter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AA4B3C,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYtD;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAYlD;AAED,sCAAsC;AACtC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAqDzE"}

package/dist/bootstrap/generated.d.ts

@@ -0,0 +1,5 @@
+export declare const bootstrapFiles: Record<string, string>;
+export declare const bootstrapTemplates: Record<string, string>;
+export declare const bootstrapExamples: Record<string, string>;
+export declare const bootstrapTutorials: Record<string, string>;
+//# sourceMappingURL=generated.d.ts.map

package/dist/bootstrap/generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated.d.ts","sourceRoot":"","sources":["../../src/bootstrap/generated.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA6bjD,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0QrD,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA00HpD,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAq6JrD,CAAA"}

package/dist/browser.d.ts

@@ -0,0 +1,12 @@
+export * from './web/container.js';
+import { WebContainer } from './web/container.js';
+import './introspection/generated.web.js';
+declare const container: WebContainer<import("./browser.js").WebFeatures, import("./browser.js").WebContainerState>;
+export default container;
+/**
+ * Returns the singleton container instance.
+ * LLMs love to hallucinate this function — so we provide it, but warn.
+ * If you need a separate container, use `container.subcontainer()`.
+ */
+export declare function createContainer(): WebContainer<import("./browser.js").WebFeatures, import("./browser.js").WebContainerState>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,kCAAkC,CAAA;AAEzC,QAAA,MAAM,SAAS,4FAAuB,CAAA;AAMtC,eAAe,SAAS,CAAA;AAExB;;;;GAIG;AACH,wBAAgB,eAAe,+FAO9B"}

package/dist/bus.d.ts

@@ -0,0 +1,29 @@
+export type EventMap = Record<string, any[]>;
+type WildcardListener = (event: string, ...args: any[]) => void;
+export interface EventStats {
+    event: string;
+    fireCount: number;
+    lastFiredAt: number | null;
+    timestamps: number[];
+    firesPerMinute: number;
+}
+export declare class Bus<T extends EventMap = EventMap> {
+    private events;
+    private wildcardListeners;
+    private stats;
+    constructor();
+    private recordEmit;
+    private computeFiresPerMinute;
+    getEventStats<E extends string & keyof T>(event: E): EventStats;
+    get history(): EventStats[];
+    get firedEvents(): string[];
+    waitFor<E extends string & keyof T>(event: E): Promise<T[E]>;
+    emit<E extends string & keyof T>(event: E, ...args: T[E]): void;
+    on(event: '*', listener: WildcardListener): void;
+    on<E extends string & keyof T>(event: E, listener: (...args: T[E]) => void): void;
+    once<E extends string & keyof T>(event: E, listener: (...args: T[E]) => void): void;
+    off(event: '*', listener?: WildcardListener): void;
+    off<E extends string & keyof T>(event: E, listener?: (...args: T[E]) => void): void;
+}
+export {};
+//# sourceMappingURL=bus.d.ts.map

package/dist/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../src/bus.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AAG7C,KAAK,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAEhE,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,GAAG,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IAC1C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,KAAK,CAAuF;;IAQpG,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,qBAAqB;IAQ7B,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU;IAW/D,IAAI,OAAO,IAAI,UAAU,EAAE,CAE1B;IAED,IAAI,WAAW,IAAI,MAAM,EAAE,CAE1B;IAEK,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAMlE,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAS/D,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAChD,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAWjF,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAQnF,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAClD,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;CAyBtF"}

package/dist/cli/build-info.d.ts

@@ -0,0 +1,4 @@
+export declare const BUILD_SHA = "bc27770";
+export declare const BUILD_BRANCH = "main";
+export declare const BUILD_DATE = "2026-04-02T05:28:05Z";
+//# sourceMappingURL=build-info.d.ts.map

package/dist/cli/build-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.d.ts","sourceRoot":"","sources":["../../src/cli/build-info.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,SAAS,YAAY,CAAA;AAClC,eAAO,MAAM,YAAY,SAAS,CAAA;AAClC,eAAO,MAAM,UAAU,yBAAyB,CAAA"}

package/dist/cli/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import '@/commands/index.js';
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":";AAeA,OAAO,qBAAqB,CAAA"}

package/dist/client.d.ts

@@ -0,0 +1,60 @@
+import { Helper } from "./helper.js";
+import type { Container, ContainerContext } from "./container.js";
+import { Registry } from "./registry.js";
+import { z } from 'zod';
+import { ClientStateSchema, ClientOptionsSchema } from './schemas/base.js';
+export type ClientOptions = z.infer<typeof ClientOptionsSchema>;
+export type ClientState = z.infer<typeof ClientStateSchema>;
+export type { WebSocketClientState, WebSocketClientOptions } from './clients/websocket.js';
+export type { GraphClientOptions } from './clients/graph.js';
+export interface AvailableClients {
+}
+export interface ClientsInterface {
+    clients: ClientsRegistry;
+    client<T extends keyof AvailableClients>(key: T, options?: ConstructorParameters<AvailableClients[T]>[0]): InstanceType<AvailableClients[T]>;
+}
+/**
+ * Base client class for all Luca network clients. Provides connection state
+ * tracking, configuration, and the registry/factory infrastructure for
+ * creating typed client instances via `container.client('rest')`.
+ *
+ * Subclasses should override `connect()` and add protocol-specific methods.
+ * Register subclasses using `Client.register(this, 'myClient')` in a static block.
+ */
+export declare class Client<T extends ClientState = ClientState, K extends ClientOptions = ClientOptions> extends Helper<T, K> {
+    static shortcut: string;
+    static stateSchema: z.ZodObject<{
+        connected: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        baseURL: z.ZodOptional<z.ZodString>;
+        json: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        failure: z.ZodTuple<[z.ZodAny], null>;
+    }, z.core.$strip>;
+    /** Self-register a Client subclass from a static initialization block. */
+    static register: (SubClass: typeof Client, id?: string) => typeof Client;
+    static attach(container: Container & ClientsInterface): any;
+    constructor(options?: K, context?: ContainerContext);
+    /** The base URL for this client's connections/requests. */
+    get baseURL(): string;
+    get options(): K;
+    /** Configure this client instance with additional options. */
+    configure(options?: any): this;
+    /** Whether the client is currently connected. */
+    get isConnected(): boolean;
+    /** Establish a connection. Subclasses should override with protocol-specific logic. */
+    connect(): Promise<this>;
+}
+export declare class ClientsRegistry extends Registry<Client<any>> {
+    scope: string;
+    baseClass: typeof Client;
+}
+export declare const clients: ClientsRegistry;
+export declare const helperCache: Map<any, any>;
+export default Client;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EACL,iBAAiB,EAAE,mBAAmB,EACvC,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAO3D,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC1F,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAG5D,MAAM,WAAW,gBAAgB;CAAG;AAEpC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACrC,GAAG,EAAE,CAAC,EACN,OAAO,CAAC,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACtD,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,qBAAa,MAAM,CACjB,CAAC,SAAS,WAAW,GAAG,WAAW,EACnC,CAAC,SAAS,aAAa,GAAG,aAAa,CACvC,SAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACpB,OAAgB,QAAQ,SAAiB;IACzC,OAAgB,WAAW;;sBAAoB;IAC/C,OAAgB,aAAa;;;;;sBAAsB;IACnD,OAAgB,YAAY;;;sBAAqB;IAEjD,0EAA0E;IAC1E,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,MAAM,CAAA;IAExE,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,GAAG,GAAG;gBA8B/C,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAUnD,2DAA2D;IAC3D,IAAI,OAAO,WAEV;IAED,IAAa,OAAO,IACM,CAAC,CAC1B;IAED,8DAA8D;IAC9D,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,IAAI;IAI9B,iDAAiD;IACjD,IAAI,WAAW,YAEd;IAED,uFAAuF;IACjF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B;AAKD,qBAAa,eAAgB,SAAQ,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/C,KAAK,SAAY;IACjB,SAAS,gBAAS;CAC5B;AAED,eAAO,MAAM,OAAO,iBAAwB,CAAC;AAE7C,eAAO,MAAM,WAAW,eAAY,CAAC;AA2CrC,eAAe,MAAM,CAAC"}