@bradygaster/squad-sdk 0.6.2 → 0.8.0

package/dist/casting/casting-engine.js

@@ -0,0 +1,223 @@
+/**
+ * Casting Engine v1 (M3-2, Issue #138)
+ *
+ * Generates themed agent personas from a universe template.
+ * Each CastMember maps to an agent role with name, personality, and backstory.
+ */
+const USUAL_SUSPECTS = {
+    id: 'usual-suspects',
+    label: 'The Usual Suspects',
+    characters: [
+        {
+            name: 'Keyser',
+            personality: 'Quietly commanding; sees the whole board before anyone else.',
+            backstory: 'A legendary figure who orchestrates from the shadows, ensuring every piece falls into place.',
+            preferredRoles: ['lead'],
+        },
+        {
+            name: 'McManus',
+            personality: 'Bold and direct; ships fast, asks questions later.',
+            backstory: 'The hotshot operator who dives headfirst into the hardest problems.',
+            preferredRoles: ['developer'],
+        },
+        {
+            name: 'Fenster',
+            personality: 'Eccentric communicator; finds bugs nobody else can see.',
+            backstory: 'Speaks in riddles but has an uncanny knack for spotting what everyone else missed.',
+            preferredRoles: ['tester'],
+        },
+        {
+            name: 'Verbal',
+            personality: 'Silver-tongued storyteller; turns complexity into clarity.',
+            backstory: 'The narrator who shapes every prompt and message into something an LLM can\'t misunderstand.',
+            preferredRoles: ['prompt-engineer', 'scribe'],
+        },
+        {
+            name: 'Hockney',
+            personality: 'Street-smart and suspicious; trusts no input.',
+            backstory: 'A seasoned skeptic who probes every surface for weaknesses before anyone else can.',
+            preferredRoles: ['security', 'reviewer'],
+        },
+        {
+            name: 'Redfoot',
+            personality: 'Resourceful fixer; keeps the machinery running.',
+            backstory: 'The behind-the-scenes operator who makes sure builds ship and pipelines stay green.',
+            preferredRoles: ['devops'],
+        },
+        {
+            name: 'Edie',
+            personality: 'Methodical and detail-oriented; nothing escapes review.',
+            backstory: 'A meticulous analyst who ensures every deliverable meets the bar.',
+            preferredRoles: ['reviewer', 'tester'],
+        },
+        {
+            name: 'Kobayashi',
+            personality: 'Precise and formal; an interface between worlds.',
+            backstory: 'The liaison who translates requirements into structured specifications.',
+            preferredRoles: ['designer', 'prompt-engineer'],
+        },
+    ],
+};
+const OCEANS_ELEVEN = {
+    id: 'oceans-eleven',
+    label: "Ocean's Eleven",
+    characters: [
+        {
+            name: 'Danny',
+            personality: 'Cool under pressure; the plan is always three steps ahead.',
+            backstory: 'The mastermind who assembles the crew and keeps the vision on track.',
+            preferredRoles: ['lead'],
+        },
+        {
+            name: 'Rusty',
+            personality: 'Effortlessly sharp; reads people and code with equal ease.',
+            backstory: 'The right hand who can debug a conversation or a stack trace mid-bite.',
+            preferredRoles: ['developer', 'reviewer'],
+        },
+        {
+            name: 'Linus',
+            personality: 'Eager and adaptable; learns fast, ships faster.',
+            backstory: 'The up-and-comer who takes on any coding challenge to prove his worth.',
+            preferredRoles: ['developer'],
+        },
+        {
+            name: 'Basher',
+            personality: 'Explosive creativity; demolishes blockers with flair.',
+            backstory: 'The demolitions expert who clears technical debt and obstacles in one blast.',
+            preferredRoles: ['devops', 'developer'],
+        },
+        {
+            name: 'Livingston',
+            personality: 'Quiet tech wizard; the surveillance and tooling expert.',
+            backstory: 'The electronics specialist who wires up monitoring, logging, and automation.',
+            preferredRoles: ['devops', 'tester'],
+        },
+        {
+            name: 'Saul',
+            personality: 'Old-school wisdom; plays the long game with finesse.',
+            backstory: 'A veteran con artist who crafts the perfect prompt persona for any situation.',
+            preferredRoles: ['prompt-engineer', 'scribe'],
+        },
+        {
+            name: 'Yen',
+            personality: 'Acrobatic precision; navigates tight constraints with grace.',
+            backstory: 'The acrobat who fits into the tightest security gaps and edge cases.',
+            preferredRoles: ['security', 'tester'],
+        },
+        {
+            name: 'Virgil',
+            personality: 'Steadfast and reliable; the backbone of every operation.',
+            backstory: 'Half of the dependable duo that handles the grunt work with quiet excellence.',
+            preferredRoles: ['developer', 'reviewer'],
+        },
+        {
+            name: 'Turk',
+            personality: 'Competitive and driven; races to finish first.',
+            backstory: 'The other half of the duo, always trying to one-up his partner in velocity.',
+            preferredRoles: ['developer', 'designer'],
+        },
+        {
+            name: 'Reuben',
+            personality: 'Strategic backer; knows what\'s worth investing in.',
+            backstory: 'The financier who scopes effort and ensures the plan is economically sound.',
+            preferredRoles: ['lead', 'reviewer'],
+        },
+    ],
+};
+const UNIVERSES = new Map([
+    ['usual-suspects', USUAL_SUSPECTS],
+    ['oceans-eleven', OCEANS_ELEVEN],
+]);
+// --- Casting Engine ---
+export class CastingEngine {
+    /** List available universe IDs. */
+    getUniverses() {
+        return Array.from(UNIVERSES.keys());
+    }
+    /** Get a universe template by ID. */
+    getUniverse(id) {
+        return UNIVERSES.get(id);
+    }
+    /**
+     * Cast a team of agents from a universe.
+     *
+     * Roles are filled by best-fit characters (preferredRoles match).
+     * Required roles are guaranteed to be present.
+     * Team size is clamped to available characters.
+     */
+    castTeam(config) {
+        if (config.universe === 'custom') {
+            return this.castCustomTeam(config);
+        }
+        const template = UNIVERSES.get(config.universe);
+        if (!template) {
+            throw new Error(`Unknown universe: ${config.universe}`);
+        }
+        const requiredRoles = config.requiredRoles ?? ['lead', 'developer', 'tester'];
+        const teamSize = Math.max(requiredRoles.length, Math.min(config.teamSize ?? requiredRoles.length, template.characters.length));
+        const assigned = new Set();
+        const members = [];
+        // Phase 1: Fill required roles by best-fit
+        for (const role of requiredRoles) {
+            const best = this.findBestFit(template.characters, role, assigned);
+            if (!best) {
+                throw new Error(`Cannot fill required role "${role}" — not enough characters in universe "${config.universe}".`);
+            }
+            assigned.add(best.name);
+            members.push(this.toCastMember(best, role));
+        }
+        // Phase 2: Fill remaining slots with unassigned characters
+        if (members.length < teamSize) {
+            const remaining = template.characters.filter((c) => !assigned.has(c.name));
+            for (const char of remaining) {
+                if (members.length >= teamSize)
+                    break;
+                const role = char.preferredRoles[0] ?? 'developer';
+                assigned.add(char.name);
+                members.push(this.toCastMember(char, role));
+            }
+        }
+        return members;
+    }
+    // --- Internals ---
+    castCustomTeam(config) {
+        if (!config.customNames || Object.keys(config.customNames).length === 0) {
+            throw new Error('customNames is required when universe is "custom".');
+        }
+        return Object.entries(config.customNames).map(([role, name]) => ({
+            name,
+            role,
+            personality: 'Custom team member.',
+            backstory: `${name} fills the ${role} role on this squad.`,
+            displayName: `${name} — ${formatRole(role)}`,
+        }));
+    }
+    findBestFit(characters, role, assigned) {
+        // Prefer characters whose first preferred role matches
+        const primary = characters.find((c) => !assigned.has(c.name) && c.preferredRoles[0] === role);
+        if (primary)
+            return primary;
+        // Fall back to any character that lists this role
+        const secondary = characters.find((c) => !assigned.has(c.name) && c.preferredRoles.includes(role));
+        if (secondary)
+            return secondary;
+        // Last resort: any unassigned character
+        return characters.find((c) => !assigned.has(c.name));
+    }
+    toCastMember(char, role) {
+        return {
+            name: char.name,
+            role,
+            personality: char.personality,
+            backstory: char.backstory,
+            displayName: `${char.name} — ${formatRole(role)}`,
+        };
+    }
+}
+function formatRole(role) {
+    return role
+        .split('-')
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=casting-engine.js.map

package/dist/casting/casting-engine.js.map

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

package/dist/casting/casting-history.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Casting History (M3-10, Issue #151)
+ *
+ * Tracks casting decisions over time and makes them queryable.
+ * Each record captures who was cast, when, and from which config.
+ */
+import type { CastMember, CastingConfig, UniverseId, AgentRole } from './casting-engine.js';
+export interface CastingRecordMember {
+    name: string;
+    role: AgentRole;
+}
+export interface CastingRecord {
+    /** When this cast was created */
+    timestamp: string;
+    /** Universe used for casting */
+    universe: UniverseId;
+    /** Number of agents cast */
+    teamSize: number;
+    /** Summary of each member */
+    members: CastingRecordMember[];
+    /** Snapshot of the config used */
+    configSnapshot: CastingConfig;
+}
+export interface SerializedCastingHistory {
+    version: 1;
+    records: CastingRecord[];
+}
+export declare class CastingHistory {
+    private records;
+    /**
+     * Record a casting decision.
+     *
+     * @param team - The cast team produced by CastingEngine
+     * @param config - The CastingConfig that produced this team
+     * @param timestamp - Optional override (defaults to now)
+     */
+    recordCast(team: CastMember[], config: CastingConfig, timestamp?: Date): CastingRecord;
+    /** Return all casting records, oldest first. */
+    getCastHistory(): CastingRecord[];
+    /**
+     * Return casting records that include a specific agent name.
+     * Useful for answering "when was Verbal last cast?"
+     */
+    getAgentHistory(agentName: string): CastingRecord[];
+    /** Number of recorded casts. */
+    get size(): number;
+    /** Clear all history. */
+    clear(): void;
+    /** Serialize history to a plain object suitable for JSON / config persistence. */
+    serializeHistory(): SerializedCastingHistory;
+    /** Restore history from a previously serialized object. Replaces current records. */
+    deserializeHistory(data: SerializedCastingHistory): void;
+}
+//# sourceMappingURL=casting-history.d.ts.map

package/dist/casting/casting-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"casting-history.d.ts","sourceRoot":"","sources":["../../src/casting/casting-history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAI5F,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,QAAQ,EAAE,UAAU,CAAC;IACrB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,kCAAkC;IAClC,cAAc,EAAE,aAAa,CAAC;CAC/B;AAID,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAuB;IAEtC;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,IAAI,GAAG,aAAa;IAYtF,gDAAgD;IAChD,cAAc,IAAI,aAAa,EAAE;IAIjC;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE;IAMnD,gCAAgC;IAChC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yBAAyB;IACzB,KAAK,IAAI,IAAI;IAMb,kFAAkF;IAClF,gBAAgB,IAAI,wBAAwB;IAO5C,qFAAqF;IACrF,kBAAkB,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI;CAMzD"}

package/dist/casting/casting-history.js

@@ -0,0 +1,63 @@
+/**
+ * Casting History (M3-10, Issue #151)
+ *
+ * Tracks casting decisions over time and makes them queryable.
+ * Each record captures who was cast, when, and from which config.
+ */
+// --- CastingHistory ---
+export class CastingHistory {
+    records = [];
+    /**
+     * Record a casting decision.
+     *
+     * @param team - The cast team produced by CastingEngine
+     * @param config - The CastingConfig that produced this team
+     * @param timestamp - Optional override (defaults to now)
+     */
+    recordCast(team, config, timestamp) {
+        const record = {
+            timestamp: (timestamp ?? new Date()).toISOString(),
+            universe: config.universe,
+            teamSize: team.length,
+            members: team.map((m) => ({ name: m.name, role: m.role })),
+            configSnapshot: { ...config },
+        };
+        this.records.push(record);
+        return record;
+    }
+    /** Return all casting records, oldest first. */
+    getCastHistory() {
+        return [...this.records];
+    }
+    /**
+     * Return casting records that include a specific agent name.
+     * Useful for answering "when was Verbal last cast?"
+     */
+    getAgentHistory(agentName) {
+        return this.records.filter((r) => r.members.some((m) => m.name === agentName));
+    }
+    /** Number of recorded casts. */
+    get size() {
+        return this.records.length;
+    }
+    /** Clear all history. */
+    clear() {
+        this.records = [];
+    }
+    // --- Serialization for config round-trip ---
+    /** Serialize history to a plain object suitable for JSON / config persistence. */
+    serializeHistory() {
+        return {
+            version: 1,
+            records: this.records.map((r) => ({ ...r })),
+        };
+    }
+    /** Restore history from a previously serialized object. Replaces current records. */
+    deserializeHistory(data) {
+        if (!data || data.version !== 1 || !Array.isArray(data.records)) {
+            throw new Error('Invalid casting history data: expected version 1 with records array');
+        }
+        this.records = data.records.map((r) => ({ ...r }));
+    }
+}
+//# sourceMappingURL=casting-history.js.map

package/dist/casting/casting-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"casting-history.js","sourceRoot":"","sources":["../../src/casting/casting-history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH,yBAAyB;AAEzB,MAAM,OAAO,cAAc;IACjB,OAAO,GAAoB,EAAE,CAAC;IAEtC;;;;;;OAMG;IACH,UAAU,CAAC,IAAkB,EAAE,MAAqB,EAAE,SAAgB;QACpE,MAAM,MAAM,GAAkB;YAC5B,SAAS,EAAE,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;YAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,IAAI,CAAC,MAAM;YACrB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,cAAc,EAAE,EAAE,GAAG,MAAM,EAAE;SAC9B,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,gDAAgD;IAChD,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,SAAiB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAC5C,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,yBAAyB;IACzB,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,8CAA8C;IAE9C,kFAAkF;IAClF,gBAAgB;QACd,OAAO;YACL,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;SAC7C,CAAC;IACJ,CAAC;IAED,qFAAqF;IACrF,kBAAkB,CAAC,IAA8B;QAC/C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/casting/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Casting System (PRD 11 + M3-2)
+ *
+ * Runtime casting engine that generates agent personas from universe themes.
+ * Typed config replaces static markdown definitions.
+ *
+ * v1 API (M3-2):  CastingEngine.castTeam(config) → CastMember[]
+ * Legacy API:     CastingRegistry (filesystem-backed, stub)
+ */
+export { CastingEngine, type CastMember, type CastingConfig, type AgentRole, type UniverseId, } from './casting-engine.js';
+export { CastingHistory, type CastingRecord, type CastingRecordMember, type SerializedCastingHistory, } from './casting-history.js';
+export interface CastingUniverse {
+    /** Universe name (e.g., 'The Wire', 'Seinfeld') */
+    name: string;
+    /** Available character names */
+    characters: string[];
+    /** Universe-specific constraints */
+    constraints?: string[];
+}
+export interface CastingEntry {
+    /** Agent role name (e.g., 'core-dev', 'lead') */
+    role: string;
+    /** Cast character name */
+    characterName: string;
+    /** Universe the character is from */
+    universe: string;
+    /** Display name (e.g., 'Fenster — Core Dev') */
+    displayName: string;
+}
+export interface CastingRegistryConfig {
+    /** Path to .squad/casting/ directory */
+    castingDir: string;
+    /** Active universe name */
+    activeUniverse?: string;
+}
+export declare class CastingRegistry {
+    private entries;
+    private config;
+    constructor(config: CastingRegistryConfig);
+    load(): Promise<void>;
+    getByRole(role: string): CastingEntry | undefined;
+    getAllEntries(): CastingEntry[];
+    cast(role: string, _universe?: string): Promise<CastingEntry>;
+    recast(_universe: string): Promise<CastingEntry[]>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/casting/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,EAAE,qBAAqB;IAInC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIjD,aAAa,IAAI,YAAY,EAAE;IAIzB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI7D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAGzD"}

package/dist/casting/index.js

@@ -0,0 +1,37 @@
+/**
+ * Casting System (PRD 11 + M3-2)
+ *
+ * Runtime casting engine that generates agent personas from universe themes.
+ * Typed config replaces static markdown definitions.
+ *
+ * v1 API (M3-2):  CastingEngine.castTeam(config) → CastMember[]
+ * Legacy API:     CastingRegistry (filesystem-backed, stub)
+ */
+// Re-export v1 casting engine (M3-2)
+export { CastingEngine, } from './casting-engine.js';
+// Re-export casting history (M3-10)
+export { CastingHistory, } from './casting-history.js';
+// --- Legacy Casting Registry ---
+export class CastingRegistry {
+    entries = new Map();
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async load() {
+        // TODO: PRD 11 — Parse registry.json into entries map
+    }
+    getByRole(role) {
+        return this.entries.get(role);
+    }
+    getAllEntries() {
+        return Array.from(this.entries.values());
+    }
+    async cast(role, _universe) {
+        throw new Error('Not implemented');
+    }
+    async recast(_universe) {
+        throw new Error('Not implemented');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/casting/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/casting/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,qCAAqC;AACrC,OAAO,EACL,aAAa,GAKd,MAAM,qBAAqB,CAAC;AAE7B,oCAAoC;AACpC,OAAO,EACL,cAAc,GAIf,MAAM,sBAAsB,CAAC;AA+B9B,kCAAkC;AAElC,MAAM,OAAO,eAAe;IAClB,OAAO,GAA8B,IAAI,GAAG,EAAE,CAAC;IAC/C,MAAM,CAAwB;IAEtC,YAAY,MAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,sDAAsD;IACxD,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,SAAkB;QACzC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/client/event-bus.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cross-Session Event Bus (PRD 1)
+ *
+ * Pub/sub event bus for session lifecycle events. Enables the coordinator
+ * to observe all agent sessions from a single subscription point.
+ * Decouples event producers (sessions) from consumers (coordinator, Ralph, UI).
+ */
+export type SquadEventType = 'session.created' | 'session.destroyed' | 'session.status_changed' | 'session.message' | 'session.tool_call' | 'session.error' | 'agent.milestone' | 'coordinator.routing' | 'pool.health';
+export interface SquadEvent {
+    type: SquadEventType;
+    sessionId?: string;
+    agentName?: string;
+    payload: unknown;
+    timestamp: Date;
+}
+export type EventHandler = (event: SquadEvent) => void | Promise<void>;
+export declare class EventBus {
+    private handlers;
+    private allHandlers;
+    /** Subscribe to a specific event type */
+    on(type: SquadEventType, handler: EventHandler): () => void;
+    /** Subscribe to all events */
+    onAny(handler: EventHandler): () => void;
+    /** Emit an event to all matching subscribers */
+    emit(event: SquadEvent): Promise<void>;
+    /** Remove all handlers */
+    clear(): void;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/client/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/client/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,mBAAmB,GACnB,wBAAwB,GACxB,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,GACf,iBAAiB,GACjB,qBAAqB,GACrB,aAAa,CAAC;AAElB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAIvE,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAqD;IACrE,OAAO,CAAC,WAAW,CAAgC;IAEnD,yCAAyC;IACzC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAY3D,8BAA8B;IAC9B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAOxC,gDAAgD;IAC1C,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB5C,0BAA0B;IAC1B,KAAK,IAAI,IAAI;CAId"}

package/dist/client/event-bus.js

@@ -0,0 +1,53 @@
+/**
+ * Cross-Session Event Bus (PRD 1)
+ *
+ * Pub/sub event bus for session lifecycle events. Enables the coordinator
+ * to observe all agent sessions from a single subscription point.
+ * Decouples event producers (sessions) from consumers (coordinator, Ralph, UI).
+ */
+// --- Event Bus ---
+export class EventBus {
+    handlers = new Map();
+    allHandlers = new Set();
+    /** Subscribe to a specific event type */
+    on(type, handler) {
+        if (!this.handlers.has(type)) {
+            this.handlers.set(type, new Set());
+        }
+        this.handlers.get(type).add(handler);
+        // Return unsubscribe function
+        return () => {
+            this.handlers.get(type)?.delete(handler);
+        };
+    }
+    /** Subscribe to all events */
+    onAny(handler) {
+        this.allHandlers.add(handler);
+        return () => {
+            this.allHandlers.delete(handler);
+        };
+    }
+    /** Emit an event to all matching subscribers */
+    async emit(event) {
+        const typeHandlers = this.handlers.get(event.type) ?? new Set();
+        const allPromises = [];
+        for (const handler of typeHandlers) {
+            const result = handler(event);
+            if (result instanceof Promise)
+                allPromises.push(result);
+        }
+        for (const handler of this.allHandlers) {
+            const result = handler(event);
+            if (result instanceof Promise)
+                allPromises.push(result);
+        }
+        // TODO: PRD 1 — Add error isolation (one handler failure shouldn't crash others)
+        await Promise.all(allPromises);
+    }
+    /** Remove all handlers */
+    clear() {
+        this.handlers.clear();
+        this.allHandlers.clear();
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/client/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/client/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,oBAAoB;AAEpB,MAAM,OAAO,QAAQ;IACX,QAAQ,GAA2C,IAAI,GAAG,EAAE,CAAC;IAC7D,WAAW,GAAsB,IAAI,GAAG,EAAE,CAAC;IAEnD,yCAAyC;IACzC,EAAE,CAAC,IAAoB,EAAE,OAAqB;QAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEtC,8BAA8B;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,KAAK,CAAC,OAAqB;QACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,IAAI,CAAC,KAAiB;QAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAChE,MAAM,WAAW,GAAoB,EAAE,CAAC;QAExC,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,MAAM,YAAY,OAAO;gBAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,MAAM,YAAY,OAAO;gBAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;QAED,iFAAiF;QACjF,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAED,0BAA0B;IAC1B,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/client/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Squad Client — High-Level API with Session Pool Management (PRD 1)
+ *
+ * This module provides the main Squad client API that combines:
+ * - SquadClient adapter (from adapter/client.ts) for connection management
+ * - SessionPool for multi-session lifecycle management
+ * - EventBus for cross-session event handling
+ *
+ * Applications should import from this module, not from adapter/ directly.
+ */
+export { SquadClient, type SquadClientOptions, type SquadConnectionState, } from '../adapter/client.js';
+export type { SquadSession, SquadSessionConfig, SquadSessionMetadata, SquadGetStatusResponse, SquadGetAuthStatusResponse, SquadModelInfo, } from '../adapter/types.js';
+export type SessionStatus = 'creating' | 'active' | 'idle' | 'error' | 'destroyed';
+export { SessionPool, type SessionPoolConfig, type PoolEvent, DEFAULT_POOL_CONFIG } from './session-pool.js';
+export { EventBus, type SquadEvent, type SquadEventType } from './event-bus.js';
+import { type SquadClientOptions } from '../adapter/client.js';
+import type { SquadSession, SquadSessionConfig } from '../adapter/types.js';
+import { SessionPool, type SessionPoolConfig } from './session-pool.js';
+import { EventBus } from './event-bus.js';
+export interface SquadClientWithPoolConfig extends SquadClientOptions {
+    /** Session pool configuration */
+    pool?: Partial<SessionPoolConfig>;
+}
+/**
+ * Squad Client with integrated session pool management.
+ *
+ * This is the recommended client for applications that need to manage
+ * multiple concurrent agent sessions. It provides:
+ * - Connection lifecycle management (from SquadClient)
+ * - Session pool with capacity limits and health checks
+ * - Event bus for cross-session event handling
+ *
+ * @example
+ * ```typescript
+ * const client = new SquadClientWithPool({
+ *   pool: { maxConcurrent: 5 }
+ * });
+ *
+ * await client.connect();
+ *
+ * const session1 = await client.createSession({ model: 'claude-sonnet-4.5' });
+ * const session2 = await client.createSession({ model: 'claude-haiku-4.5' });
+ *
+ * client.eventBus.on('session.created', (event) => {
+ *   console.log('New session:', event.sessionId);
+ * });
+ *
+ * await client.shutdown();
+ * ```
+ */
+export declare class SquadClientWithPool {
+    private baseClient;
+    readonly pool: SessionPool;
+    readonly eventBus: EventBus;
+    constructor(config?: SquadClientWithPoolConfig);
+    /** Connect to the Copilot CLI server */
+    connect(): Promise<void>;
+    /** Disconnect from the Copilot CLI server */
+    disconnect(): Promise<Error[]>;
+    /** Force disconnect without graceful cleanup */
+    forceDisconnect(): Promise<void>;
+    /** Get current connection state */
+    getState(): import("../adapter/client.js").SquadConnectionState;
+    /** Check if connected */
+    isConnected(): boolean;
+    /**
+     * Create a new session and add it to the pool.
+     * Throws if the pool is at capacity.
+     */
+    createSession(config?: SquadSessionConfig): Promise<SquadSession>;
+    /**
+     * Resume an existing session and add it to the pool if not present.
+     */
+    resumeSession(sessionId: string, config?: SquadSessionConfig): Promise<SquadSession>;
+    /**
+     * Delete a session and remove it from the pool.
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /** List all sessions from the base client */
+    listSessions(): Promise<import("../adapter/types.js").SquadSessionMetadata[]>;
+    /** Send a ping to verify connectivity */
+    ping(message?: string): Promise<{
+        message: string;
+        timestamp: number;
+        protocolVersion?: number;
+    }>;
+    /** Get CLI status information */
+    getStatus(): Promise<import("../adapter/types.js").SquadGetStatusResponse>;
+    /** Get authentication status */
+    getAuthStatus(): Promise<import("../adapter/types.js").SquadGetAuthStatusResponse>;
+    /** List available models */
+    listModels(): Promise<import("../adapter/types.js").SquadModelInfo[]>;
+    /** Subscribe to session lifecycle events */
+    on(eventType: any, handler: any): () => void;
+    /**
+     * Graceful shutdown — destroy all sessions and disconnect.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAGnF,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7G,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhF,OAAO,EAAkC,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,iCAAiC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,UAAU,CAAkB;IACpC,SAAgB,IAAI,EAAE,WAAW,CAAC;IAClC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;gBAEvB,MAAM,GAAE,yBAA8B;IAgBlD,wCAAwC;IAClC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,6CAA6C;IACvC,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAKpC,gDAAgD;IAC1C,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtC,mCAAmC;IACnC,QAAQ;IAIR,yBAAyB;IACzB,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACG,aAAa,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAuB3E;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAgB9F;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrD,6CAA6C;IACvC,YAAY;IAIlB,yCAAyC;IACnC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM;;;;;IAI3B,iCAAiC;IAC3B,SAAS;IAIf,gCAAgC;IAC1B,aAAa;IAInB,4BAA4B;IACtB,UAAU;IAIhB,4CAA4C;IAC5C,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG;IAI/B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}