@pi-agents/orchid 0.1.0-beta.0

package/src/orchestrator/sessions.ts

@@ -0,0 +1,57 @@
+/**
+ * Runtime V2 session discovery and formatting
+ * @module orch/sessions
+ */
+
+import { ORCH_MESSAGES } from "./messages.ts";
+import type { OrchBatchRuntimeState, OrchestratorSessionEntry } from "./types.ts";
+
+// ── Session Discovery ────────────────────────────────────────────────
+
+/**
+ * List active orchestrator sessions from in-memory batch state.
+ *
+ * Runtime V2 no longer uses TMUX as the execution owner. Session rows are
+ * derived from canonical lane session IDs in runtime state.
+ *
+ * @param _tmuxPrefix - Legacy parameter kept for API compatibility
+ * @param batchState  - Current batch state for lane/task enrichment
+ * @returns Array of session entries
+ */
+export function listOrchSessions(
+	_tmuxPrefix: string,
+	batchState?: OrchBatchRuntimeState,
+): OrchestratorSessionEntry[] {
+	if (!batchState || batchState.currentLanes.length === 0) return [];
+
+	return batchState.currentLanes
+		.map((lane) => ({
+			sessionName: lane.laneSessionId,
+			laneId: lane.laneId,
+			taskId: lane.tasks.length > 0 ? lane.tasks[0].taskId : null,
+			status: "alive" as const,
+			worktreePath: lane.worktreePath,
+			attachCmd: "Runtime V2 (no tmux attach)",
+		}))
+		.sort((a, b) => a.sessionName.localeCompare(b.sessionName));
+}
+
+/**
+ * Format session listing for display.
+ */
+export function formatOrchSessions(sessions: OrchestratorSessionEntry[]): string {
+	if (sessions.length === 0) {
+		return ORCH_MESSAGES.sessionsNone();
+	}
+
+	const lines: string[] = [ORCH_MESSAGES.sessionsHeader(sessions.length), ""];
+
+	for (const s of sessions) {
+		const statusIcon = s.status === "alive" ? "🟢" : "🔴";
+		const taskInfo = s.taskId ? ` (${s.taskId})` : "";
+		lines.push(`  ${statusIcon} ${s.sessionName} [${s.laneId}]${taskInfo}`);
+		lines.push(`     ${s.attachCmd}`);
+	}
+
+	return lines.join("\n");
+}

package/src/orchestrator/settings-loader.ts

@@ -0,0 +1,136 @@
+/**
+ * Settings Loader — Read and merge Pi extension packages from settings files
+ *
+ * Reads `.pi/settings.json` from both project-level and global locations,
+ * extracts the `packages` arrays, merges them (project entries first,
+ * deduplicated), and filters out orchid itself.
+ *
+ * Used by spawn points (worker, reviewer, merge agent) to forward
+ * user-installed extensions as explicit `-e` flags alongside `--no-extensions`.
+ *
+ * @module orchid/settings-loader
+ * @since TP-180
+ */
+
+import { readFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+
+// ── Constants ────────────────────────────────────────────────────────
+
+/** Subpath under a project root for the project-level Pi settings file. */
+const PROJECT_SETTINGS_SUBPATH = join(".pi", "settings.json");
+
+/** Subpath under the global agent dir for the global Pi settings file. */
+const GLOBAL_SETTINGS_SUBPATH = join(".pi", "agent", "settings.json");
+
+// ── Internal Helpers ─────────────────────────────────────────────────
+
+/**
+ * Safely read and parse a JSON file, returning null on any failure.
+ */
+function readJsonSafe(filePath: string): Record<string, unknown> | null {
+	try {
+		const raw = readFileSync(filePath, "utf-8");
+		const parsed = JSON.parse(raw);
+		if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+			return parsed as Record<string, unknown>;
+		}
+		return null;
+	} catch {
+		return null;
+	}
+}
+
+/**
+ * Extract the `packages` array from a parsed settings object.
+ * Returns an empty array if the key is missing or not an array of strings.
+ */
+function extractPackages(settings: Record<string, unknown> | null): string[] {
+	if (!settings) return [];
+	const packages = settings.packages;
+	if (!Array.isArray(packages)) return [];
+	// Filter to strings only, skip non-string entries gracefully
+	return packages.filter((p): p is string => typeof p === "string" && p.length > 0);
+}
+
+/**
+ * Resolve the global Pi agent settings path.
+ *
+ * Resolution order:
+ *   1. `PI_CODING_AGENT_DIR` env → `<value>/settings.json`
+ *   2. `os.homedir()/.pi/agent/settings.json`
+ */
+function resolveGlobalSettingsPath(): string {
+	const agentDir = process.env.PI_CODING_AGENT_DIR;
+	if (agentDir) {
+		return join(agentDir, "settings.json");
+	}
+	return join(homedir(), GLOBAL_SETTINGS_SUBPATH);
+}
+
+// ── Public API ───────────────────────────────────────────────────────
+
+/**
+ * Load Pi extension packages from project and global settings files.
+ *
+ * Reads `.pi/settings.json` from the project root (stateRoot) and from
+ * the global agent directory, merges the package lists (project first,
+ * deduplicated), and filters out any package containing "orchid"
+ * (which is already loaded as the bridge extension).
+ *
+ * @param stateRoot - Project root directory (used to locate `.pi/settings.json`)
+ * @returns Array of package specifiers (e.g., `["npm:pi-sage"]`) or empty array
+ */
+export function loadPiSettingsPackages(stateRoot: string): string[] {
+	// Read project-level packages
+	const projectSettingsPath = join(stateRoot, PROJECT_SETTINGS_SUBPATH);
+	const projectSettings = readJsonSafe(projectSettingsPath);
+	const projectPackages = extractPackages(projectSettings);
+
+	// Read global packages
+	const globalSettingsPath = resolveGlobalSettingsPath();
+	const globalSettings = readJsonSafe(globalSettingsPath);
+	const globalPackages = extractPackages(globalSettings);
+
+	// Merge: project entries first, then global, deduplicated
+	const seen = new Set<string>();
+	const merged: string[] = [];
+
+	for (const pkg of projectPackages) {
+		if (!seen.has(pkg)) {
+			seen.add(pkg);
+			merged.push(pkg);
+		}
+	}
+	for (const pkg of globalPackages) {
+		if (!seen.has(pkg)) {
+			seen.add(pkg);
+			merged.push(pkg);
+		}
+	}
+
+	// Filter out orchid itself (already loaded as bridge extension).
+	// Match known specifier patterns: "npm:@pi-agents/orchid", "@pi-agents/orchid", or scoped
+	// variants like "npm:@scope/orchid". Avoid substring matching to prevent
+	// false positives on unrelated packages containing "orchid" in their name.
+	return merged.filter((pkg) => {
+		// Strip npm:/git: prefix to get the bare package name
+		const bare = pkg.replace(/^(?:npm:|git:(?:github\.com\/[^/]+\/)?)/, "").toLowerCase();
+		// Exact match on bare name, or scoped exact match (@scope/orchid)
+		return bare !== "@pi-agents/orchid" && !bare.endsWith("/orchid");
+	});
+}
+
+/**
+ * Filter out excluded extensions from a package list.
+ *
+ * @param packages - Full list of package specifiers
+ * @param exclusions - Package specifiers to exclude (exact match)
+ * @returns Filtered list with excluded packages removed
+ */
+export function filterExcludedExtensions(packages: string[], exclusions: string[]): string[] {
+	if (!exclusions || exclusions.length === 0) return packages;
+	const excludeSet = new Set(exclusions);
+	return packages.filter((pkg) => !excludeSet.has(pkg));
+}