@plurnk/plurnk-service 1.8.0 → 1.9.0

package/dist/core/TurnRunner.d.ts.map

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

package/dist/core/TurnRunner.js

@@ -1,6 +1,5 @@
 var _a;
-import { PlurnkParser, PlurnkParseError, UNKNOWN_POSITION } from "@plurnk/plurnk-contracts";
-import Owner from "./Owner.js";
+import { PathSyntax, PlurnkParser, PlurnkParseError, UNKNOWN_POSITION } from "@plurnk/plurnk-contracts";
 const TERMINAL_SEND_SIGNALS = new Set([102, 200, 202, 499]);
 const comparePosition = (a, b) => a.line - b.line || a.column - b.column;
 import Meta from "@plurnk/plurnk-meta";
@@ -9,7 +8,7 @@ import GitMembership from "./git-membership.js";
 import GitState from "./git-state.js";
 import WorkspaceSettings from "./workspace-settings.js";
 import { editedSpan } from "../content/index.js";
-import { promptPathname, promptLoopPrefix, renderTarget } from "./plurnk-uri.js";
+import { authorityParts, generatedPathname, promptPathname, promptLoopPrefix, renderAddress } from "./plurnk-uri.js";
 import { readFile } from "node:fs/promises";
 // {§grammar-rail-registration} — bare names are the built-in rail namespace;
 // everything else is an import specifier resolved through the Node chain.
@@ -92,6 +91,15 @@ const parsePromptAttributes = (encoded, source) => {
     }
     return attributes;
 };
+const promptSourceFromAttributes = (attributes, source) => {
+    const value = attributes.source;
+    if (value === undefined)
+        return null;
+    if (typeof value !== "string" || value.length === 0) {
+        throw new TypeError(`${source}: source must be a non-empty string when present`);
+    }
+    return value;
+};
 // Per-emission action ceiling — OFF by default. `-1` (or unset/non-positive) = no cap:
 // every generated op dispatches. Runaway degeneration is a sampler concern (repetition penalty),
 // not grounds to drop already-generated work. A positive value is an operator ceiling a
@@ -173,6 +181,7 @@ class TurnRunner {
     #dispatcher;
     #liveSubscriptions;
     #streamEventNotify;
+    #reasoningEventNotify;
     #wakeWorkerNotify;
     #executors;
     #loopSignal;
@@ -181,7 +190,7 @@ class TurnRunner {
     #dispatch;
     #resolveWorkerProviderIdentity;
     #gbnfCache = new Map();
-    constructor({ db, schemes, mimetypes, weigh, notices, problems, strikes, packets, dispatcher, liveSubscriptions, streamEventNotify, wakeWorkerNotify, executors, loopSignal, interactions, warmWorkspace, dispatch, resolveWorkerProviderIdentity, }) {
+    constructor({ db, schemes, mimetypes, weigh, notices, problems, strikes, packets, dispatcher, liveSubscriptions, streamEventNotify, reasoningEventNotify, wakeWorkerNotify, executors, loopSignal, interactions, warmWorkspace, dispatch, resolveWorkerProviderIdentity, }) {
         this.#db = db;
         this.#schemes = schemes;
         this.#mimetypes = mimetypes;
@@ -193,6 +202,7 @@ class TurnRunner {
         this.#dispatcher = dispatcher;
         this.#liveSubscriptions = liveSubscriptions;
         this.#streamEventNotify = streamEventNotify;
+        this.#reasoningEventNotify = reasoningEventNotify;
         this.#wakeWorkerNotify = wakeWorkerNotify;
         this.#executors = executors;
         this.#loopSignal = loopSignal;
@@ -390,7 +400,7 @@ class TurnRunner {
     // Every admitted producer program is scheduled, dispatched, recorded, and
     // completed here; inference is only the model-specific way one program is
     // acquired and supplied with BARE capability.
-    async #executeAdmittedTurn({ statements, source, sourceFolded, sourceModelCallId = null, sourceReasoningItems, origin, workspaceId, workerId, loopId, turnId, fromSequence, maxCommands = Number.POSITIVE_INFINITY, enforceIdle = false, failOnOperationError = false, recoverableParseErrors = [], bare, signal, onDispatch, }) {
+    async executeAdmittedTurn({ statements, source, sourceFolded, sourceModelCallId = null, sourceReasoningItems, origin, workspaceId, workerId, loopId, turnId, fromSequence, maxCommands = Number.POSITIVE_INFINITY, enforceIdle = false, failOnOperationError = false, recoverableParseErrors = [], bare, signal, onDispatch, }) {
         const plan = statements[0];
         const finalOp = statements.at(-1);
         if (finalOp?.op !== "SEND") {
@@ -594,20 +604,24 @@ class TurnRunner {
         const initialSequence = await this.#db.engine_next_turn_sequence.get({ loop_id: loopId });
         if (initialSequence === undefined)
             throw new Error("Engine.runTurn: next turn sequence is unavailable");
-        // loops.sequence is the loop's ordinal within the worker. Turn-0 foists that belong to the
-        // WORKER (manifest preview, AGENTS, operator docs) gate on the worker's first loop, not every loop's
-        // first turn ({§actor-boundary-catalog-preview}); per-loop foists such as
+        // Turn-0 foists that belong to the Worker (catalog preview, AGENTS) gate
+        // on its first inference history, not on loop sequence: honest client or
+        // runtime administrative turns may precede the first provider exchange.
+        // Per-loop foists such as
         // {§prompt-entry} still fires once per loop. Durable publication state,
         // rather than the model-turn ordinal, prevents an overflow diversion
         // from replaying the prompt and its automatic path READs.
         const loopRow = await this.#db.engine_get_loop_prompt.get({ loop_id: loopId });
-        const workerFirstLoop = (loopRow?.sequence ?? 0) === 1;
+        const priorInference = await this.#db.engine_worker_has_inference_history.get({
+            worker_id: workerId,
+        });
+        const workerFirstInference = priorInference?.present === 0;
         const createdTurnIds = [];
         try {
             // {§worker-initialization-entry} — turn zero is an ordinary `_plurnk`
             // operation turn. Its model-facing zero is a phase label; durable turn
             // coordinates remain one-based.
-            const initializationTurn = initialSequence.next === 1 && workerFirstLoop
+            const initializationTurn = initialSequence.next === 1 && workerFirstInference
                 ? await Turn.open(this.#db, { loopId, producer: "_plurnk", kind: "initialization" })
                 : null;
             if (initializationTurn !== null)
@@ -617,24 +631,24 @@ class TurnRunner {
                 : null;
             if (modelTurn !== null)
                 createdTurnIds.push(modelTurn.id);
-            // {§env-delta-log-pull} — establish a fresh worker's observation
-            // baseline immediately after its first turn opens. A fork already has
-            // its parent's cursor, so the NULL-guarded statement leaves it intact.
-            // Events committed after this statement belong to this or a later
-            // closed pull window; pre-existing state is read through the ordinary
-            // shared-world projections in this first packet.
-            await this.#db.engine_initialize_ambient_cursor.get({ workspace_id: workspaceId, worker_id: workerId });
+            // {§env-delta-log-pull} — creation atomically owns the ordinary worker
+            // baseline or fork snapshot. Packet assembly consumes, never invents,
+            // that durable observation boundary.
+            const ambientCursor = await this.#db.engine_initialize_ambient_cursor.get({ workspace_id: workspaceId, worker_id: workerId });
+            if (ambientCursor?.ambient_event_cursor === null || ambientCursor === undefined) {
+                throw new Error(`worker ${workerId} has no durable ambient observation boundary`);
+            }
             // Threaded per turn, never engine state, so concurrent loops on
             // different providers each read their own honest tokenizer values.
             const systemContext = (contextTurnId) => ({
-                db: this.#db, workspaceId, workerId, loopId, turnId: contextTurnId,
+                db: this.#db, workspaceId, workerId, functionalityWorkerId: workerId, loopId, turnId: contextTurnId,
                 writer: "_plurnk",
                 signal: this.#loopSignal(loopId),
                 streamEventNotify: this.#streamEventNotify,
                 wakeWorkerNotify: this.#wakeWorkerNotify,
                 weigh: this.#weighContent,
                 mimetypes: this.#mimetypes,
-                defaultChannelFor: (s) => this.#schemes.defaultChannelFor(s, workspaceId),
+                defaultChannelFor: (s) => this.#schemes.defaultChannelFor(s, workerId),
                 pushNotice: (notice) => this.#notices.push(workspaceId, loopId, notice),
                 requestInteraction: (request) => this.#interactions.request(request, { workspaceId, workerId, loopId, turnId: contextTurnId }, this.#loopSignal(loopId)),
             });
@@ -647,27 +661,31 @@ class TurnRunner {
                 const plan = {
                     op: "PLAN", delimiter: "", annotation: null,
                     signal: null, target: null, lineMarker: null,
-                    body: "* Discover the tooling available and survey the workspace file root.",
+                    body: [{
+                            content: "Discover the tooling available and survey the workspace file root.",
+                            priority: "medium",
+                            status: "in_progress",
+                        }],
                     position: UNKNOWN_POSITION,
                 };
                 initializationStatements.push(plan);
                 // {§turn0-agents-stunt} — the project AGENTS.md (materialized by LoopDocs as
-                // worker://plurnk/agents.md) gets one foisted READ on the worker's first
+                // worker://~/_plurnk/agents.md) gets one foisted READ on the worker's first
                 // loop, so local repo guidance is visible turn-0 content. Global policy
                 // stays in the system prompt; nothing else is force-read.
-                if (workerFirstLoop) {
-                    const kernelId = await Owner.kernelId(this.#db, workspaceId);
+                if (workerFirstInference) {
                     const agentsEntry = await this.#db.crud_find_workspace_entry.get({
                         workspace_id: workspaceId,
-                        owner_id: kernelId,
+                        owner_id: workerId,
                         scheme: "worker",
-                        pathname: "/agents.md",
+                        authority: "",
+                        pathname: generatedPathname("/agents.md"),
                     });
                     if (agentsEntry !== undefined) {
                         const agentsTarget = {
-                            kind: "url", raw: "worker://plurnk/agents.md", scheme: "worker",
-                            username: null, password: null, hostname: "plurnk", port: null,
-                            pathname: "/agents.md", query: null, fragment: null,
+                            kind: "url", raw: "worker://~/_plurnk/agents.md", scheme: "worker",
+                            username: null, password: null, hostname: "~", port: null,
+                            pathname: generatedPathname("/agents.md"), query: null, fragment: null,
                         };
                         const agentsRead = {
                             op: "READ", delimiter: "", annotation: null, signal: ["+_plurnk", "+init", "+policy"], target: agentsTarget,
@@ -691,8 +709,9 @@ class TurnRunner {
             // (disk → body channel) so they appear in the catalog. No-ops
             // on headless / non-git workspaces. Runs BEFORE the derivation pump so
             // this turn's packet reflects them.
-            // Workspace creation starts this eagerly. Joining here is the correctness
-            // boundary: the model never runs against partial graph/vector coverage.
+            // Joining here is the correctness boundary: passive workspace creation and
+            // attachment spend nothing, while the model never runs against partial
+            // graph/vector coverage.
             await this.#warmWorkspace(systemCtx, false);
             // The warm materialized membership before deriving. This second pass is the
             // ordinary cheap change detector and captures any drift that landed meanwhile.
@@ -707,31 +726,33 @@ class TurnRunner {
             // consume the filesystem divergences a second time.
             await this.#warmWorkspace(systemCtx, true, false);
             // Turn-0 catalog preview (PLURNK_SERVICE_FILES_ITEMS, {§actor-boundary-catalog-preview}):
-            // Six bodyless FIND surveys in the worker's packetless initialization turn establish the skills tree
-            // (authored and Plurnk-generated families), attached tools tree, project, commons, and private
-            // surfaces in that order.
+            // Seven bodyless FIND surveys in the worker's packetless initialization turn establish the skills tree
+            // (authored and Plurnk-generated families), attached tools tree, enabled agents, project, commons, and
+            // private surfaces in that order.
             // Their `init` classification lets the model curate this opening survey as one log set.
             if (initializationTurn !== null) {
                 // {§operator-config-workspace-files-items} — workspace filesItems replaces the env default.
                 const { filesItems: workspaceMI } = await WorkspaceSettings.read(this.#db, workspaceId);
                 const filesItems = workspaceMI !== null ? normalizeFilesItems(workspaceMI) : readFilesItems();
-                if (filesItems !== null && workerFirstLoop) { // {§actor-boundary-catalog-preview} — once per worker
+                if (filesItems !== null && workerFirstInference) { // {§actor-boundary-catalog-preview} — once per worker
                     const catalogSchemes = await this.#db.engine_scheme_catalog_summary.all({ workspace_id: workspaceId });
                     const fileItems = catalogSchemes.find(({ scheme }) => scheme === "file")?.shallow_items ?? 0;
                     const fileCap = filesItems > 0 && fileItems > 0 ? Math.min(filesItems, fileItems) : null;
                     // {§tools-resource-materialization} — PLURNK_MCP_EXPANDED servers
-                    // contribute one complete tool-tree survey each, directly after the
-                    // family survey, so turn 0 names every tool they expose in order.
+                    // contribute one complete family-document READ each, directly
+                    // after the family survey, so turn 0 names every tool they
+                    // expose in order. (The family document is the whole tool
+                    // teaching — per-target child documents do not exist.)
                     const registry = this.#executors();
                     const toolExpansions = [];
-                    for (const tag of registry?.availableRuntimes(workspaceId) ?? []) {
-                        const entry = registry?.entry(tag, workspaceId);
+                    for (const tag of registry?.availableRuntimes(workerId) ?? []) {
+                        const entry = registry?.entry(tag, workerId);
                         if (entry?.resourcesPath !== "/tools" || entry.expandTools !== true)
                             continue;
                         toolExpansions.push({
                             statement: {
-                                op: "FIND", delimiter: "", annotation: `enabled tools: ${tag}`, signal: ["+_plurnk", "+init", "+tools"],
-                                target: { kind: "url", raw: `worker://plurnk/tools/${tag}/**`, scheme: "worker", username: null, password: null, hostname: "plurnk", port: null, pathname: `/tools/${tag}/**`, query: null, fragment: null },
+                                op: "READ", delimiter: "", annotation: `enabled tools: ${tag}`, signal: ["+_plurnk", "+init", "+tools"],
+                                target: { kind: "url", raw: `worker://~/_plurnk/tools/${tag}.md`, scheme: "worker", username: null, password: null, hostname: "~", port: null, pathname: generatedPathname(`/tools/${tag}.md`), query: null, fragment: null },
                                 body: null, lineMarker: { marks: [1, -1] }, position: UNKNOWN_POSITION,
                             },
                         });
@@ -740,14 +761,14 @@ class TurnRunner {
                         {
                             statement: {
                                 op: "FIND", delimiter: "", annotation: null, signal: ["+_plurnk", "+init", "+skills"],
-                                target: { kind: "url", raw: "worker://plurnk/skills/*.md", scheme: "worker", username: null, password: null, hostname: "plurnk", port: null, pathname: "/skills/*.md", query: null, fragment: null },
+                                target: { kind: "url", raw: "worker://~/_plurnk/skills/*.md", scheme: "worker", username: null, password: null, hostname: "~", port: null, pathname: generatedPathname("/skills/*.md"), query: null, fragment: null },
                                 body: null, lineMarker: { marks: [1, -1] }, position: UNKNOWN_POSITION,
                             },
                         },
                         {
                             statement: {
                                 op: "FIND", delimiter: "", annotation: null, signal: ["+_plurnk", "+init", "+skills"],
-                                target: { kind: "url", raw: "worker://plurnk/skills/plurnk/*.md", scheme: "worker", username: null, password: null, hostname: "plurnk", port: null, pathname: "/skills/plurnk/*.md", query: null, fragment: null },
+                                target: { kind: "url", raw: "worker://~/_plurnk/skills/plurnk/*.md", scheme: "worker", username: null, password: null, hostname: "~", port: null, pathname: generatedPathname("/skills/plurnk/*.md"), query: null, fragment: null },
                                 body: null, lineMarker: { marks: [1, -1] }, position: UNKNOWN_POSITION,
                             },
                         },
@@ -760,11 +781,21 @@ class TurnRunner {
                             // tool tree.
                             statement: {
                                 op: "FIND", delimiter: "", annotation: "enabled tools", signal: ["+_plurnk", "+init", "+tools"],
-                                target: { kind: "url", raw: "worker://plurnk/tools/*.md", scheme: "worker", username: null, password: null, hostname: "plurnk", port: null, pathname: "/tools/*.md", query: null, fragment: null },
+                                target: { kind: "url", raw: "worker://~/_plurnk/tools/*.md", scheme: "worker", username: null, password: null, hostname: "~", port: null, pathname: generatedPathname("/tools/*.md"), query: null, fragment: null },
                                 body: null, lineMarker: { marks: [1, -1] }, position: UNKNOWN_POSITION,
                             },
                         },
                         ...toolExpansions,
+                        {
+                            // {§a2a-agents-catalog} — enabled outbound agents survey at
+                            // alias level; each row's summary is the agent's identity line,
+                            // the exact card stays pullable through READ a2a://<alias>.
+                            statement: {
+                                op: "FIND", delimiter: "", annotation: "enabled agents", signal: ["+_plurnk", "+init", "+agents"],
+                                target: { kind: "url", raw: "worker://~/_plurnk/agents/*.md", scheme: "worker", username: null, password: null, hostname: "~", port: null, pathname: generatedPathname("/agents/*.md"), query: null, fragment: null },
+                                body: null, lineMarker: { marks: [1, -1] }, position: UNKNOWN_POSITION,
+                            },
+                        },
                         {
                             statement: {
                                 op: "FIND", delimiter: "", annotation: "workspace files", signal: ["+_plurnk", "+init"],
@@ -800,7 +831,7 @@ class TurnRunner {
                 initializationStatements.push(send);
                 const source = TurnOps.renderInternal(initializationStatements);
                 const admitted = TurnOps.parseInternal(source);
-                const result = await this.#executeAdmittedTurn({
+                const result = await this.executeAdmittedTurn({
                     statements: admitted,
                     source,
                     sourceFolded: false,
@@ -841,9 +872,12 @@ class TurnRunner {
                     const promptPath = promptTarget(promptLoopSeq, 1);
                     const entry = {
                         channels: { body: { content: promptRow.prompt, mimetype: "text/markdown" } },
-                        attributes: { openPaths },
+                        attributes: {
+                            openPaths,
+                            ...(promptRow.prompt_source === null ? {} : { source: promptRow.prompt_source }),
+                        },
                     };
-                    await EntryCrud.writeEntry(promptPath.pathname, entry, systemCtx, "prompt", workerId);
+                    await EntryCrud.writeEntry({ authority: "", pathname: promptPath.pathname }, entry, systemCtx, "prompt", workerId);
                     turnOpenPaths.push(...openPaths);
                     const promptLogId = await this.#writePromptLog({
                         workerId,
@@ -852,6 +886,7 @@ class TurnRunner {
                         sequence: nextActionIndex++,
                         target: promptPath,
                         content: promptRow.prompt,
+                        source: promptRow.prompt_source,
                     });
                     onDispatch?.(promptLogId);
                 }
@@ -882,6 +917,7 @@ class TurnRunner {
                         sequence: nextActionIndex++,
                         target: promptTarget(loopSeq, ordinal),
                         content: injectedRow.content,
+                        source: promptSourceFromAttributes(attributes, `Prompt ${injectedRow.pathname} attributes`),
                     });
                     onDispatch?.(promptLogId);
                 }
@@ -914,7 +950,7 @@ class TurnRunner {
             // the subsequent turn. The terminal output then surfaces born-OPEN via the stream-delta path.
             await this.#reapTurnScopedStreams(workerId);
             nextActionIndex += await this.#materializeEnvironmentDeltas({ workspaceId, workerId, loopId, turnId, fromSequence: nextActionIndex });
-            nextActionIndex += await this.#materializeStreamDeltas({ workspaceId, workerId, loopId, turnId, fromSequence: nextActionIndex });
+            nextActionIndex += await this.#materializeStreamDeltas({ workerId, loopId, turnId, fromSequence: nextActionIndex });
             // The post-reconciliation Git snapshot above is threaded into the packet
             // and every budget rebuild; overflow never shells again.
             // Notices are non-terminal observations, never operation-failure truth.
@@ -954,7 +990,7 @@ class TurnRunner {
                 ];
                 const source = TurnOps.renderInternal(internalStatements);
                 const admitted = TurnOps.parseInternal(source);
-                const executed = await this.#executeAdmittedTurn({
+                const executed = await this.executeAdmittedTurn({
                     statements: admitted,
                     source,
                     sourceFolded: true,
@@ -1081,6 +1117,31 @@ class TurnRunner {
                     providerAttemptId = attemptRow.id;
                     providerCallInFlight = true;
                     const currentModelCall = providerModelCall;
+                    let reasoningStarted = false;
+                    // {§notifications-reasoning-event} Only the parent emission is
+                    // conversational; BARE has no observer on its isolated calls.
+                    const observeReasoning = this.#reasoningEventNotify === undefined
+                        ? undefined
+                        : (delta) => {
+                            if (!reasoningStarted) {
+                                reasoningStarted = true;
+                                this.#reasoningEventNotify(workspaceId, {
+                                    workerId,
+                                    loopId,
+                                    turnId,
+                                    modelCallId: currentModelCall.id,
+                                    phase: "start",
+                                });
+                            }
+                            this.#reasoningEventNotify(workspaceId, {
+                                workerId,
+                                loopId,
+                                turnId,
+                                modelCallId: currentModelCall.id,
+                                phase: "content",
+                                delta,
+                            });
+                        };
                     let completedResponse;
                     try {
                         completedResponse = await observed(// {§observability-boundary}
@@ -1101,6 +1162,7 @@ class TurnRunner {
                                     loop: loopSeq,
                                     turn: seq,
                                     observeRequest: currentModelCall.observeRequest,
+                                    observeReasoning,
                                     callKind: "emission",
                                 }); // {§provider-surface-generate} {§provider-guarantees-signal-wired} {§provider-guarantees-serial-attempts} {§attribution} {§client-metadata}
                                 currentModelCall.assertAccounting(generated.accounting);
@@ -1147,6 +1209,17 @@ class TurnRunner {
                         modelMessages = PacketWire.packetToWireMessages(requestPacket);
                         continue;
                     }
+                    finally {
+                        if (reasoningStarted) {
+                            this.#reasoningEventNotify(workspaceId, {
+                                workerId,
+                                loopId,
+                                turnId,
+                                modelCallId: currentModelCall.id,
+                                phase: "end",
+                            });
+                        }
+                    }
                     response = completedResponse;
                     await currentModelCall.observeResponse(completedResponse);
                     railEvidence = railGrammar === undefined
@@ -1379,7 +1452,7 @@ class TurnRunner {
             const reasoningItems = response.assistant.reasoningEncrypted?.length
                 ? response.assistant.reasoningEncrypted
                 : undefined;
-            const executed = await this.#executeAdmittedTurn({
+            const executed = await this.executeAdmittedTurn({
                 statements: packetAssistant.ops,
                 source: splitResponse.sourceBacked ? packetAssistant.content : null,
                 sourceFolded: true,
@@ -1542,7 +1615,7 @@ class TurnRunner {
         };
     }
     // #note12 — plugin reference docs are materialized beneath
-    // worker://plurnk/skills/plurnk/ by LoopDocs.
+    // worker://~/_plurnk/skills/plurnk/ by LoopDocs.
     async #materializeEnvironmentDeltas(args) {
         const { workspaceId, workerId, loopId, turnId, fromSequence } = args;
         const rows = await this.#db.engine_pull_ambient_events.all({ workspace_id: workspaceId, worker_id: workerId });
@@ -1552,11 +1625,10 @@ class TurnRunner {
         let written = 0;
         for (const r of rows) {
             if (r.event_id === null || r.producer_worker_id === null || r.producer_worker_name === null || r.kind === null
-                || r.op === null || r.status_rx === null)
+                || r.at === null || r.op === null || r.delimiter === null || r.tx === null || r.mimetype_tx === null
+                || r.rx === null || r.mimetype_rx === null || r.status_rx === null || r.state === null)
                 continue;
             const termination = r.kind === "loop_termination";
-            if (r.rx === null)
-                throw new Error(`ambient event ${r.event_id} has no materializable result`);
             const terminal = termination
                 ? TerminalResult.parse(r.rx, `ambient loop-termination event ${r.event_id}`)
                 : null;
@@ -1587,23 +1659,36 @@ class TurnRunner {
             }
             const inserted = await this.#db.engine_insert_ambient_delta.get({
                 worker_id: workerId, loop_id: loopId, turn_id: turnId, sequence: fromSequence + written,
+                at: r.at,
                 event_id: r.event_id,
-                source: r.source ?? WorkerControlAddress.render(r.producer_worker_name),
+                source: WorkerControlAddress.render(r.producer_worker_name),
                 op: r.op,
+                delimiter: r.delimiter,
+                signal: r.signal,
                 scheme: r.scheme,
+                username: r.username,
+                password: r.password,
                 hostname: r.hostname,
+                port: r.port,
                 pathname: r.pathname,
+                query: r.query,
+                fragment: r.fragment,
+                line_marker: r.line_marker,
+                tx: r.tx,
+                mimetype_tx: r.mimetype_tx,
                 rx: r.rx,
-                mimetype_rx: "application/json",
+                mimetype_rx: r.mimetype_rx,
                 status: r.status_rx,
                 weight: LogBody.weight({
                     op: r.op,
                     attrs,
-                    tx: "",
+                    tx: r.tx,
                     rx: r.rx,
-                    mimetypeTx: "text/plain",
-                    mimetypeRx: "application/json",
+                    mimetypeTx: r.mimetype_tx,
+                    mimetypeRx: r.mimetype_rx,
                 }, this.#weighContent),
+                state: r.state,
+                outcome: r.outcome,
                 folded: LogVisibility.serialize(terminal !== null && terminal.status >= 200 && terminal.status < 300
                     ? LogVisibility.OPEN
                     : LogVisibility.FOLDED),
@@ -1639,7 +1724,7 @@ class TurnRunner {
         await Promise.all(open.map(({ id }) => this.#liveSubscriptions.cancel(id)));
     }
     async #materializeStreamDeltas(args) {
-        const { workspaceId, workerId, loopId, turnId, fromSequence } = args;
+        const { workerId, loopId, turnId, fromSequence } = args;
         const channels = await this.#db.engine_worker_stream_channels.all({ worker_id: workerId });
         let written = 0;
         for (const ch of channels) {
@@ -1648,17 +1733,22 @@ class TurnRunner {
             // ordinary address to the model; only an explicitly non-default
             // channel earns a fragment in the log.
             const visibleFragment = ch.published_channel !== null
-                && ch.channel === this.#schemes.defaultChannelFor(ch.runtime, workspaceId)
+                && ch.channel === this.#schemes.defaultChannelFor(ch.runtime, workerId)
                 ? null
                 : ch.channel;
-            const prior = await this.#db.engine_stream_cursor.get({
-                worker_id: workerId, scheme: ch.runtime, pathname: ch.coord, fragment: visibleFragment,
+            const streamBase = renderAddress({
+                scheme: ch.runtime,
+                authority: ch.authority,
+                pathname: ch.coord,
             });
-            const priorAttrs = prior !== undefined ? JSON.parse(prior.attrs) : {};
-            const cursor = priorAttrs.streamEnd ?? 0;
+            const streamTarget = visibleFragment === null
+                ? streamBase
+                : `${streamBase}#${PathSyntax.escapeTarget(visibleFragment)}`;
+            const targetParts = authorityParts(ch.authority);
+            const cursor = ch.published_end;
             const closed = ch.state === "closed" || ch.state === "errored";
             const terminal = closed
-                ? Results.assert(JSON.parse(ch.close_result ?? "null"))
+                ? Results.assert(JSON.parse(ch.producer_result ?? "null"))
                 : null;
             const terminalResult = async (fields, sequence) => {
                 if (terminal === null)
@@ -1689,17 +1779,10 @@ class TurnRunner {
                 // completion is information independently of payload. A text stream that delivered
                 // content retains its terse revisit marker; an empty text stream and every structured
                 // channel emit a bodyless typed conclusion.
-                if (closed && priorAttrs.terminal !== true) {
-                    const streamTarget = renderTarget({
-                        scheme: ch.runtime,
-                        pathname: ch.coord,
-                        fragment: visibleFragment,
-                    });
-                    if (streamTarget === null)
-                        throw new Error(`stream ${ch.subscription_id} has no renderable address`);
+                if (terminal !== null) {
                     const sequence = fromSequence + written;
                     const content = cursor > 0 && baseMimetype(ch.mimetype).startsWith("text/")
-                        ? `[ stream closed (${ch.close_status ?? 200}) - full output already delivered above; READ ${streamTarget} to revisit ]`
+                        ? `[ stream closed (${terminal.status}) - full output already delivered above; READ ${streamTarget} to revisit ]`
                         : "";
                     const rx = JSON.stringify(await terminalResult({
                         content,
@@ -1707,7 +1790,9 @@ class TurnRunner {
                     }, sequence));
                     await this.#db.engine_insert_stream_delta.run({
                         worker_id: workerId, loop_id: loopId, turn_id: turnId, sequence,
-                        scheme: ch.runtime, pathname: ch.coord, fragment: visibleFragment,
+                        subscription_publication_id: ch.publication_id,
+                        scheme: ch.runtime, hostname: targetParts.hostname, port: targetParts.port,
+                        pathname: ch.coord, fragment: visibleFragment,
                         rx,
                         weight: LogBody.weight({
                             op: "READ",
@@ -1738,7 +1823,9 @@ class TurnRunner {
             const rx = JSON.stringify(result);
             await this.#db.engine_insert_stream_delta.run({
                 worker_id: workerId, loop_id: loopId, turn_id: turnId, sequence,
-                scheme: ch.runtime, pathname: ch.coord, fragment: visibleFragment,
+                subscription_publication_id: ch.publication_id,
+                scheme: ch.runtime, hostname: targetParts.hostname, port: targetParts.port,
+                pathname: ch.coord, fragment: visibleFragment,
                 rx,
                 weight: LogBody.weight({
                     op: "READ",
@@ -1831,7 +1918,7 @@ class TurnRunner {
             throw cause;
         }
     }
-    async #writePromptLog({ workerId, loopId, turnId, sequence, target, content, }) {
+    async #writePromptLog({ workerId, loopId, turnId, sequence, target, content, source, }) {
         const rx = JSON.stringify({ content, mimetype: "text/markdown" });
         const row = await this.#db.engine_insert_log_entry.get({
             worker_id: workerId,
@@ -1839,7 +1926,7 @@ class TurnRunner {
             turn_id: turnId,
             sequence,
             origin: "_plurnk",
-            source: null,
+            source,
             model_call_id: null,
             op: "prompt",
             delimiter: "",