@vs4vijay/piverse 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# Piverse
+
+A multi-extension ecosystem for the [Pi coding agent](https://github.com/earendil-works/pi).
+
+## Install
+
+**All extensions:**
+
+```bash
+pi install npm:@vs4vijay/piverse
+```
+
+**Individual extensions:**
+
+```bash
+pi install npm:@vs4vijay/pi-queue
+```
+
+**From git (latest):**
+
+```bash
+pi install git:github.com/vs4vijay/piverse
+```
+
+## Extensions
+
+| Extension | Package | Description |
+|-----------|---------|-------------|
+| [pi-queue](./extensions/pi-queue) | `@vs4vijay/pi-queue` | Queue messages to run after the current turn settles |
+
+## Development
+
+### Quick test (single extension)
+
+```bash
+pi -e ./extensions/pi-queue/src/index.ts
+```
+
+### Hot-reload via symlink
+
+Link an extension into Pi's auto-discovery directory:
+
+```bash
+ln -sf ~/GitHub/piverse/extensions/pi-queue ~/.pi/agent/extensions/pi-queue
+```
+
+Then `/reload` inside Pi to pick up changes.
+
+### Type checking
+
+```bash
+npm run typecheck
+```
+
+## Structure
+
+```
+piverse/
+├── extensions/
+│   ├── pi-queue/        # /queue - message queueing
+│   └── ...              # future extensions
+├── package.json         # pi-package root
+└── tsconfig.json        # shared type checking
+```

package/extensions/pi-queue/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@vs4vijay/pi-queue",
+  "version": "0.1.0",
+  "description": "Queue messages to run after the current Pi session turn settles",
+  "type": "module",
+  "keywords": ["pi-package"],
+  "pi": {
+    "extensions": ["./src/index.ts"]
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}

package/extensions/pi-queue/src/index.ts

@@ -0,0 +1,52 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+  let queue: string[] = [];
+
+  pi.registerCommand("queue", {
+    description: "Queue a message to send after the current turn settles. No args = show queue.",
+    handler: async (args, ctx) => {
+      if (!args.trim()) {
+        if (queue.length === 0) {
+          ctx.ui.notify("Queue is empty. /queue <message> to add.", "info");
+        } else {
+          const display = queue.map((m, i) => `${i + 1}. ${m}`).join("\n");
+          ctx.ui.notify(`Queued (${queue.length}):\n${display}`, "info");
+        }
+        return;
+      }
+      queue.push(args.trim());
+      ctx.ui.notify(`Queued #${queue.length}: "${args.trim()}"`, "info");
+    },
+  });
+
+  pi.registerCommand("queue-clear", {
+    description: "Clear all queued messages",
+    handler: async (_args, ctx) => {
+      const count = queue.length;
+      queue = [];
+      ctx.ui.notify(count ? `Cleared ${count} queued message(s)` : "Queue already empty", "info");
+    },
+  });
+
+  pi.on("agent_settled", async () => {
+    if (queue.length === 0) return;
+    const next = queue.shift()!;
+    pi.sendUserMessage(next);
+  });
+
+  pi.on("session_start", async (_event, ctx) => {
+    queue = [];
+    for (const entry of ctx.sessionManager.getEntries()) {
+      if (entry.type === "custom" && entry.customType === "piverse-queue-state") {
+        queue = (entry.data as { queue: string[] }).queue ?? [];
+      }
+    }
+  });
+
+  pi.on("session_shutdown", async () => {
+    if (queue.length > 0) {
+      pi.appendEntry("piverse-queue-state", { queue });
+    }
+  });
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@vs4vijay/piverse",
+  "version": "0.1.0",
+  "description": "A multi-extension ecosystem for the Pi coding agent",
+  "keywords": ["pi-package"],
+  "type": "module",
+  "pi": {
+    "extensions": ["./extensions/pi-queue/src/index.ts"]
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true
+  },
+  "include": ["extensions/*/src/**/*.ts"]
+}