@theihtisham/agent-shadow-brain 5.1.1 → 6.0.0

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export type AgentTool = 'claude-code' | 'kilo-code' | 'cline' | 'opencode' | 'codex' | 'roo-code' | 'aider' | 'cursor' | 'windsurf';
+export type AgentTool = 'claude-code' | 'kilo-code' | 'cline' | 'opencode' | 'codex' | 'roo-code' | 'aider' | 'cursor' | 'windsurf' | 'copilot';
 export interface AgentAdapter {
     name: AgentTool;
     displayName: string;
@@ -333,6 +333,8 @@ export interface MCPTool {
 export interface MCPServerOptions {
     port?: number;
     host?: string;
+    authToken?: string;
+    corsOrigin?: string;
 }
 export interface PerfInsight {
     category: string;
@@ -1229,4 +1231,645 @@ export interface V6ModuleStatus {
     temporal: TemporalStats | null;
     lsp: LSPStats | null;
 }
+export interface GlobalBrainConfig {
+    /** Path to the singleton global brain store. Default: ~/.shadow-brain/global.json */
+    dbPath: string;
+    /** Reserved for future SQLite backend compatibility. JSON backend ignores this. */
+    walMode: boolean;
+    /** Max in-memory queue size for pending writes */
+    writeQueueSize: number;
+    /** Auto-vacuum threshold in MB */
+    autoVacuumMB: number;
+    /** Auto-prune threshold in MB (compress to lower tier when exceeded) */
+    autoPruneMB: number;
+    /** Sync interval to flush pending writes (ms) */
+    syncIntervalMs: number;
+}
+export interface GlobalBrainStats {
+    totalProjects: number;
+    totalAgents: number;
+    totalEntries: number;
+    totalSizeMB: number;
+    pendingWrites: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    lastSync: Date;
+    lastVacuum: Date | null;
+    lastPrune: Date | null;
+    uptime: number;
+}
+export interface GlobalEntry {
+    id: string;
+    projectId: string;
+    projectName: string;
+    agentTool: AgentTool;
+    category: string;
+    content: string;
+    vector?: number[];
+    importance: number;
+    accessCount: number;
+    createdAt: Date;
+    lastAccessed: Date;
+    metadata: Record<string, unknown>;
+}
+export interface SubconsciousConfig {
+    /** Enable proactive context injection */
+    enabled: boolean;
+    /** Maximum tokens to inject per session (default 2000) */
+    tokenBudget: number;
+    /** Lookback window in hours for recent context */
+    lookbackHours: number;
+    /** Minimum relevance score to include (0-1) */
+    relevanceThreshold: number;
+    /** Categories to always include if available */
+    alwaysInclude: string[];
+    /** Inject for these agents (empty = all) */
+    enabledAgents: AgentTool[];
+}
+export interface SubconsciousBriefing {
+    agentTool: AgentTool;
+    projectDir: string;
+    sessionId: string;
+    generatedAt: Date;
+    tokenCount: number;
+    sections: {
+        recentDecisions: string[];
+        activeTasks: string[];
+        similarPastWork: string[];
+        projectState: string;
+        crossAgentInsights: string[];
+        warnings: string[];
+    };
+    fullText: string;
+}
+export interface SubconsciousStats {
+    totalBriefings: number;
+    avgTokenCount: number;
+    avgGenerationMs: number;
+    acceptedRate: number;
+    byAgent: Record<string, number>;
+    lastBriefing: Date | null;
+}
+export type HookEvent = 'session-start' | 'session-end' | 'pre-prompt' | 'post-response' | 'file-edit';
+export interface SessionHook {
+    agent: AgentTool;
+    event: HookEvent;
+    /** Hook implementation type for this agent */
+    hookType: 'settings-json' | 'config-file' | 'env-var' | 'wrapper-script' | 'workspace-rule' | 'extension-config';
+    /** File path where the hook is installed */
+    installPath: string;
+    /** Command/script the hook executes */
+    command: string;
+    /** Whether the hook is currently active */
+    active: boolean;
+    installedAt: Date;
+}
+export interface AttachReport {
+    detected: AgentTool[];
+    attached: AgentTool[];
+    failed: Array<{
+        agent: AgentTool;
+        reason: string;
+    }>;
+    hooks: SessionHook[];
+    totalAgents: number;
+    durationMs: number;
+}
+export interface L0CacheEntry<T = unknown> {
+    key: string;
+    value: T;
+    hits: number;
+    insertedAt: number;
+    lastAccessed: number;
+    bytes: number;
+}
+export interface L0CacheStats {
+    entries: number;
+    bytesUsed: number;
+    bytesLimit: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    evictions: number;
+    avgAccessNs: number;
+    topKeys: Array<{
+        key: string;
+        hits: number;
+    }>;
+}
+export interface BrainTimelineEvent {
+    id: string;
+    projectId: string;
+    projectName: string;
+    agentTool: AgentTool;
+    category: string;
+    content: string;
+    importance: number;
+    createdAt: Date;
+    lastAccessed: Date;
+    metadata: Record<string, unknown>;
+}
+export interface AgentHandoffPacket {
+    fromAgent: AgentTool;
+    toAgent: AgentTool;
+    projectDir: string;
+    projectName: string;
+    task: string;
+    createdAt: Date;
+    recentMemories: BrainTimelineEvent[];
+    changedFiles: string[];
+    gitSummary: string;
+    safetyWarnings: string[];
+    markdown: string;
+}
+export interface FirewallFinding {
+    type: 'secret-access' | 'destructive-command' | 'network-risk' | 'package-risk' | 'prompt-injection' | 'path-risk';
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    blocked: boolean;
+    reason: string;
+    evidence: string;
+    recommendation: string;
+}
+export interface FirewallCheckInput {
+    command?: string;
+    filePath?: string;
+    url?: string;
+    content?: string;
+    toolName?: string;
+}
+export interface FirewallDecision {
+    allowed: boolean;
+    riskScore: number;
+    findings: FirewallFinding[];
+    summary: string;
+}
+export type SubAgentFramework = 'claude-code-task' | 'cursor-composer' | 'cline-substep' | 'crewai' | 'langgraph' | 'autogen' | 'generic';
+export interface SubAgentSpawnRequest {
+    parentAgent: AgentTool;
+    subAgentId: string;
+    framework: SubAgentFramework;
+    taskDescription: string;
+    projectDir: string;
+    spawnTime: Date;
+    expectedDurationMs?: number;
+    tokenBudget?: number;
+}
+export interface ContextSliver {
+    subAgentId: string;
+    parentAgent: AgentTool;
+    taskDescription: string;
+    memories: Array<{
+        id: string;
+        content: string;
+        category: string;
+        relevance: number;
+    }>;
+    warnings: string[];
+    tokenCount: number;
+    markdown: string;
+    generatedAt: Date;
+}
+export interface QuarantinedMemory {
+    id: string;
+    subAgentId: string;
+    parentAgent: AgentTool;
+    content: string;
+    category: string;
+    confidence: number;
+    graduatedAt: Date | null;
+    verdict: 'pending' | 'graduated' | 'rejected';
+    evidence: string[];
+    createdAt: Date;
+}
+export interface SABBStats {
+    totalSpawns: number;
+    totalSlivers: number;
+    quarantined: number;
+    graduated: number;
+    rejected: number;
+    avgSliverTokens: number;
+    avgGraduationMs: number;
+    byFramework: Record<SubAgentFramework, number>;
+    byParent: Record<string, number>;
+}
+export interface CausalLink {
+    id: string;
+    /** The memory/decision this is the cause of */
+    effectId: string;
+    /** The memory/event that caused it */
+    causeId: string;
+    /** Optional text explaining the causal relationship */
+    rationale?: string;
+    strength: number;
+    createdAt: Date;
+}
+export interface CausalChainNode {
+    id: string;
+    content: string;
+    agentTool: AgentTool;
+    category: string;
+    createdAt: Date;
+    parents: string[];
+    children: string[];
+    depth: number;
+}
+export interface CausalChain {
+    rootId: string;
+    nodes: CausalChainNode[];
+    links: CausalLink[];
+    maxDepth: number;
+    generatedAt: Date;
+    dot: string;
+}
+export interface AgentEditIntent {
+    agentTool: AgentTool;
+    sessionId: string;
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    intent: string;
+    declaredAt: Date;
+    expiresAt: Date;
+}
+export interface CollisionAlert {
+    id: string;
+    filePath: string;
+    conflictingIntents: AgentEditIntent[];
+    overlapStartLine: number;
+    overlapEndLine: number;
+    severity: 'info' | 'warning' | 'critical';
+    suggestedResolution: string;
+    detectedAt: Date;
+}
+export interface CollisionStats {
+    totalIntents: number;
+    activeIntents: number;
+    collisionsDetected: number;
+    collisionsResolved: number;
+    collisionsByAgent: Record<string, number>;
+    avgOverlapLines: number;
+}
+export type DreamType = 'revisit' | 'counterfactual' | 'consolidation' | 'contradiction' | 'pattern-discovery';
+export interface DreamInsight {
+    id: string;
+    type: DreamType;
+    content: string;
+    sourceMemoryIds: string[];
+    confidence: number;
+    generatedAt: Date;
+    actOnNextSession: boolean;
+    acknowledged: boolean;
+}
+export interface DreamEngineConfig {
+    enabled: boolean;
+    idleThresholdMs: number;
+    maxDreamsPerCycle: number;
+    useLocalLLM: boolean;
+    dreamIntervalMs: number;
+}
+export interface DreamEngineStats {
+    totalDreams: number;
+    byType: Record<DreamType, number>;
+    avgConfidence: number;
+    actionableCount: number;
+    acknowledgedCount: number;
+    lastDreamAt: Date | null;
+    totalDreamTimeMs: number;
+}
+export interface AgentDecisionReceipt {
+    id: string;
+    agentTool: AgentTool;
+    agentVersion: string;
+    projectId: string;
+    decision: string;
+    category: string;
+    confidence: number;
+    signedAt: Date;
+    signature: string;
+    publicKey: string;
+    outcomeVerdict?: 'correct' | 'incorrect' | 'partial' | 'unverified';
+    outcomeVerifiedAt?: Date;
+}
+export interface ReputationScore {
+    agentTool: AgentTool;
+    agentVersion: string;
+    totalDecisions: number;
+    correct: number;
+    incorrect: number;
+    partial: number;
+    accuracyRate: number;
+    categoryScores: Record<string, {
+        correct: number;
+        total: number;
+        accuracy: number;
+    }>;
+    streakDays: number;
+    lastActive: Date;
+    publicKey: string;
+    ledgerHash: string;
+}
+export interface ReputationLedgerStats {
+    totalAgents: number;
+    totalReceipts: number;
+    verifiedReceipts: number;
+    averageAccuracy: number;
+    topAgents: Array<{
+        agentTool: AgentTool;
+        accuracy: number;
+        decisions: number;
+    }>;
+}
+export interface DebateTurn {
+    turnId: number;
+    agentLabel: string;
+    position: 'pro' | 'con' | 'arbiter';
+    statement: string;
+    confidence: number;
+    timestamp: Date;
+}
+export interface DebateTranscript {
+    id: string;
+    question: string;
+    context: string;
+    turns: DebateTurn[];
+    verdict: string;
+    arbiterConfidence: number;
+    durationMs: number;
+    createdAt: Date;
+}
+export interface PreMortemFailure {
+    id: string;
+    description: string;
+    source: 'past-incident' | 'similar-project' | 'llm-predicted';
+    probability: number;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    mitigation: string;
+    relatedMemoryIds: string[];
+}
+export interface PreMortemReport {
+    taskDescription: string;
+    generatedAt: Date;
+    failures: PreMortemFailure[];
+    riskScore: number;
+    summary: string;
+}
+export interface BranchBrainState {
+    currentBranch: string;
+    activeMemoryIds: string[];
+    branchMemoryCount: number;
+    globalMemoryCount: number;
+    lastSwitchAt: Date;
+    branchSpecificCategories: string[];
+}
+export interface BranchMemoryTag {
+    memoryId: string;
+    branch: string;
+    scope: 'branch' | 'global';
+    taggedAt: Date;
+}
+export interface AttentionWeight {
+    memoryId: string;
+    memoryContent: string;
+    weight: number;
+    category: string;
+    reasoning: string;
+}
+export interface AttentionReport {
+    decisionId: string;
+    decisionText: string;
+    agentTool: AgentTool;
+    weights: AttentionWeight[];
+    totalMemoriesConsidered: number;
+    generatedAt: Date;
+}
+export interface TokenSpendRecord {
+    id: string;
+    agentTool: AgentTool;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    estimatedCostUsd: number;
+    taskCategory: string;
+    timestamp: Date;
+}
+export interface TokenEconomyStats {
+    totalSpendUsd: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    byAgent: Record<string, {
+        spendUsd: number;
+        calls: number;
+    }>;
+    byModel: Record<string, {
+        spendUsd: number;
+        calls: number;
+    }>;
+    byCategory: Record<string, {
+        spendUsd: number;
+        calls: number;
+    }>;
+    monthlyProjectionUsd: number;
+    savingsOpportunitiesUsd: number;
+    suggestions: string[];
+}
+export interface ForgettingState {
+    memoryId: string;
+    initialStrength: number;
+    currentStrength: number;
+    lastReinforced: Date;
+    accessCount: number;
+    halfLifeHours: number;
+    consolidatedTier: MemoryTier;
+}
+export interface ConsolidationReport {
+    cycle: number;
+    processedMemories: number;
+    promoted: number;
+    demoted: number;
+    forgotten: number;
+    strengthened: number;
+    ranAt: Date;
+    durationMs: number;
+}
+export interface FormalRule {
+    id: string;
+    sourceMemoryId: string;
+    naturalLanguage: string;
+    eslintRule?: string;
+    semgrepRule?: string;
+    lspDiagnostic?: {
+        code: string;
+        pattern: string;
+        message: string;
+    };
+    languageScope: string[];
+    generatedAt: Date;
+    verified: boolean;
+}
+export interface FormalBridgeStats {
+    totalRules: number;
+    byLanguage: Record<string, number>;
+    verifiedRules: number;
+    lastGenerated: Date | null;
+}
+export interface CalibrationRecord {
+    agentTool: AgentTool;
+    category: string;
+    claim: string;
+    claimedConfidence: number;
+    actualOutcome: 'correct' | 'incorrect' | 'partial';
+    outcomeAt: Date;
+    recordedAt: Date;
+}
+export interface CalibrationScore {
+    agentTool: AgentTool;
+    category: string;
+    sampleSize: number;
+    brierScore: number;
+    calibrationError: number;
+    overconfidenceRatio: number;
+    trustWeight: number;
+    updatedAt: Date;
+}
+export interface SpawnCostEstimate {
+    subAgentModel: string;
+    estimatedInputTokens: number;
+    estimatedOutputTokens: number;
+    estimatedCostUsd: number;
+    expectedValueScore: number;
+    cheaperAlternative: {
+        model: string;
+        costUsd: number;
+    } | null;
+    recommendation: 'proceed' | 'use-alternative' | 'skip';
+    rationale: string;
+}
+export interface AirGapStatus {
+    enabled: boolean;
+    blockedOutboundCount: number;
+    allowedLocalCount: number;
+    lastAttempt: Date | null;
+    policy: 'strict' | 'loose';
+}
+export interface EncryptedBrainFile {
+    schemaVersion: number;
+    cipher: 'chacha20-poly1305';
+    salt: string;
+    nonce: string;
+    ciphertext: string;
+    authTag: string;
+    createdAt: string;
+}
+export interface QuarantineEntry {
+    id: string;
+    source: string;
+    claim: string;
+    evidence: string[];
+    reasonFlagged: string;
+    quarantinedAt: Date;
+    decision: 'pending' | 'promoted' | 'deleted';
+}
+export interface VoiceCommandResult {
+    transcript: string;
+    confidence: number;
+    intent: string;
+    response: string;
+    audioPath?: string;
+    timestamp: Date;
+}
+export interface GardenNode {
+    id: string;
+    kind: 'memory' | 'pattern' | 'decision' | 'link';
+    label: string;
+    age: number;
+    strength: number;
+    connections: string[];
+    bloom: number;
+}
+export interface PRReviewComment {
+    prNumber: number;
+    repo: string;
+    body: string;
+    sections: {
+        matches: string[];
+        contradictions: string[];
+        suggestions: string[];
+        citations: Array<{
+            memoryId: string;
+            snippet: string;
+        }>;
+    };
+    generatedAt: Date;
+}
+export interface TeamPeerInfo {
+    peerId: string;
+    displayName: string;
+    agentTools: AgentTool[];
+    connectedAt: Date;
+    lastSeenAt: Date;
+    sharedMemoryCount: number;
+}
+export interface TeamSyncMessage {
+    type: 'offer' | 'answer' | 'ice' | 'memory-sync' | 'heartbeat';
+    from: string;
+    to?: string;
+    payload: unknown;
+    timestamp: Date;
+}
+export interface BrainSlicePackage {
+    id: string;
+    name: string;
+    description: string;
+    author: string;
+    version: string;
+    tags: string[];
+    categories: string[];
+    memoryCount: number;
+    memories: Array<{
+        content: string;
+        category: string;
+        importance: number;
+    }>;
+    createdAt: Date;
+    license: string;
+}
+export type LocalLLMProvider = 'ollama' | 'llamacpp' | 'lmstudio' | 'none';
+export interface LocalLLMConfig {
+    provider: LocalLLMProvider;
+    model: string;
+    endpoint: string;
+    timeoutMs: number;
+    maxTokens: number;
+    temperature: number;
+}
+export interface LocalLLMResponse {
+    text: string;
+    provider: LocalLLMProvider;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    durationMs: number;
+    local: true;
+}
+export interface HiveMindStatus {
+    version: '6.0.0';
+    modules: {
+        sabb: SABBStats;
+        causal: {
+            chains: number;
+            links: number;
+        };
+        collision: CollisionStats;
+        dream: DreamEngineStats;
+        reputation: ReputationLedgerStats;
+        tokenEconomy: TokenEconomyStats;
+        formalBridge: FormalBridgeStats;
+        airGap: AirGapStatus;
+    };
+    localFirst: boolean;
+    totalAgentsConnected: number;
+    totalMemoriesStored: number;
+    generatedAt: Date;
+}
 //# sourceMappingURL=types.d.ts.map