@aexol/spectral 0.3.8 → 0.3.9

package/dist/cli.js

@@ -87,6 +87,10 @@ function resolveObservationalMemoryPath() {
 function resolveMcpExtensionPath() {
     return resolve(__dirname, "mcp", "index.js");
 }
+/** Absolute path to the bundled openrouter-attribution extension, sitting next to this file in dist/. */
+function resolveOpenRouterAttributionPath() {
+    return resolve(__dirname, "extensions", "openrouter-attribution.js");
+}
 // ---- Branded helpers ---------------------------------------------------------
 function printVersion() {
     process.stdout.write(`spectral ${VERSION} — ${TAGLINE}\n`);
@@ -218,7 +222,13 @@ async function main() {
         process.stderr.write(`spectral: bundled observational-memory extension not found at ${obsMemPath}. This is a packaging bug.\n`);
         process.exit(1);
     }
-    const extFlags = ["--extension", aexolExtPath, "--extension", mcpExtPath, "--extension", obsMemPath];
+    // OpenRouter attribution extension – adds headers so Aexol appears in OpenRouter rankings
+    const openrouterAttrPath = resolveOpenRouterAttributionPath();
+    if (!existsSync(openrouterAttrPath)) {
+        process.stderr.write(`spectral: bundled OpenRouter attribution extension not found at ${openrouterAttrPath}. This is a packaging bug.\n`);
+        process.exit(1);
+    }
+    const extFlags = ["--extension", aexolExtPath, "--extension", mcpExtPath, "--extension", obsMemPath, "--extension", openrouterAttrPath];
     const finalArgs = [...extFlags, ...args];
     delegateToPi(finalArgs);
 }

package/dist/extensions/openrouter-attribution.js

@@ -0,0 +1,19 @@
+/**
+ * OpenRouter App Attribution extension.
+ *
+ * Adds HTTP headers required by OpenRouter's app attribution system so that
+ * Aexol / Spectral appears in OpenRouter rankings, analytics, and model
+ * "Apps" tabs. Without these headers our usage is anonymous to OpenRouter.
+ *
+ * @see https://openrouter.ai/docs/app-attribution
+ */
+export default function openrouterAttributionExtension(pi) {
+    pi.registerProvider("openrouter", {
+        headers: {
+            "HTTP-Referer": "https://aexol.ai",
+            "X-OpenRouter-Title": "Aexol",
+            "X-OpenRouter-Categories": "cli-agent,cloud-agent",
+        },
+    });
+    process.stderr.write("[openrouter-attribution] Registered OpenRouter app attribution headers.\n");
+}

package/dist/server/pi-bridge.js

@@ -502,12 +502,20 @@ export class PiBridge {
             modelRegistry: this.modelRegistry,
         });
         this.session = result.session;
+        // Headless UI context: forwards extension notify() calls as wire events
+        // so the browser can surface memory activity, MCP status, etc.
+        const uiContext = createHeadlessUIContext((event) => {
+            try {
+                this.opts.emit(event);
+            }
+            catch { /* best-effort */ }
+        });
         // Emit session_start so extensions can initialize (e.g. pi-mcp-adapter
         // connects to MCP servers, loads configs from ~/.config/mcp/mcp.json etc.).
         // bindExtensions also fires resources_discover for dynamic skill/prompt
-        // registration. No UI/command context needed in serve mode.
+        // registration.
         try {
-            await this.session.bindExtensions({});
+            await this.session.bindExtensions({ uiContext });
             console.info("[PiBridge] session_start emitted; extensions initialized.");
         }
         catch (err) {
@@ -1017,3 +1025,58 @@ export class PiBridge {
         }
     }
 }
+// ---------------------------------------------------------------------------
+// Headless UI context
+// ---------------------------------------------------------------------------
+/**
+ * Detect the memory subsystem from a notification message text.
+ * The memory extension prefixes all messages with "Observational memory:".
+ */
+function detectMemorySystem(message) {
+    if (!message.startsWith("Observational memory:"))
+        return undefined;
+    const lower = message.toLowerCase();
+    if (lower.includes("observer"))
+        return "memory_observer";
+    if (lower.includes("compaction") || lower.includes("compact"))
+        return "memory_compaction";
+    if (lower.includes("reflection"))
+        return "memory_reflection";
+    if (lower.includes("pruner") || lower.includes("prune"))
+        return "memory_pruner";
+    return "extension";
+}
+/**
+ * Create a minimal ExtensionUIContext that forwards `notify()` calls as
+ * `agent_notification` wire events. All other UI methods are no-ops —
+ * only extensions (not pi's TUI) call into the UI context in headless mode,
+ * and extensions that call methods other than `notify()` are expected to
+ * guard with `ctx.hasUI` first.
+ */
+function createHeadlessUIContext(emit) {
+    // Defer to a Proxy so we don't need to stub every method.
+    // `notify` is the only method called by extensions in serve mode
+    // (observational memory, MCP status bar updates).
+    const handler = {
+        get(_target, prop) {
+            if (prop === "notify") {
+                return (message, type) => {
+                    emit({
+                        type: "agent_notification",
+                        message,
+                        level: type ?? "info",
+                        system: detectMemorySystem(message),
+                    });
+                };
+            }
+            // All other methods: return a no-op function or undefined.
+            // Methods that return Promises (select, confirm, input, custom, editor)
+            // resolve to `undefined` — extensions are expected to guard with `ctx.hasUI`
+            // before calling them, and none do in serve mode.
+            // Methods that set state (setStatus, setWorkingMessage, setWidget, etc.)
+            // are safe to no-op.
+            return () => undefined;
+        },
+    };
+    return new Proxy({}, handler);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "Always-on coding agent for Aexol — branded pi wrapper with relay-based browser access.",
   "type": "module",
   "private": false,