pantheon-opencode 1.4.2 → 1.5.0-beta.1

package/src/plugin.ts

@@ -12,6 +12,11 @@ import {
   DEFAULT_LIMITS as SANDBOX_DEFAULT_LIMITS,
 } from './pantheon/context-sandbox.ts'
 import { createCostCommand } from './pantheon/cost-command.ts'
+import {
+  buildPluginNativeDelegation,
+  resolveDelegateMode,
+  withDelegationKillSwitch,
+} from './pantheon/delegate-task-adapter.ts'
 import {
   collectRootSessionIDs,
   createDelegationTools,
@@ -118,6 +123,14 @@ setInterval(
 
 // ─── Phase 4: Read-Only Enforcement + Compaction Context ───────────────
 
+// WS1 (PR #94): root-session predicate shared by the Phase 4 enforcement
+// guard and the native delegate toolset — both must agree on what a root is.
+// (Hoisted function: `rootSessions`/`sessionHierarchy` below are resolved at
+// call time, after module init.)
+function isRootSession(sessionID: string): boolean {
+  return rootSessions.has(sessionID) || sessionHierarchy.isRoot(sessionID)
+}
+
 // The read-only registry is populated by createDelegationTools (delegation.ts)
 // when a delegate is read-only (explicit flag or agent ∈ readOnlyAgents).
 // The guard denies edit/write/bash/task inside those sessions by throwing
@@ -126,7 +139,7 @@ const enforcementGuard = createEnforcementGuard({
   getReadOnlySessions: () => readOnlyRegistry.sessionIDs(),
   options: {
     getSessionAgent: (sessionID) => sessionAgents.get(sessionID),
-    isRootSession: (sessionID) => rootSessions.has(sessionID) || sessionHierarchy.isRoot(sessionID),
+    isRootSession,
     isChildSession: (sessionID) => sessionHierarchy.isChild(sessionID),
     logger: log,
   },
@@ -359,9 +372,25 @@ const plugin: Plugin = async (input: PluginInput) => {
   const delegationBudgets = resolveDelegationBudgets()
   const wallClockTimeoutMs = resolveDelegationTimeoutMs()
 
-  const delegation = createDelegationTools({
+  // WS1 (PR #94): delegation backend gate. Default = legacy (the V1
+  // fire-and-forget toolset, intact); PANTHEON_DELEGATE_MODE=native selects
+  // the thin manager over native task() semantics. Kill-switch
+  // PANTHEON_DELEGATION=off covers BOTH modes (native guards internally;
+  // legacy via withDelegationKillSwitch). finalizeDelegation always stays on
+  // the legacy observer: it works on the shared board in both modes and must
+  // never be kill-switched, so children never orphan. The idle hook below is
+  // untouched.
+  const delegationClient = adaptDelegationClient(input.client)
+  // Only an explicitly active routing profile may provide child models.
+  // An empty map deliberately lets OpenCode inherit the parent model.
+  const routingAgentModels = loadRoutingAgentModels({
+    candidates: activePresetCandidates(),
+    logger: log,
+  })
+  const readOnlyAgents = new Set(['apollo', 'gaia'])
+  const legacyDelegation = createDelegationTools({
     board,
-    client: adaptDelegationClient(input.client),
+    client: delegationClient,
     options: {
       rootSessions,
       isChildSession: (sessionID) => sessionHierarchy.isChild(sessionID),
@@ -369,19 +398,37 @@ const plugin: Plugin = async (input: PluginInput) => {
         sessionHierarchy.register({ id: sessionID, parentID })
       },
       enforceRuntimeMatrix: true,
-      readOnlyAgents: new Set(['apollo', 'gaia']),
-      // Only an explicitly active routing profile may provide child models.
-      // An empty map deliberately lets OpenCode inherit the parent model.
-      agentModels: loadRoutingAgentModels({
-        candidates: activePresetCandidates(),
-        logger: log,
-      }),
+      readOnlyAgents,
+      agentModels: routingAgentModels,
       delegationBudgets,
       stepCapTracker,
       ...(routingPermissionTask != null ? { permissionTask: routingPermissionTask } : {}),
       ...(wallClockTimeoutMs !== undefined ? { wallClockTimeoutMs } : {}),
     },
   })
+  const delegateMode = resolveDelegateMode()
+  if (delegateMode === 'native') {
+    log.info('[Pantheon Plugin] Delegation mode: native (PANTHEON_DELEGATE_MODE=native)')
+  }
+  const delegation =
+    delegateMode === 'native'
+      ? buildPluginNativeDelegation({
+          board,
+          client: delegationClient,
+          isRootSession,
+          registerChildSession: (sessionID, parentID) => {
+            sessionHierarchy.register({ id: sessionID, parentID })
+          },
+          registerReadOnlySession: (sessionID, info) => {
+            readOnlyRegistry.register(sessionID, info)
+          },
+          readOnlyAgents,
+          agentModels: routingAgentModels,
+          stepCap: stepCapTracker,
+          ...(wallClockTimeoutMs !== undefined ? { wallClockTimeoutMs } : {}),
+          finalizeDelegation: legacyDelegation.finalizeDelegation,
+        })
+      : withDelegationKillSwitch(legacyDelegation)
 
   // Proactive idle-child scan (Fix 2): finalize children that are idle on the
   // board but have no MD report on disk — eliminates the phantom "running"

package/src/plugins/tui/dist/server.d.ts

@@ -14,4 +14,4 @@
 declare function server(): {};
 //#endregion
 export { server as default };
-//# sourceMappingURL=server.d.ts.map
+//# sourceMappingURL=server.d.ts.map

package/src/plugins/tui/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","names":[],"sources":["../src/server.ts"],"mappings":";;;;;;;;;;;;;iBAYwB"}
+{"version":3,"file":"server.d.ts","names":[],"sources":["../src/server.ts"],"mappings":";;;;;;;;;;;;;iBAYwB"}

package/src/plugins/tui/dist/server.js

@@ -17,4 +17,4 @@ function server() {
 //#endregion
 export { server as default };
 
-//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/src/plugins/tui/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","names":[],"sources":["../src/server.ts"],"sourcesContent":["/**\n * No-op server stub for the opencode plugin loader.\n *\n * The opencode plugin host requires every plugin (TUI included) to expose a\n * `server()` entry via `exports[\"./server\"]` (or package.json `main`). When\n * that entry is missing the host fails to attach the plugin's server half and\n * the TUI runtime never wires the reactive channel — the initial JSX mounts\n * but effects/refresh/events stay dead (the \"mudo panel\" symptom).\n *\n * This stub satisfies the loader contract; pantheon-tui is TUI-only and has\n * no background server work of its own.\n */\nexport default function server() {\n  return {}\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,SAAwB,SAAS;CAC/B,OAAO,CAAC;AACV"}
+{"version":3,"file":"server.js","names":[],"sources":["../src/server.ts"],"sourcesContent":["/**\n * No-op server stub for the opencode plugin loader.\n *\n * The opencode plugin host requires every plugin (TUI included) to expose a\n * `server()` entry via `exports[\"./server\"]` (or package.json `main`). When\n * that entry is missing the host fails to attach the plugin's server half and\n * the TUI runtime never wires the reactive channel — the initial JSX mounts\n * but effects/refresh/events stay dead (the \"mudo panel\" symptom).\n *\n * This stub satisfies the loader contract; pantheon-tui is TUI-only and has\n * no background server work of its own.\n */\nexport default function server() {\n  return {}\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,SAAwB,SAAS;CAC/B,OAAO,CAAC;AACV"}

package/src/plugins/tui/dist/tui.d.ts

@@ -22,7 +22,7 @@ type DelegationEntry = {
   read?: boolean;
   /** Internal provenance used to keep a finalized md report authoritative.
    *  'children-only' = a native task() child session with NO board report
-   *  (rendered with the distinct `[task]` tag); 'md' = board report wins. */
+   *  (rendered with the distinct `[native]` tag); 'md' = board report wins. */
   source?: 'child' | 'live' | 'md' | 'children-only';
 };
 /** Parse one delegation report md header into a structured entry.
@@ -59,7 +59,7 @@ declare function readAllDelegationEntries(root: string): Promise<DelegationEntry
 declare function resolveDelegationsDir(state: {
   directory?: string;
   worktree?: string;
-} | undefined, cwd?: string): string;
+} | undefined, cwd?: any): string;
 /** Project root derived from the delegations dir: `<root>/.pantheon/delegations`
  *  → `<root>`. Used to point the panel logger at the REAL hooks.log — passing
  *  the delegations dir (or its dirname) directly made createTuiLogger append
@@ -279,10 +279,12 @@ type ChildDelegationLike = {
  *  (fail-open: a freshly-seen child is assumed active; the 1s poll + md
  *  correct it as soon as terminal data exists). */
 declare function childStatusToState(status: string | undefined): 'running' | 'completed';
-/** Row tag for a delegation entry: `[task]` for native task() children
- *  (source 'children-only' — no board report), `[<alias>]` for board rows
- *  ([apo-1]). The panel renders the tag with a distinct style so native
- *  task() children are visually separable from pantheon_delegate jobs. */
+/** Row tag for a delegation entry: `[native]` for native task() children
+ *  (source 'children-only' — no board report), `[pantheon:<alias>]` for board
+ *  rows ([pantheon:apo-1]) — the same tags the manager prints in
+ *  pantheon_delegation_list, so panel rows and CLI list lines match. The
+ *  panel renders the tag with a distinct style so native task() children are
+ *  visually separable from pantheon_delegate jobs. */
 declare function delegationTag(entry: DelegationEntry): string;
 /** Turn child sessions (PRIMARY) enriched with md reports into the display
  *  list. One entry per child id (duplicates across re-fetches collapse).
@@ -293,7 +295,7 @@ declare function delegationTag(entry: DelegationEntry): string;
  *  time.created. A report-less child is a NATIVE task() child (every
  *  child of the current session — pantheon_delegate OR the native `task()`
  *  tool — carries parentID = caller), so it gets source 'children-only'
- *  and the `[task]` tag instead of a board alias.
+ *  and the `[native]` tag instead of a board alias.
  *  Terminal md state wins over the derived state; a running md defers to
  *  the child's live status. Sorted running-first (compareDelegationEntries).
  *  Pure — no I/O. */
@@ -319,6 +321,7 @@ type LiveDelegationStore = {
 };
 declare const plugin: TuiPluginModule & {
   id: string;
+  setup: () => Promise<void>;
 };
 //#endregion
 export { ChildDelegationLike, DelegationActivity, DelegationEntry, DelegationToolPart, IDLE_SILENCE_MS, LiveDelegationEntry, LiveDelegationStore, ParsedDelegationToolPart, STALE_RUNNING_THRESHOLD_MS, TuiSessionSources, buildChildrenPath, childStatusToState, childrenToDelegationEntries, collectDelegationToolParts, compareDelegationEntries, plugin as default, delegationActivity, delegationActivityLabel, delegationElapsed, delegationSpinnerFrame, delegationTag, fmtElapsed, isValidSessionId, markStaleIfRunning, mergeChildDelegationSources, mergeDelegationSources, navigateToDelegationSession, panelLogDir, parseDelegationMarkdown, parseDelegationToolPart, readAllDelegationEntries, readDelegationEntries, reduceDelegationToolPart, removeDelegationEntry, resolveCurrentSessionID, resolveDelegationsDir, safeSessionPath, seedLiveDelegationMap, toDelegationEntry, tuiLogPath, visibleDelegationList };

package/src/plugins/tui/dist/tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","names":[],"sources":["../src/index.tsx"],"mappings":";;KAo7BY;;EAEV;;EAEA;;;;EAIA;;EAEA;EACA;;EASA;;EAEA;EACA;EACA;;EAEA;;;;EAIA;;;;;;;;;;;iBAsBc,wBACd,aACA,oBACA,qBACC;;;;;;iBAkHmB,sBAAsB,cAAc,QAAQ;;;;;;;;iBAwC5C,yBAAyB,eAAe,QAAQ;;;;;;;;iBAWtD,sBACd;EAAS;EAAoB;eAC7B;;;;;;iBAYc,YAAY;;;iBAMZ,WAAW;;;;iBAOX,yBAAyB,GAAG,iBAAiB,GAAG;;;;;iBAWhD,sBACd,cAAc,mBACd,sBACA,cACA,4BACC;;cASU;;;;cAKA;;;;;;;;;iBAUG,mBACd,OAAO,iBACP,aACA,uBACC;;;iBAWa,WAAW;;;iBAcX,kBAAkB,OAAO,iBAAiB;;;KAQ9C;iBAQI,mBAAmB,OAAO,kBAAkB;iBAc5C,wBAAwB,OAAO;;iBAoB/B,uBAAuB;;;;;;;iBAWvB,4BACd,mBAAmB,mBACnB,eAAe,wBACd;;KAmFS;EACV;EACA;EACA;EACA;EACA;EACA;IACE;IACA,QAAQ;IACR;IACA;IACA;MAAS;MAAgB;;;;;KAKjB;;EAEV;;EAEA;;EAEA;EACA;;EAEA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;;EAEA;;;KAIU;EACV;EACA;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;iBAac,wBACd,MAAM,oBACN,eACC;;;iBA+Ea,yBACd,KAAK,YAAY,sBACjB,MAAM,oBACN;;;iBA+Fc,sBACd,KAAK,YAAY,sBACjB;;;;;;iBAiBc,2BACd;EAAqB;EAAa;iBAClC,YAAY,uDACX;;;;;iBA2Ba,sBACd,KAAK,YAAY,sBACjB,gBAAgB,sBAChB;;;iBAWc,kBAAkB,MAAM,sBAAsB;;;;;;iBAqB9C,uBACd,eAAe,uBACf,aAAa,oBACZ;;;;;;;;;iBA8Da,iBAAiB,cAAc;;;;KAOnC;;EAEV;EACA;;IAEE;MAAU;;;IAEV;MAAU;QAAY;QAAe,SAAS;;;;;;;;;;iBASlC,wBAAwB,SAAS;;;;;;;;iBAmBjC,gBAAgB;EAAgB;IAAQ;;;;;;;iBASxC,kBAAkB;EAAkC;IAAQ;;;;KAKhE;;EAEV;;EAEA;;;EAGA;;;EAGA;EACA;IACE;IACA;;;;;;;iBAQY,mBAAmB;;;;;iBASnB,cAAc,OAAO;;;;;;;;;;;;;;iBAiBrB,4BACd,mBAAmB,mCACnB,aAAa,mBACb,eACC;;;;;;iBA0Ca,4BACd;EAAS,YAAY,cAAc,SAAS;eAC5C;;;;;KAiLU;EACV,KAAK,YAAY;;EAEjB;;EAEA;;cAucI,QAAQ;EAAoB"}
+{"version":3,"file":"tui.d.ts","names":[],"sources":["../src/index.tsx"],"mappings":";;KAo7BY;;EAEV;;EAEA;;;;EAIA;;EAEA;EACA;;EASA;;EAEA;EACA;EACA;;EAEA;;;;EAIA;;;;;;;;;;;iBAsBc,wBACd,aACA,oBACA,qBACC;;;;;;iBAkHmB,sBAAsB,cAAc,QAAQ;;;;;;;;iBAwC5C,yBAAyB,eAAe,QAAQ;;;;;;;;iBAWtD,sBACd;EAAS;EAAoB;eAC7B;;;;;;iBAYc,YAAY;;;iBAMZ,WAAW;;;;iBAOX,yBAAyB,GAAG,iBAAiB,GAAG;;;;;iBAWhD,sBACd,cAAc,mBACd,sBACA,cACA,4BACC;;cASU;;;;cAKA;;;;;;;;;iBAUG,mBACd,OAAO,iBACP,aACA,uBACC;;;iBAWa,WAAW;;;iBAcX,kBAAkB,OAAO,iBAAiB;;;KAQ9C;iBAQI,mBAAmB,OAAO,kBAAkB;iBAc5C,wBAAwB,OAAO;;iBAoB/B,uBAAuB;;;;;;;iBAWvB,4BACd,mBAAmB,mBACnB,eAAe,wBACd;;KAmFS;EACV;EACA;EACA;EACA;EACA;EACA;IACE;IACA,QAAQ;IACR;IACA;IACA;MAAS;MAAgB;;;;;KAKjB;;EAEV;;EAEA;;EAEA;EACA;;EAEA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;;EAEA;;;KAIU;EACV;EACA;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;iBAac,wBACd,MAAM,oBACN,eACC;;;iBA+Ea,yBACd,KAAK,YAAY,sBACjB,MAAM,oBACN;;;iBA+Fc,sBACd,KAAK,YAAY,sBACjB;;;;;;iBAiBc,2BACd;EAAqB;EAAa;iBAClC,YAAY,uDACX;;;;;iBA2Ba,sBACd,KAAK,YAAY,sBACjB,gBAAgB,sBAChB;;;iBAWc,kBAAkB,MAAM,sBAAsB;;;;;;iBAqB9C,uBACd,eAAe,uBACf,aAAa,oBACZ;;;;;;;;;iBA8Da,iBAAiB,cAAc;;;;KAOnC;;EAEV;EACA;;IAEE;MAAU;;;IAEV;MAAU;QAAY;QAAe,SAAS;;;;;;;;;;iBASlC,wBAAwB,SAAS;;;;;;;;iBAmBjC,gBAAgB;EAAgB;IAAQ;;;;;;;iBASxC,kBAAkB;EAAkC;IAAQ;;;;KAKhE;;EAEV;;EAEA;;;EAGA;;;EAGA;EACA;IACE;IACA;;;;;;;iBAQY,mBAAmB;;;;;;;iBAWnB,cAAc,OAAO;;;;;;;;;;;;;;iBAiBrB,4BACd,mBAAmB,mCACnB,aAAa,mBACb,eACC;;;;;;iBA0Ca,4BACd;EAAS,YAAY,cAAc,SAAS;eAC5C;;;;;KAiLU;EACV,KAAK,YAAY;;EAEjB;;EAEA;;cAucI,QAAQ;EAAoB;EAAY,aAAa"}

package/src/plugins/tui/dist/tui.js

@@ -164,7 +164,7 @@ async function detectVersion(api) {
 			if (ver) return ver;
 		}
 	} catch {}
-	return "1.4.2";
+	return "1.5.0";
 }
 /**
 * usage-bar — AI subscription usage gauge for the opencode TUI.
@@ -1311,12 +1311,14 @@ function childStatusToState(status) {
 	if (status === "idle") return "completed";
 	return "running";
 }
-/** Row tag for a delegation entry: `[task]` for native task() children
-*  (source 'children-only' — no board report), `[<alias>]` for board rows
-*  ([apo-1]). The panel renders the tag with a distinct style so native
-*  task() children are visually separable from pantheon_delegate jobs. */
+/** Row tag for a delegation entry: `[native]` for native task() children
+*  (source 'children-only' — no board report), `[pantheon:<alias>]` for board
+*  rows ([pantheon:apo-1]) — the same tags the manager prints in
+*  pantheon_delegation_list, so panel rows and CLI list lines match. The
+*  panel renders the tag with a distinct style so native task() children are
+*  visually separable from pantheon_delegate jobs. */
 function delegationTag(entry) {
-	return entry.source === "children-only" ? "[task]" : `[${entry.alias}]`;
+	return entry.source === "children-only" ? "[native]" : `[pantheon:${entry.alias}]`;
 }
 /** Turn child sessions (PRIMARY) enriched with md reports into the display
 *  list. One entry per child id (duplicates across re-fetches collapse).
@@ -1327,7 +1329,7 @@ function delegationTag(entry) {
 *  time.created. A report-less child is a NATIVE task() child (every
 *  child of the current session — pantheon_delegate OR the native `task()`
 *  tool — carries parentID = caller), so it gets source 'children-only'
-*  and the `[task]` tag instead of a board alias.
+*  and the `[native]` tag instead of a board alias.
 *  Terminal md state wins over the derived state; a running md defers to
 *  the child's live status. Sorted running-first (compareDelegationEntries).
 *  Pure — no I/O. */
@@ -1871,7 +1873,8 @@ const tui = (api, _options, _meta) => {
 };
 const plugin = {
 	id: "pantheon.tui",
-	tui
+	tui,
+	setup: async () => {}
 };
 //#endregion
 export { IDLE_SILENCE_MS, STALE_RUNNING_THRESHOLD_MS, buildChildrenPath, childStatusToState, childrenToDelegationEntries, collectDelegationToolParts, compareDelegationEntries, plugin as default, delegationActivity, delegationActivityLabel, delegationElapsed, delegationSpinnerFrame, delegationTag, fmtElapsed, isValidSessionId, markStaleIfRunning, mergeChildDelegationSources, mergeDelegationSources, navigateToDelegationSession, panelLogDir, parseDelegationMarkdown, parseDelegationToolPart, readAllDelegationEntries, readDelegationEntries, reduceDelegationToolPart, removeDelegationEntry, resolveCurrentSessionID, resolveDelegationsDir, safeSessionPath, seedLiveDelegationMap, toDelegationEntry, tuiLogPath, visibleDelegationList };

package/src/plugins/tui/dist/tui.js.map

@@ -1 +1 @@
-{"version":3,"file":"tui.js","names":[],"sources":[],"mappings":""}
+{"version":3,"file":"tui.js","names":[],"sources":[],"mappings":""}

package/src/plugins/tui/dist/tui.tsx

@@ -892,18 +892,18 @@ async function setupUsageBar(api: TuiPluginApi) {
  *      (`client.session.children` + `session.parentID === current`).
  *      Live status comes from `api.state.session.status(childID)`
  *      (busy/retry → running; idle → terminal). This does NOT depend on
- *      tool-part events, which runtime 1.18.13 may not deliver for
- *      pantheon_delegate (the "(0) even while delegating" symptom).
+ *  tool-part events, which runtime 1.18.13 may not deliver for
+ *  pantheon_delegate (the "(0) even while delegating" symptom).
  *
  *   1b. NATIVE task() CHILDREN — `session.children` returns ALL children,
  *      and the native `task()` tool ALSO spawns a child session with
  *      parentID = caller. A child WITHOUT a board report is a native
  *      task() child: childrenToDelegationEntries tags it source
- *      'children-only' with the `[task]` row tag (distinct info color),
+ *      'children-only' with the `[native]` row tag (distinct info color),
  *      so native task() work is visible in the panel alongside board
- *      delegates ([apo-1]) — never filtered out, never duplicated with a
- *      board row for the same child (a child WITH a report keeps the md
- *      entry, source 'md').
+ *      delegates ([pantheon:apo-1]) — never filtered out, never duplicated
+ *      with a board row for the same child (a child WITH a report keeps the
+ *      md entry, source 'md').
  *
  *   2. ENRICHMENT + HISTORY — markdown reports the job board persists under
  *      `.pantheon/delegations/<sessionID>/<alias>.md` (written by
@@ -975,7 +975,7 @@ export type DelegationEntry = {
   read?: boolean
   /** Internal provenance used to keep a finalized md report authoritative.
    *  'children-only' = a native task() child session with NO board report
-   *  (rendered with the distinct `[task]` tag); 'md' = board report wins. */
+   *  (rendered with the distinct `[native]` tag); 'md' = board report wins. */
   source?: 'child' | 'live' | 'md' | 'children-only'
 }
 
@@ -1885,12 +1885,14 @@ export function childStatusToState(status: string | undefined): 'running' | 'com
   return 'running' // busy, retry, or unknown
 }
 
-/** Row tag for a delegation entry: `[task]` for native task() children
- *  (source 'children-only' — no board report), `[<alias>]` for board rows
- *  ([apo-1]). The panel renders the tag with a distinct style so native
- *  task() children are visually separable from pantheon_delegate jobs. */
+/** Row tag for a delegation entry: `[native]` for native task() children
+ *  (source 'children-only' — no board report), `[pantheon:<alias>]` for board
+ *  rows ([pantheon:apo-1]) — the same tags the manager prints in
+ *  pantheon_delegation_list, so panel rows and CLI list lines match. The
+ *  panel renders the tag with a distinct style so native task() children are
+ *  visually separable from pantheon_delegate jobs. */
 export function delegationTag(entry: DelegationEntry): string {
-  return entry.source === 'children-only' ? '[task]' : `[${entry.alias}]`
+  return entry.source === 'children-only' ? '[native]' : `[pantheon:${entry.alias}]`
 }
 
 /** Turn child sessions (PRIMARY) enriched with md reports into the display
@@ -1902,7 +1904,7 @@ export function delegationTag(entry: DelegationEntry): string {
  *  time.created. A report-less child is a NATIVE task() child (every
  *  child of the current session — pantheon_delegate OR the native `task()`
  *  tool — carries parentID = caller), so it gets source 'children-only'
- *  and the `[task]` tag instead of a board alias.
+ *  and the `[native]` tag instead of a board alias.
  *  Terminal md state wins over the derived state; a running md defers to
  *  the child's live status. Sorted running-first (compareDelegationEntries).
  *  Pure — no I/O. */
@@ -2092,8 +2094,8 @@ function DelegationRow(props: {
     }
   })
 
-  // The row tag: `[task]` for native task() children (no board report),
-  // `[apo-1]`-style alias for pantheon_delegate board rows. Rendered with
+  // The row tag: `[native]` for native task() children (no board report),
+  // `[pantheon:apo-1]`-style alias for pantheon_delegate board rows. Rendered with
   // the info color so task() children are visually distinct from delegates.
   const tagColor = createMemo(() => (props.job.source === 'children-only' ? theme().info : color()))
 
@@ -2591,9 +2593,13 @@ const tui: TuiPlugin = (api, _options, _meta) => {
   })
 }
 
-const plugin: TuiPluginModule & { id: string } = {
+const plugin: TuiPluginModule & { id: string; setup: () => Promise<void> } = {
   id: 'pantheon.tui',
   tui,
+  // Beta loader contract: every `plugins` directory entry must expose a
+  // no-op `setup` so the entry loads as `pantheon.tui` with zero errors
+  // (sandbox probe evidence). The TUI itself boots via `tui()`.
+  setup: async () => {},
 }
 
 export default plugin

package/src/plugins/tui/package-lock.json

@@ -1,18 +1,18 @@
 {
   "name": "pantheon-tui",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pantheon-tui",
-      "version": "1.4.1",
+      "version": "1.5.0",
       "license": "MIT",
       "dependencies": {
         "@opencode-ai/plugin": ">=1.14.0",
-        "@opentui/core": ">=0.4.5",
-        "@opentui/solid": ">=0.4.5",
-        "solid-js": ">=1.9.0"
+        "@opentui/core": ">=0.5.10",
+        "@opentui/solid": ">=0.5.10",
+        "solid-js": ">=1.9.12"
       },
       "devDependencies": {
         "rolldown-plugin-solid": "^0.2.1",
@@ -21,9 +21,9 @@
       "peerDependencies": {
         "@opencode-ai/plugin": ">=1.14.0",
         "@opencode-ai/sdk": ">=1.14.0",
-        "@opentui/core": ">=0.4.5",
-        "@opentui/solid": ">=0.4.5",
-        "solid-js": ">=1.9.0"
+        "@opentui/core": ">=0.5.10",
+        "@opentui/solid": ">=0.5.10",
+        "solid-js": ">=1.9.12"
       }
     },
     "node_modules/@ai-sdk/provider": {
@@ -660,35 +660,35 @@
       }
     },
     "node_modules/@opentui/core": {
-      "version": "0.4.5",
-      "resolved": "https://registry.npmjs.org/@opentui/core/-/core-0.4.5.tgz",
-      "integrity": "sha512-JsgRTPkA6e+Vxmumxai6SElOSlRQkbzNKHlCfemlArRiLhfC1IZ9RXJo2QH4xSu+uBOWAM90uss73/pPlkdEig==",
+      "version": "0.5.10",
+      "resolved": "https://registry.npmjs.org/@opentui/core/-/core-0.5.10.tgz",
+      "integrity": "sha512-C3a2UbmefeAjIxAgm4BqjuSxKT4oqutfvYFwVvUgMxmGRHkNbBc/s7sukV0JgwcxFcV3uMFrXxo+E+BQtvuOiw==",
       "license": "MIT",
       "dependencies": {
-        "bun-ffi-structs": "0.2.4",
+        "bun-ffi-structs": "0.3.1",
         "diff": "9.0.0",
         "marked": "17.0.1",
         "string-width": "7.2.0",
         "strip-ansi": "7.1.2"
       },
       "optionalDependencies": {
-        "@opentui/core-darwin-arm64": "0.4.5",
-        "@opentui/core-darwin-x64": "0.4.5",
-        "@opentui/core-linux-arm64": "0.4.5",
-        "@opentui/core-linux-arm64-musl": "0.4.5",
-        "@opentui/core-linux-x64": "0.4.5",
-        "@opentui/core-linux-x64-musl": "0.4.5",
-        "@opentui/core-win32-arm64": "0.4.5",
-        "@opentui/core-win32-x64": "0.4.5"
+        "@opentui/core-darwin-arm64": "0.5.10",
+        "@opentui/core-darwin-x64": "0.5.10",
+        "@opentui/core-linux-arm64": "0.5.10",
+        "@opentui/core-linux-arm64-musl": "0.5.10",
+        "@opentui/core-linux-x64": "0.5.10",
+        "@opentui/core-linux-x64-musl": "0.5.10",
+        "@opentui/core-win32-arm64": "0.5.10",
+        "@opentui/core-win32-x64": "0.5.10"
       },
       "peerDependencies": {
         "web-tree-sitter": "0.25.10"
       }
     },
     "node_modules/@opentui/core-darwin-arm64": {
-      "version": "0.4.5",
-      "resolved": "https://registry.npmjs.org/@opentui/core-darwin-arm64/-/core-darwin-arm64-0.4.5.tgz",
-      "integrity": "sha512-8KUG0oRidnR+oW1RSZJ72/PhZLl+qRRMk5U/mieF4c0SJ5V3tYACpBZAKzQfHNd1f7QzD8FHZct1lPpQgtmkWg==",
+      "version": "0.5.10",
+      "resolved": "https://registry.npmjs.org/@opentui/core-darwin-arm64/-/core-darwin-arm64-0.5.10.tgz",
+      "integrity": "sha512-Vyb+nTbhab8ZcRy5gg1loEEGwRcIbjAeVRIBfHBcbFDqmITBOg7x2gqJ+x/TnoOy4uwMhCmICUN2wiyREw3r1Q==",
       "cpu": [
         "arm64"
       ],
@@ -699,9 +699,9 @@
       ]
     },
     "node_modules/@opentui/core-darwin-x64": {
-      "version": "0.4.5",
-      "resolved": "https://registry.npmjs.org/@opentui/core-darwin-x64/-/core-darwin-x64-0.4.5.tgz",
-      "integrity": "sha512-R2bocsg55gwjOqCp/MWFgFYzRmsduKegB6nzgFAPCvAD/L5Jf30xpWJWFlSg3x8vxe1L9WJ84dfqa4M7mZZ3wA==",
+      "version": "0.5.10",
+      "resolved": "https://registry.npmjs.org/@opentui/core-darwin-x64/-/core-darwin-x64-0.5.10.tgz",
+      "integrity": "sha512-tTFLcM7Oj1gTyhm/bUdAt3C6grZdCxPk6+/g2azcZBUlI3/62LwbeRS6HbQKFFmm+1fUmX8cq6kWrtul885mVg==",
       "cpu": [
         "x64"
       ],
@@ -712,9 +712,9 @@
       ]
     },
     "node_modules/@opentui/core-linux-arm64": {
-      "version": "0.4.5",
-      "resolved": "https://registry.npmjs.org/@opentui/core-linux-arm64/-/core-linux-arm64-0.4.5.tgz",
-      "integrity": "sha512-R4MZ25a4CzOAGVjW9aj1hUfzQGVfCJwrwBDbNs2SXaIvzcZqkxCVtU4FoQ5LsaD0j/BdNQVg2CIfFkFsm1fDuQ==",
+      "version": "0.5.10",
+      "resolved": "https://registry.npmjs.org/@opentui/core-linux-arm64/-/core-linux-arm64-0.5.10.tgz",
+      "integrity": "sha512-ncJXcgudhBf2GdJyF3xVQN/Ec+1F7GOL+pRrURmgBYSj2v1w6EyoDQFAACtPTK2c3R38W6fvZwL4JSLlm4EFXQ==",
       "cpu": [
         "arm64"
       ],
@@ -725,9 +725,9 @@
       ]
     },
     "node_modules/@opentui/core-linux-arm64-musl": {
-      "version": "0.4.5",
-      "resolved": "https://registry.npmjs.org/@opentui/core-linux-arm64-musl/-/core-linux-arm64-musl-0.4.5.tgz",
-      "integrity": "sha512-ieqdyKI6EIYPalYAETB2wsdP83hr5Ifi+dFnBFUmdEEFHsoKwBmn2S7bsTOYlX7Bg03F4/YPIg+IvRpeC+cUJw==",
+      "version": "0.5.10",
+      "resolved": "https://registry.npmjs.org/@opentui/core-linux-arm64-musl/-/core-linux-arm64-musl-0.5.10.tgz",
+      "integrity": "sha512-dGMphDKexSdeYqwl0wgoFBP88Ta/cdi1Zc1mk29/ENkSCGz+74zlCHgqTHRNGLmI8W5TfuUtCyktQH11/Z+TBQ==",
       "cpu": [
         "arm64"
       ],
@@ -738,9 +738,9 @@
       ]
     },
     "node_modules/@opentui/core-linux-x64": {
-      "version": "0.4.5",
-      "resolved": "https://registry.npmjs.org/@opentui/core-linux-x64/-/core-linux-x64-0.4.5.tgz",
-      "integrity": "sha512-SNyuQoxMKI1vuJhgxSSW96adWM6LqFl2SoS3GM4tGeneGOanVVG2Y06PvlytXvF4cKik97t0rqkVMRetmOs93w==",
+      "version": "0.5.10",
+      "resolved": "https://registry.npmjs.org/@opentui/core-linux-x64/-/core-linux-x64-0.5.10.tgz",
+      "integrity": "sha512-5qtYaOgwVycZD1GaGshTRsi0rXPAmVExO03N1JQaHu+NYxK/vXSOc7Bu4QW0sPXx3Sp0SpzpP+FHjXABfoK66g==",
       "cpu": [
         "x64"
       ],
@@ -751,9 +751,9 @@
       ]
     },
     "node_modules/@opentui/core-linux-x64-musl": {
-      "version": "0.4.5",
-      "resolved": "https://registry.npmjs.org/@opentui/core-linux-x64-musl/-/core-linux-x64-musl-0.4.5.tgz",
-      "integrity": "sha512-mKVKcIcPiSVVZZsdPSBoWwoa2/TCeQAaMDeHF7PFw2kt5bTXZPP7xxWfRQLCNIcA1eaGl59UuwUWHDR2Ve548Q==",
+      "version": "0.5.10",
+      "resolved": "https://registry.npmjs.org/@opentui/core-linux-x64-musl/-/core-linux-x64-musl-0.5.10.tgz",
+      "integrity": "sha512-Oj4H9hApuvuTKPWxh4SoZAgGJorR7vbvnrZA/cAkSMAk2VGSoHRRcqeXQbcH8IcdjVZ0KFpv8Zkl/D5Ye+2mew==",
       "cpu": [
         "x64"
       ],
@@ -764,9 +764,9 @@
       ]
     },
     "node_modules/@opentui/core-win32-arm64": {
-      "version": "0.4.5",
-      "resolved": "https://registry.npmjs.org/@opentui/core-win32-arm64/-/core-win32-arm64-0.4.5.tgz",
-      "integrity": "sha512-GHTTsqeR45q2Iek9Rb7ty+x/hAKn2jZ1ujlCgPR8LBKyF7h0E1dNFryoZ7ehMc3kJndP1sKn836IemKFqxuDdQ==",
+      "version": "0.5.10",
+      "resolved": "https://registry.npmjs.org/@opentui/core-win32-arm64/-/core-win32-arm64-0.5.10.tgz",
+      "integrity": "sha512-A9VhgvTxQoUdZ+8LmUumEng1sQNbj9QQQT3NYG9mSxI54qTANi7vOWNSphMiY6RMVsr22pgm6nUvSSvJXv7Jog==",
       "cpu": [
         "arm64"
       ],
@@ -777,9 +777,9 @@
       ]
     },
     "node_modules/@opentui/core-win32-x64": {
-      "version": "0.4.5",
-      "resolved": "https://registry.npmjs.org/@opentui/core-win32-x64/-/core-win32-x64-0.4.5.tgz",
-      "integrity": "sha512-Y8T/yXCDGagRGiQrtmuB6AhRcPucKFs/Dre3v8kJwNYqDccI4FzUPKclZ7djfmRZNjl7JUqPhZZP/PwDpQocMg==",
+      "version": "0.5.10",
+      "resolved": "https://registry.npmjs.org/@opentui/core-win32-x64/-/core-win32-x64-0.5.10.tgz",
+      "integrity": "sha512-u3KHa7kEeWrmKVDRJYpxSGO+g5E9cMGlrmTsPN3GVPHUmQMiREUawLXUvsU8+IHaQnqG3Q5nuE1yf4fPBzS+Qw==",
       "cpu": [
         "x64"
       ],
@@ -790,14 +790,14 @@
       ]
     },
     "node_modules/@opentui/solid": {
-      "version": "0.4.5",
-      "resolved": "https://registry.npmjs.org/@opentui/solid/-/solid-0.4.5.tgz",
-      "integrity": "sha512-B0RSkXnrtPVfEJOX+Hj+axjLJ3lzbG1BZw5I7Pvb9OPp48Vzg2cW2a3cSa86/q48ndLt647i/XwFPIw/jqnI5g==",
+      "version": "0.5.10",
+      "resolved": "https://registry.npmjs.org/@opentui/solid/-/solid-0.5.10.tgz",
+      "integrity": "sha512-KrmMIsHiKBHOABTC0brOwqWm+sGq1ZX2sGCAx6WgtBbE3STMup9n8TAy/6gUYhwcjC9zugT53ytfSVwCwVWZUg==",
       "license": "MIT",
       "dependencies": {
         "@babel/core": "7.28.0",
         "@babel/preset-typescript": "7.27.1",
-        "@opentui/core": "0.4.5",
+        "@opentui/core": "0.5.10",
         "babel-plugin-module-resolver": "5.0.2",
         "babel-preset-solid": "1.9.12",
         "entities": "7.0.1",
@@ -1568,9 +1568,9 @@
       }
     },
     "node_modules/bun-ffi-structs": {
-      "version": "0.2.4",
-      "resolved": "https://registry.npmjs.org/bun-ffi-structs/-/bun-ffi-structs-0.2.4.tgz",
-      "integrity": "sha512-AJzsqoVFs1KBbJbWHIYrVZLDC3NhTqqh25awRXqzoLzmBAKr5oqk6+CwuYHAekKx+VBCYVohBoKuRq40dV+TYg==",
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/bun-ffi-structs/-/bun-ffi-structs-0.3.1.tgz",
+      "integrity": "sha512-3gM7PpVWLyrwxWjcilSiGuhWanhZivvo6l0u573NziPH6f/gwk6McbaYgn7oJWov6pKGRTDbrg94W5DcJsKTtQ==",
       "license": "MIT",
       "peerDependencies": {
         "typescript": "^5"

package/src/plugins/tui/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pantheon-tui",
   "type": "module",
-  "version": "1.4.2",
+  "version": "1.5.0-beta.1",
   "description": "Pantheon TUI plugin — sidebar (version, preset, sessions, real-time delegations) + AI subscription usage gauges incl. OpenCode Go/Zen dollar limits (vendored, MIT)",
   "license": "MIT",
   "exports": {
@@ -19,9 +19,9 @@
   "peerDependencies": {
     "@opencode-ai/plugin": ">=1.14.0",
     "@opencode-ai/sdk": ">=1.14.0",
-    "@opentui/core": ">=0.4.5",
-    "@opentui/solid": ">=0.4.5",
-    "solid-js": ">=1.9.0"
+    "@opentui/core": ">=0.5.10",
+    "@opentui/solid": ">=0.5.10",
+    "solid-js": ">=1.9.12"
   },
   "devDependencies": {
     "rolldown-plugin-solid": "^0.2.1",
@@ -29,8 +29,8 @@
   },
   "dependencies": {
     "@opencode-ai/plugin": ">=1.14.0",
-    "@opentui/core": ">=0.4.5",
-    "@opentui/solid": ">=0.4.5",
-    "solid-js": ">=1.9.0"
+    "@opentui/core": ">=0.5.10",
+    "@opentui/solid": ">=0.5.10",
+    "solid-js": ">=1.9.12"
   }
 }