@raoxxxwq/pi-codebuddy-sdk 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eli Dickinson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,135 @@
+# @raoxxxwq/pi-codebuddy-sdk
+
+Pi extension that registers **CodeBuddy** as a model provider. You keep using Pi for the TUI, tools, skills, and extensions; CodeBuddy Agent SDK runs inference locally via the `codebuddy` CLI. No HTTP proxy and no changes to how you work in Pi beyond picking a model.
+
+- Repository: `https://github.com/MuJianxuan/pi-codebuddy-sdk`
+- Author: `raoxxxwq`
+
+## What it does
+
+- Exposes CodeBuddy models in Pi (`codebuddy/...` in `/model`)
+- Bridges Pi tools to the SDK (Pi still executes tools; CodeBuddy only plans and calls them)
+- Forwards Pi's system prompt, skills, and project `AGENTS.md` so the model acts as Pi—not as standalone CodeBuddy Code
+- Supports session resume, compaction, streaming, thinking levels, and images
+- Learns runtime-served context windows over time and keeps Pi's registered model metadata conservatively aligned with observed reality
+- Optional **AskCodebuddy** tool to delegate a focused sub-task to another CodeBuddy call
+
+## Install
+
+```bash
+pi install npm:@raoxxxwq/pi-codebuddy-sdk
+```
+
+Restart `pi` if it was already running.
+
+## Requirements
+
+- **`codebuddy` on your `PATH`** — the extension spawns the same CLI you use standalone. If `which codebuddy` fails, either add it to `PATH` or set `pathToCodebuddyCode` in `codebuddy-sdk.json` (see [Configuration](#configuration)).
+- **CodeBuddy auth already working** — if `codebuddy` works in your terminal, you do not need extra setup for this extension.
+
+## Quick start (already using CodeBuddy)
+
+No `codebuddy-sdk.json` and no plugin-specific env vars are required.
+
+1. `pi install npm:@raoxxxwq/pi-codebuddy-sdk`
+2. Restart `pi`
+3. `/model` → pick `codebuddy/...`
+
+Optional: set `defaultProvider` / `defaultModel` in `~/.pi/agent/settings.json` so you skip `/model` each time.
+
+The first query after startup may take a few seconds while models are discovered from the SDK.
+
+## Auth
+
+The extension does not store credentials. The CodeBuddy CLI reads them from your machine. Use **one** of the following:
+
+### 1. CLI login (recommended)
+
+```bash
+codebuddy login
+```
+
+Complete login in the browser. Credentials stay on your machine; Pi reuses them automatically.
+
+### 2. API key
+
+```bash
+export CODEBUDDY_API_KEY="your-api-key"
+```
+
+Obtain the key from your CodeBuddy account. Do not commit it or store it in repo files.
+
+### 3. Tencent iOA (internal network)
+
+```bash
+export CODEBUDDY_INTERNET_ENVIRONMENT=ioa
+codebuddy login
+```
+
+Use this when CodeBuddy must run on the iOA network. Add `CODEBUDDY_API_KEY` as well if your environment requires it.
+
+## Usage
+
+```text
+pi
+/model
+```
+
+Pick any entry prefixed with `codebuddy/` (for example `codebuddy/hy3-preview-agent-ioa`).
+
+Tools, skills, extensions, `/compact`, and steer behave the same as with other Pi providers.
+
+## Configuration
+
+**Optional.** Defaults work for most users.
+
+File: `~/.pi/agent/codebuddy-sdk.json` or `.pi/codebuddy-sdk.json` in a project.
+
+```json
+{
+  "askCodebuddy": {
+    "enabled": true,
+    "allowFullMode": true
+  },
+  "provider": {
+    "appendSystemPrompt": true,
+    "strictMcpConfig": true,
+    "pathToCodebuddyCode": "/path/to/codebuddy"
+  }
+}
+```
+
+| Option | Default | Meaning |
+|--------|---------|---------|
+| `askCodebuddy.enabled` | `true` | Register the AskCodebuddy delegation tool |
+| `askCodebuddy.allowFullMode` | `true` | Allow write-capable delegation mode |
+| `provider.appendSystemPrompt` | `true` | Use Pi's system prompt and Pi Tool Bridge guidance instead of CodeBuddy's default identity; disable only for debugging/compatibility |
+| `provider.strictMcpConfig` | `true` | Use only Pi-bridged MCP tools so Pi remains the tool execution boundary; disable only for debugging/compatibility |
+| `provider.pathToCodebuddyCode` | auto | Path to `codebuddy` when it is **not** on `PATH` |
+
+## Privacy
+
+- The extension does **not** send conversation data to this repository or any third-party telemetry endpoint.
+- Credentials are handled entirely by the CodeBuddy CLI on your machine.
+- Optional debug mode (`CODEBUDDY_SDK_DEBUG=1`) writes **local** logs under `~/.pi/agent/`; paths are redacted, prompts and tool payloads are not logged. Delete logs when finished.
+
+## Troubleshooting
+
+```bash
+export CODEBUDDY_SDK_DEBUG=1
+```
+
+Default log: `~/.pi/agent/codebuddy-sdk.log`. See [CONTRIBUTING.md](CONTRIBUTING.md) for maintainer details.
+Runtime calibration cache: `~/.pi/agent/codebuddy-sdk-model-calibration.json` stores observed model capability floors per runtime environment.
+
+## Development
+
+Maintainers: [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT
+
+## Inspiration
+
+Early MCP bridge patterns were inspired by [pi-claude-bridge](https://github.com/elidickinson/pi-claude-bridge). This package is a separate codebase on [@tencent-ai/agent-sdk](https://www.npmjs.com/package/@tencent-ai/agent-sdk).

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@raoxxxwq/pi-codebuddy-sdk",
+  "version": "0.3.0",
+  "description": "Pi extension that uses CodeBuddy (via Agent SDK) as a model provider and adds an AskCodebuddy tool.",
+  "author": "raoxxxwq",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MuJianxuan/pi-codebuddy-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MuJianxuan/pi-codebuddy-sdk/issues"
+  },
+  "homepage": "https://github.com/MuJianxuan/pi-codebuddy-sdk#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-coding-agent",
+    "extension",
+    "codebuddy",
+    "agent-sdk",
+    "provider"
+  ],
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test:unit": "node --import tsx --test tests/unit-*.mjs",
+    "test": "set -a && [ -f .env.test ] && . .env.test; set +a && npm run test:unit && tests/int-smoke.sh && tests/int-multi-turn.sh && tests/int-cache.sh && node --import tsx --test tests/int-*.mjs",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@tencent-ai/agent-sdk": "^0.3.0",
+    "change-case": "^5.4.4",
+    "typebox": "^1.3.0",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": ">=0.80.0",
+    "@earendil-works/pi-coding-agent": ">=0.80.0",
+    "@earendil-works/pi-tui": ">=0.80.0"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-ai": "^0.80.2",
+    "@earendil-works/pi-coding-agent": "^0.80.2",
+    "@earendil-works/pi-tui": "^0.80.2",
+    "@types/node": "^24.13.2",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3"
+  },
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  }
+}

package/src/agents-md.ts

@@ -0,0 +1,54 @@
+// AGENTS.md discovery and sanitization for forwarding to Claude Code.
+//
+// Pi uses AGENTS.md for long-lived instructions; Claude Code reads the same
+// content under "# CLAUDE.md". We walk up from cwd looking for AGENTS.md,
+// fall back to ~/.pi/agent/AGENTS.md, and rewrite pi-specific references
+// (~/.pi, .pi/, .pi, pi) to their Claude Code equivalents so any paths or
+// references in the file still resolve inside the CC subprocess.
+
+import { existsSync, readFileSync } from "fs";
+import { homedir } from "os";
+import { dirname, join, resolve } from "path";
+
+const GLOBAL_AGENTS_PATH = join(homedir(), ".pi", "agent", "AGENTS.md");
+
+export function resolveAgentsMdPath(): string | undefined {
+	const fromCwd = findAgentsMdInParents(process.cwd());
+	if (fromCwd) return fromCwd;
+	if (existsSync(GLOBAL_AGENTS_PATH)) return GLOBAL_AGENTS_PATH;
+	return undefined;
+}
+
+export function findAgentsMdInParents(startDir: string): string | undefined {
+	let current = resolve(startDir);
+	while (true) {
+		const candidate = join(current, "AGENTS.md");
+		if (existsSync(candidate)) return candidate;
+		const parent = dirname(current);
+		if (parent === current) break;
+		current = parent;
+	}
+	return undefined;
+}
+
+export function extractAgentsAppend(): string | undefined {
+	const agentsPath = resolveAgentsMdPath();
+	if (!agentsPath) return undefined;
+	try {
+		const content = readFileSync(agentsPath, "utf-8").trim();
+		if (!content) return undefined;
+		const sanitized = sanitizeAgentsContent(content);
+		return sanitized.length > 0 ? `# CLAUDE.md\n\n${sanitized}` : undefined;
+	} catch {
+		return undefined;
+	}
+}
+
+export function sanitizeAgentsContent(content: string): string {
+	let sanitized = content;
+	sanitized = sanitized.replace(/~\/\.pi\b/gi, "~/.claude");
+	sanitized = sanitized.replace(/(^|[\s'"`])\.pi\//g, "$1.claude/");
+	sanitized = sanitized.replace(/\b\.pi\b/gi, ".claude");
+	sanitized = sanitized.replace(/\bpi\b/gi, "environment");
+	return sanitized;
+}

package/src/askcodebuddy-ui.ts

@@ -0,0 +1,90 @@
+// Status-line rendering helpers for the AskCodebuddy tool.
+//
+// While CodeBuddy runs inside an AskCodebuddy call, the pi TUI can't surface
+// each tool_use individually — there's only one status row for the whole
+// delegation. These helpers shape a tool_use record into a short, path-aware
+// label (e.g. "Read(src/foo.ts)", "Bash(git log --oneline…)") and collapse
+// runs of the same tool so the line doesn't flicker. Used only by
+// promptAndWait; the provider path exposes tools directly through pi's TUI
+// and doesn't need this.
+
+export interface ToolCallState {
+	name: string;
+	status: string;
+	rawInput?: unknown;
+}
+
+export function extractPath(rawInput: unknown): string | undefined {
+	if (!rawInput || typeof rawInput !== "object") return undefined;
+	const input = rawInput as Record<string, unknown>;
+	if (typeof input.file_path === "string") return input.file_path;
+	if (typeof input.path === "string") return input.path;
+	if (typeof input.command === "string") return input.command.substring(0, 80);
+	return undefined;
+}
+
+export function shortPath(p: string): string {
+	const cwd = process.cwd();
+	if (p.startsWith(cwd + "/")) return p.slice(cwd.length + 1);
+	if (p.startsWith("/")) {
+		const parts = p.split("/");
+		if (parts.length > 3) return parts.slice(-2).join("/");
+	}
+	return p;
+}
+
+export function formatToolAction(tc: ToolCallState): string | undefined {
+	const path = extractPath(tc.rawInput);
+	const verb = tc.name.toLowerCase().split(/\s/)[0];
+	if (verb === "read" || verb === "readfile") {
+		return path ? `Read(${shortPath(path)})` : "Read";
+	} else if (verb === "glob") {
+		const input = tc.rawInput as Record<string, unknown> | undefined;
+		const pat = typeof input?.pattern === "string" ? input.pattern.slice(0, 40) : "";
+		return pat ? `Glob(${pat})` : "Glob";
+	} else if (verb === "edit" || verb === "write" || verb === "writefile" || verb === "multiedit") {
+		return path ? `Edit(${shortPath(path)})` : "Edit";
+	} else if (verb === "bashoutput") {
+		return undefined; // redundant with preceding Bash call
+	} else if (verb === "bash" || verb === "terminal") {
+		return path ? `Bash(${path})` : "Bash";
+	} else if (verb === "agent") {
+		const input = tc.rawInput as Record<string, unknown> | undefined;
+		return `Agent(${String(input?.description ?? "").slice(0, 40)})`;
+	} else if (verb === "grep") {
+		const input = tc.rawInput as Record<string, unknown> | undefined;
+		const pat = typeof input?.pattern === "string" ? input.pattern.slice(0, 40) : "";
+		return pat ? `Grep(${pat})` : "Grep";
+	} else if (verb === "skill") {
+		const input = tc.rawInput as Record<string, unknown> | undefined;
+		const name = typeof input?.skill === "string" ? input.skill.slice(0, 40) : "";
+		return name ? `Skill(${name})` : "Skill";
+	} else if (verb === "todowrite" || verb === "taskcreate" || verb === "taskupdate") {
+		const todos = Array.isArray((tc.rawInput as any)?.todos) ? (tc.rawInput as any).todos : [];
+		const current = todos.find((t: any) => t.status === "in_progress") ?? todos.find((t: any) => t.status === "pending");
+		const label = current ? String(current.content ?? "").slice(0, 40) : "";
+		return label || undefined;
+	} else if (verb === "askclaude") {
+		// Recursive — don't show AskCodebuddy in its own action summary
+		return undefined;
+	}
+	return tc.name;
+}
+
+export function buildActionSummary(calls: Map<string, ToolCallState>): string {
+	const parts: string[] = [];
+	let prevVerb = "";
+	for (const [, tc] of calls) {
+		const action = formatToolAction(tc);
+		if (!action) continue;
+		const verb = tc.name.toLowerCase().split(/\s/)[0];
+		// Collapse consecutive calls to the same tool — keep only the latest
+		if (verb === prevVerb) {
+			parts[parts.length - 1] = action;
+		} else {
+			parts.push(action);
+		}
+		prevVerb = verb;
+	}
+	return parts.join("; ");
+}

package/src/cb-session-io.ts

@@ -0,0 +1,205 @@
+// CodeBuddy session JSONL read/write for pi session sync (replaces cc-session-io).
+// CodeBuddy stores sessions at ~/.codebuddy/projects/<sanitized-path>/<sessionId>.jsonl
+
+import { randomUUID } from "crypto";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import type { Message as PiMessage } from "@earendil-works/pi-ai";
+import { convertPiMessages, messageContentToText } from "./convert.js";
+
+export interface CbMessage {
+	role: "user" | "assistant";
+	content: string;
+}
+
+export function getCodebuddyDir(codebuddyDir?: string): string {
+	return codebuddyDir ?? process.env.CODEBUDDY_CONFIG_DIR ?? join(homedir(), ".codebuddy");
+}
+
+export function normalizeProjectPath(projectPath: string): string {
+	return projectPath.replace(/\/+$/, "") || projectPath;
+}
+
+export function projectPathToHash(projectPath: string): string {
+	return normalizeProjectPath(projectPath).replace(/^\//, "").replace(/\//g, "-");
+}
+
+export function getProjectDir(projectPath: string, codebuddyDir?: string): string {
+	return join(getCodebuddyDir(codebuddyDir), "projects", projectPathToHash(projectPath));
+}
+
+export function getSessionPath(sessionId: string, projectPath: string, codebuddyDir?: string): string {
+	return join(getProjectDir(projectPath, codebuddyDir), `${sessionId}.jsonl`);
+}
+
+export function deleteSession(sessionId: string, projectPath: string, codebuddyDir?: string): void {
+	const jsonlPath = getSessionPath(sessionId, projectPath, codebuddyDir);
+	const dir = join(getProjectDir(projectPath, codebuddyDir), sessionId);
+	try { rmSync(jsonlPath, { force: true }); } catch { /* ignore */ }
+	try { rmSync(dir, { recursive: true, force: true }); } catch { /* ignore */ }
+}
+
+function piToCbMessages(messages: PiMessage[]): CbMessage[] {
+	const { anthropicMessages } = convertPiMessages(messages);
+	const out: CbMessage[] = [];
+	for (const msg of anthropicMessages) {
+		if (msg.role === "user") {
+			const text = typeof msg.content === "string"
+				? msg.content
+				: msg.content.map((b: any) => b.type === "text" ? b.text : b.type === "tool_result" ? `[tool_result:${b.tool_use_id}]` : `[${b.type}]`).join("\n");
+			out.push({ role: "user", content: text });
+		} else if (msg.role === "assistant") {
+			const text = typeof msg.content === "string"
+				? msg.content
+				: msg.content.map((b: any) => b.type === "text" ? b.text : b.type === "tool_use" ? `[tool:${b.name}]` : `[${b.type}]`).join("\n");
+			out.push({ role: "assistant", content: text });
+		}
+	}
+	return out;
+}
+
+function writeCbJsonl(sessionId: string, cwd: string, messages: CbMessage[]): string {
+	const jsonlPath = getSessionPath(sessionId, cwd);
+	mkdirSync(join(jsonlPath, ".."), { recursive: true });
+	const lines: string[] = [];
+	let parentId: string | undefined;
+	const ts = Date.now();
+	for (const msg of messages) {
+		const id = randomUUID();
+		if (msg.role === "user") {
+			lines.push(JSON.stringify({
+				id, timestamp: ts, type: "message", role: "user",
+				content: [{ type: "input_text", text: msg.content }],
+				providerData: { agent: "sdk" }, sessionId, cwd,
+			}));
+			parentId = id;
+		} else {
+			lines.push(JSON.stringify({
+				id, parentId, timestamp: ts, type: "message", role: "assistant",
+				status: "completed",
+				content: [{ type: "output_text", text: msg.content }],
+				providerData: { agent: "sdk" }, sessionId, cwd,
+			}));
+			parentId = id;
+		}
+	}
+	writeFileSync(jsonlPath, lines.join("\n") + (lines.length ? "\n" : ""));
+	return jsonlPath;
+}
+
+export class Session {
+	readonly sessionId: string;
+	readonly projectPath: string;
+	readonly codebuddyDir?: string;
+	readonly jsonlPath: string;
+	messages: CbMessage[] = [];
+
+	constructor(sessionId: string, projectPath: string, codebuddyDir?: string) {
+		this.sessionId = sessionId;
+		this.projectPath = projectPath;
+		this.codebuddyDir = codebuddyDir;
+		this.jsonlPath = getSessionPath(sessionId, projectPath, codebuddyDir);
+	}
+
+	importPiMessages(messages: PiMessage[]): void {
+		this.messages = piToCbMessages(messages);
+	}
+
+	save(): void {
+		writeCbJsonl(this.sessionId, this.projectPath, this.messages);
+	}
+}
+
+export interface CreateSessionOptions {
+	projectPath: string;
+	sessionId?: string;
+	model?: string;
+	codebuddyDir?: string;
+}
+
+export function createSession(opts: CreateSessionOptions): Session {
+	const sessionId = opts.sessionId ?? randomUUID();
+	return new Session(sessionId, opts.projectPath, opts.codebuddyDir);
+}
+
+export function repairToolPairing(messages: Array<{ role: string; content: unknown }>): Array<{ role: string; content: unknown }> {
+	const result: Array<{ role: string; content: unknown }> = [];
+	let pending: Set<string> | null = null;
+	const synthetic = (id: string) => ({
+		type: "tool_result",
+		tool_use_id: id,
+		content: "[no tool result recorded]",
+		is_error: true,
+	});
+	const flushPending = () => {
+		if (pending && pending.size > 0) {
+			result.push({ role: "user", content: [...pending].map(synthetic) });
+		}
+		pending = null;
+	};
+	for (const msg of messages) {
+		if (msg.role === "assistant") {
+			flushPending();
+			const ids = new Set<string>();
+			if (Array.isArray(msg.content)) {
+				for (const b of msg.content as Array<{ type?: string; id?: string }>) {
+					if (b.type === "tool_use" && typeof b.id === "string") ids.add(b.id);
+				}
+			}
+			result.push(msg);
+			pending = ids.size > 0 ? ids : null;
+			continue;
+		}
+		const blocks = Array.isArray(msg.content) ? msg.content as Array<{ type?: string; tool_use_id?: string }> : null;
+		const hasToolResults = blocks?.some((b) => b.type === "tool_result") ?? false;
+		if (!pending && !hasToolResults) {
+			result.push(msg);
+			continue;
+		}
+		const input = blocks ?? (typeof msg.content === "string" && msg.content ? [{ type: "text", text: msg.content }] : []);
+		const provided = new Set<string>();
+		const kept = input.filter((b: { type?: string; tool_use_id?: string }) => {
+			if (b.type !== "tool_result") return true;
+			if (b.tool_use_id && pending?.has(b.tool_use_id)) {
+				provided.add(b.tool_use_id);
+				return true;
+			}
+			return false;
+		});
+		if (pending) {
+			const missing = [...pending].filter((id) => !provided.has(id)).map(synthetic);
+			kept.unshift(...missing);
+			pending = null;
+		}
+		if (kept.length === 0) {
+			if (result.length === 0) {
+				result.push({ role: "user", content: [{ type: "text", text: "[orphaned tool result removed]" }] });
+			}
+			continue;
+		}
+		result.push({ ...msg, content: kept });
+	}
+	flushPending();
+	return result;
+}
+
+export function readSession(sessionId: string, projectPath: string, codebuddyDir?: string): Session | null {
+	const jsonlPath = getSessionPath(sessionId, projectPath, codebuddyDir);
+	if (!existsSync(jsonlPath)) return null;
+	const session = new Session(sessionId, projectPath, codebuddyDir);
+	const lines = readFileSync(jsonlPath, "utf-8").split("\n").filter(Boolean);
+	for (const line of lines) {
+		try {
+			const rec = JSON.parse(line);
+			if (rec.type === "message" && rec.role === "user") {
+				const text = rec.content?.find((b: any) => b.type === "input_text")?.text ?? messageContentToText(rec.content);
+				session.messages.push({ role: "user", content: text });
+			} else if (rec.type === "message" && rec.role === "assistant") {
+				const text = rec.content?.find((b: any) => b.type === "output_text")?.text ?? messageContentToText(rec.content);
+				session.messages.push({ role: "assistant", content: text });
+			}
+		} catch { /* skip malformed */ }
+	}
+	return session;
+}

package/src/config.ts

@@ -0,0 +1,50 @@
+import type { SettingSource } from "./index-types.js";
+import { CONFIG_DIR_NAME } from "@earendil-works/pi-coding-agent";
+import { existsSync, readFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+
+function redactPath(path: string): string {
+	const home = homedir();
+	return home && path.startsWith(home) ? "~" + path.slice(home.length) : path;
+}
+
+export const CONFIG_BASENAME = "codebuddy-sdk.json";
+
+export interface Config {
+	askCodebuddy?: {
+		enabled?: boolean;
+		name?: string;
+		label?: string;
+		description?: string;
+		defaultMode?: "full" | "read" | "none";
+		defaultIsolated?: boolean;
+		allowFullMode?: boolean;
+		appendSkills?: boolean;
+	};
+	provider?: {
+		appendSystemPrompt?: boolean;
+		settingSources?: SettingSource[];
+		strictMcpConfig?: boolean;
+		pathToCodebuddyCode?: string;
+	};
+}
+
+export function tryParseJson(path: string): Partial<Config> {
+	if (!existsSync(path)) return {};
+	try {
+		return JSON.parse(readFileSync(path, "utf-8"));
+	} catch (e) {
+		console.error(`codebuddy-sdk: failed to parse ${redactPath(path)}: ${e}`);
+		return {};
+	}
+}
+
+export function loadConfig(cwd: string): Config {
+	const global = tryParseJson(join(homedir(), ".pi", "agent", CONFIG_BASENAME));
+	const project = tryParseJson(join(cwd, CONFIG_DIR_NAME, CONFIG_BASENAME));
+	return {
+		askCodebuddy: { ...global.askCodebuddy, ...project.askCodebuddy },
+		provider: { ...global.provider, ...project.provider },
+	};
+}