opencode-swarm 7.165.0 → 7.166.0

package/dist/observability/catalog.d.ts

@@ -1,8 +1,8 @@
 /**
  * The event catalog (issue #2029).
  *
- * Exactly 59 entries, matching the `TelemetryEvent` union at
- * `src/telemetry.ts:15-165`. Thirty-eight predate the #2029 contract; the 39th is
+ * Exactly 61 entries, matching the `TelemetryEvent` union at
+ * `src/telemetry.ts:16-172`. Thirty-eight predate the #2029 contract; the 39th is
  * `agent_conflict_detected` (previously emitted through a force-cast past the
  * type system), the 40th is `close_archive_result` (issue #2030 — the
  * structured close/archive result event), the 41st is the bounded diagnostic
@@ -28,7 +28,11 @@
  * `council_round_transition`, and the 59th is `council_attempt_unscoped`
  * (issue #2046 item 9 — canonical council attempt / accepted-transition
  * observations joined to the lifecycle correlation system via the
- * server-derived `councilRoundId`). These late
+ * server-derived `councilRoundId`). The 60th is
+ * `context_source_attribution` and the 61st is `verdict_row_pipe_recovery`
+ * (issue #2482 — D3: honest savings attribution with the omit-when-unknown
+ * rule, and the #2184 verdict-row pipe-recovery fidelity class in the event
+ * lifecycle). These late
  * additions are instances
  * of the defect class this contract exists to close: an event kind entering
  * the stream with no registration.
@@ -84,7 +88,7 @@ export interface CatalogEntry {
     /**
      * Whether an event of this kind must carry `trace.parentSpanId`.
      *
-     * `false` for all 59 entries today, and that is a truthful statement about
+     * `false` for all 61 entries today, and that is a truthful statement about
      * the current system rather than a placeholder: no producer supplies a
      * parent span, so `createObservation` never sets one. Setting this to `true`
      * for a kind whose producer cannot supply a parent would make every

package/dist/sandbox/executor.d.ts

@@ -51,6 +51,16 @@ export interface SandboxExecutor {
      * Returns a record of env vars to set/unset.
      */
     getEnvOverrides(): Record<string, string | null>;
+    /**
+     * Probe result for executors backed by a native runner binary (Windows).
+     * Optional: executors without a runner binary leave it undefined and
+     * /swarm diagnose omits the downgrade reason for them.
+     */
+    readonly probeResult?: {
+        error?: string;
+    } | null;
+    /** Reason recorded via disable(), if this executor was disabled. */
+    readonly disabledReason?: string | null;
 }
 export interface SandboxPolicyOptions {
     network_mode?: 'off' | 'on';

package/dist/sandbox/win32/runner-client.d.ts

@@ -10,6 +10,8 @@
  * kill() in finally blocks.
  */
 import { spawn, spawnSync } from 'node:child_process';
+/** Policy/probe protocol version this client speaks. */
+export declare const RUNNER_PROTOCOL_SCHEMA_VERSION = 1;
 /** Result of probing the runner binary for capabilities. */
 export interface RunnerProbeResult {
     available: boolean;
@@ -23,6 +25,8 @@ export interface RunnerProbeResult {
         is_admin: boolean;
         os_version: string;
         arch: string;
+        runner_version?: string;
+        protocol_schema_version?: number;
     } | null;
     error?: string;
 }
@@ -77,6 +81,8 @@ export interface SandboxPolicy {
     network_mode: 'off' | 'on';
     env_allowlist: string[];
     env_overrides: Record<string, string>;
+    /** Keys the runner must remove from the child environment (null overrides). */
+    env_unsets: string[];
     path_stubs: string[];
     private_desktop: boolean;
     deny_alternate_data_streams: boolean;
@@ -92,6 +98,7 @@ export declare const _internals: {
     findRunnerBinary: () => string | null;
     spawnRunner: typeof spawnSync;
     spawnAsync: typeof spawn;
+    runtimeDir: string | null;
 };
 /**
  * Probe the runner binary for capabilities.

package/dist/services/context-attribution.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Context-source savings attribution (issue #2482 / D3, absorbing #1990's
+ * honesty rule).
+ *
+ * Records, per injected context source, what the surface returned and what it
+ * plausibly saved versus reading the cited files in full:
+ *
+ * - `tokensReturned` — the token estimate of the actually-injected content.
+ * - `tokensSavedEstimate` = max(0, citedFileTokensTotal − tokensReturned),
+ *   explicitly labeled an estimate (payload flag `estimate: true`).
+ *
+ * HONESTY RULE (the deliverable, #1990): when the cited-file token total is
+ * unknown — no citation set, or no file size could be measured — this module
+ * records NOTHING for that call. No zero, no guess: absent measurements are
+ * omitted entirely rather than fabricated (a zero would silently claim the
+ * source saved nothing, which is a measurement we do not have).
+ *
+ * Emission is fail-open (never throws), rides the existing telemetry stream
+ * (legacy `.swarm/telemetry.jsonl` line + the SQLite observability sink from
+ * issue #2482), and is aggregated by `/swarm report`. This module creates no
+ * new durable file stream.
+ */
+import type { TelemetryEvent } from '../telemetry.js';
+/** Context sources recognized by the attribution event. */
+export type ContextAttributionSource = 'context_pack' | 'lane-orientation' | 'reflection' | 'ask';
+export interface ContextAttributionInput {
+    sessionId: string;
+    source: ContextAttributionSource;
+    /** Token estimate of the content actually returned/injected. */
+    tokensReturned: number;
+    /**
+     * Sum of token estimates over the cited files, or `undefined`/`null` when
+     * unknown (module then records nothing — the honesty rule).
+     */
+    citedFileTokensTotal?: number | null;
+    taskId?: string;
+}
+/** Token-per-cited-file measurement for one production injection site. */
+export interface CitedFileTokenMeasurement {
+    /** Total token estimate over the files whose sizes were measured. */
+    total: number;
+    /** Number of files whose size could NOT be measured (stat failed). */
+    unmeasured: number;
+}
+/**
+ * Estimate tokens from a byte length using the same chars-per-token heuristic
+ * family as `estimateTokens` (conservative 4 bytes/token). Used ONLY for
+ * file-size-based estimates where full content is not read.
+ */
+export declare function estimateTokensFromBytes(bytes: number): number;
+/**
+ * Measure the cited-file token total from file sizes. Files whose size cannot
+ * be measured are skipped (never counted as zero); `unmeasured` reports how
+ * many. The loop is bounded — a pathological citation set never turns into an
+ * unbounded stat storm.
+ */
+export declare function measureCitedFileTokens(filePaths: readonly string[], statFn: (p: string) => {
+    size: number;
+}, maxFiles?: number): CitedFileTokenMeasurement;
+/** DI seam (repo `_internals` convention). */
+export declare const _internals: {
+    emit: (event: TelemetryEvent, data: Record<string, unknown>) => void;
+};
+/**
+ * Record one context-source attribution. Emits the
+ * `context_source_attribution` event ONLY when both measurements are known
+ * (#1990 omit-when-unknown); returns true when an event was emitted.
+ */
+export declare function recordContextSourceAttribution(input: ContextAttributionInput): boolean;

package/dist/services/cost-accounting.d.ts

@@ -66,6 +66,8 @@ export type DelegationCostFields = TokenUsage & {
     model?: string;
     gate?: string;
     retry_index?: number;
+    /** #2482: marks a recovered eventless-terminal end (stale sweep / terminal-without-event). */
+    recovered?: boolean;
 };
 export type DelegationCostInput = {
     raw?: unknown;

package/dist/telemetry.d.ts

@@ -1,3 +1,4 @@
+import type { ObservabilityEvent } from './observability/envelope.js';
 import { createObservation, toLegacyTelemetryLine } from './observability/index.js';
 import type { DelegationCostFields } from './services/cost-accounting.js';
 export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activated' | 'delegation_begin' | 'delegation_end' | 'delegation_cost_correction' | 'delegation_cost_binding' | 'delegation_cost_join' | 'task_state_changed' | 'gate_passed' | 'gate_failed' | 'gate_parse_error' | 'reviewer_gate_decision' | 'phase_changed' | 'budget_updated' | 'context_pruned' | 'retrieval_routed' | 'model_fallback'
@@ -32,7 +33,7 @@ export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activa
  * `prm_hard_stop` TRIGGER emitted by `src/prm/escalation.ts`. A trigger with
  * no matching delivery means the containment never reached the agent.
  */
- | 'prm_hard_stop_delivered' | 'agent_conflict_detected' | 'close_archive_result' | 'knowledge_receipt_transition' | 'knowledge_maintenance' | 'residue_health' | 'context_telemetry_health' | 'skill_usage_health' | 'core_events_health' | 'shell_audit_health' | 'trajectory_health' | 'learning_health_alarm' | 'pr_subscription_health' | 'council_attempt' | 'council_round_transition' | 'council_attempt_unscoped';
+ | 'prm_hard_stop_delivered' | 'agent_conflict_detected' | 'close_archive_result' | 'knowledge_receipt_transition' | 'knowledge_maintenance' | 'residue_health' | 'context_telemetry_health' | 'skill_usage_health' | 'core_events_health' | 'shell_audit_health' | 'trajectory_health' | 'learning_health_alarm' | 'pr_subscription_health' | 'council_attempt' | 'council_round_transition' | 'council_attempt_unscoped' | 'context_source_attribution' | 'verdict_row_pipe_recovery';
 /** Stable classification for how a reviewer-gate decision was established. */
 export type ReviewerGateEvidenceKind = 'genuine' | 'fallback' | 'data_quality' | 'block';
 /**
@@ -42,7 +43,14 @@ export type ReviewerGateEvidenceKind = 'genuine' | 'fallback' | 'data_quality' |
  * analytics, so additions are allowed but existing values must not be renamed.
  */
 export type ReviewerGateReasonCode = 'lean_turbo_completed_lane' | 'standard_turbo_non_tier3' | 'durable_evidence_complete' | 'workflow_state_complete' | 'stage_b_parallel_complete' | 'no_active_sessions' | 'zero_valid_sessions' | 'restart_recovery_complete' | 'scoped_delegation_complete' | 'unscoped_delegation_complete' | 'corrupt_evidence' | 'required_gates_missing' | 'inspection_error';
-export type TelemetryListener = (event: TelemetryEvent, data: Record<string, unknown>) => void;
+export type TelemetryListener = (event: TelemetryEvent, data: Record<string, unknown>, 
+/**
+ * The canonical observability envelope built by this emit (issue #2482).
+ * Always passed positionally by `emit()`; optional so every existing
+ * two-argument listener stays assignable. The SQLite observability sink
+ * (`src/db/observability-event-store.ts`) is the canonical consumer.
+ */
+canonical?: ObservabilityEvent) => void;
 export declare function startHeartbeatTracking(): void;
 export declare function getLastHeartbeat(sessionId: string): number | undefined;
 export declare function stopHeartbeatTracking(): void;

package/opencode-swarm.schema.json

@@ -1875,7 +1875,7 @@
         },
         "auto_checkpoint_threshold": {
           "default": 3,
-          "description": "Maximum number of checkpoints to retain. Oldest checkpoints are evicted when this limit is exceeded.",
+          "description": "Number of completed tasks that trigger an automatic checkpoint. Retention of old checkpoints is controlled separately by max_retention.",
           "type": "integer",
           "minimum": 1,
           "maximum": 20

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.165.0",
+	"version": "7.166.0",
 	"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",

package/dist/cli/curator-llm-factory-fhbjwar0.js

@@ -1,70 +0,0 @@
-// @bun
-import {
-  createCuratorLLMDelegate
-} from "./index-hwz46jj7.js";
-import"./index-8d90gzaz.js";
-import"./index-f36hy1x4.js";
-import"./index-hdakb4n9.js";
-import"./index-k1ntjzmf.js";
-import"./index-5ythtd9t.js";
-import"./index-tqw8w2n5.js";
-import"./index-txdagbh7.js";
-import"./index-cw912re7.js";
-import"./index-6be5caj8.js";
-import"./index-n3pjcks8.js";
-import"./index-g8wdekzz.js";
-import"./index-70ha9e09.js";
-import"./index-dh5th4jn.js";
-import"./index-9ss2m4rs.js";
-import"./index-ptsqnxwd.js";
-import"./index-zsrtt42s.js";
-import"./index-7h94rfem.js";
-import"./index-6chhqq2n.js";
-import"./index-8bdk7124.js";
-import"./index-b43rt5ph.js";
-import"./index-q7sjgr1y.js";
-import"./index-e6n7cemz.js";
-import"./index-p7hdp3rp.js";
-import"./index-afpkqsdb.js";
-import"./index-gn6ybsc4.js";
-import"./index-anxs69ad.js";
-import"./index-z6xqpmqg.js";
-import"./index-p612v1mv.js";
-import"./index-2k53pfnc.js";
-import"./index-ajknebrc.js";
-import"./index-rtry5xyf.js";
-import"./index-58be2gtd.js";
-import"./index-3qf1vxtb.js";
-import"./index-n832052r.js";
-import"./index-3xyjvx24.js";
-import"./index-y1zhpfk8.js";
-import"./index-xwbn7c8m.js";
-import"./index-556ja8an.js";
-import"./index-6m24v15v.js";
-import"./index-e45htt92.js";
-import"./index-w6988bbc.js";
-import"./index-ry16d01s.js";
-import"./index-n4fzmqz8.js";
-import"./index-j2svfhzk.js";
-import"./index-c4ddtrqg.js";
-import"./index-ae75rja9.js";
-import"./index-6rx1rdaq.js";
-import"./index-7qefgq4j.js";
-import"./index-jre6tm3v.js";
-import"./index-gy0nyfbw.js";
-import"./index-5ebgzb5a.js";
-import"./index-7g4c7s5r.js";
-import"./index-zycp24b9.js";
-import"./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
-import"./index-0e9jh9c7.js";
-import"./index-a0d4fp6r.js";
-import"./index-zjygnfay.js";
-import"./index-bk5tah7q.js";
-import"./index-bpmtbmy9.js";
-import"./index-4fwbbad3.js";
-import"./index-zgwm4ryv.js";
-import"./index-a76rekgs.js";
-export {
-  createCuratorLLMDelegate
-};

package/dist/cli/guardrail-explain-1nfbtpgg.js

@@ -1,71 +0,0 @@
-// @bun
-import {
-  handleGuardrailExplain
-} from "./index-r5hj3nfe.js";
-import"./index-hwz46jj7.js";
-import"./index-8d90gzaz.js";
-import"./index-f36hy1x4.js";
-import"./index-hdakb4n9.js";
-import"./index-k1ntjzmf.js";
-import"./index-5ythtd9t.js";
-import"./index-tqw8w2n5.js";
-import"./index-txdagbh7.js";
-import"./index-cw912re7.js";
-import"./index-6be5caj8.js";
-import"./index-n3pjcks8.js";
-import"./index-g8wdekzz.js";
-import"./index-70ha9e09.js";
-import"./index-dh5th4jn.js";
-import"./index-9ss2m4rs.js";
-import"./index-ptsqnxwd.js";
-import"./index-zsrtt42s.js";
-import"./index-7h94rfem.js";
-import"./index-6chhqq2n.js";
-import"./index-8bdk7124.js";
-import"./index-b43rt5ph.js";
-import"./index-q7sjgr1y.js";
-import"./index-e6n7cemz.js";
-import"./index-p7hdp3rp.js";
-import"./index-afpkqsdb.js";
-import"./index-gn6ybsc4.js";
-import"./index-anxs69ad.js";
-import"./index-z6xqpmqg.js";
-import"./index-p612v1mv.js";
-import"./index-2k53pfnc.js";
-import"./index-ajknebrc.js";
-import"./index-rtry5xyf.js";
-import"./index-58be2gtd.js";
-import"./index-3qf1vxtb.js";
-import"./index-n832052r.js";
-import"./index-3xyjvx24.js";
-import"./index-y1zhpfk8.js";
-import"./index-xwbn7c8m.js";
-import"./index-556ja8an.js";
-import"./index-6m24v15v.js";
-import"./index-e45htt92.js";
-import"./index-w6988bbc.js";
-import"./index-ry16d01s.js";
-import"./index-n4fzmqz8.js";
-import"./index-j2svfhzk.js";
-import"./index-c4ddtrqg.js";
-import"./index-ae75rja9.js";
-import"./index-6rx1rdaq.js";
-import"./index-7qefgq4j.js";
-import"./index-jre6tm3v.js";
-import"./index-gy0nyfbw.js";
-import"./index-5ebgzb5a.js";
-import"./index-7g4c7s5r.js";
-import"./index-zycp24b9.js";
-import"./index-9e6fdz2h.js";
-import"./index-4rhhvd1a.js";
-import"./index-0e9jh9c7.js";
-import"./index-a0d4fp6r.js";
-import"./index-zjygnfay.js";
-import"./index-bk5tah7q.js";
-import"./index-bpmtbmy9.js";
-import"./index-4fwbbad3.js";
-import"./index-zgwm4ryv.js";
-import"./index-a76rekgs.js";
-export {
-  handleGuardrailExplain
-};