@noetic-tools/core 0.3.0 → 1.1.0

package/dist/runtime/event-broadcaster.js

@@ -101,7 +101,13 @@ export class EventBroadcaster {
 //#region BroadcastIterator
 class BroadcastIterator {
     cursor = 0;
-    waiter;
+    /**
+     * Parked `next()` calls, FIFO. The AsyncIterator protocol allows pipelined
+     * `next()` calls (calling again before the previous promise settles), so a
+     * single waiter slot would orphan all but the latest call — the overwritten
+     * promises would never settle. `notify()` drains in arrival order.
+     */
+    waiters = [];
     returned = false;
     broadcaster;
     constructor(broadcaster) {
@@ -113,20 +119,22 @@ class BroadcastIterator {
     }
     /** Called by the broadcaster when new data or completion is available. */
     notify() {
-        if (!this.waiter) {
-            return;
-        }
-        const w = this.waiter;
-        this.waiter = undefined;
-        try {
-            const result = this.tryRead();
-            if (result) {
-                w.resolve(result);
+        while (this.waiters.length > 0) {
+            let result;
+            try {
+                result = this.tryRead();
             }
-        }
-        catch (err) {
-            // Reject the waiter's promise so the error propagates through the async iterator
-            w.reject(err);
+            catch (err) {
+                // Reject so the error propagates through the async iterator. The
+                // broadcaster stays finished-with-error, so the loop drains every
+                // remaining waiter with the same rejection.
+                this.waiters.shift().reject(err);
+                continue;
+            }
+            if (!result) {
+                return;
+            }
+            this.waiters.shift().resolve(result);
         }
     }
     async next() {
@@ -136,25 +144,41 @@ class BroadcastIterator {
                 value: undefined,
             };
         }
-        const result = this.tryRead();
-        if (result) {
-            return result;
+        // Only read ahead when no one is parked — a pipelined next() must queue
+        // BEHIND earlier calls so events are handed out in FIFO order.
+        if (this.waiters.length === 0) {
+            const result = this.tryRead();
+            if (result) {
+                return result;
+            }
         }
         return new Promise((resolve, reject) => {
-            this.waiter = {
+            this.waiters.push({
                 resolve,
                 reject,
-            };
+            });
         });
     }
+    /** Settle every parked waiter with `{ done: true }` — used on early exit. */
+    settleWaiters() {
+        const drained = this.waiters.splice(0, this.waiters.length);
+        for (const waiter of drained) {
+            waiter.resolve({
+                done: true,
+                value: undefined,
+            });
+        }
+    }
     async throw(err) {
         this.returned = true;
         this.broadcaster.removeIterator(this);
+        this.settleWaiters();
         throw err;
     }
     async return() {
         this.returned = true;
         this.broadcaster.removeIterator(this);
+        this.settleWaiters();
         return {
             done: true,
             value: undefined,

package/dist/schemas/workflow.js

@@ -46,7 +46,8 @@ const AllPredicateSchema = z.object({
     predicates: z.array(UntilPredicateRef).min(1),
 });
 /** @public Zod schema validating a named `until` predicate (including `any`/`all` combinators). */
-export const UntilPredicateSchema = z.union([
+export const UntilPredicateSchema = z
+    .union([
     MaxStepsPredicateSchema,
     MaxCostPredicateSchema,
     MaxDurationPredicateSchema,
@@ -56,7 +57,11 @@ export const UntilPredicateSchema = z.union([
     ConvergedPredicateSchema,
     AnyPredicateSchema,
     AllPredicateSchema,
-]);
+])
+    .meta({
+    id: 'UntilPredicate',
+    title: 'UntilPredicate',
+});
 //#endregion
 //#region Merge Strategy
 /** @public ESM literal enum for merge strategies. */
@@ -158,7 +163,8 @@ const EveryNodeSchema = z.object({
         .optional(),
 });
 /** @public Zod schema validating a single `WorkflowNode` (any of the 9 JSON-safe kinds). */
-export const WorkflowNodeSchema = z.discriminatedUnion('kind', [
+export const WorkflowNodeSchema = z
+    .discriminatedUnion('kind', [
     LlmNodeSchema,
     ToolNodeSchema,
     BranchNodeSchema,
@@ -168,11 +174,21 @@ export const WorkflowNodeSchema = z.discriminatedUnion('kind', [
     LoopNodeSchema,
     SequenceNodeSchema,
     EveryNodeSchema,
-]);
+])
+    .meta({
+    id: 'WorkflowNode',
+    title: 'WorkflowNode',
+});
 /** @public Zod schema validating a complete `WorkflowDocument`. */
-export const WorkflowDocumentSchema = z.object({
+export const WorkflowDocumentSchema = z
+    .object({
     version: z.literal(1),
     root: WorkflowNodeSchema,
+})
+    .meta({
+    id: 'WorkflowDocument',
+    title: 'WorkflowDocument',
+    description: 'A portable, JSON-safe representation of a Noetic step tree.',
 });
 //#endregion
 //#region Helpers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noetic-tools/core",
-  "version": "0.3.0",
+  "version": "1.1.0",
   "type": "module",
   "description": "Step primitives, interpreter, runtime, and memory layer contract for Noetic agents.",
   "license": "Apache-2.0",
@@ -40,10 +40,12 @@
       "types": "./dist/internal-test.d.ts",
       "default": "./dist/internal-test.js"
     },
+    "./schema": "./schema/noetic-workflow.schema.json",
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
+    "schema",
     "README.md",
     "LICENSE"
   ],
@@ -64,15 +66,16 @@
     }
   },
   "dependencies": {
-    "@noetic-tools/memory": "^0.2.0",
-    "@noetic-tools/types": "^0.2.0",
+    "@noetic-tools/memory": "^1.0.1",
+    "@noetic-tools/types": "^1.0.0",
     "@openrouter/agent": "^0.6.0",
     "zod": "^4.0.0"
   },
   "scripts": {
     "build": "bunx tsc -p tsconfig.build.json && bun scripts/add-js-extensions.ts",
+    "gen:schema": "bun scripts/generate-workflow-schema.ts",
     "verify:esm": "bun scripts/verify-node-esm.ts",
-    "prepublishOnly": "rm -rf dist && bun run build && bun run verify:esm && bun scripts/pin-workspace-deps.ts",
+    "prepublishOnly": "rm -rf dist && bun run gen:schema && bun run build && bun run verify:esm && bun scripts/pin-workspace-deps.ts && bun scripts/strip-dev-conditions.ts",
     "test": "bun test",
     "test:coverage": "bun test --coverage --coverage-reporter=text --coverage-reporter=lcov",
     "test:ci": "bun test --coverage --coverage-reporter=lcov",