@plurnk/plurnk-agui 1.3.11 → 1.4.0

package/.env.defaults

@@ -4,15 +4,17 @@
 # The listener's ADDRESS is the daemon's surface (PLURNK_HOST/PLURNK_PORT — owned
 # by plurnk-service); the module owns the semantics on that surface.
 
-# Bearer for the module's edge authz. Empty = local trust (the loopback bind is
-# the boundary); set a value and every request must carry `authorization: Bearer <it>`.
+# Bearer for the module's edge authz. Empty = no module-level bearer requirement;
+# set a value and every non-preflight request must carry
+# `authorization: Bearer <it>` ({§agui-http-authorization}).
 PLURNK_AGUI_TOKEN=
 
 # Per-run turn cap handed to the engine when a run doesn't carry its own maxTurns.
-# Empty = no module-level cap (the engine's own ceiling still applies).
+# Empty = no module-level default; otherwise -1 or a non-negative safe integer
+# (the engine's own operator ceiling still applies).
 PLURNK_AGUI_MAX_TURNS=
 
-# SSE heartbeat cadence in milliseconds (agui#3). A long model generation emits no
-# events, and consumer stacks kill silent bodies (undici defaults to 300s); a
-# comment frame every cadence keeps every consumer fed. 0 disables.
+# Required SSE heartbeat cadence in milliseconds, from 0 through 2147483647.
+# A long model generation emits no events, so a comment frame at this cadence keeps
+# consumers fed. 0 disables.
 PLURNK_AGUI_HEARTBEAT_MS=15000

package/README.md

@@ -7,7 +7,7 @@ interface and translates daemon lifecycle events into AG-UI events.
 
 `POST /` accepts `RunAgentInput` and returns an AG-UI event stream.
 
-PLURNK uses standard AG-UI events for runs, messages, steps, tool calls, state,
+PLURNK uses standard AG-UI events for Runs, messages, steps, tool calls, state,
 and approval requests. Additional execution metadata uses namespaced
 `plurnk.*` custom events so generic AG-UI clients can ignore it safely.
 
@@ -27,9 +27,17 @@ daemon.registerModule(Module.init({
 }));
 ```
 
+The service supplies this package's `.env.defaults` through the assembled
+environment before module startup. A direct in-process consumer must provide
+that environment or an explicit `heartbeatMs`; explicit `token`, `maxTurns`,
+and `heartbeatMs` options override their corresponding environment values.
+`SPEC.md` owns the exact value contract.
+
 The module owns transport authentication, request validation, event translation,
-and proposal delivery. Core owns persistence and model-loop policy; clients own
-rendering and local terminal/editor behavior.
+and proposal delivery. It consumes core's disposition-bearing proposal projection
+for both live events and reconnect rather than rebuilding policy from loop flags.
+Core owns persistence and model-loop policy; clients own rendering and local
+terminal/editor behavior.
 
 ## Development
 

package/SPEC.md

@@ -7,78 +7,107 @@ recompute them.
 
 ## Architecture
 
-- **The module is an in-process plugin of the daemon** {§agui-daemon-client} — activated
+- §agui-daemon-client **The module is an in-process plugin of the daemon** — activated
   at boot (`registerModule` → the core seam handle); it opens the AG-UI+ listener and owns
   the client interface. No WebSocket, no separate process.
-- **A plurnk SESSION is the world; an AG-UI THREAD is a conversation over it** {§agui-thread-is-run}
-  — plurnk's machine model (service SPEC §machine-processes) splits the WORLD (a workspace: one
+- §agui-thread-binding **A PLURNK workspace is the world; an AG-UI thread is a conversation over it**
+  — the lifecycle vocabulary is defined by service {§lifecycle-terms}. PLURNK's machine model ({§machine-processes}) splits the world (a workspace: one
   curated workspace) from the CONVERSATION (a worker: a history over that world). AG-UI's workspace
   concept is the workspace, selected by name, VERBATIM, via `forwardedProps.plurnk.workspace`
   (attach if it exists, create with exactly that name otherwise — no prefix, no forging). The
   workspace is REQUIRED: a worker has no existence without a world, so its absence is a contract
-  violation the module rejects (500) — never a workspace forged from the `threadId`. The
+  violation the module rejects (400) - never a workspace forged from the `threadId`. The
   `threadId` is the conversation over that world, and the name is the identity at
-  BOTH levels: `threadId` == the workspace name binds the workspace's MODEL run (the default
-  conversation, `ensureModelWorker` — origin identifies it, never a name parse); a DISTINCT
+  BOTH levels: `threadId` == the workspace name binds the workspace's model worker (the default
+  conversation, `ensureModelWorker` — its durable default-conversation role identifies it,
+  never a name parse or root ordering); a DISTINCT
   `threadId` names its own conversation worker — found by name if it exists (forks and prior
-  conversations are addressable as threads), minted via `createConversationWorker` (svc#366)
-  if it doesn't. World-scoped actions (`loop.inject`, `loop.cancel`, `log.read` default,
-  `run.fork`) operate on the THREAD's conversation, never blindly on the model worker.
-  Extended context persists across AG-UI runs because the worker's log does.
-- **AG-UI owns the client lifecycle** {§agui-run-authority} — `threadId`, `runId`,
+  conversations are addressable as threads), minted via `createConversationWorker`
+  if it doesn't. The core workspace envelope carries only the workspace and selected client
+  actor ({§methods-rebind}); AG-UI owns the separate per-thread conversation binding.
+  World-scoped actions (`loop.inject`, `loop.cancel`, `log.read` default,
+  `entry.read`, `run.fork`) operate on the THREAD's conversation, never blindly on the model worker.
+  Extended context persists across AG-UI Runs because the worker's log does.
+- §agui-run-authority **AG-UI owns the client lifecycle** — `threadId`, `runId`,
   `RUN_STARTED`, `RUN_FINISHED`, `RUN_ERROR`, interrupt outcomes, and `RunAgentInput.resume`
   follow the official `@ag-ui/core` schemas. PLURNK does not maintain a parallel client
   lifecycle dialect. PLURNK owns the internal worker/loop/turn topology and projects it
   through standard events plus namespaced `plurnk.*` extensions.
 
-## The projection {§agui-projection}
-
-One daemon notification in, zero-or-more AG-UI events out (`Translator`, pure):
-
-| plurnk wire | AG-UI events |
-|---|---|
-| `loop.run` accepted | `RUN_STARTED` |
-| `log/entry` turn boundary | `STEP_FINISHED` + `STEP_STARTED` (`turn-<id>`) |
-| `log/entry` op=PLAN (model) | `REASONING_START` + `REASONING_MESSAGE_START/CONTENT/END` + `REASONING_END` (§475: current AG-UI reasoning; the deprecated THINKING_* is retired) |
-| `log/entry` op=SEND (model) | `TEXT_MESSAGE_START/CONTENT/END` + `CUSTOM plurnk.send` (signal/status) |
-| `log/entry` other op (model) | `TOOL_CALL_START/ARGS/END` (+ `TOOL_CALL_RESULT` when rx exists) |
-| `log/entry` op=model (mirror) | a correlated `REASONING_START` / `REASONING_ENCRYPTED_VALUE`* / `REASONING_END` span when the reasoning-item `attrs.reasoning` is present (see §agui-sealed-reasoning); otherwise nothing — forensic |
-| `log/entry` origin≠model | `CUSTOM plurnk.ambient` (foists, deltas, narrations) |
-| `loop/proposal` | `TOOL_CALL_START/ARGS/END`, then `RUN_FINISHED` with an interrupt outcome |
-| `loop/terminated` | `STATE_DELTA` (budget) + `CUSTOM plurnk.terminated` + `RAW` (the provider's native completion frame, `source: provider`, §475) + `RUN_FINISHED` (200) or `RUN_ERROR` (else) |
-| `telemetry/event` | `CUSTOM plurnk.telemetry` |
-| `stream/event` + `stream/concluded` | `CUSTOM plurnk.stream` + `ACTIVITY_SNAPSHOT` (the standard background-activity channel: `activityType` = the scheme, replace-snapshot, §475) |
-| `loop/quiesced` | `CUSTOM plurnk.quiesced` |
+## §agui-projection The projection
+
+One accepted Run or daemon notification produces zero-or-more AG-UI events:
+
+| plurnk wire                                | AG-UI events |
+| ------------------------------------------ | ------------ |
+| schema-valid `RunAgentInput`               | `RUN_STARTED` + initial `STATE_SNAPSHOT` |
+| `log/entry` turn boundary                  | `STEP_FINISHED` + `STEP_STARTED` (`turn-<id>`) |
+| `log/entry` op=PLAN (model)                | `ACTIVITY_SNAPSHOT` {§agui-plan-activity} |
+| `log/entry` op=SEND (model)                | `TEXT_MESSAGE_START/CONTENT/END` + `CUSTOM plurnk.send` (signal/status) |
+| `log/entry` other op (model)               | `TOOL_CALL_START/ARGS/END` (+ `TOOL_CALL_RESULT` when rx exists) |
+| `log/entry` op=model (mirror)              | At most one `REASONING_ENCRYPTED_VALUE`, attached to the same turn's actual SEND assistant message when {§agui-encrypted-reasoning} is satisfied; otherwise nothing beyond the forensic row. |
+| `log/entry` origin≠model                   | `CUSTOM plurnk.ambient` (foists, deltas, narrations) |
+| client-owned `loop/proposal`               | `TOOL_CALL_START/ARGS/END`, then `RUN_FINISHED` with an interrupt outcome |
+| `loop/terminated`                          | `STATE_DELTA` (budget) + `CUSTOM plurnk.terminated` (including the daemon's top-level attribution projection) + `RAW` (the provider's native completion frame, `source: provider`, §475) + `RUN_FINISHED` (`result.status === 200`) or `RUN_ERROR` (otherwise, from the exact RFC 9457 Problem Details) |
+| transport failure after SSE opens          | `CUSTOM plurnk.problem` (exact Problem Details) + `RUN_ERROR` (`code` = Problem `type`, `message` = Problem `detail`) |
+| `notice/event`                             | `CUSTOM plurnk.notice` |
+| `stream/event` + `stream/concluded`        | `CUSTOM plurnk.stream` + `ACTIVITY_SNAPSHOT` (the standard background-activity channel: `activityType` = the scheme, replace-snapshot, §475). A conclusion preserves its exact universal `result`, including RFC 9457 Problem Details; AG-UI does not reconstruct failure from a status or summary. |
+| `workspace/branch-batch`                   | `CUSTOM plurnk.branch_batch` with the daemon's full queued/running/completed/failed/recovery-required lifecycle payload |
+
+§agui-plan-activity **PLAN is activity, not reasoning.** PLAN is the model's public,
+durable statement of intended goals. Provider reasoning is a separate channel, so PLAN
+never projects into AG-UI `REASONING_*` events. Live delivery and reattach preserve the
+same log identity and verbatim goals:
+
+| Projection | Standard representation |
+| ---------- | ----------------------- |
+| live       | `ACTIVITY_SNAPSHOT { messageId: coordinate ?? id, activityType: "PLAN", content: { goals: body }, replace: true }` |
+| reattach   | `ActivityMessage { id: coordinate ?? id, role: "activity", activityType: "PLAN", content: { goals: body } }` inside `MESSAGES_SNAPSHOT` |
 
 - **An op row IS a tool call** — its `coordinate` is the `toolCallId`, its tx the args (one
   delta: a dispatched plurnk op is atomic), its rx the result. The log-shaped richness the
   core vocabulary can't hold (fold state, tags, tokens) stays on the row inside
   `plurnk.ambient`/`TOOL_CALL_RESULT` payloads.
-- **Sealed reasoning: a hard interface to the standard** {§agui-sealed-reasoning} — reasoning
-  transmission is a SOLVED problem (OpenAI Responses / AG-UI reasoning-item; DIVERGENCES row 3 =
-  reasoning CONVERGED, with no exception for its representation), so agui consumes the standard
-  shape VERBATIM and does not translate a bespoke one. The REQUIRED seam contract: core surfaces
-  the model's reasoning on the model row's `attrs.reasoning` as a LIST of reasoning items —
-  `[{ id: string, subtype: "message" | "tool-call", encrypted?: [{ data, format }] }]` — because a
-  turn can carry N reasoning entities (distinct ids), each its own span (the OpenAI Responses
-  model). `id` is the entity's identity (the SAME id its open reasoning carries, so open text and
-  sealed value are two faces of one entity). agui projects, per item, `REASONING_ENCRYPTED_VALUE`
-  (`subtype`/`entityId`/`encryptedValue`) with
-  `entityId` = the item `id`, correlated to a `REASONING_START/END` span keyed by that same `id`.
-  `format` has no AG-UI slot; it rides `plurnk.row` losslessly. A non-array carrier is invalid.
-  An item with a null/absent `id` or an unknown
-  `subtype` is DROPPED (uncorrelatable → agui never coins an id or coerces a subtype).
-- **The custom namespace** {§agui-custom-namespace} — plurnk-specific metadata rides
+- §agui-encrypted-reasoning **Encrypted reasoning projects only onto an entity
+  AG-UI actually created.** Core supplies the exact normalized provider-detail
+  list on the model mirror row's `attrs.reasoning`. The provider detail `id` is
+  forensic identity, not an AG-UI entity ID ({§provider-encrypted-reasoning}).
+
+  | Condition                                   | Projection |
+  | ------------------------------------------- | ---------- |
+  | Same-turn SEND + one nonempty message value | One `REASONING_ENCRYPTED_VALUE` with `subtype: "message"` and `entityId` equal to that SEND message's coordinate. |
+  | Null or absent provider detail `id`         | No effect on correlation; the actual SEND identity owns the client relation. |
+  | No SEND or not exactly one message value    | No standard encrypted event. Nothing is selected, joined, or overwritten. |
+  | Provider-only and unprojected evidence      | Detail `id`, `format`, ordering, and every value remain lossless on the `plurnk.row` mirror evidence. |
+  | Reattach                                    | The same singular value occupies `encryptedValue` on the corresponding SEND `AssistantMessage` in `MESSAGES_SNAPSHOT`. |
+
+  AG-UI's single message slot cannot represent multiple provider details without
+  losing cardinality. The translator therefore emits neither invented reasoning
+  spans nor repeated events whose last value would silently overwrite its
+  siblings.
+- §agui-custom-namespace **The custom namespace** — plurnk-specific metadata rides
   `CUSTOM` events named `plurnk.*` (`plurnk.send`, `plurnk.ambient`,
-  `plurnk.telemetry`, `plurnk.stream`, `plurnk.quiesced`, `plurnk.terminated` — the full loop
+  `plurnk.notice`, `plurnk.stream`, `plurnk.branch_batch`, `plurnk.terminated` — the full loop
   outcome the budget `STATE_DELTA` can't hold). Generic frontends skip unknown customs; plurnk-aware frontends render
   them richly. Nothing plurnk-specific ever masquerades as a core event.
-- **Numbers pass through verbatim** {§agui-numbers-passthrough} — the budget `STATE_DELTA`
-  carries the daemon's own usage figures (`contextTokens`, `contextSize` = the effective
-  prompt budget, service#345). The module never recomputes a number; the daemon's gauge is
-  the gauge.
 
-- **The row channel** {§agui-row-channel} — every log row ALSO rides `CUSTOM plurnk.row`
+§agui-numbers-passthrough **Usage numbers pass through verbatim.** The module
+never recomputes the daemon's gauge.
+
+| AG-UI state location                        | Daemon source                            | Meaning |
+|:--------------------------------------------|:-----------------------------------------|:--------|
+| `snapshot.plurnk.providers[*].promptBudget` | `providers.list.aliases[*]`              | Each provider alias's effective model-facing prompt ceiling, or `null` when unknown. |
+| `STATE_DELTA /budget/contextTokens`         | `loop/terminated.usage.contextTokens`    | Latest turn's provider-reported prompt occupancy. |
+| `STATE_DELTA /budget/promptBudget`          | `loop/terminated.usage.promptBudget`     | Latest turn's effective model-facing prompt ceiling, or `null` when unknown. |
+| `STATE_DELTA /budget/promptTokens`          | `loop/terminated.usage.promptTokens`     | Loop-total provider-reported prompt usage. |
+| `STATE_DELTA /budget/completionTokens`      | `loop/terminated.usage.completionTokens` | Loop-total provider-reported completion usage. |
+
+§agui-cost-evidence `plurnk.terminated.usage` preserves the daemon's ordered
+`costs` evidence and nullable `costUsd` projection verbatim. Generic AG-UI has
+no standard monetary field; the custom event therefore distinguishes unknown
+from zero without fabricating either value.
+
+- §agui-row-channel **The row channel** — every log row ALSO rides `CUSTOM plurnk.row`
   carrying the full wire entry (fold state, tags-in-signal, tokens, coordinate) alongside its
   core projection. Rich clients (TUI/nvim) render plurnk-native fidelity from `plurnk.row`;
   generic clients never see the difference. This is the metadata channel the exclusive-portal
@@ -88,75 +117,243 @@ One daemon notification in, zero-or-more AG-UI events out (`Translator`, pure):
   `STATE_DELTA`s. A dropped SSE stream cancels the loop (`loop.cancel`) — the frontend hanging
   up IS the abort signal; no worker is orphaned unwatched.
 
-- **Reattach replays** {§agui-replay} — a rediscovered thread (the module restarted, a second
+- §agui-replay **Reattach replays** — a rediscovered thread (the module restarted, a second
   frontend arrived) attaches to its existing workspace by name→id and opens ORIENTED: the model
-  worker's SENDs replay as `MESSAGES_SNAPSHOT` (the conversation spine; everything else stays
-  reachable via live `plurnk.row`). Pending proposals remain durable and are presented as
+  worker's PLAN activities and SEND speech replay as `MESSAGES_SNAPSHOT`; everything else stays
+  reachable via live `plurnk.row`. Pending proposals remain durable and are presented as
   interrupts when the owning conversation is resumed; a days-old question is discoverable,
   never converted into a mystery hang.
 
-## Stop-the-world {§agui-proposal-resolve}
+## §agui-proposal-resolve Stop-the-world
 
-Every client-owned daemon proposal — file edits, MCP auths, `[300]` operator questions
-(service#346) — emits an AG-UI tool call and terminates run A with
+Every client-owned daemon proposal - file edits and `[300]` operator questions —
+emits an AG-UI tool call and terminates AG-UI Run A with
 `RUN_FINISHED.outcome.type = "interrupt"`. The durable loop remains paused indefinitely
-by default; absence is not an answer. Run B on the same thread supplies standard
+by default; absence is not an answer. AG-UI Run B on the same thread supplies standard
 `RunAgentInput.resume` entries. Each entry correlates through `interruptId = toolCallId =
 "prop:<logEntryId>"`; the module resolves every pending interrupt for that worker, binds
-run B to the persisted loop, and releases it. A resume containing foreign, partial, or
+AG-UI Run B to the persisted loop, and releases it. A resume containing foreign, partial, or
 multi-worker interrupt sets fails before any proposal is released.
 
-## The action surface {§agui-management-plane}
+§agui-proposal-disposition **AG-UI consumes disposition; it does not infer policy.** Both the live `loop/proposal` payload and `CoreSeam.pendingProposals()` return the contracts-owned `ProposalProjection`. `disposition.owner` is the sole presentation branch:
+
+| Disposition owner | AG-UI behavior                                                                |
+| ----------------- | ----------------------------------------------------------------------------- |
+| `client`          | Emit/re-surface the proposal tool call and standard interrupt                 |
+| `loop`            | Emit no tool call; core applies the carried decision and the Run continues    |
+
+Raw `auto`, `noProposals`, operation, attrs, and stale-target facts remain visible evidence but are not re-evaluated here. Reconnect filters by the same disposition, so an internal policy failure cannot silently turn client presentation into an accidental fallback.
+
+## §agui-management-plane The action surface
+
+PLURNK has three inputs through the one AG-UI Run endpoint. A normal user message
+and a standard proposal resume are not management actions and have no invented
+`loop.run` or `loop.resolve` action names.
+
+```mermaid
+flowchart LR
+    client["AG-UI client"] --> run["POST RunAgentInput"]
+    run --> classify{"Input form"}
+    classify -->|"textual user message"| loop["CoreSeam.runLoop"]
+    classify -->|"RunAgentInput.resume"| proposal["CoreSeam.resolveProposal"]
+    classify -->|"forwardedProps.plurnk.action"| actions{"AG-UI action registry"}
+    actions --> builtIn["Built-in validation<br/>and typed CoreSeam call"]
+    actions --> extension["CoreSeam.invokeModuleAction"]
+    loop --> events["Core event source"]
+    proposal --> events
+    builtIn --> events
+    events --> projection["AG-UI projection"]
+    extension --> result["plurnk.action.result"]
+    projection --> client
+    result --> client
+```
+
+A management-action Run carries
+`forwardedProps.plurnk.action = { kind, ...params }`. Once settled, it returns
+one `CUSTOM plurnk.action.result` shaped as `{ kind, ok, result | problem }`,
+followed by `RUN_FINISHED`. A proposal-gated action may first end with an
+interrupt and deliver that settled result on the standard resume Run. A failed
+action preserves exact RFC 9457 Problem Details and is the result of a
+successfully transported management Run; it does not turn the Run into
+`RUN_ERROR` or invent a parallel error string. Unknown kinds return an honest
+`unknown-action` Problem. There is no side-channel endpoint.
+
+| Public action            | Scope     | Parameters                                           | Owner / effect                                                                                                     |
+|--------------------------|-----------|------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------|
+| `ping`                   | Worldless | none                                                 | AG-UI-local liveness; returns `{}`.                                                                                |
+| `discover`               | Worldless | none                                                 | AG-UI-local public membership manifest ({§discovery}).                                                             |
+| `providers.list`         | Worldless | none                                                 | `CoreSeam.listProviders`.                                                                                          |
+| `workspace.list`         | Worldless | none                                                 | `CoreSeam.listWorkspaces`.                                                                                         |
+| `workspace.create`       | Worldless | `name?`, `projectRoot?`, `settings?`, `constraints?` | Creates or attaches the exact named world, or asks core to create an automatically named world.                    |
+| `workspace.attach`       | Worldless | `id`, `workerId?`                                    | `CoreSeam.attachWorkspace`; returns the selected envelope.                                                         |
+| `workspace.workers`      | Workspace | `id?`                                                | `CoreSeam.listWorkers`; an explicit id overrides the bound workspace.                                              |
+| `log.read`               | Workspace | `workerId?`, log-coordinate filters                  | `CoreSeam.readLog`; defaults to the thread's conversation worker.                                                  |
+| `loop.inject`            | Workspace | `prompt`                                             | `CoreSeam.runLoop` on the thread's conversation worker; folds into live work or enqueues a loop.                   |
+| `loop.cancel`            | Workspace | none                                                 | `CoreSeam.cancelDrain` on the thread's conversation worker.                                                        |
+| `workspace.prompts`      | Workspace | `limit?`                                             | `CoreSeam.listPrompts`.                                                                                            |
+| `workspace.rename`       | Workspace | `name`                                               | `CoreSeam.renameWorkspace`.                                                                                        |
+| `workspace.constrain`    | Workspace | `effect`, `glob`                                     | `CoreSeam.constrain`.                                                                                              |
+| `workspace.unconstrain`  | Workspace | `effect`, `glob`                                     | `CoreSeam.unconstrain`.                                                                                            |
+| `workspace.constraints`  | Workspace | none                                                 | `CoreSeam.listConstraints`.                                                                                        |
+| `workspace.derivation`   | Workspace | none                                                 | `CoreSeam.workspaceDerivationStatus`.                                                                              |
+| `entry.read`             | Workspace | `target`, `channel?`, `offset?`                      | Calls `CoreSeam.readEntry` with the thread's conversation worker and preserves validated {§entry-read-result}.     |
+| `op.exec`                | Workspace | `command`                                            | Constructs one EXEC statement and calls `CoreSeam.dispatchClientAction` on the client worker.                      |
+| `op.parse`               | Workspace | `text`                                               | Parses and projects PLURNK text under {§agui-op-parse}.                                                            |
+| `workspace.members`      | Workspace | none                                                 | `CoreSeam.listMembers`.                                                                                            |
+| `op.look`                | Workspace | `text`                                               | Admits one LOOK under {§agui-op-look}, rewrites it to READ, and calls core's no-log `look` projection.              |
+| `run.fork`               | Workspace | `name?`                                              | `CoreSeam.forkWorker` from the thread's conversation worker.                                                       |
+| Registered module action | Worldless | owner-defined                                        | `CoreSeam.invokeModuleAction`; the handler receives only the supplied params and owns their validation and result. |
+
+### §agui-op-parse Parsed-operation projection
+
+`op.parse` dispatches all trusted-prefix statements as one client action and
+preserves the parser's source order in its `results` array:
+
+| Parser output                                  | AG-UI result                                                                                                                                         |
+|------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Statement before the tail boundary             | Its corresponding `CoreSeam.dispatchClientAction` result in the statement's position                                                                 |
+| Bounded hard error                             | A 400 `agui/action/parse-failed` result in the error's position, preserving parser detail, line, column, source, and severity                        |
+| `unparsedTail` under {§unparsed-tail-boundary} | Exactly one final 400 `agui/action/parse-failed` result with its verbatim reason and position, `source: "grammar"`, and no adapter-authored recovery |
+| Text item                                      | No result; text is not dispatchable                                                                                                                  |
 
-A verb is a §3 action run: `forwardedProps.plurnk.action = {kind, …params}` in, one
-`CUSTOM plurnk.action.result` (`{kind, ok, result|error}`) out, `RUN_FINISHED`. There is
-no side-channel RPC endpoint; the worker envelope is the whole interface. Unknown kinds
-error honestly (`ok:false`). `loop.inject` rides this surface; its steered effect
-streams on the original worker's open SSE. `loop.cancel` is its counterpart — it aborts
-the model worker's active drain (the addressable spelling of the SSE-hangup abort; both
-clients' stop controls ride it). An action that opens a stream remains one live AG-UI run:
-its result is held until every observed stream emits `stream/concluded`, then the result
-and `RUN_FINISHED` close that same run. A client disconnect before settlement cancels the
-action worker with reason `client_disconnected`; it never silently converts the action
-into detached background work.
+No statement at or beyond the tail boundary is dispatched. Every parse failure
+uses `stage: "parsing"` and `retryable: false`.
 
-## Topology scope {§agui-topology-scope}
+### §agui-op-look Single-statement observation admission
+
+`op.look` admits a parser result only when it contains exactly one LOOK
+statement, no other item, and no `unparsedTail`. Hidden surrounding whitespace
+is not an item. The action never selects a trusted prefix or silently discards
+a parser fact.
+
+| Parser result                                       | AG-UI outcome                                                                                                                      |
+|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|
+| First positioned diagnostic                         | 400 `agui/action/parse-failed`, preserving parser detail, line, column, source, and severity                                       |
+| No diagnostic, with `unparsedTail`                  | 400 `agui/action/parse-failed`, preserving its reason and position with `source: "grammar"` and `severity: "error"`                |
+| Text item, zero or multiple statements, or non-LOOK | 400 `agui/action/invalid-action-parameters` naming the observed admission fact                                                     |
+| Exactly one LOOK and no other parser fact           | Change only `op` to READ and call `CoreSeam.look` under {§op-look}; return its exact `OperationResult` through the action envelope |
+
+Parser failures use `stage: "parsing"`; action-shape failures use
+`stage: "action-validation"`. Both are non-retryable.
+
+§agui-module-actions **One public action namespace.** Core rejects empty and
+duplicate extension registrations ({§module-action-registration}). At module
+startup AG-UI rejects any extension name colliding with a built-in before it
+opens the listener. A recognized Problem thrown by an extension crosses the
+boundary unchanged; an unexpected handler exception becomes the generic
+`action-failed` Problem without exposing private exception text.
+
+### §discovery Discovery membership
+
+The `discover` action returns membership, not a parallel description or schema
+system:
+
+```ts
+type Discovery = {
+    methods: Record<string, true>;
+    notifications: Record<string, true>;
+    display: ClientDisplayCapabilities;
+};
+```
+
+`display` is Core's validated, contracts-owned installed scheme/MIME projection
+({§client-display-capabilities}). AG-UI adds no fallback, font, theme, or packet
+policy.
+
+`methods` contains the 22 built-ins in the table plus every registered module
+action. `notifications` contains exactly these externally projected daemon
+event families:
+
+| Notification |
+|--------------|
+| `log/entry` |
+| `loop/terminated` |
+| `loop/proposal` |
+| `notice/event` |
+| `stream/event` |
+| `stream/concluded` |
+| `workspace/branch-batch` |
+
+Discovery does not report parameter pseudo-schemas, plugin catalogs, package
+versions, or update availability. Object key order is not a contract.
+
+`loop.inject`'s steered effect streams on the original worker's open SSE.
+`loop.cancel` is its counterpart: the addressable spelling of the SSE-hangup
+abort. An action that opens a stream remains one live AG-UI Run; its result is
+held until every observed stream emits `stream/concluded`, then the result and
+`RUN_FINISHED` close that Run. A client disconnect before settlement cancels
+the action worker with reason `client_disconnected`; it never silently converts
+the action into detached background work.
+
+## §agui-topology-scope Topology scope
 
 The workspace broadcast carries EVERY worker's rows (workers, the plurnk worker, siblings);
-only the thread's model worker projects onto the core vocabulary. Foreign-run rows ride
+only the thread's model worker projects onto the core vocabulary. Foreign-worker rows ride
 `plurnk.row`/`plurnk.ambient` — visible to rich clients as topology, never interleaved
 into the conversation a generic frontend renders.
 
-## Event fan and run settlement {§agui-broadcast-fan}
+## §agui-broadcast-fan Event fan and AG-UI Run settlement
 
-Workspace information fans to every open run: ambient rows and stream activity
+Workspace information fans to every open AG-UI Run: ambient rows and stream activity
 remain visible across the workspace, with each SSE
-using its own render router. Terminal control does not fan. A message run binds
-to the exact `loopId` returned by `loop.run`; a proposal-resume run binds to the
+using its own render router. Terminal control does not fan. A message AG-UI Run binds
+to the exact `loopId` returned by `CoreSeam.runLoop`; a proposal-resume AG-UI Run binds to the
 pending proposal's persisted `loopId` before resolving it. Only that loop's
 `loop/terminated` event may emit `plurnk.terminated` and close the SSE.
+The custom event preserves the daemon's exact universal `result`; failures use
+the Problem `type` as the AG-UI error code and `detail` as its message. The
+module never reconstructs a failure from a status, summary, or exception text.
 Proposal tool calls and interrupt outcomes route only to the proposal's owning
-worker; interrupting sibling runs would violate AG-UI run identity. Terminations
-that race ahead of the `loop.run` acknowledgement are held until
+worker; interrupting sibling AG-UI Runs would violate AG-UI Run identity. Terminations
+that race ahead of the `runLoop` acknowledgement are held until
 the loop identity is known. A sibling, child, or concurrent loop can therefore
-remain visible as topology without ending or relabelling this run.
+remain visible as topology without ending or relabelling this AG-UI Run.
 
 Two consequences the module owns and a client must handle:
 
-- **Multiplicity.** Workspace stream information may arrive on every open run. A client
-  that funnels all runs
-  through one shared handler (e.g. a single dispatch) must SERIALIZE its management runs —
+- **Multiplicity.** Workspace stream information may arrive on every open AG-UI Run. A client
+  that funnels all AG-UI Runs
+  through one shared handler (e.g. a single dispatch) must serialize its management Runs —
   one action in flight, the rest queued — or a background action's stream steals the shared
-  slot. Both first-party clients do exactly this (nvim's management lane, svc#504).
-- **No silent drop.** Workspace information never routes to a lone last-binder — a regression to that
-  shape is what svc#504 reported (a client-side single-slot handler, since fixed) and is
-  pinned against here.
+  slot. Both first-party clients do exactly this through a serialized management lane.
+- **No silent drop.** Workspace information never routes to a lone last-binder; the
+  client-side single-slot regression is pinned against here.
+
+## §agui-configuration Module configuration
 
-## The worker endpoint {§agui-run-endpoint}
+The daemon assembles installed package defaults through
+{§operator-config-env-defaults}; AG-UI reads and validates its own keys from that
+environment. Explicit `Module.init` options override their corresponding environment
+values for direct in-process composition. The listener address remains service-owned.
+
+| Input                              | Owner   | Empty or absent                        | Accepted value                      | Effect |
+| ---------------------------------- | ------- | -------------------------------------- | ----------------------------------- | ------ |
+| `PLURNK_HOST` / `PLURNK_PORT`      | Service | Invalid at service boot                | Service-valid host and port         | Core supplies the listener address to `Module.init`. |
+| `PLURNK_AGUI_TOKEN`                | AG-UI   | No module-level bearer requirement     | Any string                          | A non-empty value requires the exact bearer on every non-preflight request. |
+| `PLURNK_AGUI_MAX_TURNS`            | AG-UI   | No module-level default                | `-1` or a non-negative safe integer | Supplies `maxTurns` only when the Run does not carry its own value. |
+| `PLURNK_AGUI_HEARTBEAT_MS`         | AG-UI   | Invalid; the package floor is required | Integer `0` through `2147483647`    | SSE comment-frame cadence in milliseconds; `0` disables it. |
+
+## §agui-run-endpoint The AG-UI Run endpoint
 
 `POST /` (or `/agui`) accepts a schema-valid AG-UI `RunAgentInput`: the last textual
 `user` message becomes the
-`loop.run` prompt (`maxTurns`/`flags.auto` from env); the response is `text/event-stream`,
+`CoreSeam.runLoop` prompt (`maxTurns`/`flags.auto` from the forwarded PLURNK
+properties or module defaults); the response is `text/event-stream`,
 one `data:` line per event, ending after `RUN_FINISHED`/`RUN_ERROR`. Multimodal user content
 is rejected until the model-loop seam supports it deliberately. Loop auto never answers
 a question — that is the daemon's own rule; the module inherits it.
+
+§agui-http-authorization When `PLURNK_AGUI_TOKEN` is non-empty, every
+non-preflight request must carry that exact value as an
+`authorization: Bearer <token>` header. Authorization precedes request-body
+reading. A missing or mismatched credential returns the stable 401
+`bearer-token-required` Problem.
+
+§agui-http-failure Failures before SSE headers are sent use
+`application/problem+json` with exact
+RFC 9457 Problem Details. Once SSE has opened, `CUSTOM plurnk.problem` preserves
+that same object and `RUN_ERROR` maps it to the standard AG-UI fields. The custom
+event and `plurnk.terminated.result.problem` are lossless; `RUN_ERROR.code` and
+`message` are the required standard projection, not a second failure object.
+Consumers preserve the exact Problem from the lossless surface and never
+reconstruct one from `RUN_ERROR`.

package/dist/AguiPlus.d.ts

@@ -1,5 +1,6 @@
 import { type AguiEvent, type ProposalNotification } from "./types.ts";
 import type { Interrupt, ResumeEntry } from "@ag-ui/core";
+import type { ProblemDetails } from "@plurnk/plurnk-contracts";
 export declare const proposalToolCallId: (logEntryId: number) => string;
 export declare const logEntryIdFromToolCallId: (toolCallId: string) => number | null;
 export declare const proposalToolName: (op: string) => string;
@@ -49,7 +50,7 @@ export type ActionOutcome = {
     result?: unknown;
 } | {
     ok: false;
-    error: string;
+    problem: ProblemDetails;
 };
 export declare const actionResult: (kind: string, outcome: ActionOutcome) => AguiEvent;
 //# sourceMappingURL=AguiPlus.d.ts.map

package/dist/AguiPlus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AguiPlus.d.ts","sourceRoot":"","sources":["../src/AguiPlus.ts"],"names":[],"mappings":"AAQA,OAAO,EAAa,KAAK,SAAS,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK1D,eAAO,MAAM,kBAAkB,eAAgB,MAAM,KAAG,MAA8B,CAAC;AACvF,eAAO,MAAM,wBAAwB,eAAgB,MAAM,KAAG,MAAM,GAAG,IAGtE,CAAC;AAOF,eAAO,MAAM,gBAAgB,OAAQ,MAAM,KAAG,MAAqE,CAAC;AAIpH,eAAO,MAAM,gBAAgB,MAAO,oBAAoB,KAAG,SAAS,EAOnE,CAAC;AAEF,eAAO,MAAM,iBAAiB,eAAgB,MAAM,KAAG,SAarD,CAAC;AAGH,MAAM,WAAW,UAAU;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAC3G,eAAO,MAAM,oBAAoB,UAAW,WAAW,KAAG,UAAU,GAAG,IAStE,CAAC;AAIF,MAAM,WAAW,aAAa;IAC1B,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAClG,SAAS,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9F,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AACD,eAAO,MAAM,aAAa,MAAO,aAAa,KAAG,SAA0E,CAAC;AAC5H,eAAO,MAAM,UAAU,YAAa,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,KAAG,SAA8D,CAAC;AAS1J,MAAM,WAAW,aAAa;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAChF,eAAO,MAAM,WAAW,mBAAoB,OAAO,KAAG,aAAa,GAAG,IAOrE,CAAC;AACF,MAAM,MAAM,aAAa,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1F,eAAO,MAAM,YAAY,SAAU,MAAM,WAAW,aAAa,KAAG,SACuB,CAAC"}
+{"version":3,"file":"AguiPlus.d.ts","sourceRoot":"","sources":["../src/AguiPlus.ts"],"names":[],"mappings":"AAQA,OAAO,EAAa,KAAK,SAAS,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK/D,eAAO,MAAM,kBAAkB,eAAgB,MAAM,KAAG,MAA8B,CAAC;AACvF,eAAO,MAAM,wBAAwB,eAAgB,MAAM,KAAG,MAAM,GAAG,IAGtE,CAAC;AAOF,eAAO,MAAM,gBAAgB,OAAQ,MAAM,KAAG,MAAqE,CAAC;AAIpH,eAAO,MAAM,gBAAgB,MAAO,oBAAoB,KAAG,SAAS,EAOnE,CAAC;AAEF,eAAO,MAAM,iBAAiB,eAAgB,MAAM,KAAG,SAarD,CAAC;AAGH,MAAM,WAAW,UAAU;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAC3G,eAAO,MAAM,oBAAoB,UAAW,WAAW,KAAG,UAAU,GAAG,IAStE,CAAC;AAIF,MAAM,WAAW,aAAa;IAC1B,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAClG,SAAS,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9F,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AACD,eAAO,MAAM,aAAa,MAAO,aAAa,KAAG,SAA0E,CAAC;AAC5H,eAAO,MAAM,UAAU,YAAa,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,KAAG,SAA8D,CAAC;AAS1J,MAAM,WAAW,aAAa;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAChF,eAAO,MAAM,WAAW,mBAAoB,OAAO,KAAG,aAAa,GAAG,IAOrE,CAAC;AACF,MAAM,MAAM,aAAa,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC;AACpG,eAAO,MAAM,YAAY,SAAU,MAAM,WAAW,aAAa,KAAG,SACuB,CAAC"}

package/dist/AguiPlus.js

@@ -1,5 +1,5 @@
-// The AG-UI+ projection (single-interface rendering) — prototyped + unit-tested
-// standalone ahead of the in-process module (plurnk-agui#2, WS-1). Pure functions:
+// {§agui-projection} The AG-UI+ projection is unit-tested independently of the
+// in-process module. Pure functions:
 // engine state → AG-UI events, and the inverse resume-mapping. No transport, no I/O
 // — so it ports into the in-process module unchanged when the seam lands.
 //
@@ -7,8 +7,8 @@
 // shared STATE. This is the flagship choreography de-risked as logic before code.
 import { EventType } from "./types.js";
 // ── §1 — stop-the-world → tool-call ──────────────────────────────────
-// toolCallId correlates the terminating run's TOOL_CALL and interrupt with the next
-// run's ResumeEntry → the exact pending proposal. Encodes the logEntryId: `prop:<id>`.
+// toolCallId correlates the terminating AG-UI Run's TOOL_CALL and interrupt with the next
+// AG-UI Run's ResumeEntry → the exact pending proposal. Encodes the logEntryId: `prop:<id>`.
 export const proposalToolCallId = (logEntryId) => `prop:${logEntryId}`;
 export const logEntryIdFromToolCallId = (toolCallId) => {
     const m = /^prop:(\d+)$/.exec(toolCallId);
@@ -26,7 +26,7 @@ export const proposalToolCall = (p) => {
     const toolCallId = proposalToolCallId(p.logEntryId);
     return [
         { type: EventType.TOOL_CALL_START, toolCallId, toolCallName: proposalToolName(p.op) },
-        { type: EventType.TOOL_CALL_ARGS, toolCallId, delta: JSON.stringify({ op: p.op, target: p.target, body: p.body, attrs: p.attrs, staleClobberRisk: p.staleClobberRisk ?? false }) },
+        { type: EventType.TOOL_CALL_ARGS, toolCallId, delta: JSON.stringify({ op: p.op, target: p.target, body: p.body, attrs: p.attrs, staleClobberRisk: p.staleClobberRisk }) },
         { type: EventType.TOOL_CALL_END, toolCallId },
     ];
 };

package/dist/AguiPlus.js.map

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