@plurnk/plurnk-agui 0.3.0

package/.env.example

@@ -0,0 +1,37 @@
+# ============================================================================
+# @plurnk/plurnk-agui — every knob lives here; no code fallback hides one.
+# ============================================================================
+
+# The plurnk daemon this bridge fronts (the bridge is an ordinary client of the
+# JSON-RPC-over-WebSocket wire — it holds no state the daemon doesn't).
+PLURNK_AGUI_DAEMON_URL=ws://127.0.0.1:3044
+
+# The AG-UI listener. POST / with Accept: text/event-stream is the run endpoint
+# (the AG-UI HttpAgent default shape); POST /resolve answers proposals/questions.
+PLURNK_AGUI_HOST=127.0.0.1
+PLURNK_AGUI_PORT=3080
+
+# Session naming: an AG-UI threadId maps to the daemon session `<prefix>-<threadId>`
+# (created on the thread's first run, reattached on every run after — AG-UI threads
+# ARE plurnk sessions, so the extended context persists across runs).
+PLURNK_AGUI_SESSION_PREFIX=agui
+
+# Operator questions ([300]): 1 = sessions created by this bridge request
+# settings.questions, so the model's asks surface as plurnk.proposal events for
+# the frontend to answer via POST /resolve (the daemon's PLURNK_QUESTIONS=0
+# ceiling still wins). 0 = headless semantics — asks are refused with the
+# self-decide steer, exactly like bench.
+PLURNK_AGUI_QUESTIONS=1
+
+# Loop flags forwarded on every run this bridge starts. yolo=1 auto-accepts
+# file-edit proposals daemon-side (questions still stop the world — the daemon
+# never yolo-answers a human question).
+PLURNK_AGUI_YOLO=0
+
+# Per-run turn ceiling forwarded to loop.run.
+PLURNK_AGUI_MAX_TURNS=24
+
+# Bridge auth — EMPTY (shipped) = local trust (bind 127.0.0.1 and the port IS the boundary,
+# the same posture as the daemon's own WS). Set a token and every POST must carry
+# `Authorization: Bearer <token>` — the knob for any non-loopback deployment.
+PLURNK_AGUI_TOKEN=

package/README.md

@@ -0,0 +1,65 @@
+# @plurnk/plurnk-agui
+
+The plurnk daemon's **transport daughter**: owns the client interface, serving
+**AG-UI+** — the [Agent-User Interaction Protocol](https://docs.ag-ui.com) plus plurnk
+metadata extensions — as the **sole** client interaction surface. Any AG-UI frontend
+(CopilotKit, community UIs, the plurnk CLI/TUI/nvim clients) is a plurnk client.
+Vendor-agnostic, MIT.
+
+## Topology
+
+An **in-process module** of the daemon, not an external service: the daemon activates it
+at boot (`daemon.registerModule(Module.init(opts))`), handing it the curated core seam
+(event source, loop-control, op dispatch, journal/metadata reads, proposal HITL,
+session lifecycle — plurnk-service#355). The module opens its own HTTP/SSE listener and
+owns the transport+security line at that edge: bearer auth, per-session authorization,
+input validation. Below the seam: plurnk terms (loop/turn/proposal). Above: AG-UI terms
+(run/message/tool-call/state). This module is the translation.
+
+A legacy standalone bridge (`plurnk-agui` bin: WS client → SSE server) ships during the
+migration and retires at cutover.
+
+## The interface (AG-UI+)
+
+One endpoint: `POST /` with `RunAgentInput` (`threadId`, `runId`, `messages`,
+`forwardedProps`) → `text/event-stream` of AG-UI events.
+
+- **Runs**: turns are `STEP_*`; PLAN is `THINKING_TEXT_MESSAGE_*`; SEND bodies are
+  `TEXT_MESSAGE_*`; every other op row is a `TOOL_CALL_*` triple + `TOOL_CALL_RESULT`.
+  Numbers pass through verbatim (`contextSize` = the daemon's effective prompt budget).
+- **HITL, terminate-resume**: a stopped-world proposal (file edit, exec, MCP auth) emits
+  a `request_approval` tool-call — a `SEND[300]` operator question emits
+  `request_user_input` — and the run **finishes** while the loop stays paused in-engine.
+  The next run's tool-result message (`toolCallId: "prop:<id>"`, content
+  `{decision: accept|reject|cancel, body?}`) resolves it; the continued loop streams there.
+  Pending proposals re-surface on (re)connect — a days-old question is discoverable.
+- **Reads ride STATE**: providers/aliases/budget/session arrive as `STATE_SNAPSHOT` on
+  `RUN_STARTED` and `STATE_DELTA` on change — observed, not polled.
+- **Session options** ride the thread's first run: `forwardedProps.plurnk`
+  (`projectRoot`, `constraints`, `settings`); per-run knobs (`maxTurns`, `flags`,
+  `alias`/`model`) every run.
+- **Cancel**: dropping the SSE aborts a live loop (hangup is the abort); a
+  proposal-terminated run leaves the paused loop for the resume.
+- An AG-UI `threadId` **is** a plurnk session (`<prefix>-<threadId>`) — extended context
+  persists across runs; history replays as `MESSAGES_SNAPSHOT` on reattach.
+- **Tier 2 metadata** (`CUSTOM plurnk.*`: row, stream, telemetry, terminated) carries
+  what AG-UI has no term for — fold state, coordinates, tags, token truth. Generic
+  frontends skip it; family clients render it richly. The full contract: `SPEC.md`
+  (every `{§}` anchor cited by a test).
+
+## Consume
+
+```ts
+import { Module } from "@plurnk/plurnk-agui";
+daemon.registerModule(Module.init({ host: "127.0.0.1", port: 3080, sessionPrefix: "agui" }));
+```
+
+Legacy bridge: `npx plurnk-agui` fronts `ws://127.0.0.1:3044`, listens on `:3080`;
+config is `.env` over the shipped `.env.example` (every knob documented there).
+
+## Dependencies
+
+**Zero at runtime — no Zod, no SDK.** The AG-UI event shapes are hand-defined plain TS
+(the official `@ag-ui/core` is 0.0.x and would drag Zod in, so it is deliberately NOT a
+dependency). If the official SDK ever stabilizes dependency-free, adopting it is a
+types-only swap.

package/SPEC.md

@@ -0,0 +1,115 @@
+# @plurnk/plurnk-agui — the projection contract
+
+The bridge is **a client of the plurnk daemon and a server of AG-UI**: it consumes the same
+JSON-RPC-over-WebSocket wire every plurnk client speaks, and emits the Agent-User Interaction
+Protocol's SSE event stream. Zero daemon changes; the daemon's numbers and semantics pass
+through, never recomputed. Every `{§}` anchor below is cited by a `[§]` test.
+
+## Architecture
+
+- **The bridge is an ordinary daemon client** {§agui-daemon-client} — it connects to
+  `PLURNK_AGUI_DAEMON_URL`, calls the public methods (`session.create`/`session.attach`,
+  `loop.run`, `loop.resolve`), and subscribes to the public notifications (`log/entry`,
+  `loop/proposal`, `loop/terminated`). It holds no state the daemon doesn't: a bridge restart
+  loses nothing (threads reattach by session name).
+- **An AG-UI thread IS a plurnk session** {§agui-thread-is-session} — `threadId` maps to the
+  session `<PLURNK_AGUI_SESSION_PREFIX>-<threadId>`, created on the thread's first run with
+  `settings.questions` per `PLURNK_AGUI_QUESTIONS`, reattached on every run after. Plurnk's
+  extended context persists across AG-UI runs because the session does.
+- **Zero runtime dependencies** {§agui-zero-dep} — the AG-UI event shapes are hand-defined
+  plain JSON (`src/types.ts`); the SSE encoding is `data: <json>\n\n`. The protocol is young;
+  a zero-dep daughter beats tracking SDK churn, and adopting the official SDK later is a
+  types-only swap.
+
+## 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) | `THINKING_TEXT_MESSAGE_START/CONTENT/END` |
+| `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) | nothing — forensic, not speech |
+| `log/entry` origin≠model | `CUSTOM plurnk.ambient` (foists, deltas, narrations) |
+| `loop/proposal` | `CUSTOM plurnk.proposal` |
+| `loop/terminated` | `STATE_DELTA` (budget) + `CUSTOM plurnk.terminated` (sessionId, loopId, turnIds, costPico, meta) + `RUN_FINISHED` (200) or `RUN_ERROR` (else) |
+| `telemetry/event` | `CUSTOM plurnk.telemetry` |
+| `stream/event` + `stream/concluded` | `CUSTOM plurnk.stream` (payload self-discriminates: event carries `state`, concluded `closeStatus`) |
+| `loop/quiesced` | `CUSTOM plurnk.quiesced` |
+
+- **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.
+- **The custom namespace** {§agui-custom-namespace} — everything plurnk-specific rides
+  `CUSTOM` events named `plurnk.*` (`plurnk.send`, `plurnk.ambient`, `plurnk.proposal`,
+  `plurnk.telemetry`, `plurnk.stream`, `plurnk.quiesced`, `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 bridge 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`
+  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
+  migration stands on.
+- **The gauge starts true** — `RUN_STARTED` is followed by a `STATE_SNAPSHOT` carrying the
+  daemon's `providers.list` truth (the effective prompt budget, the active model), then
+  `STATE_DELTA`s. A dropped SSE stream cancels the loop (`loop.cancel`) — the frontend hanging
+  up IS the abort signal; no run is orphaned unwatched.
+
+- **Reattach replays** {§agui-replay} — a rediscovered thread (the bridge restarted, a second
+  frontend arrived) attaches to its existing session by name→id and opens ORIENTED: the model
+  run's SENDs replay as `MESSAGES_SNAPSHOT` (the conversation spine; everything else stays
+  reachable via live `plurnk.row`), and every pending stop-the-world proposal re-surfaces
+  immediately via the daemon's `proposal.list` — the indefinite-wait ruling's client half: a
+  days-old question is discoverable, never a mystery hang.
+
+## Stop-the-world {§agui-proposal-resolve}
+
+Every daemon proposal — file edits, MCP auths, `[300]` operator questions (service#346) —
+surfaces as `CUSTOM plurnk.proposal` carrying `{logEntryId, op, target, body, attrs, flags}`
+(`attrs.question`/`attrs.choices` for questions). The frontend answers via
+`POST /resolve {threadId, logEntryId, decision, body?}` — a passthrough to the daemon's
+`loop.resolve`, where an accept `body` is the answer. The SSE stream stays open while the
+world is stopped — **indefinitely by default** (service ruling: a stopped world waits for its
+human; the timeout is operator opt-in) — and the run resumes on resolution.
+
+## The management plane {§agui-management-plane}
+
+AG-UI models the RUN plane; the workspace plane rides the charter's ONE escape hatch:
+`POST /plurnk/rpc {threadId, method, params}` — a verbatim JSON-RPC passthrough on the
+thread's own daemon connection (session scoping is exactly the thread's). The daemon's
+method registry is the contract; discover it with `{method: "discover"}`. Session options
+for a thread's FIRST run ride `RunAgentInput.forwardedProps.plurnk` {§agui-forwarded-props}
+(`projectRoot`, `constraints`, `settings` — composing over the bridge's questions default).
+
+- **Topology scoping** {§agui-topology-scope} — the session broadcast carries every run's rows
+  (workers, the plurnk run, siblings); only the THREAD's model run projects onto the core
+  vocabulary. Foreign rows ride `plurnk.row`/`plurnk.ambient` — rich clients render the
+  topology; a worker's SEND never masquerades as the assistant speaking.
+- **Concurrent runs: the daemon decides** — a `POST /` while a run is live passes through to
+  `loop.run`, whose OWN semantics apply (inject-into-the-active-loop or enqueue — the ack's
+  `action` says which). Mechanism, not policy: the bridge adds no queueing of its own; both
+  open streams observe the shared session events and end at `loop/terminated`.
+
+- **Auth** {§agui-auth} — `PLURNK_AGUI_TOKEN` empty (shipped) = local trust: the loopback bind
+  is the boundary, the daemon's own posture. Set, every POST must carry
+  `Authorization: Bearer <token>`, checked before any body is read.
+- **Daemon loss fails hard — by design, not omission**: the bridge holds no state the daemon
+  doesn't, so a dropped daemon connection kills the affected request loudly and the operator's
+  supervisor restarts the bridge (reattach reconstructs every thread by name). Backoff loops
+  hide outages; a dead daemon should look dead.
+
+## The run endpoint {§agui-run-endpoint}
+
+`POST /` (or `/agui`) with an AG-UI `RunAgentInput` body: the last `user` message becomes the
+`loop.run` prompt (`maxTurns`/`flags.yolo` from env); the response is `text/event-stream`,
+one `data:` line per event, ending after `RUN_FINISHED`/`RUN_ERROR`. Yolo never auto-answers
+a question — that's the daemon's own rule; the bridge inherits it.

package/dist/AguiPlus.d.ts

@@ -0,0 +1,58 @@
+import type { AguiEvent, ProposalNotification } from "./types.ts";
+export declare const proposalToolCallId: (logEntryId: number) => string;
+export declare const logEntryIdFromToolCallId: (toolCallId: string) => number | null;
+export declare const proposalToolName: (op: string) => string;
+export declare const proposalToolCall: (p: ProposalNotification) => AguiEvent[];
+export interface ToolResultMessage {
+    toolCallId?: string;
+    content?: string;
+    role?: string;
+}
+export interface Resolution {
+    logEntryId: number;
+    decision: "accept" | "reject" | "cancel";
+    body?: string;
+}
+export declare const resolutionFromToolResult: (m: ToolResultMessage) => Resolution | null;
+export interface AguiPlusState {
+    providers?: Array<{
+        alias: string;
+        model: string;
+        active: boolean;
+        contextSize: number | null;
+    }>;
+    session?: {
+        id: number;
+        name: string;
+        projectRoot?: string | null;
+        budget?: number | null;
+    };
+    sessions?: Array<{
+        id: number;
+        name: string;
+    }>;
+    constraints?: Array<{
+        effect: string;
+        glob: string;
+    }>;
+}
+export declare const stateSnapshot: (s: AguiPlusState) => AguiEvent;
+export declare const stateDelta: (patches: Array<{
+    op: string;
+    path: string;
+    value?: unknown;
+}>) => AguiEvent;
+export interface ActionRequest {
+    kind: string;
+    params: Record<string, unknown>;
+}
+export declare const parseAction: (forwardedProps: unknown) => ActionRequest | null;
+export type ActionOutcome = {
+    ok: true;
+    result?: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+export declare const actionResult: (kind: string, outcome: ActionOutcome) => AguiEvent;
+//# sourceMappingURL=AguiPlus.d.ts.map

package/dist/AguiPlus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AguiPlus.d.ts","sourceRoot":"","sources":["../src/AguiPlus.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKlE,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;AAKF,MAAM,WAAW,iBAAiB;IAAG,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAC3F,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,wBAAwB,MAAO,iBAAiB,KAAG,UAAU,GAAG,IAiB5E,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,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACjG,OAAO,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;IAC5F,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,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,SAAkE,CAAC;AACpH,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,SAAsD,CAAC;AASlJ,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,SACe,CAAC"}

package/dist/AguiPlus.js

@@ -0,0 +1,67 @@
+// The AG-UI+ projection (single-interface rendering) — prototyped + unit-tested
+// standalone ahead of the in-process module (plurnk-agui#2, WS-1). 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.
+//
+// §1 proposals/[300] questions → tool-calls (terminate-resume HITL); §2 reads →
+// shared STATE. This is the flagship choreography de-risked as logic before code.
+// ── §1 — stop-the-world → tool-call ──────────────────────────────────
+// toolCallId correlates the TERMINATING run's TOOL_CALL with the RESUME run's
+// tool-result → 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);
+    return m === null ? null : Number(m[1]);
+};
+// Tool-call NAME — AG-UI terminology all the way up to the seam (operator ruling,
+// 2026-07-09): the client-facing name is AG-UI-conventional, NOT plurnk-namespaced.
+// A side-effecting proposal is an approval request; a [300] question elicits input.
+// The plurnk correlation rides the opaque toolCallId (`prop:<logEntryId>`), so the
+// generic names carry no plurnk vocabulary upward.
+export const proposalToolName = (op) => (op === "SEND" ? "request_user_input" : "request_approval");
+// The run's tail when it hits a pause: the tool-call, then the CALLER emits
+// RUN_FINISHED to terminate. The loop stays paused in-engine — untouched.
+export const proposalToolCall = (p) => {
+    const toolCallId = proposalToolCallId(p.logEntryId);
+    return [
+        { type: "TOOL_CALL_START", toolCallId, toolCallName: proposalToolName(p.op) },
+        { type: "TOOL_CALL_ARGS", toolCallId, delta: JSON.stringify({ op: p.op, target: p.target, body: p.body, attrs: p.attrs, staleClobberRisk: p.staleClobberRisk ?? false }) },
+        { type: "TOOL_CALL_END", toolCallId },
+    ];
+};
+export const resolutionFromToolResult = (m) => {
+    if (typeof m.toolCallId !== "string")
+        return null;
+    const logEntryId = logEntryIdFromToolCallId(m.toolCallId);
+    if (logEntryId === null)
+        return null;
+    let decision;
+    let body;
+    if (typeof m.content === "string" && m.content.length > 0) {
+        try {
+            const parsed = JSON.parse(m.content);
+            decision = parsed.decision;
+            body = parsed.body;
+        }
+        catch {
+            decision = m.content.trim(); // tolerate a bare decision string
+        }
+    }
+    if (decision !== "accept" && decision !== "reject" && decision !== "cancel")
+        return null;
+    return { logEntryId, decision, ...(body !== undefined ? { body } : {}) };
+};
+export const stateSnapshot = (s) => ({ type: "STATE_SNAPSHOT", snapshot: { plurnk: s } });
+export const stateDelta = (patches) => ({ type: "STATE_DELTA", delta: patches });
+export const parseAction = (forwardedProps) => {
+    const action = forwardedProps?.plurnk?.action;
+    if (action === null || typeof action !== "object")
+        return null;
+    const kind = action.kind;
+    if (typeof kind !== "string" || kind.length === 0)
+        return null;
+    const { kind: _kind, ...params } = action;
+    return { kind, params };
+};
+export const actionResult = (kind, outcome) => ({ type: "CUSTOM", name: "plurnk.action.result", value: { kind, ...outcome } });
+//# sourceMappingURL=AguiPlus.js.map

package/dist/AguiPlus.js.map

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

package/dist/DaemonClient.d.ts

@@ -0,0 +1,9 @@
+export default class DaemonClient {
+    #private;
+    private constructor();
+    static connect(url: string): Promise<DaemonClient>;
+    call<T = unknown>(method: string, params?: object): Promise<T>;
+    on(method: string, fn: (params: unknown) => void): () => void;
+    close(): void;
+}
+//# sourceMappingURL=DaemonClient.d.ts.map

package/dist/DaemonClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DaemonClient.d.ts","sourceRoot":"","sources":["../src/DaemonClient.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,OAAO,YAAY;;IAM7B,OAAO,eAeN;IAED,OAAa,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAOvD;IAED,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAMjE;IAED,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAK5D;IAED,KAAK,IAAI,IAAI,CAEZ;CACJ"}

package/dist/DaemonClient.js

@@ -0,0 +1,55 @@
+// An ordinary client of the plurnk daemon's JSON-RPC-over-WebSocket wire — the same protocol
+// the CLI/TUI/nvim clients speak. The bridge holds no state the daemon doesn't (§agui-daemon-client).
+export default class DaemonClient {
+    #ws;
+    #nextId = 1;
+    #pending = new Map();
+    #listeners = new Map();
+    constructor(ws) {
+        this.#ws = ws;
+        ws.addEventListener("message", (ev) => {
+            const msg = JSON.parse(String(ev.data));
+            if (typeof msg.id === "number" && this.#pending.has(msg.id)) {
+                const waiter = this.#pending.get(msg.id);
+                this.#pending.delete(msg.id);
+                if (msg.error !== undefined)
+                    waiter.reject(new Error(msg.error.message));
+                else
+                    waiter.resolve(msg.result);
+                return;
+            }
+            if (typeof msg.method === "string") {
+                for (const fn of this.#listeners.get(msg.method) ?? [])
+                    fn(msg.params);
+            }
+        });
+    }
+    static async connect(url) {
+        const ws = new WebSocket(url);
+        await new Promise((resolve, reject) => {
+            ws.addEventListener("open", () => resolve(), { once: true });
+            ws.addEventListener("error", () => reject(new Error(`plurnk-agui: cannot reach the daemon at ${url} — is plurnk-service running?`)), { once: true });
+        });
+        return new DaemonClient(ws);
+    }
+    call(method, params = {}) {
+        const id = this.#nextId++;
+        return new Promise((resolve, reject) => {
+            this.#pending.set(id, { resolve: resolve, reject });
+            this.#ws.send(JSON.stringify({ jsonrpc: "2.0", id, method, params }));
+        });
+    }
+    on(method, fn) {
+        let set = this.#listeners.get(method);
+        if (set === undefined) {
+            set = new Set();
+            this.#listeners.set(method, set);
+        }
+        set.add(fn);
+        return () => { set.delete(fn); };
+    }
+    close() {
+        this.#ws.close();
+    }
+}
+//# sourceMappingURL=DaemonClient.js.map

package/dist/DaemonClient.js.map

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

package/dist/DaemonSeam.d.ts

@@ -0,0 +1,103 @@
+export type ProposalDecision = "accept" | "reject" | "cancel";
+export interface ProposalResolution {
+    decision: ProposalDecision;
+    body?: string;
+    outcome?: string;
+}
+export interface PendingProposal {
+    logEntryId: number;
+    runId: number;
+    loopId: number;
+    turnId: number;
+    op: string;
+    suffix: string;
+    scheme: string | null;
+    pathname: string | null;
+    tx: string | null;
+    attrs: string | null;
+}
+export interface PlurnkStatement {
+    op: string;
+    [key: string]: unknown;
+}
+export type LogEntryWire = Record<string, unknown>;
+export interface DaemonSeam {
+    subscribeToEvents(handler: (sessionId: number | null, method: string, params: unknown) => void): () => void;
+    pendingProposals(sessionId: number): Promise<PendingProposal[]>;
+    resolveProposal(logEntryId: number, resolution: ProposalResolution): void;
+    runLoop(args: {
+        sessionId: number;
+        runId: number;
+        prompt: string;
+        maxTurns?: number;
+        flags?: {
+            yolo?: boolean;
+        };
+        openPaths?: string[];
+    }): Promise<{
+        action: "injected_next_turn" | "enqueued_new_loop";
+        loopId: number;
+        turnSeq?: number;
+    }>;
+    cancelDrain(runId: number, reason?: string): boolean;
+    dispatchAsClient(args: {
+        sessionId: number;
+        runId: number;
+        statement: PlurnkStatement;
+    }): Promise<{
+        status: number;
+        [key: string]: unknown;
+    }>;
+    readLog(args: {
+        sessionId: number;
+        runId: number;
+        loopId?: number;
+        turnId?: number;
+        sinceId?: number;
+        limit?: number;
+        loopSeq?: number;
+        turnSeq?: number;
+        sequence?: number;
+    }): Promise<LogEntryWire[]>;
+    listProviders(): {
+        aliases: Array<{
+            alias: string;
+            provider: string;
+            model: string;
+            active: boolean;
+            contextSize: number | null;
+        }>;
+    };
+    createSession(args: {
+        name?: string;
+        projectRoot?: string | null;
+        settings?: string;
+        constraints?: Array<{
+            effect: string;
+            glob: string;
+        }>;
+    }): Promise<ClientEnvelope>;
+    attachSession(args: {
+        sessionId: number;
+        runId?: number;
+        runName?: string;
+    }): Promise<ClientEnvelope>;
+    listSessions(): Promise<Array<{
+        id: number;
+        name: string;
+    }>>;
+    listRuns(sessionId: number): Promise<Array<{
+        id: number;
+        name: string;
+    }>>;
+}
+export interface ClientEnvelope {
+    sessionId: number;
+    sessionName: string;
+    projectRoot: string | null;
+    runId: number;
+    runName: string;
+    modelRunId: number | null;
+    clientLoopId: number | null;
+}
+//# sourceMappingURL=DaemonSeam.d.ts.map

package/dist/DaemonSeam.d.ts.map

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

package/dist/DaemonSeam.js

@@ -0,0 +1,7 @@
+// My coupling to the daemon's in-process client-interface seam (service#355). The
+// module depends on THIS interface — the committed, tested contract — never the
+// Daemon class's guts. It grows as the service lands hooks (loop-control,
+// session/envelope, reads, fork, execs/auth, the boot plug-point); today it carries
+// what's published: the event source (B) and proposal read + resolve (C + A-resolve).
+export {};
+//# sourceMappingURL=DaemonSeam.js.map

package/dist/DaemonSeam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DaemonSeam.js","sourceRoot":"","sources":["../src/DaemonSeam.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,gFAAgF;AAChF,0EAA0E;AAC1E,oFAAoF;AACpF,sFAAsF"}

package/dist/EventRouter.d.ts

@@ -0,0 +1,14 @@
+import type { AguiEvent } from "./types.ts";
+export default class EventRouter {
+    #private;
+    constructor(args: {
+        threadId: string;
+        runId: string;
+        modelRunId?: number | null;
+        sessionId?: number | null;
+    });
+    runStarted(snapshot?: unknown): AguiEvent[];
+    replay(entries: Array<Record<string, unknown>>): AguiEvent[];
+    route(method: string, params: unknown): AguiEvent[];
+}
+//# sourceMappingURL=EventRouter.d.ts.map

package/dist/EventRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventRouter.d.ts","sourceRoot":"","sources":["../src/EventRouter.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAgD,MAAM,YAAY,CAAC;AAE1F,MAAM,CAAC,OAAO,OAAO,WAAW;;IAG5B,YAAY,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAE3G;IAED,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,EAAE,CAAyC;IACpF,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EAAE,CAAoC;IAEhG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,CAUlD;CACJ"}

package/dist/EventRouter.js

@@ -0,0 +1,27 @@
+// The module's per-run render core (plurnk-agui#2). Routes a daemon event
+// (method, params) from the seam's event source → AG-UI events, composing the proven
+// projections: log/entry → core vocab, loop/terminated → RUN_FINISHED + budget STATE,
+// telemetry/stream → CUSTOM. Per-run state (turn tracking, model-run binding) lives in
+// the Translator. Proposals are ProposalHitl's domain (the terminate-resume tool-call),
+// so this router deliberately leaves loop/proposal to it — one owner per concern.
+import Translator from "./Translator.js";
+export default class EventRouter {
+    #t;
+    constructor(args) {
+        this.#t = new Translator(args);
+    }
+    runStarted(snapshot) { return this.#t.runStarted(snapshot); }
+    replay(entries) { return this.#t.replay(entries); }
+    route(method, params) {
+        switch (method) {
+            case "log/entry": return this.#t.logEntry(params);
+            case "loop/terminated": return this.#t.terminated(params);
+            case "telemetry/event": return this.#t.telemetry(params.event ?? params);
+            case "stream/event":
+            case "stream/concluded": return [{ type: "CUSTOM", name: "plurnk.stream", value: params }];
+            case "loop/proposal": return []; // ProposalHitl owns HITL (terminate-resume tool-call)
+            default: return []; // session/created + anything unmodeled: the module handles out-of-band
+        }
+    }
+}
+//# sourceMappingURL=EventRouter.js.map

package/dist/EventRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventRouter.js","sourceRoot":"","sources":["../src/EventRouter.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qFAAqF;AACrF,sFAAsF;AACtF,uFAAuF;AACvF,wFAAwF;AACxF,kFAAkF;AAElF,OAAO,UAAU,MAAM,iBAAiB,CAAC;AAGzC,MAAM,CAAC,OAAO,OAAO,WAAW;IAC5B,EAAE,CAAa;IAEf,YAAY,IAAgG;QACxG,IAAI,CAAC,EAAE,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,UAAU,CAAC,QAAkB,IAAiB,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,CAAC,OAAuC,IAAiB,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhG,KAAK,CAAC,MAAc,EAAE,MAAe;QACjC,QAAQ,MAAM,EAAE,CAAC;YACb,KAAK,WAAW,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,MAA8B,CAAC,CAAC;YAC1E,KAAK,iBAAiB,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAgC,CAAC,CAAC;YACpF,KAAK,iBAAiB,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC,SAAS,CAAE,MAA8B,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;YAClG,KAAK,cAAc,CAAC;YACpB,KAAK,kBAAkB,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3F,KAAK,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC,sDAAsD;YACvF,SAAS,OAAO,EAAE,CAAC,CAAC,uEAAuE;QAC/F,CAAC;IACL,CAAC;CACJ"}

package/dist/Module.d.ts

@@ -0,0 +1,23 @@
+import type { DaemonSeam } from "./DaemonSeam.ts";
+export interface ModuleOptions {
+    host: string;
+    port: number;
+    sessionPrefix: string;
+    token?: string;
+    maxTurns?: number;
+}
+export default class Module {
+    #private;
+    constructor(seam: DaemonSeam, opts: ModuleOptions);
+    static init(opts: ModuleOptions): (seam: DaemonSeam) => Promise<Module>;
+    listen(): Promise<{
+        host: string;
+        port: number;
+    }>;
+    address(): {
+        host: string;
+        port: number;
+    };
+    close(): Promise<void>;
+}
+//# sourceMappingURL=Module.d.ts.map

package/dist/Module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Module.d.ts","sourceRoot":"","sources":["../src/Module.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,iBAAiB,CAAC;AAGlE,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,CAAC,OAAO,OAAO,MAAM;;IAOvB,YAAY,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAKhD;IAGD,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAMtE;IAEK,MAAM,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAMtD;IAED,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAIxC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;CAwIJ"}