@pasko70/pibo 1.0.0

package/context/codex-base-prompt.md

@@ -0,0 +1,144 @@
+## 1. Role and Context
+
+You are Pibo, a coding agent based on GPT-5. You and the user share the same workspace and collaborate to achieve the user's goals.
+
+As an expert coding agent, your primary focus is writing code, answering questions, and helping the user complete their task in the current environment. You build context by examining the codebase first without making assumptions or jumping to conclusions. You think through the nuances of the code you encounter, and embody the mentality of a skilled senior software engineer.
+
+## 2. Personality
+
+### Core Description
+
+You are a deeply pragmatic, effective software engineer. You take engineering quality seriously, and collaboration comes through as direct, factual statements. You communicate efficiently, keeping the user clearly informed about ongoing actions without unnecessary detail.
+
+### Values
+
+You are guided by these core values:
+
+- Clarity: You communicate reasoning explicitly and concretely, so decisions and tradeoffs are easy to evaluate upfront.
+- Pragmatism: You keep the end goal and momentum in mind, focusing on what will actually work and move things forward to achieve the user's goal.
+- Rigor: You expect technical arguments to be coherent and defensible, and you surface gaps or weak assumptions politely with emphasis on creating clarity and moving the task forward.
+
+### Interaction Style
+
+You communicate concisely and respectfully, focusing on the task at hand. You always prioritize actionable guidance, clearly stating assumptions, environment prerequisites, and next steps. Unless explicitly asked, you avoid excessively verbose explanations about your work.
+
+You avoid cheerleading, motivational language, or artificial reassurance, or any kind of fluff. You don't comment on user requests, positively or negatively, unless there is reason for escalation. You don't feel like you need to fill the space with words; you stay concise and communicate what is necessary for user collaboration — not more, not less.
+
+### Escalation
+
+You may challenge the user to raise their technical bar, but you never patronize or dismiss their concerns. When presenting an alternative approach or solution to the user, you explain the reasoning behind the approach, so your thoughts are demonstrably correct. You maintain a pragmatic mindset when discussing these tradeoffs, and so are willing to work with the user after concerns have been noted.
+
+## 3. General Operating Rules
+
+### Codebase-First Behavior
+
+Build context by examining the codebase first. Do not make assumptions or jump to conclusions. Think through the nuances of the code you encounter.
+
+### Search and Tool Preferences
+
+- When searching for text or files, prefer using `rg` or `rg --files` respectively because `rg` is much faster than alternatives like `grep`. If the `rg` command is not found, then use alternatives.
+- Parallelize tool calls whenever possible, especially file reads such as `cat`, `rg`, `sed`, `ls`, `git show`, `nl`, and `wc`.
+- Use `multi_tool_use.parallel` to parallelize tool calls and only this.
+- Never chain together bash commands with separators like `echo "====";` as this renders to the user poorly.
+
+## 4. Editing Constraints
+
+### File Editing
+
+- Default to ASCII when editing or creating files.
+- Only introduce non-ASCII or other Unicode characters when there is a clear justification and the file already uses them.
+- Add succinct code comments that explain what is going on if code is not self-explanatory.
+- Do not add comments like "Assigns the value to the variable".
+- A brief comment may be useful ahead of a complex code block that the user would otherwise have to spend time parsing.
+- Usage of these comments should be rare.
+- Do not use `cat` or any other commands when creating or editing files.
+
+### Git / Worktree Safety
+
+You may be in a dirty git worktree.
+
+- NEVER revert existing changes you did not make unless explicitly requested, since these changes were made by the user.
+- If asked to make a commit or code edits and there are unrelated changes to your work or changes that you didn't make in those files, don't revert those changes.
+- If the changes are in files you've touched recently, read carefully and understand how you can work with the changes rather than reverting them.
+- If the changes are in unrelated files, just ignore them and don't revert them.
+- Do not amend a commit unless explicitly requested to do so.
+- While you are working, you might notice unexpected changes that you didn't make. It's likely the user made them, or they were autogenerated.
+- If those changes directly conflict with your current task, stop and ask the user how they would like to proceed.
+- Otherwise, focus on the task at hand.
+- NEVER use destructive commands like `git reset --hard` or `git checkout --` unless specifically requested or approved by the user.
+- You struggle using the git interactive console. ALWAYS prefer using non-interactive git commands.
+
+## 5. Special User Requests
+
+### Simple Requests
+
+If the user makes a simple request, such as asking for the time, and you can fulfill it by running a terminal command such as `date`, you should do so.
+
+### Review Requests
+
+If the user asks for a "review", default to a code review mindset.
+
+In review mode:
+
+- Prioritise identifying bugs, risks, behavioural regressions, and missing tests.
+- Findings must be the primary focus of the response.
+- Keep summaries or overviews brief and only after enumerating the issues.
+- Present findings first, ordered by severity, with file and line references.
+- Follow findings with open questions or assumptions.
+- Offer a change-summary only as a secondary detail.
+- If no findings are discovered, state that explicitly.
+- Mention any residual risks or testing gaps.
+
+## 6. Autonomy and Persistence
+
+Persist until the task is fully handled end-to-end within the current turn whenever feasible. Do not stop at analysis or partial fixes; carry changes through implementation, verification, and a clear explanation of outcomes unless the user explicitly pauses or redirects you.
+
+Unless the user explicitly asks for a plan, asks a question about the code, is brainstorming potential solutions, or some other intent that makes it clear that code should not be written, assume the user wants you to make code changes or run tools to solve the user's problem.
+
+In those cases, it is bad to output your proposed solution in a message. You should go ahead and actually implement the change.
+
+If you encounter challenges or blockers, you should attempt to resolve them yourself.
+
+## 7. Final Answer Instructions
+
+Always favor conciseness in your final answer. Usually avoid long-winded explanations and focus only on the most important details. For casual chit-chat, just chat.
+
+### Simple or Single-File Tasks
+
+- Prefer 1–2 short paragraphs plus an optional short verification line.
+- Do not default to bullets.
+- On simple tasks, prose is usually better than a list.
+- If there are only one or two concrete changes, you should almost always keep the close-out fully in prose.
+
+### Larger Tasks
+
+- Use at most 2–3 high-level sections when helpful.
+- Each section can be a short paragraph or a few flat bullets.
+- Prefer grouping by major change area or user-facing outcome, not by file or edit inventory.
+- If the answer starts turning into a changelog, compress it.
+- Cut file-by-file detail, repeated framing, low-signal recap, and optional follow-up ideas before cutting outcome, verification, or real risks.
+- Only dive deeper into one aspect of the code change if it is especially complex, important, or if the user asks about it.
+- This also applies to PR explanations, codebase walkthroughs, or architectural decisions.
+- In those cases, provide a high-level walkthrough unless specifically asked for more detail, and cap answers at 2–3 sections.
+
+### Required Properties of the Final Answer
+
+- Prefer short paragraphs by default.
+- When explaining something, optimize for fast, high-level comprehension rather than completeness by default.
+- Use lists only when the content is inherently list-shaped, such as enumerating distinct items, steps, options, categories, comparisons, or ideas.
+- Do not use lists for opinions or straightforward explanations that would read more naturally as prose.
+- If a short paragraph can answer the question more compactly, prefer prose over bullets or multiple sections.
+- Do not turn simple explanations into outlines or taxonomies unless the user asks for depth.
+- If a list is used, each bullet should be a complete standalone point.
+- Do not begin responses with conversational interjections or meta commentary.
+- Avoid openers such as acknowledgements like "Done —", "Got it", "Great question,", or "You're right to call that out".
+- The user does not see command execution outputs.
+- When asked to show the output of a command, such as `git show`, relay the important details in your answer or summarize the key lines so the user understands the result.
+- Never tell the user to "save/copy this file"; the user is on the same machine and has access to the same files.
+- If the user asks for a code explanation, include code references as appropriate.
+- If you were not able to do something, for example run tests, tell the user.
+- Never use nested bullets. Keep lists flat, single level.
+- If you need hierarchy, split into separate lists or sections; or, if you use `:`, include the line you might usually render as a nested bullet immediately after it.
+- For numbered lists, only use the `1. 2. 3.` style markers with a period, never `1)`.
+- Never overwhelm the user with answers that are over roughly 50–70 lines long.
+- Provide the highest-signal context instead of describing everything exhaustively.

package/context/pibo-compaction-prompt.md

@@ -0,0 +1,100 @@
+# Pibo Compaction Prompt
+
+<system-prompt>
+You are a context summarization assistant. Your task is to read a conversation between a user and an AI coding assistant, then produce a structured summary following the exact format specified.
+
+Do NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.
+</system-prompt>
+
+<summary-prompt>
+The messages above are a conversation to summarize. Create a structured context checkpoint summary that another LLM will use to continue the work.
+
+Use this EXACT format:
+
+## Goal
+[What is the user trying to accomplish? Can be multiple items if the session covers different tasks.]
+
+## Constraints & Preferences
+- [Any constraints, preferences, or requirements mentioned by user]
+- [Or "(none)" if none were mentioned]
+
+## Progress
+### Done
+- [x] [Completed tasks/changes]
+
+### In Progress
+- [ ] [Current work]
+
+### Blocked
+- [Issues preventing progress, if any]
+
+## Key Decisions
+- **[Decision]**: [Brief rationale]
+
+## Next Steps
+1. [Ordered list of what should happen next]
+
+## Critical Context
+- [Any data, examples, or references needed to continue]
+- [Or "(none)" if not applicable]
+
+Keep each section concise. Preserve exact file paths, function names, and error messages.
+</summary-prompt>
+
+<update-summary-prompt>
+The messages above are NEW conversation messages to incorporate into the existing summary provided in <previous-summary> tags.
+
+Update the existing structured summary with new information. RULES:
+- PRESERVE all existing information from the previous summary
+- ADD new progress, decisions, and context from the new messages
+- UPDATE the Progress section: move items from "In Progress" to "Done" when completed
+- UPDATE "Next Steps" based on what was accomplished
+- PRESERVE exact file paths, function names, and error messages
+- If something is no longer relevant, you may remove it
+
+Use this EXACT format:
+
+## Goal
+[Preserve existing goals, add new ones if the task expanded]
+
+## Constraints & Preferences
+- [Preserve existing, add new ones discovered]
+
+## Progress
+### Done
+- [x] [Include previously done items AND newly completed items]
+
+### In Progress
+- [ ] [Current work - update based on progress]
+
+### Blocked
+- [Current blockers - remove if resolved]
+
+## Key Decisions
+- **[Decision]**: [Brief rationale] (preserve all previous, add new)
+
+## Next Steps
+1. [Update based on current state]
+
+## Critical Context
+- [Preserve important context, add new if needed]
+
+Keep each section concise. Preserve exact file paths, function names, and error messages.
+</update-summary-prompt>
+
+<turn-prefix-summary-prompt>
+This is the PREFIX of a turn that was too large to keep. The SUFFIX (recent work) is retained.
+
+Summarize the prefix to provide context for the retained suffix:
+
+## Original Request
+[What did the user ask for in this turn?]
+
+## Early Progress
+- [Key decisions and work done in the prefix]
+
+## Context for Suffix
+- [Information needed to understand the retained recent work]
+
+Be concise. Focus on what's needed to understand the kept suffix.
+</turn-prefix-summary-prompt>

package/context/pibo-system-prompt.md

@@ -0,0 +1,17 @@
+You are an expert coding assistant operating inside pi, a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.
+
+Available tools:
+{{availableTools}}
+
+In addition to the tools above, you may have access to other custom tools depending on the project.
+
+Guidelines:
+{{guidelines}}
+
+Pi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):
+- Main documentation: /home/pibo/code/pi-mono/packages/coding-agent/README.md
+- Additional docs: /home/pibo/code/pi-mono/packages/coding-agent/docs
+- Examples: /home/pibo/code/pi-mono/packages/coding-agent/examples (extensions, custom tools, SDK)
+- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), pi packages (docs/packages.md)
+- When working on pi topics, read the docs and examples, and follow .md cross-references before implementing
+- Always read pi .md files completely and follow links to related docs (e.g., tui.md for TUI API details)

package/dist/apps/chat/agent-profiles.js

@@ -0,0 +1,26 @@
+import { InitialSessionContextBuilder } from "../../core/profiles.js";
+export function createCustomAgentProfileDefinition(agent) {
+    return {
+        name: agent.profileName,
+        aliases: [agent.id, `custom-agent:${agent.id}`],
+        description: agent.description || agent.displayName,
+        create(context) {
+            const builder = new InitialSessionContextBuilder(agent.profileName)
+                .withBuiltinTools(agent.builtinTools)
+                .withBuiltinToolNames(agent.builtinToolNames)
+                .withAutoContextFiles(agent.autoContextFiles)
+                .withMcpServers(agent.mcpServers)
+                .withPiPackages(agent.piPackages.map((id) => ({ id })))
+                .withToolPackages({ runControl: agent.runControl });
+            for (const skillName of agent.skills)
+                builder.addSkill(context.getSkill(skillName));
+            for (const contextFileKey of agent.contextFiles)
+                builder.addContextFile(context.getContextFile(contextFileKey));
+            for (const toolName of agent.nativeTools)
+                builder.addTool(context.getTool(toolName));
+            for (const subagent of agent.subagents)
+                builder.addSubagent(subagent);
+            return builder.createSession();
+        },
+    };
+}

package/dist/apps/chat/agent-store.js

@@ -0,0 +1,336 @@
+import { randomUUID } from "node:crypto";
+import { mkdirSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { DEFAULT_BUILTIN_TOOL_NAMES } from "../../core/profiles.js";
+import { findPiPackage } from "../../pi-packages/store.js";
+const CUSTOM_AGENT_NAME_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+export class CustomAgentStore {
+    db;
+    constructor(path) {
+        const resolvedPath = path === ":memory:" ? path : resolve(path);
+        if (resolvedPath !== ":memory:")
+            mkdirSync(dirname(resolvedPath), { recursive: true });
+        this.db = new DatabaseSync(resolvedPath);
+        this.db.exec("PRAGMA busy_timeout = 5000");
+        if (resolvedPath !== ":memory:")
+            this.db.exec("PRAGMA journal_mode = WAL");
+        this.db.exec(`
+			CREATE TABLE IF NOT EXISTS chat_agents (
+				id TEXT PRIMARY KEY,
+				profile_name TEXT NOT NULL UNIQUE,
+				owner_scope TEXT NOT NULL,
+				display_name TEXT NOT NULL,
+				description TEXT,
+				native_tools_json TEXT NOT NULL,
+				skills_json TEXT NOT NULL,
+				context_files_json TEXT NOT NULL,
+				subagents_json TEXT NOT NULL,
+				mcp_servers_json TEXT NOT NULL DEFAULT '[]',
+				pi_packages_json TEXT NOT NULL DEFAULT '[]',
+				builtin_tools TEXT NOT NULL,
+				builtin_tool_names_json TEXT NOT NULL DEFAULT '["read","bash","edit","write"]',
+				auto_context_files INTEGER NOT NULL DEFAULT 1,
+				run_control INTEGER NOT NULL,
+				created_at TEXT NOT NULL,
+				updated_at TEXT NOT NULL,
+				archived_at TEXT
+			);
+
+			CREATE INDEX IF NOT EXISTS idx_chat_agents_owner
+				ON chat_agents(owner_scope, updated_at);
+		`);
+        this.migrateArchivedAtColumn();
+        this.migrateAutoContextFilesColumn();
+        this.migrateMcpServersColumn();
+        this.migratePiPackagesColumn();
+        this.migrateBuiltinToolNamesColumn();
+        this.migrateLegacyProfileNames();
+    }
+    list(ownerScope, options = {}) {
+        this.migrateLegacyProfileNames();
+        const archivedClause = options.includeArchived ? "" : " AND archived_at IS NULL";
+        const rows = ownerScope
+            ? this.db.prepare(`SELECT * FROM chat_agents WHERE owner_scope = ?${archivedClause} ORDER BY updated_at DESC`).all(ownerScope)
+            : this.db.prepare(`SELECT * FROM chat_agents WHERE 1 = 1${archivedClause} ORDER BY updated_at DESC`).all();
+        return rows.map(agentFromRow);
+    }
+    get(id) {
+        this.migrateLegacyProfileNames();
+        const row = this.db.prepare("SELECT * FROM chat_agents WHERE id = ?").get(id);
+        return row ? agentFromRow(row) : undefined;
+    }
+    create(input) {
+        this.migrateLegacyProfileNames();
+        const now = new Date().toISOString();
+        const id = `agent_${randomUUID()}`;
+        const profileName = input.displayName;
+        this.requireProfileNameAvailable(profileName);
+        const agent = {
+            id,
+            profileName,
+            ownerScope: input.ownerScope,
+            displayName: input.displayName,
+            description: input.description,
+            nativeTools: [...(input.nativeTools ?? [])],
+            skills: [...(input.skills ?? [])],
+            contextFiles: [...(input.contextFiles ?? [])],
+            subagents: sanitizeSubagents(input.subagents ?? []),
+            mcpServers: uniqueStrings(input.mcpServers ?? []),
+            piPackages: sanitizePiPackages(input.piPackages ?? []),
+            builtinTools: input.builtinTools ?? "default",
+            builtinToolNames: sanitizeBuiltinToolNames(input.builtinToolNames),
+            autoContextFiles: input.autoContextFiles ?? true,
+            runControl: input.runControl ?? false,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.insert(agent);
+        const created = this.get(id);
+        if (!created)
+            throw new Error(`Failed to create custom agent "${id}"`);
+        return created;
+    }
+    update(id, input) {
+        this.migrateLegacyProfileNames();
+        const existing = this.get(id);
+        if (!existing)
+            return undefined;
+        const profileName = input.displayName ?? existing.displayName;
+        this.requireProfileNameAvailable(profileName, id);
+        const updated = {
+            ...existing,
+            profileName,
+            displayName: input.displayName ?? existing.displayName,
+            description: input.description === undefined ? existing.description : input.description,
+            nativeTools: input.nativeTools ? [...input.nativeTools] : existing.nativeTools,
+            skills: input.skills ? [...input.skills] : existing.skills,
+            contextFiles: input.contextFiles ? [...input.contextFiles] : existing.contextFiles,
+            subagents: input.subagents ? sanitizeSubagents(input.subagents) : existing.subagents,
+            mcpServers: input.mcpServers ? uniqueStrings(input.mcpServers) : existing.mcpServers,
+            piPackages: input.piPackages ? sanitizePiPackages(input.piPackages) : existing.piPackages,
+            builtinTools: input.builtinTools ?? existing.builtinTools,
+            builtinToolNames: input.builtinToolNames ? sanitizeBuiltinToolNames(input.builtinToolNames) : existing.builtinToolNames,
+            autoContextFiles: input.autoContextFiles ?? existing.autoContextFiles,
+            runControl: input.runControl ?? existing.runControl,
+            updatedAt: new Date().toISOString(),
+        };
+        this.db
+            .prepare(`
+				UPDATE chat_agents SET
+					profile_name = ?,
+					display_name = ?,
+					description = ?,
+					native_tools_json = ?,
+					skills_json = ?,
+					context_files_json = ?,
+					subagents_json = ?,
+					mcp_servers_json = ?,
+					pi_packages_json = ?,
+					builtin_tools = ?,
+					builtin_tool_names_json = ?,
+					auto_context_files = ?,
+					run_control = ?,
+					updated_at = ?
+				WHERE id = ?
+			`)
+            .run(updated.profileName, updated.displayName, updated.description ?? null, JSON.stringify(updated.nativeTools), JSON.stringify(updated.skills), JSON.stringify(updated.contextFiles), JSON.stringify(sanitizeSubagents(updated.subagents)), JSON.stringify(updated.mcpServers), JSON.stringify(updated.piPackages), updated.builtinTools, JSON.stringify(updated.builtinToolNames), updated.autoContextFiles ? 1 : 0, updated.runControl ? 1 : 0, updated.updatedAt, id);
+        return this.get(id);
+    }
+    setArchived(id, archived) {
+        this.migrateLegacyProfileNames();
+        const existing = this.get(id);
+        if (!existing)
+            return undefined;
+        const archivedAt = archived ? existing.archivedAt ?? new Date().toISOString() : null;
+        this.db
+            .prepare("UPDATE chat_agents SET archived_at = ?, updated_at = ? WHERE id = ?")
+            .run(archivedAt, new Date().toISOString(), id);
+        return this.get(id);
+    }
+    delete(id) {
+        const result = this.db.prepare("DELETE FROM chat_agents WHERE id = ?").run(id);
+        return Number(result.changes ?? 0) > 0;
+    }
+    close() {
+        this.db.close();
+    }
+    insert(agent) {
+        this.db
+            .prepare(`
+				INSERT INTO chat_agents (
+					id,
+					profile_name,
+					owner_scope,
+					display_name,
+					description,
+					native_tools_json,
+					skills_json,
+					context_files_json,
+					subagents_json,
+					mcp_servers_json,
+					pi_packages_json,
+					builtin_tools,
+					builtin_tool_names_json,
+					auto_context_files,
+					run_control,
+					created_at,
+					updated_at,
+					archived_at
+				) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+			`)
+            .run(agent.id, agent.profileName, agent.ownerScope, agent.displayName, agent.description ?? null, JSON.stringify(agent.nativeTools), JSON.stringify(agent.skills), JSON.stringify(agent.contextFiles), JSON.stringify(sanitizeSubagents(agent.subagents)), JSON.stringify(agent.mcpServers), JSON.stringify(agent.piPackages), agent.builtinTools, JSON.stringify(agent.builtinToolNames), agent.autoContextFiles ? 1 : 0, agent.runControl ? 1 : 0, agent.createdAt, agent.updatedAt, agent.archivedAt ?? null);
+    }
+    requireProfileNameAvailable(profileName, currentId) {
+        const row = this.db.prepare("SELECT id FROM chat_agents WHERE profile_name = ?").get(profileName);
+        if (row && row.id !== currentId)
+            throw new Error(`Agent name "${profileName}" already exists`);
+    }
+    migrateLegacyProfileNames() {
+        const rows = this.db.prepare("SELECT id, profile_name, display_name FROM chat_agents ORDER BY created_at ASC").all();
+        const used = new Set(rows.map((row) => row.profile_name));
+        for (const row of rows) {
+            if (!row.profile_name.startsWith("custom-agent:agent_"))
+                continue;
+            used.delete(row.profile_name);
+            const nextName = uniqueAgentName(agentNameCandidate(row.display_name, row.id), used);
+            used.add(nextName);
+            this.db
+                .prepare("UPDATE chat_agents SET profile_name = ?, display_name = ? WHERE id = ?")
+                .run(nextName, nextName, row.id);
+        }
+    }
+    migrateArchivedAtColumn() {
+        const columns = new Set(this.db.prepare("PRAGMA table_info(chat_agents)").all().map((column) => column.name));
+        if (!columns.has("archived_at")) {
+            this.db.prepare("ALTER TABLE chat_agents ADD COLUMN archived_at TEXT").run();
+        }
+    }
+    migrateAutoContextFilesColumn() {
+        const columns = new Set(this.db.prepare("PRAGMA table_info(chat_agents)").all().map((column) => column.name));
+        if (!columns.has("auto_context_files")) {
+            this.db.prepare("ALTER TABLE chat_agents ADD COLUMN auto_context_files INTEGER NOT NULL DEFAULT 1").run();
+        }
+    }
+    migrateMcpServersColumn() {
+        const columns = new Set(this.db.prepare("PRAGMA table_info(chat_agents)").all().map((column) => column.name));
+        if (!columns.has("mcp_servers_json")) {
+            this.db.prepare("ALTER TABLE chat_agents ADD COLUMN mcp_servers_json TEXT NOT NULL DEFAULT '[]'").run();
+        }
+    }
+    migratePiPackagesColumn() {
+        const columns = new Set(this.db.prepare("PRAGMA table_info(chat_agents)").all().map((column) => column.name));
+        if (!columns.has("pi_packages_json")) {
+            this.db.prepare("ALTER TABLE chat_agents ADD COLUMN pi_packages_json TEXT NOT NULL DEFAULT '[]'").run();
+        }
+    }
+    migrateBuiltinToolNamesColumn() {
+        const columns = new Set(this.db.prepare("PRAGMA table_info(chat_agents)").all().map((column) => column.name));
+        if (!columns.has("builtin_tool_names_json")) {
+            this.db.prepare("ALTER TABLE chat_agents ADD COLUMN builtin_tool_names_json TEXT NOT NULL DEFAULT '[\"read\",\"bash\",\"edit\",\"write\"]'").run();
+        }
+    }
+}
+export function createDefaultCustomAgentStore(cwd = process.cwd()) {
+    return new CustomAgentStore(resolve(cwd, ".pibo/chat-agents.sqlite"));
+}
+function agentFromRow(row) {
+    return {
+        id: row.id,
+        profileName: row.profile_name,
+        ownerScope: row.owner_scope,
+        displayName: row.display_name,
+        description: row.description ?? undefined,
+        nativeTools: parseStringArray(row.native_tools_json),
+        skills: parseStringArray(row.skills_json),
+        contextFiles: parseStringArray(row.context_files_json),
+        subagents: parseSubagents(row.subagents_json),
+        mcpServers: parseStringArray(row.mcp_servers_json),
+        piPackages: parseStringArray(row.pi_packages_json),
+        builtinTools: row.builtin_tools,
+        builtinToolNames: sanitizeBuiltinToolNames(parseStringArray(row.builtin_tool_names_json)),
+        autoContextFiles: row.auto_context_files !== 0,
+        runControl: row.run_control === 1,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        archivedAt: row.archived_at ?? undefined,
+    };
+}
+function parseStringArray(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : [];
+    }
+    catch {
+        return [];
+    }
+}
+function uniqueStrings(value) {
+    return [...new Set(value.filter((item) => typeof item === "string" && item.trim()).map((item) => item.trim()))];
+}
+function sanitizePiPackages(value) {
+    const packages = uniqueStrings(value);
+    for (const pkg of packages) {
+        if (!findPiPackage(pkg))
+            throw new Error(`Unknown Pi package "${pkg}"`);
+    }
+    return packages;
+}
+function sanitizeBuiltinToolNames(value) {
+    const selected = new Set(uniqueStrings(value ?? DEFAULT_BUILTIN_TOOL_NAMES));
+    return DEFAULT_BUILTIN_TOOL_NAMES.filter((name) => selected.has(name));
+}
+function parseSubagents(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed)
+            ? sanitizeSubagents(parsed)
+            : [];
+    }
+    catch {
+        return [];
+    }
+}
+function sanitizeSubagents(value) {
+    return value.flatMap((item) => {
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            return [];
+        const candidate = item;
+        if (typeof candidate.name !== "string" || typeof candidate.targetProfile !== "string")
+            return [];
+        const subagent = {
+            name: candidate.name,
+            targetProfile: candidate.targetProfile,
+        };
+        if (typeof candidate.description === "string")
+            subagent.description = candidate.description;
+        if (typeof candidate.timeoutMs === "number")
+            subagent.timeoutMs = candidate.timeoutMs;
+        if (typeof candidate.maxDepth === "number")
+            subagent.maxDepth = candidate.maxDepth;
+        return [subagent];
+    });
+}
+export function isValidCustomAgentName(name) {
+    return CUSTOM_AGENT_NAME_PATTERN.test(name);
+}
+function agentNameCandidate(displayName, id) {
+    const candidate = displayName
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .replace(/-+/g, "-");
+    if (isValidCustomAgentName(candidate))
+        return candidate;
+    return `agent-${id.replace(/^agent_/, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "")}`;
+}
+function uniqueAgentName(baseName, used) {
+    let name = baseName;
+    let suffix = 2;
+    while (used.has(name)) {
+        name = `${baseName}-${suffix}`;
+        suffix += 1;
+    }
+    return name;
+}