opencode-swarm 6.27.1 → 8.0.0-beta.0

package/dist/hooks/knowledge-types.d.ts

@@ -1,117 +0,0 @@
-/** Type definitions for the opencode-swarm v6.17 two-tier knowledge system. */
-export type KnowledgeCategory = 'process' | 'architecture' | 'tooling' | 'security' | 'testing' | 'debugging' | 'performance' | 'integration' | 'other';
-export interface PhaseConfirmationRecord {
-    phase_number: number;
-    confirmed_at: string;
-    project_name: string;
-}
-export interface ProjectConfirmationRecord {
-    project_name: string;
-    confirmed_at: string;
-    phase_number?: number;
-}
-export interface RetrievalOutcome {
-    applied_count: number;
-    succeeded_after_count: number;
-    failed_after_count: number;
-    last_applied_at?: string;
-}
-export interface KnowledgeEntryBase {
-    id: string;
-    tier: 'swarm' | 'hive';
-    lesson: string;
-    category: KnowledgeCategory;
-    tags: string[];
-    scope: string;
-    confidence: number;
-    status: 'candidate' | 'established' | 'promoted';
-    confirmed_by: PhaseConfirmationRecord[] | ProjectConfirmationRecord[];
-    retrieval_outcomes: RetrievalOutcome;
-    schema_version: number;
-    created_at: string;
-    updated_at: string;
-    hive_eligible?: boolean;
-    auto_generated?: boolean;
-}
-export interface SwarmKnowledgeEntry extends KnowledgeEntryBase {
-    tier: 'swarm';
-    confirmed_by: PhaseConfirmationRecord[];
-    project_name: string;
-}
-export interface HiveKnowledgeEntry extends KnowledgeEntryBase {
-    tier: 'hive';
-    confirmed_by: ProjectConfirmationRecord[];
-    source_project: string;
-    /** Weighted encounter score for hive advancement. Starts at 1.0 for originating project. */
-    encounter_score: number;
-    /** @deprecated Legacy field for backward compatibility. Use encounter_score for weighting. */
-    encounter_count?: number;
-}
-export interface RejectedLesson {
-    id: string;
-    lesson: string;
-    rejection_reason: string;
-    rejected_at: string;
-    rejection_layer: 1 | 2 | 3;
-}
-export interface KnowledgeConfig {
-    /** Enable or disable the entire knowledge system. Default: true */
-    enabled: boolean;
-    /** Maximum entries to keep in swarm knowledge.jsonl. Default: 100 */
-    swarm_max_entries: number;
-    /** Maximum entries to keep in hive shared-learnings.jsonl. Default: 200 */
-    hive_max_entries: number;
-    /** Days before auto-promotion to hive tier. Default: 90 */
-    auto_promote_days: number;
-    /** Maximum knowledge entries to inject per architect message. Default: 5 */
-    max_inject_count: number;
-    /** Jaccard bigram similarity threshold for deduplication. Default: 0.6 */
-    dedup_threshold: number;
-    /** Scope filters to apply when reading knowledge. Default: ['global'] */
-    scope_filter: string[];
-    /** Enable hive (cross-project) tier reads and writes. Default: true */
-    hive_enabled: boolean;
-    /** Maximum rejected lesson fingerprints to retain. Default: 20 */
-    rejected_max_entries: number;
-    /** Enable validation gate before storing lessons. Default: true */
-    validation_enabled: boolean;
-    /** Confidence threshold for marking an entry evergreen. Default: 0.9 */
-    evergreen_confidence: number;
-    /** Utility score threshold for marking an entry evergreen. Default: 0.8 */
-    evergreen_utility: number;
-    /** Utility score at or below which an entry is considered low-utility. Default: 0.3 */
-    low_utility_threshold: number;
-    /** Minimum retrieval count before utility scoring begins. Default: 3 */
-    min_retrievals_for_utility: number;
-    /** JSONL schema version. Default: 1 */
-    schema_version: number;
-    /** Weighted scoring: multiplier for encounters from the source project. Default: 1.0 */
-    same_project_weight: number;
-    /** Weighted scoring: multiplier for encounters from other projects. Default: 0.5 */
-    cross_project_weight: number;
-    /** Weighted scoring: minimum encounter score floor. Default: 0.1 */
-    min_encounter_score: number;
-    /** Weighted scoring: initial score for newly promoted hive entries. Default: 1.0 */
-    initial_encounter_score: number;
-    /** Weighted scoring: score increment per encounter. Default: 0.1 */
-    encounter_increment: number;
-    /** Weighted scoring: maximum encounter score cap. Default: 10.0 */
-    max_encounter_score: number;
-}
-export interface MessageInfo {
-    role: string;
-    agent?: string;
-    sessionID?: string;
-    modelID?: string;
-    providerID?: string;
-    [key: string]: unknown;
-}
-export interface MessagePart {
-    type: string;
-    text?: string;
-    [key: string]: unknown;
-}
-export interface MessageWithParts {
-    info: MessageInfo;
-    parts: MessagePart[];
-}

package/dist/hooks/knowledge-validator.d.ts

@@ -1,28 +0,0 @@
-/** Three-layer validation gate for the opencode-swarm v6.17 knowledge system. */
-import type { KnowledgeCategory, KnowledgeEntryBase } from './knowledge-types.js';
-export interface ValidationResult {
-    valid: boolean;
-    layer: 1 | 2 | 3 | null;
-    reason: string | null;
-    severity: 'error' | 'warning' | null;
-}
-export declare const DANGEROUS_COMMAND_PATTERNS: RegExp[];
-export declare const SECURITY_DEGRADING_PATTERNS: RegExp[];
-export declare const INJECTION_PATTERNS: RegExp[];
-export declare function validateLesson(candidate: string, existingLessons: string[], meta: {
-    category: KnowledgeCategory;
-    scope: string;
-    confidence: number;
-}): ValidationResult;
-export interface QuarantinedEntry extends KnowledgeEntryBase {
-    quarantine_reason: string;
-    quarantined_at: string;
-    reported_by: 'architect' | 'user' | 'auto';
-}
-export interface EntryHealthResult {
-    healthy: boolean;
-    concern?: string;
-}
-export declare function auditEntryHealth(entry: KnowledgeEntryBase): EntryHealthResult;
-export declare function quarantineEntry(directory: string, entryId: string, reason: string, reportedBy: 'architect' | 'user' | 'auto'): Promise<void>;
-export declare function restoreEntry(directory: string, entryId: string): Promise<void>;

package/dist/hooks/message-priority.d.ts

@@ -1,105 +0,0 @@
-/**
- * Message Priority Classifier Hook
- *
- * Provides zero-cost message priority classification to enable intelligent
- * context pruning. Messages are tagged with priority tiers (0-4) so that
- * low-priority messages are removed first during context budget pressure.
- *
- * Priority tiers:
- * - CRITICAL (0): System prompt, plan state, active instructions
- * - HIGH (1): User messages, current task context, tool definitions
- * - MEDIUM (2): Recent assistant responses, recent tool results
- * - LOW (3): Old assistant responses, old tool results, confirmations
- * - DISPOSABLE (4): Duplicate reads, superseded writes, stale errors
- */
-/**
- * Message priority tiers for context pruning decisions.
- * Lower values = higher priority (kept longer during pruning).
- */
-export declare const MessagePriority: {
-    /** System prompt, plan state, active instructions - never prune */
-    readonly CRITICAL: 0;
-    /** User messages, current task context, tool definitions */
-    readonly HIGH: 1;
-    /** Recent assistant responses, recent tool results (within recentWindowSize) */
-    readonly MEDIUM: 2;
-    /** Old assistant responses, old tool results */
-    readonly LOW: 3;
-    /** Duplicate reads, superseded writes, stale errors - prune first */
-    readonly DISPOSABLE: 4;
-};
-export type MessagePriorityType = (typeof MessagePriority)[keyof typeof MessagePriority];
-/** Message structure matching the format from context-budget.ts */
-interface MessageInfo {
-    role?: string;
-    agent?: string;
-    sessionID?: string;
-    modelID?: string;
-    providerID?: string;
-    toolName?: string;
-    toolArgs?: unknown;
-    [key: string]: unknown;
-}
-interface MessagePart {
-    type?: string;
-    text?: string;
-    [key: string]: unknown;
-}
-export interface MessageWithParts {
-    info?: MessageInfo;
-    parts?: MessagePart[];
-}
-/**
- * Checks if text contains .swarm/plan or .swarm/context references
- * indicating swarm state that should be preserved.
- *
- * @param text - The text content to check
- * @returns true if the text contains plan/context references
- */
-export declare function containsPlanContent(text: string): boolean;
-/**
- * Checks if a message is a tool result (assistant message with tool call).
- *
- * @param message - The message to check
- * @returns true if the message appears to be a tool result
- */
-export declare function isToolResult(message: MessageWithParts): boolean;
-/**
- * Checks if two consecutive tool read calls are duplicates
- * (same tool with same first argument).
- *
- * @param current - The current message
- * @param previous - The previous message
- * @returns true if this is a duplicate tool read
- */
-export declare function isDuplicateToolRead(current: MessageWithParts, previous: MessageWithParts): boolean;
-/**
- * Checks if a message contains an error pattern and is stale
- * (more than the specified number of turns old).
- *
- * @param text - The message text to check
- * @param turnsAgo - How many turns ago the message was sent
- * @returns true if the message is a stale error
- */
-export declare function isStaleError(text: string, turnsAgo: number): boolean;
-/**
- * Classifies a message by priority tier for intelligent pruning.
- *
- * @param message - The message to classify
- * @param index - Position in messages array (0-indexed)
- * @param totalMessages - Total number of messages
- * @param recentWindowSize - Number of recent messages to consider MEDIUM (default 10)
- * @returns Priority tier (0=CRITICAL, 1=HIGH, 2=MEDIUM, 3=LOW, 4=DISPOSABLE)
- */
-export declare function classifyMessage(message: MessageWithParts, index: number, totalMessages: number, recentWindowSize?: number): MessagePriorityType;
-/**
- * Classifies a batch of messages with duplicate detection.
- * This function should be called in order (oldest to newest) to properly
- * detect consecutive duplicate tool reads.
- *
- * @param messages - Array of messages to classify
- * @param recentWindowSize - Number of recent messages to consider MEDIUM (default 10)
- * @returns Array of priority classifications matching message order
- */
-export declare function classifyMessages(messages: MessageWithParts[], recentWindowSize?: number): MessagePriorityType[];
-export {};

package/dist/hooks/messages-transform.d.ts

@@ -1,13 +0,0 @@
-/**
- * Consolidates multiple system messages into a single system message at index 0.
- *
- * Note: Merged content order matches original insertion order (OpenCode base prompt
- * first, then swarm agent prompt) - this assumes sequential message construction.
- */
-type Message = {
-    role: string;
-    content: unknown;
-    [key: string]: unknown;
-};
-export declare function consolidateSystemMessages(messages: Message[]): Message[];
-export {};

package/dist/hooks/model-limits.d.ts

@@ -1,96 +0,0 @@
-/**
- * Provider-Aware Model Limit Resolution
- *
- * Resolves context window limits based on the model and provider platform.
- * The same model has different context limits depending on the provider:
- * - Claude Sonnet 4.6: 200k native, 128k on Copilot
- * - GPT-5: 400k native, 128k on Copilot
- * - Copilot caps ALL models at 128k prompt, regardless of native limit
- */
-/**
- * Native model context limits (in tokens) when used on their native platform.
- */
-export declare const NATIVE_MODEL_LIMITS: Record<string, number>;
-/**
- * Provider-specific context caps that override native limits.
- * These are typically lower than native limits (e.g., Copilot caps at 128k).
- */
-export declare const PROVIDER_CAPS: Record<string, number>;
-/**
- * Message structure from experimental.chat.messages.transform hook.
- */
-interface MessageInfo {
-    role: string;
-    agent?: string;
-    sessionID?: string;
-    modelID?: string;
-    providerID?: string;
-    [key: string]: unknown;
-}
-interface MessagePart {
-    type: string;
-    text?: string;
-    [key: string]: unknown;
-}
-interface MessageWithParts {
-    info: MessageInfo;
-    parts: MessagePart[];
-}
-/**
- * Extracts modelID and providerID from the most recent assistant message.
- *
- * @param messages - Array of messages from experimental.chat.messages.transform hook
- * @returns Object containing modelID and/or providerID if found
- *
- * @example
- * const info = extractModelInfo(messages);
- * // Returns: { modelID: 'claude-sonnet-4-6', providerID: 'anthropic' }
- * // Or: {} if no assistant messages or fields not found
- */
-export declare function extractModelInfo(messages: MessageWithParts[]): {
-    modelID?: string;
-    providerID?: string;
-};
-/**
- * Resolves the context limit for a given model/provider combination.
- *
- * Resolution order (first match wins):
- * 1. Check configOverrides["provider/model"] (e.g., "copilot/claude-sonnet-4-6": 200000)
- * 2. Check configOverrides[modelID] (e.g., "claude-sonnet-4-6": 200000)
- * 3. Check PROVIDER_CAPS[providerID] (e.g., copilot → 128000)
- * 4. Check NATIVE_MODEL_LIMITS with prefix matching (e.g., "claude-sonnet-4" matches "claude-sonnet-4-6-20260301")
- * 5. Check configOverrides.default
- * 6. Fall back to 128000
- *
- * @param modelID - The model identifier (e.g., "claude-sonnet-4-6", "gpt-5")
- * @param providerID - The provider identifier (e.g., "copilot", "anthropic")
- * @param configOverrides - User configuration overrides
- * @returns The resolved context limit in tokens
- *
- * @example
- * // Provider cap (copilot)
- * resolveModelLimit("claude-sonnet-4-6", "copilot", {})
- * // Returns: 128000
- *
- * @example
- * // Native limit (anthropic)
- * resolveModelLimit("claude-sonnet-4-6", "anthropic", {})
- * // Returns: 200000
- *
- * @example
- * // Override beats cap
- * resolveModelLimit("gpt-5", "copilot", { "copilot/gpt-5": 200000 })
- * // Returns: 200000
- *
- * @example
- * // Prefix match for model variants
- * resolveModelLimit("claude-sonnet-4-6-20260301", "anthropic", {})
- * // Returns: 200000
- *
- * @example
- * // Full fallback
- * resolveModelLimit(undefined, undefined, {})
- * // Returns: 128000
- */
-export declare function resolveModelLimit(modelID?: string, providerID?: string, configOverrides?: Record<string, number>): number;
-export {};

package/dist/hooks/phase-monitor.d.ts

@@ -1,22 +0,0 @@
-/**
- * Phase Monitor Hook
- *
- * Detects phase transitions by reading plan state on each system prompt transform.
- * When a phase change is detected, triggers preflight via PreflightTriggerManager.
- * Wrapped in safeHook — errors must never propagate.
- */
-import type { PreflightTriggerManager } from '../background/trigger';
-import type { CuratorConfig, CuratorInitResult } from './curator-types';
-/** Injectable curator runner type — allows test injection without module mocking. */
-export type CuratorInitRunner = (directory: string, config: CuratorConfig) => Promise<CuratorInitResult>;
-/**
- * Creates a hook that monitors plan phase transitions and triggers preflight.
- *
- * @param directory - Project directory (where .swarm/ lives)
- * @param preflightManager - Optional PreflightTriggerManager to call on phase change.
- *   When undefined, preflight checks are skipped but curator initialization still runs
- *   at session start (useful when knowledge.enabled but phase_preflight is disabled).
- * @param curatorRunner - Optional curator init runner (defaults to runCuratorInit; injectable for tests)
- * @returns A safeHook-wrapped system.transform handler
- */
-export declare function createPhaseMonitorHook(directory: string, preflightManager?: PreflightTriggerManager, curatorRunner?: CuratorInitRunner): (input: unknown, output: unknown) => Promise<void>;

package/dist/hooks/pipeline-tracker.d.ts

@@ -1,41 +0,0 @@
-/**
- * Pipeline Tracker Hook
- *
- * Injects phase reminders into messages to keep the Architect on track.
- * Uses experimental.chat.messages.transform so it doesn't show in UI.
- *
- * Research: "LLMs Get Lost In Multi-Turn Conversation" shows ~40% compliance
- * drop after 2-3 turns without reminders.
- */
-import type { PluginConfig } from '../config';
-/**
- * Build dynamic phase reminder with compliance escalation based on phase number.
- * Counteracts temporal compliance decay discovered during field testing.
- */
-export declare function buildPhaseReminder(phaseNumber: number | null): string;
-interface MessageInfo {
-    role: string;
-    agent?: string;
-    sessionID?: string;
-}
-interface MessagePart {
-    type: string;
-    text?: string;
-    [key: string]: unknown;
-}
-interface MessageWithParts {
-    info: MessageInfo;
-    parts: MessagePart[];
-}
-/**
- * Creates the experimental.chat.messages.transform hook for pipeline tracking.
- * Only injects for the architect agent.
- */
-export declare function createPipelineTrackerHook(config: PluginConfig, directory?: string): {
-    'experimental.chat.messages.transform'?: undefined;
-} | {
-    'experimental.chat.messages.transform': (input: Record<string, never>, output: {
-        messages?: MessageWithParts[];
-    }) => Promise<void>;
-};
-export {};

package/dist/hooks/steering-consumed.d.ts

@@ -1,30 +0,0 @@
-/**
- * Steering consumed hook for OpenCode Swarm
- *
- * Provides mechanisms for recording and tracking steering directive consumption.
- * Writes steering-consumed events to .swarm/events.jsonl for health check verification.
- */
-/**
- * Event written to .swarm/events.jsonl when a steering directive is consumed
- */
-export interface SteeringConsumedEvent {
-    type: 'steering-consumed';
-    directiveId: string;
-    timestamp: string;
-}
-/**
- * Records a steering-consumed event to the events.jsonl file.
- * Synchronous function that appends a single JSON line.
- *
- * @param directory - The project directory containing the .swarm folder
- * @param directiveId - The ID of the steering directive that was consumed
- */
-export declare function recordSteeringConsumed(directory: string, directiveId: string): void;
-/**
- * Creates a hook that records steering-consumed events for any unconsumed directives.
- * Reads events.jsonl to find steering-directive events without matching consumed events.
- *
- * @param directory - The project directory containing the .swarm folder
- * @returns A fire-and-forget hook function
- */
-export declare function createSteeringConsumedHook(directory: string): (input: unknown, output: unknown) => Promise<void>;

package/dist/hooks/system-enhancer.d.ts

@@ -1,30 +0,0 @@
-/**
- * System Enhancer Hook
- *
- * Enhances the system prompt with current phase information from the plan
- * and cross-agent context from the activity log.
- * Reads plan.md and injects phase context into the system prompt.
- */
-import type { PluginConfig } from '../config';
-/**
- * Build a retrospective injection string for the architect system message.
- * Tier 1: direct phase-scoped lookup for same-plan previous phase.
- * Tier 2: cross-project historical lessons (Phase 1 only).
- * Returns null if no valid retrospective found.
- */
-export declare function buildRetroInjection(directory: string, currentPhaseNumber: number, currentPlanTitle?: string): Promise<string | null>;
-/**
- * Creates the experimental.chat.system.transform hook for system enhancement.
- */
-export declare function createSystemEnhancerHook(config: PluginConfig, directory: string): Record<string, unknown>;
-/**
- * Architect operational mode derived from plan state.
- */
-export type ArchitectMode = 'DISCOVER' | 'PLAN' | 'EXECUTE' | 'PHASE-WRAP' | 'UNKNOWN';
-/**
- * Detect the current architect operational mode based on plan state.
- *
- * @param directory - The project directory to check
- * @returns The current architect mode based on plan state
- */
-export declare function detectArchitectMode(directory: string): Promise<ArchitectMode>;

package/dist/hooks/tool-summarizer.d.ts

@@ -1,28 +0,0 @@
-/**
- * Tool Output Summarizer Hook
- *
- * Intercepts oversized tool outputs in tool.execute.after,
- * stores the full content to .swarm/summaries/, and replaces
- * the output with a compact summary containing a retrieval ID.
- */
-import type { SummaryConfig } from '../config/schema';
-/**
- * Reset the summary ID counter. Used for testing.
- */
-export declare function resetSummaryIdCounter(): void;
-/**
- * Creates a tool.execute.after hook that summarizes oversized tool outputs.
- *
- * @param config - Summary configuration including enabled, thresholds, and limits
- * @param directory - Base directory for storing full outputs
- * @returns Async hook function for tool.execute.after
- */
-export declare function createToolSummarizerHook(config: SummaryConfig, directory: string): (input: {
-    tool: string;
-    sessionID: string;
-    callID: string;
-}, output: {
-    title: string;
-    output: string;
-    metadata: unknown;
-}) => Promise<void>;

package/dist/hooks/utils.d.ts

@@ -1,20 +0,0 @@
-/**
- * Shared hook utilities for OpenCode Swarm
- *
- * This module provides common utilities for working with hooks,
- * including error handling, handler composition, file I/O, and
- * token estimation for swarm-related operations.
- */
-export declare function safeHook<I, O>(fn: (input: I, output: O) => Promise<void>): (input: I, output: O) => Promise<void>;
-export declare function composeHandlers<I, O>(...fns: Array<(input: I, output: O) => Promise<void>>): (input: I, output: O) => Promise<void>;
-/**
- * Validates that a filename is safe to use within the .swarm directory
- *
- * @param directory - The base directory containing the .swarm folder
- * @param filename - The filename to validate
- * @returns The resolved absolute path if validation passes
- * @throws Error if the filename is invalid or attempts path traversal
- */
-export declare function validateSwarmPath(directory: string, filename: string): string;
-export declare function readSwarmFileAsync(directory: string, filename: string): Promise<string | null>;
-export declare function estimateTokens(text: string): number;

package/dist/index.adversarial-bootstrap.test.d.ts

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

package/dist/index.bootstrap-adversarial.test.d.ts

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

package/dist/index.bootstrap-directory.test.d.ts

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

package/dist/knowledge/identity.d.ts

@@ -1,25 +0,0 @@
-/** Project Identity Management for opencode-swarm.
- * Handles creation and retrieval of project identity files.
- */
-export interface ProjectIdentity {
-    projectHash: string;
-    projectName: string;
-    repoUrl?: string;
-    absolutePath: string;
-    createdAt: string;
-    swarmVersion: string;
-}
-/**
- * Get identity file path for a project hash.
- * Path: {platform-config-dir}/projects/{projectHash}/identity.json
- */
-export declare function resolveIdentityPath(projectHash: string): string;
-/**
- * Read existing identity.json or return null if it doesn't exist.
- */
-export declare function readProjectIdentity(projectHash: string): Promise<ProjectIdentity | null>;
-/**
- * Create or update identity.json for a project.
- * Uses atomic write pattern (write to temp file, then rename).
- */
-export declare function writeProjectIdentity(directory: string, projectHash: string, projectName: string): Promise<ProjectIdentity>;

package/dist/knowledge/index.d.ts

@@ -1,2 +0,0 @@
-/** Knowledge system exports for opencode-swarm. */
-export * from './identity.js';

package/dist/lang/detector.d.ts

@@ -1,20 +0,0 @@
-/**
- * Language Detection Utilities
- *
- * Provides detectProjectLanguages() for scanning a project directory
- * and getProfileForFile() for resolving a language profile from a file path.
- * No tool logic — pure detection only.
- */
-import { type LanguageProfile } from './profiles.js';
-/**
- * Resolve a language profile from a file path based on its extension.
- * Returns undefined for files with no extension or unknown extensions.
- */
-export declare function getProfileForFile(filePath: string): LanguageProfile | undefined;
-/**
- * Scan a project directory (and immediate subdirectories) to detect active languages.
- * Detection is based on presence of build indicator files or source files with known extensions.
- * Returns unique profiles in priority order (Tier 1 first, then Tier 2, then Tier 3).
- * Skips unreadable directories silently.
- */
-export declare function detectProjectLanguages(projectDir: string): Promise<LanguageProfile[]>;

package/dist/lang/index.d.ts

@@ -1,4 +0,0 @@
-export * from './detector';
-export * from './profiles';
-export * from './registry';
-export * from './runtime';