@bradygaster/squad-cli 0.6.2 → 0.8.0

package/dist/cli/shell/memory.js

@@ -0,0 +1,53 @@
+/**
+ * Memory management for shell sessions.
+ * Enforces buffer limits and handles cleanup.
+ */
+export const DEFAULT_LIMITS = {
+    maxMessages: 1000,
+    maxStreamBuffer: 1024 * 1024, // 1MB
+    maxSessions: 10,
+    sessionIdleTimeout: 5 * 60 * 1000, // 5 minutes
+};
+export class MemoryManager {
+    limits;
+    bufferSizes = new Map();
+    constructor(limits = {}) {
+        this.limits = { ...DEFAULT_LIMITS, ...limits };
+    }
+    /** Check if a new session can be created */
+    canCreateSession(currentCount) {
+        return currentCount < this.limits.maxSessions;
+    }
+    /** Track buffer growth, return true if within limits */
+    trackBuffer(sessionId, additionalBytes) {
+        const current = this.bufferSizes.get(sessionId) ?? 0;
+        const newSize = current + additionalBytes;
+        if (newSize > this.limits.maxStreamBuffer) {
+            return false; // would exceed limit
+        }
+        this.bufferSizes.set(sessionId, newSize);
+        return true;
+    }
+    /** Trim message history to limit */
+    trimMessages(messages) {
+        if (messages.length <= this.limits.maxMessages)
+            return messages;
+        return messages.slice(-this.limits.maxMessages);
+    }
+    /** Clear buffer tracking for a session */
+    clearBuffer(sessionId) {
+        this.bufferSizes.delete(sessionId);
+    }
+    /** Get current memory stats */
+    getStats() {
+        let total = 0;
+        for (const size of this.bufferSizes.values())
+            total += size;
+        return { sessions: this.bufferSizes.size, totalBufferBytes: total };
+    }
+    /** Get configured limits */
+    getLimits() {
+        return { ...this.limits };
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/cli/shell/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/cli/shell/memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,WAAW,EAAE,IAAI;IACjB,eAAe,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM;IACpC,WAAW,EAAE,EAAE;IACf,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;CAChD,CAAC;AAEF,MAAM,OAAO,aAAa;IAChB,MAAM,CAAe;IACrB,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEhD,YAAY,SAAgC,EAAE;QAC5C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED,4CAA4C;IAC5C,gBAAgB,CAAC,YAAoB;QACnC,OAAO,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;IAChD,CAAC;IAED,wDAAwD;IACxD,WAAW,CAAC,SAAiB,EAAE,eAAuB;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,OAAO,GAAG,eAAe,CAAC;QAC1C,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC,CAAC,qBAAqB;QACrC,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oCAAoC;IACpC,YAAY,CAAI,QAAa;QAC3B,IAAI,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,QAAQ,CAAC;QAChE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAED,0CAA0C;IAC1C,WAAW,CAAC,SAAiB;QAC3B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,+BAA+B;IAC/B,QAAQ;QACN,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE;YAAE,KAAK,IAAI,IAAI,CAAC;QAC5D,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;IACtE,CAAC;IAED,4BAA4B;IAC5B,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/cli/shell/render.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Console-based shell renderer.
+ *
+ * Renders agent output to the terminal using plain stdout writes.
+ * This is the pre-ink renderer — will be replaced with ink components later.
+ *
+ * @module cli/shell/render
+ */
+export declare class ShellRenderer {
+    private currentAgent;
+    /** Print a content delta (streaming chunk). */
+    renderDelta(agentName: string, content: string): void;
+    /** Print a complete message. */
+    renderMessage(role: string, name: string | undefined, content: string): void;
+    /** Print a system message. */
+    renderSystem(message: string): void;
+    /** Print an error. */
+    renderError(agentName: string, error: string): void;
+    /** Print usage stats. */
+    renderUsage(model: string, inputTokens: number, outputTokens: number, cost: number): void;
+}
+//# sourceMappingURL=render.d.ts.map

package/dist/cli/shell/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/cli/shell/render.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAuB;IAE3C,+CAA+C;IAC/C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IASrD,gCAAgC;IAChC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAM5E,8BAA8B;IAC9B,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKnC,sBAAsB;IACtB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKnD,yBAAyB;IACzB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAK1F"}

package/dist/cli/shell/render.js

@@ -0,0 +1,44 @@
+/**
+ * Console-based shell renderer.
+ *
+ * Renders agent output to the terminal using plain stdout writes.
+ * This is the pre-ink renderer — will be replaced with ink components later.
+ *
+ * @module cli/shell/render
+ */
+export class ShellRenderer {
+    currentAgent = null;
+    /** Print a content delta (streaming chunk). */
+    renderDelta(agentName, content) {
+        if (this.currentAgent !== agentName) {
+            if (this.currentAgent)
+                process.stdout.write('\n');
+            process.stdout.write(`\n${agentName}: `);
+            this.currentAgent = agentName;
+        }
+        process.stdout.write(content);
+    }
+    /** Print a complete message. */
+    renderMessage(role, name, content) {
+        const prefix = name ? `${name}` : role;
+        console.log(`\n${prefix}: ${content}`);
+        this.currentAgent = null;
+    }
+    /** Print a system message. */
+    renderSystem(message) {
+        console.log(`\n💡 ${message}`);
+        this.currentAgent = null;
+    }
+    /** Print an error. */
+    renderError(agentName, error) {
+        console.error(`\n❌ ${agentName}: ${error}`);
+        this.currentAgent = null;
+    }
+    /** Print usage stats. */
+    renderUsage(model, inputTokens, outputTokens, cost) {
+        if (cost > 0) {
+            console.log(`  📊 ${model}: ${inputTokens}+${outputTokens} tokens ($${cost.toFixed(4)})`);
+        }
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/cli/shell/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/cli/shell/render.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,OAAO,aAAa;IAChB,YAAY,GAAkB,IAAI,CAAC;IAE3C,+CAA+C;IAC/C,WAAW,CAAC,SAAiB,EAAE,OAAe;QAC5C,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,YAAY;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAChC,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,gCAAgC;IAChC,aAAa,CAAC,IAAY,EAAE,IAAwB,EAAE,OAAe;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,8BAA8B;IAC9B,YAAY,CAAC,OAAe;QAC1B,OAAO,CAAC,GAAG,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,sBAAsB;IACtB,WAAW,CAAC,SAAiB,EAAE,KAAa;QAC1C,OAAO,CAAC,KAAK,CAAC,OAAO,SAAS,KAAK,KAAK,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,yBAAyB;IACzB,WAAW,CAAC,KAAa,EAAE,WAAmB,EAAE,YAAoB,EAAE,IAAY;QAChF,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,KAAK,WAAW,IAAI,YAAY,aAAa,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;CACF"}

package/dist/cli/shell/router.d.ts

@@ -0,0 +1,17 @@
+export type MessageType = 'slash_command' | 'direct_agent' | 'coordinator';
+export interface ParsedInput {
+    type: MessageType;
+    raw: string;
+    command?: string;
+    args?: string[];
+    agentName?: string;
+    content?: string;
+}
+/**
+ * Parse user input to determine routing.
+ * - /command → slash command
+ * - @AgentName message → direct to agent
+ * - anything else → coordinator
+ */
+export declare function parseInput(input: string, knownAgents: string[]): ParsedInput;
+//# sourceMappingURL=router.d.ts.map

package/dist/cli/shell/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/cli/shell/router.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,CAAC;AAE3E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,WAAW,CAmD5E"}

package/dist/cli/shell/router.js

@@ -0,0 +1,55 @@
+/**
+ * Parse user input to determine routing.
+ * - /command → slash command
+ * - @AgentName message → direct to agent
+ * - anything else → coordinator
+ */
+export function parseInput(input, knownAgents) {
+    const trimmed = input.trim();
+    // Slash commands
+    if (trimmed.startsWith('/')) {
+        const parts = trimmed.slice(1).split(/\s+/);
+        return {
+            type: 'slash_command',
+            raw: trimmed,
+            command: parts[0].toLowerCase(),
+            args: parts.slice(1),
+        };
+    }
+    // @Agent direct addressing
+    const atMatch = trimmed.match(/^@(\w+)\s*(.*)/s);
+    if (atMatch) {
+        const name = atMatch[1];
+        // Case-insensitive match against known agents
+        const match = knownAgents.find(a => a.toLowerCase() === name.toLowerCase());
+        if (match) {
+            return {
+                type: 'direct_agent',
+                raw: trimmed,
+                agentName: match,
+                content: atMatch[2].trim() || undefined,
+            };
+        }
+    }
+    // Also support "AgentName, do something" syntax
+    const commaMatch = trimmed.match(/^(\w+),\s*(.*)/s);
+    if (commaMatch) {
+        const name = commaMatch[1];
+        const match = knownAgents.find(a => a.toLowerCase() === name.toLowerCase());
+        if (match) {
+            return {
+                type: 'direct_agent',
+                raw: trimmed,
+                agentName: match,
+                content: commaMatch[2].trim() || undefined,
+            };
+        }
+    }
+    // Default: route to coordinator
+    return {
+        type: 'coordinator',
+        raw: trimmed,
+        content: trimmed,
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/cli/shell/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/cli/shell/router.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,WAAqB;IAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,iBAAiB;IACjB,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5C,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,GAAG,EAAE,OAAO;YACZ,OAAO,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE;YAChC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;SACrB,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACjD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QACzB,8CAA8C;QAC9C,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5E,IAAI,KAAK,EAAE,CAAC;YACV,OAAO;gBACL,IAAI,EAAE,cAAc;gBACpB,GAAG,EAAE,OAAO;gBACZ,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,IAAI,SAAS;aACzC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACpD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5E,IAAI,KAAK,EAAE,CAAC;YACV,OAAO;gBACL,IAAI,EAAE,cAAc;gBACpB,GAAG,EAAE,OAAO;gBACZ,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,IAAI,SAAS;aAC5C,CAAC;QACJ,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,GAAG,EAAE,OAAO;QACZ,OAAO,EAAE,OAAO;KACjB,CAAC;AACJ,CAAC"}

package/dist/cli/shell/sessions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Session registry — tracks active agent sessions within the interactive shell.
+ */
+import { AgentSession } from './types.js';
+export declare class SessionRegistry {
+    private sessions;
+    register(name: string, role: string): AgentSession;
+    get(name: string): AgentSession | undefined;
+    getAll(): AgentSession[];
+    getActive(): AgentSession[];
+    updateStatus(name: string, status: AgentSession['status']): void;
+    remove(name: string): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=sessions.d.ts.map

package/dist/cli/shell/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/cli/shell/sessions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAmC;IAEnD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY;IAWlD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI3C,MAAM,IAAI,YAAY,EAAE;IAIxB,SAAS,IAAI,YAAY,EAAE;IAI3B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,IAAI;IAKhE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,KAAK,IAAI,IAAI;CAGd"}

package/dist/cli/shell/sessions.js

@@ -0,0 +1,37 @@
+/**
+ * Session registry — tracks active agent sessions within the interactive shell.
+ */
+export class SessionRegistry {
+    sessions = new Map();
+    register(name, role) {
+        const session = {
+            name,
+            role,
+            status: 'idle',
+            startedAt: new Date(),
+        };
+        this.sessions.set(name, session);
+        return session;
+    }
+    get(name) {
+        return this.sessions.get(name);
+    }
+    getAll() {
+        return Array.from(this.sessions.values());
+    }
+    getActive() {
+        return this.getAll().filter(s => s.status === 'working' || s.status === 'streaming');
+    }
+    updateStatus(name, status) {
+        const session = this.sessions.get(name);
+        if (session)
+            session.status = status;
+    }
+    remove(name) {
+        return this.sessions.delete(name);
+    }
+    clear() {
+        this.sessions.clear();
+    }
+}
+//# sourceMappingURL=sessions.js.map

package/dist/cli/shell/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../../src/cli/shell/sessions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,OAAO,eAAe;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEnD,QAAQ,CAAC,IAAY,EAAE,IAAY;QACjC,MAAM,OAAO,GAAiB;YAC5B,IAAI;YACJ,IAAI;YACJ,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;IACvF,CAAC;IAED,YAAY,CAAC,IAAY,EAAE,MAA8B;QACvD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,OAAO;YAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/cli/shell/spawn.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Agent spawning — loads charters, builds prompts, and manages spawn lifecycle.
+ *
+ * Full SDK session integration is stubbed pending CopilotClient session API wiring.
+ */
+import { SessionRegistry } from './sessions.js';
+export interface SpawnOptions {
+    /** Wait for completion (sync) or fire-and-track (background) */
+    mode: 'sync' | 'background';
+    /** Additional system prompt context */
+    systemContext?: string;
+    /** Tool definitions to register */
+    tools?: ToolDefinition[];
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export interface SpawnResult {
+    agentName: string;
+    status: 'completed' | 'streaming' | 'error';
+    response?: string;
+    error?: string;
+}
+/**
+ * Load agent charter from .squad/agents/{name}/charter.md
+ */
+export declare function loadAgentCharter(agentName: string, teamRoot?: string): string;
+/**
+ * Build system prompt for an agent from their charter + optional context
+ */
+export declare function buildAgentPrompt(charter: string, options?: {
+    systemContext?: string;
+}): string;
+/**
+ * Spawn an agent session.
+ * In this initial version, this is a stub that:
+ * 1. Loads the agent's charter
+ * 2. Registers the session in the registry
+ * 3. Returns a SpawnResult
+ *
+ * Full SDK session integration comes in a follow-up when the CopilotClient
+ * session API is wired in.
+ */
+export declare function spawnAgent(name: string, task: string, registry: SessionRegistry, options?: SpawnOptions): Promise<SpawnResult>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/cli/shell/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/cli/shell/spawn.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKhD,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IAC5B,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAW7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAM9F;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,YAA+B,GACvC,OAAO,CAAC,WAAW,CAAC,CAoCtB"}

package/dist/cli/shell/spawn.js

@@ -0,0 +1,77 @@
+/**
+ * Agent spawning — loads charters, builds prompts, and manages spawn lifecycle.
+ *
+ * Full SDK session integration is stubbed pending CopilotClient session API wiring.
+ */
+import { resolveSquad } from '@bradygaster/squad-sdk/resolution';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Load agent charter from .squad/agents/{name}/charter.md
+ */
+export function loadAgentCharter(agentName, teamRoot) {
+    const squadDir = teamRoot ? join(teamRoot, '.squad') : resolveSquad();
+    if (!squadDir) {
+        throw new Error('No .squad/ directory found. Run "squad init" first.');
+    }
+    const charterPath = join(squadDir, 'agents', agentName.toLowerCase(), 'charter.md');
+    try {
+        return readFileSync(charterPath, 'utf-8');
+    }
+    catch {
+        throw new Error(`Charter not found for agent "${agentName}" at ${charterPath}`);
+    }
+}
+/**
+ * Build system prompt for an agent from their charter + optional context
+ */
+export function buildAgentPrompt(charter, options) {
+    let prompt = `You are an AI agent on a software development team.\n\nYOUR CHARTER:\n${charter}`;
+    if (options?.systemContext) {
+        prompt += `\n\nADDITIONAL CONTEXT:\n${options.systemContext}`;
+    }
+    return prompt;
+}
+/**
+ * Spawn an agent session.
+ * In this initial version, this is a stub that:
+ * 1. Loads the agent's charter
+ * 2. Registers the session in the registry
+ * 3. Returns a SpawnResult
+ *
+ * Full SDK session integration comes in a follow-up when the CopilotClient
+ * session API is wired in.
+ */
+export async function spawnAgent(name, task, registry, options = { mode: 'sync' }) {
+    // Load charter
+    const charter = loadAgentCharter(name);
+    // Register in session registry
+    // Read role from charter (first line after "# Name — Role")
+    const roleMatch = charter.match(/^#\s+\w+\s+—\s+(.+)$/m);
+    const role = roleMatch?.[1] ?? 'Agent';
+    registry.register(name, role);
+    registry.updateStatus(name, 'working');
+    try {
+        // Build prompt
+        const _systemPrompt = buildAgentPrompt(charter, { systemContext: options.systemContext });
+        // TODO: Wire to CopilotClient session API
+        // For now, return a stub result indicating the spawn infrastructure is ready
+        // but actual LLM session creation requires the SDK session management
+        const result = {
+            agentName: name,
+            status: 'completed',
+            response: `[Agent ${name} spawn infrastructure ready — SDK session wiring pending]`,
+        };
+        registry.updateStatus(name, 'idle');
+        return result;
+    }
+    catch (error) {
+        registry.updateStatus(name, 'error');
+        return {
+            agentName: name,
+            status: 'error',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=spawn.js.map

package/dist/cli/shell/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../src/cli/shell/spawn.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAwBjC;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,QAAiB;IACnE,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;IACtE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC,CAAC;IACpF,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,gCAAgC,SAAS,QAAQ,WAAW,EAAE,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAoC;IACpF,IAAI,MAAM,GAAG,yEAAyE,OAAO,EAAE,CAAC;IAChG,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,4BAA4B,OAAO,CAAC,aAAa,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,IAAY,EACZ,QAAyB,EACzB,UAAwB,EAAE,IAAI,EAAE,MAAM,EAAE;IAExC,eAAe;IACf,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEvC,+BAA+B;IAC/B,4DAA4D;IAC5D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IAEvC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAEvC,IAAI,CAAC;QACH,eAAe;QACf,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;QAE1F,0CAA0C;QAC1C,6EAA6E;QAC7E,sEAAsE;QAEtE,MAAM,MAAM,GAAgB;YAC1B,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,UAAU,IAAI,2DAA2D;SACpF,CAAC;QAEF,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO;YACL,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/cli/shell/stream-bridge.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Stream Bridge — connects StreamingPipeline events to shell rendering callbacks.
+ *
+ * Accumulates content deltas into complete messages and dispatches
+ * to the shell's render loop via simple callbacks.
+ *
+ * @module cli/shell/stream-bridge
+ */
+import type { StreamingEvent } from '@bradygaster/squad-sdk/runtime/streaming';
+import type { SessionRegistry } from './sessions.js';
+import type { ShellMessage } from './types.js';
+export interface StreamBridgeOptions {
+    /** Callback when new content arrives (for render updates) */
+    onContent: (agentName: string, content: string) => void;
+    /** Callback when a message is complete */
+    onComplete: (message: ShellMessage) => void;
+    /** Callback for usage/cost data */
+    onUsage?: (usage: {
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        cost: number;
+    }) => void;
+    /** Callback for reasoning content */
+    onReasoning?: (agentName: string, content: string) => void;
+    /** Callback for errors */
+    onError?: (agentName: string, error: Error) => void;
+}
+/**
+ * Bridges the StreamingPipeline events to shell rendering callbacks.
+ * Accumulates content deltas into complete messages.
+ */
+export declare class StreamBridge {
+    private buffers;
+    private readonly options;
+    private readonly registry;
+    constructor(registry: SessionRegistry, options: StreamBridgeOptions);
+    /**
+     * Process a streaming event from the pipeline.
+     * Dispatches to the correct callback based on event type.
+     */
+    handleEvent(event: StreamingEvent): void;
+    /**
+     * Finalize the buffer for a session, emitting a complete ShellMessage.
+     * Call this when a stream ends (e.g. after the SDK signals completion).
+     */
+    flush(sessionId: string): void;
+    /**
+     * Get the current buffer content for a session (for partial renders).
+     */
+    getBuffer(sessionId: string): string;
+    /**
+     * Clear all buffers (on session end).
+     */
+    clear(): void;
+    private handleDelta;
+    private handleUsage;
+    private handleReasoning;
+}
+//# sourceMappingURL=stream-bridge.d.ts.map

package/dist/cli/shell/stream-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-bridge.d.ts","sourceRoot":"","sources":["../../../src/cli/shell/stream-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,0CAA0C;IAC1C,UAAU,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5C,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;IACX,qCAAqC;IACrC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,0BAA0B;IAC1B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrD;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAE/B,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB;IAKnE;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAcxC;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAoB9B;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIpC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,eAAe;CAKxB"}

package/dist/cli/shell/stream-bridge.js

@@ -0,0 +1,98 @@
+/**
+ * Stream Bridge — connects StreamingPipeline events to shell rendering callbacks.
+ *
+ * Accumulates content deltas into complete messages and dispatches
+ * to the shell's render loop via simple callbacks.
+ *
+ * @module cli/shell/stream-bridge
+ */
+/**
+ * Bridges the StreamingPipeline events to shell rendering callbacks.
+ * Accumulates content deltas into complete messages.
+ */
+export class StreamBridge {
+    buffers = new Map();
+    options;
+    registry;
+    constructor(registry, options) {
+        this.registry = registry;
+        this.options = options;
+    }
+    /**
+     * Process a streaming event from the pipeline.
+     * Dispatches to the correct callback based on event type.
+     */
+    handleEvent(event) {
+        switch (event.type) {
+            case 'message_delta':
+                this.handleDelta(event);
+                break;
+            case 'usage':
+                this.handleUsage(event);
+                break;
+            case 'reasoning_delta':
+                this.handleReasoning(event);
+                break;
+        }
+    }
+    /**
+     * Finalize the buffer for a session, emitting a complete ShellMessage.
+     * Call this when a stream ends (e.g. after the SDK signals completion).
+     */
+    flush(sessionId) {
+        const content = this.buffers.get(sessionId);
+        if (content === undefined || content.length === 0)
+            return;
+        const session = this.registry.get(sessionId);
+        const agentName = session?.name ?? sessionId;
+        const message = {
+            role: 'agent',
+            agentName,
+            content,
+            timestamp: new Date(),
+        };
+        this.options.onComplete(message);
+        this.buffers.delete(sessionId);
+        this.registry.updateStatus(sessionId, 'idle');
+    }
+    /**
+     * Get the current buffer content for a session (for partial renders).
+     */
+    getBuffer(sessionId) {
+        return this.buffers.get(sessionId) ?? '';
+    }
+    /**
+     * Clear all buffers (on session end).
+     */
+    clear() {
+        this.buffers.clear();
+    }
+    // ---------- Private ----------
+    handleDelta(event) {
+        const { sessionId, content } = event;
+        const agentName = event.agentName ?? sessionId;
+        // Accumulate content in the session buffer
+        const existing = this.buffers.get(sessionId) ?? '';
+        this.buffers.set(sessionId, existing + content);
+        // Mark session as streaming
+        this.registry.updateStatus(agentName, 'streaming');
+        // Notify the render loop
+        this.options.onContent(agentName, content);
+    }
+    handleUsage(event) {
+        const agentName = event.agentName ?? event.sessionId;
+        this.options.onUsage?.({
+            model: event.model,
+            inputTokens: event.inputTokens,
+            outputTokens: event.outputTokens,
+            cost: event.estimatedCost,
+        });
+        // Usage event typically signals end of a turn — mark idle
+        this.registry.updateStatus(agentName, 'idle');
+    }
+    handleReasoning(event) {
+        const agentName = event.agentName ?? event.sessionId;
+        this.options.onReasoning?.(agentName, event.content);
+    }
+}
+//# sourceMappingURL=stream-bridge.js.map

package/dist/cli/shell/stream-bridge.js.map

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

package/dist/cli/shell/terminal.d.ts

@@ -0,0 +1,30 @@
+export interface TerminalCapabilities {
+    supportsColor: boolean;
+    supportsUnicode: boolean;
+    columns: number;
+    rows: number;
+    platform: NodeJS.Platform;
+    isWindows: boolean;
+    isTTY: boolean;
+}
+/**
+ * Detect terminal capabilities for cross-platform compatibility.
+ */
+export declare function detectTerminal(): TerminalCapabilities;
+/**
+ * Get a safe character for the platform.
+ * Falls back to ASCII on terminals that don't support unicode.
+ */
+export declare function safeChar(unicode: string, ascii: string, caps: TerminalCapabilities): string;
+/**
+ * Box-drawing characters that degrade gracefully.
+ */
+export declare function boxChars(caps: TerminalCapabilities): {
+    tl: string;
+    tr: string;
+    bl: string;
+    br: string;
+    h: string;
+    v: string;
+};
+//# sourceMappingURL=terminal.d.ts.map

package/dist/cli/shell/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../src/cli/shell/terminal.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,CAarD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAE3F;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,oBAAoB;;;;;;;EAKlD"}

package/dist/cli/shell/terminal.js

@@ -0,0 +1,34 @@
+import { platform } from 'node:os';
+/**
+ * Detect terminal capabilities for cross-platform compatibility.
+ */
+export function detectTerminal() {
+    const plat = platform();
+    const isTTY = Boolean(process.stdout.isTTY);
+    return {
+        supportsColor: isTTY && (process.env['FORCE_COLOR'] !== '0'),
+        supportsUnicode: plat !== 'win32' || Boolean(process.env['WT_SESSION']), // Windows Terminal supports unicode
+        columns: process.stdout.columns || 80,
+        rows: process.stdout.rows || 24,
+        platform: plat,
+        isWindows: plat === 'win32',
+        isTTY,
+    };
+}
+/**
+ * Get a safe character for the platform.
+ * Falls back to ASCII on terminals that don't support unicode.
+ */
+export function safeChar(unicode, ascii, caps) {
+    return caps.supportsUnicode ? unicode : ascii;
+}
+/**
+ * Box-drawing characters that degrade gracefully.
+ */
+export function boxChars(caps) {
+    if (caps.supportsUnicode) {
+        return { tl: '╭', tr: '╮', bl: '╰', br: '╯', h: '─', v: '│' };
+    }
+    return { tl: '+', tr: '+', bl: '+', br: '+', h: '-', v: '|' };
+}
+//# sourceMappingURL=terminal.js.map