@plurnk/plurnk-service 1.14.2 → 1.16.0

package/dist/core/mutation-types.d.ts

@@ -0,0 +1,102 @@
+import { type LineMarker, type ParsedPath, type ReadStatement, type ResourceSelection, type SchemeMetadataOrNull, type TextLineMarker } from "@plurnk/plurnk-contracts";
+import { type ScopeNormalization, type SchemeHandler, type SchemeResult } from "@plurnk/plurnk-schemes";
+import type { SchemeManifest, WriterTier, PlurnkSchemeContext } from "./scheme-types.ts";
+import { type EditBatchReceipt, type LineAnchorPrecondition, type ResourceEffect } from "../content/index.ts";
+import type { BoundEntryAddress, EntryAddressResolution } from "./EntryAddressBinding.ts";
+export type DispatchResult = SchemeResult;
+export type EditPreparationContext = {
+    readonly workspaceId: number;
+    readonly workerId: number;
+    readonly loopId: number;
+    readonly origin: WriterTier;
+};
+export type PreparedEditBatch = {
+    readonly initial: DispatchResult;
+    readonly settled: Promise<DispatchResult>;
+    aggregate: EditBatchReceipt | undefined;
+    settle(result: DispatchResult): void;
+};
+export type EditMergeFact = {
+    readonly rule: string;
+} & Record<string, unknown>;
+export type PreparedEdit = {
+    readonly first: boolean;
+    readonly index: number;
+    readonly normalizationIndex: number | null;
+    readonly projection: DispatchResult | null;
+    readonly batch: PreparedEditBatch;
+    readonly receiptIndex: number | null;
+    readonly merged: readonly EditMergeFact[];
+};
+export type ResolvedDataEntryAddress = BoundEntryAddress;
+export type PreparedRepresentation = EntryAddressResolution;
+export type MetadataResourceSelection = ResourceSelection & {
+    readonly metadata: SchemeMetadataOrNull;
+};
+export type ResourceAddress = {
+    readonly target: ParsedPath;
+    readonly metadata: SchemeMetadataOrNull;
+    readonly scheme: string;
+    readonly authority: string;
+    readonly pathname: string;
+    readonly identityPathname: string;
+    readonly channel: string;
+    readonly manifest: SchemeManifest;
+};
+export type AddressedResourceSelection = ResourceAddress & {
+    readonly lineMarker: TextLineMarker | null;
+};
+export type ResolvedResourceSelection = ResourceAddress & {
+    readonly lineMarker: LineMarker | null;
+};
+export type SelectedSource = ResolvedResourceSelection & {
+    readonly storageAddress: ResolvedDataEntryAddress;
+    readonly content: string;
+    readonly completeContent: string;
+    readonly bytes?: Uint8Array;
+    readonly mimetype: string;
+    readonly lineAnchorPrecondition: LineAnchorPrecondition | null;
+    readonly scopeNormalizations?: ReadonlyArray<ScopeNormalization>;
+};
+export type DeferredMoveSource = {
+    readonly target: ParsedPath;
+    readonly metadata: SchemeMetadataOrNull;
+    readonly lineMarker: LineMarker | null;
+    readonly scheme: string;
+    readonly authority: string;
+    readonly pathname: string;
+    readonly channel: string;
+    readonly destination: string;
+    readonly lineAnchorPrecondition: LineAnchorPrecondition | null;
+};
+export type PendingResourceEffect = Pick<ResourceEffect, "target" | "action">;
+export type OrchestrationProposalAttrs = {
+    readonly proposalScheme?: string;
+    readonly proposalTarget?: {
+        readonly scheme: string;
+        readonly authority: string;
+        readonly pathname: string;
+    };
+    readonly proposalEffects?: readonly PendingResourceEffect[];
+    readonly moveSource?: DeferredMoveSource;
+    readonly moveDestinationWritten?: string;
+    readonly moveDestinationEffects?: readonly ResourceEffect[];
+};
+export type RunOperation = (schemeName: string | null, statement: ReadStatement, ctx: PlurnkSchemeContext) => Promise<DispatchResult>;
+export type PrepareDataRepresentation = (args: {
+    target: ParsedPath;
+    metadata: SchemeMetadataOrNull;
+    routedScheme: string;
+    handler: SchemeHandler;
+    manifest: SchemeManifest;
+    ctx: PlurnkSchemeContext;
+    publishedChannel: string | null;
+}) => Promise<PreparedRepresentation>;
+export type ProposalIds = {
+    workspaceId: number;
+    workerId: number;
+    functionalityWorkerId: number;
+    loopId: number;
+    turnId: number;
+};
+//# sourceMappingURL=mutation-types.d.ts.map

package/dist/core/mutation-types.d.ts.map

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

package/dist/core/mutation-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mutation-types.js.map

package/dist/core/mutation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-types.js","sourceRoot":"","sources":["../../src/core/mutation-types.ts"],"names":[],"mappings":""}

package/dist/core/operation-target-groups.js

@@ -32,7 +32,7 @@ const splitTopLevel = (raw) => {
 // path grammar. The authored statement remains in the forensic turnOps source;
 // only ordinary dispatch receives one clone per independently valid URI.
 export const expandSafeUriTargetGroup = (statement) => {
-    if (statement.op !== "READ" && statement.op !== "FOLD" && statement.op !== "OPEN" && statement.op !== "KILL")
+    if (statement.op !== "READ" && statement.op !== "KILL")
         return [statement];
     if (statement.target === null)
         return [statement];

package/dist/core/operation-target-groups.js.map

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

package/dist/core/packet-wire.d.ts

@@ -1,7 +1,5 @@
-export declare const previewBounds: () => {
-    lines: number;
-    chars: number;
-};
+import type { PacketAttachment, RequestPacket } from "./StoredPacket.ts";
+import type { ChatMessage } from "@plurnk/plurnk-providers";
 interface SectionView {
     name?: unknown;
     slot?: unknown;
@@ -17,7 +15,7 @@ interface RenderLogOptions {
     readonly promptProjectionWeight?: number;
     readonly projectRoot?: string | null;
 }
-export interface ReclaimableLogBody {
+interface ReclaimableLogBody {
     readonly path: string;
     readonly tokensBody: number;
     readonly tokensActive: number;
@@ -25,7 +23,10 @@ export interface ReclaimableLogBody {
 export interface RenderedLog {
     readonly content: string;
     readonly reclaimableBodies: readonly ReclaimableLogBody[];
+    readonly attachments: readonly PacketAttachment[];
 }
+import { imageWeight, pdfWeight } from "./attachments.ts";
+export { imageWeight, pdfWeight };
 export default class PacketWire {
     #private;
     static renderSlot(sections: SectionView[], slot: "system" | "user"): string;
@@ -41,6 +42,6 @@ export default class PacketWire {
         role: string;
         content: string;
     }>;
+    static wireMessages(packet: RequestPacket, bytesOf: (attachment: PacketAttachment) => Promise<Uint8Array | null>, accepts?: (kind: PacketAttachment["kind"]) => boolean): Promise<ChatMessage[]>;
 }
-export {};
 //# sourceMappingURL=packet-wire.d.ts.map

package/dist/core/packet-wire.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packet-wire.d.ts","sourceRoot":"","sources":["../../src/core/packet-wire.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,aAAa,QAAO;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAY9D,CAAC;AAoEF,UAAU,WAAW;IAAG,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE;AAC/G,UAAU,MAAM;IAAG,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE;AAC7C,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAC7C,UAAU,gBAAgB;IACtB,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAGzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC7D;AAeD,MAAM,CAAC,OAAO,OAAO,UAAU;;IAK3B,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAM1E;IAMD,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAI3C;IAKD,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAMtD;IAKD,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAe7C;IAMD,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAGhD;IAGD,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGrC;IAKD,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAErG;IAID,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAWxH;IAKD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;IAKD,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAMpF;CAg2BJ"}
+{"version":3,"file":"packet-wire.d.ts","sourceRoot":"","sources":["../../src/core/packet-wire.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA0G7E,UAAU,WAAW;IAAG,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE;AAC/G,UAAU,MAAM;IAAG,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE;AAC7C,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAC7C,UAAU,gBAAgB;IACtB,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAGzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,UAAU,kBAAkB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAE1D,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACrD;AAED,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAgBlC,MAAM,CAAC,OAAO,OAAO,UAAU;;IAK3B,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAM1E;IAMD,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAI3C;IAKD,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAMtD;IAKD,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAe7C;IAMD,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAQhD;IAGD,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGrC;IAKD,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAErG;IAID,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAUxH;IAKD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;IAKD,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAMpF;IAuyBD,OAAa,YAAY,CACrB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,CAAC,UAAU,EAAE,gBAAgB,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,EACrE,OAAO,GAAE,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,OAAoB,GAClE,OAAO,CAAC,WAAW,EAAE,CAAC,CAYxB;CAkEJ"}

package/dist/core/packet-wire.js

@@ -22,7 +22,7 @@ const editReceiptRevisionChars = () => {
     }
     return value;
 };
-export const previewBounds = () => {
+const previewBounds = () => {
     const rawLines = process.env.PLURNK_SERVICE_PREVIEW_LINES;
     const rawChars = process.env.PLURNK_SERVICE_PREVIEW_CHARS;
     const lines = Number(rawLines);
@@ -35,6 +35,9 @@ export const previewBounds = () => {
     }
     return { lines, chars };
 };
+// {§packet-attachment-parts} — the attachment kinds and their readout weights live in one table.
+import { imageWeight, pdfWeight } from "./attachments.js";
+export { imageWeight, pdfWeight };
 export default class PacketWire {
     // {§packet-markdown} Render the sections in `slot` to one ChatMessage.content
     // string. Sections render in list order; empties are omitted (no empty headers on the wire);
@@ -47,7 +50,7 @@ export default class PacketWire {
             .filter((p) => p.length > 0)
             .join("\n\n");
     }
-    // One section → its markdown block (`## {header}\n\n{content}`, or bare
+    // One section → its markdown block (`## {header}\n{content}`, or bare
     // content when header is null/empty), trailing newlines stripped. Empty
     // content renders to "" so renderSlot drops it. This is the unit the
     // per-section `weight` is measured over.
@@ -55,16 +58,16 @@ export default class PacketWire {
         if (typeof s.content !== "string" || s.content.length === 0)
             return "";
         const header = typeof s.header === "string" && s.header.length > 0 ? s.header : null;
-        return (header ? `## ${header}\n\n${s.content}` : s.content).replace(/\n+$/, "");
+        return (header ? `## ${header}\n${s.content}` : s.content).replace(/\n+$/, "");
     }
-    // Durable operation failures render as terse pointers to the log rows that
+    // Durable operation failures render as `{status, path}` JSON pointers to the log rows that
     // own their exact RFC 9457 results.
     static renderFailurePointers(failures) {
         const rows = Array.isArray(failures) ? failures : [];
-        return rows
+        const pointers = rows
             .filter((row) => typeof row.status === "number" && typeof row.coordinate === "string")
-            .map((row) => `* ${row.status} log:///${row.coordinate}`)
-            .join("\n");
+            .map((row) => JSON.stringify({ status: row.status, path: `log:///${row.coordinate}` }));
+        return pointers.length === 0 ? "" : `[${pointers.join(",\n")}]`;
     }
     // Non-terminal model-facing observations are deliberately separate from
     // operation failures. Producer messages are normalized and bounded by the
@@ -86,20 +89,25 @@ export default class PacketWire {
         }).join("\n");
     }
     // The Child Streams / Active Child Workers sections ({§child-orientation}) — the OPPOSITE of advice: terse
-    // `* <status> <path>` pointers (same shape as the errors section) to the live things the worker holds,
+    // `{status, path}` JSON pointers (same shape as the errors section) to the live things the worker holds,
     // so the model SEES its open streams + unconcluded workers each turn and reasons for itself (READ /
     // OPEN / KILL via the path). Orienting state, never an instruction. "" when none → section omitted.
     static renderChildPointers(rows) {
         const items = Array.isArray(rows) ? rows : [];
-        return items.map((r) => `* ${String(r.status)} ${String(r.path)}${typeof r.detail === "string" && r.detail.length > 0 ? ` — ${r.detail}` : ""}`).join("\n");
+        const pointers = items.map((r) => JSON.stringify({
+            status: r.status,
+            path: r.path,
+            ...(typeof r.detail === "string" && r.detail.length > 0 ? { detail: r.detail } : {}),
+        }));
+        return pointers.length === 0 ? "" : `[${pointers.join(",\n")}]`;
     }
     // The git section content: the working-tree summary. "" when absent.
     static renderGit(git) {
         const status = git === null || git === undefined ? "" : PacketWire.#renderGitState(git);
         return status;
     }
-    // The log section's content: the model's curated rows as a fenced `jsonplurnk` array ({§jsonplurnk}).
-    // Data only — no prose leads the fence (the log carries rules for no one). Empty log → ""
+    // The log section's content: the model's curated rows as Markdown-framed records ({§log-wire-format}).
+    // Data only — no prose leads the records (the log carries rules for no one). Empty log → ""
     // (the section is omitted).
     static renderLog(entries, weighContent, options = {}) {
         return PacketWire.renderLogWithAccounting(entries, weighContent, options).content;
@@ -109,13 +117,12 @@ export default class PacketWire {
     static renderLogWithAccounting(entries, weighContent, options = {}) {
         const log = Array.isArray(entries) ? entries : [];
         if (log.length === 0)
-            return { content: "", reclaimableBodies: [] };
+            return { content: "", reclaimableBodies: [], attachments: [] };
         const rows = PacketWire.#renderLogEntries(log, weighContent, options);
-        // Every source line is coordinate-prefixed, so source backticks never occupy the
-        // CommonMark closing-fence position. The fixed opener keeps the packet prefix cache-stable.
         return {
-            content: `\`\`\`jsonplurnk\n[\n${rows.map(({ content }) => content).join(",\n")}\n]\n\`\`\``,
+            content: rows.map(({ content }) => content).join("\n\n"),
             reclaimableBodies: rows.flatMap(({ reclaimableBody }) => reclaimableBody === null ? [] : [reclaimableBody]),
+            attachments: rows.flatMap(({ attachment }) => attachment === null ? [] : [attachment]),
         };
     }
     // Read one section's content by name off a packet (Engine's or re-parsed).
@@ -137,7 +144,7 @@ export default class PacketWire {
     }
     // Number a non-READ body line as `<N>:<line>` — `N:` followed by NO separator whitespace
     // ({§render-rule-line-navigable-prefix}): the leading digit prevents column-zero fence collisions and gives
-    // the model line refs for free (`## READ0 (...) <42-46>`), while the absence of any separator means a
+    // the model line refs for free (`### READ0 (...) <42-46>`), while the absence of any separator means a
     // reproduced line has nothing between `N:` and the content to copy — the hard-tab separator used
     // to leak into edit bodies and corrupt indentation. The content's OWN leading whitespace is
     // content, preserved verbatim. `N` is left-padded to the body's line-range width so every body
@@ -197,7 +204,7 @@ export default class PacketWire {
                     ? PacketWire.#numberLines(content, startLine, numericLineNumberWidth)
                     : LineAnchors.render(content, startLine, lineAnchors, lineNumberWidth ?? 0)
             : content;
-        return PacketWire.#quoteBody(rendered);
+        return PacketWire.#frameBody(rendered);
     }
     // Tolerant JSON parser for log entries' persisted rx/tx strings. The engine
     // pre-parses application/json mimetypes; malformed stored text is not JSON.
@@ -209,18 +216,13 @@ export default class PacketWire {
             return null;
         }
     }
-    // Stable JSON: `path` leads (it is the row's identity, {§jsonplurnk}), then
-    // the remaining keys are sorted alphabetically so the same meta produces the
-    // same string across turns — prefix-cache friendly.
+    // Stable JSON metadata: keys are sorted so the same facts produce the same
+    // line across turns — prefix-cache friendly. The preceding H3 owns identity.
     static #canonicalJson(obj) {
         const keys = Object.keys(obj).sort();
         const sorted = {};
-        if (Object.hasOwn(obj, "path"))
-            sorted.path = obj.path;
-        for (const k of keys) {
-            if (k !== "path")
-                sorted[k] = obj[k];
-        }
+        for (const k of keys)
+            sorted[k] = obj[k];
         return JSON.stringify(sorted);
     }
     static #receiptMeta(value) {
@@ -237,6 +239,8 @@ export default class PacketWire {
                 ...head,
                 change: `-${receipt.effect.removed} +${receipt.effect.inserted}`,
                 range: `${receipt.effect.requested} ${receipt.effect.source}->${receipt.effect.result}`,
+                // {§edit-receipt-removed-text} — what a deletion took, so it can be put back from the receipt.
+                ...(receipt.effect.removedText === undefined ? {} : { removed: receipt.effect.removedText }),
             };
         }
         return {
@@ -251,19 +255,17 @@ export default class PacketWire {
                 }),
         };
     }
-    // {§jsonplurnk} One deliberately raw multiline JSON string. The physical
-    // newline after the opening quote and every positive numeric (optionally left-padded) or anchored coordinate prefix
-    // make the closing quote at column zero unambiguous without an invented
-    // delimiter for source text to imitate. Already-numbered producer output is
-    // checked here too: malformed bodies fail at the one projection boundary.
-    static #quoteBody(body) {
+    // {§log-wire-format} Every body line carries its ordinary text coordinate,
+    // which makes an empty Markdown line and an H3 record boundary unavailable
+    // to source content. Already-numbered producer output is checked here too.
+    static #frameBody(body) {
         const endsWithLineBreak = /(?:\r\n|\r|\n)$/.test(body);
         const lines = body.split(/\r\n|\r|\n/);
         const contentLines = endsWithLineBreak ? lines.slice(0, -1) : lines;
         if (contentLines.length === 0 || contentLines.some((line) => !/^ *[1-9]\d*:/.test(line) && !LineAnchors.isAnchoredLine(line))) {
-            throw new TypeError("A raw jsonplurnk body requires a positive coordinate prefix on every physical line.");
+            throw new TypeError("A packet log body requires a positive coordinate prefix on every physical line.");
         }
-        return `"\n${body}${endsWithLineBreak ? "" : "\n"}"`;
+        return endsWithLineBreak ? body.replace(/(?:\r\n|\r|\n)$/, "") : body;
     }
     // Render one Log entry → a single bullet line carrying the meta JSON.
     // No body, no fence — every meaningful field is in the JSON. Naming
@@ -279,10 +281,10 @@ export default class PacketWire {
     // LogBody owns tx/rx storage interpretation; packet projection owns only
     // visibility, previewing, mimetype rendering, and metadata.
     // The log:/// handle the model sees for an entry.
-    // ({§open-fold}).
+    // ({§log-kill-scope}).
     static #entryPath(coordinate, leaf) {
         if (coordinate === null)
-            return null;
+            throw new TypeError("A packet log row requires an addressable coordinate.");
         return `log:///${coordinate}/${leaf}`;
     }
     static #offsetAfterCharacters(text, count) {
@@ -521,8 +523,6 @@ export default class PacketWire {
             const op = typeof e.op === "string" && e.op.length > 0 ? e.op : null;
             const renderedLeaf = LogEntryProjection.leaf(e);
             const path = PacketWire.#entryPath(coordinate, renderedLeaf);
-            if (path !== null)
-                meta.path = path;
             // Absence = "model" — the worker's own authorship is the default,
             // exactly as `source` absence means the owning worker (#338).
             if (typeof e.origin === "string" && e.origin !== "model")
@@ -540,23 +540,11 @@ export default class PacketWire {
             }
             // Absence = 200 on an ordinary row — the clients' quiet grammar
             // (plurnk#21) applied to the packet. SEND keeps its disposition,
-            // KILL keeps decisive destructive completion, a dissolving OPEN/FOLD
+            // KILL keeps decisive destructive completion, a dissolving log-KILL
             // receipt exists only to show its status ({§curation-receipt-dissolves}),
             // and every non-200 stays explicit (#338).
-            if (typeof e.status === "number" && (op === "SEND" || op === "KILL" || op === "FOLD" || op === "OPEN" || e.status !== 200))
+            if (typeof e.status === "number" && (op === "SEND" || op === "KILL" || e.status !== 200))
                 meta.status = e.status;
-            if (e.tags !== undefined) {
-                const storedTags = e.tags;
-                if (!Array.isArray(storedTags) || !storedTags.every((tag) => typeof tag === "string" && tag.length > 0)) {
-                    throw new TypeError("A log row carries malformed folksonomic tags.");
-                }
-                const tags = [...new Set(storedTags)].toSorted();
-                if (tags.length !== storedTags.length || tags.some((tag, index) => tag !== storedTags[index])) {
-                    throw new TypeError("A log row's folksonomic tags must be unique and sorted.");
-                }
-                if (tags.length > 0)
-                    meta.tags = tags;
-            }
             const tx = (typeof e.tx === "string" ? PacketWire.#safeParse(e.tx) : e.tx);
             if (typeof tx?.annotation === "string")
                 meta.annotation = tx.annotation;
@@ -756,9 +744,6 @@ export default class PacketWire {
                 : previewExempt
                     ? { text: projectedBody.content, cut: false, chunk: null }
                     : PacketWire.#preview(projectedBody.content);
-            if (projection.cut && path === null) {
-                throw new Error("a previewed log body requires an addressable log path");
-            }
             const projectedLineCount = TextCoordinates.logicalLines(projection.text).length;
             const projectedOrdinals = sourceOrdinals.slice(0, projectedLineCount);
             const body = emptyFind || projection.text.length === 0
@@ -781,10 +766,9 @@ export default class PacketWire {
             if (bodyVisibility.folded.length > 0 && !bodyVisibility.fullyFolded) {
                 meta.folded = LogVisibility.format(bodyVisibility.folded);
             }
-            // {§jsonplurnk} — the three body states stay self-describing through
-            // field presence alone (#338): a `body` field ⇒ open, `tokensBody`
-            // without `body` ⇒ folded, neither ⇒ none. OPEN/FOLD remain
-            // friendly no-ops on `none`.
+            // {§log-wire-format} — the three body states stay self-describing:
+            // coordinate lines ⇒ open, `tokensBody` without lines ⇒ folded,
+            // neither ⇒ none. OPEN/FOLD remain friendly no-ops on `none`.
             const display = fullBody.content.length === 0
                 ? "none"
                 : bodyVisibility.fullyFolded
@@ -797,37 +781,81 @@ export default class PacketWire {
                 && !bodyVisibility.fullyFolded
                 ? PacketWire.#sparseChunk(fullBody.content, projectedBody.content, sourceOrdinals, projection.text)
                 : projection.chunk;
-            const chunk = projectedChunk !== null
-                ? `,"chunk":${JSON.stringify(projectedChunk)}`
-                : "";
+            if (display === "open" && projectedChunk !== null)
+                meta.chunk = projectedChunk;
             const renderRow = () => {
-                const obj = PacketWire.#canonicalJson(meta);
+                const metadata = PacketWire.#canonicalJson(meta);
                 return display === "open"
-                    ? obj.replace(/\}$/, `,"body":${body}${chunk}}`)
-                    : obj;
+                    ? `### ${path}\n${metadata}\n${body}`
+                    : `### ${path}\n${metadata}`;
             };
             // The accounting field participates in the row it measures. Iterate
             // until its decimal width and therefore the rendered row's curation
             // weight are stable. The metadata share is derivable (tokensActive −
             // tokensBody when open; tokensActive otherwise) and feeds no
             // curation decision, so it is not serialized (#338).
+            // {§packet-attachment-parts} — an open READ of an attachable member carries it as a native
+            // part on a route that can take it; the row weighs the attachment whether or not the route can.
+            const attachment = display === "open" && op === "READ" ? PacketWire.#attachmentOf(e.rx, e.target) : null;
+            if (attachment !== null)
+                meta.tokensAttachment = attachment.weight;
             meta.tokensActive = 0;
             for (let pass = 0; pass < 8; pass += 1) {
-                const tokensActive = weighContent(renderRow());
+                const tokensActive = weighContent(renderRow()) + (attachment?.weight ?? 0);
                 if (meta.tokensActive === tokensActive) {
                     const tokensBody = typeof meta.tokensBody === "number" ? meta.tokensBody : 0;
                     return {
                         content: renderRow(),
-                        reclaimableBody: display === "open" && path !== null && tokensBody > 0
+                        reclaimableBody: display === "open" && tokensBody > 0
                             ? { path, tokensBody, tokensActive }
                             : null,
+                        attachment,
                     };
                 }
                 meta.tokensActive = tokensActive;
             }
-            throw new Error("jsonplurnk row accounting did not converge");
+            throw new Error("packet log row accounting did not converge");
         });
     }
+    static #attachmentOf(rx, target) {
+        const view = rx;
+        const pathname = typeof target?.pathname === "string" && target.pathname.length > 0
+            ? target.pathname
+            : typeof target?.raw === "string" ? target.raw : null;
+        if (pathname === null)
+            return null;
+        const scheme = target?.scheme ?? "file";
+        const image = view?.image;
+        if (image !== undefined && typeof image.mimetype === "string" && Number.isSafeInteger(image.width) && Number.isSafeInteger(image.height)) {
+            const width = image.width;
+            const height = image.height;
+            return { scheme, pathname, mimetype: image.mimetype, kind: "image", width, height, weight: imageWeight(width, height) };
+        }
+        const document = view?.document;
+        if (document !== undefined && typeof document.mimetype === "string" && Number.isSafeInteger(document.pages)) {
+            const pages = document.pages;
+            return { scheme, pathname, mimetype: document.mimetype, kind: "pdf", pages, weight: pdfWeight(pages) };
+        }
+        return null;
+    }
+    // {§packet-attachment-parts} — the wire form with native parts: the user slot's text first, then
+    // one part per attachment of a kind the route accepts whose bytes the scheme still supplies; a
+    // picture rides as an image part, a document as a file part.
+    static async wireMessages(packet, bytesOf, accepts = () => true) {
+        const [system, user] = PacketWire.packetToWireMessages(packet);
+        const parts = [{ type: "text", text: user.content }];
+        for (const attachment of packet.attachments ?? []) {
+            if (!accepts(attachment.kind))
+                continue;
+            const bytes = await bytesOf(attachment);
+            if (bytes === null)
+                continue;
+            parts.push(attachment.kind === "image"
+                ? { type: "image", image: bytes, mediaType: attachment.mimetype }
+                : { type: "file", data: bytes, mediaType: attachment.mimetype });
+        }
+        return parts.length === 1 ? [system, user] : [system, { role: "user", content: parts }];
+    }
     static #projectRelativeCwd(cwd, projectRoot) {
         if (projectRoot === null || cwd === projectRoot)
             return null;