opencode-swarm 7.97.0 → 7.98.1

package/dist/services/external-skill-validator.d.ts

@@ -105,7 +105,13 @@ export declare const VALIDATION_RATE_LIMITS: {
     /** Timeout for individual fetch operations in milliseconds. */
     readonly fetch_timeout_ms: 30000;
 };
-declare function stripMarkdownCodeForUnsafeScan(text: string): string;
+interface MarkdownSegment {
+    value: string;
+    isCode: boolean;
+}
+declare function splitMarkdownCodeSegments(text: string): MarkdownSegment[];
+declare function isDangerousRemovalTarget(rawTarget: string): boolean;
+declare function hasDangerousRemovalTarget(text: string): boolean;
 /**
  * Scan an external skill candidate for prompt-injection patterns.
  *
@@ -158,6 +164,8 @@ export declare function evaluateCandidate(candidate: ExternalSkillCandidate, opt
 export declare const _internals: {
     getTimestamp: () => string;
     computeSha256: (content: string) => string;
-    stripMarkdownCodeForUnsafeScan: typeof stripMarkdownCodeForUnsafeScan;
+    splitMarkdownCodeSegments: typeof splitMarkdownCodeSegments;
+    hasDangerousRemovalTarget: typeof hasDangerousRemovalTarget;
+    isDangerousRemovalTarget: typeof isDangerousRemovalTarget;
 };
 export {};

package/dist/services/injection-budget.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Unified Injection Budget Service (FR-002).
+ *
+ * Pure, side-effect-free allocation function for the combined
+ * system-enhancer + knowledge-injector injection ceiling.
+ *
+ * Allocation strategy: proportional share.
+ * - When combined demand fits within the budget, each component receives its
+ *   full requested amount.
+ * - When one component alone exceeds the budget, it receives the entire budget
+ *   and the other receives zero (SC-005: single-component overrun is impossible).
+ * - When both together exceed the budget but neither alone does, the budget is
+ *   split proportionally to each component's demand. The system-enhancer
+ *   receives the floor of its proportional share; the knowledge-injector
+ *   receives the remainder so the total always equals the ceiling (SC-006).
+ *
+ * Proportional share is chosen over first-come-first-served because this
+ * service is a pure function with no knowledge of hook ordering; it must
+ * produce the same allocation regardless of which component calls first.
+ * Priority-based allocation would require an arbitrary component ranking
+ * not specified by the acceptance criteria.
+ *
+ * Char-to-token conversion uses the project's existing 0.33 tok/char ratio
+ * (matches `estimateTokens` in src/hooks/utils.ts:200).
+ */
+/**
+ * Allocation result for a single turn's unified injection budget.
+ */
+export interface InjectionBudgetAllocation {
+    /** Tokens granted to the system-enhancer (input was already in tokens). */
+    systemEnhancerTokens: number;
+    /** Tokens granted to the knowledge-injector (converted from chars to tokens). */
+    knowledgeInjectorTokens: number;
+    /** Sum of both allocations; never exceeds the configured budget. */
+    totalTokens: number;
+}
+/**
+ * Configuration for the unified injection budget.
+ */
+export interface InjectionBudgetConfig {
+    /** Unified ceiling (tokens) for combined system-enhancer + knowledge-injector injection per turn. */
+    totalBudgetTokens: number;
+}
+/**
+ * Allocate the unified injection budget between system-enhancer and
+ * knowledge-injector for a single turn.
+ *
+ * The allocation respects the configured ceiling and guarantees:
+ * - totalTokens ≤ config.totalBudgetTokens
+ * - If one component alone exceeds the budget, the other receives zero.
+ * - If combined demand fits, each receives its full demand.
+ * - If combined demand exceeds the budget but neither alone does, the split
+ *   is proportional to each component's demand.
+ *
+ * @param systemEnhancerDemandTokens - Tokens requested by the system-enhancer.
+ * @param knowledgeInjectorDemandChars - Characters requested by the knowledge-injector.
+ * @param config - Budget configuration containing the total ceiling.
+ * @returns Allocation breakdown with per-component token grants.
+ */
+export declare function allocateInjectionBudget(systemEnhancerDemandTokens: number, knowledgeInjectorDemandChars: number, config: InjectionBudgetConfig): InjectionBudgetAllocation;
+/**
+ * Reset the budget for a session to the full unified ceiling.
+ * Called by the first component to run for a given turn.
+ */
+export declare function resetUnifiedBudget(sessionID: string, totalBudget: number): void;
+/**
+ * Return the remaining unified budget for a session.
+ */
+export declare function getUnifiedBudgetRemaining(sessionID: string): number;
+/**
+ * Request a slice of the unified budget. Returns the granted token count.
+ * If the requester's need exceeds the remaining budget, it gets the remainder
+ * and the other source is implicitly blocked (remaining drops to 0).
+ */
+export declare function requestUnifiedBudget(sessionID: string, requestedTokens: number): number;
+/**
+ * Return the total unified budget configured for a session (or 0 if unset).
+ */
+export declare function getUnifiedBudgetTotal(sessionID: string): number;
+/**
+ * Remove a session's budget entry. Used for cleanup in tests.
+ */
+export declare function clearUnifiedBudget(sessionID: string): void;
+/**
+ * Ensure a budget entry exists for the session. Creates one with the full
+ * budget if none exists; leaves an existing entry untouched.
+ */
+export declare function ensureSessionBudget(sessionID: string, totalBudget: number): void;
+/**
+ * Store the system-enhancer's actual per-turn token demand so that
+ * knowledge-injector can read it and compute its proportional share.
+ */
+export declare function setSystemEnhancerDemand(sessionID: string, demand: number): void;
+/**
+ * Return the system-enhancer's actual per-turn token demand for a session.
+ * Returns 0 if no budget entry exists or demand was not set.
+ */
+export declare function getSystemEnhancerDemand(sessionID: string): number;

package/dist/summaries/summarizer.d.ts

@@ -26,6 +26,31 @@ export declare function detectContentType(output: string, toolName: string): Con
  * @returns true if the output should be summarized
  */
 export declare function shouldSummarize(output: string, thresholdBytes: number): boolean;
+/**
+ * Infer a compact type signature for a JSON value.
+ */
+declare function jsonTypeSignature(value: unknown): string;
+/**
+ * Build a structure-aware preview for a JSON object.
+ * Shows ALL top-level keys with their type signatures (AC-008 / SC-012).
+ */
+declare function summarizeJsonObject(parsed: Record<string, unknown>): string;
+/**
+ * Build a structure-aware preview for a JSON array.
+ */
+declare function summarizeJsonArray(parsed: unknown[]): string;
+/**
+ * Extract declaration names from code text.
+ */
+declare function extractCodeSignatures(code: string): string[];
+/**
+ * Build a preview for code output that includes declaration signatures.
+ */
+declare function summarizeCode(output: string): string;
+/**
+ * Build a preview for plain text output (leading non-blank lines).
+ */
+declare function summarizeText(output: string, maxLines: number): string;
 /**
  * Creates a structured summary string from tool output.
  * @param output - The full tool output string
@@ -35,4 +60,15 @@ export declare function shouldSummarize(output: string, thresholdBytes: number):
  * @returns Formatted summary string
  */
 export declare function createSummary(output: string, toolName: string, summaryId: string, maxSummaryChars: number): string;
+/**
+ * Internal helpers exposed for testability.
+ */
+export declare const _internals: {
+    jsonTypeSignature: typeof jsonTypeSignature;
+    summarizeJsonObject: typeof summarizeJsonObject;
+    summarizeJsonArray: typeof summarizeJsonArray;
+    extractCodeSignatures: typeof extractCodeSignatures;
+    summarizeCode: typeof summarizeCode;
+    summarizeText: typeof summarizeText;
+};
 export {};

package/dist/tools/context-status.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Context Status Tool
+ *
+ * Read-only tool that reports current context-window headroom for the active
+ * session. Derives messages from the runtime session context (via
+ * `swarmState.opencodeClient.session.messages`) and resolves thresholds from
+ * the plugin config, mirroring the active `createContextBudgetHandler` hook's
+ * behavior exactly — including strict `>` boundary semantics (exact threshold
+ * values do NOT trigger a warning).
+ *
+ * Pure read-only: no state mutation, no warning injection, no side effects.
+ * Works whether `context_budget.enabled` is true or false.
+ */
+import { loadPluginConfig } from '../config';
+import { createSwarmTool } from './create-tool';
+/**
+ * Shape of a message's info block.
+ * Mirrors the `MessageInfo` interface used by the context-budget hook.
+ */
+interface MessageInfo {
+    role: string;
+    agent?: string;
+    sessionID?: string;
+    modelID?: string;
+    providerID?: string;
+    [key: string]: unknown;
+}
+/**
+ * Shape of a single message part (text chunk).
+ * Mirrors the `MessagePart` interface used by the context-budget hook.
+ */
+interface MessagePart {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+}
+/**
+ * Shape of a single message in the session array.
+ * Mirrors `MessageWithParts` from the context-budget hook.
+ */
+export interface ContextMessage {
+    info: MessageInfo;
+    parts: MessagePart[];
+    [key: string]: unknown;
+}
+/**
+ * Result returned by the context_status tool.
+ */
+export interface ContextStatusResult {
+    /** Estimated tokens used across all text parts in the session */
+    tokensUsed: number;
+    /** Resolved model context limit in tokens */
+    modelLimit: number;
+    /** Ratio of tokens-used to model-limit (0.0 – 1.0+) */
+    usagePercent: number;
+    /** Threshold state: 'none' | 'warn' | 'critical' */
+    thresholdCrossed: 'none' | 'warn' | 'critical';
+    /** Model identifier detected from the most recent assistant message */
+    modelId: string | null;
+    /** Provider identifier detected from the most recent assistant message */
+    provider: string | null;
+}
+/**
+ * Test-only dependency-injection seam. Production code calls
+ * `_internals.loadPluginConfig(...)` and `_internals.fetchSessionMessages(...)`
+ * so tests can replace these functions without `mock.module` leakage across
+ * Bun's shared test-runner process. Mutating this local object is file-scoped
+ * and trivially restorable via `afterEach`.
+ */
+export declare const _internals: {
+    loadPluginConfig: typeof loadPluginConfig;
+    fetchSessionMessages: (sessionID: string, directory: string, limit?: number) => Promise<ContextMessage[] | null>;
+};
+/**
+ * Compute context headroom from a session message array.
+ * Pure function — no side effects, no logging, no state mutation.
+ *
+ * @param messages - Session messages (same shape as experimental.chat.messages.transform output)
+ * @param warnThreshold - Usage ratio that triggers 'warn' state (default 0.7)
+ * @param criticalThreshold - Usage ratio that triggers 'critical' state (default 0.9)
+ * @param modelLimitsConfig - Model-specific limit overrides from config
+ * @returns Context status with token usage, limit, and threshold state
+ */
+declare function computeContextHeadroom(messages: ContextMessage[], warnThreshold?: number, criticalThreshold?: number, modelLimitsConfig?: Record<string, number>): ContextStatusResult;
+/**
+ * context_status tool — read-only context window headroom report.
+ *
+ * Architects invoke this on demand to check how much context budget remains
+ * without triggering the reactive warning injection that the
+ * `createContextBudgetHandler` hook performs.
+ *
+ * The tool derives messages from the active session context (via
+ * `ctx.sessionID` and the OpenCode client session API) and resolves
+ * warn/critical thresholds from the plugin config, matching the live
+ * context-budget hook's behavior.
+ *
+ * No arguments required — the tool queries current state automatically.
+ *
+ * Returns JSON string with tokensUsed, modelLimit, usagePercent, thresholdCrossed, modelId, provider.
+ */
+export { computeContextHeadroom };
+export declare const context_status: ReturnType<typeof createSwarmTool>;

package/dist/tools/index.d.ts

@@ -10,6 +10,7 @@ export { checkpoint } from './checkpoint';
 export { co_change_analyzer } from './co-change-analyzer';
 export { completion_verify } from './completion-verify';
 export { complexity_hotspots } from './complexity-hotspots';
+export { context_status } from './context-status';
 export { submit_council_verdicts } from './convene-council';
 export { convene_general_council } from './convene-general-council';
 export { curator_analyze } from './curator-analyze';

package/dist/tools/manifest.d.ts

@@ -76,6 +76,7 @@ export declare const TOOL_MANIFEST: {
     knowledge_recall: () => ToolDefinition;
     knowledge_remove: () => ToolDefinition;
     co_change_analyzer: () => ToolDefinition;
+    context_status: () => ToolDefinition;
     search: () => ToolDefinition;
     ast_grep: () => ToolDefinition;
     actionlint_scan: () => ToolDefinition;

package/dist/tools/tool-metadata.d.ts

@@ -235,6 +235,10 @@ export declare const TOOL_METADATA: {
         description: string;
         agents: "architect"[];
     };
+    context_status: {
+        description: string;
+        agents: "architect"[];
+    };
     search: {
         description: string;
         agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "explorer" | "sme" | "critic_hallucination_verifier" | "critic_oversight" | "architect" | "researcher" | "docs_design" | "skill_improver" | "spec_writer")[];
@@ -301,19 +305,19 @@ export declare const TOOL_METADATA: {
     };
     skill_generate: {
         description: string;
-        agents: ("architect" | "skill_improver")[];
+        agents: "skill_improver"[];
     };
     skill_list: {
         description: string;
-        agents: ("architect" | "skill_improver")[];
+        agents: "skill_improver"[];
     };
     skill_apply: {
         description: string;
-        agents: "architect"[];
+        agents: never[];
     };
     skill_inspect: {
         description: string;
-        agents: ("architect" | "skill_improver")[];
+        agents: "skill_improver"[];
     };
     run_stale_reconciliation: {
         description: string;
@@ -321,15 +325,15 @@ export declare const TOOL_METADATA: {
     };
     skill_regenerate: {
         description: string;
-        agents: "architect"[];
+        agents: never[];
     };
     skill_retire: {
         description: string;
-        agents: "architect"[];
+        agents: never[];
     };
     skill_improve: {
         description: string;
-        agents: ("architect" | "skill_improver")[];
+        agents: "skill_improver"[];
     };
     spec_write: {
         description: string;

package/dist/tools/write-drift-evidence.d.ts

@@ -4,6 +4,7 @@
  * a gate-contract formatted evidence file.
  */
 import type { ToolDefinition } from '@opencode-ai/plugin/tool';
+import { isAcceptedVerdict2, normalizeVerdict2 } from '../evidence/normalize-verdict';
 /**
  * Arguments for the write_drift_evidence tool
  */
@@ -29,6 +30,16 @@ export interface WriteDriftEvidenceArgs {
  * @returns JSON string with success status and details
  */
 export declare function executeWriteDriftEvidence(args: WriteDriftEvidenceArgs, directory: string): Promise<string>;
+/**
+ * Dependency-injection seam for testing. Tests can temporarily replace these
+ * to verify that this writer delegates to the shared normalize-verdict module.
+ * Restore each entry in afterEach via the saved original reference.
+ */
+export declare const _internals: {
+    normalizeVerdict2: typeof normalizeVerdict2;
+    VERDICT_SET_2: readonly string[];
+    isAcceptedVerdict2: typeof isAcceptedVerdict2;
+};
 /**
  * Tool definition for write_drift_evidence
  */

package/dist/tools/write-hallucination-evidence.d.ts

@@ -7,6 +7,7 @@
  * write a plan snapshot — those side-effects belong to drift verification only.
  */
 import type { ToolDefinition } from '@opencode-ai/plugin/tool';
+import { isAcceptedVerdict2, normalizeVerdict2 } from '../evidence/normalize-verdict';
 /**
  * Arguments for the write_hallucination_evidence tool
  */
@@ -24,6 +25,16 @@ export interface WriteHallucinationEvidenceArgs {
  * Execute the write_hallucination_evidence tool.
  */
 export declare function executeWriteHallucinationEvidence(args: WriteHallucinationEvidenceArgs, directory: string): Promise<string>;
+/**
+ * Dependency-injection seam for testing. Tests can temporarily replace these
+ * to verify that this writer delegates to the shared normalize-verdict module.
+ * Restore each entry in afterEach via the saved original reference.
+ */
+export declare const _internals: {
+    normalizeVerdict2: typeof normalizeVerdict2;
+    VERDICT_SET_2: readonly string[];
+    isAcceptedVerdict2: typeof isAcceptedVerdict2;
+};
 /**
  * Tool definition for write_hallucination_evidence
  */

package/dist/tools/write-mutation-evidence.d.ts

@@ -7,6 +7,7 @@
  * write a plan snapshot — those side-effects belong to drift verification only.
  */
 import type { ToolDefinition } from '@opencode-ai/plugin/tool';
+import { isAcceptedVerdict4, normalizeVerdict4 } from '../evidence/normalize-verdict';
 /**
  * Arguments for the write_mutation_evidence tool
  */
@@ -28,6 +29,16 @@ export interface WriteMutationEvidenceArgs {
  * Execute the write_mutation_evidence tool.
  */
 export declare function executeWriteMutationEvidence(args: WriteMutationEvidenceArgs, directory: string): Promise<string>;
+/**
+ * Dependency-injection seam for testing. Tests can temporarily replace these
+ * to verify that this writer delegates to the shared normalize-verdict module.
+ * Restore each entry in afterEach via the saved original reference.
+ */
+export declare const _internals: {
+    normalizeVerdict4: typeof normalizeVerdict4;
+    VERDICT_SET_4: readonly string[];
+    isAcceptedVerdict4: typeof isAcceptedVerdict4;
+};
 /**
  * Tool definition for write_mutation_evidence
  */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.97.0",
+	"version": "7.98.1",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",