@noetic-tools/types 2.3.0 → 3.0.0

package/dist/types/channel.d.ts

@@ -14,11 +14,13 @@ export interface Channel<T> {
     readonly capacity?: number;
 }
 /**
- * A channel that is writable from outside the execution tree (e.g. user input).
+ * A channel reachable from outside the execution tree: writable via
+ * `getChannelHandle` (e.g. user input) and readable via `getChannelStream`
+ * (e.g. approval requests posted to a chat platform).
  * @public
  */
 export interface ExternalChannel<T> extends Channel<T> {
-    /** Marker indicating the channel accepts writes from external callers. */
+    /** Marker indicating the channel accepts external readers and writers. */
     readonly external: true;
 }
 /** @public Handle for sending messages to a channel and checking its closed state. */

package/dist/types/context.d.ts

@@ -177,6 +177,8 @@ export interface ContextHarness {
     }): Promise<T>;
     tryRecv<T>(channel: Channel<T>, ctx: Context): T | null;
     getChannelHandle<T>(channel: ExternalChannel<T>, executionId: string): ChannelHandle<T>;
+    /** Read-side counterpart to `getChannelHandle` — see `AgentHarnessContract.getChannelStream`. */
+    getChannelStream<T>(channel: ExternalChannel<T>, executionId: string): AsyncIterable<T>;
     initLayers(layers: ContextLayer[], ctx: Context, storage: StorageAdapter): Promise<void>;
     disposeLayers(layers: ContextLayer[], ctx: Context): Promise<void>;
     checkpoint(ctx: Context): Promise<void>;

package/dist/types/runtime.d.ts

@@ -234,6 +234,17 @@ export interface AgentHarnessContract<TParams extends Record<string, unknown> =
     }): Promise<T>;
     tryRecv<T>(channel: Channel<T>, ctx: Context): T | null;
     getChannelHandle<T>(channel: ExternalChannel<T>, executionId: string): ChannelHandle<T>;
+    /**
+     * Read-side counterpart to `getChannelHandle`: subscribe to values the agent
+     * sends on an external channel. Delivery is CHANNEL-scoped (state is keyed
+     * by channel name per harness) — `executionId` bounds only the
+     * subscription's lifetime: the iterable ends when that root execution
+     * completes (success, failure, or cancellation), draining buffered values
+     * first. An id no execution runs under never closes, giving a
+     * harness-lifetime stream ended via `iterator.return()`. The returned
+     * iterable owns a single iterator; subscribe again for a second consumer.
+     */
+    getChannelStream<T>(channel: ExternalChannel<T>, executionId: string): AsyncIterable<T>;
     initLayers(layers: ContextLayer[], ctx: Context, storage: StorageAdapter): Promise<void>;
     recallLayers(layers: ContextLayer[], input: string, ctx: Context): Promise<RecallLayerOutput[]>;
     /** Recall only atomic layers (or all layers when the harness forces atomic recall). Blocks until complete. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noetic-tools/types",
-  "version": "2.3.0",
+  "version": "3.0.0",
   "type": "module",
   "description": "Foundational type contracts and primitives shared across the Noetic framework (items, LLM config, adapters, steering, errors).",
   "license": "Apache-2.0",