opencode-swarm 6.27.0 → 7.0.0-beta.1

package/dist/services/evidence-summary-service.d.ts

@@ -1,75 +0,0 @@
-/**
- * Evidence Summary Service
- *
- * Provides deterministic evidence aggregation per task and phase.
- * Produces machine-readable and human-readable summary artifacts.
- */
-import type { PhaseStatus, TaskStatus } from '../config/plan-schema';
-/** Evidence types required for task completion */
-export declare const REQUIRED_EVIDENCE_TYPES: readonly ["review", "test"];
-export type RequiredEvidenceType = (typeof REQUIRED_EVIDENCE_TYPES)[number];
-/** Summary artifact schema version */
-export declare const EVIDENCE_SUMMARY_VERSION = "1.0.0";
-/** Evidence summary for a single task */
-export interface TaskEvidenceSummary {
-    taskId: string;
-    phase: number;
-    taskStatus: TaskStatus;
-    evidenceCount: number;
-    hasReview: boolean;
-    hasTest: boolean;
-    hasApproval: boolean;
-    missingEvidence: string[];
-    isComplete: boolean;
-    blockers: string[];
-    lastEvidenceTimestamp: string | null;
-}
-/** Phase evidence summary */
-export interface PhaseEvidenceSummary {
-    phaseId: number;
-    phaseName: string;
-    phaseStatus: PhaseStatus;
-    totalTasks: number;
-    completedTasks: number;
-    tasksWithEvidence: number;
-    tasksWithCompleteEvidence: number;
-    completionRatio: number;
-    missingEvidenceByType: Record<string, string[]>;
-    blockers: PhaseBlocker[];
-    tasks: TaskEvidenceSummary[];
-}
-/** Blockers preventing phase closure */
-export interface PhaseBlocker {
-    type: 'missing_evidence' | 'incomplete_task' | 'blocked_task';
-    taskId: string;
-    reason: string;
-    severity: 'high' | 'medium' | 'low';
-}
-/** Full evidence summary artifact */
-export interface EvidenceSummaryArtifact {
-    schema_version: typeof EVIDENCE_SUMMARY_VERSION;
-    generated_at: string;
-    planTitle: string;
-    currentPhase: number;
-    phaseSummaries: PhaseEvidenceSummary[];
-    overallCompletionRatio: number;
-    overallBlockers: PhaseBlocker[];
-    summaryText: string;
-}
-/**
- * Build complete evidence summary artifact
- *
- * Aggregates evidence per task and phase, producing deterministic
- * summary artifacts including completion ratio, missing evidence,
- * blockers, and per-task status.
- */
-export declare function buildEvidenceSummary(directory: string, currentPhase?: number): Promise<EvidenceSummaryArtifact | null>;
-/**
- * Check if auto-summaries are enabled via feature flags
- */
-export declare function isAutoSummaryEnabled(automationConfig?: {
-    capabilities?: {
-        evidence_auto_summaries?: boolean;
-    };
-    mode?: string;
-}): boolean;

package/dist/services/export-service.d.ts

@@ -1,23 +0,0 @@
-/**
- * Structured export data.
- */
-export interface ExportData {
-    version: string;
-    exported: string;
-    plan: unknown;
-    context: string | null;
-}
-/**
- * Get export data from the swarm directory.
- * Returns structured data for GUI, background flows, or commands.
- */
-export declare function getExportData(directory: string): Promise<ExportData>;
-/**
- * Format export data as markdown with JSON code block for command output.
- */
-export declare function formatExportMarkdown(exportData: ExportData): string;
-/**
- * Handle export command - delegates to service and formats output.
- * Kept for backward compatibility - thin adapter.
- */
-export declare function handleExportCommand(directory: string, _args: string[]): Promise<string>;

package/dist/services/handoff-service.d.ts

@@ -1,61 +0,0 @@
-/**
- * Handoff Service
- *
- * Provides structured handoff data for agent transitions between swarm sessions.
- * Reads from .swarm files to gather current state for context-efficient handoffs.
- */
-/**
- * Pending QA state from agent sessions
- */
-export interface PendingQA {
-    taskId: string;
-    lastFailure: string | null;
-}
-/**
- * Delegation chain entry
- */
-export interface DelegationEntry {
-    from: string;
-    to: string;
-    taskId: string;
-    timestamp: number;
-}
-/**
- * Delegation state from session snapshot
- */
-export interface DelegationState {
-    activeChains: string[];
-    delegationDepth: number;
-    pendingHandoffs: string[];
-}
-/**
- * Structured handoff data for agent transitions
- */
-export interface HandoffData {
-    /** ISO timestamp when data was generated */
-    generated: string;
-    /** Current phase number or name */
-    currentPhase: string | null;
-    /** Current task ID being worked on */
-    currentTask: string | null;
-    /** List of incomplete task IDs */
-    incompleteTasks: string[];
-    /** Pending QA state */
-    pendingQA: PendingQA | null;
-    /** Active agent name */
-    activeAgent: string | null;
-    /** Recent decisions from context.md */
-    recentDecisions: string[];
-    /** Delegation state */
-    delegationState: DelegationState | null;
-}
-/**
- * Get handoff data from the swarm directory.
- * Reads session state, plan, and context to build comprehensive handoff info.
- */
-export declare function getHandoffData(directory: string): Promise<HandoffData>;
-/**
- * Format handoff data as terse markdown for LLM consumption.
- * Targets under 2K tokens for efficient context injection.
- */
-export declare function formatHandoffMarkdown(data: HandoffData): string;

package/dist/services/history-service.d.ts

@@ -1,35 +0,0 @@
-/**
- * Structured history data for a single phase.
- */
-export interface PhaseHistoryData {
-    id: number;
-    name: string;
-    status: 'complete' | 'in_progress' | 'pending' | 'blocked';
-    statusText: string;
-    statusIcon: string;
-    completedTasks: number;
-    totalTasks: number;
-    tasksDisplay: string;
-}
-/**
- * Structured history data returned by the history service.
- */
-export interface HistoryData {
-    hasPlan: boolean;
-    phases: PhaseHistoryData[];
-    isLegacy: boolean;
-}
-/**
- * Get history data from the swarm directory.
- * Returns structured data for GUI, background flows, or commands.
- */
-export declare function getHistoryData(directory: string): Promise<HistoryData>;
-/**
- * Format history data as markdown for command output.
- */
-export declare function formatHistoryMarkdown(history: HistoryData): string;
-/**
- * Handle history command - delegates to service and formats output.
- * Kept for backward compatibility - thin adapter.
- */
-export declare function handleHistoryCommand(directory: string, _args: string[]): Promise<string>;

package/dist/services/index.d.ts

@@ -1,13 +0,0 @@
-export { analyzeDecisionDrift, DEFAULT_DRIFT_CONFIG, type Decision, type DriftAnalysisResult, type DriftAnalyzerConfig, type DriftSeverity, type DriftSignal, extractDecisionsFromContext, findContradictions, formatDriftForContext, } from './decision-drift-analyzer';
-export { applySafeAutoFixes, type ConfigBackup, type ConfigDoctorResult, type ConfigFinding, type ConfigFix, createConfigBackup, type FindingSeverity, getConfigPaths, runConfigDoctor, runConfigDoctorWithFixes, shouldRunOnStartup, writeBackupArtifact, writeDoctorArtifact, } from './config-doctor';
-export { type BudgetState, type ContextBudgetConfig, type ContextBudgetReport, DEFAULT_CONTEXT_BUDGET_CONFIG, estimateTokens, formatBudgetWarning, getContextBudgetReport, getDefaultConfig, } from './context-budget-service';
-export { type DiagnoseData, formatDiagnoseMarkdown, getDiagnoseData, type HealthCheck, handleDiagnoseCommand, } from './diagnose-service';
-export { type EvidenceEntryData, type EvidenceListData, formatEvidenceListMarkdown, formatTaskEvidenceMarkdown, getEvidenceListData, getTaskEvidenceData, getVerdictEmoji, handleEvidenceCommand, type TaskEvidenceData, } from './evidence-service';
-export { buildEvidenceSummary, EVIDENCE_SUMMARY_VERSION, type EvidenceSummaryArtifact, isAutoSummaryEnabled, type PhaseBlocker, type PhaseEvidenceSummary, REQUIRED_EVIDENCE_TYPES, type TaskEvidenceSummary, } from './evidence-summary-service';
-export { type ExportData, formatExportMarkdown, getExportData, handleExportCommand, } from './export-service';
-export { type DelegationState, formatHandoffMarkdown, getHandoffData, type HandoffData, type PendingQA, } from './handoff-service';
-export { formatHistoryMarkdown, getHistoryData, type HistoryData, handleHistoryCommand, type PhaseHistoryData, } from './history-service';
-export { formatPlanMarkdown, getPlanData, handlePlanCommand, type PlanData, } from './plan-service';
-export { createPreflightIntegration, type PreflightIntegrationConfig, runManualPreflight, } from './preflight-integration';
-export { formatPreflightMarkdown, handlePreflightCommand, type PreflightCheckResult, type PreflightCheckType, type PreflightConfig, type PreflightReport, runPreflight, } from './preflight-service';
-export { formatStatusMarkdown, getStatusData, handleStatusCommand, type StatusData, } from './status-service';

package/dist/services/plan-service.d.ts

@@ -1,25 +0,0 @@
-/**
- * Structured plan data for a specific phase or full plan.
- */
-export interface PlanData {
-    hasPlan: boolean;
-    fullMarkdown: string;
-    requestedPhase: number | null;
-    phaseMarkdown: string | null;
-    errorMessage: string | null;
-    isLegacy: boolean;
-}
-/**
- * Get plan data from the swarm directory.
- * Returns structured data for GUI, background flows, or commands.
- */
-export declare function getPlanData(directory: string, phaseArg?: string | number): Promise<PlanData>;
-/**
- * Format plan data as markdown for command output.
- */
-export declare function formatPlanMarkdown(planData: PlanData): string;
-/**
- * Handle plan command - delegates to service and formats output.
- * Kept for backward compatibility - thin adapter.
- */
-export declare function handlePlanCommand(directory: string, args: string[]): Promise<string>;

package/dist/services/preflight-integration.d.ts

@@ -1,38 +0,0 @@
-/**
- * Preflight Background Integration
- *
- * Wires the preflight service to background automation:
- * - Subscribes to preflight.requested events
- * - Runs preflight checks
- * - Updates status artifact with results
- */
-import { PreflightTriggerManager } from '../background/trigger';
-import type { AutomationConfig } from '../config/schema';
-import { type PreflightConfig, type PreflightReport } from '../services/preflight-service';
-/** Integration configuration */
-export interface PreflightIntegrationConfig {
-    /** Automation configuration (required for capability gating) */
-    automationConfig: AutomationConfig;
-    /** Directory to run preflight in */
-    directory: string;
-    /** Swarm directory for status artifact */
-    swarmDir: string;
-    /** Preflight check configuration */
-    preflightConfig?: PreflightConfig;
-    /** Whether to update status artifact (default true) */
-    updateStatusArtifact?: boolean;
-}
-/**
- * Create preflight integration
- *
- * Sets up the handler that will be called when preflight is requested.
- * Returns the trigger manager and cleanup function.
- */
-export declare function createPreflightIntegration(config: PreflightIntegrationConfig): {
-    manager: PreflightTriggerManager;
-    cleanup: () => void;
-};
-/**
- * Run preflight manually (for testing or CLI)
- */
-export declare function runManualPreflight(directory: string, phase: number, config?: PreflightConfig): Promise<PreflightReport>;

package/dist/services/preflight-service.d.ts

@@ -1,62 +0,0 @@
-/**
- * Preflight Automation Service
- *
- * Runs automated preflight checks for release readiness:
- * - lint check
- * - tests check (sane verification scope)
- * - secrets check
- * - evidence completeness check
- * - version consistency check
- *
- * Returns deterministic structured result with per-check status + overall verdict.
- * Callable by background flow (from preflight.requested events).
- */
-/** Preflight check types */
-export type PreflightCheckType = 'lint' | 'tests' | 'secrets' | 'evidence' | 'version';
-/** Individual check status */
-export interface PreflightCheckResult {
-    type: PreflightCheckType;
-    status: 'pass' | 'fail' | 'skip' | 'error';
-    message: string;
-    details?: Record<string, unknown>;
-    durationMs?: number;
-}
-/** Preflight report structure */
-export interface PreflightReport {
-    id: string;
-    timestamp: number;
-    phase: number;
-    overall: 'pass' | 'fail' | 'skipped';
-    checks: PreflightCheckResult[];
-    totalDurationMs: number;
-    message: string;
-}
-/** Preflight configuration */
-export interface PreflightConfig {
-    /** Timeout per check in ms (default 60s, min 5s, max 300s) */
-    checkTimeoutMs?: number;
-    /** Skip tests check (default false) */
-    skipTests?: boolean;
-    /** Skip secrets check (default false) */
-    skipSecrets?: boolean;
-    /** Skip evidence check (default false) */
-    skipEvidence?: boolean;
-    /** Skip version check (default false) */
-    skipVersion?: boolean;
-    /** Test scope (default 'convention' for faster preflight) */
-    testScope?: 'all' | 'convention' | 'graph';
-    /** Linter to use (default 'biome') */
-    linter?: 'biome' | 'eslint';
-}
-/**
- * Run all preflight checks
- */
-export declare function runPreflight(dir: string, phase: number, config?: PreflightConfig): Promise<PreflightReport>;
-/**
- * Format preflight report as markdown
- */
-export declare function formatPreflightMarkdown(report: PreflightReport): string;
-/**
- * Handle preflight command - thin adapter for CLI
- */
-export declare function handlePreflightCommand(directory: string, _args: string[]): Promise<string>;

package/dist/services/run-memory.d.ts

@@ -1,66 +0,0 @@
-/**
- * Run Memory Service
- *
- * Provides append-only per-task outcome logging for tracking task execution
- * results across swarm sessions. Used to avoid repeating known failure patterns.
- */
-/**
- * Represents a single task execution outcome entry
- */
-export interface RunMemoryEntry {
-    /** ISO timestamp when the entry was recorded */
-    timestamp: string;
-    /** Plan.json task ID (e.g. "3.2") */
-    taskId: string;
-    /** SHA256 hash of taskId + sorted file targets, first 8 chars */
-    taskFingerprint: string;
-    /** Which agent executed the task (e.g. "coder") */
-    agent: string;
-    /** Outcome of the task execution */
-    outcome: 'pass' | 'fail' | 'retry' | 'skip';
-    /** 1-indexed attempt number */
-    attemptNumber: number;
-    /** One-line failure reason (only for fail/retry outcomes) */
-    failureReason?: string;
-    /** Files that were modified during this attempt */
-    filesModified?: string[];
-    /** Wall-clock time in milliseconds */
-    durationMs?: number;
-}
-/**
- * Generate a task fingerprint from taskId and file targets
- *
- * @param taskId - The task identifier
- * @param fileTargets - Array of file paths that were targeted
- * @returns First 8 characters of SHA256 hash
- */
-export declare function generateTaskFingerprint(taskId: string, fileTargets: string[]): string;
-/**
- * Append a task outcome entry to the run memory log
- *
- * @param directory - The swarm workspace directory
- * @param entry - The outcome entry to record
- */
-export declare function recordOutcome(directory: string, entry: RunMemoryEntry): Promise<void>;
-/**
- * Get all entries for a specific task ID
- *
- * @param directory - The swarm workspace directory
- * @param taskId - The task identifier to filter by
- * @returns Array of matching entries
- */
-export declare function getTaskHistory(directory: string, taskId: string): Promise<RunMemoryEntry[]>;
-/**
- * Get all failure and retry entries
- *
- * @param directory - The swarm workspace directory
- * @returns Array of fail/retry entries
- */
-export declare function getFailures(directory: string): Promise<RunMemoryEntry[]>;
-/**
- * Generate a compact summary of task failures for context injection
- *
- * @param directory - The swarm workspace directory
- * @returns Formatted summary string (≤500 tokens) or null if no failures
- */
-export declare function getRunMemorySummary(directory: string): Promise<string | null>;

package/dist/services/status-service.d.ts

@@ -1,29 +0,0 @@
-import type { AgentDefinition } from '../agents';
-/**
- * Structured status data returned by the status service.
- * This can be used by GUI, background flows, or command adapters.
- */
-export interface StatusData {
-    hasPlan: boolean;
-    currentPhase: string;
-    completedTasks: number;
-    totalTasks: number;
-    agentCount: number;
-    isLegacy: boolean;
-    turboMode: boolean;
-}
-/**
- * Get status data from the swarm directory.
- * Returns structured data that can be used by GUI, background flows, or commands.
- */
-export declare function getStatusData(directory: string, agents: Record<string, AgentDefinition>): Promise<StatusData>;
-/**
- * Format status data as markdown for command output.
- * This is the thin adapter that delegates to the service.
- */
-export declare function formatStatusMarkdown(status: StatusData): string;
-/**
- * Handle status command - delegates to service and formats output.
- * Kept for backward compatibility - thin adapter.
- */
-export declare function handleStatusCommand(directory: string, agents: Record<string, AgentDefinition>): Promise<string>;

package/dist/services/status-service.turbo-indicator.test.d.ts

@@ -1,5 +0,0 @@
-/**
- * Tests for Task 3.18: Turbo Mode indicator in status output
- * Verifies that the status-service surfaces the current bypass mode
- */
-export {};

package/dist/session/snapshot-reader.d.ts

@@ -1,37 +0,0 @@
-/**
- * Session snapshot reader for OpenCode Swarm plugin.
- * Reads .swarm/session/state.json and rehydrates swarmState on plugin init.
- */
-import type { AgentSessionState } from '../state';
-import type { SerializedAgentSession, SnapshotData } from './snapshot-writer';
-/**
- * Deserialize a SerializedAgentSession back to AgentSessionState.
- * Handles Map/Set conversion and migration safety defaults.
- */
-export declare function deserializeAgentSession(s: SerializedAgentSession): AgentSessionState;
-/**
- * Read the snapshot file from .swarm/session/state.json.
- * Returns null if file doesn't exist, parse fails, or version is wrong.
- * NEVER throws - always returns null on any error.
- */
-export declare function readSnapshot(directory: string): Promise<SnapshotData | null>;
-/**
- * Rehydrate swarmState from a SnapshotData object.
- * Clears existing maps first, then populates from snapshot.
- * Does NOT touch activeToolCalls or pendingEvents (remain at defaults).
- */
-export declare function rehydrateState(snapshot: SnapshotData): void;
-/**
- * Reconcile task workflow states from plan.json for all active sessions.
- * Seeds completed plan tasks to 'tests_run' and in_progress tasks to 'coder_delegated'.
- * Best-effort: returns silently on any file/parse error. NEVER throws.
- *
- * @param directory - The project root directory containing .swarm/plan.json
- */
-export declare function reconcileTaskStatesFromPlan(directory: string): Promise<void>;
-/**
- * Load snapshot from disk and rehydrate swarmState.
- * Called on plugin init to restore state from previous session.
- * NEVER throws - swallows any errors silently.
- */
-export declare function loadSnapshot(directory: string): Promise<void>;

package/dist/session/snapshot-writer.d.ts

@@ -1,89 +0,0 @@
-/**
- * Session snapshot writer for OpenCode Swarm plugin.
- * Serializes swarmState to .swarm/session/state.json using atomic write (temp-file + rename).
- */
-import type { AgentSessionState, DelegationEntry, ToolAggregate } from '../state';
-import { swarmState } from '../state';
-/**
- * Serialized form of AgentSessionState with Map/Set fields converted to plain arrays/objects
- */
-export interface SerializedAgentSession {
-    agentName: string;
-    lastToolCallTime: number;
-    lastAgentEventTime: number;
-    delegationActive: boolean;
-    activeInvocationId: number;
-    lastInvocationIdByAgent: Record<string, number>;
-    windows: Record<string, SerializedInvocationWindow>;
-    lastCompactionHint: number;
-    architectWriteCount: number;
-    lastCoderDelegationTaskId: string | null;
-    currentTaskId: string | null;
-    turboMode: boolean;
-    gateLog: Record<string, string[]>;
-    reviewerCallCount: Record<string, number>;
-    lastGateFailure: {
-        tool: string;
-        taskId: string;
-        timestamp: number;
-    } | null;
-    partialGateWarningsIssuedForTask: string[];
-    selfFixAttempted: boolean;
-    selfCodingWarnedAtCount: number;
-    catastrophicPhaseWarnings: number[];
-    lastPhaseCompleteTimestamp: number;
-    lastPhaseCompletePhase: number;
-    phaseAgentsDispatched: string[];
-    lastCompletedPhaseAgentsDispatched: string[];
-    qaSkipCount: number;
-    qaSkipTaskIds: string[];
-    taskWorkflowStates?: Record<string, string>;
-    /** Flag for one-shot scope violation warning injection (omitted when undefined for additive-only schema) */
-    scopeViolationDetected?: boolean;
-}
-/**
- * Minimal interface for serialized InvocationWindow
- */
-interface SerializedInvocationWindow {
-    id: number;
-    agentName: string;
-    startedAtMs: number;
-    toolCalls: number;
-    consecutiveErrors: number;
-    hardLimitHit: boolean;
-    lastSuccessTimeMs: number;
-    recentToolCalls: Array<{
-        tool: string;
-        argsHash: number;
-        timestamp: number;
-    }>;
-    warningIssued: boolean;
-    warningReason: string;
-}
-/**
- * Snapshot data structure written to disk
- */
-export interface SnapshotData {
-    version: 1;
-    writtenAt: number;
-    toolAggregates: Record<string, ToolAggregate>;
-    activeAgent: Record<string, string>;
-    delegationChains: Record<string, DelegationEntry[]>;
-    agentSessions: Record<string, SerializedAgentSession>;
-}
-/**
- * Convert a live AgentSessionState to its serialized form.
- * Handles missing/undefined Map/Set fields gracefully (migration safety).
- */
-export declare function serializeAgentSession(s: AgentSessionState): SerializedAgentSession;
-/**
- * Write a snapshot of swarmState to .swarm/session/state.json atomically.
- * Silently swallows errors (non-fatal — never crash the plugin).
- */
-export declare function writeSnapshot(directory: string, state: typeof swarmState): Promise<void>;
-/**
- * Create a snapshot writer hook suitable for use in tool.execute.after.
- * Returns a hook function that writes the current swarmState to disk.
- */
-export declare function createSnapshotWriterHook(directory: string): (input: unknown, output: unknown) => Promise<void>;
-export {};

package/dist/skills/index.d.ts

@@ -1,30 +0,0 @@
-/**
- * Skill definition with versioning and per-agent overlays
- */
-export interface AgentOverlay {
-    agent: string;
-    prompt?: string;
-    model?: string;
-}
-export interface SkillDefinition {
-    id: string;
-    name: string;
-    description: string;
-    SKILL_VERSION: number;
-    basePrompt?: string;
-    agents?: AgentOverlay[];
-}
-export declare const skills: SkillDefinition[];
-export declare const AGENT_OVERLAYS: Record<string, AgentOverlay[]>;
-/**
- * Get skill by ID
- */
-export declare function getSkill(id: string): SkillDefinition | undefined;
-/**
- * Get agent overlay for a skill
- */
-export declare function getAgentOverlay(skillId: string, agent: string): AgentOverlay | undefined;
-/**
- * Resolve effective prompt for an agent on a skill
- */
-export declare function resolveAgentPrompt(skillId: string, agent: string, defaultPrompt: string): string;

package/dist/state.rehydrate.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/state.rehydration-adversarial.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/state.rehydration-integration.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/state.session-restart.test.d.ts

@@ -1,7 +0,0 @@
-/**
- * Adversarial security tests for Task 2.15: Session restart rehydration
- *
- * ONLY attack vectors - malformed inputs, oversized payloads, injection attempts, boundary violations
- * Tests the security hardening of rehydrateSessionFromDisk, readPlanFromDisk, and readEvidenceFromDisk
- */
-export {};

package/dist/summaries/index.d.ts

@@ -1,2 +0,0 @@
-export { cleanupSummaries, listSummaries, loadFullOutput, storeSummary, } from './manager';
-export { createSummary, detectContentType, HYSTERESIS_FACTOR, shouldSummarize, } from './summarizer';

package/dist/summaries/manager.d.ts

@@ -1,29 +0,0 @@
-/**
- * Validate and sanitize summary ID.
- * Must match regex ^S\d+$ (e.g., S1, S2, S99)
- * Rejects: empty string, null bytes, control characters, path traversal, non-matching patterns
- * @throws Error with descriptive message on failure
- */
-export declare function sanitizeSummaryId(id: string): string;
-/**
- * Store a summary entry to .swarm/summaries/{id}.json.
- * Performs atomic write via temp file + rename.
- * @throws Error if summary ID is invalid or size limit would be exceeded
- */
-export declare function storeSummary(directory: string, id: string, fullOutput: string, summaryText: string, maxStoredBytes: number): Promise<void>;
-/**
- * Load fullOutput from a summary entry.
- * Returns null if file doesn't exist or validation fails.
- */
-export declare function loadFullOutput(directory: string, id: string): Promise<string | null>;
-/**
- * List all summary IDs that have summary entries.
- * Returns sorted array of valid summary IDs.
- * Returns empty array if summaries directory doesn't exist.
- */
-export declare function listSummaries(directory: string): Promise<string[]>;
-/**
- * Delete summaries older than retentionDays.
- * Returns array of deleted summary IDs.
- */
-export declare function cleanupSummaries(directory: string, retentionDays: number): Promise<string[]>;