@bradygaster/squad-sdk 0.7.0 → 0.8.0

package/dist/skills/skill-source.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Skill Source Interface & Implementations (M5-5, Issue #128)
+ *
+ * Pluggable skill discovery from local filesystem or GitHub repos.
+ */
+import { type SkillDefinition } from './skill-loader.js';
+import type { GitHubFetcher } from '../config/agent-source.js';
+export interface SkillSource {
+    readonly name: string;
+    readonly type: 'local' | 'github';
+    readonly priority: number;
+    listSkills(): Promise<SkillManifest[]>;
+    getSkill(id: string): Promise<SkillDefinition | null>;
+    getContent(id: string): Promise<string | null>;
+}
+export interface SkillManifest {
+    id: string;
+    name: string;
+    domain: string;
+    source: string;
+}
+export declare class LocalSkillSource implements SkillSource {
+    private basePath;
+    readonly name = "local";
+    readonly type: "local";
+    readonly priority: number;
+    constructor(basePath: string, priority?: number);
+    private get skillsDir();
+    listSkills(): Promise<SkillManifest[]>;
+    getSkill(id: string): Promise<SkillDefinition | null>;
+    getContent(id: string): Promise<string | null>;
+}
+export declare class GitHubSkillSource implements SkillSource {
+    readonly name = "github";
+    readonly type: "github";
+    readonly priority: number;
+    private owner;
+    private repoName;
+    private branch?;
+    private pathPrefix;
+    private fetcher;
+    constructor(repo: string, options?: {
+        ref?: string;
+        pathPrefix?: string;
+        fetcher?: GitHubFetcher;
+        priority?: number;
+    });
+    listSkills(): Promise<SkillManifest[]>;
+    getSkill(id: string): Promise<SkillDefinition | null>;
+    getContent(id: string): Promise<string | null>;
+}
+export declare class SkillSourceRegistry {
+    private sources;
+    register(source: SkillSource): void;
+    unregister(name: string): boolean;
+    getSource(name: string): SkillSource | undefined;
+    /** Sources sorted by priority descending (higher priority first). */
+    private sortedSources;
+    listAllSkills(): Promise<SkillManifest[]>;
+    findSkill(id: string): Promise<SkillDefinition | null>;
+    getContent(id: string): Promise<string | null>;
+}
+//# sourceMappingURL=skill-source.d.ts.map

package/dist/skills/skill-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-source.d.ts","sourceRoot":"","sources":["../../src/skills/skill-source.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI/D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACtD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,qBAAa,gBAAiB,YAAW,WAAW;IAKtC,OAAO,CAAC,QAAQ;IAJ5B,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEN,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAI;IAIlD,OAAO,KAAK,SAAS,GAEpB;IAEK,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IA8BtC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAoBrD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAWrD;AAID,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAgB;gBAG7B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,aAAa,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAiBvF,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAwBtC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAkBrD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CASrD;AAID,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAuC;IAEtD,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAInC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIhD,qEAAqE;IACrE,OAAO,CAAC,aAAa;IAIf,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAMzC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAQtD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAOrD"}

package/dist/skills/skill-source.js

@@ -0,0 +1,199 @@
+/**
+ * Skill Source Interface & Implementations (M5-5, Issue #128)
+ *
+ * Pluggable skill discovery from local filesystem or GitHub repos.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parseFrontmatter } from './skill-loader.js';
+// --- Local implementation ---
+export class LocalSkillSource {
+    basePath;
+    name = 'local';
+    type = 'local';
+    priority;
+    constructor(basePath, priority = 0) {
+        this.basePath = basePath;
+        this.priority = priority;
+    }
+    get skillsDir() {
+        return path.join(this.basePath, '.squad', 'skills');
+    }
+    async listSkills() {
+        if (!fs.existsSync(this.skillsDir))
+            return [];
+        let entries;
+        try {
+            entries = fs.readdirSync(this.skillsDir, { withFileTypes: true });
+        }
+        catch {
+            return [];
+        }
+        const manifests = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const skillFile = path.join(this.skillsDir, entry.name, 'SKILL.md');
+            if (!fs.existsSync(skillFile))
+                continue;
+            try {
+                const raw = fs.readFileSync(skillFile, 'utf-8');
+                const { meta } = parseFrontmatter(raw);
+                manifests.push({
+                    id: entry.name,
+                    name: typeof meta.name === 'string' ? meta.name : entry.name,
+                    domain: typeof meta.domain === 'string' ? meta.domain : 'general',
+                    source: 'local',
+                });
+            }
+            catch {
+                // skip malformed
+            }
+        }
+        return manifests;
+    }
+    async getSkill(id) {
+        const skillFile = path.join(this.skillsDir, id, 'SKILL.md');
+        if (!fs.existsSync(skillFile))
+            return null;
+        try {
+            const raw = fs.readFileSync(skillFile, 'utf-8');
+            const { meta, body } = parseFrontmatter(raw);
+            if (!body)
+                return null;
+            return {
+                id,
+                name: typeof meta.name === 'string' ? meta.name : id,
+                domain: typeof meta.domain === 'string' ? meta.domain : 'general',
+                content: body,
+                triggers: Array.isArray(meta.triggers) ? meta.triggers : [],
+                agentRoles: Array.isArray(meta.roles) ? meta.roles : [],
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async getContent(id) {
+        const skillFile = path.join(this.skillsDir, id, 'SKILL.md');
+        if (!fs.existsSync(skillFile))
+            return null;
+        try {
+            const raw = fs.readFileSync(skillFile, 'utf-8');
+            const { body } = parseFrontmatter(raw);
+            return body || null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+// --- GitHub implementation ---
+export class GitHubSkillSource {
+    name = 'github';
+    type = 'github';
+    priority;
+    owner;
+    repoName;
+    branch;
+    pathPrefix;
+    fetcher;
+    constructor(repo, options) {
+        const parts = repo.split('/');
+        if (parts.length !== 2 || !parts[0] || !parts[1]) {
+            throw new Error(`Invalid repo format "${repo}": expected "owner/repo"`);
+        }
+        this.owner = parts[0];
+        this.repoName = parts[1];
+        this.branch = options?.ref;
+        this.pathPrefix = options?.pathPrefix ?? '.squad/skills';
+        this.fetcher = options?.fetcher ?? {
+            async listDirectory() { throw new Error('No GitHubFetcher configured'); },
+            async getFileContent() { throw new Error('No GitHubFetcher configured'); },
+        };
+        this.priority = options?.priority ?? 0;
+    }
+    async listSkills() {
+        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 skillPath = `${this.pathPrefix}/${dir.name}/SKILL.md`;
+            const content = await this.fetcher.getFileContent(this.owner, this.repoName, skillPath, this.branch);
+            if (!content)
+                continue;
+            const { meta } = parseFrontmatter(content);
+            manifests.push({
+                id: dir.name,
+                name: typeof meta.name === 'string' ? meta.name : dir.name,
+                domain: typeof meta.domain === 'string' ? meta.domain : 'general',
+                source: 'github',
+            });
+        }
+        return manifests;
+    }
+    async getSkill(id) {
+        const skillPath = `${this.pathPrefix}/${id}/SKILL.md`;
+        const content = await this.fetcher.getFileContent(this.owner, this.repoName, skillPath, this.branch);
+        if (!content)
+            return null;
+        const { meta, body } = parseFrontmatter(content);
+        if (!body)
+            return null;
+        return {
+            id,
+            name: typeof meta.name === 'string' ? meta.name : id,
+            domain: typeof meta.domain === 'string' ? meta.domain : 'general',
+            content: body,
+            triggers: Array.isArray(meta.triggers) ? meta.triggers : [],
+            agentRoles: Array.isArray(meta.roles) ? meta.roles : [],
+        };
+    }
+    async getContent(id) {
+        const skillPath = `${this.pathPrefix}/${id}/SKILL.md`;
+        const content = await this.fetcher.getFileContent(this.owner, this.repoName, skillPath, this.branch);
+        if (!content)
+            return null;
+        const { body } = parseFrontmatter(content);
+        return body || null;
+    }
+}
+// --- Registry ---
+export class SkillSourceRegistry {
+    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);
+    }
+    /** Sources sorted by priority descending (higher priority first). */
+    sortedSources() {
+        return Array.from(this.sources.values()).sort((a, b) => b.priority - a.priority);
+    }
+    async listAllSkills() {
+        const sorted = this.sortedSources();
+        const results = await Promise.all(sorted.map(s => s.listSkills()));
+        return results.flat();
+    }
+    async findSkill(id) {
+        for (const source of this.sortedSources()) {
+            const skill = await source.getSkill(id);
+            if (skill)
+                return skill;
+        }
+        return null;
+    }
+    async getContent(id) {
+        for (const source of this.sortedSources()) {
+            const content = await source.getContent(id);
+            if (content)
+                return content;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=skill-source.js.map

package/dist/skills/skill-source.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Tool Registry — Custom Tools API (PRD 2)
+ *
+ * Defines Squad's custom tools registered with the SDK via defineTool().
+ * Tools provide agents with typed, validated orchestration primitives:
+ *   - squad_route:  Route work to another agent via session pool
+ *   - squad_decide: Write a typed decision to the inbox drop-box
+ *   - squad_memory: Append to agent history (learnings, updates)
+ *   - squad_status: Query session pool state
+ *   - squad_skill:  Read/write agent skills
+ */
+import type { SquadTool, SquadToolResult } from '../adapter/types.js';
+export interface ToolResult {
+    success: boolean;
+    message: string;
+    data?: unknown;
+}
+export interface RouteRequest {
+    /** Target agent name */
+    targetAgent: string;
+    /** Task description for the target agent */
+    task: string;
+    /** Priority level */
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    /** Context to pass to the target session */
+    context?: string;
+}
+export interface DecisionRecord {
+    /** Decision author (agent name) */
+    author: string;
+    /** Decision summary */
+    summary: string;
+    /** Full decision body */
+    body: string;
+    /** Related agents or PRDs */
+    references?: string[];
+}
+export interface MemoryEntry {
+    /** Agent name */
+    agent: string;
+    /** Section to append to (learnings, updates, sessions) */
+    section: 'learnings' | 'updates' | 'sessions';
+    /** Content to append */
+    content: string;
+}
+export interface StatusQuery {
+    /** Filter by agent name */
+    agentName?: string;
+    /** Filter by session status */
+    status?: string;
+    /** Include detailed session metadata */
+    verbose?: boolean;
+}
+export interface SkillRequest {
+    /** Skill name (maps to .squad/skills/{name}/SKILL.md) */
+    skillName: string;
+    /** Operation: read the skill or write/update it */
+    operation: 'read' | 'write';
+    /** Skill content (required for write) */
+    content?: string;
+    /** Confidence level (required for write) */
+    confidence?: 'low' | 'medium' | 'high';
+}
+/**
+ * Define a typed Squad tool with JSON schema parameters.
+ * Creates a SquadTool object compatible with the adapter layer.
+ */
+export declare function defineTool<TArgs = unknown>(config: {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    handler: (args: TArgs) => Promise<SquadToolResult> | SquadToolResult;
+}): SquadTool<TArgs>;
+export declare class ToolRegistry {
+    private tools;
+    private squadRoot;
+    private sessionPoolGetter?;
+    constructor(squadRoot?: string, sessionPoolGetter?: () => any);
+    private registerSquadTools;
+    /** Get all registered tools for session config */
+    getTools(): SquadTool<any>[];
+    /** Get tools filtered by agent's allowed tool list */
+    getToolsForAgent(allowedTools?: string[]): SquadTool<any>[];
+    /** Get a specific tool by name */
+    getTool(name: string): SquadTool<any> | undefined;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAItE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IAC9C,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACxC;AAID;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,EAAE;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;CACtE,GAAG,SAAS,CAAC,KAAK,CAAC,CASnB;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,iBAAiB,CAAC,CAAY;gBAE1B,SAAS,SAAW,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG;IAM/D,OAAO,CAAC,kBAAkB;IA4Y1B,kDAAkD;IAClD,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE;IAI5B,sDAAsD;IACtD,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE;IAO3D,kCAAkC;IAClC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS;CAGlD"}