@bradygaster/squad-sdk 0.7.0 → 0.8.0

package/dist/config/agent-source.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Agent Source Registry
+ * Pluggable agent discovery and loading
+ */
+export interface AgentSource {
+    readonly name: string;
+    readonly type: 'local' | 'github' | 'marketplace';
+    listAgents(): Promise<AgentManifest[]>;
+    getAgent(name: string): Promise<AgentDefinition | null>;
+    getCharter(name: string): Promise<string | null>;
+}
+export interface AgentManifest {
+    name: string;
+    role: string;
+    version?: string;
+    source: string;
+}
+export interface AgentDefinition extends AgentManifest {
+    charter: string;
+    model?: string;
+    tools?: string[];
+    skills?: string[];
+    history?: string;
+}
+/**
+ * Parse charter.md content to extract agent metadata.
+ */
+export declare function parseCharterMetadata(content: string): {
+    name?: string;
+    role?: string;
+    model?: string;
+    skills?: string[];
+    tools?: string[];
+};
+export declare class LocalAgentSource implements AgentSource {
+    private basePath;
+    readonly name = "local";
+    readonly type: "local";
+    constructor(basePath: string);
+    /**
+     * Resolve the agents directory, preferring .squad/agents over .ai-team/agents.
+     */
+    private resolveAgentsDir;
+    listAgents(): Promise<AgentManifest[]>;
+    getAgent(name: string): Promise<AgentDefinition | null>;
+    getCharter(name: string): Promise<string | null>;
+}
+/**
+ * Pluggable fetcher interface for GitHub API calls (enables testing).
+ */
+export interface GitHubFetcher {
+    /** List directory entries at a path in a repo. */
+    listDirectory(owner: string, repo: string, path: string, ref?: string): Promise<Array<{
+        name: string;
+        type: 'file' | 'dir';
+    }>>;
+    /** Fetch file content (UTF-8 string) at a path in a repo. */
+    getFileContent(owner: string, repo: string, path: string, ref?: string): Promise<string | null>;
+}
+export declare class GitHubAgentSource implements AgentSource {
+    readonly name = "github";
+    readonly type: "github";
+    private owner;
+    private repoName;
+    private branch?;
+    private pathPrefix;
+    private fetcher;
+    constructor(repo: string, options?: {
+        ref?: string;
+        pathPrefix?: string;
+        fetcher?: GitHubFetcher;
+    });
+    listAgents(): Promise<AgentManifest[]>;
+    getAgent(name: string): Promise<AgentDefinition | null>;
+    getCharter(name: string): Promise<string | null>;
+}
+export declare class MarketplaceAgentSource implements AgentSource {
+    private apiEndpoint;
+    readonly name = "marketplace";
+    readonly type: "marketplace";
+    constructor(apiEndpoint: string);
+    listAgents(): Promise<AgentManifest[]>;
+    getAgent(name: string): Promise<AgentDefinition | null>;
+    getCharter(name: string): Promise<string | null>;
+}
+export declare class AgentRegistry {
+    private sources;
+    register(source: AgentSource): void;
+    unregister(name: string): boolean;
+    getSource(name: string): AgentSource | undefined;
+    listAllAgents(): Promise<AgentManifest[]>;
+    findAgent(name: string): Promise<AgentDefinition | null>;
+    getCharter(name: string): Promise<string | null>;
+}
+//# sourceMappingURL=agent-source.d.ts.map

package/dist/config/agent-source.d.ts.map

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

package/dist/config/agent-source.js

@@ -0,0 +1,274 @@
+/**
+ * Agent Source Registry
+ * Pluggable agent discovery and loading
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/** Directories to scan for agents, in priority order. */
+const AGENT_DIRS = ['.squad/agents', '.ai-team/agents'];
+/**
+ * Parse charter.md content to extract agent metadata.
+ */
+export function parseCharterMetadata(content) {
+    const result = {};
+    const identityMatch = content.match(/##\s+Identity\s*\n([\s\S]*?)(?=\n##|\n---|$)/i);
+    if (identityMatch) {
+        const section = identityMatch[1];
+        const nameMatch = section.match(/\*\*Name:\*\*\s*(.+)/i);
+        if (nameMatch)
+            result.name = nameMatch[1].trim();
+        const roleMatch = section.match(/\*\*Role:\*\*\s*(.+)/i);
+        if (roleMatch)
+            result.role = roleMatch[1].trim();
+        const expertiseMatch = section.match(/\*\*Expertise:\*\*\s*(.+)/i);
+        if (expertiseMatch) {
+            result.skills = expertiseMatch[1].split(',').map(s => s.trim()).filter(Boolean);
+        }
+    }
+    const modelMatch = content.match(/##\s+Model\s*\n([\s\S]*?)(?=\n##|\n---|$)/i);
+    if (modelMatch) {
+        const preferredMatch = modelMatch[1].match(/\*\*Preferred:\*\*\s*(.+)/i);
+        if (preferredMatch)
+            result.model = preferredMatch[1].trim();
+    }
+    const toolsMatch = content.match(/##\s+Tools?\s*\n([\s\S]*?)(?=\n##|\n---|$)/i);
+    if (toolsMatch) {
+        result.tools = toolsMatch[1]
+            .split('\n')
+            .map(line => {
+            const m = line.match(/^\s*[-*]\s+`?([^`\s]+)`?/);
+            return m ? m[1].trim() : null;
+        })
+            .filter((t) => t !== null);
+    }
+    return result;
+}
+export class LocalAgentSource {
+    basePath;
+    name = 'local';
+    type = 'local';
+    constructor(basePath) {
+        this.basePath = basePath;
+    }
+    /**
+     * Resolve the agents directory, preferring .squad/agents over .ai-team/agents.
+     */
+    async resolveAgentsDir() {
+        for (const dir of AGENT_DIRS) {
+            const fullPath = path.join(this.basePath, dir);
+            try {
+                const stat = await fs.stat(fullPath);
+                if (stat.isDirectory())
+                    return fullPath;
+            }
+            catch {
+                // directory doesn't exist, try next
+            }
+        }
+        return null;
+    }
+    async listAgents() {
+        const agentsDir = await this.resolveAgentsDir();
+        if (!agentsDir)
+            return [];
+        const manifests = [];
+        let entries;
+        try {
+            entries = await fs.readdir(agentsDir, { withFileTypes: true });
+        }
+        catch {
+            return [];
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const charterPath = path.join(agentsDir, entry.name, 'charter.md');
+            try {
+                const content = await fs.readFile(charterPath, 'utf-8');
+                const meta = parseCharterMetadata(content);
+                manifests.push({
+                    name: meta.name || entry.name,
+                    role: meta.role || 'agent',
+                    source: 'local',
+                });
+            }
+            catch {
+                // Skip agents with missing/unreadable charter
+            }
+        }
+        return manifests;
+    }
+    async getAgent(name) {
+        const agentsDir = await this.resolveAgentsDir();
+        if (!agentsDir)
+            return null;
+        const charterPath = path.join(agentsDir, name, 'charter.md');
+        let charter;
+        try {
+            charter = await fs.readFile(charterPath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+        const meta = parseCharterMetadata(charter);
+        // Optionally read history.md
+        let history;
+        try {
+            history = await fs.readFile(path.join(agentsDir, name, 'history.md'), 'utf-8');
+        }
+        catch {
+            // history is optional
+        }
+        return {
+            name: meta.name || name,
+            role: meta.role || 'agent',
+            source: 'local',
+            charter,
+            model: meta.model,
+            tools: meta.tools,
+            skills: meta.skills,
+            history,
+        };
+    }
+    async getCharter(name) {
+        const agentsDir = await this.resolveAgentsDir();
+        if (!agentsDir)
+            return null;
+        try {
+            return await fs.readFile(path.join(agentsDir, name, 'charter.md'), 'utf-8');
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/** Parse "owner/repo" format into components. */
+function parseOwnerRepo(repo) {
+    const parts = repo.split('/');
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        throw new Error(`Invalid repo format "${repo}": expected "owner/repo"`);
+    }
+    return { owner: parts[0], repo: parts[1] };
+}
+export class GitHubAgentSource {
+    name = 'github';
+    type = 'github';
+    owner;
+    repoName;
+    branch;
+    pathPrefix;
+    fetcher;
+    constructor(repo, options) {
+        const parsed = parseOwnerRepo(repo);
+        this.owner = parsed.owner;
+        this.repoName = parsed.repo;
+        this.branch = options?.ref;
+        this.pathPrefix = options?.pathPrefix ?? '.squad/agents';
+        this.fetcher = options?.fetcher ?? createDefaultFetcher();
+    }
+    async listAgents() {
+        const entries = await this.fetcher.listDirectory(this.owner, this.repoName, this.pathPrefix, this.branch);
+        const dirs = entries.filter(e => e.type === 'dir');
+        const manifests = [];
+        for (const dir of dirs) {
+            const charterPath = `${this.pathPrefix}/${dir.name}/charter.md`;
+            const content = await this.fetcher.getFileContent(this.owner, this.repoName, charterPath, this.branch);
+            if (!content)
+                continue;
+            const meta = parseCharterMetadata(content);
+            manifests.push({
+                name: meta.name || dir.name,
+                role: meta.role || 'agent',
+                source: 'github',
+            });
+        }
+        return manifests;
+    }
+    async getAgent(name) {
+        const charterPath = `${this.pathPrefix}/${name}/charter.md`;
+        const charter = await this.fetcher.getFileContent(this.owner, this.repoName, charterPath, this.branch);
+        if (!charter)
+            return null;
+        const meta = parseCharterMetadata(charter);
+        let history;
+        const historyPath = `${this.pathPrefix}/${name}/history.md`;
+        const historyContent = await this.fetcher.getFileContent(this.owner, this.repoName, historyPath, this.branch);
+        if (historyContent)
+            history = historyContent;
+        return {
+            name: meta.name || name,
+            role: meta.role || 'agent',
+            source: 'github',
+            charter,
+            model: meta.model,
+            tools: meta.tools,
+            skills: meta.skills,
+            history,
+        };
+    }
+    async getCharter(name) {
+        const charterPath = `${this.pathPrefix}/${name}/charter.md`;
+        return this.fetcher.getFileContent(this.owner, this.repoName, charterPath, this.branch);
+    }
+}
+/** Default fetcher that returns empty results when no real fetcher is configured. */
+function createDefaultFetcher() {
+    return {
+        async listDirectory() {
+            return [];
+        },
+        async getFileContent() {
+            return null;
+        },
+    };
+}
+export class MarketplaceAgentSource {
+    apiEndpoint;
+    name = 'marketplace';
+    type = 'marketplace';
+    constructor(apiEndpoint) {
+        this.apiEndpoint = apiEndpoint;
+    }
+    async listAgents() {
+        return [];
+    }
+    async getAgent(name) {
+        return null;
+    }
+    async getCharter(name) {
+        return null;
+    }
+}
+export class AgentRegistry {
+    sources = new Map();
+    register(source) {
+        this.sources.set(source.name, source);
+    }
+    unregister(name) {
+        return this.sources.delete(name);
+    }
+    getSource(name) {
+        return this.sources.get(name);
+    }
+    async listAllAgents() {
+        const results = await Promise.all(Array.from(this.sources.values()).map(s => s.listAgents()));
+        return results.flat();
+    }
+    async findAgent(name) {
+        for (const source of this.sources.values()) {
+            const agent = await source.getAgent(name);
+            if (agent)
+                return agent;
+        }
+        return null;
+    }
+    async getCharter(name) {
+        for (const source of this.sources.values()) {
+            const charter = await source.getCharter(name);
+            if (charter)
+                return charter;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=agent-source.js.map

package/dist/config/agent-source.js.map

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

package/dist/config/doc-sync.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Doc ↔ Config Synchronisation (M2-12)
+ *
+ * Keeps agent documentation (.agent.md) in sync with typed SquadConfig.
+ * The .agent.md file is the *reference* document; SquadConfig is the
+ * *runtime* source of truth.  This module bridges the two.
+ *
+ * @module config/doc-sync
+ */
+import type { AgentDocMetadata } from './agent-doc.js';
+import type { SquadConfig } from './schema.js';
+/**
+ * A single mismatch between the agent doc and the typed config.
+ */
+export interface DriftEntry {
+    /** Which field differs */
+    field: string;
+    /** Value found in the agent doc */
+    docValue: unknown;
+    /** Value found in the typed config */
+    configValue: unknown;
+    /** Human-readable summary */
+    message: string;
+}
+/**
+ * Result of a drift-detection run.
+ */
+export interface DriftReport {
+    /** True when doc and config are perfectly aligned */
+    inSync: boolean;
+    /** Individual mismatches */
+    entries: DriftEntry[];
+}
+/**
+ * Merge metadata extracted from an agent doc into an existing SquadConfig.
+ *
+ * Only fields present in the doc metadata will overwrite config values;
+ * everything else is left untouched.
+ *
+ * @param doc    - Metadata parsed from the .agent.md file
+ * @param config - Current typed configuration (mutated in-place *and* returned)
+ * @returns The updated config
+ */
+export declare function syncDocToConfig(doc: AgentDocMetadata, config: SquadConfig): SquadConfig;
+/**
+ * Generate (or update) an agent doc from a typed SquadConfig.
+ *
+ * If a `template` is provided the function replaces recognised section
+ * placeholders (`{{IDENTITY}}`, `{{CAPABILITIES}}`, etc.) with values
+ * from the config.  If no template is given a minimal markdown document
+ * is produced from scratch.
+ *
+ * @param config   - The typed configuration
+ * @param template - Optional markdown template with `{{SECTION}}` placeholders
+ * @returns Generated markdown string
+ */
+export declare function syncConfigToDoc(config: SquadConfig, template?: string): string;
+/**
+ * Detect mismatches between an agent doc and a typed config.
+ *
+ * @param doc    - Metadata parsed from the .agent.md file
+ * @param config - Current typed configuration
+ * @returns A drift report listing every mismatch found
+ */
+export declare function detectDrift(doc: AgentDocMetadata, config: SquadConfig): DriftReport;
+//# sourceMappingURL=doc-sync.d.ts.map

package/dist/config/doc-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-sync.d.ts","sourceRoot":"","sources":["../../src/config/doc-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,aAAa,CAAC;AAG5D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,WAAW,EAAE,OAAO,CAAC;IACrB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,MAAM,EAAE,OAAO,CAAC;IAChB,4BAA4B;IAC5B,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,WAAW,GAClB,WAAW,CAiDb;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CA2CR;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,WAAW,GAClB,WAAW,CAiFb"}