@xenosystem/blocks 0.9.1 → 0.10.0

package/dist/agent/host-source.d.ts

@@ -1,4 +1,4 @@
-import { X as XenoAgentSessionDelta, a as XenoAgentEvent } from '../types-C5T3uVwd.js';
+import { X as XenoAgentSessionDelta, a as XenoAgentEvent } from '../types-CaBV2_q8.js';
 
 /**
  * The reference adapter: XENO Agent host runtime events → this panel's `session` input.

package/dist/agent/index.d.ts

@@ -1,7 +1,8 @@
-import { PanelModule, PanelManifest } from '@xenosystem/block-sdk';
-import { a as XenoAgentEvent, b as XenoAgentTurnState, A as AgentViewState, X as XenoAgentSessionDelta, c as XenoAgentCatalog, d as XenoAgentConnection, e as AgentPanelState } from '../types-C5T3uVwd.js';
-export { f as XenoAgentAskEvent, g as XenoAgentAskWithdrawEvent, h as XenoAgentError, i as XenoAgentIntent, j as XenoAgentLane, k as XenoAgentMessageEvent, l as XenoAgentModel, m as XenoAgentPatchEvent, n as XenoAgentPatchFile, o as XenoAgentProvider, p as XenoAgentRole, q as XenoAgentSession, r as XenoAgentSessionClosedEvent, s as XenoAgentSessionEvent, t as XenoAgentStatus, u as XenoAgentTerminalEvent, v as XenoAgentToolEvent, w as XenoAgentTurnEvent, x as isBusy, y as isWaitingOnUser } from '../types-C5T3uVwd.js';
+import { PanelModule, PanelManifest, BlockDeclaration } from '@xenosystem/block-sdk';
+import { a as XenoAgentEvent, b as XenoAgentTurnState, A as AgentViewState, X as XenoAgentSessionDelta, c as XenoAgentCatalog, d as XenoAgentConnection, e as AgentPanelState, f as XenoAgentLane } from '../types-CaBV2_q8.js';
+export { g as XenoAgentAskEvent, h as XenoAgentAskWithdrawEvent, i as XenoAgentError, j as XenoAgentIntent, k as XenoAgentMessageEvent, l as XenoAgentModel, m as XenoAgentPatchEvent, n as XenoAgentPatchFile, o as XenoAgentProvider, p as XenoAgentRole, q as XenoAgentSession, r as XenoAgentSessionClosedEvent, s as XenoAgentSessionEvent, t as XenoAgentStatus, u as XenoAgentTerminalEvent, v as XenoAgentToolEvent, w as XenoAgentTurnEvent, x as isBusy, y as isWaitingOnUser } from '../types-CaBV2_q8.js';
 import { ReactNode } from 'react';
+import { PanelTone } from '@xenosystem/components/chrome';
 
 /**
  * The translation: ONE agent session-event stream → the canonical panels that already render it.
@@ -554,15 +555,105 @@ declare function countChanges(hunks: readonly XenoDiffHunk[]): {
 /** Props for {@link AgentPanelView}. */
 interface AgentPanelViewProps {
     controller: AgentController;
-    /** Enter submits, Shift+Enter newlines. `false` swaps them. */
     submitOnEnter?: boolean;
-    /** Render the lane badge. */
     showLane?: boolean;
-    /** Render the session switcher. */
     showSessions?: boolean;
     emptyHint?: string;
 }
-/** The view. */
+/**
+ * The code view of the agent block. It renders the SAME view model the declaration binds
+ * (`agentPanelView` in `../declaration`), so the two cannot drift: labels, tones, row shapes and
+ * placeholders are decided once. `test/agent-agent/declaration.test.tsx` holds the markup equal.
+ */
 declare function AgentPanelView({ controller, submitOnEnter, showLane, showSessions, emptyHint, }: AgentPanelViewProps): ReactNode;
 
-export { AGENT_CATALOG_SCHEMA, AGENT_FANOUT_PORTS, AGENT_INTENT_SCHEMA, AGENT_PANEL_ID, AGENT_PANEL_WIRING, AGENT_SESSION_SCHEMA, AGENT_WIRING_TARGETS, AgentController, type AgentControllerOptions, type AgentEmission, type AgentFanoutPort, type AgentHostBridge, AgentPanelState, AgentPanelView, type AgentPanelViewProps, AgentProjector, type AgentProjectorOptions, type AgentRenderContext, AgentViewState, type AgentWire, type AgentWireEnd, CONSENT_ELICITATION_RESULT_SCHEMA, CONSENT_ELICITATION_SCHEMA, type CreateAgentPanelOptions, XenoAgentCatalog, XenoAgentConnection, XenoAgentEvent, XenoAgentSessionDelta, XenoAgentTurnState, type XenoDiffHunk, type XenoDiffLine, type XenoDiffLineKind, agentManifest, agentPanel, countChanges, createAgentPanel, parseUnifiedDiff, turnStatusToRunStatus, wiringFor };
+/**
+ * The agent panel AS A DECLARATION — the second block written the way `xeno-apps/SPEC.md` §8d says every
+ * block is (the auth gate was the first): chrome units + bindings + emits, with ONE behaviour
+ * (`agent/agentPanelView`) for the only logic the view has — labels, tones and row shapes derived from
+ * `AgentViewState`. The code view (`AgentPanelView`) and this declaration render the same panel from the
+ * same behaviour; `test/agent-agent/declaration.test.tsx` holds them equal in every connection/turn state.
+ *
+ * Where the state lives: the block's `AgentController` is its runtime — it consumes the host ports
+ * (`session`, `catalog`, `status`, …) and derives `AgentViewState`. The declaration is the PRESENTATION of
+ * that state: input `view` (an `AgentViewState` push), output `ui` (`{ kind, id?, draft? }`), which the
+ * controller applies (`newSession`, `selectSession`, `selectProvider`, `setDraft`, `submit`, `steer`,
+ * `cancel`). The declaration holds no state of its own — a draft keystroke is a `ui` emit and comes back
+ * as `view.draft`, which is exactly how the auth gate's intents round-trip.
+ *
+ * Node-valued props (`{ node: … }`, block-sdk 0.3.0) carry the toolbar sides, the row trailers and the
+ * status bar — the parts chrome units take as element props rather than children.
+ */
+
+type AgentUiIntent = {
+    kind: 'newSession';
+} | {
+    kind: 'selectSession';
+    id: string;
+} | {
+    kind: 'selectProvider';
+    id: string;
+} | {
+    kind: 'setDraft';
+    draft: string;
+} | {
+    kind: 'submit';
+} | {
+    kind: 'steer';
+} | {
+    kind: 'cancel';
+};
+/** The manifest the declaration validates against — the agent panel's id, its PRESENTATION ports. */
+declare const agentViewManifest: PanelManifest;
+declare const LANE_LABEL: Record<XenoAgentLane, string>;
+declare const TURN: Record<XenoAgentTurnState, {
+    label: string;
+    tone: PanelTone;
+}>;
+interface AgentPanelViewModel {
+    failed: boolean;
+    connecting: boolean;
+    empty: boolean;
+    ready: boolean;
+    failedHint: string;
+    emptyHint: string;
+    turnLabel: string;
+    turnTone: PanelTone;
+    lane?: string;
+    waiting?: string;
+    showSessions: boolean;
+    sessions: {
+        id: string;
+        label: string;
+        selected: boolean;
+        turnLabel: string;
+    }[];
+    showProviders: boolean;
+    providers: {
+        id: string;
+        label: string;
+        meta?: string;
+        disabled: boolean;
+        selected: boolean;
+    }[];
+    draft: string;
+    placeholder: string;
+    status?: string;
+    busy: boolean;
+    idle: boolean;
+    canSubmit: boolean;
+    cannotSubmit: boolean;
+    submitKind: 'submit' | 'steer';
+}
+interface AgentPanelViewOptions {
+    showLane?: boolean;
+    showSessions?: boolean;
+    emptyHint?: string;
+}
+declare function agentPanelView(state: AgentViewState, options?: AgentPanelViewOptions): AgentPanelViewModel;
+declare const BEHAVIOURS: {
+    'agent/agentPanelView': (inputs: Record<string, unknown>, config: Readonly<Record<string, unknown>>) => AgentPanelViewModel;
+};
+declare const AGENT_DECLARATION: BlockDeclaration;
+
+export { AGENT_CATALOG_SCHEMA, AGENT_DECLARATION, AGENT_FANOUT_PORTS, AGENT_INTENT_SCHEMA, AGENT_PANEL_ID, AGENT_PANEL_WIRING, AGENT_SESSION_SCHEMA, AGENT_WIRING_TARGETS, AgentController, type AgentControllerOptions, type AgentEmission, type AgentFanoutPort, type AgentHostBridge, AgentPanelState, AgentPanelView, type AgentPanelViewModel, type AgentPanelViewOptions, type AgentPanelViewProps, AgentProjector, type AgentProjectorOptions, type AgentRenderContext, type AgentUiIntent, AgentViewState, type AgentWire, type AgentWireEnd, BEHAVIOURS, CONSENT_ELICITATION_RESULT_SCHEMA, CONSENT_ELICITATION_SCHEMA, type CreateAgentPanelOptions, LANE_LABEL, TURN, XenoAgentCatalog, XenoAgentConnection, XenoAgentEvent, XenoAgentLane, XenoAgentSessionDelta, XenoAgentTurnState, type XenoDiffHunk, type XenoDiffLine, type XenoDiffLineKind, agentManifest, agentPanel, agentPanelView, agentViewManifest, countChanges, createAgentPanel, parseUnifiedDiff, turnStatusToRunStatus, wiringFor };

package/dist/agent/index.js

@@ -1037,6 +1037,8 @@ var agentManifest = {
 import { useSyncExternalStore } from "react";
 import {
   Badge,
+  Column,
+  Composer,
   EmptyState,
   Row,
   RowList,
@@ -1047,12 +1049,19 @@ import {
   Toolbar,
   ToolbarGroup
 } from "@xenosystem/components/chrome";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-var LANE_LABEL = {
-  cloud: "Cloud",
-  local: "Local",
-  acp: "ACP"
+
+// src/agent/agent/declaration.ts
+var agentViewManifest = {
+  id: AGENT_PANEL_ID,
+  version: "1.0.0",
+  title: "Agent",
+  category: "agent",
+  layout: { slot: "main" },
+  inputs: [{ id: "view", type: "object", label: "View state", description: "The AgentViewState the controller derives from the host ports." }],
+  outputs: [{ id: "ui", type: "object", label: "UI intent", description: "{ kind, id?, draft? } \u2014 applied by the controller." }],
+  commands: []
 };
+var LANE_LABEL = { cloud: "Cloud", local: "Local", acp: "ACP" };
 var TURN = {
   idle: { label: "Idle", tone: "neutral" },
   queued: { label: "Queued", tone: "neutral" },
@@ -1063,18 +1072,157 @@ var TURN = {
   failed: { label: "Failed", tone: "error" },
   cancelled: { label: "Cancelled", tone: "neutral" }
 };
-var COLUMN = { display: "flex", flexDirection: "column", height: "100%", minHeight: 0 };
-var COMPOSER = {
-  width: "100%",
-  minHeight: 64,
-  resize: "vertical",
-  background: "transparent",
-  color: "inherit",
-  border: "none",
-  outline: "none",
-  font: "inherit",
-  padding: "8px 10px"
+function agentPanelView(state, options = {}) {
+  const showLane = options.showLane ?? true;
+  const showSessions = options.showSessions ?? true;
+  const turn = TURN[state.turn];
+  const lane = state.activeProvider?.lane;
+  return {
+    failed: state.connection === "failed",
+    connecting: state.connection === "connecting",
+    empty: state.connection !== "failed" && state.connection !== "connecting" && state.sessions.length === 0,
+    ready: state.connection !== "failed" && state.connection !== "connecting" && state.sessions.length > 0,
+    failedHint: state.message ?? "The agent host reported a failure.",
+    emptyHint: options.emptyHint ?? "Start a session to talk to an agent.",
+    turnLabel: turn.label,
+    turnTone: turn.tone,
+    lane: showLane && lane ? LANE_LABEL[lane] ?? lane : void 0,
+    waiting: state.pendingAsks > 0 ? `${state.pendingAsks} waiting` : void 0,
+    showSessions,
+    sessions: state.sessions.map((s) => ({ id: s.id, label: s.title ?? s.id, selected: s.id === state.active?.id, turnLabel: TURN[s.turn ?? "idle"].label })),
+    showProviders: state.providers.length > 1,
+    providers: state.providers.map((p) => ({
+      id: p.id,
+      label: p.label,
+      meta: p.unavailable ?? (showLane ? LANE_LABEL[p.lane] ?? p.lane : void 0),
+      disabled: p.unavailable !== void 0,
+      selected: p.id === state.activeProvider?.id
+    })),
+    draft: state.draft,
+    placeholder: state.busy ? "Steer the running turn\u2026" : "Ask the agent\u2026",
+    status: state.message ?? state.active?.cwd ?? void 0,
+    busy: state.busy,
+    idle: !state.busy,
+    canSubmit: state.canSubmit,
+    cannotSubmit: !state.canSubmit,
+    submitKind: state.busy ? "steer" : "submit"
+  };
+}
+var EMPTY_VIEW = { sessions: [], active: null, turn: "idle", connection: "connecting", message: null, providers: [], activeProvider: null, activeModelId: null, draft: "", canSubmit: false, busy: false, pendingAsks: 0 };
+var BEHAVIOURS = {
+  "agent/agentPanelView": (inputs, config) => agentPanelView(inputs.view ?? EMPTY_VIEW, {
+    showLane: typeof config.showLane === "boolean" ? config.showLane : void 0,
+    showSessions: typeof config.showSessions === "boolean" ? config.showSessions : void 0,
+    emptyHint: typeof config.emptyHint === "string" ? config.emptyHint : void 0
+  })
+};
+var ui = (kind) => ({ emit: "ui", value: { object: { kind: { value: kind } } } });
+var uiWithItem = (kind) => ({ emit: "ui", value: { object: { kind: { value: kind }, id: { item: "id" } } } });
+var newSessionButton = { component: "chrome/TextButton", on: { onClick: ui("newSession") }, children: [{ component: "text", props: { text: { value: "New session" } } }] };
+var AGENT_DECLARATION = {
+  format: "xeno.block@1",
+  manifest: agentViewManifest,
+  behaviour: "agent/agentPanelView",
+  composition: {
+    component: "fragment",
+    children: [
+      { component: "chrome/EmptyState", when: { input: "view.failed" }, props: { title: { value: "Not connected" }, hint: { input: "view.failedHint" } } },
+      { component: "chrome/EmptyState", when: { input: "view.connecting" }, props: { title: { value: "Connecting\u2026" }, hint: { value: "Waiting for the agent host." } } },
+      {
+        component: "chrome/Column",
+        when: { input: "view.empty" },
+        children: [
+          { component: "chrome/EmptyState", props: { title: { value: "No sessions" }, hint: { input: "view.emptyHint" } } },
+          { component: "chrome/Toolbar", props: { right: { node: { component: "chrome/ToolbarGroup", props: { end: { value: true } }, children: [newSessionButton] } } } }
+        ]
+      },
+      {
+        component: "chrome/Column",
+        when: { input: "view.ready" },
+        children: [
+          {
+            component: "chrome/Toolbar",
+            props: {
+              left: {
+                node: {
+                  component: "chrome/ToolbarGroup",
+                  children: [
+                    { component: "chrome/StatusBadge", props: { tone: { input: "view.turnTone" } }, children: [{ component: "text", props: { text: { input: "view.turnLabel" } } }] },
+                    { component: "chrome/Badge", when: { input: "view.lane" }, children: [{ component: "text", props: { text: { input: "view.lane" } } }] },
+                    { component: "chrome/Badge", when: { input: "view.waiting" }, children: [{ component: "text", props: { text: { input: "view.waiting" } } }] }
+                  ]
+                }
+              },
+              right: { node: { component: "chrome/ToolbarGroup", props: { end: { value: true } }, children: [newSessionButton] } }
+            }
+          },
+          {
+            component: "chrome/ScrollArea",
+            when: { input: "view.showSessions" },
+            children: [
+              {
+                component: "chrome/RowList",
+                children: [
+                  {
+                    component: "chrome/Row",
+                    each: { input: "view.sessions", key: "id" },
+                    props: {
+                      noIcon: { value: true },
+                      label: { item: "label" },
+                      selected: { item: "selected" },
+                      trailing: { node: { component: "chrome/Badge", children: [{ component: "text", props: { text: { item: "turnLabel" } } }] } }
+                    },
+                    on: { onClick: uiWithItem("selectSession") }
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            component: "chrome/RowList",
+            when: { input: "view.showProviders" },
+            children: [
+              {
+                component: "chrome/Row",
+                each: { input: "view.providers", key: "id" },
+                props: { noIcon: { value: true }, label: { item: "label" }, meta: { item: "meta" }, disabled: { item: "disabled" }, selected: { item: "selected" } },
+                on: { onClick: uiWithItem("selectProvider") }
+              }
+            ]
+          },
+          {
+            component: "chrome/Composer",
+            props: { value: { input: "view.draft" }, placeholder: { input: "view.placeholder" } },
+            on: {
+              onChange: { emit: "ui", value: { object: { kind: { value: "setDraft" }, draft: { arg: "" } } } },
+              onSubmit: { emit: "ui", value: { object: { kind: { input: "view.submitKind" } } } }
+            }
+          },
+          {
+            component: "chrome/StatusBar",
+            props: {
+              left: { input: "view.status" },
+              right: {
+                node: {
+                  component: "chrome/ToolbarGroup",
+                  props: { end: { value: true } },
+                  children: [
+                    { component: "chrome/TextButton", when: { input: "view.busy" }, on: { onClick: ui("steer") }, children: [{ component: "text", props: { text: { value: "Steer" } } }] },
+                    { component: "chrome/TextButton", when: { input: "view.busy" }, on: { onClick: ui("cancel") }, children: [{ component: "text", props: { text: { value: "Stop" } } }] },
+                    { component: "chrome/TextButton", when: { input: "view.idle" }, props: { disabled: { input: "view.cannotSubmit" } }, on: { onClick: ui("submit") }, children: [{ component: "text", props: { text: { value: "Send" } } }] }
+                  ]
+                }
+              }
+            }
+          }
+        ]
+      }
+    ]
+  }
 };
+
+// src/agent/agent/react/AgentPanelView.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
 function AgentPanelView({
   controller,
   submitOnEnter = true,
@@ -1083,96 +1231,74 @@ function AgentPanelView({
   emptyHint
 }) {
   const state = useSyncExternalStore(controller.subscribe, controller.getState, controller.getState);
-  if (state.connection === "failed") {
-    return /* @__PURE__ */ jsx(ErrorPane, { message: state.message });
-  }
-  if (state.connection === "connecting") {
-    return /* @__PURE__ */ jsx(EmptyState, { title: "Connecting\u2026", hint: "Waiting for the agent host." });
-  }
-  if (state.sessions.length === 0) {
-    return /* @__PURE__ */ jsxs("div", { style: COLUMN, children: [
-      /* @__PURE__ */ jsx(EmptyState, { title: "No sessions", hint: emptyHint ?? "Start a session to talk to an agent." }),
-      /* @__PURE__ */ jsx(
-        Toolbar,
-        {
-          right: /* @__PURE__ */ jsx(ToolbarGroup, { end: true, children: /* @__PURE__ */ jsx(TextButton, { onClick: () => controller.newSession(), children: "New session" }) })
-        }
-      )
+  const v = agentPanelView(state, { showLane, showSessions, emptyHint });
+  if (v.failed) return /* @__PURE__ */ jsx(EmptyState, { title: "Not connected", hint: v.failedHint });
+  if (v.connecting) return /* @__PURE__ */ jsx(EmptyState, { title: "Connecting\u2026", hint: "Waiting for the agent host." });
+  const newSession = /* @__PURE__ */ jsx(ToolbarGroup, { end: true, children: /* @__PURE__ */ jsx(TextButton, { onClick: () => controller.newSession(), children: "New session" }) });
+  if (v.empty) {
+    return /* @__PURE__ */ jsxs(Column, { children: [
+      /* @__PURE__ */ jsx(EmptyState, { title: "No sessions", hint: v.emptyHint }),
+      /* @__PURE__ */ jsx(Toolbar, { right: newSession })
     ] });
   }
-  const turn = TURN[state.turn];
-  const lane = state.activeProvider?.lane;
-  return /* @__PURE__ */ jsxs("div", { style: COLUMN, children: [
+  return /* @__PURE__ */ jsxs(Column, { children: [
     /* @__PURE__ */ jsx(
       Toolbar,
       {
         left: /* @__PURE__ */ jsxs(ToolbarGroup, { children: [
-          /* @__PURE__ */ jsx(StatusBadge, { tone: turn.tone, children: turn.label }),
-          showLane && lane ? /* @__PURE__ */ jsx(Badge, { children: LANE_LABEL[lane] ?? lane }) : null,
-          state.pendingAsks > 0 ? /* @__PURE__ */ jsx(Badge, { children: `${state.pendingAsks} waiting` }) : null
+          /* @__PURE__ */ jsx(StatusBadge, { tone: v.turnTone, children: v.turnLabel }),
+          v.lane ? /* @__PURE__ */ jsx(Badge, { children: v.lane }) : null,
+          v.waiting ? /* @__PURE__ */ jsx(Badge, { children: v.waiting }) : null
         ] }),
-        right: /* @__PURE__ */ jsx(ToolbarGroup, { end: true, children: /* @__PURE__ */ jsx(TextButton, { onClick: () => controller.newSession(), children: "New session" }) })
+        right: newSession
       }
     ),
-    showSessions ? /* @__PURE__ */ jsx(ScrollArea, { children: /* @__PURE__ */ jsx(RowList, { children: state.sessions.map((session) => /* @__PURE__ */ jsx(
+    v.showSessions ? /* @__PURE__ */ jsx(ScrollArea, { children: /* @__PURE__ */ jsx(RowList, { children: v.sessions.map((session) => /* @__PURE__ */ jsx(
       Row,
       {
         noIcon: true,
-        label: session.title ?? session.id,
-        selected: session.id === state.active?.id,
+        label: session.label,
+        selected: session.selected,
         onClick: () => controller.selectSession(session.id),
-        trailing: /* @__PURE__ */ jsx(Badge, { children: TURN[session.turn ?? "idle"].label })
+        trailing: /* @__PURE__ */ jsx(Badge, { children: session.turnLabel })
       },
       session.id
     )) }) }) : null,
-    state.providers.length > 1 ? /* @__PURE__ */ jsx(RowList, { children: state.providers.map((provider) => /* @__PURE__ */ jsx(
+    v.showProviders ? /* @__PURE__ */ jsx(RowList, { children: v.providers.map((provider) => /* @__PURE__ */ jsx(
       Row,
       {
         noIcon: true,
         label: provider.label,
-        meta: provider.unavailable ?? (showLane ? LANE_LABEL[provider.lane] ?? provider.lane : void 0),
-        disabled: provider.unavailable !== void 0,
-        selected: provider.id === state.activeProvider?.id,
+        meta: provider.meta,
+        disabled: provider.disabled,
+        selected: provider.selected,
         onClick: () => controller.selectProvider(provider.id)
       },
       provider.id
     )) }) : null,
     /* @__PURE__ */ jsx(
-      "textarea",
+      Composer,
       {
-        style: COMPOSER,
-        value: state.draft,
-        placeholder: state.busy ? "Steer the running turn\u2026" : "Ask the agent\u2026",
-        onChange: (event) => controller.setDraft(event.target.value),
-        onKeyDown: (event) => {
-          if (event.key !== "Enter") return;
-          const wantsSubmit = submitOnEnter ? !event.shiftKey : event.shiftKey;
-          if (!wantsSubmit) return;
-          event.preventDefault();
-          if (state.busy) controller.steer();
-          else controller.submit();
-        }
+        value: v.draft,
+        placeholder: v.placeholder,
+        submitOnEnter,
+        onChange: (draft) => controller.setDraft(draft),
+        onSubmit: () => v.busy ? controller.steer() : controller.submit()
       }
     ),
     /* @__PURE__ */ jsx(
       StatusBar,
       {
-        left: state.message ?? state.active?.cwd ?? void 0,
-        right: /* @__PURE__ */ jsx(ToolbarGroup, { end: true, children: state.busy ? /* @__PURE__ */ jsxs(Fragment, { children: [
-          /* @__PURE__ */ jsx(TextButton, { onClick: () => controller.steer(), children: "Steer" }),
-          /* @__PURE__ */ jsx(TextButton, { onClick: () => controller.cancel(), children: "Stop" })
-        ] }) : (
-          // `disabled` derives from the SAME predicate `submit()` enforces, so an enabled
-          // button can never be a button that refuses.
-          /* @__PURE__ */ jsx(TextButton, { disabled: !state.canSubmit, onClick: () => controller.submit(), children: "Send" })
-        ) })
+        left: v.status,
+        right: /* @__PURE__ */ jsxs(ToolbarGroup, { end: true, children: [
+          v.busy ? /* @__PURE__ */ jsx(TextButton, { onClick: () => controller.steer(), children: "Steer" }) : null,
+          v.busy ? /* @__PURE__ */ jsx(TextButton, { onClick: () => controller.cancel(), children: "Stop" }) : null,
+          v.idle ? /* @__PURE__ */ jsx(TextButton, { disabled: v.cannotSubmit, onClick: () => controller.submit(), children: "Send" }) : null
+        ] })
       }
     )
   ] });
 }
-function ErrorPane({ message }) {
-  return /* @__PURE__ */ jsx(EmptyState, { title: "Not connected", hint: message ?? "The agent host reported a failure." });
-}
 
 // src/agent/agent/panel.ts
 var CONNECTIONS = ["idle", "connecting", "ready", "failed"];
@@ -1416,6 +1542,7 @@ function wiringFor(panelId) {
 }
 export {
   AGENT_CATALOG_SCHEMA,
+  AGENT_DECLARATION,
   AGENT_FANOUT_PORTS,
   AGENT_INTENT_SCHEMA,
   AGENT_PANEL_ID,
@@ -1425,10 +1552,15 @@ export {
   AgentController,
   AgentPanelView,
   AgentProjector,
+  BEHAVIOURS,
   CONSENT_ELICITATION_RESULT_SCHEMA,
   CONSENT_ELICITATION_SCHEMA,
+  LANE_LABEL,
+  TURN,
   agentManifest,
   agentPanel,
+  agentPanelView,
+  agentViewManifest,
   countChanges,
   createAgentPanel,
   isBusy,

package/dist/{types-C5T3uVwd.d.ts → types-CaBV2_q8.d.ts}

@@ -422,4 +422,4 @@ declare function isBusy(turn: XenoAgentTurnState): boolean;
  */
 declare function isWaitingOnUser(turn: XenoAgentTurnState): boolean;
 
-export { type AgentViewState as A, type XenoAgentSessionDelta as X, type XenoAgentEvent as a, type XenoAgentTurnState as b, type XenoAgentCatalog as c, type XenoAgentConnection as d, type AgentPanelState as e, type XenoAgentAskEvent as f, type XenoAgentAskWithdrawEvent as g, type XenoAgentError as h, type XenoAgentIntent as i, type XenoAgentLane as j, type XenoAgentMessageEvent as k, type XenoAgentModel as l, type XenoAgentPatchEvent as m, type XenoAgentPatchFile as n, type XenoAgentProvider as o, type XenoAgentRole as p, type XenoAgentSession as q, type XenoAgentSessionClosedEvent as r, type XenoAgentSessionEvent as s, type XenoAgentStatus as t, type XenoAgentTerminalEvent as u, type XenoAgentToolEvent as v, type XenoAgentTurnEvent as w, isBusy as x, isWaitingOnUser as y };
+export { type AgentViewState as A, type XenoAgentSessionDelta as X, type XenoAgentEvent as a, type XenoAgentTurnState as b, type XenoAgentCatalog as c, type XenoAgentConnection as d, type AgentPanelState as e, type XenoAgentLane as f, type XenoAgentAskEvent as g, type XenoAgentAskWithdrawEvent as h, type XenoAgentError as i, type XenoAgentIntent as j, type XenoAgentMessageEvent as k, type XenoAgentModel as l, type XenoAgentPatchEvent as m, type XenoAgentPatchFile as n, type XenoAgentProvider as o, type XenoAgentRole as p, type XenoAgentSession as q, type XenoAgentSessionClosedEvent as r, type XenoAgentSessionEvent as s, type XenoAgentStatus as t, type XenoAgentTerminalEvent as u, type XenoAgentToolEvent as v, type XenoAgentTurnEvent as w, isBusy as x, isWaitingOnUser as y };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xenosystem/blocks",
-  "version": "0.9.1",
-  "description": "XENO Blocks \u2014 rung 3 of the front ladder: components composed into a contract-bearing unit (manifest: ports, intents, commands, agent surface), rendered by @xenosystem/workbench. ONE package, one subpath per family (/auth, /edit, /data, /time, /ops, /trust, /agent), one named export per block \u2014 XENO PACKAGE NAMING - STANDARD.md.",
+  "version": "0.10.0",
+  "description": "XENO Blocks — rung 3 of the front ladder: components composed into a contract-bearing unit (manifest: ports, intents, commands, agent surface), rendered by @xenosystem/workbench. ONE package, one subpath per family (/auth, /edit, /data, /time, /ops, /trust, /agent), one named export per block — XENO PACKAGE NAMING - STANDARD.md.",
   "license": "UNLICENSED",
   "type": "module",
   "sideEffects": false,
@@ -58,38 +58,38 @@
     "test": "vitest run"
   },
   "peerDependencies": {
-    "@xenosystem/components": ">=0.9.0 <1",
+    "@duckdb/duckdb-wasm": ">=1.28.0",
+    "@xenosystem/block-sdk": "^0.3.0",
+    "@xenosystem/components": ">=0.9.2 <1",
+    "@xenosystem/data-core": "^0.1.0",
     "@xenosystem/elements-react": ">=0.0.1",
-    "@xenosystem/workbench": "^1.0.0",
-    "react": ">=18.0.0",
-    "react-dom": ">=18.0.0",
-    "@xenosystem/block-sdk": "^0.2.0",
+    "@xenosystem/time-core": "^0.1.0",
     "@xenosystem/tree-core": "^0.1.0",
-    "@xterm/xterm": ">=5.5.0",
+    "@xenosystem/workbench": "^1.0.0",
     "@xterm/addon-fit": ">=0.10.0",
-    "@xenosystem/time-core": "^0.1.0",
-    "@xenosystem/data-core": "^0.1.0",
-    "@duckdb/duckdb-wasm": ">=1.28.0"
+    "@xterm/xterm": ">=5.5.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
-    "@xenosystem/components": "^0.9.0",
+    "@xenosystem/block-sdk": "^0.3.1",
+    "@xenosystem/components": "^0.9.2",
+    "@xenosystem/data-core": "^0.1.0",
     "@xenosystem/elements-react": "0.0.1",
-    "@xenosystem/workbench": "^1.2.0",
+    "@xenosystem/time-core": "^0.1.0",
+    "@xenosystem/tree-core": "^0.1.0",
+    "@xenosystem/workbench": "^1.2.1",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/xterm": "^6.0.0",
     "jsdom": "^26.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
-    "vitest": "^4.1.0",
-    "@xenosystem/block-sdk": "^0.2.0",
-    "@xenosystem/tree-core": "^0.1.0",
-    "@xterm/xterm": "^6.0.0",
-    "@xterm/addon-fit": "^0.11.0",
-    "@xenosystem/time-core": "^0.1.0",
-    "@xenosystem/data-core": "^0.1.0"
+    "vitest": "^4.1.0"
   },
   "publishConfig": {
     "access": "public"