@orkestrel/agent 0.0.16 → 0.0.18

package/dist/src/core/index.d.ts

@@ -1102,6 +1102,18 @@ export declare interface AuthorityRule {
  * `push` / `close` / `fail` enqueue/flag, then fire `#wake` so the parked reader wakes,
  * re-reads the buffer, and either yields the next chunk, returns (on `close`), or throws
  * (on `fail`). Event-free, no `!` / `as` / `any`.
+ *
+ * @example
+ * ```ts
+ * import { Channel } from '@orkestrel/agent'
+ *
+ * const channel = new Channel<number>()
+ * channel.push(1)
+ * channel.close()
+ * for await (const value of channel.drain()) {
+ * 	value // 1
+ * }
+ * ```
  */
 export declare class Channel<T> {
     #private;

package/dist/src/core/index.js

@@ -1287,6 +1287,18 @@ var AgentContext = class {
 * `push` / `close` / `fail` enqueue/flag, then fire `#wake` so the parked reader wakes,
 * re-reads the buffer, and either yields the next chunk, returns (on `close`), or throws
 * (on `fail`). Event-free, no `!` / `as` / `any`.
+*
+* @example
+* ```ts
+* import { Channel } from '@orkestrel/agent'
+*
+* const channel = new Channel<number>()
+* channel.push(1)
+* channel.close()
+* for await (const value of channel.drain()) {
+* 	value // 1
+* }
+* ```
 */
 var Channel = class {
 	#buffer = [];
@@ -1294,7 +1306,7 @@ var Channel = class {
 	#closed = false;
 	#failure;
 	push(value) {
-		this.#buffer.push(value);
+		this.#buffer.push({ value });
 		this.#signal();
 	}
 	close() {
@@ -1308,10 +1320,7 @@ var Channel = class {
 	}
 	async *drain() {
 		for (;;) {
-			while (this.#buffer.length > 0) {
-				const next = this.#buffer.shift();
-				if (next !== void 0) yield next;
-			}
+			for (let cell = this.#buffer.shift(); cell !== void 0; cell = this.#buffer.shift()) yield cell.value;
 			if (this.#failure !== void 0) throw this.#failure.error;
 			if (this.#closed) return;
 			await this.#parked();