@xenosystem/agent-interface-panel 0.1.27 → 0.1.28

package/dist/index.d.ts

@@ -40,10 +40,37 @@
  */
 import type { PanelModule } from '@xenosystem/panel-sdk';
 import type { AgentHostClient } from '@xenosystem/agent-interface-client';
-/** Options for {@link createXenoAgentInterfacePanel}. */
+/**
+ * The platform bridge, structurally. Deliberately not `XenoAPI`: a panel host implements the
+ * capabilities the interface reaches and refuses the rest by name, so demanding the full type
+ * here would put back exactly the barrier this panel exists to remove.
+ */
+export type AgentPlatformBridgeLike = object;
+/**
+ * Options for {@link createXenoAgentInterfacePanel} — supply EITHER a client or a bridge.
+ *
+ * 🔴 **Two mount modes, because hosts differ in a way that is a security boundary, not a
+ * preference.**
+ *
+ * | mode | supply | for |
+ * |---|---|---|
+ * | **client** | `createClient` | a host that already holds an `AgentHostClient` — Hub, Shell, the Agent app |
+ * | **bridge** | `createBridge` | a PANEL host, which does not and must not |
+ *
+ * `AgentHostClient` takes a `transport` with a generic `request(method, input)`, so supplying one
+ * means the renderer can invoke ANY of the 141 host methods — `workspace.file.write`,
+ * `workspace.command.run`, every `workspace.pty.*` verb. That is fine in the Agent app, whose
+ * renderer is its own. It is not fine in a panel host, whose renderer runs user-authored panels.
+ * `xeno-apps`'s preload says so in its own words: the asymmetry "is the whole security design".
+ *
+ * ⚠️ The bridge mode exists because it was MEASURED to be sufficient, not assumed. Mounting the
+ * real interface against a recording bridge showed it reaches `workspace`, `agentContext` and
+ * `subagents` — platform-bridge members, not client methods — and it renders from a bridge alone.
+ * The client is the embed lifecycle; the component reads the bridge.
+ */
 export interface CreateXenoAgentInterfacePanelOptions {
     /**
-     * Build the client this panel mounts against.
+     * Build the client this panel mounts against — the EMBED path.
      *
      * 🔴 A FACTORY, not a client. A panel can be mounted more than once in one layout and can be
      * closed and reopened without the host restarting; sharing a single client across those
@@ -51,7 +78,16 @@ export interface CreateXenoAgentInterfacePanelOptions {
      *
      * The client's `surface` must be `'panel-embed'` or the embed layer refuses the mount.
      */
-    createClient: () => AgentHostClient | Promise<AgentHostClient>;
+    createClient?: () => AgentHostClient | Promise<AgentHostClient>;
+    /**
+     * Build the platform bridge this panel mounts against — the PANEL path, and the one a panel host
+     * should use.
+     *
+     * A factory for the same reason `createClient` is one. Returning `null` means this surface has no
+     * agent host, which is the ordinary state of a machine: the panel renders its own empty state
+     * rather than the host failing to start.
+     */
+    createBridge?: () => AgentPlatformBridgeLike | null | Promise<AgentPlatformBridgeLike | null>;
     /** Called when a mount fails, so a host can surface it rather than showing an empty tile. */
     onError?: (error: unknown) => void;
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAezE,yDAAyD;AACzD,MAAM,WAAW,oCAAoC;IACnD;;;;;;;;OAQG;IACH,YAAY,EAAE,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC9D,6FAA6F;IAC7F,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC;AAED,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,EAAG,aAAsB,CAAA;AAEzD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,oCAAoC,GAC5C,WAAW,CAsDb"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAOzE;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAA;AAc5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,oCAAoC;IACnD;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC/D;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,uBAAuB,GAAG,IAAI,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAA;IAC7F,6FAA6F;IAC7F,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC;AAED,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,EAAG,aAAsB,CAAA;AAEzD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,oCAAoC,GAC5C,WAAW,CAiFb"}

package/dist/index.js

@@ -42,7 +42,7 @@ import { createElement } from 'react';
 import { createRoot } from 'react-dom/client';
 import { createAgentPanel } from '@xenosystem/panel-agent';
 import { mountXenoAgentInterface } from '@xenosystem/agent-interface-embed';
-import { XenoAgentInterface } from '@xenosystem/agent-interface-ui';
+import { XenoAgentInterface, configureAgentPlatformBridge, } from '@xenosystem/agent-interface-ui';
 /*
  * ⚠️ The cast is not laziness. `AgentInterface` declares its props parameter as OPTIONAL —
  * `(props?: AgentInterfaceProps)` — and `createElement` narrows such a component to `{}`, so
@@ -67,6 +67,8 @@ export function createXenoAgentInterfacePanel(options) {
         render(el) {
             let handle = null;
             let root = null;
+            /* Restores whatever bridge was installed before this mount — a panel can be mounted twice. */
+            let restoreBridge = null;
             /*
              * 🔴 Disposal can be requested BEFORE the mount resolves, and a panel closed during its own
              * startup is an ordinary thing in a dockable layout — drag a tile away while it is opening.
@@ -76,6 +78,29 @@ export function createXenoAgentInterfacePanel(options) {
             let disposed = false;
             void (async () => {
                 try {
+                    /*
+                     * The BRIDGE path first, because it is the one a panel host should take: configure the
+                     * platform bridge and render the interface directly. No AgentHostClient, so no generic
+                     * `request(method, input)`, so the host never has to widen its renderer's authority to
+                     * all 141 host methods in order to draw a panel.
+                     */
+                    if (options.createBridge) {
+                        const bridge = await options.createBridge();
+                        if (disposed)
+                            return;
+                        if (!bridge) {
+                            // No agent host on this machine — the ordinary state. The panel shows its own empty
+                            // state rather than the host treating a missing optional agent as a failure.
+                            return;
+                        }
+                        restoreBridge = configureAgentPlatformBridge(bridge);
+                        root = createRoot(el);
+                        root.render(createElement(AgentInterfaceComponent, { surface: 'embedded' }));
+                        return;
+                    }
+                    if (!options.createClient) {
+                        throw new Error('createXenoAgentInterfacePanel needs either createBridge or createClient.');
+                    }
                     const client = await options.createClient();
                     const mounted = await mountXenoAgentInterface(el, {
                         surface: AGENT_PANEL_SURFACE,
@@ -112,6 +137,8 @@ export function createXenoAgentInterfacePanel(options) {
                 handle = null;
                 root?.unmount();
                 root = null;
+                restoreBridge?.();
+                restoreBridge = null;
             };
         },
     });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,aAAa,EAA0B,MAAM,OAAO,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,EAAE,uBAAuB,EAAsC,MAAM,mCAAmC,CAAA;AAE/G,OAAO,EAAE,kBAAkB,EAA4B,MAAM,gCAAgC,CAAA;AAE7F;;;;;;;;;GASG;AACH,MAAM,uBAAuB,GAAG,kBAA4D,CAAA;AAkB5F,6CAA6C;AAC7C,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAsB,CAAA;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAA6C;IAE7C,OAAO,gBAAgB,CAAC;QACtB,MAAM,CAAC,EAAe;YACpB,IAAI,MAAM,GAAyC,IAAI,CAAA;YACvD,IAAI,IAAI,GAAgB,IAAI,CAAA;YAC5B;;;;;eAKG;YACH,IAAI,QAAQ,GAAG,KAAK,CAAA;YAEpB,KAAK,CAAC,KAAK,IAAI,EAAE;gBACf,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAA;oBAC3C,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,EAAE,EAAE;wBAChD,OAAO,EAAE,mBAAmB;wBAC5B,MAAM;wBACN,QAAQ,EAAE;4BACR,KAAK,CAAC,SAAsB;gCAC1B;;;;mCAIG;gCACH,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;gCAC5B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,uBAAuB,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;4BAC9E,CAAC;4BACD,OAAO;gCACL,IAAI,EAAE,OAAO,EAAE,CAAA;gCACf,IAAI,GAAG,IAAI,CAAA;4BACb,CAAC;yBACF;qBACF,CAAC,CAAA;oBACF,IAAI,QAAQ,EAAE,CAAC;wBACb,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;wBACvB,OAAM;oBACR,CAAC;oBACD,MAAM,GAAG,OAAO,CAAA;gBAClB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;gBAC1B,CAAC;YACH,CAAC,CAAC,EAAE,CAAA;YAEJ,OAAO,GAAG,EAAE;gBACV,QAAQ,GAAG,IAAI,CAAA;gBACf,KAAK,MAAM,EAAE,OAAO,EAAE,CAAA;gBACtB,MAAM,GAAG,IAAI,CAAA;gBACb,IAAI,EAAE,OAAO,EAAE,CAAA;gBACf,IAAI,GAAG,IAAI,CAAA;YACb,CAAC,CAAA;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xenosystem/agent-interface-panel",
-  "version": "0.1.27",
+  "version": "0.1.28",
   "license": "UNLICENSED",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,10 +24,10 @@
   },
   "dependencies": {
     "@xenosystem/panel-agent": "^0.1.0",
-    "@xenosystem/agent-interface-client": "0.1.27",
-    "@xenosystem/agent-interface-ui": "0.1.27",
-    "@xenosystem/agent-interface-contract": "0.1.27",
-    "@xenosystem/agent-interface-embed": "0.1.27"
+    "@xenosystem/agent-interface-client": "0.1.28",
+    "@xenosystem/agent-interface-contract": "0.1.28",
+    "@xenosystem/agent-interface-embed": "0.1.28",
+    "@xenosystem/agent-interface-ui": "0.1.28"
   },
   "peerDependencies": {
     "@xenosystem/panel-sdk": "^1.1.0",