@kehto/paja 0.16.5 → 0.17.1

package/README.md

@@ -59,7 +59,11 @@ warning, when the target would block the sandboxed frame.
 
 The console shows supported interfaces with per-domain injection toggles,
 runtime ACL controls, signer controls, and a filterable message log with visible
-error details. In runtime-pointer mode, ACL controls always display and mutate
+error details. It starts expanded and collapses to the left with the chevron
+button in the top bar; the same button brings the whole panel back. Collapsing
+is presentation-only — the target iframe keeps its identity and the loaded
+napplet keeps running — and Paja remembers the choice per browser origin. In
+runtime-pointer mode, ACL controls always display and mutate
 the active tab's resolver-verified d-tag and aggregate hash; a grant or revoke
 rerenders that same identity immediately. Paja auto-connects a browser NIP-07 signer when `window.nostr` is
 available, can connect to a bunker/NIP-46 URI, and only uses the generated local
@@ -213,6 +217,15 @@ identity. A superseded target/source, failed open/readiness, or terminal send is
 handled by the controller's replacement/retry/terminal policy and produces a
 canonical failed `IntentResult`.
 
+Reusing a handler tab activates it and remembers the new active tab. Paja's stage
+shows exactly one tab, so a delivered intent always selects the handler tab:
+`behavior.focus` is a hint, and honoring `false` as "deliver into the hidden
+tab" would report a handled intent whose surface the user never sees. Reuse
+still leaves the caller's tab open, so nothing is replaced. Newly created
+handler tabs behave the same way. Pointer installation logs declared
+archetypes and required domains; Paja warns when archetypes lack `inc`, which
+its current convention delivery policy requires.
+
 `@napplet/shim@0.30.0` supplies no generic shell API. Kehto deliberately keeps
 its host-owned mandatory `window.napplet.shell` prelude: it installs the live
 receiver before the one bare `shell.ready`, caches the first `shell.init`, and

package/dist/browser-host.js

@@ -5363,6 +5363,39 @@ function nappletNamespacePrelude(domains) {
   });
 }
 
+// src/browser-console-panel.ts
+var PAJA_CONSOLE_PANEL_STORAGE_KEY = "kehto:paja:console:v1";
+var PAJA_CONSOLE_TOGGLE_ID = "paja-console-toggle";
+var PAJA_CONSOLE_COLLAPSE_LABEL = "Collapse the Paja development console";
+var PAJA_CONSOLE_EXPAND_LABEL = "Expand the Paja development console";
+function installPajaConsolePanel() {
+  const root = document.documentElement;
+  const button2 = document.getElementById(PAJA_CONSOLE_TOGGLE_ID);
+  let collapsed = false;
+  try {
+    collapsed = localStorage.getItem(PAJA_CONSOLE_PANEL_STORAGE_KEY) === "collapsed";
+  } catch {
+  }
+  const apply = () => {
+    root.dataset.pajaConsole = collapsed ? "collapsed" : "expanded";
+    const label = collapsed ? PAJA_CONSOLE_EXPAND_LABEL : PAJA_CONSOLE_COLLAPSE_LABEL;
+    button2?.setAttribute("aria-expanded", String(!collapsed));
+    button2?.setAttribute("aria-label", label);
+    button2?.setAttribute("title", label);
+  };
+  const toggle = () => {
+    collapsed = !collapsed;
+    apply();
+    try {
+      localStorage.setItem(PAJA_CONSOLE_PANEL_STORAGE_KEY, root.dataset.pajaConsole);
+    } catch {
+    }
+  };
+  apply();
+  button2?.addEventListener("click", toggle);
+  return () => button2?.removeEventListener("click", toggle);
+}
+
 // ../../node_modules/.pnpm/@noble+hashes@2.0.1/node_modules/@noble/hashes/utils.js
 function isBytes(a) {
   return a instanceof Uint8Array || ArrayBuffer.isView(a) && a.constructor.name === "Uint8Array";
@@ -22695,6 +22728,8 @@ function createPajaIntentTargetOptions(getState, getContext, effects = {}) {
         (tab2) => matchesInstalledNappletRecord(record, tab2.resolvedTarget) && isCurrentRuntimeTabGeneration(state, context, tab2)
       );
       if (current && params.behavior?.newWindow !== true && params.behavior?.reuse !== false) {
+        activateRuntimeTab(state, context, current.id);
+        effects.persistTabs?.(state);
         return bindPajaIntentGeneration(current, record, context.runtime);
       }
       const resolved = await resolvePajaPointer(record.pointer.value, pajaPointerResolverOptions(context));
@@ -22757,6 +22792,25 @@ function createPajaIntentTargetOptions(getState, getContext, effects = {}) {
     }
   };
 }
+function recordInstalledIntentSurface(state, resolvedTarget) {
+  const archetypes = resolvedTarget.manifest.archetypes;
+  const requires = resolvedTarget.manifest.requires;
+  const intentEligible = requires.includes("inc") && archetypes.length > 0;
+  if (archetypes.length > 0 && !intentEligible) {
+    console.warn(
+      '[paja] napplet %s declares archetypes but is NOT intent-eligible: missing "inc" in requires. Add a ["requires","inc"] tag to its manifest to route intents to it.',
+      resolvedTarget.dTag
+    );
+  }
+  appendPajaMessageLog(state, "paja", {
+    type: "paja.pointer.resolved",
+    dTag: resolvedTarget.dTag,
+    aggregateHash: resolvedTarget.aggregateHash,
+    archetypes,
+    requires,
+    intentEligible
+  });
+}
 function pajaPointerResolverOptions(context) {
   return {
     relays: [
@@ -23530,11 +23584,7 @@ async function loadRuntimePointer(state, context, value, options = {}) {
     runtime.catalog.install(resolvedTarget);
     const pointerStatus = `${resolvedTarget.dTag}:${resolvedTarget.aggregateHash.slice(0, 12)}`;
     setPointerStatus(state, pointerStatus);
-    appendPajaMessageLog(state, "paja", {
-      type: "paja.pointer.resolved",
-      dTag: resolvedTarget.dTag,
-      aggregateHash: resolvedTarget.aggregateHash
-    });
+    recordInstalledIntentSurface(state, resolvedTarget);
     const duplicate = options.skipDuplicatePrompt ? void 0 : state.tabs.find((tab) => tab.key === resolvedTargetKey(resolvedTarget));
     if (duplicate) {
       const choice = await showDuplicatePointerDialog();
@@ -23681,6 +23731,7 @@ function createPajaBrowserState(context) {
   };
 }
 async function installPajaHost() {
+  const disposeConsolePanel = installPajaConsolePanel();
   const config = await readLatestConfig(readConfig());
   const stage = getStage();
   const frame = config.target.mode === "runtime-pointer" ? null : getFrame();
@@ -23771,6 +23822,7 @@ async function installPajaHost() {
   window.addEventListener("pagehide", () => confirmationController.dispose(), { once: true });
   window.addEventListener("pagehide", () => notifyController?.dispose(), { once: true });
   window.addEventListener("pagehide", () => configController?.dispose(), { once: true });
+  window.addEventListener("pagehide", disposeConsolePanel, { once: true });
   window.__KEHTO_PAJA__ = state;
   window.addEventListener("message", (event) => {
     const source = event.source;