@plurnk/plurnk-service 1.4.0 → 1.5.0

package/dist/core/Dispatcher.js

@@ -5,27 +5,29 @@ import WorkerControlAddress from "./WorkerControlAddress.js";
 import { entryPathnameOf, foldAuthorityIntoPath, renderAddress, renderTarget, schemeNameOf } from "./plurnk-uri.js";
 import Fork from "./fork.js";
 import WorkerCap from "./worker-cap.js";
-import { parsePath, PathSyntax } from "@plurnk/plurnk-contracts";
+import { PathSyntax } from "@plurnk/plurnk-contracts";
 import Namespace from "./namespace.js";
 import LoopFlagsReader from "./LoopFlagsReader.js";
 import ChannelWrite from "./ChannelWrite.js";
-import { assertEditBatchReceipt, assertEditReceipt, assertResourceEffects, editReceipt, LineMarkerOps, MimetypeBinary, PathMimetype, projectEditReceipt, } from "../content/index.js";
+import { assertEditBatchReceipt, assertEditReceipt, assertResourceEffects, editReceipt, LineMarkerOps, MimetypeBinary, PathMimetype, ReadProjector, projectEditReceipt, } from "../content/index.js";
 import SchemeCtxImpl from "./caps/SchemeCtxImpl.js";
 import EntryCrud from "../schemes/_entry-crud.js";
 import EntryOps from "../schemes/_entry-ops.js";
+import EntryFind from "../schemes/_entry-find.js";
 import WorkspaceSettings from "./workspace-settings.js";
 import LoopLifecycle from "./LoopLifecycle.js";
+import TerminalResult from "./TerminalResult.js";
 import Results from "./results.js";
 import { OperationFailureError } from "./results.js";
 import EffectPolicy from "../schemes/EffectPolicy.js";
-import { CoreSchemeAdapterBase } from "./CoreSchemeServices.js";
+import { CoreSchemeAdapterBase, } from "./CoreSchemeServices.js";
 import { InvalidOperationResultError, NetworkAddress, } from "@plurnk/plurnk-schemes";
 import DurableStatement from "./DurableStatement.js";
 // SPEC {§scheme-surface}: writer must be in target scheme's manifest.writableBy.
 // OPEN/FOLD/READ/FIND are not gated — they curate the log or read, never mutating an entry.
 const MUTATING_OPS = new Set(["EDIT", "SEND", "COPY", "MOVE", "EXEC", "KILL", "FORK", "WORK"]);
 // Op dispatch ({§op-methods-op-dispatch}): gates (writableBy, loop flags), the
-// engine-owned op orchestrations (COPY/MOVE/KILL/SEND/READ-fanout), scheme
+// engine-owned op orchestrations (COPY/MOVE/KILL/SEND), scheme
 // routing, the durable log write, and the proposal pause.
 class Dispatcher {
     static #failure(code, status, detail, fields = {}, extensions = {}) {
@@ -95,8 +97,14 @@ class Dispatcher {
         const handlerCtx = this.#handlerContext(scheme, ctx);
         return this.#schemes.manifestFor(scheme)?.category === "data" ? handlerCtx : null;
     }
-    async #readEntry(scheme, pathname, ctx) {
+    #coreCrud(scheme) {
         const handler = this.#schemes.get(scheme);
+        return handler instanceof CoreSchemeAdapterBase
+            ? handler
+            : undefined;
+    }
+    async #readEntry(scheme, pathname, ctx) {
+        const handler = this.#coreCrud(scheme);
         const handlerCtx = this.#entryContext(scheme, ctx);
         if (typeof handler?.readEntry === "function" && handlerCtx !== null) {
             return Results.assert(await handler.readEntry(pathname, handlerCtx));
@@ -120,7 +128,7 @@ class Dispatcher {
         });
     }
     async #writeEntry(scheme, pathname, entry, ctx) {
-        const handler = this.#schemes.get(scheme);
+        const handler = this.#coreCrud(scheme);
         const handlerCtx = this.#entryContext(scheme, ctx);
         if (typeof handler?.writeEntry === "function" && handlerCtx !== null) {
             return Results.assert(await handler.writeEntry(pathname, entry, handlerCtx));
@@ -137,7 +145,7 @@ class Dispatcher {
         return Results.assert(await caps.write(pathname, entry, scheme === "prompt" ? "worker" : "commons"));
     }
     async #deleteEntry(scheme, pathname, ctx) {
-        const handler = this.#schemes.get(scheme);
+        const handler = this.#coreCrud(scheme);
         const handlerCtx = this.#entryContext(scheme, ctx);
         if (typeof handler?.deleteEntry === "function" && handlerCtx !== null) {
             return Results.assert(await handler.deleteEntry(pathname, handlerCtx));
@@ -154,7 +162,7 @@ class Dispatcher {
         return Results.assert(await caps.delete(pathname, scheme === "prompt" ? "worker" : "commons"));
     }
     async #deleteChannel(scheme, pathname, channel, ctx) {
-        const handler = this.#schemes.get(scheme);
+        const handler = this.#coreCrud(scheme);
         const handlerCtx = this.#entryContext(scheme, ctx);
         if (typeof handler?.deleteChannel === "function" && handlerCtx !== null) {
             return Results.assert(await handler.deleteChannel(pathname, channel, handlerCtx));
@@ -241,7 +249,10 @@ class Dispatcher {
                 else {
                     try {
                         const addressedScheme = first.target?.kind === "url" ? first.target.scheme : schemeName;
-                        initial = Results.assert(await method.call(handler, group, new SchemeCtxImpl(schemeCtx, addressedScheme ?? schemeName, manifest, this.#liveSubscriptions)));
+                        const publishedChannel = first.target?.kind === "url"
+                            ? first.target.fragment ?? manifest.defaultChannel
+                            : manifest.defaultChannel;
+                        initial = Results.assert(await method.call(handler, group, new SchemeCtxImpl(schemeCtx, addressedScheme ?? schemeName, manifest, this.#liveSubscriptions, { publishedChannel })));
                     }
                     catch (err) {
                         if (err instanceof InvalidOperationResultError)
@@ -297,31 +308,15 @@ class Dispatcher {
         return result;
     }
     async #dispatchOne(context) {
-        const { statement, workspaceId, workerId, loopId, turnId, sequence, origin, onDispatch, operationConstraint, } = context;
+        const { statement, workspaceId, workerId, loopId, turnId, sequence, origin, onDispatch, } = context;
         const schemeCtx = this.#buildSchemeCtx({ workspaceId, workerId, loopId, turnId, origin });
         let result;
-        let denial = operationConstraint !== undefined
-            && !operationConstraint.allowedOperations.includes(statement.op)
-            ? _a.#failure("operation-not-allowed", 409, `${statement.op} was not executed because ${operationConstraint.detail}.`, {}, {
-                constraint: operationConstraint.code,
-                allowedOperations: [...operationConstraint.allowedOperations],
-                retryable: false,
-            })
-            : null;
-        if (denial === null)
-            denial = this.#checkWritable(statement, origin);
+        let denial = this.#checkWritable(statement, origin);
         if (denial === null)
             denial = await this.#checkFlagsGate(statement, loopId);
         if (denial !== null) {
             result = denial;
         }
-        else if (this.#readFansOut(statement)) {
-            // Multi-resource scopes, relation matchers, and acquisition-scheme
-            // matchers use FIND for selection and write their own rows. An exact
-            // stored-resource content matcher remains a direct READ, preserving
-            // content-level outcomes such as 203.
-            return await this.#handleReadFanout(statement, schemeCtx, { workerId, loopId, turnId, sequence, origin, onDispatch });
-        }
         else {
             // {§scheme-surface-exception-500} Scheme-handler
             // exceptions become the action-entry's outcome (status 500), not a
@@ -531,11 +526,49 @@ class Dispatcher {
             origin: "client",
         });
         const schemeCtx = new SchemeCtxImpl(coreCtx, addressedScheme, manifest, this.#liveSubscriptions);
+        const resolved = await this.#resolveDataEntryAddress({
+            target,
+            routedScheme,
+            handler,
+            manifest,
+            ctx: coreCtx,
+            schemeCtx,
+        });
+        if (resolved.address === null)
+            return null;
+        const rendered = target.kind === "url"
+            ? renderTarget({ ...target, fragment: null })
+            : renderTarget({ scheme: null, pathname: target.raw, fragment: null });
+        if (rendered === null)
+            throw new TypeError("Resolved entry target did not render.");
+        return {
+            ownerId: resolved.address.ownerId,
+            scheme: resolved.address.scheme,
+            pathname: resolved.address.pathname,
+            target: rendered,
+        };
+    }
+    async #resolveDataEntryAddress({ target, routedScheme, handler, manifest, ctx, schemeCtx, }) {
+        const addressedScheme = target.kind === "url" ? target.scheme : routedScheme;
+        const identityTarget = target.kind === "url"
+            ? {
+                ...target,
+                pathname: PathSyntax.decodeParens(target.pathname),
+                fragment: null,
+            }
+            : { ...target, raw: PathSyntax.decodeParens(target.raw) };
         const resolved = handler.resolveEntryAddress === undefined
-            ? { pathname: entryPathnameOf(target), owner: "commons" }
-            : await handler.resolveEntryAddress(target, schemeCtx);
+            ? { pathname: entryPathnameOf(identityTarget), owner: "commons" }
+            : await handler.resolveEntryAddress(identityTarget, schemeCtx);
         if (resolved === null)
-            return null;
+            return { address: null, result: null };
+        if ("status" in resolved) {
+            const result = Results.assert(resolved);
+            if (result.status < 300) {
+                throw new InvalidOperationResultError(`Scheme '${routedScheme}' returned a successful operation result instead of an entry address.`);
+            }
+            return { address: null, result };
+        }
         if (typeof resolved.pathname !== "string") {
             throw new TypeError(`Scheme '${routedScheme}' returned an invalid entry pathname.`);
         }
@@ -547,10 +580,10 @@ class Dispatcher {
             ownerId = resolved.ownerId;
         }
         else if (resolved.owner === "worker") {
-            ownerId = workerId;
+            ownerId = ctx.workerId;
         }
         else if (resolved.owner === "commons") {
-            ownerId = await Owner.commonsId(this.#db, workspaceId);
+            ownerId = await Owner.commonsId(this.#db, ctx.workspaceId);
         }
         else {
             throw new TypeError(`Scheme '${routedScheme}' returned an invalid entry owner.`);
@@ -558,16 +591,48 @@ class Dispatcher {
         if (!Number.isSafeInteger(ownerId) || ownerId < 1) {
             throw new TypeError(`Scheme '${routedScheme}' returned an invalid entry owner id.`);
         }
-        const rendered = target.kind === "url"
-            ? renderTarget({ ...target, fragment: null })
-            : renderTarget({ scheme: null, pathname: target.raw, fragment: null });
-        if (rendered === null)
-            throw new TypeError("Resolved entry target did not render.");
         return {
-            ownerId,
-            scheme: manifest.storedScheme ?? addressedScheme,
-            pathname: resolved.pathname,
-            target: rendered,
+            address: {
+                ownerId,
+                scheme: manifest.storedScheme ?? addressedScheme,
+                pathname: resolved.pathname,
+            },
+            result: null,
+        };
+    }
+    async #prepareDataRepresentation({ target, routedScheme, handler, manifest, ctx, schemeCtx, publishedChannel, }) {
+        const resolved = await this.#resolveDataEntryAddress({
+            target,
+            routedScheme,
+            handler,
+            manifest,
+            ctx,
+            schemeCtx,
+        });
+        if (resolved.address === null
+            || resolved.result !== null
+            || typeof handler.prepareRepresentation !== "function") {
+            return resolved;
+        }
+        const address = resolved.address;
+        const selectionNeutralTarget = target.kind === "url"
+            ? {
+                ...target,
+                raw: renderTarget({ ...target, fragment: null }) ?? target.raw,
+                fragment: null,
+            }
+            : target;
+        const preparationCtx = new SchemeCtxImpl(ctx, target.kind === "url" ? target.scheme : routedScheme, manifest, this.#liveSubscriptions, {
+            ownerId: address.ownerId,
+            publishedChannel,
+        });
+        const prepared = Results.assertRepresentationPreparation(await handler.prepareRepresentation({
+            target: selectionNeutralTarget,
+            pathname: address.pathname,
+        }, preparationCtx));
+        return {
+            address,
+            result: prepared.status === 200 ? null : prepared,
         };
     }
     // An accepted EXEC reads a non-file source through the same registered
@@ -829,7 +894,7 @@ class Dispatcher {
         if (statement.op === "FORK") {
             // Branch the current worker's log into a named sister.
             const branchWorkerId = await Fork.fork(this.#db, ctx.workerId, name);
-            await ctx.injectWorker({ workspaceId: ctx.workspaceId, workerId: branchWorkerId, prompt, flags });
+            await ctx.injectWorker({ workspaceId: ctx.workspaceId, workerId: branchWorkerId, prompt, flags, parentLoopId: ctx.loopId });
             return { status: 200, body: name };
         }
         // WORK — a fresh worker sister named <name>.
@@ -838,7 +903,7 @@ class Dispatcher {
         });
         if (row === undefined)
             throw new Error("worker spawn: worker insert returned no row");
-        await ctx.injectWorker({ workspaceId: ctx.workspaceId, workerId: row.id, prompt, flags });
+        await ctx.injectWorker({ workspaceId: ctx.workspaceId, workerId: row.id, prompt, flags, parentLoopId: ctx.loopId });
         return { status: 200, body: name };
     }
     async #handleCopy(statement, ctx) {
@@ -949,178 +1014,28 @@ class Dispatcher {
         // carries the delete target to review (#isProposal fires on 202). Plurnk-internal deletes execute inline.
         return this.#deleteEntry(schemeName, entryPathnameOf(path), ctx);
     }
-    // A multi-resource READ uses FIND as its resource selector, then writes one
-    // READ row per selected resource. Match coordinates remain metadata on that
-    // resource; they never create extra rows or replace its content.
-    #readFansOut(statement) {
-        if (statement.op !== "READ")
-            return false;
-        const body = statement.body;
-        if (body?.dialect === "semantic" || body?.dialect === "graph")
-            return true;
-        const schemeName = schemeNameOf(statement.target);
-        const handler = schemeName === null
-            ? undefined
-            : this.#schemes.get(schemeName);
-        if (body !== null && typeof handler?.prepareFind === "function")
-            return true;
-        const t = statement.target;
-        const p = t === null ? "" : (t.kind === "url" ? t.pathname : t.raw);
-        if (PathSyntax.hasGlob(p))
-            return true;
-        return p.endsWith("/") && schemeName !== null && this.#schemes.manifestFor(schemeName)?.folderScopes === true;
-    }
-    static #retargetRead(statement, pathname, lineMarker, body) {
-        const t = statement.target;
-        const target = t !== null && t.kind === "url"
-            ? { ...t, pathname, raw: `${t.scheme}://${pathname}` }
-            : { ...t, raw: pathname };
-        return { ...statement, target: target, lineMarker, body };
-    }
-    // READ scope always projects text. Semantic READ reserves a leading decimal
-    // for similarity selection; any remaining integers are the text projection.
-    // FIND retains its own public result-range interpretation.
-    static #readMarkers(statement) {
-        const marker = statement.lineMarker;
-        if (statement.body?.dialect !== "semantic") {
-            return { selection: null, projection: marker };
-        }
-        if (marker === null)
-            return { selection: null, projection: null };
-        const [first, ...rest] = marker.marks;
-        if (Number.isInteger(first)) {
-            return { selection: null, projection: marker };
-        }
-        return {
-            selection: { marks: [first] },
-            projection: rest.length === 0 ? null : { marks: rest },
-        };
-    }
-    #standardEntryManifest(schemeName, statement) {
-        const handler = this.#schemes.get(schemeName);
-        if (typeof handler?.find === "function")
-            return null;
-        const target = statement.target;
-        if (target === null || target.kind !== "url" || target.scheme === null)
-            return null;
-        const manifest = this.#schemes.manifestFor(schemeName);
-        return manifest === undefined ? null : { ...manifest, name: target.scheme };
-    }
-    static #storedEntryRead(statement, pathname, lineMarker, body, storage) {
-        const target = statement.target;
-        if (target === null || target.kind !== "url")
-            return _a.#retargetRead(statement, pathname, lineMarker, body);
-        if (NetworkAddress.supports(target.scheme)) {
-            const parsed = parsePath(renderAddress(target.scheme, pathname));
-            if (parsed === null || parsed.kind !== "url") {
-                throw new Error(`failed to reconstruct network entry target for ${target.scheme}:${pathname}`);
-            }
-            const reconstructed = { ...parsed, fragment: target.fragment };
-            const raw = renderTarget(reconstructed);
-            if (raw === null)
-                throw new Error(`failed to render network entry target for ${target.scheme}:${pathname}`);
-            return {
-                ...statement,
-                target: { ...reconstructed, raw },
-                lineMarker,
-                body,
-            };
-        }
-        const hostPrefix = target.hostname === null ? null : `/${target.hostname}`;
-        const displayPath = hostPrefix !== null && pathname.startsWith(`${hostPrefix}/`)
-            ? pathname.slice(hostPrefix.length)
-            : pathname;
-        return {
-            ...statement,
-            target: storage
-                ? { ...target, hostname: null, pathname, raw: `${target.scheme}://${pathname}` }
-                : { ...target, pathname: displayPath, raw: `${target.scheme}://${target.hostname ?? ""}${displayPath}` },
-            lineMarker,
-            body,
-        };
-    }
-    async #handleReadFanout(statement, ctx, ids) {
-        const { workerId, loopId, turnId, sequence, origin, onDispatch } = ids;
-        const schemeName = schemeNameOf(statement.target);
-        const read = statement;
-        const markers = _a.#readMarkers(read);
-        const findStatement = {
-            ...statement,
-            op: "FIND",
-            lineMarker: markers.selection,
-        };
-        const standardEntryManifest = schemeName === null ? null : this.#standardEntryManifest(schemeName, statement);
-        const found = await this.#run(schemeName, findStatement, ctx);
-        const matches = found.matches ?? [];
-        const omittedItems = typeof found.omittedItems === "number" ? found.omittedItems : null;
-        if (omittedItems !== null) {
-            const maximumItems = typeof found.maximumItems === "number" ? found.maximumItems : null;
-            const result = _a.#failure("read-materialization-too-large", 413, `READ selected ${omittedItems} resources, exceeding the materialization limit${maximumItems === null ? "" : ` of ${maximumItems}`}.`, {}, {
-                resources: omittedItems,
-                ...(maximumItems === null ? {} : { maximumResources: maximumItems }),
-                stage: "materialization",
-                recovery: "Narrow the target or matcher.",
-                retryable: false,
-            });
-            const readRowId = await this.#writeLog({ statement, result, workspaceId: ctx.workspaceId, workerId, loopId, turnId, sequence, origin });
-            onDispatch?.(readRowId);
-            return { ...result, rowsWritten: 1 };
-        }
-        // Find-less scheme, a matcher/scope error, or zero matches → a single row carrying the
-        // status, exactly like a non-fanned READ. The model sees the empty/failed result, not silence.
-        if (found.status !== 200 || matches.length === 0) {
-            const result = found.status === 200
-                ? { status: 204, ...(read.body === null ? {} : { matches: [] }) }
-                : found;
-            const id = await this.#writeLog({ statement, result, workspaceId: ctx.workspaceId, workerId, loopId, turnId, sequence, origin });
-            onDispatch?.(id);
-            return { ...result, rowsWritten: 1 };
-        }
-        const fannedStatuses = [];
-        const scopeNormalizations = [];
-        let written = 0;
-        for (const match of matches) {
-            ctx.signal?.throwIfAborted();
-            const executionStatement = standardEntryManifest === null
-                ? _a.#retargetRead(statement, match.pathname, markers.projection, null)
-                : _a.#storedEntryRead(statement, match.pathname, markers.projection, null, true);
-            const readResult = standardEntryManifest === null
-                ? await this.#run(schemeName, executionStatement, ctx)
-                : await EntryOps.readWorkspaceEntry(executionStatement, ctx, standardEntryManifest);
-            const result = read.body === null
-                ? readResult
-                : { ...readResult, matches: match.matches };
-            const loggedStatement = standardEntryManifest === null
-                ? _a.#retargetRead(statement, match.pathname, statement.lineMarker, read.body)
-                : _a.#storedEntryRead(statement, match.pathname, statement.lineMarker, read.body, false);
-            const id = await this.#writeLog({ statement: loggedStatement, result, workspaceId: ctx.workspaceId, workerId, loopId, turnId, sequence: sequence + written, origin });
-            onDispatch?.(id);
-            fannedStatuses.push(result.status);
-            scopeNormalizations.push(...(result.scopeNormalizations ?? []));
-            written++;
-        }
-        return {
-            status: 200,
-            rowsWritten: written,
-            fannedStatuses,
-            ...(scopeNormalizations.length === 0 ? {} : { scopeNormalizations }),
-        };
-    }
-    // {§model-entry} — mirror an admitted model emission back as an actionless `model` log row, so
-    // the model can inspect and curate its own prior behavior.
+    // {§model-entry} — mirror a model emission back as an actionless log row, so
+    // the model can inspect and curate its own prior behavior. Ordinary admitted
+    // emissions are folded; the bounded invalid-emission lifeline is the one
+    // born-open rejected item under {§invalid-emission-attempts} and labels
+    // that admission fact structurally.
     // Born FOLDED by default (budget-neutral until OPENed); the turn-0 exemplar passes folded:false
     // (born open — the one worked example the model orients on, thinning the grammar). text/vnd.plurnk.
-    async writeModelEntry({ verbatim, workerId, loopId, turnId, sequence, folded, origin = "model", reasoningItems }) {
+    async writeModelEntry({ verbatim, workerId, loopId, turnId, sequence, folded, origin = "model", admission = "accepted", reasoningItems }) {
         const row = await this.#db.engine_insert_log_entry.get({
             worker_id: workerId, loop_id: loopId, turn_id: turnId, sequence,
-            origin, source: null, op: "model", suffix: "", signal: null,
+            origin, source: null, op: null, suffix: "", signal: null,
             scheme: null, username: null, password: null, hostname: null, port: null,
             pathname: null, query: null, fragment: null, lineMarker: null,
             tx: "", mimetype_tx: "text/vnd.plurnk",
             rx: JSON.stringify({ content: verbatim, mimetype: "text/vnd.plurnk" }),
             mimetype_rx: "application/json",
             status_rx: 200, tokens: this.#tokenize(verbatim), state: "resolved", outcome: null,
-            attrs: reasoningItems !== undefined && reasoningItems.length > 0 ? JSON.stringify({ reasoning: reasoningItems }) : "{}",
+            attrs: JSON.stringify({
+                kind: "model_emission",
+                ...(admission === "rejected" ? { admission } : {}),
+                ...(reasoningItems !== undefined && reasoningItems.length > 0 ? { reasoning: reasoningItems } : {}),
+            }),
         });
         if (row === undefined)
             throw new Error("Dispatcher.writeModelEntry: insert returned no row");
@@ -1202,7 +1117,30 @@ class Dispatcher {
         };
     }
     async #selectSource(selection, ctx) {
-        const read = await this.#readEntry(selection.scheme, selection.pathname, ctx);
+        const handler = this.#schemes.get(selection.scheme);
+        if (handler === undefined) {
+            throw new InvalidOperationResultError(`Resolved COPY/MOVE source scheme '${selection.scheme}' is no longer registered.`);
+        }
+        const addressedScheme = selection.target.kind === "url"
+            ? selection.target.scheme
+            : selection.scheme;
+        const schemeCtx = new SchemeCtxImpl(ctx, addressedScheme, selection.manifest, this.#liveSubscriptions, { publishedChannel: selection.channel });
+        const prepared = await this.#prepareDataRepresentation({
+            target: selection.target,
+            routedScheme: selection.scheme,
+            handler,
+            manifest: selection.manifest,
+            ctx,
+            schemeCtx,
+            publishedChannel: selection.channel,
+        });
+        if (prepared.result !== null)
+            return prepared.result;
+        if (prepared.address === null) {
+            return _a.#failure("entry-not-found", 404, `No entry exists at ${this.#resourceAddress(selection)}.`, {}, { target: this.#resourceAddress(selection) });
+        }
+        const storageAddress = prepared.address;
+        const read = await EntryCrud.readEntry(storageAddress.pathname, ctx, storageAddress.scheme, storageAddress.ownerId);
         if (read.status >= 400)
             return read;
         if (read.status !== 200 || read.entry === null) {
@@ -1210,8 +1148,8 @@ class Dispatcher {
         }
         const selected = read.entry.channels[selection.channel];
         if (selected === undefined) {
-            return _a.#failure("channel-not-found", 404, `No channel named #${selection.channel} exists at ${renderAddress(selection.scheme, selection.identityPathname)}.`, {}, {
-                target: renderAddress(selection.scheme, selection.identityPathname),
+            return _a.#failure("channel-not-found", 404, `No channel named #${selection.channel} exists at ${renderAddress(storageAddress.scheme, storageAddress.pathname)}.`, {}, {
+                target: renderAddress(storageAddress.scheme, storageAddress.pathname),
                 requestedChannel: selection.channel,
                 availableChannels: Object.keys(read.entry.channels),
                 retryable: false,
@@ -1234,8 +1172,12 @@ class Dispatcher {
             content = sliced.text ?? "";
             scopeNormalizations = sliced.scopeNormalizations;
         }
+        if (selected.producerResult !== undefined && selected.producerResult.status >= 400) {
+            return Results.assert(selected.producerResult);
+        }
         return {
             ...selection,
+            storageAddress,
             content,
             mimetype: selected.mimetype,
             ...(scopeNormalizations === undefined ? {} : { scopeNormalizations }),
@@ -1911,7 +1853,7 @@ class Dispatcher {
         if (status === null) {
             return _a.#failure("send-status-required", 400, "SEND requires a numeric status.", {}, { retryable: false });
         }
-        const raw = statement.body === null ? "" : typeof statement.body === "string" ? statement.body : statement.body.raw;
+        const raw = statement.body === null ? "" : statement.body.raw;
         // The park rides SEND[202] only ({§park-202-only}). A scoped SEND[102] is neither
         // a wait nor a meaningful continuation, so reject it instead of preserving the
         // retired dual spelling.
@@ -1927,7 +1869,7 @@ class Dispatcher {
         // indefinite park. {§join-blocking-collect}
         const joinArmed = this.#joinTargets.delete(loopId);
         if (status === 102 && statement.lineMarker === null && joinArmed) {
-            if (!await this.#lifecycle.park(loopId, raw.length > 0 ? raw : "parked — awaiting a worker's result (blocking collect)")) {
+            if (!await this.#lifecycle.park(loopId)) {
                 return _a.#statusResult(await this.#lifecycle.status(loopId), "loop-already-terminal", "The loop was already terminal when SEND attempted to park it.");
             }
             this.#parkDeadlines.set(loopId, -1); // indefinite: the bounded child's terminal is the wake edge
@@ -1942,7 +1884,7 @@ class Dispatcher {
             const marks = statement.lineMarker?.marks[0];
             const seconds = typeof marks === "number" ? marks : -1; // bare 202 / absent T = indefinite, bounded by the join
             if (await this.#hasLiveWork(workerId)) {
-                if (!await this.#lifecycle.park(loopId, raw.length > 0 ? raw : "waiting on live work")) {
+                if (!await this.#lifecycle.park(loopId)) {
                     return _a.#statusResult(await this.#lifecycle.status(loopId), "loop-already-terminal", "The loop was already terminal when SEND attempted to wait.");
                 }
                 this.#parkDeadlines.set(loopId, seconds);
@@ -1964,7 +1906,7 @@ class Dispatcher {
                 return branchDenial;
             // The joined set is already drained. Awaiting an empty task group completes
             // immediately; it never parks and needs no corrective model turn.
-            const finished = await this.#lifecycle.finish(loopId, { status: 200 }, { message: raw === "" ? null : raw });
+            const finished = await this.#lifecycle.finish(loopId, TerminalResult.success(raw));
             return {
                 status: finished !== null ? 200 : await this.#lifecycle.status(loopId),
                 attrs: { joined: true, pending: 0 },
@@ -2022,7 +1964,7 @@ class Dispatcher {
             const branchDenial = await this.#branchCompletionGate?.(workerId) ?? null;
             if (branchDenial !== null)
                 return branchDenial;
-            const finished = await this.#lifecycle.finish(loopId, { status: 200 }, { message: raw === "" ? null : raw });
+            const finished = await this.#lifecycle.finish(loopId, TerminalResult.success(raw));
             return _a.#statusResult(finished !== null ? 200 : await this.#lifecycle.status(loopId), "loop-already-terminal", "The loop was already terminal when SEND attempted to conclude it.");
         }
         if (status === 499) {
@@ -2050,7 +1992,20 @@ class Dispatcher {
     }
     async #run(schemeName, statement, ctx) {
         if (schemeName === null) {
-            return _a.#failure("target-scheme-required", 400, `${statement.op} requires a target scheme.`, {}, { operation: statement.op, retryable: false });
+            const fields = statement.op === "READ"
+                ? { content: null, mimetype: null, channel: null }
+                : statement.op === "FIND"
+                    ? {
+                        content: null,
+                        mimetype: null,
+                        results: [],
+                        itemsTokenTotal: 0,
+                        returnedItemsTokenTotal: 0,
+                        matchingPathCount: 0,
+                        matchLocationCount: 0,
+                    }
+                    : {};
+            return _a.#failure("target-scheme-required", 400, `${statement.op} requires a target scheme.`, fields, { operation: statement.op, retryable: false });
         }
         if (statement.op === "SEND" && statement.signal === 499 && statement.target?.kind === "url") {
             const addressedScheme = statement.target.scheme;
@@ -2084,16 +2039,127 @@ class Dispatcher {
         const manifest = this.#schemes.manifestFor(schemeName);
         if (manifest === undefined)
             throw new Error(`scheme '${schemeName}' has no manifest`);
-        const schemeCtx = new SchemeCtxImpl(ctx, addressedScheme ?? schemeName, manifest, this.#liveSubscriptions);
-        if (typeof method === "function")
-            return Results.assert(await method.call(handler, statement, schemeCtx));
+        const publishedChannel = statement.target?.kind === "url"
+            ? statement.target.fragment ?? manifest.defaultChannel
+            : manifest.defaultChannel;
+        const schemeCtx = new SchemeCtxImpl(ctx, addressedScheme ?? schemeName, manifest, this.#liveSubscriptions, { publishedChannel });
+        if (statement.op === "READ"
+            && handler instanceof CoreSchemeAdapterBase
+            && typeof handler.resolveCoreRepresentation === "function") {
+            const selectionNeutralTarget = statement.target?.kind === "url"
+                ? {
+                    ...statement.target,
+                    raw: renderTarget({ ...statement.target, fragment: null }) ?? statement.target.raw,
+                    fragment: null,
+                }
+                : statement.target;
+            const resolved = await handler
+                .resolveCoreRepresentation(selectionNeutralTarget, schemeCtx);
+            if ("result" in resolved)
+                return Results.assertReadResult(resolved.result);
+            if (selectionNeutralTarget === null) {
+                throw new InvalidOperationResultError(`Core scheme '${schemeName}' resolved a targetless READ representation.`);
+            }
+            const target = renderTarget(selectionNeutralTarget.kind === "url"
+                ? selectionNeutralTarget
+                : { scheme: null, pathname: selectionNeutralTarget.raw });
+            if (target === null) {
+                throw new TypeError(`Core scheme '${schemeName}' resolved an unrenderable READ target.`);
+            }
+            return Results.assertReadResult(await ReadProjector.project({
+                statement,
+                manifest,
+                target,
+                representation: resolved.representation,
+                mimetypes: ctx.mimetypes,
+            }));
+        }
+        if (statement.op === "READ" && manifest.category === "data") {
+            const prepared = statement.target === null
+                ? { address: null, result: null }
+                : await this.#prepareDataRepresentation({
+                    target: statement.target,
+                    routedScheme: schemeName,
+                    handler: handler,
+                    manifest,
+                    ctx,
+                    schemeCtx,
+                    publishedChannel,
+                });
+            if (prepared.result !== null)
+                return prepared.result;
+            const resolved = prepared.address;
+            if (statement.target !== null && resolved === null) {
+                const target = renderTarget(statement.target.kind === "url"
+                    ? statement.target
+                    : { scheme: null, pathname: statement.target.raw });
+                return Results.failure(`scheme:${schemeName}`, "entry-not-found", 404, `No entry exists at ${target ?? "the requested address"}.`, { content: null, mimetype: null, channel: null }, { target });
+            }
+            const storageScheme = resolved?.scheme ?? manifest.storedScheme ?? addressedScheme ?? schemeName;
+            const projected = Results.assertReadResult(await EntryOps.readWorkspaceEntry(statement, ctx, { ...manifest, name: storageScheme, storedScheme: storageScheme }, resolved === null
+                ? {}
+                : {
+                    ownerId: resolved.ownerId,
+                    pathname: resolved.pathname,
+                }));
+            return projected;
+        }
         if (statement.op !== "FIND" || manifest.category !== "data") {
+            if (typeof method === "function") {
+                return Results.assert(await method.call(handler, statement, schemeCtx));
+            }
             return _a.#failure("operation-not-implemented", 501, `Scheme '${schemeName}' does not implement ${statement.op}.`, {}, {
                 scheme: schemeName,
                 operation: statement.op,
                 retryable: false,
             });
         }
+        const targetPathname = statement.target?.kind === "url"
+            ? statement.target.pathname
+            : statement.target?.raw ?? "";
+        const collectionTarget = manifest.folderScopes === true
+            && (targetPathname === "" || targetPathname.endsWith("/"));
+        const exactTarget = statement.target !== null
+            && !collectionTarget
+            && !PathSyntax.hasGlob(entryPathnameOf(statement.target));
+        if (exactTarget && statement.target !== null) {
+            const prepared = await this.#prepareDataRepresentation({
+                target: statement.target,
+                routedScheme: schemeName,
+                handler: handler,
+                manifest,
+                ctx,
+                schemeCtx,
+                publishedChannel,
+            });
+            if (prepared.result !== null)
+                return prepared.result;
+            if (prepared.address === null) {
+                const target = renderTarget(statement.target.kind === "url"
+                    ? statement.target
+                    : { scheme: null, pathname: statement.target.raw });
+                return Results.failure(`scheme:${schemeName}`, "entry-not-found", 404, `No entry exists at ${target ?? "the requested address"}.`, {
+                    content: null,
+                    mimetype: null,
+                    results: [],
+                    itemsTokenTotal: 0,
+                    returnedItemsTokenTotal: 0,
+                    matchingPathCount: 0,
+                    matchLocationCount: 0,
+                }, { target });
+            }
+            const storageScheme = prepared.address.scheme
+                ?? manifest.storedScheme
+                ?? addressedScheme
+                ?? schemeName;
+            return Results.assert(await EntryFind.findWorkspaceEntries(statement, ctx, { ...manifest, name: storageScheme, storedScheme: storageScheme }, {
+                ownerId: prepared.address.ownerId,
+                pathname: prepared.address.pathname,
+            }));
+        }
+        if (typeof method === "function") {
+            return Results.assert(await method.call(handler, statement, schemeCtx));
+        }
         const prepareFind = handler.prepareFind;
         if (typeof prepareFind === "function") {
             const prepared = await prepareFind.call(handler, statement, schemeCtx);