@plurnk/plurnk-contracts 1.7.0 → 1.9.0

package/dist/src/ApplicationPort.d.ts

@@ -0,0 +1,271 @@
+import type { ClientDisplayCapabilities, ClientInteractionProjection, ClientInteractionResolution, EntryReadResult, JsonSchema, LoopFlags, ModelCatalogPage, ModelCatalogQuery, ModelRoute, OperationResult, PlurnkStatement, ProposalProjection, ReasoningPolicy } from "./types.ts";
+export type ProposalDecision = "accept" | "reject" | "cancel";
+export interface ProposalResolution {
+    readonly decision: ProposalDecision;
+    readonly body?: string;
+    readonly outcome?: string;
+}
+export type ApplicationActionContext = {
+    readonly scope: "worldless";
+} | {
+    readonly scope: "workspace";
+    readonly workspaceId: number;
+} | {
+    readonly scope: "worker";
+    readonly workspaceId: number;
+    readonly workerId: number;
+};
+export interface ApplicationActionDescriptor {
+    readonly name: string;
+    readonly scope: ApplicationActionContext["scope"];
+    readonly inputSchema: JsonSchema;
+    readonly outputSchema: JsonSchema;
+}
+export interface ClientEnvelope {
+    readonly workspaceId: number;
+    readonly workspaceName: string;
+    readonly projectRoot: string | null;
+    readonly workerId: number;
+    readonly workerName: string;
+}
+export type ApplicationWorkerOrigin = "model" | "client" | "_plurnk";
+export interface ApplicationWorkerProjection {
+    readonly id: number;
+    readonly name: string;
+    readonly created_at: string;
+    readonly origin: ApplicationWorkerOrigin;
+    readonly parentWorkerId: number | null;
+}
+export interface ApplicationWorkerQuery {
+    readonly origin?: ApplicationWorkerOrigin;
+    /** Omitted means every lineage position; null means roots only. */
+    readonly parentWorkerId?: number | null;
+}
+export type ApplicationWorkerIdentity = {
+    readonly id: number;
+    readonly name?: never;
+} | {
+    readonly id?: never;
+    readonly name: string;
+};
+export interface ApplicationLoopProjection {
+    readonly id: number;
+    readonly workerId: number;
+    readonly sequence: number;
+    readonly status: number;
+    readonly prompt: string;
+    readonly promptSource: string | null;
+    readonly terminatedAt: string | null;
+    readonly terminalResult: OperationResult | null;
+}
+export type LogEntryWire = Readonly<Record<string, unknown>>;
+export type ApplicationEventHandler = (workspaceId: number | null, method: string, params: unknown) => void;
+/** The transport-neutral application contract consumed by exterior adapters. */
+export interface ApplicationPort {
+    listClientDisplayCapabilities(): Promise<ClientDisplayCapabilities>;
+    listModuleActions(): ApplicationActionDescriptor[];
+    invokeModuleAction(name: string, params: Readonly<Record<string, unknown>>, context: ApplicationActionContext): Promise<unknown>;
+    subscribeToEvents(handler: ApplicationEventHandler): () => void;
+    pendingProposals(workspaceId: number): Promise<ProposalProjection[]>;
+    resolveProposal(logEntryId: number, resolution: ProposalResolution): void;
+    pendingClientInteractions(workspaceId: number): Promise<ClientInteractionProjection[]>;
+    resolveClientInteraction(interactionId: number, resolution: ClientInteractionResolution): Promise<void>;
+    ensureModelWorker(workspaceId: number, settings?: {
+        readonly requestUserInput?: boolean;
+    }): Promise<number>;
+    runLoop(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+        readonly prompt: string;
+        readonly source?: string;
+        readonly maxTurns?: number;
+        readonly flags?: Partial<LoopFlags>;
+        readonly openPaths?: string[];
+        readonly selector?: string;
+        readonly childSelector?: string | null;
+    }): Promise<OperationResult & {
+        readonly action: "injected_next_turn" | "enqueued_new_loop";
+        readonly loopId: number;
+        readonly turnSeq?: number;
+    }>;
+    cancelDrain(workerId: number, reason?: string): boolean;
+    cancelWorker(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+        readonly reason?: string;
+    }): Promise<void>;
+    dispatchClientAction(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+        readonly functionalityWorkerId: number;
+        readonly statements: PlurnkStatement[];
+    }): Promise<OperationResult[]>;
+    readLog(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+        readonly loopId?: number;
+        readonly turnId?: number;
+        readonly sinceId?: number;
+        readonly limit?: number;
+        readonly loopSeq?: number;
+        readonly turnSeq?: number;
+        readonly sequence?: number;
+    }): Promise<LogEntryWire[]>;
+    listProviders(): {
+        readonly aliases: Array<{
+            readonly alias: string;
+            readonly provider: string;
+            readonly model: string;
+            readonly active: boolean;
+            readonly inputCapacity: number | null;
+        }>;
+    };
+    listModels(query: ModelCatalogQuery): ModelCatalogPage;
+    createWorkspace(args: {
+        readonly name?: string;
+        readonly projectRoot?: string | null;
+        readonly settings?: string | object;
+        readonly constraints?: Array<{
+            readonly effect: string;
+            readonly glob: string;
+        }>;
+    }): Promise<ClientEnvelope>;
+    attachWorkspace(args: {
+        readonly workspaceId: number;
+        readonly workerId?: number;
+        readonly workerName?: string;
+    }): Promise<ClientEnvelope>;
+    listWorkspaces(): Promise<Array<{
+        readonly id: number;
+        readonly name: string;
+        readonly project_root: string | null;
+        readonly created_at: string;
+    }>>;
+    listWorkers(workspaceId: number, query?: ApplicationWorkerQuery): Promise<ApplicationWorkerProjection[]>;
+    readWorker(args: {
+        readonly workspaceId: number;
+        readonly identity: ApplicationWorkerIdentity;
+    }): Promise<ApplicationWorkerProjection | null>;
+    listWorkerLoops(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+    }): Promise<ApplicationLoopProjection[]>;
+    listPrompts(workspaceId: number, limit?: number): Promise<string[]>;
+    renameWorkspace(workspaceId: number, name: string): Promise<{
+        readonly id: number;
+        readonly name: string;
+    }>;
+    constrain(workspaceId: number, effect: string, glob: string): Promise<{
+        readonly effect: string;
+        readonly glob: string;
+        readonly source: "explicit";
+    }>;
+    unconstrain(workspaceId: number, effect: string, glob: string): Promise<{
+        readonly effect: string;
+        readonly glob: string;
+    }>;
+    listConstraints(workspaceId: number): Promise<Array<{
+        readonly effect: string;
+        readonly glob: string;
+        readonly source: "explicit" | "create";
+    }>> | Array<{
+        readonly effect: string;
+        readonly glob: string;
+        readonly source: "explicit" | "create";
+    }>;
+    workspaceDerivationStatus(workspaceId: number): {
+        readonly phase: "preparing" | "indexing" | "complete" | "failed";
+        readonly completed: number;
+        readonly total: number;
+        readonly percent: number;
+        readonly message: string;
+        readonly level: "info" | "error";
+    } | null;
+    listMembers(workspaceId: number): Promise<{
+        readonly members: Array<{
+            readonly path: string;
+            readonly effect: string;
+        }>;
+        readonly hidden: string[];
+    }>;
+    look(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+        readonly functionalityWorkerId: number;
+        readonly statement: PlurnkStatement;
+    }): Promise<OperationResult>;
+    readEntry(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+        readonly target: string;
+        readonly channel?: string;
+        readonly offset?: number;
+    }): Promise<EntryReadResult>;
+    forkWorker(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+        readonly name?: string;
+    }): Promise<{
+        readonly workerId: number;
+        readonly workerName: string | null;
+        readonly parentWorkerId: number;
+    }>;
+    createConversationWorker(args: {
+        readonly workspaceId: number;
+        readonly name?: string;
+        readonly settings?: {
+            readonly requestUserInput?: boolean;
+        };
+    }): Promise<{
+        readonly workerId: number;
+        readonly workerName: string;
+    }>;
+    readWorkerModel(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+    }): Promise<{
+        readonly model: ModelRoute | null;
+        readonly spawnModel: ModelRoute | null;
+    }>;
+    setWorkerModel(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+        readonly selector: string;
+    }): Promise<ModelRoute>;
+    setWorkerSpawnModel(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+        readonly selector: string | null;
+    }): Promise<ModelRoute | null>;
+    readWorkerReasoning(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+    }): Promise<{
+        readonly policy: ReasoningPolicy | null;
+        readonly supportedPolicies: readonly ReasoningPolicy[];
+    }>;
+    setWorkerReasoning(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+        readonly policy: unknown;
+    }): Promise<{
+        readonly policy: ReasoningPolicy;
+        readonly supportedPolicies: readonly ReasoningPolicy[];
+    }>;
+    readWorkerSettings(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+    }): Promise<{
+        readonly requestUserInput: boolean;
+    }>;
+    setWorkerSettings(args: {
+        readonly workspaceId: number;
+        readonly workerId: number;
+        readonly settings: {
+            readonly requestUserInput?: boolean;
+        };
+    }): Promise<{
+        readonly requestUserInput: boolean;
+    }>;
+}
+//# sourceMappingURL=ApplicationPort.d.ts.map

package/dist/src/ApplicationPort.d.ts.map

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

package/dist/src/ApplicationPort.js

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

package/dist/src/ApplicationPort.js.map

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

package/dist/src/AstBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AstBuilder.d.ts","sourceRoot":"","sources":["../../src/AstBuilder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAIR,eAAe,EAaf,iBAAiB,EACjB,UAAU,EAGV,eAAe,EACf,QAAQ,EAOX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAGR,sBAAsB,EAgBtB,gBAAgB,EAChB,mBAAmB,EAGtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAIH,oBAAoB,EACpB,oBAAoB,EAIvB,MAAM,6BAA6B,CAAC;AAOrC,OAAO,QAAQ,OAAO,CAAC;IACnB,SAAgB,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;CACtD;AAUD,MAAM,CAAC,OAAO,OAAO,UAAU;;IAc3B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,oBAAoB,GAAG,eAAe,CA6BvH;IAoBD,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,sBAAsB,GAAG,eAAe,CAK/D;IAkbD;;;;OAIG;IACH,MAAM,CAAC,sBAAsB,CACzB,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,QAAiC,GACvC,iBAAiB,GAAG,IAAI,CA6B1B;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,QAAiC,GAAG,UAAU,GAAG,IAAI,CAoCvF;CA2HJ"}
+{"version":3,"file":"AstBuilder.d.ts","sourceRoot":"","sources":["../../src/AstBuilder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAIR,eAAe,EAaf,iBAAiB,EACjB,UAAU,EAGV,eAAe,EACf,QAAQ,EAOX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAGR,sBAAsB,EAetB,gBAAgB,EAChB,mBAAmB,EAGtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAIH,oBAAoB,EACpB,oBAAoB,EAIvB,MAAM,6BAA6B,CAAC;AAQrC,OAAO,QAAQ,OAAO,CAAC;IACnB,SAAgB,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;CACtD;AAUD,MAAM,CAAC,OAAO,OAAO,UAAU;;IAc3B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,oBAAoB,GAAG,eAAe,CA6BvH;IAqBD,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,sBAAsB,GAAG,eAAe,CAK/D;IAucD;;;;OAIG;IACH,MAAM,CAAC,sBAAsB,CACzB,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,QAAiC,GACvC,iBAAiB,GAAG,IAAI,CA6B1B;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,QAAiC,GAAG,UAAU,GAAG,IAAI,CAoCvF;CA2HJ"}

package/dist/src/AstBuilder.js

@@ -7,6 +7,7 @@ import { BodyContext, IdentSignalContext, LineMarkerContext, PlanStatementContex
 import { plurnkLexer } from "./generated/plurnkLexer.js";
 import PlurnkParseError from "./PlurnkParseError.js";
 import PathSyntax from "./PathSyntax.js";
+import PlanValue from "./PlanValue.js";
 import TagSignal, { InvalidTagSignalError } from "./TagSignal.js";
 export default class AstBuilder {
     static #SCHEME_PATTERN = /^[a-z][a-z0-9+.-]*:\/\//i;
@@ -86,7 +87,8 @@ export default class AstBuilder {
         const raw = AstBuilder.#bodyTextOf(ctx);
         return {
             op: "FIND",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_FIND().getText(), "FIND"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_FIND().getText(), "FIND"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             body: raw !== null ? AstBuilder.#parseMatcherBody(raw, position) : null,
             position,
@@ -116,7 +118,8 @@ export default class AstBuilder {
         const raw = AstBuilder.#bodyTextOf(ctx);
         return {
             op: "LOOK",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_LOOK().getText(), "LOOK"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_LOOK().getText(), "LOOK"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             body: raw !== null ? AstBuilder.#parseMatcherBody(raw, position) : null,
             position,
@@ -128,7 +131,8 @@ export default class AstBuilder {
         const raw = AstBuilder.#bodyTextOf(ctx);
         return {
             op: "BUFF",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_BUFF().getText(), "BUFF"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_BUFF().getText(), "BUFF"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             body: raw !== null ? AstBuilder.#parseMatcherBody(raw, position) : null,
             position,
@@ -150,7 +154,8 @@ export default class AstBuilder {
             const findSlots = slots;
             return {
                 op: "FIND",
-                suffix: AstBuilder.#splitSuffix(ctx.OPEN_READ().getText(), "READ"),
+                delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_READ().getText(), "READ"),
+                annotation: AstBuilder.#annotationOf(ctx),
                 ...findSlots,
                 body: hasMatcher ? AstBuilder.#parseMatcherBody(raw, position) : null,
                 position,
@@ -158,7 +163,8 @@ export default class AstBuilder {
         }
         return {
             op: "READ",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_READ().getText(), "READ"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_READ().getText(), "READ"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             body: null,
             position,
@@ -166,7 +172,7 @@ export default class AstBuilder {
     }
     static #buildOpen(ctx) {
         const position = AstBuilder.#positionOf(ctx);
-        const slots = AstBuilder.#extractCurationSlots(ctx.curationModifiers(), position);
+        const slots = AstBuilder.#extractCurationSlots(ctx.tagOpModifiers(), position);
         const raw = AstBuilder.#bodyTextOf(ctx);
         const tags = AstBuilder.#curationTags(slots.signal, position);
         if (slots.target === null && raw === null && tags.filter.length === 0 && (tags.add.length > 0 || tags.remove.length > 0)) {
@@ -174,7 +180,8 @@ export default class AstBuilder {
         }
         return {
             op: "OPEN",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_OPEN().getText(), "OPEN"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_OPEN().getText(), "OPEN"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             body: raw !== null ? AstBuilder.#parseMatcherBody(raw, position) : null,
             position,
@@ -182,7 +189,7 @@ export default class AstBuilder {
     }
     static #buildFold(ctx) {
         const position = AstBuilder.#positionOf(ctx);
-        const slots = AstBuilder.#extractCurationSlots(ctx.curationModifiers(), position);
+        const slots = AstBuilder.#extractCurationSlots(ctx.tagOpModifiers(), position);
         const raw = AstBuilder.#bodyTextOf(ctx);
         const tags = AstBuilder.#curationTags(slots.signal, position);
         if (slots.target === null && raw === null && tags.filter.length === 0 && (tags.add.length > 0 || tags.remove.length > 0)) {
@@ -190,7 +197,8 @@ export default class AstBuilder {
         }
         return {
             op: "FOLD",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_FOLD().getText(), "FOLD"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_FOLD().getText(), "FOLD"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             body: raw !== null ? AstBuilder.#parseMatcherBody(raw, position) : null,
             position,
@@ -202,7 +210,8 @@ export default class AstBuilder {
         AstBuilder.#assertAppliedTags(slots.signal, position);
         return {
             op: "EDIT",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_EDIT().getText(), "EDIT"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_EDIT().getText(), "EDIT"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             body: AstBuilder.#bodyTextOf(ctx),
             position,
@@ -215,7 +224,8 @@ export default class AstBuilder {
         const raw = AstBuilder.#bodyTextOf(ctx);
         return {
             op: "COPY",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_COPY().getText(), "COPY"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_COPY().getText(), "COPY"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             body: raw === null ? null : AstBuilder.parseResourceSelection(raw, position),
             position,
@@ -228,7 +238,8 @@ export default class AstBuilder {
         const raw = AstBuilder.#bodyTextOf(ctx);
         return {
             op: "MOVE",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_MOVE().getText(), "MOVE"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_MOVE().getText(), "MOVE"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             body: raw !== null ? AstBuilder.parseResourceSelection(raw, position) : null,
             position,
@@ -240,7 +251,8 @@ export default class AstBuilder {
         const raw = AstBuilder.#bodyTextOf(ctx);
         return {
             op: "SEND",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_SEND().getText(), "SEND"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_SEND().getText(), "SEND"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             // Preserve a terminal wait scope; the dispatcher owns which disposition
             // accepts it. Only the terminal rule carries a marker (midSend → null).
@@ -254,7 +266,8 @@ export default class AstBuilder {
         const slots = AstBuilder.#extractExecSlots(ctx.execModifiers(), position);
         return {
             op: "EXEC",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_EXEC().getText(), "EXEC"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_EXEC().getText(), "EXEC"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             body: AstBuilder.#bodyTextOf(ctx),
             position,
@@ -266,7 +279,8 @@ export default class AstBuilder {
         AstBuilder.#assertAppliedTags(signal, position);
         return {
             op: "BARE",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_BARE().getText(), "BARE"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_BARE().getText(), "BARE"),
+            annotation: AstBuilder.#annotationOf(ctx),
             signal,
             target: null,
             lineMarker: null,
@@ -279,9 +293,10 @@ export default class AstBuilder {
         const slots = AstBuilder.#extractTagSlots(ctx.tagOpModifiers(), position);
         return {
             op: "PLAN",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_PLAN().getText(), "PLAN"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_PLAN().getText(), "PLAN"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
-            body: AstBuilder.#bodyTextOf(ctx),
+            body: PlanValue.admit(AstBuilder.#requiredBodyTextOf(ctx)),
             position,
         };
     }
@@ -290,7 +305,8 @@ export default class AstBuilder {
         const slots = AstBuilder.#extractIntSlots(ctx, position);
         return {
             op: "KILL",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_KILL().getText(), "KILL"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_KILL().getText(), "KILL"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             lineMarker: null,
             body: AstBuilder.#bodyTextOf(ctx),
@@ -302,7 +318,8 @@ export default class AstBuilder {
         const slots = AstBuilder.#extractBranchSlots(ctx.branchModifiers(), position);
         return {
             op: "WORK",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_WORK().getText(), "WORK"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_WORK().getText(), "WORK"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             lineMarker: null,
             body: AstBuilder.#requiredBodyTextOf(ctx),
@@ -314,7 +331,8 @@ export default class AstBuilder {
         const slots = AstBuilder.#extractBranchSlots(ctx.branchModifiers(), position);
         return {
             op: "FORK",
-            suffix: AstBuilder.#splitSuffix(ctx.OPEN_FORK().getText(), "FORK"),
+            delimiter: AstBuilder.#splitDelimiter(ctx.OPEN_FORK().getText(), "FORK"),
+            annotation: AstBuilder.#annotationOf(ctx),
             ...slots,
             lineMarker: null,
             body: AstBuilder.#requiredBodyTextOf(ctx),
@@ -346,7 +364,7 @@ export default class AstBuilder {
         return {
             signal: AstBuilder.#tagsFromSignal(AstBuilder.#findFirst(modCtx, TagSignalContext)),
             target: AstBuilder.#targetFromCtx(AstBuilder.#findFirst(modCtx, TargetContext), pos),
-            lineMarker: null,
+            lineMarker: AstBuilder.#textLineMarkerFromCtx(AstBuilder.#findFirst(modCtx, LineMarkerContext)),
         };
     }
     // A SEND/KILL signal is one signed-integer literal, tokenized as INT (mid-comms SEND, KILL)
@@ -456,13 +474,17 @@ export default class AstBuilder {
         const start = ctx.start;
         return { line: start?.line ?? 0, column: start?.column ?? 0 };
     }
+    static #annotationOf(ctx) {
+        const token = AstBuilder.#findToken(ctx, plurnkLexer.ANNOTATION);
+        return token === null ? null : token.slice("<!--".length, -"-->".length).trim();
+    }
     static #bodyTextOf(ctx) {
         return AstBuilder.#findFirst(ctx, BodyContext)?.getText() ?? null;
     }
     static #requiredBodyTextOf(ctx) {
         return AstBuilder.#bodyTextOf(ctx) ?? "";
     }
-    static #splitSuffix(headingText, op) {
+    static #splitDelimiter(headingText, op) {
         const marker = op === "PLAN" ? "# " : "## ";
         return headingText.slice(marker.length + op.length);
     }