opencode-swarm 6.27.1 → 8.0.0-beta.0

package/dist/knowledge-migrator.d.ts

@@ -0,0 +1,2 @@
+export type { MigrationResult } from '@opencode-swarm/core';
+export { migrateContextToKnowledge } from '@opencode-swarm/core';

package/dist/knowledge-store.d.ts

@@ -0,0 +1 @@
+export { appendKnowledge, appendRejectedLesson, computeConfidence, findNearDuplicate, getPlatformConfigDir, inferTags, jaccardBigram, normalize, readKnowledge, readRejectedLessons, resolveHiveKnowledgePath, resolveHiveRejectedPath, resolveSwarmKnowledgePath, resolveSwarmRejectedPath, rewriteKnowledge, wordBigrams, } from '@opencode-swarm/core';

package/dist/knowledge-types.d.ts

@@ -0,0 +1 @@
+export type { HiveKnowledgeEntry, KnowledgeCategory, KnowledgeConfig, KnowledgeEntryBase, MessageInfo, MessagePart, PhaseConfirmationRecord, ProjectConfirmationRecord, RejectedLesson, RetrievalOutcome, SwarmKnowledgeEntry, } from '@opencode-swarm/core';

package/dist/knowledge-validator.d.ts

@@ -0,0 +1,2 @@
+export type { EntryHealthResult, QuarantinedEntry, ValidationResult, } from '@opencode-swarm/core';
+export { auditEntryHealth, DANGEROUS_COMMAND_PATTERNS, INJECTION_PATTERNS, quarantineEntry, restoreEntry, SECURITY_DEGRADING_PATTERNS, validateLesson, } from '@opencode-swarm/core';

package/dist/loader.d.ts

@@ -0,0 +1 @@
+export { loadPluginConfig, loadPluginConfigWithMeta, loadRawConfigFromPath, MAX_CONFIG_FILE_BYTES, } from '@opencode-swarm/core';

package/dist/manager.d.ts

@@ -0,0 +1 @@
+export { loadFullOutput } from '@opencode-swarm/core';

package/dist/models.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_MODELS: Record<string, string>;

package/dist/plan-service.d.ts

@@ -0,0 +1 @@
+export { formatPlanMarkdown, getPlanData, handlePlanCommand, type PlanData, } from '@opencode-swarm/core';

package/dist/preflight-service.d.ts

@@ -0,0 +1 @@
+export { formatPreflightMarkdown, handlePreflightCommand, type PreflightCheckResult, type PreflightCheckType, type PreflightConfig, type PreflightReport, runPreflight, } from '@opencode-swarm/core';

package/dist/profiles.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Language Profiles Bridge
+ *
+ * Re-exports language profile registry and types from @opencode-swarm/core.
+ * Maintains compatibility for legacy import paths.
+ */
+export { type BuildCommand, LANGUAGE_REGISTRY, type LanguageProfile, LanguageRegistry, type LintTool, type TestFramework, } from '@opencode-swarm/core';

package/dist/register.d.ts

@@ -0,0 +1,36 @@
+/**
+ * OpenCode Plugin Tool Registration
+ *
+ * Wraps core tool logic functions with createSwarmTool() for OpenCode plugin registration.
+ * Each tool:
+ * - Has plugin-compatible arg schema
+ * - Injects directory from plugin context
+ * - Returns serialized JSON/text consistent with current tool behavior
+ */
+import type { tool } from '@opencode-ai/plugin';
+type SwarmTool = ReturnType<typeof tool>;
+export declare const check_gate_status: SwarmTool;
+export declare const checkpoint: SwarmTool;
+export declare const complexity_hotspots: SwarmTool;
+export declare const declare_scope: SwarmTool;
+export declare const detect_domains: SwarmTool;
+export declare const diff: SwarmTool;
+export declare const evidence_check: SwarmTool;
+export declare const extract_code_blocks: SwarmTool;
+export declare const gitingest: SwarmTool;
+export declare const imports: SwarmTool;
+export declare const knowledge_query: SwarmTool;
+export declare const lint: SwarmTool;
+export declare const phase_complete: SwarmTool;
+export declare const pkg_audit: SwarmTool;
+export declare const pre_check_batch: SwarmTool;
+export declare const retrieve_summary: SwarmTool;
+export declare const save_plan: SwarmTool;
+export declare const schema_drift: SwarmTool;
+export declare const secretscan: SwarmTool;
+export declare const symbols: SwarmTool;
+export declare const test_runner: SwarmTool;
+export declare const todo_extract: SwarmTool;
+export declare const update_task_status: SwarmTool;
+export declare const write_retro: SwarmTool;
+export {};

package/dist/schema.d.ts

@@ -0,0 +1,2 @@
+export type { GuardrailsConfig, KnowledgeConfig, PluginConfig, } from '@opencode-swarm/core';
+export { KnowledgeConfigSchema } from '@opencode-swarm/core';

package/dist/snapshot-writer.d.ts

@@ -0,0 +1 @@
+export { writeSnapshot } from '@opencode-swarm/core';

package/dist/state.d.ts

@@ -1,292 +1 @@
-/**
- * Shared state module for OpenCode Swarm plugin.
- * Provides a module-scoped singleton for cross-hook state sharing.
- *
- * This module is used by multiple hooks (tool.execute.before, tool.execute.after,
- * chat.message, system-enhancer) to share state like active agents, tool call tracking,
- * and delegation chains.
- */
-/**
- * Represents a single tool call entry for tracking purposes
- */
-export interface ToolCallEntry {
-    tool: string;
-    sessionID: string;
-    callID: string;
-    startTime: number;
-}
-/**
- * Aggregated statistics for a specific tool
- */
-export interface ToolAggregate {
-    tool: string;
-    count: number;
-    successCount: number;
-    failureCount: number;
-    totalDuration: number;
-}
-/**
- * Represents a delegation from one agent to another
- */
-export interface DelegationEntry {
-    from: string;
-    to: string;
-    timestamp: number;
-}
-/**
- * Per-task workflow state for gate progression tracking.
- * Transitions must be forward-only: idle → coder_delegated → pre_check_passed → reviewer_run → tests_run → complete
- */
-export type TaskWorkflowState = 'idle' | 'coder_delegated' | 'pre_check_passed' | 'reviewer_run' | 'tests_run' | 'complete';
-/**
- * Represents per-session state for guardrail tracking.
- * Budget fields (toolCallCount, consecutiveErrors, etc.) have moved to InvocationWindow.
- * This interface now tracks session-level metadata and window management.
- */
-export interface AgentSessionState {
-    /** Current agent identity for this session */
-    agentName: string;
-    /** Timestamp of most recent tool call (for session-level stale detection) */
-    lastToolCallTime: number;
-    /** Timestamp of most recent agent identity event (chat.message) */
-    lastAgentEventTime: number;
-    /** Whether active delegation is in progress for this session */
-    delegationActive: boolean;
-    /** Current active invocation ID for this agent */
-    activeInvocationId: number;
-    /** Last invocation ID by agent name (e.g., { "coder": 3, "reviewer": 1 }) */
-    lastInvocationIdByAgent: Record<string, number>;
-    /** Active invocation windows keyed by "${agentName}:${invId}" */
-    windows: Record<string, InvocationWindow>;
-    /** Last tool-call threshold at which a compaction hint was issued */
-    lastCompactionHint: number;
-    /** Count of architect direct writes to non-.swarm/ files */
-    architectWriteCount: number;
-    /** Last task ID that was delegated to coder (for zero-delegation detection) */
-    lastCoderDelegationTaskId: string | null;
-    /** Current task ID being worked on (set when coder delegation fires, used for per-task gate tracking) */
-    currentTaskId: string | null;
-    /** Gate names observed for current task (taskId → Set of gates) */
-    gateLog: Map<string, Set<string>>;
-    /** Reviewer delegations per phase (phaseNumber → count) */
-    reviewerCallCount: Map<number, number>;
-    /** Last gate failure for self-fix detection */
-    lastGateFailure: {
-        tool: string;
-        taskId: string;
-        timestamp: number;
-    } | null;
-    /** Task IDs for which partial gate warning has already been issued (prevents per-task spam) */
-    partialGateWarningsIssuedForTask: Set<string>;
-    /** Whether architect attempted self-fix write after gate failure */
-    selfFixAttempted: boolean;
-    /** Value of architectWriteCount at the time the self-coding warning was last injected.
-     *  Warning is suppressed unless architectWriteCount has increased since last injection. */
-    selfCodingWarnedAtCount: number;
-    /** Phases that have already received a catastrophic zero-reviewer warning */
-    catastrophicPhaseWarnings: Set<number>;
-    /** Number of consecutive coder delegations without reviewer/test_engineer between them */
-    qaSkipCount: number;
-    /** Task IDs skipped without QA (for audit trail), reset when reviewer/test_engineer fires */
-    qaSkipTaskIds: string[];
-    /** Per-task workflow state — taskId → current state */
-    taskWorkflowStates: Map<string, TaskWorkflowState>;
-    /** Last gate outcome for deliberation preamble injection */
-    lastGateOutcome: {
-        gate: string;
-        taskId: string;
-        passed: boolean;
-        timestamp: number;
-    } | null;
-    /** Declared file scope for current coder task (null = no scope declared) */
-    declaredCoderScope: string[] | null;
-    /** Last scope violation message (null = no violation) */
-    lastScopeViolation: string | null;
-    /** Flag for one-shot scope violation warning injection in messagesTransform */
-    scopeViolationDetected?: boolean;
-    /** Files modified by the current coder task (populated by guardrails toolBefore/toolAfter, reset on new coder delegation) */
-    modifiedFilesThisCoderTask: string[];
-    /** Timestamp of most recent phase completion */
-    lastPhaseCompleteTimestamp: number;
-    /** Phase number of most recent phase completion */
-    lastPhaseCompletePhase: number;
-    /** Set of agents dispatched in current phase (normalized names) */
-    phaseAgentsDispatched: Set<string>;
-    /** Set of agents dispatched in the most recently completed phase (persisted across phase reset) */
-    lastCompletedPhaseAgentsDispatched: Set<string>;
-    /** Session-scoped Turbo Mode flag for controlling LLM inference speed */
-    turboMode: boolean;
-}
-/**
- * Represents a single agent invocation window with isolated guardrail budgets.
- * Each time the architect delegates to an agent, a new window is created.
- * Architect never creates windows (unlimited).
- */
-export interface InvocationWindow {
-    /** Unique ID for this invocation (increments per agent type) */
-    id: number;
-    /** Agent name (stripped of swarm prefix) */
-    agentName: string;
-    /** Timestamp when this invocation started */
-    startedAtMs: number;
-    /** Tool calls made in this invocation */
-    toolCalls: number;
-    /** Consecutive errors in this invocation */
-    consecutiveErrors: number;
-    /** Whether hard limit was hit for this invocation */
-    hardLimitHit: boolean;
-    /** Timestamp of most recent successful tool call */
-    lastSuccessTimeMs: number;
-    /** Circular buffer of recent tool calls (max 20) for repetition detection */
-    recentToolCalls: Array<{
-        tool: string;
-        argsHash: number;
-        timestamp: number;
-    }>;
-    /** Whether soft warning has been issued for this invocation */
-    warningIssued: boolean;
-    /** Human-readable warning reason */
-    warningReason: string;
-}
-/**
- * Singleton state object for sharing data across hooks
- */
-export declare const swarmState: {
-    /** Active tool calls — keyed by callID for before→after correlation */
-    activeToolCalls: Map<string, ToolCallEntry>;
-    /** Aggregated tool usage stats — keyed by tool name */
-    toolAggregates: Map<string, ToolAggregate>;
-    /** Active agent per session — keyed by sessionID, updated by chat.message hook */
-    activeAgent: Map<string, string>;
-    /** Delegation chains per session — keyed by sessionID */
-    delegationChains: Map<string, DelegationEntry[]>;
-    /** Number of events since last flush */
-    pendingEvents: number;
-    /** Per-session guardrail state — keyed by sessionID */
-    agentSessions: Map<string, AgentSessionState>;
-};
-/**
- * Reset all state to initial values - useful for testing
- */
-export declare function resetSwarmState(): void;
-/**
- * Start a new agent session with initialized guardrail state.
- * Also removes any stale sessions older than staleDurationMs.
- * @param sessionId - The session identifier
- * @param agentName - The agent associated with this session
- * @param staleDurationMs - Age threshold for stale session eviction (default: 120 min)
- * @param directory - Optional project directory for rehydrating workflow state from disk
- */
-export declare function startAgentSession(sessionId: string, agentName: string, staleDurationMs?: number, directory?: string): void;
-/**
- * End an agent session by removing it from the state.
- * NOTE: Currently unused in production — no session lifecycle teardown is wired up.
- * Sessions accumulate for the process lifetime. Callers should integrate this into
- * a session TTL or idle-timeout mechanism to prevent unbounded Map growth.
- * @param sessionId - The session identifier to remove
- */
-export declare function endAgentSession(sessionId: string): void;
-/**
- * Get an agent session state by session ID.
- * @param sessionId - The session identifier
- * @returns The AgentSessionState or undefined if not found
- */
-export declare function getAgentSession(sessionId: string): AgentSessionState | undefined;
-/**
- * Ensure a guardrail session exists for the given sessionID.
- * If one exists and agentName is provided and different, update it.
- * If none exists, create one.
- * Always updates lastToolCallTime.
- * @param sessionId - The session identifier
- * @param agentName - Optional agent name (if known)
- * @param directory - Optional project directory for rehydrating workflow state from disk
- * @returns The AgentSessionState
- */
-export declare function ensureAgentSession(sessionId: string, agentName?: string, directory?: string): AgentSessionState;
-/**
- * Update only the agent event timestamp (for stale detection).
- * Does NOT change agent name or reset guardrail state.
- * @param sessionId - The session identifier
- */
-export declare function updateAgentEventTime(sessionId: string): void;
-/**
- * Begin a new invocation window for the given agent.
- * Increments invocation ID, creates fresh budget counters.
- * Returns null for architect (unlimited, no window).
- *
- * @param sessionId - Session identifier
- * @param agentName - Agent name (with or without swarm prefix)
- * @returns New window or null if architect
- */
-export declare function beginInvocation(sessionId: string, agentName: string): InvocationWindow | null;
-/**
- * Get the currently active invocation window for the session.
- * Returns undefined if no window exists (e.g., architect session).
- *
- * @param sessionId - Session identifier
- * @returns Active window or undefined
- */
-export declare function getActiveWindow(sessionId: string): InvocationWindow | undefined;
-/**
- * Prune old invocation windows to prevent unbounded memory growth.
- * Removes windows older than maxAgeMs and keeps only the most recent maxWindows.
- *
- * @param sessionId - Session identifier
- * @param maxAgeMs - Maximum age in milliseconds (default 24 hours)
- * @param maxWindows - Maximum number of windows to keep (default 50)
- */
-export declare function pruneOldWindows(sessionId: string, maxAgeMs?: number, maxWindows?: number): void;
-/**
- * Record an agent dispatch for phase completion tracking.
- * Normalizes the agent name via stripKnownSwarmPrefix before adding to phaseAgentsDispatched.
- * @param sessionId - Session identifier
- * @param agentName - Agent name to record (will be normalized)
- */
-export declare function recordPhaseAgentDispatch(sessionId: string, agentName: string): void;
-/**
- * Advance a task's workflow state. Validates forward-only transitions.
- * Throws 'INVALID_TASK_STATE_TRANSITION: [taskId] [current] → [requested]' on illegal transition.
- * Safely returns without mutating state when taskId is null, undefined, empty, or whitespace-only.
- *
- * Valid forward order: idle → coder_delegated → pre_check_passed → reviewer_run → tests_run → complete
- *
- * @param session - The agent session state
- * @param taskId - The task identifier
- * @param newState - The requested new state
- */
-export declare function advanceTaskState(session: AgentSessionState, taskId: string, newState: TaskWorkflowState): void;
-/**
- * Get the current workflow state for a task.
- * Returns 'idle' if no entry exists.
- * Returns 'idle' for invalid taskId (null, undefined, empty, or whitespace-only).
- * If taskWorkflowStates is missing/invalid, initializes it as a new Map.
- *
- * @param session - The agent session state
- * @param taskId - The task identifier
- * @returns Current task workflow state
- */
-export declare function getTaskState(session: AgentSessionState, taskId: string): TaskWorkflowState;
-/**
- * Rehydrates session workflow state from durable swarm files.
- *
- * Reads `.swarm/plan.json` and `.swarm/evidence/*.json` from the provided
- * project directory, derives task workflow states from this data, and merges
- * them into the target AgentSessionState.
- *
- * Merge rules:
- * - Evidence-derived progression wins over plan-only state
- * - Existing in-memory workflow states for the same task IDs are NOT downgraded
- * - Missing/malformed `.swarm` data is non-fatal (silently skipped)
- *
- * This helper is useful for session restart scenarios where in-memory state
- * is lost but durable files persist.
- *
- * @param directory - Project root containing .swarm/ subdirectory
- * @param session - Target AgentSessionState to merge rehydrated state into
- */
-export declare function rehydrateSessionFromDisk(directory: string, session: AgentSessionState): Promise<void>;
-/**
- * Check if ANY active session has Turbo Mode enabled.
- * @returns true if any session has turboMode: true
- */
-export declare function hasActiveTurboMode(): boolean;
+export * from '@opencode-swarm/core';

package/dist/status-service.d.ts

@@ -0,0 +1,15 @@
+import { formatStatusMarkdown, type StatusData } from '@opencode-swarm/core';
+import type { AgentDefinition as OpenCodeAgentDefinition } from '../agents';
+/**
+ * Get status data - adapts local OpenCode agents to core type.
+ * The core service only uses Object.keys(agents).length for counting,
+ * so a safe cast is acceptable.
+ */
+export declare function getStatusData(directory: string, agents: Record<string, OpenCodeAgentDefinition>): Promise<StatusData>;
+/**
+ * Handle status command - adapts local OpenCode agents to core type.
+ * The core service only uses Object.keys(agents).length for counting,
+ * so a safe cast is acceptable.
+ */
+export declare function handleStatusCommand(directory: string, agents: Record<string, OpenCodeAgentDefinition>): Promise<string>;
+export { formatStatusMarkdown, type StatusData };