@vimhead.dev/pi-norn 0.1.0-tip.0

package/README.md

@@ -0,0 +1,15 @@
+# Norn for Pi
+
+Deliver the selected Norn runtime's documentation introduction to outer Pi sessions.
+Install the Norn CLI separately, then:
+
+```bash
+pi install npm:@vimhead.dev/pi-norn@tip
+pi
+```
+
+The adapter selects `norn` from `PATH`, or `pi --norn-executable /absolute/path/to/norn`.
+It does not carry another Norn runtime or SDK and does not inject authoring context
+into Norn-managed agent sessions.
+
+[Runtime installation](https://github.com/vimhead/norn#installation).

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export default function nornPiAdapter(pi: ExtensionAPI): void;

package/dist/index.js

@@ -0,0 +1,49 @@
+// ../core/src/agent-protocol.ts
+var AGENT_RESPONSE_TOOL_NAME = "pi_workflows_agent_response";
+
+// src/index.ts
+var INTRO_START = "<norn-docs-intro>";
+var INTRO_END = "</norn-docs-intro>";
+function nornPiAdapter(pi) {
+  let cachedIntro;
+  pi.registerFlag("norn-executable", {
+    type: "string",
+    description: "Norn executable for docs intro (defaults to norn on PATH). Accepts an executable path, not a shell command."
+  });
+  pi.on("session_start", async (_event, ctx) => {
+    cachedIntro = void 0;
+    if (pi.getAllTools().some((tool) => tool.name === AGENT_RESPONSE_TOOL_NAME)) return;
+    try {
+      const configuredExecutable = pi.getFlag("norn-executable");
+      if (configuredExecutable !== void 0 && typeof configuredExecutable !== "string") throw new Error("Invalid Norn executable flag");
+      const executable = configuredExecutable ?? "norn";
+      const result = await pi.exec(executable, ["docs", "intro"], { cwd: ctx.cwd, timeout: 1e4 });
+      if (result.killed || result.code !== 0) throw new Error("Norn docs intro did not complete successfully");
+      const response = JSON.parse(result.stdout);
+      if (!response || typeof response !== "object" || !("intro" in response) || typeof response.intro !== "string" || response.intro.trim().length === 0 || Buffer.byteLength(response.intro, "utf8") > 16384) {
+        throw new Error("Invalid Norn introduction response");
+      }
+      cachedIntro = { executable, intro: response.intro };
+    } catch {
+      ctx.ui.notify("Norn introduction unavailable. Check --norn-executable and run that executable with 'docs intro' to diagnose, then /reload to retry.", "warning");
+    }
+  });
+  pi.on("before_agent_start", (event, ctx) => {
+    if (!cachedIntro) return;
+    if (pi.getAllTools().some((tool) => tool.name === AGENT_RESPONSE_TOOL_NAME)) return;
+    if (event.systemPrompt.includes(INTRO_START)) return;
+    if (cachedIntro.executable !== (pi.getFlag("norn-executable") ?? "norn")) {
+      cachedIntro = void 0;
+      ctx.ui.notify("Norn executable changed. Run /reload to refresh its introduction.", "warning");
+      return;
+    }
+    return { systemPrompt: `${event.systemPrompt}
+
+${INTRO_START}
+${cachedIntro.intro}
+${INTRO_END}` };
+  });
+}
+export {
+  nornPiAdapter as default
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@vimhead.dev/pi-norn",
+  "version": "0.1.0-tip.0",
+  "description": "Deliver installed Norn runtime documentation to outer Pi agent sessions.",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "pi-package"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vimhead/norn.git",
+    "directory": "packages/pi-norn"
+  },
+  "homepage": "https://github.com/vimhead/norn#readme",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "tip"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "0.85.1",
+    "@vimhead.dev/norn-core": "0.0.0"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.ts"
+  }
+}