@saifymatteo/pi-extensions 0.0.0-stage → 0.1.0

package/packages/pi-session-id/README.md

@@ -0,0 +1,31 @@
+# pi-session-id
+
+Copy the current session ID to the system clipboard.
+
+## Running locally
+
+From the monorepo root:
+
+```sh
+pi -e ./packages/pi-session-id
+```
+
+**Warning:** this extension uses your existing Pi resources and settings unless you load it in an isolated home (see the root README). Do not load two copies of the same extension (for example an older standalone file alongside this package): commands and hooks can duplicate. The package never installs or relocates personal settings.
+
+## Commands and shortcuts
+
+- `/session-id` — copies the current ID; on failure, the notification includes the ID for manual copying.
+
+## Settings and storage
+
+No settings file or persistent state.
+
+## Privacy and operations
+
+Writes the ID to your system clipboard (which may be synchronized by your OS). Clipboard failures are reported; there are no model requests or session-file mutations.
+
+## Compatibility
+
+Node.js >=24 for development checks; run extensions through Pi's TypeScript loader. Host imports are wildcard peers, not bundled runtime copies. Requires Pi's `copyToClipboard` export and working OS clipboard support. Notifications require a UI-capable host.
+
+See [NOTICE.md](NOTICE.md) for provenance. Tests use the monorepo's TypeScript dev dependency and VM loader; they do not contact services or write to user-home resources.

package/packages/pi-session-id/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@saifymatteo/pi-session-id",
+  "version": "0.1.0",
+  "license": "AGPL-3.0-only",
+  "type": "module",
+  "keywords": [
+    "pi-package"
+  ],
+  "files": [
+    "src",
+    "README.md",
+    "NOTICE.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "description": "Copy the current session ID to the clipboard.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/saifymatteo/pi-extensions.git",
+    "directory": "packages/pi-session-id"
+  }
+}

package/packages/pi-session-id/src/index.ts

@@ -0,0 +1,20 @@
+import { copyToClipboard, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+	pi.registerCommand("session-id", {
+		description: "Copy the current session ID to the clipboard",
+		handler: async (_args, ctx) => {
+			const sessionId = ctx.sessionManager.getSessionId();
+			try {
+				await copyToClipboard(sessionId);
+			} catch (error) {
+				ctx.ui.notify(
+					`Could not copy session ID: ${error instanceof Error ? error.message : String(error)}\nSession ID: ${sessionId}`,
+					"error",
+				);
+				return;
+			}
+			ctx.ui.notify(`Copied session ID: ${sessionId}`, "info");
+		},
+	});
+}

package/packages/pi-session-id/test/behavior.test.mjs

@@ -0,0 +1,25 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { loadExtension } from '../../../test/load-extension.mjs';
+
+for (const fail of [false, true]) {
+  test('session-id command reports clipboard ' + (fail ? 'failure with recoverable ID' : 'success'), async () => {
+    const copied = [], notices = [], commands = new Map();
+    const extension = loadExtension(new URL('../src/index.ts', import.meta.url), {
+      '@earendil-works/pi-coding-agent': {
+        copyToClipboard: async id => { copied.push(id); if (fail) throw new Error('clipboard unavailable'); },
+      },
+    });
+    extension.default({ registerCommand: (name, command) => commands.set(name, command) });
+    assert.equal(commands.size, 1);
+    await commands.get('session-id').handler('', {
+      sessionManager: { getSessionId: () => 'fixture-session-id' },
+      ui: { notify: (message, level) => notices.push({ message, level }) },
+    });
+    assert.deepEqual(copied, ['fixture-session-id']);
+    assert.equal(notices.length, 1);
+    assert.equal(notices[0].level, fail ? 'error' : 'info');
+    assert.match(notices[0].message, /fixture-session-id/);
+    assert.match(notices[0].message, fail ? /Could not copy session ID:.*clipboard unavailable/ : /^Copied session ID:/);
+  });
+}