@entelligentsia/forgecli 0.7.7 → 0.7.9

package/node_modules/@earendil-works/pi-coding-agent/examples/extensions/custom-provider-anthropic/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "pi-extension-custom-provider-anthropic",
+  "private": true,
+  "version": "0.74.1",
+  "type": "module",
+  "scripts": {
+    "clean": "echo 'nothing to clean'",
+    "build": "echo 'nothing to build'",
+    "check": "echo 'nothing to check'"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.52.0"
+  }
+}

package/node_modules/@earendil-works/pi-coding-agent/examples/extensions/custom-provider-gitlab-duo/index.ts

@@ -0,0 +1,349 @@
+/**
+ * GitLab Duo Provider Extension
+ *
+ * Provides access to GitLab Duo AI models (Claude and GPT) through GitLab's AI Gateway.
+ * Delegates to pi-ai's built-in Anthropic and OpenAI streaming implementations.
+ *
+ * Usage:
+ *   pi -e ./packages/coding-agent/examples/extensions/custom-provider-gitlab-duo
+ *   # Then /login gitlab-duo, or set GITLAB_TOKEN=glpat-...
+ */
+
+import {
+	type Api,
+	type AssistantMessageEventStream,
+	type Context,
+	createAssistantMessageEventStream,
+	type Model,
+	type OAuthCredentials,
+	type OAuthLoginCallbacks,
+	type SimpleStreamOptions,
+	streamSimpleAnthropic,
+	streamSimpleOpenAIResponses,
+} from "@earendil-works/pi-ai";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+// =============================================================================
+// Constants
+// =============================================================================
+
+const GITLAB_COM_URL = "https://gitlab.com";
+const AI_GATEWAY_URL = "https://cloud.gitlab.com";
+const ANTHROPIC_PROXY_URL = `${AI_GATEWAY_URL}/ai/v1/proxy/anthropic/`;
+const OPENAI_PROXY_URL = `${AI_GATEWAY_URL}/ai/v1/proxy/openai/v1`;
+
+const BUNDLED_CLIENT_ID = "da4edff2e6ebd2bc3208611e2768bc1c1dd7be791dc5ff26ca34ca9ee44f7d4b";
+const OAUTH_SCOPES = ["api"];
+const REDIRECT_URI = "http://127.0.0.1:8080/callback";
+const DIRECT_ACCESS_TTL = 25 * 60 * 1000;
+
+// =============================================================================
+// Models - exported for use by tests
+// =============================================================================
+
+type Backend = "anthropic" | "openai";
+
+interface GitLabModel {
+	id: string;
+	name: string;
+	backend: Backend;
+	baseUrl: string;
+	reasoning: boolean;
+	input: ("text" | "image")[];
+	cost: { input: number; output: number; cacheRead: number; cacheWrite: number };
+	contextWindow: number;
+	maxTokens: number;
+}
+
+export const MODELS: GitLabModel[] = [
+	// Anthropic
+	{
+		id: "claude-opus-4-5-20251101",
+		name: "Claude Opus 4.5",
+		backend: "anthropic",
+		baseUrl: ANTHROPIC_PROXY_URL,
+		reasoning: true,
+		input: ["text", "image"],
+		cost: { input: 15, output: 75, cacheRead: 1.5, cacheWrite: 18.75 },
+		contextWindow: 200000,
+		maxTokens: 32000,
+	},
+	{
+		id: "claude-sonnet-4-5-20250929",
+		name: "Claude Sonnet 4.5",
+		backend: "anthropic",
+		baseUrl: ANTHROPIC_PROXY_URL,
+		reasoning: true,
+		input: ["text", "image"],
+		cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
+		contextWindow: 200000,
+		maxTokens: 16384,
+	},
+	{
+		id: "claude-haiku-4-5-20251001",
+		name: "Claude Haiku 4.5",
+		backend: "anthropic",
+		baseUrl: ANTHROPIC_PROXY_URL,
+		reasoning: true,
+		input: ["text", "image"],
+		cost: { input: 1, output: 5, cacheRead: 0.1, cacheWrite: 1.25 },
+		contextWindow: 200000,
+		maxTokens: 8192,
+	},
+	// OpenAI (all use Responses API)
+	{
+		id: "gpt-5.1-2025-11-13",
+		name: "GPT-5.1",
+		backend: "openai",
+		baseUrl: OPENAI_PROXY_URL,
+		reasoning: true,
+		input: ["text", "image"],
+		cost: { input: 2.5, output: 10, cacheRead: 0, cacheWrite: 0 },
+		contextWindow: 128000,
+		maxTokens: 16384,
+	},
+	{
+		id: "gpt-5-mini-2025-08-07",
+		name: "GPT-5 Mini",
+		backend: "openai",
+		baseUrl: OPENAI_PROXY_URL,
+		reasoning: true,
+		input: ["text", "image"],
+		cost: { input: 0.15, output: 0.6, cacheRead: 0, cacheWrite: 0 },
+		contextWindow: 128000,
+		maxTokens: 16384,
+	},
+	{
+		id: "gpt-5-codex",
+		name: "GPT-5 Codex",
+		backend: "openai",
+		baseUrl: OPENAI_PROXY_URL,
+		reasoning: true,
+		input: ["text", "image"],
+		cost: { input: 2.5, output: 10, cacheRead: 0, cacheWrite: 0 },
+		contextWindow: 128000,
+		maxTokens: 16384,
+	},
+];
+
+const MODEL_MAP = new Map(MODELS.map((m) => [m.id, m]));
+
+// =============================================================================
+// Direct Access Token Cache
+// =============================================================================
+
+interface DirectAccessToken {
+	token: string;
+	headers: Record<string, string>;
+	expiresAt: number;
+}
+
+let cachedDirectAccess: DirectAccessToken | null = null;
+
+async function getDirectAccessToken(gitlabAccessToken: string): Promise<DirectAccessToken> {
+	const now = Date.now();
+	if (cachedDirectAccess && cachedDirectAccess.expiresAt > now) {
+		return cachedDirectAccess;
+	}
+
+	const response = await fetch(`${GITLAB_COM_URL}/api/v4/ai/third_party_agents/direct_access`, {
+		method: "POST",
+		headers: { Authorization: `Bearer ${gitlabAccessToken}`, "Content-Type": "application/json" },
+		body: JSON.stringify({ feature_flags: { DuoAgentPlatformNext: true } }),
+	});
+
+	if (!response.ok) {
+		const errorText = await response.text();
+		if (response.status === 403) {
+			throw new Error(
+				`GitLab Duo access denied. Ensure GitLab Duo is enabled for your account. Error: ${errorText}`,
+			);
+		}
+		throw new Error(`Failed to get direct access token: ${response.status} ${errorText}`);
+	}
+
+	const data = (await response.json()) as { token: string; headers: Record<string, string> };
+	cachedDirectAccess = { token: data.token, headers: data.headers, expiresAt: now + DIRECT_ACCESS_TTL };
+	return cachedDirectAccess;
+}
+
+function invalidateDirectAccessToken() {
+	cachedDirectAccess = null;
+}
+
+// =============================================================================
+// OAuth
+// =============================================================================
+
+async function generatePKCE(): Promise<{ verifier: string; challenge: string }> {
+	const array = new Uint8Array(32);
+	crypto.getRandomValues(array);
+	const verifier = btoa(String.fromCharCode(...array))
+		.replace(/\+/g, "-")
+		.replace(/\//g, "_")
+		.replace(/=+$/, "");
+	const hash = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(verifier));
+	const challenge = btoa(String.fromCharCode(...new Uint8Array(hash)))
+		.replace(/\+/g, "-")
+		.replace(/\//g, "_")
+		.replace(/=+$/, "");
+	return { verifier, challenge };
+}
+
+async function loginGitLab(callbacks: OAuthLoginCallbacks): Promise<OAuthCredentials> {
+	const { verifier, challenge } = await generatePKCE();
+	const authParams = new URLSearchParams({
+		client_id: BUNDLED_CLIENT_ID,
+		redirect_uri: REDIRECT_URI,
+		response_type: "code",
+		scope: OAUTH_SCOPES.join(" "),
+		code_challenge: challenge,
+		code_challenge_method: "S256",
+		state: crypto.randomUUID(),
+	});
+
+	callbacks.onAuth({ url: `${GITLAB_COM_URL}/oauth/authorize?${authParams.toString()}` });
+	const callbackUrl = await callbacks.onPrompt({ message: "Paste the callback URL:" });
+	const code = new URL(callbackUrl).searchParams.get("code");
+	if (!code) throw new Error("No authorization code found in callback URL");
+
+	const tokenResponse = await fetch(`${GITLAB_COM_URL}/oauth/token`, {
+		method: "POST",
+		headers: { "Content-Type": "application/x-www-form-urlencoded" },
+		body: new URLSearchParams({
+			client_id: BUNDLED_CLIENT_ID,
+			grant_type: "authorization_code",
+			code,
+			code_verifier: verifier,
+			redirect_uri: REDIRECT_URI,
+		}).toString(),
+	});
+
+	if (!tokenResponse.ok) throw new Error(`Token exchange failed: ${await tokenResponse.text()}`);
+	const data = (await tokenResponse.json()) as {
+		access_token: string;
+		refresh_token: string;
+		expires_in: number;
+		created_at: number;
+	};
+	invalidateDirectAccessToken();
+	return {
+		refresh: data.refresh_token,
+		access: data.access_token,
+		expires: (data.created_at + data.expires_in) * 1000 - 5 * 60 * 1000,
+	};
+}
+
+async function refreshGitLabToken(credentials: OAuthCredentials): Promise<OAuthCredentials> {
+	const response = await fetch(`${GITLAB_COM_URL}/oauth/token`, {
+		method: "POST",
+		headers: { "Content-Type": "application/x-www-form-urlencoded" },
+		body: new URLSearchParams({
+			client_id: BUNDLED_CLIENT_ID,
+			grant_type: "refresh_token",
+			refresh_token: credentials.refresh,
+		}).toString(),
+	});
+	if (!response.ok) throw new Error(`Token refresh failed: ${await response.text()}`);
+	const data = (await response.json()) as {
+		access_token: string;
+		refresh_token: string;
+		expires_in: number;
+		created_at: number;
+	};
+	invalidateDirectAccessToken();
+	return {
+		refresh: data.refresh_token,
+		access: data.access_token,
+		expires: (data.created_at + data.expires_in) * 1000 - 5 * 60 * 1000,
+	};
+}
+
+// =============================================================================
+// Stream Function
+// =============================================================================
+
+export function streamGitLabDuo(
+	model: Model<Api>,
+	context: Context,
+	options?: SimpleStreamOptions,
+): AssistantMessageEventStream {
+	const stream = createAssistantMessageEventStream();
+
+	(async () => {
+		try {
+			const gitlabAccessToken = options?.apiKey;
+			if (!gitlabAccessToken) throw new Error("No GitLab access token. Run /login gitlab-duo or set GITLAB_TOKEN");
+
+			const cfg = MODEL_MAP.get(model.id);
+			if (!cfg) throw new Error(`Unknown model: ${model.id}`);
+
+			const directAccess = await getDirectAccessToken(gitlabAccessToken);
+			const modelWithBaseUrl = { ...model, baseUrl: cfg.baseUrl };
+			const headers = { ...directAccess.headers, Authorization: `Bearer ${directAccess.token}` };
+			const streamOptions = { ...options, apiKey: "gitlab-duo", headers };
+
+			const innerStream =
+				cfg.backend === "anthropic"
+					? streamSimpleAnthropic(modelWithBaseUrl as Model<"anthropic-messages">, context, streamOptions)
+					: streamSimpleOpenAIResponses(modelWithBaseUrl as Model<"openai-responses">, context, streamOptions);
+
+			for await (const event of innerStream) stream.push(event);
+			stream.end();
+		} catch (error) {
+			stream.push({
+				type: "error",
+				reason: "error",
+				error: {
+					role: "assistant",
+					content: [],
+					api: model.api,
+					provider: model.provider,
+					model: model.id,
+					usage: {
+						input: 0,
+						output: 0,
+						cacheRead: 0,
+						cacheWrite: 0,
+						totalTokens: 0,
+						cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+					},
+					stopReason: "error",
+					errorMessage: error instanceof Error ? error.message : String(error),
+					timestamp: Date.now(),
+				},
+			});
+			stream.end();
+		}
+	})();
+
+	return stream;
+}
+
+// =============================================================================
+// Extension Entry Point
+// =============================================================================
+
+export default function (pi: ExtensionAPI) {
+	pi.registerProvider("gitlab-duo", {
+		baseUrl: AI_GATEWAY_URL,
+		apiKey: "GITLAB_TOKEN",
+		api: "gitlab-duo-api",
+		models: MODELS.map(({ id, name, reasoning, input, cost, contextWindow, maxTokens }) => ({
+			id,
+			name,
+			reasoning,
+			input,
+			cost,
+			contextWindow,
+			maxTokens,
+		})),
+		oauth: {
+			name: "GitLab Duo",
+			login: loginGitLab,
+			refreshToken: refreshGitLabToken,
+			getApiKey: (cred) => cred.access,
+		},
+		streamSimple: streamGitLabDuo,
+	});
+}

package/node_modules/@earendil-works/pi-coding-agent/examples/extensions/custom-provider-gitlab-duo/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "pi-extension-custom-provider-gitlab-duo",
+  "private": true,
+  "version": "0.74.1",
+  "type": "module",
+  "scripts": {
+    "clean": "echo 'nothing to clean'",
+    "build": "echo 'nothing to build'",
+    "check": "echo 'nothing to check'"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}

package/node_modules/@earendil-works/pi-coding-agent/examples/extensions/custom-provider-gitlab-duo/test.ts

@@ -0,0 +1,82 @@
+/**
+ * Test script for GitLab Duo extension
+ * Run: npx tsx test.ts [model-id] [--thinking]
+ *
+ * Examples:
+ *   npx tsx test.ts                              # Test default (claude-sonnet-4-5-20250929)
+ *   npx tsx test.ts gpt-5-codex                  # Test GPT-5 Codex
+ *   npx tsx test.ts claude-sonnet-4-5-20250929 --thinking
+ */
+
+import { type Api, type Context, type Model, registerApiProvider, streamSimple } from "@earendil-works/pi-ai";
+import { readFileSync } from "fs";
+import { getAgentDir } from "packages/coding-agent/src/config.js";
+import { join } from "path";
+import { MODELS, streamGitLabDuo } from "./index.js";
+
+const MODEL_MAP = new Map(MODELS.map((m) => [m.id, m]));
+
+async function main() {
+	const modelId = process.argv[2] || "claude-sonnet-4-5-20250929";
+	const useThinking = process.argv.includes("--thinking");
+
+	const cfg = MODEL_MAP.get(modelId);
+	if (!cfg) {
+		console.error(`Unknown model: ${modelId}`);
+		console.error("Available:", MODELS.map((m) => m.id).join(", "));
+		process.exit(1);
+	}
+
+	// Read auth
+	const authPath = join(getAgentDir(), "extensions", "auth.json");
+	const authData = JSON.parse(readFileSync(authPath, "utf-8"));
+	const gitlabCred = authData["gitlab-duo"];
+	if (!gitlabCred?.access) {
+		console.error("No gitlab-duo credentials. Run /login gitlab-duo first.");
+		process.exit(1);
+	}
+
+	// Register provider
+	registerApiProvider({
+		api: "gitlab-duo-api" as Api,
+		stream: streamGitLabDuo,
+		streamSimple: streamGitLabDuo,
+	});
+
+	// Create model
+	const model: Model<Api> = {
+		id: cfg.id,
+		name: cfg.name,
+		api: "gitlab-duo-api" as Api,
+		provider: "gitlab-duo",
+		baseUrl: cfg.baseUrl,
+		reasoning: cfg.reasoning,
+		input: cfg.input,
+		cost: cfg.cost,
+		contextWindow: cfg.contextWindow,
+		maxTokens: cfg.maxTokens,
+	};
+
+	const context: Context = {
+		messages: [{ role: "user", content: "Say hello in exactly 3 words.", timestamp: Date.now() }],
+	};
+
+	console.log(`Model: ${model.id}, Backend: ${cfg.backend}, Thinking: ${useThinking}`);
+
+	const stream = streamSimple(model, context, {
+		apiKey: gitlabCred.access,
+		maxTokens: 100,
+		reasoning: useThinking ? "low" : undefined,
+	});
+
+	for await (const event of stream) {
+		if (event.type === "thinking_start") console.log("[Thinking]");
+		else if (event.type === "thinking_delta") process.stdout.write(event.delta);
+		else if (event.type === "thinking_end") console.log("\n[/Thinking]\n");
+		else if (event.type === "text_delta") process.stdout.write(event.delta);
+		else if (event.type === "error") console.error("\nError:", event.error.errorMessage);
+		else if (event.type === "done") console.log("\n\nDone!", event.reason, event.message.usage);
+	}
+}
+
+main().catch(console.error);

package/node_modules/@earendil-works/pi-coding-agent/examples/extensions/dirty-repo-guard.ts

@@ -0,0 +1,56 @@
+/**
+ * Dirty Repo Guard Extension
+ *
+ * Prevents session changes when there are uncommitted git changes.
+ * Useful to ensure work is committed before switching context.
+ */
+
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+
+async function checkDirtyRepo(
+	pi: ExtensionAPI,
+	ctx: ExtensionContext,
+	action: string,
+): Promise<{ cancel: boolean } | undefined> {
+	// Check for uncommitted changes
+	const { stdout, code } = await pi.exec("git", ["status", "--porcelain"]);
+
+	if (code !== 0) {
+		// Not a git repo, allow the action
+		return;
+	}
+
+	const hasChanges = stdout.trim().length > 0;
+	if (!hasChanges) {
+		return;
+	}
+
+	if (!ctx.hasUI) {
+		// In non-interactive mode, block by default
+		return { cancel: true };
+	}
+
+	// Count changed files
+	const changedFiles = stdout.trim().split("\n").filter(Boolean).length;
+
+	const choice = await ctx.ui.select(`You have ${changedFiles} uncommitted file(s). ${action} anyway?`, [
+		"Yes, proceed anyway",
+		"No, let me commit first",
+	]);
+
+	if (choice !== "Yes, proceed anyway") {
+		ctx.ui.notify("Commit your changes first", "warning");
+		return { cancel: true };
+	}
+}
+
+export default function (pi: ExtensionAPI) {
+	pi.on("session_before_switch", async (event, ctx) => {
+		const action = event.reason === "new" ? "new session" : "switch session";
+		return checkDirtyRepo(pi, ctx, action);
+	});
+
+	pi.on("session_before_fork", async (_event, ctx) => {
+		return checkDirtyRepo(pi, ctx, "fork");
+	});
+}

package/node_modules/@earendil-works/pi-coding-agent/examples/extensions/doom-overlay/doom-component.ts

@@ -0,0 +1,132 @@
+/**
+ * DOOM Component for overlay mode
+ *
+ * Renders DOOM frames using half-block characters (▀) with 24-bit color.
+ * Height is calculated from width to maintain DOOM's aspect ratio.
+ */
+
+import type { Component } from "@earendil-works/pi-tui";
+import { isKeyRelease, type TUI } from "@earendil-works/pi-tui";
+import type { DoomEngine } from "./doom-engine.js";
+import { DoomKeys, mapKeyToDoom } from "./doom-keys.js";
+
+function renderHalfBlock(
+	rgba: Uint8Array,
+	width: number,
+	height: number,
+	targetCols: number,
+	targetRows: number,
+): string[] {
+	const lines: string[] = [];
+	const scaleX = width / targetCols;
+	const scaleY = height / (targetRows * 2);
+
+	for (let row = 0; row < targetRows; row++) {
+		let line = "";
+		const srcY1 = Math.floor(row * 2 * scaleY);
+		const srcY2 = Math.floor((row * 2 + 1) * scaleY);
+
+		for (let col = 0; col < targetCols; col++) {
+			const srcX = Math.floor(col * scaleX);
+			const idx1 = (srcY1 * width + srcX) * 4;
+			const idx2 = (srcY2 * width + srcX) * 4;
+			const r1 = rgba[idx1] ?? 0,
+				g1 = rgba[idx1 + 1] ?? 0,
+				b1 = rgba[idx1 + 2] ?? 0;
+			const r2 = rgba[idx2] ?? 0,
+				g2 = rgba[idx2 + 1] ?? 0,
+				b2 = rgba[idx2 + 2] ?? 0;
+			line += `\x1b[38;2;${r1};${g1};${b1}m\x1b[48;2;${r2};${g2};${b2}m▀`;
+		}
+		line += "\x1b[0m";
+		lines.push(line);
+	}
+	return lines;
+}
+
+export class DoomOverlayComponent implements Component {
+	private engine: DoomEngine;
+	private tui: TUI;
+	private interval: ReturnType<typeof setInterval> | null = null;
+	private onExit: () => void;
+
+	// Opt-in to key release events for smooth movement
+	wantsKeyRelease = true;
+
+	constructor(tui: TUI, engine: DoomEngine, onExit: () => void, resume = false) {
+		this.tui = tui;
+		this.engine = engine;
+		this.onExit = onExit;
+
+		// Unpause if resuming
+		if (resume) {
+			this.engine.pushKey(true, DoomKeys.KEY_PAUSE);
+			this.engine.pushKey(false, DoomKeys.KEY_PAUSE);
+		}
+
+		this.startGameLoop();
+	}
+
+	private startGameLoop(): void {
+		this.interval = setInterval(() => {
+			try {
+				this.engine.tick();
+				this.tui.requestRender();
+			} catch {
+				// WASM error (e.g., exit via DOOM menu) - treat as quit
+				this.dispose();
+				this.onExit();
+			}
+		}, 1000 / 35);
+	}
+
+	handleInput(data: string): void {
+		// Q to pause and exit (but not on release)
+		if (!isKeyRelease(data) && (data === "q" || data === "Q")) {
+			// Send DOOM's pause key before exiting
+			this.engine.pushKey(true, DoomKeys.KEY_PAUSE);
+			this.engine.pushKey(false, DoomKeys.KEY_PAUSE);
+			this.dispose();
+			this.onExit();
+			return;
+		}
+
+		const doomKeys = mapKeyToDoom(data);
+		if (doomKeys.length === 0) return;
+
+		const released = isKeyRelease(data);
+
+		for (const key of doomKeys) {
+			this.engine.pushKey(!released, key);
+		}
+	}
+
+	render(width: number): string[] {
+		// DOOM renders at 640x400 (1.6:1 ratio)
+		// With half-block characters, each terminal row = 2 pixels
+		// So effective ratio is 640:200 = 3.2:1 (width:height in terminal cells)
+		// Add 1 row for footer
+		const ASPECT_RATIO = 3.2;
+		const MIN_HEIGHT = 10;
+		const height = Math.max(MIN_HEIGHT, Math.floor(width / ASPECT_RATIO));
+
+		const rgba = this.engine.getFrameRGBA();
+		const lines = renderHalfBlock(rgba, this.engine.width, this.engine.height, width, height);
+
+		// Footer
+		const footer = " DOOM | Q=Pause | WASD=Move | Shift+WASD=Run | Space=Use | F=Fire | 1-7=Weapons";
+		const truncatedFooter = footer.length > width ? footer.slice(0, width) : footer;
+		lines.push(`\x1b[2m${truncatedFooter}\x1b[0m`);
+
+		return lines;
+	}
+
+	invalidate(): void {}
+
+	dispose(): void {
+		if (this.interval) {
+			clearInterval(this.interval);
+			this.interval = null;
+		}
+	}
+}