opencode-swarm 7.183.0 → 7.184.0

package/dist/services/config-doctor.d.ts

@@ -5,6 +5,30 @@
  * classifies findings by severity, and proposes safe auto-fixes.
  */
 import type { PluginConfig } from '../config/schema';
+/**
+ * Current config format version (issue #2504). Version 3 introduces the
+ * governed v8 defaults-flip rows below; a config stamped at this version has
+ * acknowledged those default changes.
+ */
+export declare const CURRENT_CONFIG_FORMAT_VERSION = 3;
+/**
+ * Governed v8 default flips (issue #2504). Unlike DEPRECATED_FIELDS (key
+ * renames surfaced through `availableMigrations`), these are default-value
+ * changes surfaced as info-severity `defaults-flip` findings — they never
+ * rewrite user keys (explicit user values always win), they inform the owner
+ * of the change, the one-line kill switch, and the conservative preset that
+ * restores the pre-flip (v7) default. Evidence for every entry is cited in
+ * docs/defaults-governance.md.
+ */
+export declare const DEFAULT_FLIPS: ReadonlyArray<{
+    field: string;
+    v7Default: string;
+    v8Default: string;
+    killSwitch: string;
+    preset: 'conservative';
+    sinceVersion: number;
+    evidence: string;
+}>;
 /**
  * Lean Turbo evidence-requiring gates and the registered producer tool that
  * writes each gate's evidence (issue #2470: every evidence-requiring gate must

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

@@ -70,7 +70,7 @@ export declare function allocateInjectionBudget(systemEnhancerDemandTokens: numb
  * therefore already inside the final measurement (attribution only — adding
  * them again would double-count).
  */
-export type InjectionProducer = 'system-enhancer' | 'knowledge-injector' | 'context-capsule' | 'memory-recall' | 'advisory-queue' | 'swarm-command-banner' | 'linked-cohort-advisory' | 'spec-drift-advisory' | 'final-accounting-warning';
+export type InjectionProducer = 'system-enhancer' | 'knowledge-injector' | 'context-capsule' | 'memory-recall' | 'advisory-queue' | 'swarm-command-banner' | 'guidance-carrier-fence' | 'linked-cohort-advisory' | 'spec-drift-advisory' | 'final-accounting-warning';
 export type InjectionSurface = 'system' | 'messages';
 export interface ProducerAccounting {
     /** Tokens the producer asked the ledger for this turn (claims only). */
@@ -79,10 +79,15 @@ export interface ProducerAccounting {
     granted: number;
     /** Tokens actually emitted to the model-visible surface. */
     emitted: number;
-    /** Tokens the producer wanted but did not emit (its own pruning). */
+    /** Tokens the producer wanted but did not reach the model-visible surface, whether pruned locally or rejected during downstream carrier delivery. */
     truncated: number;
     surface: InjectionSurface;
 }
+declare const injectionBudgetReceiptBrand: unique symbol;
+/** Opaque, one-shot handle for a turn-ledger reservation. */
+export interface InjectionBudgetReceipt {
+    readonly [injectionBudgetReceiptBrand]: true;
+}
 export interface TurnLedgerSummary {
     generation: number;
     totalBudget: number;
@@ -112,13 +117,25 @@ export declare function beginTurnLedger(sessionID: string, totalBudget: number,
  * preserving #1617's fail-open contract; the caller is expected to report that
  * the hard ceiling was unavailable.
  */
-export declare function claimTurnBudget(sessionID: string, producer: InjectionProducer, requestedTokens: number, opts?: {
-    localMaxTokens?: number;
-    surface?: InjectionSurface;
-}): {
+interface TurnBudgetClaimResult {
     granted: number;
     ledgerPresent: boolean;
     ceilingActive: boolean;
+}
+export declare function claimTurnBudget(sessionID: string, producer: InjectionProducer, requestedTokens: number, opts?: {
+    localMaxTokens?: number;
+    surface?: InjectionSurface;
+}): TurnBudgetClaimResult;
+/**
+ * Claim from the ledger and return an opaque receipt that can settle exactly
+ * this claim. A missing ledger keeps the normal fail-open grant and produces
+ * no receipt because there is no reservation to commit or refund.
+ */
+export declare function claimTurnBudgetWithReceipt(sessionID: string, producer: InjectionProducer, requestedTokens: number, opts?: {
+    localMaxTokens?: number;
+    surface?: InjectionSurface;
+}): TurnBudgetClaimResult & {
+    receipt?: InjectionBudgetReceipt;
 };
 /**
  * Record a producer's grant without claiming through `claimTurnBudget`.
@@ -132,13 +149,33 @@ export declare function claimTurnBudget(sessionID: string, producer: InjectionPr
  * exceed `totalBudget`.
  */
 export declare function recordProducerGrant(sessionID: string, producer: InjectionProducer, requestedTokens: number, grantedTokens: number, surface: InjectionSurface): void;
+/**
+ * Record an allocator-derived producer grant and return a receipt tied to the
+ * exact ledger generation and charged amount. `expectedGeneration` prevents a
+ * delayed transform from booking into a newer request's replacement ledger.
+ */
+export declare function recordProducerGrantWithReceipt(sessionID: string, producer: InjectionProducer, requestedTokens: number, grantedTokens: number, surface: InjectionSurface, options?: {
+    expectedGeneration?: number;
+    retractEmissionOnRefund?: boolean;
+    emittedTokensOnRefund?: number;
+}): InjectionBudgetReceipt | undefined;
 /**
  * Record what a producer actually emitted (and pruned itself) this turn.
  * Producers that never claim (fixed/base content: advisory queue, banners,
  * the context-budget warning, the final-accounting warning) still record their
  * emission here so the final accounting can include them.
  */
-export declare function recordProducerEmission(sessionID: string, producer: InjectionProducer, emittedTokens: number, truncatedTokens: number, surface: InjectionSurface): void;
+export declare function recordProducerEmission(sessionID: string, producer: InjectionProducer, emittedTokens: number, truncatedTokens: number, surface: InjectionSurface, options?: {
+    expectedGeneration?: number;
+}): void;
+/**
+ * Record a direct producer emission and return a receipt that retracts exactly
+ * that emission if its carrier is not delivered. A generation mismatch is a
+ * no-op, so an old staged transform cannot write into a replacement ledger.
+ */
+export declare function recordProducerEmissionWithReceipt(sessionID: string, producer: InjectionProducer, emittedTokens: number, surface: InjectionSurface, options?: {
+    expectedGeneration?: number;
+}): InjectionBudgetReceipt | undefined;
 /**
  * Snapshot of the session's current turn ledger (null when absent).
  */
@@ -148,7 +185,9 @@ export declare function recordProducerEmission(sessionID: string, producer: Inje
  * recorded them, and the final accounting must not count bytes the model
  * never sees. Floors at zero; no-op without a ledger or producer entry.
  */
-export declare function deductProducerEmission(sessionID: string, producer: InjectionProducer, removedTokens: number): void;
+export declare function deductProducerEmission(sessionID: string, producer: InjectionProducer, removedTokens: number, options?: {
+    expectedGeneration?: number;
+}): void;
 export declare function getTurnLedgerSummary(sessionID: string): TurnLedgerSummary | null;
 /**
  * Emitted tokens recorded for one producer this turn (0 when no ledger or the
@@ -156,6 +195,14 @@ export declare function getTurnLedgerSummary(sessionID: string): TurnLedgerSumma
  * knowledge-injector reads the system-enhancer's actual emission from here.
  */
 export declare function getProducerEmission(sessionID: string, producer: InjectionProducer): number;
+/** Commit exactly one live receipt. Repeated or stale commits are no-ops. */
+export declare function commitInjectionBudgetReceipt(receipt: InjectionBudgetReceipt): boolean;
+/**
+ * Refund exactly one live receipt. Repeated, post-commit, or stale-generation
+ * refunds are no-ops. Grant receipts configured for emission retraction also
+ * move only their still-emitted amount into that producer's truncation count.
+ */
+export declare function refundInjectionBudgetReceipt(receipt: InjectionBudgetReceipt): boolean;
 /**
  * Advance the turn generation for a session: the current ledger is discarded so
  * the next request composition starts from a fresh generation. Called when
@@ -173,3 +220,4 @@ export declare function clearTurnLedger(sessionID: string): void;
  * review on PR #2415: the reset pattern must cover ALL module-scoped maps).
  */
 export declare function clearAllTurnLedgers(): void;
+export {};

package/dist/tools/save-plan.d.ts

@@ -3,8 +3,20 @@
  * Allows the Architect agent to save structured plans to .swarm/plan.json and .swarm/plan.md.
  */
 import type { ToolDefinition } from '@opencode-ai/plugin/tool';
+import { loadPluginConfigWithMeta } from '../config';
 import { type ExecutionProfile } from '../config/plan-schema';
 import { takeSnapshotWithRetry } from '../plan/ledger';
+/**
+ * DI seam for hermetic config-load substitution in tests (AGENTS.md invariant 7).
+ * Mirrors `src/tools/apply-patch.ts`. Tests override
+ * `_internals.loadPluginConfigWithMeta` and restore it in `afterEach` instead of
+ * writing real config files or using `mock.module` (which leaks across test
+ * files in Bun's shared runner). Used by the #2504 conservative-preset
+ * new-plan default below.
+ */
+export declare const _internals: {
+    loadPluginConfigWithMeta: typeof loadPluginConfigWithMeta;
+};
 /** Test seam for the snapshot retry helper (FR-004). */
 export declare const _test_exports: {
     takeSnapshotWithRetry: typeof takeSnapshotWithRetry;

package/opencode-swarm.schema.json

@@ -16,6 +16,14 @@
       "minimum": 0,
       "maximum": 9007199254740991
     },
+    "preset": {
+      "description": "Defaults profile: \"default\" applies the governed v8 defaults; \"conservative\" restores the pre-flip (v7) defaults for every flipped surface (#2504).",
+      "type": "string",
+      "enum": [
+        "default",
+        "conservative"
+      ]
+    },
     "agents": {
       "description": "Per-agent overrides keyed by agent name for the default swarm (e.g. \"architect\", \"coder\"). Multi-swarm setups configure agents under swarms.<id>.agents instead.",
       "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.183.0",
+	"version": "7.184.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-grnfsaa2.js

@@ -1,74 +0,0 @@
-// @bun
-import {
-  createCuratorLLMDelegate
-} from "./index-c6zrffwn.js";
-import"./index-fqc1a1vj.js";
-import"./index-hamqvzqn.js";
-import"./index-wjqc2mnc.js";
-import"./index-a6np52p4.js";
-import"./index-9gehw4xb.js";
-import"./index-nmfnggaa.js";
-import"./index-ht88g5mc.js";
-import"./index-txdagbh7.js";
-import"./index-mewsqwbq.js";
-import"./index-6b295cas.js";
-import"./index-1ex9ecf5.js";
-import"./index-w670pfv4.js";
-import"./index-29f69hzd.js";
-import"./index-rdec0y3z.js";
-import"./index-30pz2xvj.js";
-import"./index-cjapb4hy.js";
-import"./index-zsrtt42s.js";
-import"./index-pvtf7cjg.js";
-import"./index-v8ja5zcr.js";
-import"./index-1kpa3an2.js";
-import"./index-pt7h91zc.js";
-import"./index-q7sjgr1y.js";
-import"./index-yv5fmjcf.js";
-import"./index-jf9cvkzr.js";
-import"./index-4aggsva0.js";
-import"./index-wqg2j647.js";
-import"./index-6f7tfq3m.js";
-import"./index-25m6rekr.js";
-import"./index-2s7dvzff.js";
-import"./index-94pwd45k.js";
-import"./index-r7dqevkc.js";
-import"./index-rtry5xyf.js";
-import"./index-qws72zbs.js";
-import"./index-frcemc0b.js";
-import"./index-0725jpp7.js";
-import"./index-k88thqa0.js";
-import"./index-kv0k3b60.js";
-import"./index-rfggc332.js";
-import"./index-820e6w22.js";
-import"./index-wnkx6gs0.js";
-import"./index-5cvm6ykc.js";
-import"./index-rdm3px0g.js";
-import"./index-ry16d01s.js";
-import"./index-w6hrms7j.js";
-import"./index-0n24h4zb.js";
-import"./index-vzm6zre7.js";
-import"./index-ae75rja9.js";
-import"./index-3bcmw8pc.js";
-import"./index-v2rbpcqy.js";
-import"./index-tt705bap.js";
-import"./index-1xnse449.js";
-import"./index-c1ggtmpm.js";
-import"./index-ejhxgyvm.js";
-import"./index-7g4c7s5r.js";
-import"./index-s1y70y0w.js";
-import"./index-gx2vp8gx.js";
-import"./index-r65yxdv7.js";
-import"./index-zxdawwc7.js";
-import"./index-fb0v3e71.js";
-import"./index-wzec3c4g.js";
-import"./index-bk5tah7q.js";
-import"./index-gknz3bv1.js";
-import"./index-zpsr8rpc.js";
-import"./index-wvghb3x6.js";
-import"./index-9rwhas09.js";
-import"./index-zgwm4ryv.js";
-import"./index-a76rekgs.js";
-export {
-  createCuratorLLMDelegate
-};

package/dist/cli/guardrail-explain-2sb06877.js

@@ -1,75 +0,0 @@
-// @bun
-import {
-  handleGuardrailExplain
-} from "./index-6nhzekvt.js";
-import"./index-c6zrffwn.js";
-import"./index-fqc1a1vj.js";
-import"./index-hamqvzqn.js";
-import"./index-wjqc2mnc.js";
-import"./index-a6np52p4.js";
-import"./index-9gehw4xb.js";
-import"./index-nmfnggaa.js";
-import"./index-ht88g5mc.js";
-import"./index-txdagbh7.js";
-import"./index-mewsqwbq.js";
-import"./index-6b295cas.js";
-import"./index-1ex9ecf5.js";
-import"./index-w670pfv4.js";
-import"./index-29f69hzd.js";
-import"./index-rdec0y3z.js";
-import"./index-30pz2xvj.js";
-import"./index-cjapb4hy.js";
-import"./index-zsrtt42s.js";
-import"./index-pvtf7cjg.js";
-import"./index-v8ja5zcr.js";
-import"./index-1kpa3an2.js";
-import"./index-pt7h91zc.js";
-import"./index-q7sjgr1y.js";
-import"./index-yv5fmjcf.js";
-import"./index-jf9cvkzr.js";
-import"./index-4aggsva0.js";
-import"./index-wqg2j647.js";
-import"./index-6f7tfq3m.js";
-import"./index-25m6rekr.js";
-import"./index-2s7dvzff.js";
-import"./index-94pwd45k.js";
-import"./index-r7dqevkc.js";
-import"./index-rtry5xyf.js";
-import"./index-qws72zbs.js";
-import"./index-frcemc0b.js";
-import"./index-0725jpp7.js";
-import"./index-k88thqa0.js";
-import"./index-kv0k3b60.js";
-import"./index-rfggc332.js";
-import"./index-820e6w22.js";
-import"./index-wnkx6gs0.js";
-import"./index-5cvm6ykc.js";
-import"./index-rdm3px0g.js";
-import"./index-ry16d01s.js";
-import"./index-w6hrms7j.js";
-import"./index-0n24h4zb.js";
-import"./index-vzm6zre7.js";
-import"./index-ae75rja9.js";
-import"./index-3bcmw8pc.js";
-import"./index-v2rbpcqy.js";
-import"./index-tt705bap.js";
-import"./index-1xnse449.js";
-import"./index-c1ggtmpm.js";
-import"./index-ejhxgyvm.js";
-import"./index-7g4c7s5r.js";
-import"./index-s1y70y0w.js";
-import"./index-gx2vp8gx.js";
-import"./index-r65yxdv7.js";
-import"./index-zxdawwc7.js";
-import"./index-fb0v3e71.js";
-import"./index-wzec3c4g.js";
-import"./index-bk5tah7q.js";
-import"./index-gknz3bv1.js";
-import"./index-zpsr8rpc.js";
-import"./index-wvghb3x6.js";
-import"./index-9rwhas09.js";
-import"./index-zgwm4ryv.js";
-import"./index-a76rekgs.js";
-export {
-  handleGuardrailExplain
-};