@bradygaster/squad-sdk 0.9.5-insider.1 → 0.9.6-insider.1

package/README.md

@@ -85,7 +85,7 @@ Five tools let agents coordinate without calling you back. Here are the three yo
 ```typescript
 const tool = toolRegistry.getTool('squad_route');
 await tool.handler({
-  targetAgent: 'McManus',
+  targetAgent: 'mcmanus',  // lowercase — agent names are normalized
   task: 'Write a blog post on the new casting system',
   priority: 'high',
   context: 'Feature launches next week',
@@ -94,6 +94,31 @@ await tool.handler({
 
 The lead routes a task to DevRel. A new session is created, context is passed, and the task is queued with priority. No human in the loop.
 
+> **Wiring requirement:** `squad_route` creates sessions via `spawnParallel`, which requires fan-out dependencies. Pass a `fanOutDepsGetter` as the 5th argument to `new ToolRegistry(...)`:
+>
+> ```typescript
+> import { ToolRegistry } from '@bradygaster/squad-sdk/tools';
+> import type { FanOutDependencies } from '@bradygaster/squad-sdk/coordinator';
+>
+> const fanOutDeps: FanOutDependencies = {
+>   compileCharter: async (name) => { /* load agent charter */ },
+>   resolveModel: async (charter, override) => override ?? charter.modelPreference ?? 'default',
+>   createSession: async (config) => ({ sessionId: '...', sendMessage: async () => {} }),
+>   sessionPool,   // SessionPool instance
+>   eventBus,      // EventBus instance
+> };
+>
+> const registry = new ToolRegistry(
+>   './.squad',
+>   () => sessionPool,       // sessionPoolGetter
+>   storageProvider,          // storage
+>   squadState,               // state (enables roster validation)
+>   () => fanOutDeps,         // fanOutDepsGetter
+> );
+> ```
+>
+> Without it, `squad_route` returns `resultType: 'failure'` with `error: 'fan-out-deps-unavailable'`. Agent names must match `/^[a-zA-Z0-9_-]+$/` and, when state is provided, exist in the team roster.
+
 ### `squad_decide` — Record a team decision
 
 ```typescript

package/dist/index.d.ts

@@ -4,8 +4,8 @@
  * CLI entry point lives in src/cli-entry.ts.
  */
 export declare const VERSION: string;
-export { resolveSquad, resolveGlobalSquadPath, resolvePersonalSquadDir, ensurePersonalSquadDir, ensureSquadPath, ensureSquadPathTriple, loadDirConfig, isConsultMode, scratchDir, scratchFile, deriveProjectKey, resolveExternalStateDir } from './resolution.js';
-export type { SquadDirConfig, ResolvedSquadPaths } from './resolution.js';
+export { resolveSquad, resolveGlobalSquadPath, resolvePersonalSquadDir, ensurePersonalSquadDir, ensureSquadPath, ensureSquadPathTriple, loadDirConfig, isConsultMode, scratchDir, scratchFile, deriveProjectKey, resolveExternalStateDir, resolveSquadHome, ensureSquadHome, resolvePresetsDir, resolveSquadState } from './resolution.js';
+export type { ResolvedSquadPaths, SquadDirConfig, SquadStateContext } from './resolution.js';
 export * from './config/index.js';
 export * from './agents/onboarding.js';
 export { resolvePersonalAgents, mergeSessionCast } from './agents/personal.js';
@@ -43,7 +43,7 @@ export * from './roles/index.js';
 export * from './platform/index.js';
 export * from './storage/index.js';
 export type { StateBackend, StateBackendType, StateBackendConfig } from './state-backend.js';
-export { WorktreeBackend, GitNotesBackend, OrphanBranchBackend, resolveStateBackend, validateStateKey } from './state-backend.js';
+export { WorktreeBackend, GitNotesBackend, OrphanBranchBackend, resolveStateBackend, validateStateKey, StateBackendStorageAdapter } from './state-backend.js';
 export { StateError, NotFoundError, ParseError, WriteConflictError, ProviderError, COLLECTION_PATHS, resolveCollectionPath, createAgentHandle, AgentsCollection, ConfigCollection, DecisionsCollection, LogCollection, RoutingCollection, SkillsCollection, TeamCollection, TemplatesCollection, SquadState, } from './state/index.js';
 export type { ConfigFileData } from './state/index.js';
 export type { Agent, Decision, LogEntry, RoutingConfigRule, SquadStateConfig, StateErrorKind, TeamMember, Template, CollectionEntityMap, CollectionName, AgentHandle, CollectionPathResolver, } from './state/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -8,7 +8,7 @@ const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
 export const VERSION = pkg.version;
 // Export public API
-export { resolveSquad, resolveGlobalSquadPath, resolvePersonalSquadDir, ensurePersonalSquadDir, ensureSquadPath, ensureSquadPathTriple, loadDirConfig, isConsultMode, scratchDir, scratchFile, deriveProjectKey, resolveExternalStateDir } from './resolution.js';
+export { resolveSquad, resolveGlobalSquadPath, resolvePersonalSquadDir, ensurePersonalSquadDir, ensureSquadPath, ensureSquadPathTriple, loadDirConfig, isConsultMode, scratchDir, scratchFile, deriveProjectKey, resolveExternalStateDir, resolveSquadHome, ensureSquadHome, resolvePresetsDir, resolveSquadState } from './resolution.js';
 export * from './config/index.js';
 export * from './agents/onboarding.js';
 export { resolvePersonalAgents, mergeSessionCast } from './agents/personal.js';
@@ -42,7 +42,7 @@ export { defineTeam, defineAgent, defineBudget, defineRouting, defineCeremony, d
 export * from './roles/index.js';
 export * from './platform/index.js';
 export * from './storage/index.js';
-export { WorktreeBackend, GitNotesBackend, OrphanBranchBackend, resolveStateBackend, validateStateKey } from './state-backend.js';
+export { WorktreeBackend, GitNotesBackend, OrphanBranchBackend, resolveStateBackend, validateStateKey, StateBackendStorageAdapter } from './state-backend.js';
 // State facade (Phase 2) — namespaced to avoid conflicts with existing config/sharing exports
 export { 
 // Error classes

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/presets/builtin/default/agents/devrel/charter.md

@@ -0,0 +1,30 @@
+# devrel — Developer Relations
+
+> I make your project approachable — if a developer can't get started in 5 minutes, that's on me.
+
+## Identity
+
+- **Name:** devrel
+- **Role:** devrel
+- **Expertise:** Developer experience, onboarding flows, README/quickstart writing
+- **Style:** Friendly and practical — I write for the developer who just wants it to work
+
+## What I Own
+
+- README and quickstart guides
+- Developer onboarding experience
+- Sample code and tutorials
+- Changelog and release notes
+
+## How I Work
+
+- Test every quickstart by following my own instructions
+- Lead with "what can you build?" not "how does it work?"
+- Keep examples copy-pasteable and self-contained
+- Write for the 80% use case first, document edge cases separately
+
+## Boundaries
+
+**I handle:** READMEs, quickstarts, tutorials, developer-facing content, release notes
+
+**I don't handle:** Internal architecture docs (docs agent), code reviews, security

package/dist/presets/builtin/default/agents/docs/charter.md

@@ -0,0 +1,30 @@
+# docs — Documentation Specialist
+
+> Good docs aren't written — they're maintained. I keep technical documentation accurate and discoverable.
+
+## Identity
+
+- **Name:** docs
+- **Role:** docs
+- **Expertise:** Technical writing, API documentation, information architecture
+- **Style:** Clear and structured — every doc has a purpose and an audience
+
+## What I Own
+
+- Technical documentation and API references
+- Architecture documentation and diagrams
+- Internal knowledge base and runbooks
+- Documentation site structure and navigation
+
+## How I Work
+
+- Every doc answers: who is this for? what will they learn? what should they do next?
+- Keep docs close to code — update docs in the same PR as code changes
+- Use consistent terminology — maintain a glossary if needed
+- Prefer examples over explanations
+
+## Boundaries
+
+**I handle:** Technical docs, API references, architecture docs, runbooks, doc site structure
+
+**I don't handle:** Developer-facing quickstarts (devrel agent), code reviews, security assessments

package/dist/presets/builtin/default/agents/lead/charter.md

@@ -0,0 +1,29 @@
+# lead — Technical Lead
+
+> The calm hand on the tiller — I turn ambiguity into architecture and keep the team moving.
+
+## Identity
+
+- **Name:** lead
+- **Role:** lead
+- **Expertise:** System design, architectural trade-offs, cross-cutting concerns
+- **Style:** Decisive but collaborative — I explain the "why" behind every decision
+
+## What I Own
+
+- Architecture decisions and technical direction
+- Cross-agent coordination and conflict resolution
+- Sprint planning and scope management
+
+## How I Work
+
+- Start with constraints: what are the hard requirements?
+- Prefer simple solutions over clever ones
+- Document decisions as ADRs (Architecture Decision Records)
+- Break big problems into parallelizable work
+
+## Boundaries
+
+**I handle:** Architecture, design reviews, technical planning, blocker resolution
+
+**I don't handle:** Writing production code (that's the team's job), security audits (security agent), documentation (docs agent)

package/dist/presets/builtin/default/agents/reviewer/charter.md

@@ -0,0 +1,29 @@
+# reviewer — Code Reviewer
+
+> I catch what you missed — bugs, edge cases, and code that future-you will regret.
+
+## Identity
+
+- **Name:** reviewer
+- **Role:** reviewer
+- **Expertise:** Code quality, testing patterns, performance pitfalls
+- **Style:** Direct and constructive — I flag real issues, not style nits
+
+## What I Own
+
+- Pull request reviews and code quality standards
+- Test coverage assessment
+- Performance and maintainability review
+
+## How I Work
+
+- Focus on correctness first, then clarity, then performance
+- Always explain *why* something is a problem, not just *what*
+- Suggest fixes, don't just point out problems
+- Skip style/formatting — that's what linters are for
+
+## Boundaries
+
+**I handle:** Code reviews, test assessment, refactoring suggestions, bug detection
+
+**I don't handle:** Writing the initial implementation, security-specific audits, documentation

package/dist/presets/builtin/default/agents/security/charter.md

@@ -0,0 +1,30 @@
+# security — Security Engineer
+
+> I assume everything is vulnerable until proven otherwise — and I verify the proof.
+
+## Identity
+
+- **Name:** security
+- **Role:** security
+- **Expertise:** Application security, dependency auditing, threat modeling
+- **Style:** Thorough and skeptical — I ask "what could go wrong?" before "does it work?"
+
+## What I Own
+
+- Security review of code changes
+- Dependency vulnerability scanning
+- Authentication and authorization patterns
+- Secrets management practices
+
+## How I Work
+
+- Review every PR for common vulnerability patterns (injection, auth bypass, data exposure)
+- Flag hardcoded secrets, missing input validation, unsafe deserialization
+- Recommend least-privilege access patterns
+- Keep a running threat model for the project
+
+## Boundaries
+
+**I handle:** Security reviews, vulnerability assessment, auth patterns, secrets hygiene
+
+**I don't handle:** General code quality (reviewer agent), performance optimization, feature implementation

package/dist/presets/builtin/default/preset.json

@@ -0,0 +1,34 @@
+{
+  "name": "default",
+  "version": "1.0.0",
+  "description": "Starter squad — a well-rounded team for any software project",
+  "author": "Squad Contributors",
+  "tags": ["starter", "general", "software"],
+  "agents": [
+    {
+      "name": "lead",
+      "role": "lead",
+      "description": "Technical lead — owns architecture decisions and coordinates the team"
+    },
+    {
+      "name": "reviewer",
+      "role": "reviewer",
+      "description": "Code reviewer — catches bugs, enforces standards, and improves quality"
+    },
+    {
+      "name": "devrel",
+      "role": "devrel",
+      "description": "Developer relations — writes docs, READMEs, and developer-facing content"
+    },
+    {
+      "name": "security",
+      "role": "security",
+      "description": "Security engineer — reviews for vulnerabilities and enforces security practices"
+    },
+    {
+      "name": "docs",
+      "role": "docs",
+      "description": "Documentation specialist — maintains technical docs and API references"
+    }
+  ]
+}

package/dist/presets/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Preset loading and application logic.
+ *
+ * Presets are curated agent collections stored in `<squad-home>/presets/<name>/`.
+ * Each preset directory contains:
+ * - `preset.json` — manifest with metadata and agent list
+ * - `agents/<name>/charter.md` — agent charter files
+ *
+ * @module presets
+ */
+import type { PresetManifest, PresetApplyResult } from './types.js';
+export type { PresetManifest, PresetAgent, PresetApplyResult } from './types.js';
+/**
+ * List all available presets from the squad home presets directory.
+ *
+ * @returns Array of preset manifests, or empty array if no presets found.
+ */
+export declare function listPresets(): PresetManifest[];
+/**
+ * Load a specific preset by name.
+ *
+ * @param name - Preset name (directory name under presets/).
+ * @returns The preset manifest, or null if not found.
+ */
+export declare function loadPreset(name: string): PresetManifest | null;
+/**
+ * Apply a preset — copy its agents into a target squad directory.
+ *
+ * By default, existing agents are skipped (not overwritten).
+ * Pass `force: true` to overwrite existing agents.
+ *
+ * @param presetName - Name of the preset to apply.
+ * @param targetDir  - Target directory to install agents into (e.g. `.squad/agents/`).
+ * @param options    - Options for applying the preset.
+ * @returns Array of results for each agent in the preset.
+ */
+export declare function applyPreset(presetName: string, targetDir: string, options?: {
+    force?: boolean;
+}): PresetApplyResult[];
+/**
+ * Install a preset into squad home from an external source directory.
+ * Copies the preset directory into `<squad-home>/presets/<name>/`.
+ *
+ * @param sourceDir - Source directory containing preset.json and agents/.
+ * @param name      - Preset name (used as destination directory name).
+ * @returns Path to the installed preset.
+ */
+export declare function installPreset(sourceDir: string, name: string): string;
+/**
+ * Save the current project's squad agents as a reusable preset.
+ *
+ * Reads agents from the given squad directory (e.g. `.squad/agents/`),
+ * generates a `preset.json` manifest, and copies everything into
+ * `<squad-home>/presets/<name>/`.
+ *
+ * @param name      - Name for the new preset.
+ * @param squadDir  - Path to the project's .squad/ directory containing agents/.
+ * @param options   - force: overwrite existing preset; description: preset description.
+ * @returns Path to the saved preset directory.
+ */
+export declare function savePreset(name: string, squadDir: string, options?: {
+    force?: boolean;
+    description?: string;
+}): string;
+/**
+ * Get the path to the built-in presets that ship with the SDK.
+ * These are bundled in the package under `presets/builtin/`.
+ */
+export declare function getBuiltinPresetsDir(): string;
+/**
+ * Seed squad home with built-in presets if they don't already exist.
+ * Only copies presets that are missing — never overwrites user presets.
+ *
+ * @returns Names of presets that were seeded.
+ */
+export declare function seedBuiltinPresets(): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/presets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAgBjF;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAgB9C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAU9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,iBAAiB,EAAE,CAmDrB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,MAAM,CAiER;AA8CD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAG7C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAqB7C"}

package/dist/presets/index.js

@@ -0,0 +1,288 @@
+/**
+ * Preset loading and application logic.
+ *
+ * Presets are curated agent collections stored in `<squad-home>/presets/<name>/`.
+ * Each preset directory contains:
+ * - `preset.json` — manifest with metadata and agent list
+ * - `agents/<name>/charter.md` — agent charter files
+ *
+ * @module presets
+ */
+import path from 'node:path';
+import { readdirSync, lstatSync, rmSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { FSStorageProvider } from '../storage/fs-storage-provider.js';
+import { resolvePresetsDir, ensureSquadHome } from '../resolution.js';
+const storage = new FSStorageProvider();
+function isDirSync(p) {
+    try {
+        return lstatSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** Validate a preset or agent name — must be a safe basename (no path separators, no ..) */
+function validateName(name, label) {
+    if (!name || name !== path.basename(name) || name === '..' || name === '.') {
+        throw new Error(`Invalid ${label} name: '${name}'. Must be a simple directory name.`);
+    }
+}
+/**
+ * List all available presets from the squad home presets directory.
+ *
+ * @returns Array of preset manifests, or empty array if no presets found.
+ */
+export function listPresets() {
+    const presetsDir = resolvePresetsDir();
+    if (!presetsDir)
+        return [];
+    const entries = readdirSync(presetsDir, { encoding: 'utf-8' });
+    const presets = [];
+    for (const entry of entries) {
+        const presetDir = path.join(presetsDir, entry);
+        if (!isDirSync(presetDir))
+            continue;
+        const manifest = loadPresetManifest(presetDir);
+        if (manifest)
+            presets.push(manifest);
+    }
+    return presets;
+}
+/**
+ * Load a specific preset by name.
+ *
+ * @param name - Preset name (directory name under presets/).
+ * @returns The preset manifest, or null if not found.
+ */
+export function loadPreset(name) {
+    const presetsDir = resolvePresetsDir();
+    if (!presetsDir)
+        return null;
+    const presetDir = path.join(presetsDir, name);
+    if (!storage.existsSync(presetDir) || !isDirSync(presetDir)) {
+        return null;
+    }
+    return loadPresetManifest(presetDir);
+}
+/**
+ * Apply a preset — copy its agents into a target squad directory.
+ *
+ * By default, existing agents are skipped (not overwritten).
+ * Pass `force: true` to overwrite existing agents.
+ *
+ * @param presetName - Name of the preset to apply.
+ * @param targetDir  - Target directory to install agents into (e.g. `.squad/agents/`).
+ * @param options    - Options for applying the preset.
+ * @returns Array of results for each agent in the preset.
+ */
+export function applyPreset(presetName, targetDir, options = {}) {
+    try {
+        validateName(presetName, 'preset');
+    }
+    catch (err) {
+        return [{ agent: presetName, status: 'error', reason: String(err) }];
+    }
+    const presetsDir = resolvePresetsDir();
+    if (!presetsDir) {
+        return [{ agent: presetName, status: 'error', reason: 'No presets directory found. Run `squad preset init --remote` to set up, or `squad preset init` for local-only.' }];
+    }
+    const presetDir = path.join(presetsDir, presetName);
+    const manifest = loadPresetManifest(presetDir);
+    if (!manifest) {
+        return [{ agent: presetName, status: 'error', reason: `Preset '${presetName}' not found` }];
+    }
+    const presetAgentsDir = path.join(presetDir, 'agents');
+    const results = [];
+    for (const agent of manifest.agents) {
+        try {
+            validateName(agent.name, 'agent');
+        }
+        catch {
+            results.push({ agent: agent.name, status: 'error', reason: `Invalid agent name: '${agent.name}'` });
+            continue;
+        }
+        const sourceDir = path.join(presetAgentsDir, agent.name);
+        const destDir = path.join(targetDir, agent.name);
+        if (!storage.existsSync(sourceDir)) {
+            results.push({ agent: agent.name, status: 'error', reason: 'Source agent directory missing in preset' });
+            continue;
+        }
+        if (storage.existsSync(destDir) && !options.force) {
+            results.push({ agent: agent.name, status: 'skipped', reason: 'Already exists (use --force to overwrite)' });
+            continue;
+        }
+        try {
+            // When forcing, remove dest first so renamed/deleted files don't linger
+            if (options.force && storage.existsSync(destDir)) {
+                rmSync(destDir, { recursive: true, force: true });
+            }
+            copyDirRecursive(sourceDir, destDir);
+            results.push({ agent: agent.name, status: 'installed' });
+        }
+        catch (err) {
+            results.push({ agent: agent.name, status: 'error', reason: String(err) });
+        }
+    }
+    return results;
+}
+/**
+ * Install a preset into squad home from an external source directory.
+ * Copies the preset directory into `<squad-home>/presets/<name>/`.
+ *
+ * @param sourceDir - Source directory containing preset.json and agents/.
+ * @param name      - Preset name (used as destination directory name).
+ * @returns Path to the installed preset.
+ */
+export function installPreset(sourceDir, name) {
+    const homeDir = ensureSquadHome();
+    const destDir = path.join(homeDir, 'presets', name);
+    copyDirRecursive(sourceDir, destDir);
+    return destDir;
+}
+/**
+ * Save the current project's squad agents as a reusable preset.
+ *
+ * Reads agents from the given squad directory (e.g. `.squad/agents/`),
+ * generates a `preset.json` manifest, and copies everything into
+ * `<squad-home>/presets/<name>/`.
+ *
+ * @param name      - Name for the new preset.
+ * @param squadDir  - Path to the project's .squad/ directory containing agents/.
+ * @param options   - force: overwrite existing preset; description: preset description.
+ * @returns Path to the saved preset directory.
+ */
+export function savePreset(name, squadDir, options = {}) {
+    validateName(name, 'preset');
+    const agentsDir = path.join(squadDir, 'agents');
+    if (!storage.existsSync(agentsDir) || !isDirSync(agentsDir)) {
+        throw new Error(`No agents/ directory found in ${squadDir}`);
+    }
+    const homeDir = ensureSquadHome();
+    const destDir = path.join(homeDir, 'presets', name);
+    if (storage.existsSync(destDir) && !options.force) {
+        throw new Error(`Preset '${name}' already exists. Use --force to overwrite.`);
+    }
+    // Discover agents
+    const agentEntries = readdirSync(agentsDir, { encoding: 'utf-8' });
+    const agents = [];
+    for (const entry of agentEntries) {
+        const agentDir = path.join(agentsDir, entry);
+        if (!isDirSync(agentDir))
+            continue;
+        // Try to extract role from charter.md front matter
+        let role = entry;
+        let description = '';
+        const charterPath = path.join(agentDir, 'charter.md');
+        if (storage.existsSync(charterPath)) {
+            const content = storage.readSync(charterPath);
+            if (content) {
+                const roleMatch = content.match(/^##?\s+.*?[-–—]\s*(.+)/m);
+                if (roleMatch)
+                    role = roleMatch[1].trim();
+                // First non-empty, non-heading line as description
+                const lines = content.split('\n');
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('---')) {
+                        description = trimmed.slice(0, 120);
+                        break;
+                    }
+                }
+            }
+        }
+        agents.push({ name: entry, role, description });
+    }
+    if (agents.length === 0) {
+        throw new Error(`No agents found in ${agentsDir}`);
+    }
+    // Build manifest
+    const manifest = {
+        name,
+        version: '1.0.0',
+        description: options.description ?? `Custom preset '${name}'`,
+        agents: agents.map(a => ({ name: a.name, role: a.role, description: a.description })),
+    };
+    // Write preset directory
+    storage.mkdirSync(destDir, { recursive: true });
+    storage.writeSync(path.join(destDir, 'preset.json'), JSON.stringify(manifest, null, 2));
+    copyDirRecursive(agentsDir, path.join(destDir, 'agents'));
+    return destDir;
+}
+// ============================================================================
+// Internal helpers
+// ============================================================================
+function loadPresetManifest(presetDir) {
+    const manifestPath = path.join(presetDir, 'preset.json');
+    if (!storage.existsSync(manifestPath))
+        return null;
+    try {
+        const content = storage.readSync(manifestPath);
+        if (!content)
+            return null;
+        const manifest = JSON.parse(content);
+        if (!manifest.name || !manifest.agents || !Array.isArray(manifest.agents)) {
+            return null;
+        }
+        return manifest;
+    }
+    catch {
+        return null;
+    }
+}
+function copyDirRecursive(src, dest) {
+    storage.mkdirSync(dest, { recursive: true });
+    const entries = readdirSync(src, { encoding: 'utf-8' });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry);
+        const destPath = path.join(dest, entry);
+        const stat = lstatSync(srcPath);
+        // Skip symlinks — don't follow them into unintended locations
+        if (stat.isSymbolicLink())
+            continue;
+        if (stat.isDirectory()) {
+            copyDirRecursive(srcPath, destPath);
+        }
+        else {
+            const content = storage.readSync(srcPath);
+            if (content !== undefined) {
+                storage.writeSync(destPath, content);
+            }
+        }
+    }
+}
+/**
+ * Get the path to the built-in presets that ship with the SDK.
+ * These are bundled in the package under `presets/builtin/`.
+ */
+export function getBuiltinPresetsDir() {
+    const thisFile = fileURLToPath(import.meta.url);
+    return path.join(path.dirname(thisFile), 'builtin');
+}
+/**
+ * Seed squad home with built-in presets if they don't already exist.
+ * Only copies presets that are missing — never overwrites user presets.
+ *
+ * @returns Names of presets that were seeded.
+ */
+export function seedBuiltinPresets() {
+    const homeDir = ensureSquadHome();
+    const builtinDir = getBuiltinPresetsDir();
+    const targetPresetsDir = path.join(homeDir, 'presets');
+    const seeded = [];
+    if (!storage.existsSync(builtinDir))
+        return seeded;
+    const entries = readdirSync(builtinDir, { encoding: 'utf-8' });
+    for (const entry of entries) {
+        const srcDir = path.join(builtinDir, entry);
+        const destDir = path.join(targetPresetsDir, entry);
+        if (!isDirSync(srcDir))
+            continue;
+        if (storage.existsSync(destDir))
+            continue;
+        copyDirRecursive(srcDir, destDir);
+        seeded.push(entry);
+    }
+    return seeded;
+}
+//# sourceMappingURL=index.js.map