clankerbend 0.1.0 → 0.1.1

package/host/README.md

@@ -1,9 +1,9 @@
-# OneWhack Host
+# ClankerBend Host
 
-OneWhack is an independent OneWill project compatible with OpenAI Codex
+ClankerBend is an independent OneWill project compatible with OpenAI Codex
 Desktop. It is not affiliated with or endorsed by OpenAI.
 
-This package contains reusable host primitives for OneWhack `0.1`:
+This package contains reusable host primitives for ClankerBend `0.1`:
 
 - loopback HTTP server
 - JSON response envelopes and error envelopes
@@ -14,5 +14,5 @@ This package contains reusable host primitives for OneWhack `0.1`:
 - monotonic selection handling
 - mock transcript adapter for tests and local development
 
-The host does not contain Vim Navigator-specific logic. Apps register a
+The host does not contain VimNav-specific logic. Apps register a
 manifest, static panel directory, state function, and action handler.

package/host/src/app-registry.js

@@ -2,7 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 
-export const ONEWHACK_APP_MANIFEST_VERSION = "0.1";
+export const CLANKERBEND_APP_MANIFEST_VERSION = "0.1";
 
 const VALID_DISTRIBUTION_KINDS = new Set(["local", "npm", "tarball", "binary"]);
 const VALID_PLATFORM_OS = new Set(["darwin", "linux", "win32", "any"]);
@@ -51,9 +51,9 @@ export function validateAppManifest(manifest, options = {}) {
   if (!isPlainObject(manifest)) errors.push("manifest must be a JSON object");
   if (errors.length) throwManifestError(errors, options);
 
-  requireString(manifest, "oneWhackVersion", errors);
-  if (manifest.oneWhackVersion !== ONEWHACK_APP_MANIFEST_VERSION) {
-    errors.push(`oneWhackVersion must be ${ONEWHACK_APP_MANIFEST_VERSION}`);
+  requireString(manifest, "clankerbendVersion", errors);
+  if (manifest.clankerbendVersion !== CLANKERBEND_APP_MANIFEST_VERSION) {
+    errors.push(`clankerbendVersion must be ${CLANKERBEND_APP_MANIFEST_VERSION}`);
   }
   requireString(manifest, "appId", errors);
   requireString(manifest, "version", errors);
@@ -202,7 +202,7 @@ export function normalizeAppFromManifest(app, manifest) {
 
 export function defaultRegistryConfig() {
   return {
-    oneWhackVersion: ONEWHACK_APP_MANIFEST_VERSION,
+    clankerbendVersion: CLANKERBEND_APP_MANIFEST_VERSION,
     installedApps: {},
     profiles: {
       default: {
@@ -307,7 +307,7 @@ function requireString(object, key, errors, label = key) {
 
 function throwManifestError(errors, options = {}) {
   const prefix = options.manifestPath ? `${options.manifestPath}: ` : "";
-  throw new Error(`${prefix}invalid OneWhack app manifest:\n${errors.map((error) => `- ${error}`).join("\n")}`);
+  throw new Error(`${prefix}invalid ClankerBend app manifest:\n${errors.map((error) => `- ${error}`).join("\n")}`);
 }
 
 function isPlainObject(value) {

package/host/src/codex-desktop-cdp-adapter.js

@@ -52,7 +52,7 @@ function normalizeProviders(options = {}, rendererBridges = []) {
 
 function userPanelError(error) {
   if (/native Browser panel controls not found|panel app did not load|panel unavailable/i.test(String(error || ""))) {
-    return "Waiting for Codex Desktop to expose the Browser side panel. Open a Codex thread, then OneWhack will load the selected app automatically.";
+    return "Waiting for Codex Desktop to expose the Browser side panel. Open a Codex thread, then ClankerBend will load the selected app automatically.";
   }
   return error || "Waiting for Codex Desktop to expose the Browser side panel.";
 }
@@ -219,7 +219,7 @@ class CodexDesktopCdpAdapter {
     const bridge = this.bridgeForProvider("transcriptHighlight");
     const appId = this.bridgeAppId(bridge);
     return this.evaluate(`(() => {
-      const runtime = window.__oneWhackRuntime;
+      const runtime = window.__clankerbendRuntime;
       const bridge = runtime?.getBridge?.(${JSON.stringify(appId)});
       if (bridge?.highlightRange) return bridge.highlightRange(${JSON.stringify(range)}, ${JSON.stringify(options)});
       if (runtime?.highlightRange) return runtime.highlightRange(${JSON.stringify(range)}, ${JSON.stringify(options)});
@@ -230,7 +230,7 @@ class CodexDesktopCdpAdapter {
 
   async setComposerDraft(draft, options = {}) {
     return this.evaluate(`(() => {
-      const runtime = window.__oneWhackRuntime;
+      const runtime = window.__clankerbendRuntime;
       if (!runtime?.setComposerDraft) return { ok: false, error: "composer draft unavailable" };
       return runtime.setComposerDraft(${JSON.stringify(draft)}, ${JSON.stringify(options)});
     })()`);
@@ -238,7 +238,7 @@ class CodexDesktopCdpAdapter {
 
   async submitComposer(draft, options = {}) {
     return this.evaluate(`(() => {
-      const runtime = window.__oneWhackRuntime;
+      const runtime = window.__clankerbendRuntime;
       if (!runtime?.submitComposer) return { ok: false, error: "composer submit unavailable" };
       return runtime.submitComposer(${JSON.stringify(draft)}, ${JSON.stringify(options)});
     })()`);
@@ -347,7 +347,7 @@ class CodexDesktopCdpAdapter {
         return { ok: false, error: "app-server active thread is unknown", mode: "app-server-inject-items", diagnostic: diagnostics };
       }
       const items = buildAttachmentResponseItems(files, {
-        appName: options.appName || "OneWhack",
+        appName: options.appName || "ClankerBend",
         createdAt: new Date().toISOString()
       });
       const response = await client.threadInjectItems(thread.threadId, items);
@@ -491,20 +491,20 @@ class CodexDesktopCdpAdapter {
       const protocolVersion = ${JSON.stringify(this.host.protocolVersion)};
       const hostUrl = ${JSON.stringify(this.host.state.host.url)};
       const seededApps = ${JSON.stringify(apps)};
-      const previous = window.__oneWhackRuntime;
+      const previous = window.__clankerbendRuntime;
       const slots = previous && typeof previous.apps === "object" ? previous.apps : {};
       const cssEscape = (value) => window.CSS?.escape ? window.CSS.escape(String(value)) : String(value).replace(/["\\\\]/g, "\\\\$&");
       const ensureAnnotationLayoutStyle = () => {
-        const styleId = "onewhack-annotation-layout-style";
+        const styleId = "clankerbend-annotation-layout-style";
         if (document.getElementById(styleId)) return;
         const style = document.createElement("style");
         style.id = styleId;
         style.textContent = \`
-          .onewhack-transcript-anchor {
+          .clankerbend-transcript-anchor {
             position: relative !important;
             overflow: visible !important;
           }
-          .onewhack-transcript-annotations {
+          .clankerbend-transcript-annotations {
             position: absolute !important;
             left: -62px !important;
             top: 4px !important;
@@ -515,37 +515,35 @@ class CodexDesktopCdpAdapter {
             gap: 6px !important;
             pointer-events: none !important;
           }
-          .onewhack-transcript-annotation-slot {
+          .clankerbend-transcript-annotation-slot {
             display: flex !important;
             align-items: center !important;
             justify-content: center !important;
             pointer-events: auto !important;
           }
           @media (max-width: 900px) {
-            .onewhack-transcript-annotations {
-              position: static !important;
-              flex-direction: row !important;
-              justify-content: flex-start !important;
-              align-items: center !important;
-              margin: 0 0 6px 0 !important;
+            .clankerbend-transcript-annotations {
+              position: absolute !important;
+              left: -44px !important;
+              top: 4px !important;
             }
           }
         \`;
         document.head.appendChild(style);
       };
       const annotationHost = (anchor, anchorId) => {
-        if (!(anchor instanceof HTMLElement)) throw new Error("OneWhack annotation anchor must be an HTMLElement");
+        if (!(anchor instanceof HTMLElement)) throw new Error("ClankerBend annotation anchor must be an HTMLElement");
         ensureAnnotationLayoutStyle();
-        anchor.classList.add("onewhack-transcript-anchor");
+        anchor.classList.add("clankerbend-transcript-anchor");
         let host = Array.from(anchor.children).find((child) =>
           child instanceof HTMLElement &&
-          child.classList.contains("onewhack-transcript-annotations") &&
-          child.dataset.onewhackAnchorId === anchorId
+          child.classList.contains("clankerbend-transcript-annotations") &&
+          child.dataset.clankerbendAnchorId === anchorId
         );
         if (!host) {
           host = document.createElement("div");
-          host.className = "onewhack-transcript-annotations";
-          host.dataset.onewhackAnchorId = anchorId;
+          host.className = "clankerbend-transcript-annotations";
+          host.dataset.clankerbendAnchorId = anchorId;
           anchor.insertAdjacentElement("afterbegin", host);
         }
         return host;
@@ -565,15 +563,15 @@ class CodexDesktopCdpAdapter {
           }
           return left;
         })();
-        const visibleLeft = clippingLeft - rect.left;
-        host.style.setProperty("left", Math.max(visibleLeft, desiredLeft) + "px", "important");
+        host.style.setProperty("left", desiredLeft + "px", "important");
+        host.style.setProperty("visibility", rect.left + desiredLeft < clippingLeft ? "hidden" : "visible", "important");
       };
       const sortAnnotationSlots = (host) => {
         [...host.children]
           .sort((a, b) =>
-            Number(a.dataset.onewhackPriority || 100) - Number(b.dataset.onewhackPriority || 100) ||
-            String(a.dataset.onewhackAppId || "").localeCompare(String(b.dataset.onewhackAppId || "")) ||
-            String(a.dataset.onewhackMarkerId || "").localeCompare(String(b.dataset.onewhackMarkerId || ""))
+            Number(a.dataset.clankerbendPriority || 100) - Number(b.dataset.clankerbendPriority || 100) ||
+            String(a.dataset.clankerbendAppId || "").localeCompare(String(b.dataset.clankerbendAppId || "")) ||
+            String(a.dataset.clankerbendMarkerId || "").localeCompare(String(b.dataset.clankerbendMarkerId || ""))
           )
           .forEach((child) => host.appendChild(child));
       };
@@ -589,8 +587,8 @@ class CodexDesktopCdpAdapter {
       const findAnchorElement = (anchorId) => document.querySelector(transcriptAnchorSelector(anchorId));
       const isHostUiElement = (el) => {
         for (let node = el; node; node = node.parentElement) {
-          if (node.classList?.contains?.("onewhack-host-ui")) return true;
-          if (/^onewhack-/.test(String(node.id || ""))) return true;
+          if (node.classList?.contains?.("clankerbend-host-ui")) return true;
+          if (/^clankerbend-/.test(String(node.id || ""))) return true;
         }
         return false;
       };
@@ -633,16 +631,16 @@ class CodexDesktopCdpAdapter {
           );
         return candidates[0]?.el || null;
       };
-      const ONEWHACK_CONTEXT_START = "--- OneWhack context ---";
-      const ONEWHACK_CONTEXT_END = "--- End OneWhack context ---";
-      const stripOneWhackContext = (text) => {
+      const CLANKERBEND_CONTEXT_START = "--- ClankerBend context ---";
+      const CLANKERBEND_CONTEXT_END = "--- End ClankerBend context ---";
+      const stripContextBlock = (text) => {
         let output = String(text || "");
         while (true) {
-          const start = output.indexOf(ONEWHACK_CONTEXT_START);
+          const start = output.indexOf(CLANKERBEND_CONTEXT_START);
           if (start < 0) return output.trimStart();
-          const end = output.indexOf(ONEWHACK_CONTEXT_END, start + ONEWHACK_CONTEXT_START.length);
+          const end = output.indexOf(CLANKERBEND_CONTEXT_END, start + CLANKERBEND_CONTEXT_START.length);
           if (end < 0) return output.slice(0, start).trimEnd();
-          output = output.slice(0, start) + output.slice(end + ONEWHACK_CONTEXT_END.length);
+          output = output.slice(0, start) + output.slice(end + CLANKERBEND_CONTEXT_END.length);
         }
       };
       const setComposerValue = (el, value) => {
@@ -678,7 +676,7 @@ class CodexDesktopCdpAdapter {
         hostUrl,
         apps: slots,
         registerApp(app) {
-          if (!app || !app.appId) throw new Error("OneWhack appId is required");
+          if (!app || !app.appId) throw new Error("ClankerBend appId is required");
           const seeded = seededApps[app.appId] || {};
           const current = this.apps[app.appId] || {};
           const currentVersion = Number(current.bridge?.version);
@@ -690,7 +688,7 @@ class CodexDesktopCdpAdapter {
             Number.isFinite(nextVersion) &&
             nextVersion < currentVersion
           ) {
-            throw new Error("OneWhack app bridge version regressed for " + app.appId);
+            throw new Error("ClankerBend app bridge version regressed for " + app.appId);
           }
           const slot = {
             ...current,
@@ -713,22 +711,22 @@ class CodexDesktopCdpAdapter {
           return this.getApp(appId)?.entryUrl || null;
         },
         placeAnnotation(anchor, annotation) {
-          if (!annotation?.appId) throw new Error("OneWhack annotation appId is required");
-          if (!annotation?.anchorId) throw new Error("OneWhack annotation anchorId is required");
-          if (!(annotation.element instanceof HTMLElement)) throw new Error("OneWhack annotation element is required");
+          if (!annotation?.appId) throw new Error("ClankerBend annotation appId is required");
+          if (!annotation?.anchorId) throw new Error("ClankerBend annotation anchorId is required");
+          if (!(annotation.element instanceof HTMLElement)) throw new Error("ClankerBend annotation element is required");
           const markerId = annotation.markerId || annotation.anchorId;
           const host = annotationHost(anchor, annotation.anchorId);
-          const selector = '.onewhack-transcript-annotation-slot[data-onewhack-app-id="' + cssEscape(annotation.appId) + '"][data-onewhack-marker-id="' + cssEscape(markerId) + '"]';
+          const selector = '.clankerbend-transcript-annotation-slot[data-clankerbend-app-id="' + cssEscape(annotation.appId) + '"][data-clankerbend-marker-id="' + cssEscape(markerId) + '"]';
           let slot = host.querySelector(selector);
           if (!slot) {
             slot = document.createElement("div");
-            slot.className = "onewhack-transcript-annotation-slot";
-            slot.dataset.onewhackAppId = annotation.appId;
-            slot.dataset.onewhackMarkerId = markerId;
+            slot.className = "clankerbend-transcript-annotation-slot";
+            slot.dataset.clankerbendAppId = annotation.appId;
+            slot.dataset.clankerbendMarkerId = markerId;
             host.appendChild(slot);
           }
-          slot.dataset.onewhackAnchorId = annotation.anchorId;
-          slot.dataset.onewhackPriority = String(annotation.priority ?? 100);
+          slot.dataset.clankerbendAnchorId = annotation.anchorId;
+          slot.dataset.clankerbendPriority = String(annotation.priority ?? 100);
           if (slot.firstElementChild !== annotation.element) slot.replaceChildren(annotation.element);
           sortAnnotationSlots(host);
           positionAnnotationHost(host, anchor);
@@ -736,10 +734,10 @@ class CodexDesktopCdpAdapter {
         },
         removeAnnotations(appId, liveAnchorIds = null) {
           const live = liveAnchorIds ? new Set([...liveAnchorIds].map(String)) : null;
-          document.querySelectorAll('.onewhack-transcript-annotation-slot[data-onewhack-app-id="' + cssEscape(appId) + '"]').forEach((slot) => {
-            if (!live || !live.has(slot.dataset.onewhackAnchorId || "")) slot.remove();
+          document.querySelectorAll('.clankerbend-transcript-annotation-slot[data-clankerbend-app-id="' + cssEscape(appId) + '"]').forEach((slot) => {
+            if (!live || !live.has(slot.dataset.clankerbendAnchorId || "")) slot.remove();
           });
-          document.querySelectorAll(".onewhack-transcript-annotations").forEach((host) => {
+          document.querySelectorAll(".clankerbend-transcript-annotations").forEach((host) => {
             if (!host.children.length) host.remove();
           });
         },
@@ -747,14 +745,14 @@ class CodexDesktopCdpAdapter {
           if (!range?.anchorId) return { ok: false, error: "range.anchorId is required" };
           const anchor = findAnchorElement(range.anchorId);
           if (!anchor) return { ok: false, error: "anchor not found", anchorId: range.anchorId };
-          anchor.classList.add("onewhack-range-highlight");
+          anchor.classList.add("clankerbend-range-highlight");
           const previousOutline = anchor.style.outline;
           const previousOffset = anchor.style.outlineOffset;
           anchor.style.outline = "3px solid #f6c945";
           anchor.style.outlineOffset = "3px";
           anchor.scrollIntoView({ block: options.block || "center", behavior: options.behavior || "smooth" });
           setTimeout(() => {
-            anchor.classList.remove("onewhack-range-highlight");
+            anchor.classList.remove("clankerbend-range-highlight");
             anchor.style.outline = previousOutline;
             anchor.style.outlineOffset = previousOffset;
           }, Number(options.durationMs || 1200));
@@ -764,8 +762,8 @@ class CodexDesktopCdpAdapter {
           const el = findComposer();
           if (!el) return { ok: false, error: "composer not found" };
           const currentText = composerText(el);
-          const text = draft.oneWhackContext
-            ? (draft.text ? mergeDraftText(stripOneWhackContext(currentText), String(draft.text || ""), "prepend") : stripOneWhackContext(currentText))
+          const text = draft.clankerbendContext
+            ? (draft.text ? mergeDraftText(stripContextBlock(currentText), String(draft.text || ""), "prepend") : stripContextBlock(currentText))
             : mergeDraftText(currentText, String(draft.text || ""), draft.mode || "replace");
           if (!setComposerValue(el, text)) return { ok: false, error: "composer cannot be updated" };
           return { ok: true, draft: { ...draft, text } };
@@ -790,7 +788,7 @@ class CodexDesktopCdpAdapter {
           injectedAt: runtime.apps[appId]?.injectedAt || null
         };
       }
-      window.__oneWhackRuntime = runtime;
+      window.__clankerbendRuntime = runtime;
     })()`);
     for (const bridge of this.rendererBridges) {
       await this.evaluate(bridge.injectedSource);
@@ -1042,9 +1040,9 @@ class CodexDesktopCdpAdapter {
   async evalBridge(expression, bridge = this.primaryBridge()) {
     const appId = this.bridgeAppId(bridge);
     return this.evaluate(`(() => {
-      const runtime = window.__oneWhackRuntime;
+      const runtime = window.__clankerbendRuntime;
       const bridge = runtime?.getBridge?.(${JSON.stringify(appId)});
-      if (!bridge) return { ok: false, error: "OneWhack bridge is not installed for " + ${JSON.stringify(appId)} };
+      if (!bridge) return { ok: false, error: "ClankerBend bridge is not installed for " + ${JSON.stringify(appId)} };
       return bridge.${expression};
     })()`);
   }
@@ -1240,8 +1238,8 @@ class AppServerClient {
   async initialize() {
     const response = await this.call("initialize", {
       clientInfo: {
-        name: "onewhack-host",
-        title: "OneWhack Host",
+        name: "clankerbend-host",
+        title: "ClankerBend Host",
         version: "0.1"
       },
       capabilities: {
@@ -1448,7 +1446,7 @@ function buildAttachmentResponseItems(files = [], options = {}) {
   const createdAt = options.createdAt || new Date().toISOString();
   return files.map((file, index) => {
     const text = [
-      "OneWhack attached runtime file context.",
+      "ClankerBend attached runtime file context.",
       "",
       `Attached at: ${createdAt}`,
       `File ${index + 1}: ${file.name || basename(file.path)}`,
@@ -1456,7 +1454,7 @@ function buildAttachmentResponseItems(files = [], options = {}) {
       file.relativePath ? `Runtime path: ${file.relativePath}` : null,
       file.mimeType ? `MIME type: ${file.mimeType}` : null,
       "",
-      "The following file was created by a OneWhack app and should be treated as attached context for the user's next prompt.",
+      "The following file was created by a ClankerBend app and should be treated as attached context for the user's next prompt.",
       "",
       "```markdown",
       readFileSync(file.path, "utf8"),
@@ -1731,14 +1729,14 @@ function nativeAttachmentDiagnosticExpression(paths) {
     (() => {
       const paths = ${JSON.stringify(paths)};
       const basenames = paths.map((path) => String(path).split(/[\\\\/]/).pop()).filter(Boolean);
-      const oneWhackChipCount = document.querySelectorAll("#onewhack-composer-chips .onewhack-context-chip").length;
+      const clankerbendChipCount = document.querySelectorAll("#clankerbend-composer-chips .clankerbend-context-chip").length;
       const composerInputs = [...document.querySelectorAll("textarea,[contenteditable='true'],[role='textbox']")]
         .map((el) => ({ el, rect: el.getBoundingClientRect() }))
         .filter((item) => item.rect.width > 180 && item.rect.height > 18 && item.rect.bottom > window.innerHeight * 0.45)
         .sort((a, b) => b.rect.bottom - a.rect.bottom);
       const composerRect = composerInputs[0]?.rect || null;
       const candidates = [...document.querySelectorAll("button,[role='button'],span,div")]
-        .filter((el) => !el.closest("#onewhack-composer-chips"))
+        .filter((el) => !el.closest("#clankerbend-composer-chips"))
         .map((el) => {
           const text = (el.innerText || el.textContent || "").replace(/\\s+/g, " ").trim();
           const rect = el.getBoundingClientRect();
@@ -1760,10 +1758,10 @@ function nativeAttachmentDiagnosticExpression(paths) {
         );
       const matched = basenames.filter((name) => candidates.some((item) => item.text.includes(name)));
       return {
-        ok: matched.length === basenames.length && oneWhackChipCount === 0,
+        ok: matched.length === basenames.length && clankerbendChipCount === 0,
         matched,
         basenames,
-        oneWhackChipCount,
+        clankerbendChipCount,
         candidates: candidates.slice(0, 12)
       };
     })()