@kadi.build/core 0.0.1-alpha.1 → 0.0.1-alpha.10

package/dist/types/broker.d.ts

@@ -0,0 +1,301 @@
+/**
+ * Broker Types
+ *
+ * Type definitions for broker connections, protocol, and communication.
+ * Brokers enable service discovery and remote communication between agents.
+ */
+import type { WebSocket } from 'ws';
+import type { ToolDefinition } from './tools.js';
+/**
+ * Broker connection state
+ */
+export interface BrokerConnection {
+    /**
+     * WebSocket instance
+     */
+    ws: WebSocket;
+    /**
+     * Broker URL (e.g., ws://localhost:8080)
+     */
+    url: string;
+    /**
+     * Named identifier for this broker (e.g., 'local', 'production')
+     */
+    brokerName: string;
+    /**
+     * Unique agent/session ID assigned by broker
+     */
+    agentId: string;
+    /**
+     * Whether authentication has completed successfully
+     */
+    isAuthenticated: boolean;
+    /**
+     * Connection state
+     */
+    state: ConnectionState;
+    /**
+     * Heartbeat timer (for keeping connection alive)
+     */
+    heartbeatTimer?: NodeJS.Timeout;
+    /**
+     * When the connection was established
+     */
+    connectedAt?: number;
+    /**
+     * Last heartbeat timestamp
+     */
+    lastHeartbeat?: number;
+}
+/**
+ * Connection state enum
+ */
+export declare enum ConnectionState {
+    DISCONNECTED = "disconnected",
+    CONNECTING = "connecting",
+    CONNECTED = "connected",
+    AUTHENTICATING = "authenticating",
+    AUTHENTICATED = "authenticated",
+    ERROR = "error"
+}
+/**
+ * Broker configuration
+ */
+export interface BrokerConfig {
+    /**
+     * Broker URL
+     */
+    url: string;
+    /**
+     * Named identifier for this broker
+     */
+    name: string;
+    /**
+     * Authentication token (if required)
+     */
+    authToken?: string;
+    /**
+     * Heartbeat interval in milliseconds
+     */
+    heartbeatInterval?: number;
+    /**
+     * Connection timeout in milliseconds
+     */
+    connectionTimeout?: number;
+    /**
+     * Request timeout in milliseconds
+     */
+    requestTimeout?: number;
+    /**
+     * Whether to automatically reconnect on disconnect
+     */
+    autoReconnect?: boolean;
+    /**
+     * Max reconnection attempts
+     */
+    maxReconnectAttempts?: number;
+}
+/**
+ * JSON-RPC 2.0 request
+ */
+export interface JsonRpcRequest<TParams = unknown> {
+    jsonrpc: '2.0';
+    method: string;
+    params?: TParams;
+    id?: string | number;
+}
+/**
+ * JSON-RPC 2.0 response
+ */
+export interface JsonRpcResponse<TResult = unknown> {
+    jsonrpc: '2.0';
+    result?: TResult;
+    error?: JsonRpcError;
+    id: string | number;
+}
+/**
+ * JSON-RPC 2.0 error
+ */
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/**
+ * JSON-RPC 2.0 notification (request without ID)
+ */
+export interface JsonRpcNotification<TParams = unknown> {
+    jsonrpc: '2.0';
+    method: string;
+    params?: TParams;
+}
+/**
+ * KADI broker protocol methods
+ *
+ * IMPORTANT: These must match KadiMessages in src/messages/index.ts!
+ *
+ * @deprecated Use KadiMessages directly from '@kadi.build/core/messages' instead
+ */
+export declare enum KadiProtocolMethod {
+    HANDSHAKE = "kadi.session.hello",
+    AUTHENTICATE = "kadi.session.authenticate",
+    HEARTBEAT = "kadi.session.ping",
+    GOODBYE = "kadi.session.goodbye",
+    REGISTER_CAPABILITIES = "kadi.agent.register",
+    LIST_TOOLS = "kadi.ability.list",
+    TOOL_INVOKE = "kadi.ability.request",
+    TOOL_RESULT = "kadi.ability.result",
+    TOOL_PENDING = "kadi.ability.pending",
+    EVENT_SUBSCRIBE = "kadi.event.subscribe",
+    EVENT_UNSUBSCRIBE = "kadi.event.unsubscribe",
+    EVENT_PUBLISH = "kadi.event.publish",
+    EVENT_DELIVERY = "kadi.event.delivery"
+}
+/**
+ * Handshake request parameters
+ */
+export interface HandshakeParams {
+    /**
+     * Agent/client role
+     *
+     * Must be one of: 'agent', 'client', 'observer', 'ability'
+     */
+    role: 'agent' | 'client' | 'observer' | 'ability';
+    /**
+     * Agent name
+     */
+    name?: string;
+    /**
+     * Agent version
+     */
+    version?: string;
+    /**
+     * Protocol version
+     */
+    protocolVersion?: string;
+    /**
+     * Networks this agent wants to join
+     */
+    networks?: string[];
+}
+/**
+ * Handshake response result
+ */
+export interface HandshakeResult {
+    /**
+     * Assigned agent ID
+     * Empty string for unauthenticated connections (observers, clients)
+     */
+    agentId: string;
+    /**
+     * Whether this connection requires capability registration
+     * True for agent/ability roles, false for client/observer roles
+     */
+    requiresRegistration: boolean;
+}
+/**
+ * Capability registration parameters
+ */
+export interface RegisterCapabilitiesParams {
+    /**
+     * Tools this agent provides
+     */
+    tools: ToolDefinition[];
+    /**
+     * Networks to register in
+     */
+    networks?: string[];
+    /**
+     * Display name for this agent
+     */
+    displayName?: string;
+}
+/**
+ * Tool invocation parameters
+ */
+export interface ToolInvokeParams {
+    /**
+     * Target agent name
+     */
+    targetAgent: string;
+    /**
+     * Tool name to invoke
+     */
+    toolName: string;
+    /**
+     * Input parameters
+     */
+    toolInput?: unknown;
+    /**
+     * Request ID for tracking
+     */
+    requestId?: string;
+    /**
+     * Timeout in milliseconds
+     */
+    timeout?: number;
+}
+/**
+ * Event subscription parameters
+ */
+export interface EventSubscribeParams {
+    /**
+     * Event patterns to subscribe to
+     */
+    channels: string[];
+    /**
+     * Network to subscribe within
+     */
+    networkId?: string;
+}
+/**
+ * Event publish parameters
+ */
+export interface EventPublishParams {
+    /**
+     * Event channel/name
+     */
+    channel: string;
+    /**
+     * Event data
+     */
+    data: unknown;
+    /**
+     * Optional hints for delivery
+     */
+    hints?: {
+        latestOnly?: boolean;
+        coalescingKey?: string;
+        ttl?: number;
+    };
+    /**
+     * Network to publish to
+     */
+    networkId?: string;
+}
+/**
+ * Pending request tracker
+ */
+export interface PendingRequest<T = unknown> {
+    /**
+     * Request ID
+     */
+    id: string | number;
+    /**
+     * Promise resolve function
+     */
+    resolve: (value: T) => void;
+    /**
+     * Promise reject function
+     */
+    reject: (reason: unknown) => void;
+    /**
+     * Timeout timer
+     */
+    timeout?: NodeJS.Timeout;
+    /**
+     * When the request was sent
+     */
+    timestamp: number;
+}
+//# sourceMappingURL=broker.d.ts.map

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

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

package/dist/types/broker.js

@@ -0,0 +1,46 @@
+/**
+ * Broker Types
+ *
+ * Type definitions for broker connections, protocol, and communication.
+ * Brokers enable service discovery and remote communication between agents.
+ */
+/**
+ * Connection state enum
+ */
+export var ConnectionState;
+(function (ConnectionState) {
+    ConnectionState["DISCONNECTED"] = "disconnected";
+    ConnectionState["CONNECTING"] = "connecting";
+    ConnectionState["CONNECTED"] = "connected";
+    ConnectionState["AUTHENTICATING"] = "authenticating";
+    ConnectionState["AUTHENTICATED"] = "authenticated";
+    ConnectionState["ERROR"] = "error";
+})(ConnectionState || (ConnectionState = {}));
+/**
+ * KADI broker protocol methods
+ *
+ * IMPORTANT: These must match KadiMessages in src/messages/index.ts!
+ *
+ * @deprecated Use KadiMessages directly from '@kadi.build/core/messages' instead
+ */
+export var KadiProtocolMethod;
+(function (KadiProtocolMethod) {
+    // Session lifecycle
+    KadiProtocolMethod["HANDSHAKE"] = "kadi.session.hello";
+    KadiProtocolMethod["AUTHENTICATE"] = "kadi.session.authenticate";
+    KadiProtocolMethod["HEARTBEAT"] = "kadi.session.ping";
+    KadiProtocolMethod["GOODBYE"] = "kadi.session.goodbye";
+    // Agent registration
+    KadiProtocolMethod["REGISTER_CAPABILITIES"] = "kadi.agent.register";
+    // Tool operations
+    KadiProtocolMethod["LIST_TOOLS"] = "kadi.ability.list";
+    KadiProtocolMethod["TOOL_INVOKE"] = "kadi.ability.request";
+    KadiProtocolMethod["TOOL_RESULT"] = "kadi.ability.result";
+    KadiProtocolMethod["TOOL_PENDING"] = "kadi.ability.pending";
+    // Events
+    KadiProtocolMethod["EVENT_SUBSCRIBE"] = "kadi.event.subscribe";
+    KadiProtocolMethod["EVENT_UNSUBSCRIBE"] = "kadi.event.unsubscribe";
+    KadiProtocolMethod["EVENT_PUBLISH"] = "kadi.event.publish";
+    KadiProtocolMethod["EVENT_DELIVERY"] = "kadi.event.delivery";
+})(KadiProtocolMethod || (KadiProtocolMethod = {}));
+//# sourceMappingURL=broker.js.map

package/dist/types/broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.js","sourceRoot":"","sources":["../../src/types/broker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuDH;;GAEG;AACH,MAAM,CAAN,IAAY,eAOX;AAPD,WAAY,eAAe;IACzB,gDAA6B,CAAA;IAC7B,4CAAyB,CAAA;IACzB,0CAAuB,CAAA;IACvB,oDAAiC,CAAA;IACjC,kDAA+B,CAAA;IAC/B,kCAAe,CAAA;AACjB,CAAC,EAPW,eAAe,KAAf,eAAe,QAO1B;AAqFD;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,kBAqBX;AArBD,WAAY,kBAAkB;IAC5B,oBAAoB;IACpB,sDAAgC,CAAA;IAChC,gEAA0C,CAAA;IAC1C,qDAA+B,CAAA;IAC/B,sDAAgC,CAAA;IAEhC,qBAAqB;IACrB,mEAA6C,CAAA;IAE7C,kBAAkB;IAClB,sDAAgC,CAAA;IAChC,0DAAoC,CAAA;IACpC,yDAAmC,CAAA;IACnC,2DAAqC,CAAA;IAErC,SAAS;IACT,8DAAwC,CAAA;IACxC,kEAA4C,CAAA;IAC5C,0DAAoC,CAAA;IACpC,4DAAsC,CAAA;AACxC,CAAC,EArBW,kBAAkB,KAAlB,kBAAkB,QAqB7B"}

package/dist/types/config.d.ts

@@ -0,0 +1,325 @@
+/**
+ * Configuration Types
+ *
+ * Type definitions for KADI client and service configuration.
+ * Clear precedence: Code > Environment > File > Defaults
+ */
+/**
+ * Transport protocol types
+ */
+export type TransportKind = 'native' | 'stdio' | 'broker';
+/**
+ * Agent role type
+ */
+export type AgentRole = 'agent' | 'ability' | 'client' | 'observer';
+/**
+ * KADI Client Configuration
+ *
+ * Complete configuration for creating a KADI client.
+ *
+ * @example
+ * ```typescript
+ * const config: KadiClientConfig = {
+ *   name: 'my-service',
+ *   brokers: {
+ *     local: 'ws://localhost:8080',
+ *     prod: 'wss://prod.example.com'
+ *   },
+ *   networks: ['global', 'team-alpha']
+ * };
+ * ```
+ */
+export interface KadiClientConfig {
+    /**
+     * Agent/service name (required)
+     */
+    name: string;
+    /**
+     * Version string (semver recommended)
+     */
+    version?: string;
+    /**
+     * Human-readable description
+     */
+    description?: string;
+    /**
+     * Role of this agent
+     * @default 'agent'
+     */
+    role?: AgentRole;
+    /**
+     * Default transport mode for loading abilities
+     * @default 'native'
+     */
+    transport?: TransportKind;
+    /**
+     * Named broker configurations
+     *
+     * @example
+     * ```typescript
+     * brokers: {
+     *   local: 'ws://localhost:8080',
+     *   production: 'wss://broker.example.com'
+     * }
+     * ```
+     */
+    brokers?: Record<string, string>;
+    /**
+     * Default broker to use (must be a key in `brokers`)
+     */
+    defaultBroker?: string;
+    /**
+     * Networks to join
+     * @default ['global']
+     */
+    networks?: string[];
+    /**
+     * Path to agent.json file (for ability mode)
+     */
+    abilityAgentJSON?: string;
+    /**
+     * Whether to automatically connect to brokers on instantiation
+     * @default false
+     */
+    autoConnect?: boolean;
+    /**
+     * Advanced configuration options
+     */
+    advanced?: AdvancedConfig;
+}
+/**
+ * Advanced configuration options
+ */
+export interface AdvancedConfig {
+    /**
+     * Heartbeat interval in milliseconds
+     * @default 30000 (30 seconds)
+     */
+    heartbeatInterval?: number;
+    /**
+     * Request timeout in milliseconds
+     * @default 30000 (30 seconds)
+     */
+    requestTimeout?: number;
+    /**
+     * Connection timeout in milliseconds
+     * @default 10000 (10 seconds)
+     */
+    connectionTimeout?: number;
+    /**
+     * Whether to automatically reconnect on disconnect
+     * @default true
+     */
+    autoReconnect?: boolean;
+    /**
+     * Maximum reconnection attempts
+     * @default 5
+     */
+    maxReconnectAttempts?: number;
+    /**
+     * Enable verbose logging
+     * @default false
+     */
+    verbose?: boolean;
+}
+/**
+ * Simplified configuration for quick setup
+ *
+ * Can be just a broker URL string or a full config object
+ *
+ * @example
+ * ```typescript
+ * // Simple
+ * const config: KadiConfig = 'ws://localhost:8080';
+ *
+ * // Full
+ * const config: KadiConfig = {
+ *   name: 'my-service',
+ *   broker: 'ws://localhost:8080'
+ * };
+ * ```
+ */
+export type KadiConfig = string | KadiClientConfig;
+/**
+ * Service configuration (simplified for service creation)
+ *
+ * @example
+ * ```typescript
+ * const config: ServiceConfig = {
+ *   name: 'calculator',
+ *   broker: 'ws://localhost:8080'
+ * };
+ * ```
+ */
+export interface ServiceConfig {
+    /**
+     * Service name
+     */
+    name: string;
+    /**
+     * Broker URL or name
+     */
+    broker?: string;
+    /**
+     * Version
+     */
+    version?: string;
+    /**
+     * Description
+     */
+    description?: string;
+    /**
+     * Networks to join
+     */
+    networks?: string[];
+}
+/**
+ * Ability loading options
+ *
+ * @deprecated Use {@link LoadOptions} from '@kadi.build/core/abilities' instead
+ *
+ * **Migration Guide:**
+ * ```typescript
+ * // OLD (deprecated)
+ * import type { LoadAbilityOptions } from '@kadi.build/core/types';
+ * const options: LoadAbilityOptions = {
+ *   transport: 'broker',
+ *   networks: ['global']
+ * };
+ *
+ * // NEW (recommended)
+ * import type { LoadOptions } from '@kadi.build/core/abilities';
+ * const options: LoadOptions = {
+ *   transport: 'broker',
+ *   networks: ['global']
+ * };
+ * ```
+ *
+ * **Benefits of new LoadOptions:**
+ * - Type-safe discriminated unions (only relevant fields per transport)
+ * - Better autocomplete
+ * - Compile-time validation
+ * - Auto-detection support
+ *
+ * This interface kept temporarily for backward compatibility.
+ * Will be removed in next major version.
+ */
+export interface LoadAbilityOptions {
+    /**
+     * Transport protocol to use
+     * @deprecated Use LoadOptions from abilities module
+     */
+    transport?: TransportKind;
+    /**
+     * Version constraint (semver)
+     * @deprecated Use LoadOptions from abilities module
+     */
+    version?: string;
+    /**
+     * Networks to search in (for broker transport)
+     * @deprecated Use LoadOptions from abilities module
+     */
+    networks?: string[];
+    /**
+     * Specific broker to use (overrides client default)
+     * @deprecated Use LoadOptions from abilities module
+     */
+    broker?: string;
+    /**
+     * Timeout for loading
+     * @deprecated Use LoadOptions from abilities module
+     */
+    timeout?: number;
+    /**
+     * Path to ability directory (for native/stdio transports)
+     * @deprecated Use LoadOptions from abilities module
+     */
+    path?: string;
+}
+/**
+ * Configuration loaded from agent.json file
+ */
+export interface AgentJsonConfig {
+    /**
+     * Agent name
+     */
+    name: string;
+    /**
+     * Version
+     */
+    version?: string;
+    /**
+     * Description
+     */
+    description?: string;
+    /**
+     * Broker configuration
+     */
+    brokers?: Record<string, string>;
+    /**
+     * Default broker
+     */
+    defaultBroker?: string;
+    /**
+     * Networks
+     */
+    networks?: string[];
+    /**
+     * Tools/capabilities this agent provides
+     */
+    tools?: Array<{
+        name: string;
+        handler: string;
+        schema?: Record<string, unknown>;
+    }>;
+    /**
+     * Other metadata
+     */
+    [key: string]: unknown;
+}
+/**
+ * Environment variable configuration
+ */
+export interface EnvConfig {
+    /**
+     * KADI_BROKER_URL
+     */
+    KADI_BROKER_URL?: string;
+    /**
+     * KADI_NETWORKS (comma-separated)
+     */
+    KADI_NETWORKS?: string;
+    /**
+     * KADI_TRANSPORT
+     */
+    KADI_TRANSPORT?: TransportKind;
+    /**
+     * KADI_AGENT_NAME
+     */
+    KADI_AGENT_NAME?: string;
+    /**
+     * KADI_AUTO_CONNECT
+     */
+    KADI_AUTO_CONNECT?: string;
+}
+/**
+ * Resolved configuration after merging all sources
+ */
+export interface ResolvedConfig extends Required<KadiClientConfig> {
+    /**
+     * Configuration source for each field
+     */
+    sources: {
+        [K in keyof KadiClientConfig]?: ConfigSource;
+    };
+}
+/**
+ * Configuration source
+ */
+export declare enum ConfigSource {
+    CODE = "code",
+    ENVIRONMENT = "environment",
+    FILE = "file",
+    DEFAULT = "default"
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAE1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,gBAAgB,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAE1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC,CAAC;IAEH;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,aAAa,CAAC;IAE/B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,QAAQ,CAAC,gBAAgB,CAAC;IAChE;;OAEG;IACH,OAAO,EAAE;SACN,CAAC,IAAI,MAAM,gBAAgB,CAAC,CAAC,EAAE,YAAY;KAC7C,CAAC;CACH;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,OAAO,YAAY;CACpB"}

package/dist/types/config.js

@@ -0,0 +1,17 @@
+/**
+ * Configuration Types
+ *
+ * Type definitions for KADI client and service configuration.
+ * Clear precedence: Code > Environment > File > Defaults
+ */
+/**
+ * Configuration source
+ */
+export var ConfigSource;
+(function (ConfigSource) {
+    ConfigSource["CODE"] = "code";
+    ConfigSource["ENVIRONMENT"] = "environment";
+    ConfigSource["FILE"] = "file";
+    ConfigSource["DEFAULT"] = "default";
+})(ConfigSource || (ConfigSource = {}));
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoWH;;GAEG;AACH,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,2CAA2B,CAAA;IAC3B,6BAAa,CAAA;IACb,mCAAmB,CAAA;AACrB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB"}