@swarm.ing/pieui 2.0.34 → 2.1.1

package/dist/agent/index.d.ts

@@ -8,4 +8,5 @@
  * expose PieCard methods as OpenAI function tools.
  */
 export { getMittAgentTools, usePieMittAgentTools, type MittAgentTool, type MittAgentToolDescriptor, type MittAgentToolsOptions, } from '../util/mittAgentTools';
+export { default as useOpenAIWebRTC, type OpenAIEvent, type UseOpenAIWebRTCReturn, } from '../util/useOpenAIWebRTC';
 //# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,OAAO,EACH,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC7B,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,OAAO,EACH,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC7B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACH,OAAO,IAAI,eAAe,EAC1B,KAAK,WAAW,EAChB,KAAK,qBAAqB,GAC7B,MAAM,yBAAyB,CAAA"}

package/dist/agent/index.esm.js

@@ -1,2 +1,2 @@
 "use client";
-import{tool as A}from"@openai/agents";import{useContext as P,useMemo as I}from"react";import S from"mitt";import{createContext as O,useCallback as w,useContext as E}from"react";var Z=null;function $(){if(!Z)Z=S();return Z}var R=O(null);var q=R;var z=/^pie(.+?)_(.+)$/;function D(X=$(),Q={}){let G=[],H=new Set;for(let j of X.all.keys()){if(typeof j!=="string")continue;let W=j.match(z);if(!W)continue;let[,J,L]=W,B={methodName:J,cardName:L,eventName:j};if(Q.filter&&!Q.filter(B))continue;let Y=Q.nameFor?.(B)??`${L}_${J}`;if(H.has(Y))continue;H.add(Y);let U=Q.describe?.(B)??`Invokes the "${J}" method on the PieCard "${L}" by emitting the in-process mitt event "${j}". The optional "payload" argument is forwarded verbatim to the card's handler.`;G.push(A({name:Y,description:U,strict:!1,parameters:{type:"object",properties:{payload:{description:"Arbitrary JSON payload forwarded to the PieCard method handler. Omit for fire-and-forget calls."}},required:[],additionalProperties:!0},execute:async(F)=>{let V=F?.payload;return X.emit(j,V),`Emitted "${j}"`}}))}return G}function _(X={}){let G=P(q)??$(),H=[];for(let B of G.all.keys())if(typeof B==="string"&&z.test(B))H.push(B);H.sort();let j=H.join("|"),{filter:W,describe:J,nameFor:L}=X;return I(()=>D(G,{filter:W,describe:J,nameFor:L}),[G,j,W,J,L])}export{_ as usePieMittAgentTools,D as getMittAgentTools};
+import{tool as x}from"@openai/agents";import{useContext as b,useMemo as k}from"react";import M from"mitt";import{createContext as w,useCallback as c,useContext as d}from"react";var P=null;function F(){if(!P)P=M();return P}var T=w(null);var O=T;var I=/^pie(.+?)_(.+)$/;function A(G=F(),H={}){let Z=[],L=new Set;for(let J of G.all.keys()){if(typeof J!=="string")continue;let Q=J.match(I);if(!Q)continue;let[,X,q]=Q,$={methodName:X,cardName:q,eventName:J};if(H.filter&&!H.filter($))continue;let W=H.nameFor?.($)??`${q}_${X}`;if(L.has(W))continue;L.add(W);let D=H.describe?.($)??`Invokes the "${X}" method on the PieCard "${q}" by emitting the in-process mitt event "${J}". The optional "payload" argument is forwarded verbatim to the card's handler.`;Z.push(x({name:W,description:D,strict:!1,parameters:{type:"object",properties:{payload:{description:"Arbitrary JSON payload forwarded to the PieCard method handler. Omit for fire-and-forget calls."}},required:[],additionalProperties:!0},execute:async(j)=>{let Y=j?.payload;return G.emit(J,Y),`Emitted "${J}"`}}))}return Z}function N(G={}){let Z=b(O)??F(),L=[];for(let $ of Z.all.keys())if(typeof $==="string"&&I.test($))L.push($);L.sort();let J=L.join("|"),{filter:Q,describe:X,nameFor:q}=G;return k(()=>A(Z,{filter:Q,describe:X,nameFor:q}),[Z,J,Q,X,q])}import{useCallback as V,useEffect as y,useRef as _,useState as f}from"react";function v(){let G=new AudioContext,H=G.createOscillator(),Z=H.connect(G.createMediaStreamDestination());H.start();let L=Z.stream.getAudioTracks()[0];return L.enabled=!1,L}function R(G=null,H){let[Z,L]=f(!1),J=_(null),Q=_(null),X=_(null),q=V(async(j,Y=!0)=>{if(J.current)$();let B=new RTCPeerConnection;if(B.onconnectionstatechange=()=>{if(B.connectionState==="connected")L(!0);else if(["disconnected","failed","closed"].includes(B.connectionState))L(!1)},B.ontrack=(z)=>{if(G)G.srcObject=z.streams[0]},Y){let z=await navigator.mediaDevices.getUserMedia({audio:!0});B.addTrack(z.getTracks()[0],z)}else{let z=v();B.addTrack(z)}let U=B.createDataChannel("oai-events");Q.current=U,X.current=new Promise((z)=>{U.addEventListener("open",()=>{z()})});let K=await B.createOffer();await B.setLocalDescription(K);let S=await(await fetch(`${"https://api.openai.com/v1/realtime/calls"}?model=${"gpt-realtime"}`,{method:"POST",body:K.sdp,headers:{Authorization:`Bearer ${j}`,"Content-Type":"application/sdp"}})).text();await B.setRemoteDescription({type:"answer",sdp:S}),J.current=B,await X.current},[G]),$=V(()=>{let j=Q.current;if(j)j.close();J.current?.getSenders()?.forEach((Y)=>Y.track?.stop()),J.current?.close(),L(!1),J.current=null,Q.current=null,X.current=null},[G]),W=V((j)=>{let Y=Q.current;if(!Y){console.error("Data channel is not ready",j);return}let B=new Date().toLocaleTimeString();if(j.event_id=j.event_id||crypto.randomUUID(),Y.send(JSON.stringify(j)),!j.timestamp)j.timestamp=B;H?.(j)},[H,G]),D=V((j)=>{if(!Q.current){console.error("Data channel is not ready");return}let B=()=>{W({type:"conversation.item.create",item:{type:"message",role:"user",content:[{type:"input_text",text:j}]}}),W({type:"response.create"})};if(X.current)X.current.then(B);else B()},[H,G]);return y(()=>{let j=Q.current;if(!j)return;let Y=(B)=>{let U=JSON.parse(B.data);if(!U.timestamp)U.timestamp=new Date().toLocaleTimeString();H?.(U)};return j.addEventListener("message",Y),()=>{j.removeEventListener("message",Y)}},[H,G]),{isSessionActive:Z,startSession:q,stopSession:$,sendTextMessage:D}}export{N as usePieMittAgentTools,R as useOpenAIWebRTC,A as getMittAgentTools};

package/dist/agent/index.js

@@ -1,2 +1,2 @@
 "use client";
-var M=Object.create;var{getPrototypeOf:w,defineProperty:Y,getOwnPropertyNames:V,getOwnPropertyDescriptor:E}=Object,S=Object.prototype.hasOwnProperty;var f=(j,B,G)=>{G=j!=null?M(w(j)):{};let H=B||!j||!j.__esModule?Y(G,"default",{value:j,enumerable:!0}):G;for(let J of V(j))if(!S.call(H,J))Y(H,J,{get:()=>j[J],enumerable:!0});return H},F=new WeakMap,x=(j)=>{var B=F.get(j),G;if(B)return B;if(B=Y({},"__esModule",{value:!0}),j&&typeof j==="object"||typeof j==="function")V(j).map((H)=>!S.call(B,H)&&Y(B,H,{get:()=>j[H],enumerable:!(G=E(j,H))||G.enumerable}));return F.set(j,B),B};var T=(j,B)=>{for(var G in B)Y(j,G,{get:B[G],enumerable:!0,configurable:!0,set:(H)=>B[G]=()=>H})};var C={};T(C,{usePieMittAgentTools:()=>I,getMittAgentTools:()=>U});module.exports=x(C);var A=require("@openai/agents"),$=require("react");var O=f(require("mitt")),Z=require("react"),z=null;function D(){if(!z)z=O.default();return z}var b=Z.createContext(null);var R=b;var P=/^pie(.+?)_(.+)$/;function U(j=D(),B={}){let G=[],H=new Set;for(let J of j.all.keys()){if(typeof J!=="string")continue;let X=J.match(P);if(!X)continue;let[,Q,W]=X,L={methodName:Q,cardName:W,eventName:J};if(B.filter&&!B.filter(L))continue;let q=B.nameFor?.(L)??`${W}_${Q}`;if(H.has(q))continue;H.add(q);let _=B.describe?.(L)??`Invokes the "${Q}" method on the PieCard "${W}" by emitting the in-process mitt event "${J}". The optional "payload" argument is forwarded verbatim to the card's handler.`;G.push(A.tool({name:q,description:_,strict:!1,parameters:{type:"object",properties:{payload:{description:"Arbitrary JSON payload forwarded to the PieCard method handler. Omit for fire-and-forget calls."}},required:[],additionalProperties:!0},execute:async(K)=>{let k=K?.payload;return j.emit(J,k),`Emitted "${J}"`}}))}return G}function I(j={}){let G=$.useContext(R)??D(),H=[];for(let L of G.all.keys())if(typeof L==="string"&&P.test(L))H.push(L);H.sort();let J=H.join("|"),{filter:X,describe:Q,nameFor:W}=j;return $.useMemo(()=>U(G,{filter:X,describe:Q,nameFor:W}),[G,J,X,Q,W])}
+var f=Object.create;var{getPrototypeOf:v,defineProperty:D,getOwnPropertyNames:M,getOwnPropertyDescriptor:C}=Object,w=Object.prototype.hasOwnProperty;var E=(j,B,H)=>{H=j!=null?f(v(j)):{};let G=B||!j||!j.__esModule?D(H,"default",{value:j,enumerable:!0}):H;for(let L of M(j))if(!w.call(G,L))D(G,L,{get:()=>j[L],enumerable:!0});return G},S=new WeakMap,g=(j)=>{var B=S.get(j),H;if(B)return B;if(B=D({},"__esModule",{value:!0}),j&&typeof j==="object"||typeof j==="function")M(j).map((G)=>!w.call(B,G)&&D(B,G,{get:()=>j[G],enumerable:!(H=C(j,G))||H.enumerable}));return S.set(j,B),B};var u=(j,B)=>{for(var H in B)D(j,H,{get:B[H],enumerable:!0,configurable:!0,set:(G)=>B[H]=()=>G})};var c={};u(c,{usePieMittAgentTools:()=>N,useOpenAIWebRTC:()=>A,getMittAgentTools:()=>I});module.exports=g(c);var b=require("@openai/agents"),F=require("react");var T=E(require("mitt")),P=require("react"),K=null;function O(){if(!K)K=T.default();return K}var h=P.createContext(null);var x=h;var k=/^pie(.+?)_(.+)$/;function I(j=O(),B={}){let H=[],G=new Set;for(let L of j.all.keys()){if(typeof L!=="string")continue;let Y=L.match(k);if(!Y)continue;let[,Z,z]=Y,q={methodName:Z,cardName:z,eventName:L};if(B.filter&&!B.filter(q))continue;let V=B.nameFor?.(q)??`${z}_${Z}`;if(G.has(V))continue;G.add(V);let _=B.describe?.(q)??`Invokes the "${Z}" method on the PieCard "${z}" by emitting the in-process mitt event "${L}". The optional "payload" argument is forwarded verbatim to the card's handler.`;H.push(b.tool({name:V,description:_,strict:!1,parameters:{type:"object",properties:{payload:{description:"Arbitrary JSON payload forwarded to the PieCard method handler. Omit for fire-and-forget calls."}},required:[],additionalProperties:!0},execute:async(J)=>{let $=J?.payload;return j.emit(L,$),`Emitted "${L}"`}}))}return H}function N(j={}){let H=F.useContext(x)??O(),G=[];for(let q of H.all.keys())if(typeof q==="string"&&k.test(q))G.push(q);G.sort();let L=G.join("|"),{filter:Y,describe:Z,nameFor:z}=j;return F.useMemo(()=>I(H,{filter:Y,describe:Z,nameFor:z}),[H,L,Y,Z,z])}var X=require("react");function p(){let j=new AudioContext,B=j.createOscillator(),H=B.connect(j.createMediaStreamDestination());B.start();let G=H.stream.getAudioTracks()[0];return G.enabled=!1,G}function A(j=null,B){let[H,G]=X.useState(!1),L=X.useRef(null),Y=X.useRef(null),Z=X.useRef(null),z=X.useCallback(async(J,$=!0)=>{if(L.current)q();let Q=new RTCPeerConnection;if(Q.onconnectionstatechange=()=>{if(Q.connectionState==="connected")G(!0);else if(["disconnected","failed","closed"].includes(Q.connectionState))G(!1)},Q.ontrack=(U)=>{if(j)j.srcObject=U.streams[0]},$){let U=await navigator.mediaDevices.getUserMedia({audio:!0});Q.addTrack(U.getTracks()[0],U)}else{let U=p();Q.addTrack(U)}let W=Q.createDataChannel("oai-events");Y.current=W,Z.current=new Promise((U)=>{W.addEventListener("open",()=>{U()})});let R=await Q.createOffer();await Q.setLocalDescription(R);let y=await(await fetch(`${"https://api.openai.com/v1/realtime/calls"}?model=${"gpt-realtime"}`,{method:"POST",body:R.sdp,headers:{Authorization:`Bearer ${J}`,"Content-Type":"application/sdp"}})).text();await Q.setRemoteDescription({type:"answer",sdp:y}),L.current=Q,await Z.current},[j]),q=X.useCallback(()=>{let J=Y.current;if(J)J.close();L.current?.getSenders()?.forEach(($)=>$.track?.stop()),L.current?.close(),G(!1),L.current=null,Y.current=null,Z.current=null},[j]),V=X.useCallback((J)=>{let $=Y.current;if(!$){console.error("Data channel is not ready",J);return}let Q=new Date().toLocaleTimeString();if(J.event_id=J.event_id||crypto.randomUUID(),$.send(JSON.stringify(J)),!J.timestamp)J.timestamp=Q;B?.(J)},[B,j]),_=X.useCallback((J)=>{if(!Y.current){console.error("Data channel is not ready");return}let Q=()=>{V({type:"conversation.item.create",item:{type:"message",role:"user",content:[{type:"input_text",text:J}]}}),V({type:"response.create"})};if(Z.current)Z.current.then(Q);else Q()},[B,j]);return X.useEffect(()=>{let J=Y.current;if(!J)return;let $=(Q)=>{let W=JSON.parse(Q.data);if(!W.timestamp)W.timestamp=new Date().toLocaleTimeString();B?.(W)};return J.addEventListener("message",$),()=>{J.removeEventListener("message",$)}},[B,j]),{isSessionActive:H,startSession:z,stopSession:q,sendTextMessage:_}}

package/dist/cli.js

@@ -188176,7 +188176,7 @@ var require_typescript_json_schema = __commonJS((exports2) => {
 });
 
 // src/cli.ts
-var import_node_path23 = __toESM(require("node:path"));
+var import_node_path24 = __toESM(require("node:path"));
 
 // src/code/args.ts
 var VALID_CARD_ACTIONS = [
@@ -188434,6 +188434,29 @@ var parseArgs = (argv) => {
       result.pageAjaxHandler = argv[4];
     }
   }
+  if (command === "registry" && argv[1]) {
+    const action = argv[1];
+    if (action === "dev" || action === "build") {
+      result.registryAction = action;
+      const tail = argv.slice(2);
+      for (let i = 0;i < tail.length; i++) {
+        const tok = tail[i];
+        if (tok === "--port" && tail[i + 1]) {
+          result.registryPort = parseIntFlag("--port", tail[++i]);
+        } else if (tok.startsWith("--port=")) {
+          result.registryPort = parseIntFlag("--port", tok.slice("--port=".length));
+        } else if (tok === "--api-server" && tail[i + 1]) {
+          result.registryApiServer = tail[++i];
+        } else if (tok.startsWith("--api-server=")) {
+          result.registryApiServer = tok.slice("--api-server=".length);
+        } else if (tok === "--out" && tail[i + 1]) {
+          result.registryOut = tail[++i];
+        } else if (tok.startsWith("--out=")) {
+          result.registryOut = tok.slice("--out=".length);
+        }
+      }
+    }
+  }
   return result;
 };
 var detectHelpScope = (argv) => {
@@ -188448,6 +188471,8 @@ var detectHelpScope = (argv) => {
     return "card";
   if (c0 === "page")
     return "page";
+  if (c0 === "registry")
+    return "registry";
   if (c0 === "init")
     return "init";
   if (c0 === "postbuild")
@@ -188500,6 +188525,10 @@ var ALL_LINES = [
   "  page view <path>                                 Print app/<path>/page.tsx source",
   "  page ajax <path> <add|remove> <handler>          Add or remove an AJAX handler in app/<path>/page.tsx",
   "",
+  "Registry preview harness (standalone PiePreviewRoot, no app layout):",
+  "  registry dev [--port N] [--api-server URL]       Run the preview harness dev server (used by `pie card show`)",
+  "  registry build [--out DIR]                       Static-export the harness (served by `pie` with disable_serving=False)",
+  "",
   "Component types for `card add`:",
   "  simple              Simple component (only data prop)",
   "  complex             Complex component (data + children props)",
@@ -197348,6 +197377,189 @@ var pageAjaxCommand = (pageName, action, handlerName) => {
   }
 };
 
+// src/code/commands/registry.ts
+var import_node_fs19 = __toESM(require("node:fs"));
+var import_node_path20 = __toESM(require("node:path"));
+var import_node_child_process6 = require("node:child_process");
+var REGISTRY_DIR = ".pie/registry";
+var OUT_DIRNAME = "out";
+var writeIfChanged = (filePath, contents) => {
+  if (import_node_fs19.default.existsSync(filePath) && import_node_fs19.default.readFileSync(filePath, "utf8") === contents) {
+    return;
+  }
+  import_node_fs19.default.mkdirSync(import_node_path20.default.dirname(filePath), { recursive: true });
+  import_node_fs19.default.writeFileSync(filePath, contents, "utf8");
+};
+var scaffoldHarness = (frontendRoot, registryName) => {
+  const dir = import_node_path20.default.join(frontendRoot, REGISTRY_DIR);
+  writeIfChanged(import_node_path20.default.join(dir, "package.json"), JSON.stringify({ name: "pie-registry-preview", version: "0.0.0", private: true }, null, 2) + `
+`);
+  writeIfChanged(import_node_path20.default.join(dir, "next.config.mjs"), `import path from 'node:path'
+
+// Next runs with cwd = this harness dir; the frontend project is two levels up.
+const harnessRoot = process.cwd()
+const frontendRoot = path.resolve(harnessRoot, '..', '..')
+
+/** @type {import('next').NextConfig} */
+export default {
+  output: 'export',
+  reactStrictMode: true,
+  // Next 16 blocks dev requests from non-localhost origins; allow loopback so
+  // the HMR socket / lazy chunk loading work when opened via 127.0.0.1.
+  allowedDevOrigins: ['127.0.0.1', 'localhost'],
+  images: { unoptimized: true },
+  typescript: { ignoreBuildErrors: true },
+  transpilePackages: ['@swarm.ing/pieui'],
+  // The workspace root must be the frontend project: that's where node_modules
+  // (incl. \`next\`) lives and where the card registry + cards are imported from
+  // (outside this harness dir). The app dir stays this harness (cwd).
+  outputFileTracingRoot: frontendRoot,
+  env: {
+    PIE_API_SERVER: process.env.PIE_API_SERVER ?? '',
+    NEXT_PUBLIC_PIE_API_SERVER: process.env.NEXT_PUBLIC_PIE_API_SERVER ?? '',
+  },
+  turbopack: { root: frontendRoot, resolveAlias: { '@': frontendRoot } },
+  webpack: (config) => {
+    config.resolve = config.resolve || {}
+    config.resolve.alias = { ...(config.resolve.alias || {}), '@': frontendRoot }
+    return config
+  },
+}
+`);
+  writeIfChanged(import_node_path20.default.join(dir, "tsconfig.json"), JSON.stringify({
+    compilerOptions: {
+      target: "ES2017",
+      lib: ["dom", "dom.iterable", "esnext"],
+      allowJs: true,
+      skipLibCheck: true,
+      strict: false,
+      noEmit: true,
+      esModuleInterop: true,
+      module: "esnext",
+      moduleResolution: "bundler",
+      resolveJsonModule: true,
+      isolatedModules: true,
+      jsx: "preserve",
+      incremental: true,
+      baseUrl: "../..",
+      paths: { "@/*": ["./*"] },
+      plugins: [{ name: "next" }]
+    },
+    include: [
+      "next-env.d.ts",
+      "**/*.ts",
+      "**/*.tsx",
+      ".next/types/**/*.ts"
+    ],
+    exclude: ["node_modules"]
+  }, null, 2) + `
+`);
+  writeIfChanged(import_node_path20.default.join(dir, "app", "layout.tsx"), `import '@/app/globals.css'
+
+export const metadata = { title: 'Pie Registry Preview' }
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}
+`);
+  writeIfChanged(import_node_path20.default.join(dir, "app", "page.tsx"), `'use client'
+
+import dynamic from 'next/dynamic'
+
+const PreviewClient = dynamic(
+  () =>
+    import('./preview-client').catch((e) => ({
+      default: () => (
+        <pre style={{ color: 'red', padding: 16, whiteSpace: 'pre-wrap' }}>
+          {'[pie] preview harness failed to load:\\n' + String(e && e.stack ? e.stack : e)}
+        </pre>
+      ),
+    })),
+  { ssr: false, loading: () => <div style={{ padding: 16 }}>harness loading…</div> }
+)
+
+export default function Page() {
+  return <PreviewClient />
+}
+`);
+  writeIfChanged(import_node_path20.default.join(dir, "app", "preview-client.tsx"), `'use client'
+
+import '@/${registryName}/registry'
+import { PiePreviewRoot } from '@swarm.ing/pieui'
+
+export default function PreviewClient() {
+  // Dev: NEXT_PUBLIC_PIE_API_SERVER points at the ephemeral backend (Next
+  // statically inlines NEXT_PUBLIC_* into the client bundle). Static build:
+  // unset → falls back to same-origin '/' (pie serves both the SPA and API).
+  const apiServer = process.env.NEXT_PUBLIC_PIE_API_SERVER || '/'
+  return <PiePreviewRoot apiServer={apiServer} pathname="/" />
+}
+`);
+  writeIfChanged(import_node_path20.default.join(dir, ".gitignore"), `*
+`);
+  return dir;
+};
+var resolveNextBin = (frontendRoot) => {
+  const bin = import_node_path20.default.join(frontendRoot, "node_modules", ".bin", "next");
+  if (!import_node_fs19.default.existsSync(bin)) {
+    throw new Error(`Next.js binary not found at ${bin}. Install dependencies in the ` + `frontend project first (the registry harness reuses them).`);
+  }
+  return bin;
+};
+var registryCommand = (action, opts = {}) => {
+  const frontendRoot = process.cwd();
+  const settings = loadSettings(frontendRoot);
+  const registryName = import_node_path20.default.basename(settings.componentsDir);
+  const dir = scaffoldHarness(frontendRoot, registryName);
+  const nextBin = resolveNextBin(frontendRoot);
+  const env = { ...process.env };
+  if (opts.apiServer) {
+    env.PIE_API_SERVER = opts.apiServer;
+    env.NEXT_PUBLIC_PIE_API_SERVER = opts.apiServer;
+  }
+  if (action === "dev") {
+    const port = opts.port ?? 3210;
+    console.log(`[pieui] registry dev → http://localhost:${port}`);
+    console.log(`[pieui]   harness: ${dir}`);
+    console.log(`[pieui]   PIE_API_SERVER=${env.PIE_API_SERVER ?? "(unset → /)"}`);
+    const result2 = import_node_child_process6.spawnSync(nextBin, ["dev", "-p", String(port)], {
+      cwd: dir,
+      stdio: "inherit",
+      env
+    });
+    if (result2.error)
+      throw result2.error;
+    if (typeof result2.status === "number" && result2.status !== 0) {
+      process.exitCode = result2.status;
+    }
+    return;
+  }
+  delete env.PIE_API_SERVER;
+  delete env.NEXT_PUBLIC_PIE_API_SERVER;
+  console.log(`[pieui] registry build (static export) → ${import_node_path20.default.join(dir, OUT_DIRNAME)}`);
+  const result = import_node_child_process6.spawnSync(nextBin, ["build"], {
+    cwd: dir,
+    stdio: "inherit",
+    env
+  });
+  if (result.error)
+    throw result.error;
+  if (typeof result.status === "number" && result.status !== 0) {
+    process.exitCode = result.status;
+    return;
+  }
+  const outDir = opts.out ? import_node_path20.default.resolve(frontendRoot, opts.out) : import_node_path20.default.join(dir, OUT_DIRNAME);
+  console.log(`[pieui] registry build complete: ${outDir}`);
+};
+
 // src/code/commands/create.ts
 var import_fs9 = __toESM(require("fs"));
 var import_path11 = __toESM(require("path"));
@@ -197467,7 +197679,8 @@ var DEFAULT_SHARED_SIMPLE_TSX = `"use client";
 
 import { useEffect, useState } from "react";
 import { useRouter } from "next/navigation";
-import { PieTelegramRoot, PieQueryOptions } from "@swarm.ing/pieui";
+import { PieQueryOptions } from "@swarm.ing/pieui";
+import { PieTelegramRoot } from "@swarm.ing/pieui/telegram";
 
 import { usePathname, useSearchParams } from "next/navigation";
 import LoadingScreen from "@/components/LoadingScreen";
@@ -197705,49 +197918,49 @@ var createPieAppCommand = (appName) => {
 };
 
 // src/code/commands/login.ts
-var import_node_child_process6 = require("node:child_process");
+var import_node_child_process7 = require("node:child_process");
 var import_node_crypto = require("node:crypto");
-var import_node_fs20 = __toESM(require("node:fs"));
-var import_node_path21 = __toESM(require("node:path"));
+var import_node_fs21 = __toESM(require("node:fs"));
+var import_node_path22 = __toESM(require("node:path"));
 
 // src/code/services/projectLinks.ts
-var import_node_fs19 = __toESM(require("node:fs"));
-var import_node_path20 = __toESM(require("node:path"));
+var import_node_fs20 = __toESM(require("node:fs"));
+var import_node_path21 = __toESM(require("node:path"));
 var readline3 = __toESM(require("node:readline/promises"));
 var PIE_CONFIG_DIR3 = ".pie";
 var PIE_CONFIG_FILE3 = "config.json";
-var configPathFor = (cwd) => import_node_path20.default.join(cwd, PIE_CONFIG_DIR3, PIE_CONFIG_FILE3);
+var configPathFor = (cwd) => import_node_path21.default.join(cwd, PIE_CONFIG_DIR3, PIE_CONFIG_FILE3);
 var readConfig2 = (cwd) => {
   const p = configPathFor(cwd);
-  if (!import_node_fs19.default.existsSync(p))
+  if (!import_node_fs20.default.existsSync(p))
     return {};
   try {
-    const parsed = JSON.parse(import_node_fs19.default.readFileSync(p, "utf8"));
+    const parsed = JSON.parse(import_node_fs20.default.readFileSync(p, "utf8"));
     return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : {};
   } catch {
     return {};
   }
 };
 var writeConfig2 = (cwd, config) => {
-  const dir = import_node_path20.default.join(cwd, PIE_CONFIG_DIR3);
-  import_node_fs19.default.mkdirSync(dir, { recursive: true });
-  import_node_fs19.default.writeFileSync(configPathFor(cwd), JSON.stringify(config, null, 2) + `
+  const dir = import_node_path21.default.join(cwd, PIE_CONFIG_DIR3);
+  import_node_fs20.default.mkdirSync(dir, { recursive: true });
+  import_node_fs20.default.writeFileSync(configPathFor(cwd), JSON.stringify(config, null, 2) + `
 `, "utf8");
 };
 var walkUpForPyproject2 = (start) => {
-  let dir = import_node_path20.default.resolve(start);
-  while (dir !== import_node_path20.default.dirname(dir)) {
-    if (import_node_fs19.default.existsSync(import_node_path20.default.join(dir, "pyproject.toml")))
+  let dir = import_node_path21.default.resolve(start);
+  while (dir !== import_node_path21.default.dirname(dir)) {
+    if (import_node_fs20.default.existsSync(import_node_path21.default.join(dir, "pyproject.toml")))
       return dir;
-    dir = import_node_path20.default.dirname(dir);
+    dir = import_node_path21.default.dirname(dir);
   }
   return null;
 };
 var ensureBackendDir2 = async (cwd) => {
   const config = readConfig2(cwd);
   if (config.backendProjectDir) {
-    const dir = import_node_path20.default.resolve(cwd, config.backendProjectDir);
-    if (import_node_fs19.default.existsSync(dir) && import_node_fs19.default.statSync(dir).isDirectory())
+    const dir = import_node_path21.default.resolve(cwd, config.backendProjectDir);
+    if (import_node_fs20.default.existsSync(dir) && import_node_fs20.default.statSync(dir).isDirectory())
       return dir;
     console.error(`[pieui] Configured backendProjectDir not found: ${dir}`);
   }
@@ -197772,9 +197985,9 @@ var ensureBackendDir2 = async (cwd) => {
     const raw = (await rl.question("[pieui] Path to backend (pie) project: ")).trim();
     if (!raw)
       return null;
-    const expanded = raw.startsWith("~") ? import_node_path20.default.join(process.env.HOME || "", raw.slice(1).replace(/^[\\/]/, "")) : raw;
-    const absolute = import_node_path20.default.resolve(expanded);
-    if (!import_node_fs19.default.existsSync(absolute) || !import_node_fs19.default.statSync(absolute).isDirectory()) {
+    const expanded = raw.startsWith("~") ? import_node_path21.default.join(process.env.HOME || "", raw.slice(1).replace(/^[\\/]/, "")) : raw;
+    const absolute = import_node_path21.default.resolve(expanded);
+    if (!import_node_fs20.default.existsSync(absolute) || !import_node_fs20.default.statSync(absolute).isDirectory()) {
       console.error(`[pieui] Not a directory: ${absolute}`);
       return null;
     }
@@ -197808,11 +198021,11 @@ var generateCode = (length = CODE_LENGTH) => {
 var tryOpenBrowser = (url) => {
   try {
     if (process.platform === "win32") {
-      import_node_child_process6.execFile("cmd", ["/c", "start", "", url], () => {});
+      import_node_child_process7.execFile("cmd", ["/c", "start", "", url], () => {});
     } else if (process.platform === "darwin") {
-      import_node_child_process6.execFile("open", [url], () => {});
+      import_node_child_process7.execFile("open", [url], () => {});
     } else {
-      import_node_child_process6.execFile("xdg-open", [url], () => {});
+      import_node_child_process7.execFile("xdg-open", [url], () => {});
     }
   } catch {}
 };
@@ -197843,8 +198056,8 @@ var appendPieCredentialsToEnv = (cwd, config) => {
   if (Object.keys(entries).length === 0) {
     return;
   }
-  const envPath = import_node_path21.default.join(cwd, ".env");
-  let content = import_node_fs20.default.existsSync(envPath) ? import_node_fs20.default.readFileSync(envPath, "utf8") : "";
+  const envPath = import_node_path22.default.join(cwd, ".env");
+  let content = import_node_fs21.default.existsSync(envPath) ? import_node_fs21.default.readFileSync(envPath, "utf8") : "";
   if (content.length > 0 && !content.endsWith(`
 `)) {
     content += `
@@ -197854,7 +198067,7 @@ var appendPieCredentialsToEnv = (cwd, config) => {
   content += `${additions.join(`
 `)}
 `;
-  import_node_fs20.default.writeFileSync(envPath, content, "utf8");
+  import_node_fs21.default.writeFileSync(envPath, content, "utf8");
   console.log(`[pie] Appended credentials to ${envPath}`);
 };
 async function loginCommand(options = {}) {
@@ -197875,8 +198088,8 @@ async function loginCommand(options = {}) {
   try {
     openBrowser(connectUrl);
   } catch {}
-  const pieDir = import_node_path21.default.join(cwd, ".pie");
-  const configPath = import_node_path21.default.join(pieDir, "config.json");
+  const pieDir = import_node_path22.default.join(cwd, ".pie");
+  const configPath = import_node_path22.default.join(pieDir, "config.json");
   const url = `${credentialsApi}?${new URLSearchParams({ code }).toString()}`;
   let first = true;
   while (true) {
@@ -197910,7 +198123,7 @@ async function loginCommand(options = {}) {
         throw new Error("Login succeeded but response had no 'config' field");
       }
       const credBlob = typeof record.config === "object" && record.config !== null && !Array.isArray(record.config) ? record.config : {};
-      import_node_fs20.default.mkdirSync(pieDir, { recursive: true });
+      import_node_fs21.default.mkdirSync(pieDir, { recursive: true });
       mergeConfig(cwd, credBlob);
       console.log(`[pie] Saved credentials to ${configPath}`);
       appendPieCredentialsToEnv(cwd, record.config);
@@ -197925,9 +198138,9 @@ async function loginCommand(options = {}) {
 }
 
 // src/code/commands/selfUpgrade.ts
-var import_node_child_process7 = require("node:child_process");
-var import_node_fs21 = __toESM(require("node:fs"));
-var import_node_path22 = __toESM(require("node:path"));
+var import_node_child_process8 = require("node:child_process");
+var import_node_fs22 = __toESM(require("node:fs"));
+var import_node_path23 = __toESM(require("node:path"));
 var __dirname = "/home/runner/work/pieui/pieui/src/code/commands";
 var PACKAGE_NAME = "@swarm.ing/pieui";
 var INSTALL_ARGS = {
@@ -197938,7 +198151,7 @@ var INSTALL_ARGS = {
 };
 var isPackageManager = (value2) => value2 === "bun" || value2 === "npm" || value2 === "pnpm" || value2 === "yarn";
 var hasBinary = (bin) => {
-  const result = import_node_child_process7.spawnSync("which", [bin], { stdio: "ignore" });
+  const result = import_node_child_process8.spawnSync("which", [bin], { stdio: "ignore" });
   return result.status === 0;
 };
 var detectPackageManager = () => {
@@ -197951,13 +198164,13 @@ var detectPackageManager = () => {
 };
 var readInstalledVersion = () => {
   const candidates = [
-    import_node_path22.default.resolve(__dirname, "..", "package.json"),
-    import_node_path22.default.resolve(__dirname, "..", "..", "package.json"),
-    import_node_path22.default.resolve(__dirname, "..", "..", "..", "package.json")
+    import_node_path23.default.resolve(__dirname, "..", "package.json"),
+    import_node_path23.default.resolve(__dirname, "..", "..", "package.json"),
+    import_node_path23.default.resolve(__dirname, "..", "..", "..", "package.json")
   ];
   for (const file of candidates) {
     try {
-      const raw = import_node_fs21.default.readFileSync(file, "utf8");
+      const raw = import_node_fs22.default.readFileSync(file, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed.name === PACKAGE_NAME && parsed.version) {
         return parsed.version;
@@ -197981,7 +198194,7 @@ var selfUpgradeCommand = async (override) => {
   }
   const args = INSTALL_ARGS[pm];
   console.log(`[pieui] Upgrading via ${pm}: ${pm} ${args.join(" ")}`);
-  const result = import_node_child_process7.spawnSync(pm, args, {
+  const result = import_node_child_process8.spawnSync(pm, args, {
     stdio: "inherit",
     env: process.env
   });
@@ -198040,7 +198253,11 @@ var main = async () => {
     historyPage,
     historyPerPage,
     historyFrom,
-    historyTo
+    historyTo,
+    registryAction,
+    registryPort,
+    registryApiServer,
+    registryOut
   } = args;
   console.log(`[pieui] CLI started with command: "${command}"`);
   switch (command) {
@@ -198064,9 +198281,22 @@ var main = async () => {
     case "self-upgrade":
       await selfUpgradeCommand(args.selfUpgradePm);
       return;
+    case "registry": {
+      if (registryAction !== "dev" && registryAction !== "build") {
+        console.error("[pieui] Error: Supported registry subcommands: dev, build");
+        printUsage();
+        process.exit(1);
+      }
+      registryCommand(registryAction, {
+        port: registryPort,
+        apiServer: registryApiServer,
+        out: registryOut
+      });
+      return;
+    }
     case "postbuild":
-      console.log(`[pieui] Source directory: ${import_node_path23.default.resolve(process.cwd(), srcDir)}`);
-      console.log(`[pieui] Output directory: ${import_node_path23.default.resolve(process.cwd(), outDir)}`);
+      console.log(`[pieui] Source directory: ${import_node_path24.default.resolve(process.cwd(), srcDir)}`);
+      console.log(`[pieui] Output directory: ${import_node_path24.default.resolve(process.cwd(), outDir)}`);
       console.log(`[pieui] Append mode: ${append}`);
       await postbuildCommand(srcDir, outDir, append);
       return;

package/dist/code/args.d.ts

@@ -1,6 +1,6 @@
 import type { ParsedArgs } from './types';
 export declare const parseArgs: (argv: string[]) => ParsedArgs;
-export type HelpScope = 'all' | 'login' | 'create' | 'init' | 'postbuild' | 'card' | 'card-remote' | 'page' | 'self-upgrade';
+export type HelpScope = 'all' | 'login' | 'create' | 'init' | 'postbuild' | 'card' | 'card-remote' | 'page' | 'registry' | 'self-upgrade';
 export declare const detectHelpScope: (argv: string[]) => HelpScope | null;
 export declare const printUsage: (scope?: HelpScope) => void;
 //# sourceMappingURL=args.d.ts.map

package/dist/code/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/code/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAOR,UAAU,EACb,MAAM,SAAS,CAAA;AA0KhB,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,KAAG,UA8I1C,CAAA;AAED,MAAM,MAAM,SAAS,GACf,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,WAAW,GACX,MAAM,GACN,aAAa,GACb,MAAM,GACN,cAAc,CAAA;AAEpB,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,KAAG,SAAS,GAAG,IAe5D,CAAA;AA0MD,eAAO,MAAM,UAAU,GAAI,QAAO,SAAiB,SAwBlD,CAAA"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/code/args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAOR,UAAU,EAEb,MAAM,SAAS,CAAA;AA0KhB,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,KAAG,UAyK1C,CAAA;AAED,MAAM,MAAM,SAAS,GACf,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,WAAW,GACX,MAAM,GACN,aAAa,GACb,MAAM,GACN,UAAU,GACV,cAAc,CAAA;AAEpB,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,KAAG,SAAS,GAAG,IAgB5D,CAAA;AA8MD,eAAO,MAAM,UAAU,GAAI,QAAO,SAAiB,SAwBlD,CAAA"}

package/dist/code/commands/createPieApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createPieApp.d.ts","sourceRoot":"","sources":["../../../src/code/commands/createPieApp.ts"],"names":[],"mappings":"AAoOA,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,SAyElD,CAAA"}
+{"version":3,"file":"createPieApp.d.ts","sourceRoot":"","sources":["../../../src/code/commands/createPieApp.ts"],"names":[],"mappings":"AAqOA,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,SAyElD,CAAA"}

package/dist/code/commands/registry.d.ts

@@ -0,0 +1,8 @@
+type RegistryOptions = {
+    port?: number;
+    apiServer?: string;
+    out?: string;
+};
+export declare const registryCommand: (action: "dev" | "build", opts?: RegistryOptions) => void;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/code/commands/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/code/commands/registry.ts"],"names":[],"mappings":"AAyBA,KAAK,eAAe,GAAG;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AA2LD,eAAO,MAAM,eAAe,GACxB,QAAQ,KAAK,GAAG,OAAO,EACvB,OAAM,eAAoB,KAC3B,IAiDF,CAAA"}

package/dist/code/types.d.ts

@@ -39,7 +39,12 @@ export type ParsedArgs = {
     selfUpgradePm?: string;
     dumpMetadataOut?: string;
     cardGeneratePreviewOut?: string;
+    registryAction?: RegistryAction;
+    registryPort?: number;
+    registryApiServer?: string;
+    registryOut?: string;
 };
+export type RegistryAction = 'dev' | 'build';
 export type CardScaffoldOptions = {
     ajax?: boolean;
     io?: boolean;

package/dist/code/types.d.ts.map

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

package/dist/components/LazyBoundary/index.d.ts

@@ -0,0 +1,43 @@
+import { Component, ReactNode } from 'react';
+/**
+ * Error boundary + Suspense wrapper for a single lazy (code-split) card.
+ *
+ * A `React.lazy` chunk can fail to load — a flaky network, or (commonly) a
+ * fresh deploy that changed chunk hashes so the running tab requests a chunk
+ * that now 404s. A bare `<Suspense>` does NOT catch that: the error propagates
+ * and white-screens the tree. This boundary instead:
+ *
+ *   1. renders the card's `fallback` (its skeleton) instead of crashing,
+ *   2. retries the import a couple of times with backoff — remounting the
+ *      Suspense subtree, which re-runs the loader (the module cache evicts a
+ *      rejected promise, so the retry is a fresh attempt), and
+ *   3. calls `onError` so the host can recover from a stale deploy (e.g. a
+ *      one-shot page reload).
+ *
+ * If the retries are exhausted it stays on the fallback rather than throwing,
+ * so one broken card never takes down the whole screen.
+ */
+type Props = {
+    /** Stable key (the card name) — resets the boundary if the card changes. */
+    name: string;
+    /** Shown while loading and as the give-up state (the card's skeleton). */
+    fallback: ReactNode;
+    /** Called on each caught chunk error, after retries are scheduled. */
+    onError?: (error: unknown) => void;
+    children: ReactNode;
+};
+type State = {
+    failed: boolean;
+    attempt: number;
+};
+export default class LazyBoundary extends Component<Props, State> {
+    state: State;
+    private timer;
+    static getDerivedStateFromError(): Partial<State>;
+    componentDidCatch(error: unknown): void;
+    componentDidUpdate(prevProps: Props): void;
+    componentWillUnmount(): void;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/components/LazyBoundary/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/LazyBoundary/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAY,MAAM,OAAO,CAAA;AAEtD;;;;;;;;;;;;;;;;;GAiBG;AAEH,KAAK,KAAK,GAAG;IACT,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;IACZ,0EAA0E;IAC1E,QAAQ,EAAE,SAAS,CAAA;IACnB,sEAAsE;IACtE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,QAAQ,EAAE,SAAS,CAAA;CACtB,CAAA;AAED,KAAK,KAAK,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAKjD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;IAC7D,KAAK,EAAE,KAAK,CAAgC;IAC5C,OAAO,CAAC,KAAK,CAA2C;IAExD,MAAM,CAAC,wBAAwB,IAAI,OAAO,CAAC,KAAK,CAAC;IAIjD,iBAAiB,CAAC,KAAK,EAAE,OAAO;IAWhC,kBAAkB,CAAC,SAAS,EAAE,KAAK;IAOnC,oBAAoB;IAIpB,MAAM;CAWT"}