@saifymatteo/pi-extensions 0.0.0-stage → 0.1.0

package/packages/pi-load-pi-dotenv/README.md

@@ -0,0 +1,27 @@
+# Pi dotenv loader
+
+Loads environment variables from the Pi agent directory without replacing existing environment values.
+
+## Try locally
+
+From the repository root:
+
+```sh
+pi -e ./packages/pi-load-pi-dotenv
+```
+
+This uses your normal personal resources unless you isolate the agent home. Follow the [root README](../../README.md#isolated-sessions) to avoid loading an existing copy of the extension. Nothing is installed globally. 
+
+## Configuration and requirements
+
+Reads <agent-dir>/.env, where <agent-dir> is PI_CODING_AGENT_DIR or ~/.pi/agent. Supports $NAME and ${NAME} expansion. Missing and circular references remain literal. Missing files are ignored.
+
+## Compatibility and safety
+
+Loaded values are inherited by subprocesses. Keep .env out of Git. This loader runs during extension initialization; do not assume it loads credentials early enough for every provider's discovery.
+
+Imported host APIs are declared as peer dependencies and supplied by the Pi host. A `*` peer range describes host resolution, not a guarantee of compatibility with every release. See root verification notes for what was actually exercised.
+
+## Status
+
+Part of the [pi-extensions](../../README.md) collection. No personal settings or credentials are included; see [NOTICE.md](NOTICE.md) for licensing and provenance.

package/packages/pi-load-pi-dotenv/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@saifymatteo/pi-load-pi-dotenv",
+  "version": "0.1.0",
+  "description": "Loads environment variables from the Pi agent directory without replacing existing environment values.",
+  "type": "module",
+  "license": "AGPL-3.0-only",
+  "keywords": [
+    "pi-package"
+  ],
+  "files": [
+    "src",
+    "README.md",
+    "NOTICE.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/saifymatteo/pi-extensions.git",
+    "directory": "packages/pi-load-pi-dotenv"
+  }
+}

package/packages/pi-load-pi-dotenv/src/index.ts

@@ -0,0 +1,66 @@
+/**
+ * Load <PI_CODING_AGENT_DIR>/.env into process.env so bash-tool subprocesses
+ * inherit the vars (verified: extension-set process.env reaches bash).
+ * No tool registration -> no conflict with extensions that override `bash`
+ * (e.g. pi-tool-display). Resolution: $PI_CODING_AGENT_DIR/.env first,
+ * fallback ~/.pi/agent/.env.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import os from "node:os";
+
+// Expand $NAME and ${NAME}; leave missing or circular references literal.
+function expandValue(
+	value: string,
+	envFile: Record<string, string>,
+	hostEnv: NodeJS.ProcessEnv,
+	resolving = new Set<string>(),
+): string {
+	return value.replace(/\$([A-Za-z_][A-Za-z0-9_]*)|\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (token, bare, braced) => {
+		const name = braced || bare;
+		if (hostEnv[name] !== undefined) return hostEnv[name];
+		if (!(name in envFile) || resolving.has(name)) return token;
+		const nextResolving = new Set(resolving).add(name);
+		return expandValue(envFile[name], envFile, hostEnv, nextResolving);
+	});
+}
+
+function parseDotEnv(path: string): Record<string, string> {
+	const out: Record<string, string> = {};
+	let text;
+	try {
+		text = readFileSync(path, "utf8");
+	} catch {
+		return out;
+	}
+	for (const raw of text.split(/\r?\n/)) {
+		const line = raw.trim();
+		if (!line || line.startsWith("#")) continue;
+		const eq = line.indexOf("=");
+		if (eq <= 0) continue;
+		const key = line.slice(0, eq).trim();
+		let value = line.slice(eq + 1).trim();
+		if (
+			(value.startsWith('"') && value.endsWith('"')) ||
+			(value.startsWith("'") && value.endsWith("'"))
+		) {
+			value = value.slice(1, -1);
+		}
+		out[key] = value;
+	}
+	return out;
+}
+
+export default function () {
+	const envPath = join(
+		process.env.PI_CODING_AGENT_DIR || join(os.homedir(), ".pi", "agent"),
+		".env",
+	);
+	const envFile = parseDotEnv(envPath);
+	for (const [k, v] of Object.entries(envFile)) {
+		// Fill gap only; never clobber vars already set in the session.
+		if (process.env[k] === undefined) {
+			process.env[k] = expandValue(v, envFile, process.env, new Set([k]));
+		}
+	}
+}