@vamsitalupula/pi-run 1.0.1

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Talupula Vamsi
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# pi-run
+
+Run debugging typescript within the node context of pi coding agent
+
+## Installation
+
+```sh
+pi install npm:@vamsitalupula/pi-run
+```
+
+## How to use?
+1. Create a new file using `/pi-run ./debug.ts` inside *pi*
+2. You should see a new file called `debug.ts` created in the current folder
+```ts
+import type {
+    ExtensionAPI,
+    ExtensionContext,
+} from "@mariozechner/pi-coding-agent";
+
+export default function (
+    pi: ExtensionAPI,
+    getCtx: () => ExtensionContext | null,
+) {
+    // Your code here
+    return pi.getActiveTools();
+}
+```
+3. The package `@mariozechner/pi-coding-agent` is available in the node environment running *pi*. But if you need LSP/linting support in your editor, you need to point your editor tools to the install location of the package one way or an other. The easiest is to just run `pnpm i --save-dev @mariozechner/pi-coding-agent` in the project or local directory
+4. Now run the file with
+    `/pi-run ./debug.ts`
+5. The data/object returned by the `default export function` is shown as a pi notification

package/dist/index.js

@@ -0,0 +1,74 @@
+// src/index.ts
+import { existsSync, writeFileSync, readFileSync } from "fs";
+import { resolve } from "path";
+import { createJiti } from "jiti";
+var TEMPLATE = `import type {
+    ExtensionAPI,
+    ExtensionContext,
+} from "@mariozechner/pi-coding-agent";
+
+export default function (pi: ExtensionAPI, getCtx: () => ExtensionContext | null) {
+    return pi.getActiveTools();
+}
+`;
+function index_default(pi) {
+  let lastCtx = null;
+  const jiti = createJiti(import.meta.url);
+  pi.on("session_start", async (_event, ctx) => {
+    lastCtx = ctx;
+  });
+  pi.on("turn_start", async (_event, ctx) => {
+    lastCtx = ctx;
+  });
+  pi.registerCommand("pi-run", {
+    description: "Run a .ts file with default export function",
+    handler: async (args, ctx) => {
+      lastCtx = ctx;
+      let filePath = args?.trim() || "";
+      if (filePath.startsWith("@")) filePath = filePath.slice(1);
+      if (!filePath) {
+        ctx.ui.notify("Usage: /pi-run <file-path>", "info");
+        return;
+      }
+      const fullPath = resolve(ctx.cwd, filePath);
+      if (!existsSync(fullPath)) {
+        writeFileSync(fullPath, TEMPLATE, "utf-8");
+        ctx.ui.notify(`Created new file: ${fullPath}`, "info");
+        return;
+      }
+      const code = readFileSync(fullPath, "utf-8");
+      if (!code.trim()) {
+        writeFileSync(fullPath, TEMPLATE, "utf-8");
+        ctx.ui.notify(
+          `File was empty, reset to template: ${fullPath}`,
+          "info"
+        );
+        return;
+      }
+      try {
+        const mod = await jiti.import(fullPath);
+        const fn = mod?.default || mod;
+        if (typeof fn !== "function") {
+          ctx.ui.notify(
+            `Error: No default export function found`,
+            "error"
+          );
+          return;
+        }
+        const result = await fn(pi, () => lastCtx);
+        if (result !== void 0) {
+          const str = typeof result === "object" ? JSON.stringify(result, null, 2) : String(result);
+          ctx.ui.notify(`Result:
+${str}`, "info");
+        } else {
+          ctx.ui.notify("Done (no return value)", "info");
+        }
+      } catch (e) {
+        ctx.ui.notify(`Error: ${e.message}`, "error");
+      }
+    }
+  });
+}
+export {
+  index_default as default
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@vamsitalupula/pi-run",
+  "version": "1.0.1",
+  "description": "A pi coding agent extension to run TypeScript files with a default export function",
+  "type": "module",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean",
+    "dev": "tsup src/index.ts --format esm --watch"
+  },
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "main": "dist/index.js",
+  "keywords": [
+    "pi",
+    "coding-agent",
+    "extension",
+    "typescript",
+    "jiti",
+    "devtool",
+    "runner"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "jiti": "^2.6.1"
+  },
+  "devDependencies": {
+    "@mariozechner/pi-coding-agent": "^0.58.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "access": "public"
+}