@kadi.build/core 0.0.1-alpha.8 → 0.1.0

package/dist/schemas/events.schemas.js

@@ -1,265 +0,0 @@
-/**
- * Event System Schema Validation
- * ------------------------------
- * Zod schemas for validating event system parameters and messages.
- * This ensures type safety and proper input validation for all event operations.
- *
- * The schemas follow the established patterns in the KADI broker for consistency
- * and integrate with the existing validation middleware.
- */
-import { z } from 'zod';
-import { NetworkIdSchema } from './kadi.schemas.js';
-// ============================================================================
-// EVENT CHANNEL VALIDATION
-// ============================================================================
-/**
- * Event channel pattern validation schema.
- *
- * Enforces the hierarchical naming convention:
- * - Format: namespace.event-name or namespace.category.event-name
- * - Examples: 'system.startup', 'tool.completed', 'agent.status.changed'
- * - Wildcards: '*' matches one segment, '#' matches multiple segments
- *
- * Rules:
- * - Must start with lowercase letter
- * - Segments separated by dots
- * - Only lowercase letters, numbers, underscores, hyphens allowed
- * - Wildcards * and # only allowed at end of segments
- */
-export const EventChannelSchema = z
-    .string()
-    .min(1, 'Event channel cannot be empty')
-    .max(128, 'Event channel too long')
-    .regex(/^[a-z][a-z0-9_-]*(?:\.[a-z0-9_*#-]+)*$/, 'Event channel must use lowercase with dots (e.g., "system.startup", "tool.*", "agent.#")')
-    .describe('Event channel pattern for subscriptions');
-// ============================================================================
-// EVENT SUBSCRIPTION SCHEMAS
-// ============================================================================
-/**
- * Schema for event subscription requests (kadi.event.subscribe)
- */
-export const EventSubscribeSchema = z
-    .object({
-    /** Array of event channel patterns to subscribe to */
-    channels: z
-        .array(EventChannelSchema)
-        .min(1, 'Must specify at least one channel')
-        .max(50, 'Too many channels in single subscription'),
-    /** Optional network to subscribe within - defaults to agent's networks */
-    networkId: NetworkIdSchema.optional(),
-    /** Optional filters to reduce event volume */
-    filter: z
-        .object({
-        /** Only receive events from specific publisher */
-        publisherId: z.string().optional(),
-        /** Only receive events with matching metadata */
-        metadata: z.record(z.string(), z.unknown()).optional()
-    })
-        .optional()
-})
-    .strict(); // Prevent additional properties
-/**
- * Schema for event subscription response
- */
-export const EventSubscribeResultSchema = z
-    .object({
-    /** Channels that were successfully subscribed to */
-    subscribed: z.array(EventChannelSchema),
-    /** Internal queue name for debugging/monitoring */
-    queueName: z.string()
-})
-    .strict();
-// ============================================================================
-// EVENT UNSUBSCRIPTION SCHEMAS
-// ============================================================================
-/**
- * Schema for event unsubscription requests (kadi.event.unsubscribe)
- */
-export const EventUnsubscribeSchema = z
-    .object({
-    /** Channel patterns to unsubscribe from */
-    channels: z
-        .array(EventChannelSchema)
-        .min(1, 'Must specify at least one channel'),
-    /** Network to unsubscribe from - defaults to 'global' */
-    networkId: NetworkIdSchema.optional()
-})
-    .strict();
-/**
- * Schema for event unsubscription response
- */
-export const EventUnsubscribeResultSchema = z
-    .object({
-    /** Channels that were successfully unsubscribed */
-    unsubscribed: z.array(EventChannelSchema)
-})
-    .strict();
-// ============================================================================
-// EVENT PUBLISHING SCHEMAS
-// ============================================================================
-/**
- * Schema for event publishing requests (kadi.event.publish)
- */
-export const EventPublishSchema = z
-    .object({
-    /** Event channel to publish to - must not contain wildcards */
-    channel: EventChannelSchema.refine((channel) => !channel.includes('*') && !channel.includes('#'), 'Cannot publish to wildcard channels - use specific channel names'),
-    /** Event payload data - any serializable value */
-    data: z.unknown(),
-    /** Networks to publish to - defaults to publisher's networks */
-    networks: z
-        .array(NetworkIdSchema)
-        .max(10, 'Cannot publish to more than 10 networks at once')
-        .optional(),
-    /** Optional metadata to include with the event */
-    metadata: z.record(z.string(), z.unknown()).optional()
-})
-    .strict();
-/**
- * Schema for event publishing response
- */
-export const EventPublishResultSchema = z
-    .object({
-    /** Whether the event was successfully published */
-    published: z.boolean(),
-    /** Unique identifier for this event (for tracking/debugging) */
-    eventId: z.string().uuid()
-})
-    .strict();
-// ============================================================================
-// EVENT LISTING SCHEMAS
-// ============================================================================
-/**
- * Schema for event subscription listing requests (kadi.event.list)
- */
-export const EventListSchema = z
-    .object({
-    /** Filter subscriptions by agent ID */
-    agentId: z.string().optional(),
-    /** Filter subscriptions by network */
-    networkId: NetworkIdSchema.optional()
-})
-    .strict();
-/**
- * Schema for event subscription listing response
- */
-export const EventListResultSchema = z
-    .object({
-    /** Array of active subscriptions */
-    subscriptions: z.array(z.object({
-        agentId: z.string(),
-        channels: z.array(EventChannelSchema),
-        networks: z.array(NetworkIdSchema),
-        queueName: z.string(),
-        subscribedAt: z.string().datetime() // ISO 8601 timestamp
-    }))
-})
-    .strict();
-// ============================================================================
-// EVENT MESSAGE SCHEMAS
-// ============================================================================
-/**
- * Schema for validating event messages before delivery.
- * This ensures all events have consistent structure when delivered to subscribers.
- */
-export const EventMessageSchema = z
-    .object({
-    /** The channel this event was published to */
-    channel: EventChannelSchema,
-    /** Event-specific payload data */
-    data: z.unknown(),
-    /** ISO 8601 timestamp when event was published */
-    timestamp: z.string().datetime(),
-    /** ID of the agent/tool that published this event */
-    publisherId: z.string(),
-    /** Network where this event was published */
-    networkId: NetworkIdSchema,
-    /** Optional metadata for correlation and tracking */
-    metadata: z
-        .object({
-        /** For tracking related events across the system */
-        correlationId: z.string().optional(),
-        /** Event schema version for evolution */
-        version: z.string().optional(),
-        /** Event ID for deduplication and tracing */
-        eventId: z.string().uuid().optional(),
-        /** Role of the publisher (agent, tool, system) */
-        publisherRole: z.string().optional()
-        /** Additional custom metadata */
-    })
-        .catchall(z.unknown())
-        .optional() // Allow additional metadata fields
-})
-    .strict();
-// ============================================================================
-// VALIDATION MIDDLEWARE INTEGRATION
-// ============================================================================
-/**
- * Validation middleware for event system methods.
- * Extends the existing ValidationMiddleware pattern to support event operations.
- */
-export class EventValidationMiddleware {
-    /**
-     * Validates parameters for event system methods using appropriate schemas
-     */
-    static validateEventParams(method, params) {
-        switch (method) {
-            case 'kadi.event.subscribe':
-                return EventSubscribeSchema.parse(params);
-            case 'kadi.event.unsubscribe':
-                return EventUnsubscribeSchema.parse(params);
-            case 'kadi.event.publish':
-                return EventPublishSchema.parse(params);
-            case 'kadi.event.list':
-                return EventListSchema.parse(params);
-            default:
-                // For non-event methods, return params as-is
-                return params;
-        }
-    }
-    /**
-     * Validates event message structure before delivery
-     */
-    static validateEventMessage(message) {
-        return EventMessageSchema.parse(message);
-    }
-    /**
-     * Provides user-friendly error messages for common validation failures
-     */
-    static getValidationHint(method, error) {
-        const firstError = error.issues[0];
-        switch (method) {
-            case 'kadi.event.subscribe':
-                if (firstError?.path.includes('channels')) {
-                    return 'Check channel format: use lowercase with dots (e.g., "system.startup", "tool.*")';
-                }
-                break;
-            case 'kadi.event.publish':
-                if (firstError?.path.includes('channel')) {
-                    return 'Channel must be specific (no wildcards) and use lowercase.separated format';
-                }
-                if (firstError?.path.includes('networks')) {
-                    return 'Networks must be an array of valid network IDs';
-                }
-                break;
-            default:
-                return 'Check your event parameters for correct format and types';
-        }
-        return 'Check the event system documentation for parameter requirements';
-    }
-}
-// ============================================================================
-// SCHEMA EXPORTS FOR EXTERNAL USE
-// ============================================================================
-/**
- * Export all schemas for use in tests and external validation
- */
-export const EventSchemas = {
-    EventChannel: EventChannelSchema,
-    EventSubscribe: EventSubscribeSchema,
-    EventUnsubscribe: EventUnsubscribeSchema,
-    EventPublish: EventPublishSchema,
-    EventList: EventListSchema,
-    EventMessage: EventMessageSchema
-};
-//# sourceMappingURL=events.schemas.js.map

package/dist/schemas/events.schemas.js.map

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

package/dist/schemas/index.d.ts

@@ -1,3 +0,0 @@
-export * from './kadi.schemas.js';
-export * from './events.schemas.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/schemas/index.js

@@ -1,4 +0,0 @@
-// Export all schemas from a single entry point
-export * from './kadi.schemas.js';
-export * from './events.schemas.js';
-//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/schemas/kadi.schemas.d.ts

@@ -1,70 +0,0 @@
-import { z } from 'zod';
-export declare const NetworkIdSchema: z.ZodString;
-export declare const ToolNameSchema: z.ZodString;
-export declare const ToolSchema: z.ZodObject<{
-    name: z.ZodString;
-    title: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    version: z.ZodOptional<z.ZodString>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    networks: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export declare const MailboxModeSchema: z.ZodEnum<{
-    volatile: "volatile";
-    persistent: "persistent";
-}>;
-export declare const AgentIdSchema: z.ZodString;
-export declare const KadiRegisterParamsSchema: z.ZodObject<{
-    tools: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        title: z.ZodOptional<z.ZodString>;
-        description: z.ZodOptional<z.ZodString>;
-        version: z.ZodOptional<z.ZodString>;
-        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        networks: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>>>;
-    displayName: z.ZodOptional<z.ZodString>;
-    mailboxMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        volatile: "volatile";
-        persistent: "persistent";
-    }>>>;
-    networks: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>;
-    parentAgentId: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type KadiRegisterParams = z.infer<typeof KadiRegisterParamsSchema>;
-export declare const KadiRegisterResultSchema: z.ZodObject<{
-    agentId: z.ZodString;
-    registered: z.ZodNumber;
-    networks: z.ZodArray<z.ZodString>;
-    mailbox: z.ZodString;
-    mailboxMode: z.ZodEnum<{
-        volatile: "volatile";
-        persistent: "persistent";
-    }>;
-}, z.core.$strip>;
-export type KadiRegisterResult = z.infer<typeof KadiRegisterResultSchema>;
-export declare const KadiToolListParamsSchema: z.ZodObject<{
-    networks: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export type KadiToolListParams = z.infer<typeof KadiToolListParamsSchema>;
-export declare const KadiToolInvokeParamsSchema: z.ZodObject<{
-    toolName: z.ZodString;
-    toolInput: z.ZodOptional<z.ZodUnknown>;
-    requestId: z.ZodOptional<z.ZodString>;
-    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-}, z.core.$strip>;
-export type KadiToolInvokeParams = z.infer<typeof KadiToolInvokeParamsSchema>;
-export declare const KadiToolResultParamsSchema: z.ZodObject<{
-    requestId: z.ZodString;
-    result: z.ZodOptional<z.ZodUnknown>;
-    error: z.ZodOptional<z.ZodUnknown>;
-    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-}, z.core.$strip>;
-export type KadiToolResultParams = z.infer<typeof KadiToolResultParamsSchema>;
-export declare class ValidationMiddleware {
-    static validateParams<T>(method: string, params: unknown): T;
-}
-//# sourceMappingURL=kadi.schemas.d.ts.map

package/dist/schemas/kadi.schemas.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kadi.schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/kadi.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,eAAe,aAKK,CAAC;AAMlC,eAAO,MAAM,cAAc,aAmB2B,CAAC;AAGvD,eAAO,MAAM,UAAU;;;;;;;;iBAWrB,CAAC;AAGH,eAAO,MAAM,iBAAiB;;;EAAqC,CAAC;AAGpE,eAAO,MAAM,aAAa,aAKK,CAAC;AAOhC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;iBAiBjC,CAAC;AAEL,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAG1E,eAAO,MAAM,wBAAwB;;;;;;;;;iBAMnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAG1E,eAAO,MAAM,wBAAwB;;iBAEnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAG1E,eAAO,MAAM,0BAA0B;;;;;;iBAMrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAG9E,eAAO,MAAM,0BAA0B;;;;;iBAKrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC;CAc7D"}

package/dist/schemas/kadi.schemas.js

@@ -1,120 +0,0 @@
-import { z } from 'zod';
-// ============================================================================
-// NETWORK VALIDATION SCHEMAS
-// ============================================================================
-// Network ID validation
-export const NetworkIdSchema = z
-    .string()
-    .min(1)
-    .max(128)
-    .regex(/^[a-z0-9][a-z0-9-_.]*$/i)
-    .describe('Network identifier');
-// Tool name validation - Supports both legacy and namespaced formats
-// Namespaced format: <namespace>/<name>@<major>[.<minor>]
-// Legacy format: simple name (will be auto-normalized)
-// Examples: 'data/analyze_dataset@1', 'kadi/echo@1.0', 'legacy_tool'
-export const ToolNameSchema = z
-    .string()
-    .min(1)
-    .max(128)
-    .refine((val) => {
-    // Allow legacy format (simple names)
-    const legacyRegex = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
-    // Strict namespaced format
-    const namespacedRegex = /^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._-]*@\d+(?:\.\d+)?$/;
-    return legacyRegex.test(val) || namespacedRegex.test(val);
-}, {
-    message: 'Tool name must be either legacy format (alphanumeric) or namespaced format (<namespace>/<name>@<version>)'
-})
-    .describe('Tool name - legacy or namespaced format');
-// Tool schema with networks, namespace, and versioning
-export const ToolSchema = z.object({
-    name: ToolNameSchema, // Now supports namespace/name@version format
-    title: z.string().min(1).max(128).optional(), // Human-readable title
-    description: z.string().optional(),
-    version: z
-        .string()
-        .regex(/^\d+\.\d+\.\d+$/)
-        .optional(), // Semantic version
-    tags: z.array(z.string()).optional(), // Routing hints like ['cpu-heavy', 'batch']
-    inputSchema: z.record(z.string(), z.unknown()).optional(),
-    networks: z.array(NetworkIdSchema).optional()
-});
-// Mailbox mode validation
-export const MailboxModeSchema = z.enum(['volatile', 'persistent']);
-// Agent ID validation
-export const AgentIdSchema = z
-    .string()
-    .min(1)
-    .max(64)
-    .regex(/^[a-z0-9]+$/i)
-    .describe('Agent identifier');
-// ============================================================================
-// KADI PROTOCOL MESSAGE SCHEMAS
-// ============================================================================
-// Registration Schema - Updated to use 'networks' instead of 'scopes'
-export const KadiRegisterParamsSchema = z
-    .object({
-    tools: z.array(ToolSchema).optional().default([]),
-    displayName: z.string().min(1).max(64).optional(),
-    mailboxMode: MailboxModeSchema.optional().default('volatile'),
-    networks: z
-        .union([
-        // Changed from 'scopes'
-        NetworkIdSchema,
-        z.array(NetworkIdSchema)
-    ])
-        .transform((val) => (Array.isArray(val) ? val : [val])),
-    parentAgentId: AgentIdSchema.optional()
-})
-    .refine((data) => data.networks.length > 0, {
-    message: 'At least one network must be specified',
-    path: ['networks']
-});
-// Registration Result
-export const KadiRegisterResultSchema = z.object({
-    agentId: z.string(),
-    registered: z.number(),
-    networks: z.array(NetworkIdSchema),
-    mailbox: z.string(),
-    mailboxMode: MailboxModeSchema
-});
-// Tool List params - Changed from 'scopes'
-export const KadiToolListParamsSchema = z.object({
-    networks: z.array(NetworkIdSchema).optional() // Filter by networks
-});
-// Tool invocation params
-export const KadiToolInvokeParamsSchema = z.object({
-    toolName: ToolNameSchema,
-    toolInput: z.unknown().optional(),
-    requestId: z.string().optional(),
-    timeout: z.number().min(1000).max(300000).optional().default(30000),
-    metadata: z.record(z.string(), z.unknown()).optional().default({})
-});
-// Tool result params
-export const KadiToolResultParamsSchema = z.object({
-    requestId: z.string(),
-    result: z.unknown().optional(),
-    error: z.unknown().optional(),
-    metadata: z.record(z.string(), z.unknown()).optional().default({})
-});
-// ============================================================================
-// VALIDATION MIDDLEWARE
-// ============================================================================
-export class ValidationMiddleware {
-    static validateParams(method, params) {
-        switch (method) {
-            case 'kadi.agent.register':
-                return KadiRegisterParamsSchema.parse(params);
-            case 'kadi.ability.list':
-                return KadiToolListParamsSchema.parse(params);
-            case 'kadi.ability.invoke':
-                return KadiToolInvokeParamsSchema.parse(params);
-            case 'kadi.ability.result':
-                return KadiToolResultParamsSchema.parse(params);
-            default:
-                return params;
-        }
-    }
-}
-//# sourceMappingURL=kadi.schemas.js.map

package/dist/schemas/kadi.schemas.js.map

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

package/dist/transports/BrokerTransport.d.ts

@@ -1,102 +0,0 @@
-/**
- * BrokerTransport - Handles communication with remote abilities via broker
- *
- * This transport connects to a broker (WebSocket server) to invoke methods
- * on remote agents/abilities. Unlike Native and Stdio transports which load
- * local code, BrokerTransport is purely a client that calls remote services.
- *
- * The broker acts as a message router, allowing agents to discover and
- * invoke each other's methods across network boundaries.
- *
- * Communication Flow:
- * 1. Connect to broker via WebSocket
- * 2. Authenticate and join networks
- * 3. Discover available methods from target agent
- * 4. Send method invocations through broker
- * 5. Receive results back through broker
- */
-import { EventEmitter } from 'events';
-import { Transport, TransportOptions } from './Transport.js';
-import { KadiClient } from '../KadiClient.js';
-/**
- * Options specific to BrokerTransport
- */
-interface BrokerTransportOptions extends TransportOptions {
-    /**
-     * The target agent name we want to call methods on
-     * This is the remote agent that has the methods we want to invoke
-     */
-    targetAgent: string;
-    /**
-     * Existing KadiClient to reuse (if already connected to broker)
-     */
-    existingClient?: KadiClient;
-    /**
-     * WebSocket URL of the broker (required if no existing client)
-     */
-    brokerUrl?: string;
-    /**
-     * Name of the broker (for logging/identification)
-     */
-    brokerName?: string;
-    /**
-     * Networks to join for discovering agents
-     */
-    networks?: string[];
-}
-/**
- * BrokerTransport - Client for invoking methods on remote agents
- *
- * This transport is a thin wrapper around KadiClient's broker functionality.
- * It creates an ephemeral KadiClient instance that connects to the broker
- * solely for the purpose of calling methods on a remote agent.
- *
- * Unlike serving mode (where an agent registers its own methods),
- * this transport is purely a consumer of remote methods.
- */
-export declare class BrokerTransport extends EventEmitter implements Transport {
-    private options;
-    private logger;
-    private client;
-    private targetAgent;
-    private connected;
-    constructor(options: BrokerTransportOptions);
-    /**
-     * Connect to the broker and discover target agent's methods
-     *
-     * This creates an ephemeral KadiClient that connects to the broker
-     * as a client (not serving any methods of its own).
-     */
-    connect(): Promise<void>;
-    /**
-     * Invoke a method on the remote agent
-     *
-     * Sends the method invocation through the broker to the target agent.
-     */
-    invoke(method: string, params: unknown): Promise<unknown>;
-    /**
-     * Get list of discovered methods
-     *
-     * Returns empty array as broker transport doesn't do method discovery.
-     */
-    getMethods(): string[];
-    /**
-     * Disconnect from the broker
-     *
-     * Since we're reusing an existing client, we don't actually disconnect it
-     * (other parts of the app might still be using it)
-     */
-    disconnect(): Promise<void>;
-    /**
-     * Check if transport is connected
-     */
-    isConnected(): boolean;
-    /**
-     * Get the target agent name
-     *
-     * Useful for debugging and logging
-     */
-    getTargetAgent(): string;
-}
-export {};
-//# sourceMappingURL=BrokerTransport.d.ts.map

package/dist/transports/BrokerTransport.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BrokerTransport.d.ts","sourceRoot":"","sources":["../../src/transports/BrokerTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;GAEG;AACH,UAAU,sBAAuB,SAAQ,gBAAgB;IACvD;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,UAAU,CAAC;IAE5B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,YAAa,YAAW,SAAS;IAMxD,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;gBAEN,OAAO,EAAE,sBAAsB;IAgBnD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4G9B;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA2B/D;;;;OAIG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACH,cAAc,IAAI,MAAM;CAGzB"}