@calliopelabs/cli 0.8.20 → 2.0.2

package/dist/agents/council-types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Calliope Agents — Council Types
+ *
+ * Type definitions for agent councils: groups of agents deliberating
+ * on a shared goal with multiple coordination modes.
+ */
+import type { SubAgentType } from './types.js';
+/**
+ * Council coordination modes
+ */
+export type CouncilMode = 'consensus' | 'competitive' | 'collaborative' | 'overseer';
+/**
+ * Council session status
+ */
+export type CouncilStatus = 'deliberating' | 'voting' | 'scoring' | 'building' | 'reviewing' | 'completed' | 'failed' | 'cancelled';
+/**
+ * Tie-breaking strategies
+ */
+export type TieBreaker = 'voting' | 'scoring' | 'designated' | 'user';
+/**
+ * A council member (agent)
+ */
+export interface CouncilMember {
+    id: string;
+    name: string;
+    agent: SubAgentType;
+    role?: string;
+    weight: number;
+}
+/**
+ * A deliberation entry from a council member
+ */
+export interface DeliberationEntry {
+    memberId: string;
+    memberName: string;
+    response: string;
+    timestamp: Date;
+    score?: number;
+    votes?: number;
+}
+/**
+ * Vote in consensus mode
+ */
+export interface Vote {
+    voterId: string;
+    candidateId: string;
+    weight: number;
+}
+/**
+ * Score in competitive mode
+ */
+export interface Score {
+    scorerId: string;
+    targetId: string;
+    score: number;
+    weight: number;
+}
+/**
+ * Council session configuration
+ */
+export interface CouncilConfig {
+    /** Coordination mode */
+    mode: CouncilMode;
+    /** Council members */
+    members: CouncilMember[];
+    /** Tie-breaking strategy */
+    tieBreaker: TieBreaker;
+    /** Maximum rounds in consensus mode (default: 3) */
+    maxRounds: number;
+    /** Supermajority threshold for consensus (default: 0.67) */
+    consensusThreshold: number;
+    /** Designated tie-breaker member ID */
+    designatedBreaker?: string;
+}
+/**
+ * Default council configuration
+ */
+export declare const DEFAULT_COUNCIL_CONFIG: Omit<CouncilConfig, 'members'>;
+/**
+ * A council session
+ */
+export interface CouncilSession {
+    id: string;
+    prompt: string;
+    status: CouncilStatus;
+    config: CouncilConfig;
+    deliberations: DeliberationEntry[];
+    votes: Vote[];
+    scores: Score[];
+    round: number;
+    result?: string;
+    winnerId?: string;
+    error?: string;
+    createdAt: Date;
+    updatedAt: Date;
+    completedAt?: Date;
+}
+/**
+ * Pre-built council templates
+ */
+export interface CouncilTemplate {
+    name: string;
+    description: string;
+    mode: CouncilMode;
+    members: Omit<CouncilMember, 'id'>[];
+    tieBreaker: TieBreaker;
+    promptPrefix?: string;
+}
+/**
+ * Built-in council templates
+ */
+export declare const COUNCIL_TEMPLATES: Record<string, CouncilTemplate>;
+//# sourceMappingURL=council-types.d.ts.map

package/dist/agents/council-types.d.ts.map

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

package/dist/agents/council-types.js

@@ -0,0 +1,81 @@
+/**
+ * Calliope Agents — Council Types
+ *
+ * Type definitions for agent councils: groups of agents deliberating
+ * on a shared goal with multiple coordination modes.
+ */
+/**
+ * Default council configuration
+ */
+export const DEFAULT_COUNCIL_CONFIG = {
+    mode: 'competitive',
+    tieBreaker: 'scoring',
+    maxRounds: 3,
+    consensusThreshold: 0.67,
+};
+/**
+ * Built-in council templates
+ */
+export const COUNCIL_TEMPLATES = {
+    'code-review': {
+        name: 'code-review',
+        description: 'Multi-perspective code review council',
+        mode: 'competitive',
+        members: [
+            { name: 'Reviewer A', agent: 'claude', role: 'correctness-reviewer', weight: 1.0 },
+            { name: 'Reviewer B', agent: 'gemini', role: 'performance-reviewer', weight: 1.0 },
+            { name: 'Reviewer C', agent: 'claude', role: 'security-reviewer', weight: 1.2 },
+        ],
+        tieBreaker: 'scoring',
+        promptPrefix: 'Review the following code. Focus on correctness, performance, security, and maintainability:\n\n',
+    },
+    'architecture': {
+        name: 'architecture',
+        description: 'Architecture decision council',
+        mode: 'collaborative',
+        members: [
+            { name: 'Architect', agent: 'claude', role: 'lead-architect', weight: 1.5 },
+            { name: 'Engineer', agent: 'gemini', role: 'implementation-expert', weight: 1.0 },
+            { name: 'Ops', agent: 'claude', role: 'devops-expert', weight: 1.0 },
+        ],
+        tieBreaker: 'designated',
+        promptPrefix: 'Evaluate the following architecture decision. Consider scalability, maintainability, and operational concerns:\n\n',
+    },
+    'security-audit': {
+        name: 'security-audit',
+        description: 'Security audit council',
+        mode: 'competitive',
+        members: [
+            { name: 'AppSec', agent: 'claude', role: 'application-security', weight: 1.0 },
+            { name: 'NetSec', agent: 'gemini', role: 'network-security', weight: 1.0 },
+            { name: 'Compliance', agent: 'claude', role: 'compliance-auditor', weight: 0.8 },
+        ],
+        tieBreaker: 'scoring',
+        promptPrefix: 'Conduct a security audit of the following. Identify vulnerabilities, risks, and remediation steps:\n\n',
+    },
+    'brainstorm': {
+        name: 'brainstorm',
+        description: 'Creative brainstorming council',
+        mode: 'collaborative',
+        members: [
+            { name: 'Ideator', agent: 'claude', role: 'creative-thinker', weight: 1.0 },
+            { name: 'Analyst', agent: 'gemini', role: 'feasibility-analyst', weight: 1.0 },
+            { name: 'Builder', agent: 'claude', role: 'implementation-planner', weight: 1.0 },
+        ],
+        tieBreaker: 'voting',
+        promptPrefix: 'Brainstorm solutions for the following challenge. Think creatively and consider multiple approaches:\n\n',
+    },
+    'debate': {
+        name: 'debate',
+        description: 'Structured debate council',
+        mode: 'competitive',
+        members: [
+            { name: 'Proponent', agent: 'claude', role: 'advocate-for', weight: 1.0 },
+            { name: 'Opponent', agent: 'gemini', role: 'advocate-against', weight: 1.0 },
+            { name: 'Judge', agent: 'claude', role: 'impartial-judge', weight: 1.5 },
+        ],
+        tieBreaker: 'designated',
+        promptPrefix: 'Debate the following proposition. Present arguments for and against:\n\n',
+    },
+};
+//# sourceMappingURL=council-types.js.map

package/dist/agents/council-types.js.map

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

package/dist/agents/council.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Calliope Agents — Council Manager
+ *
+ * Coordinates groups of agents deliberating on a shared goal.
+ * Supports competitive, collaborative, consensus, and overseer modes.
+ */
+import type { CouncilSession, CouncilConfig, CouncilMember, CouncilTemplate } from './council-types.js';
+/**
+ * Council Manager - Singleton
+ */
+declare class CouncilManager {
+    private sessions;
+    /**
+     * Start a new council session
+     */
+    startCouncil(prompt: string, config: Partial<CouncilConfig> & {
+        members: CouncilMember[];
+    }, cwd?: string): Promise<CouncilSession>;
+    /**
+     * Start a council from a template
+     */
+    startFromTemplate(templateName: string, prompt: string, cwd?: string): Promise<CouncilSession>;
+    /**
+     * Get a council session
+     */
+    getSession(sessionId: string): CouncilSession | undefined;
+    /**
+     * Get all sessions
+     */
+    getAllSessions(): CouncilSession[];
+    /**
+     * Cancel a council session
+     */
+    cancelCouncil(sessionId: string): Promise<boolean>;
+    /**
+     * Get council statistics
+     */
+    getStats(): {
+        totalSessions: number;
+        activeSessions: number;
+        completedSessions: number;
+        failedSessions: number;
+    };
+    /**
+     * Run the council lifecycle based on mode
+     */
+    private runCouncilLifecycle;
+    /**
+     * Competitive mode: All respond independently → cross-score → highest wins
+     */
+    private runCompetitive;
+    /**
+     * Collaborative mode: Sequential building (A → B builds on A → C builds on B)
+     */
+    private runCollaborative;
+    /**
+     * Consensus mode: Deliberate → vote → supermajority or repeat
+     */
+    private runConsensus;
+    /**
+     * Overseer mode: Lead decomposes (Swarm), reviews results, makes final call
+     */
+    private runOverseer;
+    /**
+     * LLM-based cross-scoring: spawns a scoring agent to evaluate responses.
+     * Returns null if LLM scoring fails (caller should fall back to heuristic).
+     */
+    private llmCrossScore;
+    /**
+     * Heuristic cross-scoring fallback: scores based on response structure.
+     */
+    private heuristicCrossScore;
+    /**
+     * Cross-score deliberations (sync fallback for non-competitive callers).
+     */
+    private crossScore;
+    /**
+     * Async cross-scoring: tries LLM evaluation first, falls back to heuristics.
+     */
+    private crossScoreAsync;
+    /**
+     * Select the winner based on scores
+     */
+    private selectWinner;
+    /**
+     * Apply tie-breaker when consensus fails
+     */
+    private applyTieBreaker;
+    /**
+     * Format session status for display
+     */
+    formatSessionStatus(session: CouncilSession): string;
+    /**
+     * Get available templates
+     */
+    getTemplates(): CouncilTemplate[];
+    /**
+     * Reset all sessions
+     */
+    reset(): void;
+}
+/**
+ * Singleton council manager instance
+ */
+export declare const councilManager: CouncilManager;
+export {};
+//# sourceMappingURL=council.d.ts.map

package/dist/agents/council.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"council.d.ts","sourceRoot":"","sources":["../../src/agents/council.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EAKb,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAK5B;;GAEG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,QAAQ,CAAqC;IAErD;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG;QAAE,OAAO,EAAE,aAAa,EAAE,CAAA;KAAE,EAC7D,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC;IA+B1B;;OAEG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC;IAsB1B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIzD;;OAEG;IACH,cAAc,IAAI,cAAc,EAAE;IAIlC;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUxD;;OAEG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC;KACxB;IAUD;;OAEG;YACW,mBAAmB;IAwBjC;;OAEG;YACW,cAAc;IAgE5B;;OAEG;YACW,gBAAgB;IA0D9B;;OAEG;YACW,YAAY;IA0G1B;;OAEG;YACW,WAAW;IAkFzB;;;OAGG;YACW,aAAa;IA2D3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkC3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;YACW,eAAe;IAM7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM;IA0BpD;;OAEG;IACH,YAAY,IAAI,eAAe,EAAE;IAIjC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC"}