@agentick/core 0.0.1 → 0.1.9

package/dist/component/tentickle-component.js

@@ -1,182 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-/**
- * TentickleComponent - React.Component base class for Tentickle
- *
- * Extends React.Component to work seamlessly with the reconciler while providing
- * access to Tentickle-specific features like COM, TickState, and lifecycle hooks.
- *
- * @example
- * ```tsx
- * class MyAgent extends TentickleComponent {
- *   onTickStart() {
- *     console.log(`Tick ${this.tickState.tick} starting`);
- *   }
- *
- *   render() {
- *     const history = this.tickState.previous?.timeline ?? [];
- *     return (
- *       <>
- *         <Section id="system" audience="model">
- *           You are a helpful assistant.
- *         </Section>
- *         {history.map((entry, i) => (
- *           <Message key={i} {...entry.message} />
- *         ))}
- *       </>
- *     );
- *   }
- * }
- * ```
- */
-import React, {} from "react";
-import { COMContext, TickStateContext } from "../hooks/context-internal";
-/**
- * Internal wrapper that consumes contexts and passes them to the component.
- */
-function TentickleComponentWrapper({ componentClass: ComponentClass, props, }) {
-    return (_jsx(COMContext.Consumer, { children: (com) => (_jsx(TickStateContext.Consumer, { children: (tickState) => {
-                // Create instance with context values
-                const instance = new ComponentClass(props);
-                instance._setContextValues({ com, tickState });
-                return instance._renderWithLifecycle();
-            } })) }));
-}
-/**
- * Base class for class-based Tentickle components.
- *
- * Extends React.Component and provides:
- * - Access to COM via `this.com`
- * - Access to TickState via `this.tickState`
- * - Tentickle lifecycle methods (onMount, onTickStart, etc.)
- *
- * @example
- * ```tsx
- * class TaskAgent extends TentickleComponent<{ maxTasks?: number }> {
- *   onMount() {
- *     console.log('Agent mounted');
- *   }
- *
- *   onTickStart() {
- *     console.log(`Starting tick ${this.tickState.tick}`);
- *   }
- *
- *   render() {
- *     return (
- *       <Section id="system" audience="model">
- *         You can manage up to {this.props.maxTasks ?? 10} tasks.
- *       </Section>
- *     );
- *   }
- * }
- *
- * // Usage
- * <TaskAgent maxTasks={5} />
- * ```
- */
-export class TentickleComponent extends React.Component {
-    // Context values (set by wrapper)
-    _com = null;
-    _tickState = null;
-    _mounted = false;
-    _lastTick = -1;
-    /**
-     * Access the Context Object Model.
-     * Provides access to timeline, sections, tools, state, and more.
-     */
-    get com() {
-        if (!this._com) {
-            throw new Error("COM not available. TentickleComponent must be used within a Tentickle execution context.");
-        }
-        return this._com;
-    }
-    /**
-     * Access the current tick state.
-     * Provides tick number, previous output, current output, and stop control.
-     */
-    get tickState() {
-        if (!this._tickState) {
-            throw new Error("TickState not available. TentickleComponent must be used within a Tentickle execution context.");
-        }
-        return this._tickState;
-    }
-    /**
-     * Shortcut to get the previous timeline (conversation history).
-     */
-    get history() {
-        return this.tickState.previous?.timeline ?? [];
-    }
-    /**
-     * Shortcut to get the current tick number.
-     */
-    get tick() {
-        return this.tickState.tick;
-    }
-    /**
-     * Internal: Set context values from wrapper.
-     */
-    _setContextValues(values) {
-        this._com = values.com;
-        this._tickState = values.tickState;
-    }
-    /**
-     * Internal: Render with lifecycle management.
-     *
-     * Note: onTickEnd is not called from class components directly.
-     * Use useTickEnd hook or createTool for tick end callbacks.
-     */
-    _renderWithLifecycle() {
-        // Handle mount
-        if (!this._mounted) {
-            this._mounted = true;
-            this.onMount?.();
-        }
-        // Handle tick start (only once per tick)
-        const currentTick = this._tickState?.tick ?? 0;
-        if (currentTick !== this._lastTick) {
-            this._lastTick = currentTick;
-            if (this.onTickStart && this._com && this._tickState) {
-                this.onTickStart(this._com, this._tickState);
-            }
-        }
-        // Call render
-        const result = this.render();
-        return result;
-    }
-    // ============================================================================
-    // React Lifecycle Integration
-    // ============================================================================
-    componentWillUnmount() {
-        this.onUnmount?.();
-    }
-}
-// ============================================================================
-// Factory Function
-// ============================================================================
-/**
- * Create a functional component from a TentickleComponent class.
- *
- * This is needed because React's reconciler needs a function component
- * to consume contexts and create the class instance.
- *
- * @example
- * ```tsx
- * class MyAgent extends TentickleComponent {
- *   render() { return <Section id="system">Hello</Section>; }
- * }
- *
- * // Create the usable component
- * const MyAgentComponent = createClassComponent(MyAgent);
- *
- * // Use in JSX
- * <MyAgentComponent />
- * ```
- */
-export function createClassComponent(ComponentClass) {
-    const WrappedComponent = (props) => {
-        return _jsx(TentickleComponentWrapper, { componentClass: ComponentClass, props: props });
-    };
-    // Preserve the original class name for debugging
-    WrappedComponent.displayName = ComponentClass.name || "TentickleComponent";
-    return WrappedComponent;
-}
-//# sourceMappingURL=tentickle-component.js.map

package/dist/component/tentickle-component.js.map

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

package/dist/core/channel-helpers.d.ts

@@ -1,31 +0,0 @@
-import { Channel, type ChannelEvent } from "./channel";
-/**
- * Helper functions for accessing channels from KernelContext.
- * These provide convenient access patterns for tools and components.
- */
-/**
- * Get a channel from the current context.
- * @throws Error if channels are not available in context
- */
-export declare function getChannel(channelName: string): Channel;
-/**
- * Publish an event to a channel using the current context.
- * @throws Error if channels are not available in context
- */
-export declare function publishChannel(channelName: string, event: Omit<ChannelEvent, "channel">): void;
-/**
- * Subscribe to events on a channel using the current context.
- * @returns Unsubscribe function
- * @throws Error if channels are not available in context
- */
-export declare function subscribeChannel(channelName: string, handler: (event: ChannelEvent) => void): () => void;
-/**
- * Wait for a response on a channel using the current context.
- * @throws Error if channels are not available in context
- */
-export declare function waitForChannelResponse(channelName: string, requestId: string, timeoutMs?: number): Promise<ChannelEvent>;
-/**
- * Try to get a channel from the current context (returns undefined if not available).
- */
-export declare function tryGetChannel(channelName: string): Channel | undefined;
-//# sourceMappingURL=channel-helpers.d.ts.map

package/dist/core/channel-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"channel-helpers.d.ts","sourceRoot":"","sources":["../../src/core/channel-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAGvD;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAQvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,GAAG,IAAI,CAQ9F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACrC,MAAM,IAAI,CAQZ;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC,CAQvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAMtE"}

package/dist/core/channel-helpers.js

@@ -1,62 +0,0 @@
-import { Channel } from "./channel";
-import { Context } from "./context";
-/**
- * Helper functions for accessing channels from KernelContext.
- * These provide convenient access patterns for tools and components.
- */
-/**
- * Get a channel from the current context.
- * @throws Error if channels are not available in context
- */
-export function getChannel(channelName) {
-    const ctx = Context.get();
-    if (!ctx.channels) {
-        throw new Error("Channels are not available in the current context. Ensure channels are configured in EngineConfig.");
-    }
-    return ctx.channels.getChannel(ctx, channelName);
-}
-/**
- * Publish an event to a channel using the current context.
- * @throws Error if channels are not available in context
- */
-export function publishChannel(channelName, event) {
-    const ctx = Context.get();
-    if (!ctx.channels) {
-        throw new Error("Channels are not available in the current context. Ensure channels are configured in EngineConfig.");
-    }
-    ctx.channels.publish(ctx, channelName, event);
-}
-/**
- * Subscribe to events on a channel using the current context.
- * @returns Unsubscribe function
- * @throws Error if channels are not available in context
- */
-export function subscribeChannel(channelName, handler) {
-    const ctx = Context.get();
-    if (!ctx.channels) {
-        throw new Error("Channels are not available in the current context. Ensure channels are configured in EngineConfig.");
-    }
-    return ctx.channels.subscribe(ctx, channelName, handler);
-}
-/**
- * Wait for a response on a channel using the current context.
- * @throws Error if channels are not available in context
- */
-export function waitForChannelResponse(channelName, requestId, timeoutMs) {
-    const ctx = Context.get();
-    if (!ctx.channels) {
-        throw new Error("Channels are not available in the current context. Ensure channels are configured in EngineConfig.");
-    }
-    return ctx.channels.waitForResponse(ctx, channelName, requestId, timeoutMs);
-}
-/**
- * Try to get a channel from the current context (returns undefined if not available).
- */
-export function tryGetChannel(channelName) {
-    const ctx = Context.tryGet();
-    if (!ctx?.channels) {
-        return undefined;
-    }
-    return ctx.channels.getChannel(ctx, channelName);
-}
-//# sourceMappingURL=channel-helpers.js.map

package/dist/core/channel-helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"channel-helpers.js","sourceRoot":"","sources":["../../src/core/channel-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAqB,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,KAAoC;IACtF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAC;IACJ,CAAC;IACD,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAmB,EACnB,OAAsC;IAEtC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,SAAiB,EACjB,SAAkB;IAElB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC"}

package/dist/core/channel.d.ts

@@ -1,164 +0,0 @@
-import type { KernelContext } from "./context";
-/**
- * Target specification for event routing.
- * Used by transports to determine which connections receive the event.
- *
- * Inspired by Socket.io patterns:
- * - emit: send to target (may include sender)
- * - broadcast: send to target excluding sender
- */
-export interface ChannelTarget {
-    /**
-     * Send to specific connection by ID.
-     */
-    connectionId?: string;
-    /**
-     * Send to all connections in these rooms.
-     * Rooms are arbitrary strings - application decides naming convention.
-     * Examples: 'user:123', 'tenant:abc', 'thread:xyz'
-     */
-    rooms?: string[];
-    /**
-     * Broadcast mode: exclude the source connection from delivery.
-     * Requires metadata.sourceConnectionId to be set.
-     *
-     * Mimics Socket.io's socket.broadcast.emit() pattern:
-     * - false (default): emit to all targets including sender
-     * - true: broadcast to all targets except sender
-     */
-    excludeSender?: boolean;
-}
-/**
- * Normalized channel event structure.
- * Loosely structured but normalized for consistency.
- */
-export interface ChannelEvent {
-    /**
-     * Event type (normalized patterns: 'request', 'response', 'progress', 'status', 'error')
-     */
-    type: string;
-    /**
-     * Request/response correlation ID (for bidirectional communication)
-     */
-    id?: string;
-    /**
-     * Channel name (e.g., 'ui:progress', 'ui:user-input', 'tool:status')
-     */
-    channel: string;
-    /**
-     * Flexible event payload
-     */
-    payload: any;
-    /**
-     * Optional metadata
-     */
-    metadata?: {
-        timestamp?: number;
-        source?: string;
-        executionId?: string;
-        tick?: number;
-        sourceConnectionId?: string;
-        [key: string]: unknown;
-    };
-    /**
-     * Optional routing target.
-     * If not specified, event is broadcast to all channel subscribers.
-     * Used by transports for targeted delivery.
-     */
-    target?: ChannelTarget;
-}
-/**
- * Core Channel primitive.
- * Works standalone in any Node environment.
- * Uses EventEmitter internally for pub/sub.
- */
-export declare class Channel {
-    readonly name: string;
-    private emitter;
-    private pendingRequests;
-    private recentResponses;
-    constructor(name: string);
-    /**
-     * Publish an event to the channel.
-     */
-    publish(event: ChannelEvent): void;
-    /**
-     * Subscribe to events on this channel.
-     * @returns Unsubscribe function
-     */
-    subscribe(handler: (event: ChannelEvent) => void): () => void;
-    /**
-     * Wait for a response to a specific request.
-     * Used by tools/components for bidirectional communication.
-     *
-     * @param requestId The request ID to wait for
-     * @param timeoutMs Timeout in milliseconds (default: 30000)
-     * @returns Promise that resolves when response is received
-     */
-    waitForResponse(requestId: string, timeoutMs?: number): Promise<ChannelEvent>;
-    /**
-     * Get the number of active subscribers.
-     */
-    getSubscriberCount(): number;
-    /**
-     * Cleanup: remove all subscribers and pending requests.
-     */
-    destroy(): void;
-}
-/**
- * Channel session manages a collection of channels.
- * Sessions persist across multiple engine executions.
- */
-export declare class ChannelSession {
-    readonly id: string;
-    readonly channels: Map<string, Channel>;
-    readonly createdAt: number;
-    lastActivity: number;
-    constructor(id: string);
-    /**
-     * Get or create a channel within this session.
-     */
-    getChannel(name: string): Channel;
-    /**
-     * Remove a channel from the session.
-     */
-    removeChannel(name: string): void;
-    /**
-     * Default session ID generator.
-     * Uses user context + conversation ID or trace ID.
-     * Users can override this via ChannelService config.
-     */
-    static generateId(ctx: KernelContext): string;
-    /**
-     * Cleanup all channels in the session.
-     */
-    destroy(): void;
-}
-/**
- * Kernel-level interface for channel service access.
- * This allows KernelContext to reference channels without creating
- * a circular dependency between kernel and engine packages.
- *
- * Engine's ChannelService implements this interface.
- */
-export interface ChannelServiceInterface {
-    /**
-     * Get or create a channel within the current session.
-     * Session is determined from the provided context.
-     */
-    getChannel(ctx: KernelContext, channelName: string): Channel;
-    /**
-     * Publish an event to a channel.
-     */
-    publish(ctx: KernelContext, channelName: string, event: Omit<ChannelEvent, "channel">): void;
-    /**
-     * Subscribe to events on a channel.
-     * @returns Unsubscribe function
-     */
-    subscribe(ctx: KernelContext, channelName: string, handler: (event: ChannelEvent) => void): () => void;
-    /**
-     * Wait for a response on a channel (for bidirectional communication).
-     */
-    waitForResponse(ctx: KernelContext, channelName: string, requestId: string, timeoutMs?: number): Promise<ChannelEvent>;
-}
-//# sourceMappingURL=channel.d.ts.map

package/dist/core/channel.d.ts.map

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

package/dist/core/channel.js

@@ -1,199 +0,0 @@
-import { EventEmitter } from "node:events";
-import { Context } from "./context";
-import { Telemetry } from "./telemetry";
-/**
- * Core Channel primitive.
- * Works standalone in any Node environment.
- * Uses EventEmitter internally for pub/sub.
- */
-export class Channel {
-    name;
-    emitter = new EventEmitter();
-    pendingRequests = new Map();
-    // Store recent responses to handle race conditions (response before wait)
-    recentResponses = new Map();
-    constructor(name) {
-        this.name = name;
-    }
-    /**
-     * Publish an event to the channel.
-     */
-    publish(event) {
-        // Ensure channel name matches
-        const normalizedEvent = {
-            ...event,
-            channel: this.name,
-            metadata: {
-                timestamp: Date.now(),
-                ...event.metadata,
-            },
-        };
-        // Track channel events as metrics
-        const ctx = Context.tryGet();
-        if (ctx?.procedureGraph && ctx.procedurePid) {
-            const node = ctx.procedureGraph.get(ctx.procedurePid);
-            if (node) {
-                // Track as metric in node
-                node.addMetric(`channel.${this.name}.events`, 1);
-                // Also track in context metrics (for consistency)
-                if (ctx.metrics) {
-                    ctx.metrics[`channel.${this.name}.events`] =
-                        (ctx.metrics[`channel.${this.name}.events`] || 0) + 1;
-                }
-                // Send to telemetry immediately
-                Telemetry.getCounter(`channel.${this.name}.events`).add(1, {
-                    channel: this.name,
-                    event_type: normalizedEvent.type,
-                    procedure: node.name || "anonymous",
-                    procedure_pid: node.pid,
-                });
-            }
-        }
-        // Emit to all subscribers
-        this.emitter.emit("event", normalizedEvent);
-        // If this is a response, resolve any pending requests or store for later
-        if (normalizedEvent.type === "response" && normalizedEvent.id) {
-            const responseId = normalizedEvent.id; // Type guard
-            const pending = this.pendingRequests.get(responseId);
-            if (pending) {
-                clearTimeout(pending.timeout);
-                this.pendingRequests.delete(responseId);
-                pending.resolve(normalizedEvent);
-            }
-            else {
-                // Store response in case waitForResponse is called later (race condition)
-                this.recentResponses.set(responseId, normalizedEvent);
-                // Clean up after 5 seconds
-                setTimeout(() => {
-                    this.recentResponses.delete(responseId);
-                }, 5000);
-            }
-        }
-    }
-    /**
-     * Subscribe to events on this channel.
-     * @returns Unsubscribe function
-     */
-    subscribe(handler) {
-        this.emitter.on("event", handler);
-        return () => {
-            this.emitter.off("event", handler);
-        };
-    }
-    /**
-     * Wait for a response to a specific request.
-     * Used by tools/components for bidirectional communication.
-     *
-     * @param requestId The request ID to wait for
-     * @param timeoutMs Timeout in milliseconds (default: 30000)
-     * @returns Promise that resolves when response is received
-     */
-    waitForResponse(requestId, timeoutMs = 30000) {
-        return new Promise((resolve, reject) => {
-            // Check if response was already received (race condition: response before wait)
-            const cachedResponse = this.recentResponses.get(requestId);
-            if (cachedResponse) {
-                this.recentResponses.delete(requestId);
-                resolve(cachedResponse);
-                return;
-            }
-            const timeout = setTimeout(() => {
-                this.pendingRequests.delete(requestId);
-                reject(new Error(`Channel "${this.name}": Request "${requestId}" timed out after ${timeoutMs}ms`));
-            }, timeoutMs);
-            this.pendingRequests.set(requestId, {
-                resolve,
-                reject,
-                timeout,
-            });
-            // Subscribe to catch responses that arrive after we set up the pending request
-            const unsubscribe = this.subscribe((event) => {
-                if (event.type === "response" && event.id === requestId) {
-                    unsubscribe();
-                    clearTimeout(timeout);
-                    this.pendingRequests.delete(requestId);
-                    resolve(event);
-                }
-            });
-        });
-    }
-    /**
-     * Get the number of active subscribers.
-     */
-    getSubscriberCount() {
-        return this.emitter.listenerCount("event");
-    }
-    /**
-     * Cleanup: remove all subscribers and pending requests.
-     */
-    destroy() {
-        // Reject all pending requests
-        for (const [requestId, pending] of this.pendingRequests.entries()) {
-            clearTimeout(pending.timeout);
-            pending.reject(new Error(`Channel "${this.name}" destroyed while waiting for request "${requestId}"`));
-        }
-        this.pendingRequests.clear();
-        // Clear cached responses
-        this.recentResponses.clear();
-        // Remove all listeners
-        this.emitter.removeAllListeners();
-    }
-}
-/**
- * Channel session manages a collection of channels.
- * Sessions persist across multiple engine executions.
- */
-export class ChannelSession {
-    id;
-    channels = new Map();
-    createdAt;
-    lastActivity;
-    constructor(id) {
-        this.id = id;
-        this.createdAt = Date.now();
-        this.lastActivity = Date.now();
-    }
-    /**
-     * Get or create a channel within this session.
-     */
-    getChannel(name) {
-        if (!this.channels.has(name)) {
-            this.channels.set(name, new Channel(name));
-        }
-        this.lastActivity = Date.now();
-        return this.channels.get(name);
-    }
-    /**
-     * Remove a channel from the session.
-     */
-    removeChannel(name) {
-        const channel = this.channels.get(name);
-        if (channel) {
-            channel.destroy();
-            this.channels.delete(name);
-        }
-    }
-    /**
-     * Default session ID generator.
-     * Uses user context + conversation ID or trace ID.
-     * Users can override this via ChannelService config.
-     */
-    static generateId(ctx) {
-        const userId = ctx.user?.id || "anonymous";
-        // Use conversationId if present and not 'na', otherwise fall back to traceId
-        const conversationId = ctx.metadata["conversationId"] && ctx.metadata["conversationId"] !== "na"
-            ? ctx.metadata["conversationId"]
-            : ctx.traceId;
-        return `${userId}-${conversationId}`;
-    }
-    /**
-     * Cleanup all channels in the session.
-     */
-    destroy() {
-        for (const channel of this.channels.values()) {
-            channel.destroy();
-        }
-        this.channels.clear();
-    }
-}
-//# sourceMappingURL=channel.js.map

package/dist/core/channel.js.map

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