@intentius/chant-lexicon-fountain 0.124.27 → 0.124.28

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "4cd2b1a1515c4d32f4fca0e514dcc212c19dffb8933e41f7c2d680e100fddd1a",
+    "manifest.json": "897892e3f675a2e4d5d27da914798743a1159472ac616fc150275551e3e55699",
     "meta.json": "3301437a2a56eaf1a5cc8f6eabb18a40767f916e09701b2d9bf20aba4066738c",
     "types/index.d.ts": "cf6b634fe0a8e9e96f1d9d07e3df53838def2683dc93dbe3c7fd971c6d3908ae",
     "rules/ftn001-no-secret-literals.ts": "dd1b54db3919afadcb5b8261db9a5db7c316a5f263c86f7a551fddb19f6ac532",
@@ -23,5 +23,5 @@
     "skills/chant-fountain-ops.md": "4e72f0a0c7477a9e98f85ea45e49ba69e8a699f9c13ba0f0cf1cb20a88151373",
     "skills/chant-fountain-locked-sandboxes.md": "7404ece96f2a3bc9105942fd3b6db156a3537db7e34c8cf2faa9ba87f5512567"
   },
-  "composite": "88243a1acbb024b85b4ea3c7e56d704e39c3cc7d81f9483a2e5bf206a90fbcab"
+  "composite": "d9a461b89d5f289cba62e4b0941a05cde8865390e9614fad44f985d9feb70bf8"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "fountain",
-  "version": "0.124.27",
+  "version": "0.124.28",
   "chantVersion": ">=0.1.0",
   "namespace": "Fountain",
   "specVersion": "v0.21.0"

package/dist/op/runtime.d.ts

@@ -229,6 +229,15 @@ interface TailOptions {
     idleTimeoutMs: number;
     now: () => number;
     progress?: (record: StepRecord) => void;
+    /**
+     * Where the run's event stream goes (#4041, `chant run <op> --on fountain
+     * --events-json`). The tail writes it as the steward works: a phase for
+     * each stage the turn reports, a step for each tool call, started when the
+     * call starts and settled when it settles. `runtime` is `steward`, the run
+     * id is the conversation's, and the commit is null, since the run builds
+     * from whatever the steward's sandbox holds.
+     */
+    runEvents?: (line: string) => void;
     signal?: AbortSignal;
     /**
      * REST seam for the conversation poll (#2167). Without it the tail waits on

package/dist/op/runtime.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-fountain",
-  "version": "0.124.27",
+  "version": "0.124.28",
   "type": "module",
   "description": "Fountain lexicon for chant — sandboxed agent environments, vaults, and agents as typed estate",
   "license": "Apache-2.0",
@@ -50,7 +50,7 @@
     "bundle": "tsx src/package-cli.ts"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.124.27",
+    "@intentius/chant": "^0.124.28",
     "zod": "^4.3.6"
   },
   "devDependencies": {

package/src/op/runtime.test.ts

@@ -10,6 +10,9 @@
  */
 
 import { describe, expect, it, vi } from "vitest";
+import { createRequire } from "node:module";
+import type { RunEvent } from "@intentius/chant";
+import runEventSchema from "@intentius/chant/workspace/run-event.schema.json";
 import type { ChantConfig } from "@intentius/chant/config";
 import type { OpConfig, StepRecord } from "@intentius/chant/op";
 import {
@@ -1312,3 +1315,83 @@ describe("the plugin registers the provider", () => {
     fetchSpy.mockRestore();
   });
 });
+
+// ── the run-event stream (#4041) ──────────────────────────────────────────
+
+describe("tailConversation runEvents (#4041)", () => {
+  // The draft 2020-12 validator core's own contract tests use, loaded from core:
+  // this package carries no ajv of its own.
+  const { default: Ajv2020 } = createRequire(import.meta.resolve("@intentius/chant"))("ajv/dist/2020") as { default: new (o: object) => { compile(s: object): ((d: unknown) => boolean) & { errors?: unknown } } };
+  const validate = new Ajv2020({ strict: true, allErrors: true }).compile(runEventSchema);
+
+  /** Parse and check a stream: schema-valid, framed, one run, each step started before it settles. */
+  function check(lines: string[]) {
+    const events = lines.map((l) => JSON.parse(l) as RunEvent);
+    for (const e of events) expect(validate(e), JSON.stringify(validate.errors)).toBe(true);
+    expect(events.map((e) => e.seq)).toEqual(events.map((_, i) => i));
+    expect(events[0]?.type).toBe("run-start");
+    expect(events.at(-1)?.type).toBe("run-settle");
+    return events;
+  }
+
+  it("streams the steward's stages as phases and its tool calls as steps, on the steward runtime", async () => {
+    const { sse } = fakeSse([
+      [
+        sseEvent("1", { stream: "stage", stage: "plan" }),
+        sseEvent("2", { stream: "stdout", blocks: [{ kind: "tool_call", id: "t1", title: "plan" }] }),
+        sseEvent("3", { stream: "stdout", blocks: [{ kind: "tool_call_update", tool_call_id: "t1", status: "completed" }] }),
+        sseEvent("4", { stream: "stage", stage: "apply" }),
+        sseEvent("5", { stream: "stdout", blocks: [{ kind: "tool_call", id: "t2", title: "apply" }] }),
+        sseEvent("6", { stream: "stdout", blocks: [{ kind: "tool_call_update", tool_call_id: "t2", status: "failed" }] }),
+        sseEvent("7", { stream: "stdout", blocks: [{ kind: "text", body: JSON.stringify(RECORD) }] }),
+        sseEvent("8", { stream: "stage", stage: "turn", state: "done" }),
+      ],
+    ]);
+    const lines: string[] = [];
+    const status = await tailConversation({
+      sse,
+      conversationId: "conv-1",
+      op: "alb-deploy",
+      startedAt: "2026-03-01T10:00:00.000Z",
+      idleTimeoutMs: 60_000,
+      now: fakeClock(),
+      runEvents: (l) => lines.push(l),
+    });
+
+    expect(status.state).toBe("completed");
+    const events = check(lines);
+    expect(events[0]).toMatchObject({ runId: "conv-1", kind: "op", name: "alb-deploy", gitSha: null, runtime: "steward", runOrigin: { forge: "op" } });
+    expect(events.map((e) => [e.type, "phase" in e ? e.phase : undefined, "step" in e ? e.step : undefined, "status" in e ? e.status : undefined])).toEqual([
+      ["run-start", undefined, undefined, undefined],
+      ["phase-start", "plan", undefined, undefined],
+      ["step-start", "plan", "plan", undefined],
+      ["step-settle", "plan", "plan", "ok"],
+      ["phase-settle", "plan", undefined, "ok"],
+      ["phase-start", "apply", undefined, undefined],
+      ["step-start", "apply", "apply", undefined],
+      ["step-settle", "apply", "apply", "failed"],
+      ["phase-settle", "apply", undefined, "failed"],
+      ["run-settle", undefined, undefined, "ok"],
+    ]);
+  });
+
+  it("a tail that gives up still ends the stream, failed with the reason", async () => {
+    const sse: FountainSse = () => ({
+      [Symbol.asyncIterator]: () => ({ next: () => new Promise<never>(() => {}) }),
+    });
+    const lines: string[] = [];
+    await expect(
+      tailConversation({
+        sse,
+        conversationId: "conv-1",
+        op: "alb-deploy",
+        startedAt: "2026-03-01T10:00:00.000Z",
+        idleTimeoutMs: 5,
+        now: () => Date.now(),
+        runEvents: (l) => lines.push(l),
+      }),
+    ).rejects.toThrow(/nothing arrived/);
+    const events = check(lines);
+    expect(events.at(-1)).toMatchObject({ type: "run-settle", status: "failed", error: expect.stringMatching(/nothing arrived on conversation conv-1/) });
+  });
+});

package/src/op/runtime.ts

@@ -65,6 +65,8 @@ import { loadChantConfig, type ChantConfig } from "@intentius/chant/config";
 import type { OpConfig, OpGateResolveOptions, OpRunHandle, OpRunRecord, OpRunStartOptions, OpRunState, OpRunStatus, OpRuntimeProvider, StepRecord } from "@intentius/chant/op";
 import { runStateOf } from "@intentius/chant/op";
 import type { GateResolutionRecord } from "@intentius/chant/lifecycle/gate-ledger";
+import type { RunEventSettleStatus } from "@intentius/chant";
+import { openRunEventStream, runEventRunOf, type RunEventStream } from "@intentius/chant/run-event-stream";
 import { resolveProfile, type FountainProfile } from "../config";
 import {
   defaultFountainHttp,
@@ -794,6 +796,7 @@ export function createFountainOpRuntime(opts: FountainOpRuntimeOptions = {}): Op
         http,
         ...(opts.conversationPollMs !== undefined ? { pollIntervalMs: opts.conversationPollMs } : {}),
         ...(startOpts.progress ? { progress: startOpts.progress } : {}),
+        ...(startOpts.runEvents ? { runEvents: startOpts.runEvents } : {}),
         ...(startOpts.signal ? { signal: startOpts.signal } : {}),
       });
 
@@ -1077,6 +1080,15 @@ interface TailOptions {
   idleTimeoutMs: number;
   now: () => number;
   progress?: (record: StepRecord) => void;
+  /**
+   * Where the run's event stream goes (#4041, `chant run <op> --on fountain
+   * --events-json`). The tail writes it as the steward works: a phase for
+   * each stage the turn reports, a step for each tool call, started when the
+   * call starts and settled when it settles. `runtime` is `steward`, the run
+   * id is the conversation's, and the commit is null, since the run builds
+   * from whatever the steward's sandbox holds.
+   */
+  runEvents?: (line: string) => void;
   signal?: AbortSignal;
   /**
    * REST seam for the conversation poll (#2167). Without it the tail waits on
@@ -1164,6 +1176,85 @@ async function readConversation(
  * one connection — ends the wait, and it ends it with an error.
  */
 export async function tailConversation(opts: TailOptions): Promise<OpRunStatus> {
+  const stream = opts.runEvents
+    ? openRunEventStream(
+        runEventRunOf({ kind: "op", name: opts.op, runId: opts.conversationId, runtime: "steward", runOrigin: { forge: "op" } }),
+        opts.runEvents,
+        { now: () => new Date(opts.now()) },
+      )
+    : undefined;
+  stream?.emit({ type: "run-start", waves: null });
+  const steps = stewardSteps(stream);
+  try {
+    const status = await tailTurn(opts, steps);
+    steps.close(status.state === "completed" ? "ok" : "failed");
+    stream?.settle(...settleOfState(status));
+    return status;
+  } catch (err) {
+    steps.close("failed");
+    stream?.settle("failed", err instanceof Error ? err.message : String(err));
+    throw err;
+  }
+}
+
+/** A run's final state as its stream's `run-settle`. */
+function settleOfState(status: OpRunStatus): [RunEventSettleStatus, string?] {
+  switch (status.state) {
+    case "completed":
+      return ["ok"];
+    case "gated":
+      return ["gated"];
+    case "waiting":
+      return ["waiting"];
+    case "cancelled":
+      return ["failed", status.error ?? "the run was cancelled"];
+    default:
+      return ["failed", status.error ?? `the run ended ${status.state}`];
+  }
+}
+
+/** The steward's tool calls as run events: a phase per stage, a step per call. */
+interface StewardSteps {
+  /** The tool call `key` started in `phase`. */
+  start(key: string, phase: string, step: string): void;
+  /** The tool call `key` settled. One never seen to start is started first, so its start still comes before its settle. */
+  settle(key: string, phase: string, step: string, ok: boolean, durationMs: number): void;
+  /** Settle the open phase, if any. */
+  close(status: RunEventSettleStatus): void;
+}
+
+function stewardSteps(stream: RunEventStream | undefined): StewardSteps {
+  let open: { phase: string; failed: boolean } | undefined;
+  const started = new Set<string>();
+  const enter = (phase: string): void => {
+    if (!stream || open?.phase === phase) return;
+    if (open) stream.emit({ type: "phase-settle", component: null, phase: open.phase, status: open.failed ? "failed" : "ok" });
+    open = { phase, failed: false };
+    stream.emit({ type: "phase-start", component: null, phase });
+  };
+  return {
+    start(key, phase, step) {
+      if (!stream || started.has(key)) return;
+      started.add(key);
+      enter(phase);
+      stream.emit({ type: "step-start", component: null, phase, step });
+    },
+    settle(key, phase, step, ok, durationMs) {
+      if (!stream) return;
+      this.start(key, phase, step);
+      started.delete(key);
+      if (!ok && open?.phase === phase) open.failed = true;
+      stream.emit({ type: "step-settle", component: null, phase, step, status: ok ? "ok" : "failed", durationMs });
+    },
+    close(status) {
+      if (!stream || !open) return;
+      stream.emit({ type: "phase-settle", component: null, phase: open.phase, status: open.failed ? "failed" : status });
+      open = undefined;
+    },
+  };
+}
+
+async function tailTurn(opts: TailOptions, steps: StewardSteps): Promise<OpRunStatus> {
   const { sse, conversationId, op, startedAt, idleTimeoutMs, now } = opts;
   const path = `/api/conversations/${conversationId}/stream?streams=stdout,stderr,stage&blocks=true`;
 
@@ -1195,6 +1286,7 @@ export async function tailConversation(opts: TailOptions): Promise<OpRunStatus>
     const key = toolCallId(block);
     const open = pending.get(key);
     pending.delete(key);
+    steps.settle(key, open?.phase ?? phase, open?.fn ?? toolCallName(block), status === "ok", open ? Math.max(0, now() - open.startedAt) : 0);
     if (!opts.progress) return;
     opts.progress({
       phase: open?.phase ?? phase,
@@ -1219,6 +1311,7 @@ export async function tailConversation(opts: TailOptions): Promise<OpRunStatus>
         const key = toolCallId(block);
         if (!pending.has(key)) {
           pending.set(key, { fn: toolCallName(block), phase, startedAt: now() });
+          steps.start(key, phase, toolCallName(block));
         }
         if (block.status && SETTLED_TOOL_STATUS.has(block.status)) {
           emit(block, block.status === "completed" || block.status === "success" ? "ok" : "fail");