@compilr-dev/sdk 0.1.28 → 0.2.1

package/dist/team/shared-context.d.ts

@@ -0,0 +1,293 @@
+/**
+ * SharedContextManager - Shared context across team agents
+ *
+ * Provides a lightweight, token-budgeted context layer that's injected
+ * into all agent system prompts. Enables cross-agent knowledge sharing.
+ *
+ * Token Budget: ~4000 tokens (2% of 200K context)
+ */
+import type { ArtifactType, ArtifactSummary } from './artifacts.js';
+/**
+ * Project information in shared context
+ */
+export interface SharedProjectInfo {
+    id: number | null;
+    name: string;
+    path: string;
+    memorySummary: string;
+}
+/**
+ * Team roster in shared context
+ */
+export interface SharedTeamInfo {
+    agents: string[];
+    activeAgent: string;
+}
+/**
+ * Team roster entry with full agent info for team awareness
+ */
+export interface TeamRosterEntry {
+    id: string;
+    displayName: string;
+    mascot: string;
+    role: string;
+    expertise: string[];
+    isActive: boolean;
+    todoCount?: number;
+    workItemCount?: number;
+}
+/**
+ * A decision made by an agent
+ */
+export interface SharedDecision {
+    id: string;
+    agent: string;
+    summary: string;
+    reasoning?: string;
+    timestamp: Date;
+    supersededBy?: string;
+}
+/**
+ * Token budget tracking
+ */
+export interface TokenBudget {
+    max: number;
+    current: number;
+}
+/**
+ * Activity type for team activity feed
+ */
+export type TeamActivityType = 'artifact_created' | 'artifact_updated' | 'task_completed' | 'decision_made';
+/**
+ * Team activity entry for activity feed
+ */
+export interface TeamActivity {
+    agentId: string;
+    timestamp: Date;
+    action: TeamActivityType;
+    summary: string;
+}
+/**
+ * Full shared context structure
+ */
+export interface SharedContext {
+    project: SharedProjectInfo;
+    team: SharedTeamInfo;
+    decisions: SharedDecision[];
+    artifactIndex: ArtifactSummary[];
+    tokenBudget: TokenBudget;
+    updatedAt: Date;
+}
+/**
+ * Serialized shared context for persistence
+ */
+export interface SerializedSharedContext {
+    version: number;
+    project: {
+        id: number | null;
+        name: string;
+        path: string;
+        memorySummary: string;
+    };
+    decisions: Array<{
+        id: string;
+        agent: string;
+        summary: string;
+        reasoning?: string;
+        timestamp: string;
+        supersededBy?: string;
+    }>;
+    artifactIndex: Array<{
+        id: string;
+        name: string;
+        agent: string;
+        type: ArtifactType;
+        summary: string;
+        updatedAt: string;
+    }>;
+    updatedAt: string;
+}
+/**
+ * Manages shared context across all team agents
+ */
+export declare class SharedContextManager {
+    private readonly project;
+    private readonly team;
+    private teamRoster;
+    private recentActivity;
+    private decisions;
+    private artifactIndex;
+    private readonly tokenBudget;
+    private updatedAt;
+    constructor(options?: {
+        project?: Partial<SharedProjectInfo>;
+        maxTokens?: number;
+    });
+    /**
+     * Update project information
+     */
+    setProject(project: Partial<SharedProjectInfo>): void;
+    /**
+     * Get project information
+     */
+    getProject(): SharedProjectInfo;
+    /**
+     * Update team roster
+     */
+    setTeam(agents: string[], activeAgent?: string): void;
+    /**
+     * Set active agent
+     */
+    setActiveAgent(agentId: string): void;
+    /**
+     * Add an agent to the team
+     */
+    addAgent(agentId: string): void;
+    /**
+     * Remove an agent from the team
+     */
+    removeAgent(agentId: string): void;
+    /**
+     * Get team roster
+     */
+    getTeam(): SharedTeamInfo;
+    /**
+     * Update the full team roster with agent details
+     * Called when team composition changes
+     */
+    updateTeamRoster(entries: TeamRosterEntry[]): void;
+    /**
+     * Set active agent in the roster
+     * Called on agent switch
+     */
+    setRosterActiveAgent(agentId: string): void;
+    /**
+     * Get the full team roster
+     */
+    getTeamRoster(): TeamRosterEntry[];
+    /**
+     * Check if team roster is available (more than just default agent)
+     */
+    hasTeamRoster(): boolean;
+    /**
+     * Update task counts for an agent
+     * Called by REPL when todo list or work items change
+     */
+    updateAgentTaskCounts(agentId: string, todoCount: number, workItemCount: number): void;
+    /**
+     * Update task counts for all agents
+     * Called with a map of agentId -> { todoCount, workItemCount }
+     */
+    updateAllAgentTaskCounts(counts: Record<string, {
+        todoCount: number;
+        workItemCount: number;
+    }>): void;
+    /**
+     * Record a team activity
+     * Called when significant actions occur (artifact created, task completed, etc.)
+     */
+    recordActivity(activity: Omit<TeamActivity, 'timestamp'>): void;
+    /**
+     * Get recent activity
+     */
+    getRecentActivity(): TeamActivity[];
+    /**
+     * Check if there is recent activity to display
+     */
+    hasRecentActivity(): boolean;
+    /**
+     * Clear activity feed
+     */
+    clearActivity(): void;
+    /**
+     * Add a decision to the shared context
+     */
+    addDecision(decision: Omit<SharedDecision, 'id' | 'timestamp'>): string;
+    /**
+     * Update/supersede a decision
+     */
+    supersededDecision(oldId: string, newDecision: Omit<SharedDecision, 'id' | 'timestamp'>): string;
+    /**
+     * Get all decisions (active only by default)
+     */
+    getDecisions(includeSuperseded?: boolean): SharedDecision[];
+    /**
+     * Clear all decisions
+     */
+    clearDecisions(): void;
+    /**
+     * Update the artifact index (called by ArtifactStore)
+     */
+    setArtifactIndex(index: ArtifactSummary[]): void;
+    /**
+     * Add an artifact to the index
+     */
+    addArtifactToIndex(artifact: ArtifactSummary): void;
+    /**
+     * Remove an artifact from the index
+     */
+    removeArtifactFromIndex(artifactId: string): void;
+    /**
+     * Get artifact index
+     */
+    getArtifactIndex(): ArtifactSummary[];
+    /**
+     * Update token count based on current content
+     */
+    private updateTokenCount;
+    /**
+     * Check if adding content would exceed budget
+     */
+    wouldExceedBudget(additionalTokens: number): boolean;
+    /**
+     * Get token budget status
+     */
+    getTokenBudget(): TokenBudget;
+    /**
+     * Get utilization percentage
+     */
+    getUtilization(): number;
+    /**
+     * Format shared context for injection into system prompt.
+     * @param options.excludeRoster - If true, omit the team roster (it will be injected via anchor instead)
+     */
+    format(options?: {
+        excludeRoster?: boolean;
+    }): string;
+    /**
+     * Format team roster as a table for team awareness
+     */
+    formatTeamRoster(): string;
+    /**
+     * Build handoff suggestions based on team composition
+     */
+    private buildHandoffSuggestions;
+    /**
+     * Format recent activity feed for team awareness
+     */
+    private formatRecentActivity;
+    /**
+     * Format a timestamp as "Xm ago", "Xh ago", etc.
+     */
+    private formatTimeAgo;
+    /**
+     * Format a compact version (for token-constrained situations)
+     */
+    formatCompact(): string;
+    /**
+     * Mark as updated
+     */
+    private touch;
+    /**
+     * Serialize for persistence
+     */
+    serialize(): SerializedSharedContext;
+    /**
+     * Restore from serialized data
+     */
+    static fromSerialized(data: SerializedSharedContext): SharedContextManager;
+    /**
+     * Get the full context object
+     */
+    getContext(): SharedContext;
+}