@tangle-network/blueprint-ui 0.3.1 → 0.5.0

package/dist/iframe/testing-index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/iframe/testing.tsx"],"sourcesContent":["// Testing harness for iframe blueprints. The promise of the SDK is that\n// publishers can iterate on their UI without running the Tangle Cloud dapp\n// — these utilities are what makes that true.\n\nimport {\n  type FC,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport type { Address } from 'viem';\n\nimport type {\n  ServiceSnapshot,\n  WalletSnapshot,\n} from './tangleIframeClient';\nimport type {\n  CallJobRequest,\n  JobInputs,\n  JobResultEvent,\n  ParentMessage,\n  ServiceContextBroadcast,\n  ServiceContextJob,\n  ServiceContextOperator,\n} from '../wallet/parentBridgeProtocol';\n\nexport type MockWalletInput = Partial<{\n  address: Address | null;\n  chainId: number;\n  isConnected: boolean;\n}>;\n\nexport type MockServiceInput = Partial<{\n  blueprintId: string;\n  serviceId: string | null;\n  operators: readonly ServiceContextOperator[];\n  jobs: readonly ServiceContextJob[];\n  mode: string | null;\n  chain: import('../wallet/parentBridgeProtocol').ChainContext | null;\n}>;\n\n/**\n * Construct a deterministic wallet snapshot for tests. Defaults:\n * connected, vitalik.eth's address, Base Sepolia (84532).\n */\nexport function mockWallet(input: MockWalletInput = {}): WalletSnapshot {\n  return {\n    address:\n      input.address === undefined\n        ? '0xd8da6bf26964af9d7eed9e03e53415d37aa96045'\n        : input.address,\n    chainId: input.chainId ?? 84532,\n    isConnected: input.isConnected ?? input.address !== null,\n  };\n}\n\n/**\n * Construct a deterministic service snapshot for tests. Defaults: blueprint\n * id `0`, no service deployed yet (serviceId null), single mock operator on\n * the canonical local sidecar URL.\n */\nexport function mockServiceContext(\n  input: MockServiceInput = {},\n): ServiceSnapshot {\n  return {\n    blueprintId: input.blueprintId ?? '0',\n    serviceId: input.serviceId === undefined ? null : input.serviceId,\n    operators:\n      input.operators ?? [\n        {\n          address: '0x70997970C51812dc3A010C7d01b50e0d17dc79C8',\n          rpcAddress: 'http://localhost:8545',\n          status: 'active',\n        },\n      ],\n    jobs:\n      input.jobs ?? [\n        { index: 0, name: 'invoke' },\n      ],\n    mode: input.mode ?? null,\n    chain:\n      input.chain === undefined\n        ? {\n            id: 84532,\n            name: 'Base Sepolia',\n            rpcUrl: 'https://sepolia.base.org',\n            blockExplorerUrl: 'https://sepolia.basescan.org',\n            nativeCurrency: { name: 'Sepolia Ether', symbol: 'ETH', decimals: 18 },\n          }\n        : input.chain,\n  };\n}\n\nexport type CallJobHandler = (\n  request: CallJobRequest,\n) => Promise<{\n  status: 'success' | 'error';\n  data?: unknown;\n  error?: string;\n  /** Streaming chunks emitted in order before the terminal status. */\n  chunks?: readonly unknown[];\n}>;\n\ntype HarnessProps = {\n  appId?: string;\n  wallet?: WalletSnapshot;\n  service?: ServiceSnapshot;\n  /** Override callJob behavior. Default: returns a static `{ ok: true }`. */\n  onCallJob?: CallJobHandler;\n  /** Surface a floating debug panel that lets the developer flip state at runtime. */\n  showDebugPanel?: boolean;\n  children: ReactNode;\n};\n\n/**\n * Drop-in parent simulator for tests + storybook + standalone dev. Wraps\n * children in a fake parent that:\n *\n *   - Acks the iframe's handshake immediately\n *   - Broadcasts the configured wallet + service context on mount\n *   - Intercepts `callJob` requests and routes them through `onCallJob`\n *   - (Optional) Mounts a floating debug panel so the developer can\n *     mutate state at runtime: change account, switch chain, set\n *     serviceId, fire a custom job\n *\n * The harness runs in the same JS context as the iframe app — there's no\n * cross-frame postMessage, just same-window event dispatch. That keeps it\n * fully synchronous + assertable, but the messages still flow through the\n * exact same protocol surface the production bridge uses.\n *\n * Usage:\n *\n *   <TangleParentHarness wallet={mockWallet()} service={mockServiceContext()}>\n *     <TangleIframeProvider appId=\"my-app\" mode=\"bridge\" parentOrigin=\"harness://\">\n *       <App />\n *     </TangleIframeProvider>\n *   </TangleParentHarness>\n *\n * Set `mode=\"bridge\"` + `parentOrigin=\"harness://\"` on the provider so it\n * matches the harness's synthetic origin. In production, use `mode=\"auto\"`\n * (the default).\n */\nexport const TangleParentHarness: FC<HarnessProps> = ({\n  appId = 'harness',\n  wallet = mockWallet(),\n  service = mockServiceContext(),\n  onCallJob,\n  showDebugPanel = false,\n  children,\n}) => {\n  const [currentWallet, setCurrentWallet] = useState<WalletSnapshot>(wallet);\n  const [currentService, setCurrentService] =\n    useState<ServiceSnapshot>(service);\n  const [callLog, setCallLog] = useState<CallJobRequest[]>([]);\n  const callJobHandler = useRef<CallJobHandler | undefined>(onCallJob);\n  callJobHandler.current = onCallJob;\n  const seenHandshake = useRef(false);\n\n  // Listen for iframe → \"parent\" messages. Since the harness shares the\n  // window, `window.postMessage` with the synthetic origin is the easiest\n  // wire — the iframe SDK posts to `window.parent`, which in same-window\n  // mode IS this listener.\n  useEffect(() => {\n    const reply = (message: ParentMessage) => {\n      window.dispatchEvent(\n        new MessageEvent('message', {\n          data: message,\n          origin: HARNESS_ORIGIN,\n        }),\n      );\n    };\n\n    const broadcast = () => {\n      const broadcastMsg: ServiceContextBroadcast = {\n        kind: 'tangle.app.serviceContext',\n        blueprintId: currentService.blueprintId ?? '0',\n        serviceId: currentService.serviceId,\n        operators: currentService.operators,\n        jobs: currentService.jobs,\n        mode: currentService.mode,\n        ...(currentService.chain !== null\n          ? { chain: currentService.chain }\n          : {}),\n      };\n      reply(broadcastMsg);\n      // Also broadcast wallet — combined into accountChanged + chainChanged.\n      reply({\n        kind: 'tangle.app.accountChanged',\n        account: currentWallet.address,\n      });\n      if (currentWallet.chainId !== null) {\n        reply({\n          kind: 'tangle.app.chainChanged',\n          chainId: currentWallet.chainId,\n        });\n      }\n    };\n\n    const handler = async (event: MessageEvent) => {\n      // The iframe posts via `window.parent.postMessage(msg, parentOrigin)`.\n      // In same-window mode, that fires a message event on this same window\n      // with origin = parentOrigin. Filter out events the harness itself\n      // dispatched (origin === HARNESS_ORIGIN) — those are replies.\n      if (event.origin === HARNESS_ORIGIN) return;\n      const data = event.data;\n      if (typeof data !== 'object' || data === null) return;\n      const message = data as { kind?: string; correlationId?: string };\n\n      switch (message.kind) {\n        case 'tangle.app.handshake': {\n          if (!seenHandshake.current) {\n            seenHandshake.current = true;\n            reply({\n              kind: 'tangle.app.handshakeAck',\n              appId,\n              protocolVersion: '1',\n            });\n            broadcast();\n          }\n          return;\n        }\n        case 'tangle.app.readAccount': {\n          if (typeof message.correlationId !== 'string') return;\n          reply({\n            kind: 'tangle.app.readAccountResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: {\n              account:\n                currentWallet.address ??\n                ('0x0000000000000000000000000000000000000000' as Address),\n              chainId: currentWallet.chainId ?? 0,\n            },\n          });\n          return;\n        }\n        case 'tangle.app.callJob': {\n          if (typeof message.correlationId !== 'string') return;\n          const request = message as unknown as CallJobRequest;\n          setCallLog((prev) => [...prev, request]);\n          // Default behavior when no handler: emit a single `success` with\n          // a echo of the inputs so UIs render *something* in dev mode.\n          const handler = callJobHandler.current;\n          if (!handler) {\n            const result: JobResultEvent = {\n              kind: 'tangle.app.jobResult',\n              correlationId: request.correlationId,\n              status: 'success',\n              data: { echo: request.inputs },\n            };\n            reply(result);\n            return;\n          }\n          try {\n            const outcome = await handler(request);\n            for (const chunk of outcome.chunks ?? []) {\n              reply({\n                kind: 'tangle.app.jobResult',\n                correlationId: request.correlationId,\n                status: 'streaming',\n                chunk,\n              });\n            }\n            reply({\n              kind: 'tangle.app.jobResult',\n              correlationId: request.correlationId,\n              status: outcome.status,\n              ...(outcome.data !== undefined ? { data: outcome.data } : {}),\n              ...(outcome.error !== undefined ? { error: outcome.error } : {}),\n            });\n          } catch (err) {\n            reply({\n              kind: 'tangle.app.jobResult',\n              correlationId: request.correlationId,\n              status: 'error',\n              error: err instanceof Error ? err.message : String(err),\n            });\n          }\n          return;\n        }\n        // Wallet ops respond optimistically — tests that want to assert\n        // specific signatures should pre-set them via the dev handler.\n        case 'tangle.app.signMessage': {\n          if (typeof message.correlationId !== 'string') return;\n          reply({\n            kind: 'tangle.app.signMessageResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: { signature: '0xdeadbeef' as `0x${string}` },\n          });\n          return;\n        }\n        case 'tangle.app.signTypedData': {\n          if (typeof message.correlationId !== 'string') return;\n          // The harness signs deterministically — production parents show\n          // an approval modal first. Tests that need to assert the\n          // typed-data payload should inspect callLog (extend later if\n          // needed) or pass a custom onSignTypedData handler.\n          reply({\n            kind: 'tangle.app.signTypedDataResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: {\n              signature: ('0x' + '11'.repeat(65)) as `0x${string}`,\n            },\n          });\n          return;\n        }\n        case 'tangle.app.signTransaction': {\n          if (typeof message.correlationId !== 'string') return;\n          reply({\n            kind: 'tangle.app.signTransactionResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: { txHash: ('0x' + '00'.repeat(32)) as `0x${string}` },\n          });\n          return;\n        }\n        case 'tangle.app.switchChain': {\n          if (\n            typeof message.correlationId !== 'string' ||\n            typeof (message as unknown as { chainId?: number }).chainId !== 'number'\n          ) {\n            return;\n          }\n          const chainId = (message as unknown as { chainId: number }).chainId;\n          setCurrentWallet((w) => ({ ...w, chainId }));\n          reply({\n            kind: 'tangle.app.switchChainResult',\n            correlationId: message.correlationId,\n            ok: true,\n            data: { chainId },\n          });\n          return;\n        }\n      }\n    };\n    window.addEventListener('message', handler);\n    return () => window.removeEventListener('message', handler);\n  }, [appId, currentWallet, currentService]);\n\n  // Re-broadcast when state changes.\n  useEffect(() => {\n    if (!seenHandshake.current) return;\n    window.dispatchEvent(\n      new MessageEvent('message', {\n        data: {\n          kind: 'tangle.app.accountChanged',\n          account: currentWallet.address,\n        },\n        origin: HARNESS_ORIGIN,\n      }),\n    );\n  }, [currentWallet.address]);\n\n  useEffect(() => {\n    if (!seenHandshake.current || currentWallet.chainId === null) return;\n    window.dispatchEvent(\n      new MessageEvent('message', {\n        data: {\n          kind: 'tangle.app.chainChanged',\n          chainId: currentWallet.chainId,\n        },\n        origin: HARNESS_ORIGIN,\n      }),\n    );\n  }, [currentWallet.chainId]);\n\n  useEffect(() => {\n    if (!seenHandshake.current) return;\n    window.dispatchEvent(\n      new MessageEvent('message', {\n        data: {\n          kind: 'tangle.app.serviceContext',\n          blueprintId: currentService.blueprintId ?? '0',\n          serviceId: currentService.serviceId,\n          operators: currentService.operators,\n          jobs: currentService.jobs,\n          mode: currentService.mode,\n          ...(currentService.chain !== null\n            ? { chain: currentService.chain }\n            : {}),\n        },\n        origin: HARNESS_ORIGIN,\n      }),\n    );\n  }, [currentService]);\n\n  const debugApi = useMemo(\n    () => ({\n      setWallet: setCurrentWallet,\n      setService: setCurrentService,\n      callLog,\n    }),\n    [callLog],\n  );\n\n  return (\n    <>\n      {children}\n      {showDebugPanel && <DebugPanel api={debugApi} />}\n    </>\n  );\n};\n\n/**\n * Synthetic origin every harness instance uses. Stable across tests so the\n * iframe SDK + the harness can pin to the same string.\n */\nexport const HARNESS_ORIGIN = 'harness://tangle.local';\n\n// ── Debug panel ──────────────────────────────────────────────────────────────\n\nconst DebugPanel: FC<{\n  api: {\n    setWallet: (w: WalletSnapshot | ((prev: WalletSnapshot) => WalletSnapshot)) => void;\n    setService: (\n      s: ServiceSnapshot | ((prev: ServiceSnapshot) => ServiceSnapshot),\n    ) => void;\n    callLog: readonly CallJobRequest[];\n  };\n}> = ({ api }) => {\n  const [open, setOpen] = useState(true);\n  const [tab, setTab] = useState<'wallet' | 'service' | 'log'>('wallet');\n  if (!open) {\n    return (\n      <button\n        type=\"button\"\n        onClick={() => setOpen(true)}\n        style={debugStyles.collapsedTrigger}\n      >\n        Debug\n      </button>\n    );\n  }\n  return (\n    <div style={debugStyles.panel}>\n      <header style={debugStyles.header}>\n        <strong style={{ fontSize: 11 }}>TANGLE DEV HARNESS</strong>\n        <button\n          type=\"button\"\n          onClick={() => setOpen(false)}\n          style={debugStyles.closeButton}\n          aria-label=\"Close debug panel\"\n        >\n          ×\n        </button>\n      </header>\n      <nav style={debugStyles.tabs}>\n        {(['wallet', 'service', 'log'] as const).map((t) => (\n          <button\n            key={t}\n            type=\"button\"\n            onClick={() => setTab(t)}\n            style={{\n              ...debugStyles.tab,\n              ...(tab === t ? debugStyles.tabActive : {}),\n            }}\n          >\n            {t}\n          </button>\n        ))}\n      </nav>\n      <div style={debugStyles.body}>\n        {tab === 'wallet' && <WalletTab api={api} />}\n        {tab === 'service' && <ServiceTab api={api} />}\n        {tab === 'log' && <CallLogTab callLog={api.callLog} />}\n      </div>\n    </div>\n  );\n};\n\nconst WalletTab: FC<{\n  api: { setWallet: (w: WalletSnapshot | ((prev: WalletSnapshot) => WalletSnapshot)) => void };\n}> = ({ api }) => {\n  const [address, setAddressInput] = useState(\n    '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',\n  );\n  const [chainId, setChainIdInput] = useState('84532');\n  const applyConnect = useCallback(() => {\n    api.setWallet({\n      address: address as Address,\n      chainId: Number(chainId) || null,\n      isConnected: true,\n    });\n  }, [address, chainId, api]);\n  const disconnect = useCallback(() => {\n    api.setWallet({ address: null, chainId: null, isConnected: false });\n  }, [api]);\n  return (\n    <div>\n      <label style={debugStyles.label}>address</label>\n      <input\n        value={address}\n        onChange={(e) => setAddressInput(e.target.value)}\n        style={debugStyles.input}\n      />\n      <label style={debugStyles.label}>chain id</label>\n      <input\n        value={chainId}\n        onChange={(e) => setChainIdInput(e.target.value)}\n        style={debugStyles.input}\n      />\n      <div style={debugStyles.buttonRow}>\n        <button type=\"button\" onClick={applyConnect} style={debugStyles.primary}>\n          Set connected\n        </button>\n        <button type=\"button\" onClick={disconnect} style={debugStyles.secondary}>\n          Disconnect\n        </button>\n      </div>\n    </div>\n  );\n};\n\nconst ServiceTab: FC<{\n  api: {\n    setService: (\n      s: ServiceSnapshot | ((prev: ServiceSnapshot) => ServiceSnapshot),\n    ) => void;\n  };\n}> = ({ api }) => {\n  const [serviceId, setServiceIdInput] = useState('1');\n  const [blueprintId, setBlueprintIdInput] = useState('0');\n  const apply = useCallback(() => {\n    api.setService((prev) => ({\n      ...prev,\n      serviceId: serviceId || null,\n      blueprintId,\n    }));\n  }, [api, serviceId, blueprintId]);\n  const clearService = useCallback(() => {\n    api.setService((prev) => ({ ...prev, serviceId: null }));\n  }, [api]);\n  return (\n    <div>\n      <label style={debugStyles.label}>blueprint id</label>\n      <input\n        value={blueprintId}\n        onChange={(e) => setBlueprintIdInput(e.target.value)}\n        style={debugStyles.input}\n      />\n      <label style={debugStyles.label}>service id (empty = not deployed)</label>\n      <input\n        value={serviceId}\n        onChange={(e) => setServiceIdInput(e.target.value)}\n        style={debugStyles.input}\n      />\n      <div style={debugStyles.buttonRow}>\n        <button type=\"button\" onClick={apply} style={debugStyles.primary}>\n          Apply\n        </button>\n        <button type=\"button\" onClick={clearService} style={debugStyles.secondary}>\n          Clear service\n        </button>\n      </div>\n    </div>\n  );\n};\n\nconst CallLogTab: FC<{ callLog: readonly CallJobRequest[] }> = ({ callLog }) => {\n  if (callLog.length === 0) {\n    return <p style={debugStyles.empty}>No callJob requests yet.</p>;\n  }\n  return (\n    <ol style={debugStyles.log}>\n      {callLog.map((entry) => (\n        <li key={entry.correlationId} style={debugStyles.logEntry}>\n          <strong>job {entry.jobIndex}</strong>\n          <pre style={debugStyles.pre}>\n            {JSON.stringify(entry.inputs, null, 2)}\n          </pre>\n        </li>\n      ))}\n    </ol>\n  );\n};\n\n// Inline styles keep the harness style-system-agnostic — consumers may not\n// ship Tailwind, and the panel shouldn't add a dependency.\nconst debugStyles = {\n  panel: {\n    position: 'fixed' as const,\n    right: 12,\n    top: 12,\n    width: 280,\n    zIndex: 99999,\n    background: '#0b0b14',\n    color: '#fff',\n    border: '1px solid #3a3a52',\n    borderRadius: 10,\n    boxShadow: '0 14px 32px rgba(0,0,0,0.4)',\n    fontFamily:\n      'ui-monospace, SFMono-Regular, Menlo, Monaco, \"Cascadia Code\", monospace',\n    fontSize: 12,\n  },\n  header: {\n    display: 'flex',\n    alignItems: 'center',\n    justifyContent: 'space-between',\n    padding: '8px 10px',\n    borderBottom: '1px solid #2a2a3e',\n  },\n  closeButton: {\n    background: 'none',\n    border: 'none',\n    color: '#fff',\n    fontSize: 18,\n    cursor: 'pointer',\n    lineHeight: 1,\n  },\n  tabs: {\n    display: 'flex',\n    borderBottom: '1px solid #2a2a3e',\n  },\n  tab: {\n    flex: 1,\n    background: 'none',\n    border: 'none',\n    color: '#a0a0c0',\n    padding: '6px 8px',\n    cursor: 'pointer',\n    fontSize: 11,\n    textTransform: 'uppercase' as const,\n  },\n  tabActive: {\n    color: '#fff',\n    borderBottom: '2px solid #818cf8',\n  },\n  body: {\n    padding: 10,\n    maxHeight: 320,\n    overflow: 'auto' as const,\n  },\n  label: {\n    display: 'block',\n    color: '#a0a0c0',\n    fontSize: 10,\n    marginBottom: 4,\n    marginTop: 6,\n    textTransform: 'uppercase' as const,\n  },\n  input: {\n    width: '100%',\n    background: '#15152a',\n    border: '1px solid #2a2a3e',\n    color: '#fff',\n    padding: '6px 8px',\n    borderRadius: 4,\n    fontFamily: 'inherit',\n    fontSize: 11,\n    boxSizing: 'border-box' as const,\n  },\n  buttonRow: { display: 'flex', gap: 6, marginTop: 8 },\n  primary: {\n    flex: 1,\n    background: '#4f46e5',\n    color: '#fff',\n    border: 'none',\n    padding: '6px 8px',\n    borderRadius: 4,\n    cursor: 'pointer',\n    fontSize: 11,\n    fontFamily: 'inherit',\n  },\n  secondary: {\n    flex: 1,\n    background: 'transparent',\n    color: '#a0a0c0',\n    border: '1px solid #3a3a52',\n    padding: '6px 8px',\n    borderRadius: 4,\n    cursor: 'pointer',\n    fontSize: 11,\n    fontFamily: 'inherit',\n  },\n  collapsedTrigger: {\n    position: 'fixed' as const,\n    right: 12,\n    top: 12,\n    zIndex: 99999,\n    padding: '6px 10px',\n    background: '#0b0b14',\n    border: '1px solid #3a3a52',\n    color: '#fff',\n    borderRadius: 6,\n    fontFamily: 'inherit',\n    fontSize: 11,\n    cursor: 'pointer',\n  },\n  log: { listStyle: 'none', padding: 0, margin: 0 },\n  logEntry: {\n    padding: 6,\n    borderBottom: '1px solid #2a2a3e',\n    fontSize: 11,\n  },\n  pre: {\n    margin: '4px 0 0',\n    color: '#a0a0c0',\n    fontSize: 10,\n    whiteSpace: 'pre-wrap' as const,\n    wordBreak: 'break-word' as const,\n  },\n  empty: { color: '#a0a0c0', fontSize: 11, margin: 0 },\n} as const;\n\nexport type { JobInputs };\n"],"mappings":"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","names":["handler"]}

package/dist/parentBridgeProtocol-BS2zbIvX.d.ts

@@ -0,0 +1,194 @@
+import { Address, Hex } from 'viem';
+
+declare const TANGLE_IFRAME_PROTOCOL_VERSION: "1";
+declare const TANGLE_IFRAME_PROTOCOL_PREFIX = "tangle.app.";
+type HandshakeRequest = {
+    kind: 'tangle.app.handshake';
+    appId: string;
+    version: typeof TANGLE_IFRAME_PROTOCOL_VERSION;
+};
+type ReadAccountRequest = {
+    kind: 'tangle.app.readAccount';
+    correlationId: string;
+};
+type SwitchChainRequest = {
+    kind: 'tangle.app.switchChain';
+    correlationId: string;
+    chainId: number;
+};
+type SignMessageRequest = {
+    kind: 'tangle.app.signMessage';
+    correlationId: string;
+    chainId: number;
+    message: string;
+};
+type SignTransactionRequest = {
+    kind: 'tangle.app.signTransaction';
+    correlationId: string;
+    chainId: number;
+    to: Address;
+    data: Hex;
+    value?: string;
+};
+type SignTypedDataRequest = {
+    kind: 'tangle.app.signTypedData';
+    correlationId: string;
+    chainId: number;
+    domain: Readonly<{
+        name?: string;
+        version?: string;
+        chainId?: number;
+        verifyingContract?: Address;
+        salt?: Hex;
+    }>;
+    /** EIP-712 types map; do NOT include the EIP712Domain entry (the parent
+     * injects it derived from `domain`). */
+    types: Readonly<Record<string, ReadonlyArray<{
+        name: string;
+        type: string;
+    }>>>;
+    /** Top-level type name in `types` whose values appear in `message`. */
+    primaryType: string;
+    /** The actual typed-data values. Shape matches `types[primaryType]`. */
+    message: Readonly<Record<string, unknown>>;
+};
+type HandshakeAck = {
+    kind: 'tangle.app.handshakeAck';
+    appId: string;
+    protocolVersion: typeof TANGLE_IFRAME_PROTOCOL_VERSION;
+};
+type ResultEnvelope<T> = {
+    correlationId: string;
+} & ({
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: string;
+});
+type ReadAccountResult = {
+    kind: 'tangle.app.readAccountResult';
+} & ResultEnvelope<{
+    account: Address;
+    chainId: number;
+}>;
+type SwitchChainResult = {
+    kind: 'tangle.app.switchChainResult';
+} & ResultEnvelope<{
+    chainId: number;
+}>;
+type SignMessageResult = {
+    kind: 'tangle.app.signMessageResult';
+} & ResultEnvelope<{
+    signature: Hex;
+}>;
+type SignTransactionResult = {
+    kind: 'tangle.app.signTransactionResult';
+} & ResultEnvelope<{
+    txHash: Hex;
+}>;
+type SignTypedDataResult = {
+    kind: 'tangle.app.signTypedDataResult';
+} & ResultEnvelope<{
+    signature: Hex;
+}>;
+type AccountChanged = {
+    kind: 'tangle.app.accountChanged';
+    account: Address | null;
+};
+type ChainChanged = {
+    kind: 'tangle.app.chainChanged';
+    chainId: number;
+};
+type ServiceContextOperator = {
+    readonly address: Address;
+    readonly rpcAddress: string | undefined;
+    readonly status: 'active' | 'inactive' | 'unknown';
+};
+type ServiceContextJob = {
+    readonly index: number;
+    readonly name: string;
+    readonly inputSchema?: unknown;
+};
+/**
+ * Chain configuration the parent broadcasts to the iframe along with
+ * service context. Iframes use this to build a `viem` public client for
+ * READ-ONLY queries (`useTanglePublicClient` is the convenience hook).
+ *
+ * Iframes can ignore this and roll their own RPC config — particularly
+ * when they need to read from chains OTHER than the active one (e.g. a
+ * trading dapp pulling oracle data from mainnet while the active service
+ * lives on Base Sepolia). The injected client is a hint, not a constraint.
+ *
+ * `rpcUrl` is the public RPC the parent uses, NOT a wallet RPC. Iframes
+ * cannot sign or submit with this URL; signing always routes upstream via
+ * the bridge.
+ */
+type ChainContext = {
+    readonly id: number;
+    readonly name: string;
+    readonly rpcUrl: string;
+    /** Block-explorer base URL — useful for rendering tx links. */
+    readonly blockExplorerUrl?: string;
+    /** Native currency metadata for cost displays. */
+    readonly nativeCurrency?: {
+        readonly name: string;
+        readonly symbol: string;
+        readonly decimals: number;
+    };
+};
+type ServiceContextBroadcast = {
+    kind: 'tangle.app.serviceContext';
+    readonly blueprintId: string;
+    readonly serviceId: string | null;
+    readonly operators: readonly ServiceContextOperator[];
+    readonly jobs: readonly ServiceContextJob[];
+    readonly mode: string | null;
+    /** Active chain the parent is connected to; iframes can build a viem
+     * publicClient against this for convenience. Optional for backwards
+     * compatibility with parents that haven't been upgraded yet. */
+    readonly chain?: ChainContext;
+};
+type JobInputs = Readonly<Record<string, unknown>>;
+type CallJobRequest = {
+    kind: 'tangle.app.callJob';
+    correlationId: string;
+    /** Job index within the blueprint, e.g. 0 for the primary entry-point. */
+    jobIndex: number;
+    /** Free-form inputs validated by the parent against the on-chain ABI. */
+    inputs: JobInputs;
+    /**
+     * Whether the publisher wants intermediate progress (streaming chunks)
+     * or just the terminal result. Streaming jobs (LLM generation, video
+     * encode) opt in; one-shots (embeddings, classifications) don't.
+     */
+    stream?: boolean;
+};
+type JobResultStatus = 'pending' | 'streaming' | 'success' | 'error';
+type JobResultEvent = {
+    kind: 'tangle.app.jobResult';
+    correlationId: string;
+    status: JobResultStatus;
+    /** Present on `streaming` and `success`. Shape is publisher-defined. */
+    data?: unknown;
+    /** Present on `streaming` only — incremental chunk for live UI. */
+    chunk?: unknown;
+    /** Present on `error`. Human-readable. */
+    error?: string;
+    /** Optional progress metadata (e.g. `{ percent: 0.42, eta_ms: 8000 }`). */
+    progress?: {
+        readonly percent?: number;
+        readonly eta_ms?: number;
+    };
+};
+type ParentMessage = HandshakeAck | ReadAccountResult | SwitchChainResult | SignMessageResult | SignTransactionResult | SignTypedDataResult | AccountChanged | ChainChanged | ServiceContextBroadcast | JobResultEvent;
+type IframeRequest = HandshakeRequest | ReadAccountRequest | SwitchChainRequest | SignMessageRequest | SignTransactionRequest | SignTypedDataRequest | CallJobRequest;
+declare const NO_WALLET_ADDRESS = "0x0000000000000000000000000000000000000000";
+/**
+ * Cryptographically-random ASCII correlation id matching the parent's
+ * validator regex (`/^[\w.\-:]+$/`, max length 128). The connector keeps a
+ * Map<correlationId, Resolver> so each request resolves independently.
+ */
+declare function makeCorrelationId(prefix: string): string;
+
+export { type AccountChanged as A, type CallJobRequest as C, type HandshakeAck as H, type IframeRequest as I, type JobInputs as J, NO_WALLET_ADDRESS as N, type ParentMessage as P, type ReadAccountRequest as R, type ServiceContextBroadcast as S, TANGLE_IFRAME_PROTOCOL_PREFIX as T, type ChainChanged as a, type ChainContext as b, type HandshakeRequest as c, type JobResultEvent as d, type JobResultStatus as e, type ReadAccountResult as f, type ServiceContextJob as g, type ServiceContextOperator as h, type SignMessageRequest as i, type SignMessageResult as j, type SignTransactionRequest as k, type SignTransactionResult as l, type SignTypedDataRequest as m, type SignTypedDataResult as n, type SwitchChainRequest as o, type SwitchChainResult as p, TANGLE_IFRAME_PROTOCOL_VERSION as q, makeCorrelationId as r };

package/dist/styles.css

@@ -246,6 +246,7 @@
 .tracking-wider{--un-tracking:var(--tracking-wider);letter-spacing:var(--tracking-wider);}
 .font-medium{--un-font-weight:var(--fontWeight-medium);font-weight:var(--fontWeight-medium);}
 .font-semibold{--un-font-weight:var(--fontWeight-semibold);font-weight:var(--fontWeight-semibold);}
+.tab{-moz-tab-size:4;-o-tab-size:4;tab-size:4;}
 .mx-auto{margin-inline:auto;}
 .my-2{margin-block:calc(var(--spacing) * 2);}
 .mb-2{margin-bottom:calc(var(--spacing) * 2);}
@@ -403,6 +404,7 @@
 .inline{display:inline;}
 .block{display:block;}
 .hidden{display:none;}
+.collapse{visibility:collapse;}
 .cursor-pointer{cursor:pointer;}
 .\[\&_svg\]\:pointer-events-none svg,
 .pointer-events-none{pointer-events:none;}
@@ -458,6 +460,7 @@
 .absolute{position:absolute;}
 .fixed{position:fixed;}
 .relative{position:relative;}
+.static{position:static;}
 .z-50{z-index:50;}
 .overflow-auto{overflow:auto;}
 .overflow-hidden{overflow:hidden;}

package/dist/tangleIframeClient-DES8FDF0.d.ts

@@ -0,0 +1,121 @@
+import { Address, Hex } from 'viem';
+import { h as ServiceContextOperator, g as ServiceContextJob, b as ChainContext, e as JobResultStatus, m as SignTypedDataRequest, J as JobInputs } from './parentBridgeProtocol-BS2zbIvX.js';
+
+type WalletSnapshot = {
+    readonly address: Address | null;
+    readonly chainId: number | null;
+    readonly isConnected: boolean;
+};
+type ServiceSnapshot = {
+    readonly blueprintId: string | null;
+    readonly serviceId: string | null;
+    readonly operators: readonly ServiceContextOperator[];
+    readonly jobs: readonly ServiceContextJob[];
+    readonly mode: string | null;
+    /** Chain context broadcast by the parent — drives `useTanglePublicClient`.
+     * `null` when the parent hasn't sent one (older parent or dev mode). */
+    readonly chain: ChainContext | null;
+};
+type JobInvocation = {
+    readonly correlationId: string;
+    readonly status: JobResultStatus;
+    readonly data?: unknown;
+    readonly chunks: readonly unknown[];
+    readonly error?: string;
+    readonly progress?: {
+        readonly percent?: number;
+        readonly eta_ms?: number;
+    };
+};
+type ClientEventMap = {
+    wallet: WalletSnapshot;
+    service: ServiceSnapshot;
+    job: JobInvocation;
+};
+type Listener<K extends keyof ClientEventMap> = (value: ClientEventMap[K]) => void;
+type TangleIframeClientOptions = {
+    /**
+     * Origin of the parent dapp. The client posts every message with this
+     * exact `targetOrigin` and rejects inbound messages from any other origin.
+     * Pass `'*'` only in dev — production must pin to the real parent
+     * (`https://cloud.tangle.tools` etc.).
+     */
+    parentOrigin: string;
+    /**
+     * Stable identifier for this iframe app. The parent surfaces it in
+     * handshake logs + uses it for permission scoping.
+     */
+    appId: string;
+    /**
+     * Per-request timeout. Defaults to 60s — long enough for a user to
+     * read + approve a signing prompt in the parent. Long-running jobs
+     * stream progress events; the request "completes" only on terminal
+     * status, so the timeout protects against parents that drop replies
+     * entirely.
+     */
+    requestTimeoutMs?: number;
+};
+declare class TangleIframeClient {
+    private readonly options;
+    private wallet;
+    private service;
+    private handshakeAcked;
+    private handshakeWaiters;
+    private installed;
+    private listeners;
+    private pendingJobs;
+    constructor(options: TangleIframeClientOptions);
+    /** Wire the global message listener + initial handshake. Idempotent. */
+    install(): void;
+    uninstall(): void;
+    getWallet(): WalletSnapshot;
+    getService(): ServiceSnapshot;
+    subscribe<K extends keyof ClientEventMap>(event: K, listener: Listener<K>): () => void;
+    signMessage(message: string): Promise<Hex>;
+    sendTransaction(tx: {
+        to: Address;
+        data: Hex;
+        value?: bigint;
+    }): Promise<Hex>;
+    switchChain(chainId: number): Promise<number>;
+    /**
+     * EIP-712 typed-data signing. The parent renders the typed-data fields in
+     * its approval modal; the user audits what they're signing. Use for
+     * operator envelopes, off-chain attestations, anything that needs a
+     * signature outside the standard blueprint-job RFQ flow.
+     *
+     * Shape mirrors viem's `signTypedData` argument. Do not include the
+     * EIP712Domain entry in `types` — the parent injects it from `domain`.
+     */
+    signTypedData(args: {
+        domain: SignTypedDataRequest['domain'];
+        types: SignTypedDataRequest['types'];
+        primaryType: string;
+        message: Readonly<Record<string, unknown>>;
+    }): Promise<Hex>;
+    /**
+     * Invoke a blueprint job. Returns a Promise that resolves on terminal
+     * status (`success` or `error`); subscribe to the `job` event for
+     * intermediate streaming chunks.
+     *
+     * Streaming opt-in: pass `stream: true` if the publisher's job emits
+     * chunks (LLM generation, video encoding). One-shot jobs (embeddings,
+     * classifications) skip the streaming machinery.
+     */
+    callJob(args: {
+        jobIndex: number;
+        inputs: JobInputs;
+        stream?: boolean;
+    }): Promise<JobInvocation>;
+    private postHandshake;
+    private postToParent;
+    private handleParentMessage;
+    private dispatchWallet;
+    private handleJobResult;
+    private updateWallet;
+    private updateService;
+    private emit;
+    private ensureBootstrapped;
+}
+
+export { type ClientEventMap as C, type JobInvocation as J, type ServiceSnapshot as S, TangleIframeClient as T, type WalletSnapshot as W, type TangleIframeClientOptions as a };

package/dist/wallet/index.d.ts

@@ -1,30 +1,7 @@
+export { T as TANGLE_CLOUD_ORIGINS_DEFAULT, d as detectTangleCloudParentOrigin } from '../detectParentOrigin-BYruoIdc.js';
 import * as wagmi from 'wagmi';
-import { Address, Hex } from 'viem';
-
-/**
- * Default Tangle Cloud origins. Consumers (agent-sandbox UI,
- * trading-arena, future iframe blueprints) pass app-specific additions
- * via `extraOrigins` rather than mutating this list.
- */
-declare const TANGLE_CLOUD_ORIGINS_DEFAULT: readonly ["https://cloud.tangle.tools", "https://develop.cloud.tangle.tools", "http://localhost:4300", "http://localhost:8888"];
-/**
- * Returns the parent origin to bridge to, or null when no trusted parent is
- * detected. Caller should skip installing the bridge connector when this
- * returns null.
- *
- * `extraOrigins` is the application's escape hatch for staging or dev
- * deploys not covered by the default list. The library deliberately does
- * not read environment variables itself (consumers may bundle for non-Vite
- * runtimes); the consuming app threads `import.meta.env.VITE_*` or
- * `process.env.*` in itself.
- *
- * Falls back to a `?parent=<origin>` query parameter when no referrer is
- * present (some browsers strip referrer from cross-origin loads). Useful
- * for dev embedding flows.
- */
-declare function detectTangleCloudParentOrigin(options?: {
-    extraOrigins?: readonly string[];
-}): string | null;
+import { Address } from 'viem';
+export { A as AccountChanged, C as CallJobRequest, a as ChainChanged, b as ChainContext, H as HandshakeAck, c as HandshakeRequest, I as IframeRequest, J as JobInputs, d as JobResultEvent, e as JobResultStatus, N as NO_WALLET_ADDRESS, P as ParentMessage, R as ReadAccountRequest, f as ReadAccountResult, S as ServiceContextBroadcast, g as ServiceContextJob, h as ServiceContextOperator, i as SignMessageRequest, j as SignMessageResult, k as SignTransactionRequest, l as SignTransactionResult, m as SignTypedDataRequest, n as SignTypedDataResult, o as SwitchChainRequest, p as SwitchChainResult, T as TANGLE_IFRAME_PROTOCOL_PREFIX, q as TANGLE_IFRAME_PROTOCOL_VERSION, r as makeCorrelationId } from '../parentBridgeProtocol-BS2zbIvX.js';
 
 type EventName = 'accountsChanged' | 'chainChanged' | 'connect' | 'disconnect' | 'message';
 type Listener = (...args: unknown[]) => void;
@@ -89,6 +66,12 @@ declare class ParentBridgeProvider {
     private requestSignTransaction;
     private requestSwitchChain;
     private dispatch;
+    /**
+     * Resolves wallet-shape responses (`{ ok, data | error }`). Job results
+     * use a different envelope (`{ status, data?, chunk?, error? }`) and are
+     * routed through a separate listener registered by `useCallJob` / the SDK
+     * — the provider doesn't double-handle them.
+     */
     private resolvePending;
     private ensureBootstrapped;
     private updateAccount;
@@ -103,86 +86,4 @@ declare class ParentBridgeProvider {
 type ParentBridgeConnectorOptions = ParentBridgeOptions;
 declare function parentBridgeConnector(options: ParentBridgeConnectorOptions): wagmi.CreateConnectorFn<ParentBridgeProvider, Record<string, unknown>, Record<string, unknown>>;
 
-declare const TANGLE_IFRAME_PROTOCOL_VERSION: "1";
-declare const TANGLE_IFRAME_PROTOCOL_PREFIX = "tangle.app.";
-type HandshakeRequest = {
-    kind: 'tangle.app.handshake';
-    appId: string;
-    version: typeof TANGLE_IFRAME_PROTOCOL_VERSION;
-};
-type ReadAccountRequest = {
-    kind: 'tangle.app.readAccount';
-    correlationId: string;
-};
-type SwitchChainRequest = {
-    kind: 'tangle.app.switchChain';
-    correlationId: string;
-    chainId: number;
-};
-type SignMessageRequest = {
-    kind: 'tangle.app.signMessage';
-    correlationId: string;
-    chainId: number;
-    message: string;
-};
-type SignTransactionRequest = {
-    kind: 'tangle.app.signTransaction';
-    correlationId: string;
-    chainId: number;
-    to: Address;
-    data: Hex;
-    value?: string;
-};
-type HandshakeAck = {
-    kind: 'tangle.app.handshakeAck';
-    appId: string;
-    protocolVersion: typeof TANGLE_IFRAME_PROTOCOL_VERSION;
-};
-type ResultEnvelope<T> = {
-    correlationId: string;
-} & ({
-    ok: true;
-    data: T;
-} | {
-    ok: false;
-    error: string;
-});
-type ReadAccountResult = {
-    kind: 'tangle.app.readAccountResult';
-} & ResultEnvelope<{
-    account: Address;
-    chainId: number;
-}>;
-type SwitchChainResult = {
-    kind: 'tangle.app.switchChainResult';
-} & ResultEnvelope<{
-    chainId: number;
-}>;
-type SignMessageResult = {
-    kind: 'tangle.app.signMessageResult';
-} & ResultEnvelope<{
-    signature: Hex;
-}>;
-type SignTransactionResult = {
-    kind: 'tangle.app.signTransactionResult';
-} & ResultEnvelope<{
-    txHash: Hex;
-}>;
-type AccountChanged = {
-    kind: 'tangle.app.accountChanged';
-    account: Address | null;
-};
-type ChainChanged = {
-    kind: 'tangle.app.chainChanged';
-    chainId: number;
-};
-type ParentMessage = HandshakeAck | ReadAccountResult | SwitchChainResult | SignMessageResult | SignTransactionResult | AccountChanged | ChainChanged;
-declare const NO_WALLET_ADDRESS = "0x0000000000000000000000000000000000000000";
-/**
- * Cryptographically-random ASCII correlation id matching the parent's
- * validator regex (`/^[\w.\-:]+$/`, max length 128). The connector keeps a
- * Map<correlationId, Resolver> so each request resolves independently.
- */
-declare function makeCorrelationId(prefix: string): string;
-
-export { type AccountChanged, type ChainChanged, type HandshakeAck, type HandshakeRequest, NO_WALLET_ADDRESS, type ParentBridgeConnectorOptions, type ParentBridgeOptions, ParentBridgeProvider, type ParentMessage, type ReadAccountRequest, type ReadAccountResult, type SignMessageRequest, type SignMessageResult, type SignTransactionRequest, type SignTransactionResult, type SwitchChainRequest, type SwitchChainResult, TANGLE_CLOUD_ORIGINS_DEFAULT, TANGLE_IFRAME_PROTOCOL_PREFIX, TANGLE_IFRAME_PROTOCOL_VERSION, detectTangleCloudParentOrigin, isRunningInIframe, makeCorrelationId, parentBridgeConnector };
+export { type ParentBridgeConnectorOptions, type ParentBridgeOptions, ParentBridgeProvider, isRunningInIframe, parentBridgeConnector };

package/dist/wallet/index.js

@@ -1,54 +1,15 @@
-// src/wallet/detectParentOrigin.ts
-var TANGLE_CLOUD_ORIGINS_DEFAULT = Object.freeze([
-  "https://cloud.tangle.tools",
-  "https://develop.cloud.tangle.tools",
-  // Local dev (Vite default port for tangle-cloud + Netlify dev preview).
-  "http://localhost:4300",
-  "http://localhost:8888"
-]);
-function originFromReferrer() {
-  if (typeof document === "undefined") return null;
-  const ref = document.referrer;
-  if (!ref) return null;
-  try {
-    return new URL(ref).origin;
-  } catch {
-    return null;
-  }
-}
-function detectTangleCloudParentOrigin(options = {}) {
-  if (typeof window === "undefined" || window.parent === window) {
-    return null;
-  }
-  const allowlist = /* @__PURE__ */ new Set([
-    ...TANGLE_CLOUD_ORIGINS_DEFAULT,
-    ...options.extraOrigins ?? []
-  ]);
-  const referrerOrigin = originFromReferrer();
-  if (referrerOrigin && allowlist.has(referrerOrigin)) {
-    return referrerOrigin;
-  }
-  try {
-    const url = new URL(window.location.href);
-    const explicit = url.searchParams.get("parent");
-    if (explicit && allowlist.has(explicit)) return explicit;
-  } catch {
-  }
-  return null;
-}
+import {
+  NO_WALLET_ADDRESS,
+  TANGLE_CLOUD_ORIGINS_DEFAULT,
+  TANGLE_IFRAME_PROTOCOL_PREFIX,
+  TANGLE_IFRAME_PROTOCOL_VERSION,
+  detectTangleCloudParentOrigin,
+  makeCorrelationId
+} from "../chunk-ZKICSKZH.js";
 
 // src/wallet/parentBridgeConnector.ts
 import { createConnector } from "wagmi";
 
-// src/wallet/parentBridgeProtocol.ts
-var TANGLE_IFRAME_PROTOCOL_VERSION = "1";
-var TANGLE_IFRAME_PROTOCOL_PREFIX = "tangle.app.";
-var NO_WALLET_ADDRESS = "0x0000000000000000000000000000000000000000";
-function makeCorrelationId(prefix) {
-  const random = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : Math.random().toString(36).slice(2) + Date.now().toString(36);
-  return `${prefix}.${random}`;
-}
-
 // src/wallet/parentBridgeProvider.ts
 var DEFAULT_REQUEST_TIMEOUT_MS = 6e4;
 function isRunningInIframe() {
@@ -260,6 +221,12 @@ var ParentBridgeProvider = class {
       });
     });
   }
+  /**
+   * Resolves wallet-shape responses (`{ ok, data | error }`). Job results
+   * use a different envelope (`{ status, data?, chunk?, error? }`) and are
+   * routed through a separate listener registered by `useCallJob` / the SDK
+   * — the provider doesn't double-handle them.
+   */
   resolvePending(message) {
     const entry = this.pending.get(message.correlationId);
     if (!entry) return;