@agentick/core 0.0.1

package/dist/component/tentickle-component.d.ts.map

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

package/dist/component/tentickle-component.js

@@ -0,0 +1,182 @@
+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

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

package/dist/content/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Content types, blocks, and message utilities.
+ *
+ * @module agentick/content
+ */
+export { normalizeMessageInput, normalizeContentInput, normalizeContentArray, isMessage, isContentBlock, } from "@agentick/shared";
+export * from "@agentick/shared/blocks";
+export * from "@agentick/shared/block-types";
+export * from "@agentick/shared/input";
+export * from "@agentick/shared/messages";
+export * from "@agentick/shared/streaming";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,SAAS,EACT,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAK1C,cAAc,4BAA4B,CAAC"}

package/dist/content/index.js

@@ -0,0 +1,17 @@
+/**
+ * Content types, blocks, and message utilities.
+ *
+ * @module agentick/content
+ */
+// Re-export content types, but exclude ones we extend locally
+// Note: Message, ContentBlock, etc. are also exported from types.ts re-exports
+export { normalizeMessageInput, normalizeContentInput, normalizeContentArray, isMessage, isContentBlock, } from "@agentick/shared";
+export * from "@agentick/shared/blocks";
+export * from "@agentick/shared/block-types";
+export * from "@agentick/shared/input";
+export * from "@agentick/shared/messages";
+// Re-export all streaming types and utilities
+// ModelStreamEvent types are model output streaming events
+// OrchestrationStreamEvent types are execution/tick/tool events
+export * from "@agentick/shared/streaming";
+//# sourceMappingURL=index.js.map

package/dist/content/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8DAA8D;AAC9D,+EAA+E;AAC/E,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,SAAS,EACT,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAE1C,8CAA8C;AAC9C,2DAA2D;AAC3D,gEAAgE;AAChE,cAAc,4BAA4B,CAAC"}

package/dist/context/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Engine's Context wrapper - re-exports Kernel's Context with EngineContext types.
+ *
+ * This ensures that when Engine users call Context.create(), they get EngineContext
+ * (which includes Engine-specific fields via module augmentation) instead of KernelContext.
+ *
+ * @module agentick/context
+ */
+import type { EngineContext } from "../types";
+/**
+ * Context utilities for Engine.
+ *
+ * Re-exports Kernel's Context class but with EngineContext return types.
+ * This ensures Engine users get properly typed contexts with Engine-specific fields.
+ */
+export declare class Context {
+    /**
+     * Creates a new EngineContext with defaults.
+     * Returns EngineContext (KernelContext with Engine augmentations).
+     */
+    static create(overrides?: Partial<Omit<EngineContext, "events">>): EngineContext;
+    /**
+     * Runs a function within the given EngineContext.
+     */
+    static run<T>(context: EngineContext, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Gets the current EngineContext. Throws if not found.
+     *
+     * Note: EngineContext extends KernelContext, so it has all KernelContext properties
+     * (metadata, user, etc.) available directly.
+     */
+    static get(): EngineContext;
+    /**
+     * Gets the current EngineContext. Returns undefined if not found.
+     *
+     * Note: EngineContext extends KernelContext, so it has all KernelContext properties
+     * (metadata, user, etc.) available directly.
+     */
+    static tryGet(): EngineContext | undefined;
+    /**
+     * Emits an event on the current context's event bus.
+     */
+    static emit(type: string, payload: any, source?: string): void;
+    /**
+     * Set the current tick number in the context.
+     * Called by the engine at the start of each tick.
+     */
+    static setTick(tick: number): void;
+}
+export declare function context(): EngineContext;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,OAAO;IAClB;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,SAAS,GAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAM,GAAG,aAAa;IAQpF;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvE;;;;;OAKG;IACH,MAAM,CAAC,GAAG,IAAI,aAAa;IAK3B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,IAAI,aAAa,GAAG,SAAS;IAK1C;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAE,MAAiB,GAAG,IAAI;IAIxE;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAGnC;AAED,wBAAgB,OAAO,kBAEtB"}

package/dist/context/index.js

@@ -0,0 +1,69 @@
+/**
+ * Engine's Context wrapper - re-exports Kernel's Context with EngineContext types.
+ *
+ * This ensures that when Engine users call Context.create(), they get EngineContext
+ * (which includes Engine-specific fields via module augmentation) instead of KernelContext.
+ *
+ * @module agentick/context
+ */
+import { Context as KernelContext, } from "@agentick/kernel";
+/**
+ * Context utilities for Engine.
+ *
+ * Re-exports Kernel's Context class but with EngineContext return types.
+ * This ensures Engine users get properly typed contexts with Engine-specific fields.
+ */
+export class Context {
+    /**
+     * Creates a new EngineContext with defaults.
+     * Returns EngineContext (KernelContext with Engine augmentations).
+     */
+    static create(overrides = {}) {
+        // Call Kernel's Context.create() and cast to EngineContext
+        // This is safe because EngineContext extends KernelContext and Engine augments it
+        return KernelContext.create(overrides);
+    }
+    /**
+     * Runs a function within the given EngineContext.
+     */
+    static run(context, fn) {
+        return KernelContext.run(context, fn);
+    }
+    /**
+     * Gets the current EngineContext. Throws if not found.
+     *
+     * Note: EngineContext extends KernelContext, so it has all KernelContext properties
+     * (metadata, user, etc.) available directly.
+     */
+    static get() {
+        // Cast is safe: EngineContext extends KernelContext and only narrows executionHandle
+        return KernelContext.get();
+    }
+    /**
+     * Gets the current EngineContext. Returns undefined if not found.
+     *
+     * Note: EngineContext extends KernelContext, so it has all KernelContext properties
+     * (metadata, user, etc.) available directly.
+     */
+    static tryGet() {
+        // Cast is safe: EngineContext extends KernelContext and only narrows executionHandle
+        return KernelContext.tryGet();
+    }
+    /**
+     * Emits an event on the current context's event bus.
+     */
+    static emit(type, payload, source = "system") {
+        KernelContext.emit(type, payload, source);
+    }
+    /**
+     * Set the current tick number in the context.
+     * Called by the engine at the start of each tick.
+     */
+    static setTick(tick) {
+        KernelContext.setTick(tick);
+    }
+}
+export function context() {
+    return Context.get();
+}
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,OAAO,IAAI,aAAa,GAEzB,MAAM,kBAAkB,CAAC;AAG1B;;;;;GAKG;AACH,MAAM,OAAO,OAAO;IAClB;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,YAAoD,EAAE;QAClE,2DAA2D;QAC3D,kFAAkF;QAClF,OAAO,aAAa,CAAC,MAAM,CACzB,SAAuD,CACvC,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAI,OAAsB,EAAE,EAAoB;QACxD,OAAO,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAG;QACR,qFAAqF;QACrF,OAAO,aAAa,CAAC,GAAG,EAAmB,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM;QACX,qFAAqF;QACrF,OAAO,aAAa,CAAC,MAAM,EAA+B,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,IAAY,EAAE,OAAY,EAAE,SAAiB,QAAQ;QAC/D,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAY;QACzB,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC"}

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

@@ -0,0 +1,31 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,62 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,164 @@
+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

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