@xenosystem/agent-interface-panel 0.1.26

package/LICENSE

@@ -0,0 +1,67 @@
+XENO Agent — Proprietary Software License
+Copyright © 2026 XENO Corporation. All rights reserved.
+
+This software, including its source code, compiled binaries, published packages,
+assets, and accompanying documentation (collectively, the "Software"), is the
+proprietary and confidential property of XENO Corporation ("XENO"). The Software
+is licensed for use, not sold, and no title to or ownership of the Software is
+transferred to any user.
+
+1. GRANT OF USE
+   Subject to a separate written agreement and/or the terms of service published
+   at https://xenostudio.ai, XENO grants the end user a limited, non-exclusive,
+   non-transferable, revocable license to install and use the Software for its
+   intended purpose. The standalone desktop application ("the Agent") may be used
+   locally at no charge; connected platform features — hosted agent runs, model
+   inference, credits, and account services — are governed by the applicable
+   subscription and the XENO terms of service.
+
+2. PACKAGE DISTRIBUTION
+   The `@xeno-corporation/xeno-agent-interface-*` and
+   `@xeno-corporation/xeno-agents-client` packages are published to a PRIVATE
+   registry and are licensed for use solely by XENO products and by parties
+   holding a separate written agreement with XENO. Access credentials to that
+   registry do not grant redistribution rights. Publication of any package in
+   this repository to a public registry is prohibited without written
+   authorization from XENO.
+
+3. RESTRICTIONS
+   Except to the extent expressly permitted by applicable law or by a separate
+   written agreement with XENO, you may NOT: (a) copy, redistribute, sell, rent,
+   lease, sublicense, or otherwise transfer the Software; (b) modify, adapt,
+   translate, or create derivative works of the Software; (c) reverse-engineer,
+   decompile, or disassemble the Software, or attempt to derive its source code;
+   (d) remove, obscure, or alter any proprietary notices; or (e) use the Software
+   to build a competing product.
+
+4. RESERVATION OF RIGHTS
+   All rights not expressly granted are reserved by XENO Corporation. The Software
+   is protected by copyright and other intellectual-property laws and treaties.
+
+5. DISCLAIMER OF WARRANTY
+   THE SOFTWARE IS PROVIDED "AS IS" AND "AS AVAILABLE", WITHOUT WARRANTY OF ANY
+   KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THE
+   SOFTWARE EXECUTES AGENT-DIRECTED OPERATIONS AGAINST A USER-SELECTED WORKSPACE,
+   INCLUDING FILE AND PROCESS ACTIONS; THE USER IS RESPONSIBLE FOR THE WORKSPACES
+   AND PERMISSIONS THEY GRANT IT.
+
+6. LIMITATION OF LIABILITY
+   TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT SHALL XENO CORPORATION BE
+   LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE
+   DAMAGES, OR ANY LOSS OF PROFITS OR DATA, ARISING FROM OR RELATED TO THE USE OF
+   OR INABILITY TO USE THE SOFTWARE.
+
+7. THIRD-PARTY COMPONENTS
+   The Software includes third-party open-source components, each licensed under
+   its own terms; those terms govern those components and are not superseded by
+   this license. It also composes third-party agent providers over the Agent
+   Client Protocol and hosted APIs; use of those providers is governed by their
+   own terms.
+
+For licensing inquiries, contact: legal@xenostudio.ai
+
+NOTE TO OPERATOR: confirm the exact legal entity name and notice/contact details
+with counsel before public distribution and code-signing (the code-signing
+publisher name must match the registered entity). No public distribution of this
+product is authorized by this file — see docs/PRODUCT_STATUS.md.

package/dist/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * `@xenosystem/agent-interface-panel` — the XENO Agent panel that renders the REAL interface.
+ *
+ * ONE agent surface, mounted wherever a XENO Panel host can put a tile: xeno-apps, Pixel,
+ * Motion, Canvas. Update the interface once and every host that mounts this panel gets it,
+ * because there is nothing here to keep in sync — this package contributes a mount, not a UI.
+ *
+ * ## What this is, precisely
+ *
+ * `@xenosystem/panel-agent` (xeno-core) is the GENERIC half: manifest, controller, projections,
+ * wiring, diff parsing, host-event translation. It depends on no product, which is why it lives
+ * in core, and it ships a deliberately minimal default view whose own docblock says what is not
+ * in it — no transcript, no tool timeline, no diff, no terminal.
+ *
+ * This package is the PRODUCT half. It supplies the view, and the view is the shipping XENO Agent
+ * interface itself, mounted through `@xenosystem/agent-interface-embed`.
+ *
+ * 🔴 **It renders the real interface rather than reproducing it, and that is the whole point.**
+ * `XENO AGENT PANEL - SPEC.md` D7d refuses a port: three agent UIs already exist because each
+ * began as a reasonable copy, and a fourth would drift from the day it was written. The
+ * conversation view is ~11.5k lines bound to six stores with no tests — reproducing it is not a
+ * task, it is a second product to maintain.
+ *
+ * ## What a host must supply
+ *
+ * 1. An `AgentHostClient` whose `surface` is `'panel-embed'`. The embed layer refuses a client
+ *    whose surface disagrees with the mount, deliberately — a surface that lies about which kind
+ *    it is gets the wrong chrome and the wrong lifecycle.
+ * 2. A platform bridge, installed before mount. The interface reads its data from the bridge, not
+ *    from props, exactly as it does under `hub-embed`.
+ *
+ * ⚠️ **Known limit, stated rather than hidden.** The mounted interface holds its own connection to
+ * the agent host. The panel's input ports still carry status and intents for host wiring, but they
+ * are not yet the interface's source of truth — D7c's "the panel OWNS the conversation" is only
+ * half done here. Closing it needs the interface to accept an injected session source, which does
+ * not exist today. Until it does, a host should treat this panel as the interface in a tile, and
+ * not wire a second conversation into it and expect them to agree.
+ *
+ * @packageDocumentation
+ */
+import type { PanelModule } from '@xenosystem/panel-sdk';
+import type { AgentHostClient } from '@xenosystem/agent-interface-client';
+/** Options for {@link createXenoAgentInterfacePanel}. */
+export interface CreateXenoAgentInterfacePanelOptions {
+    /**
+     * Build the client this panel mounts against.
+     *
+     * 🔴 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
+     * lifetimes means the second mount inherits the first one's teardown. One mount, one client.
+     *
+     * The client's `surface` must be `'panel-embed'` or the embed layer refuses the mount.
+     */
+    createClient: () => AgentHostClient | Promise<AgentHostClient>;
+    /** Called when a mount fails, so a host can surface it rather than showing an empty tile. */
+    onError?: (error: unknown) => void;
+}
+/** The surface kind this panel mounts as. */
+export declare const AGENT_PANEL_SURFACE: "panel-embed";
+/**
+ * Build the panel module: the generic agent panel, rendered by the real XENO Agent interface.
+ *
+ * @param options - How to build a client, and where to report a failed mount.
+ * @returns A `PanelModule` any XENO Panel host can register.
+ */
+export declare function createXenoAgentInterfacePanel(options: CreateXenoAgentInterfacePanelOptions): PanelModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,119 @@
+/**
+ * `@xenosystem/agent-interface-panel` — the XENO Agent panel that renders the REAL interface.
+ *
+ * ONE agent surface, mounted wherever a XENO Panel host can put a tile: xeno-apps, Pixel,
+ * Motion, Canvas. Update the interface once and every host that mounts this panel gets it,
+ * because there is nothing here to keep in sync — this package contributes a mount, not a UI.
+ *
+ * ## What this is, precisely
+ *
+ * `@xenosystem/panel-agent` (xeno-core) is the GENERIC half: manifest, controller, projections,
+ * wiring, diff parsing, host-event translation. It depends on no product, which is why it lives
+ * in core, and it ships a deliberately minimal default view whose own docblock says what is not
+ * in it — no transcript, no tool timeline, no diff, no terminal.
+ *
+ * This package is the PRODUCT half. It supplies the view, and the view is the shipping XENO Agent
+ * interface itself, mounted through `@xenosystem/agent-interface-embed`.
+ *
+ * 🔴 **It renders the real interface rather than reproducing it, and that is the whole point.**
+ * `XENO AGENT PANEL - SPEC.md` D7d refuses a port: three agent UIs already exist because each
+ * began as a reasonable copy, and a fourth would drift from the day it was written. The
+ * conversation view is ~11.5k lines bound to six stores with no tests — reproducing it is not a
+ * task, it is a second product to maintain.
+ *
+ * ## What a host must supply
+ *
+ * 1. An `AgentHostClient` whose `surface` is `'panel-embed'`. The embed layer refuses a client
+ *    whose surface disagrees with the mount, deliberately — a surface that lies about which kind
+ *    it is gets the wrong chrome and the wrong lifecycle.
+ * 2. A platform bridge, installed before mount. The interface reads its data from the bridge, not
+ *    from props, exactly as it does under `hub-embed`.
+ *
+ * ⚠️ **Known limit, stated rather than hidden.** The mounted interface holds its own connection to
+ * the agent host. The panel's input ports still carry status and intents for host wiring, but they
+ * are not yet the interface's source of truth — D7c's "the panel OWNS the conversation" is only
+ * half done here. Closing it needs the interface to accept an injected session source, which does
+ * not exist today. Until it does, a host should treat this panel as the interface in a tile, and
+ * not wire a second conversation into it and expect them to agree.
+ *
+ * @packageDocumentation
+ */
+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';
+/*
+ * ⚠️ The cast is not laziness. `AgentInterface` declares its props parameter as OPTIONAL —
+ * `(props?: AgentInterfaceProps)` — and `createElement` narrows such a component to `{}`, so
+ * passing `surface` is rejected as an unknown attribute even though the built `.d.ts` types it
+ * correctly. Naming the props type restores it.
+ *
+ * Deliberately NOT solved by omitting the prop. `surface` defaults to `'embedded'` today, and
+ * relying on that default would make this panel's chrome depend on a value it never states —
+ * silently wrong the day the default changes.
+ */
+const AgentInterfaceComponent = XenoAgentInterface;
+/** The surface kind this panel mounts as. */
+export const AGENT_PANEL_SURFACE = 'panel-embed';
+/**
+ * Build the panel module: the generic agent panel, rendered by the real XENO Agent interface.
+ *
+ * @param options - How to build a client, and where to report a failed mount.
+ * @returns A `PanelModule` any XENO Panel host can register.
+ */
+export function createXenoAgentInterfacePanel(options) {
+    return createAgentPanel({
+        render(el) {
+            let handle = null;
+            let root = 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.
+             * Without this flag the late `.then` mounts into a container the host has already discarded
+             * and nothing ever unmounts it, which is the leak `panel-template` records for this shape.
+             */
+            let disposed = false;
+            void (async () => {
+                try {
+                    const client = await options.createClient();
+                    const mounted = await mountXenoAgentInterface(el, {
+                        surface: AGENT_PANEL_SURFACE,
+                        client,
+                        renderer: {
+                            mount(container) {
+                                /*
+                                 * Mounted HERE, inside this package, so `react` and `react-dom` resolve to one
+                                 * copy. A host that calls `createRoot` on a view imported across a package
+                                 * boundary can end up with two Reacts, and every hook throws "Invalid hook call".
+                                 */
+                                root = createRoot(container);
+                                root.render(createElement(AgentInterfaceComponent, { surface: 'embedded' }));
+                            },
+                            unmount() {
+                                root?.unmount();
+                                root = null;
+                            },
+                        },
+                    });
+                    if (disposed) {
+                        await mounted.unmount();
+                        return;
+                    }
+                    handle = mounted;
+                }
+                catch (error) {
+                    options.onError?.(error);
+                }
+            })();
+            return () => {
+                disposed = true;
+                void handle?.unmount();
+                handle = null;
+                root?.unmount();
+                root = null;
+            };
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@xenosystem/agent-interface-panel",
+  "version": "0.1.26",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "//sideEffects": "Only stylesheets are un-droppable; unused JS may be tree-shaken.",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@xenosystem/panel-agent": "^0.1.0",
+    "@xenosystem/agent-interface-client": "0.1.26",
+    "@xenosystem/agent-interface-embed": "0.1.26",
+    "@xenosystem/agent-interface-ui": "0.1.26",
+    "@xenosystem/agent-interface-contract": "0.1.26"
+  },
+  "peerDependencies": {
+    "@xenosystem/panel-sdk": "^1.1.0",
+    "@xenosystem/workbench": "^1.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.2",
+    "@types/react-dom": "^19.0.2",
+    "@xenosystem/panel-sdk": "^1.1.0",
+    "@xenosystem/workbench": "^1.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}