@sleep2agi/agent-network 2.3.0-preview.136 → 2.3.0-preview.138

package/dist/src/opencode-agent-node-pair.d.ts

@@ -1,9 +1,9 @@
-export declare const PAIRED_AGENT_NETWORK_VERSION = "2.3.0-preview.136";
-export declare const PAIRED_AGENT_NODE_VERSION = "2.5.0-preview.103";
-export declare const PAIRED_AGENT_NODE_SPEC = "@sleep2agi/agent-node@2.5.0-preview.103";
-export declare const OPENCODE_AGENT_NETWORK_VERSION = "2.3.0-preview.136";
-export declare const OPENCODE_AGENT_NODE_VERSION = "2.5.0-preview.103";
-export declare const OPENCODE_AGENT_NODE_SPEC = "@sleep2agi/agent-node@2.5.0-preview.103";
+export declare const PAIRED_AGENT_NETWORK_VERSION = "2.3.0-preview.138";
+export declare const PAIRED_AGENT_NODE_VERSION = "2.5.0-preview.105";
+export declare const PAIRED_AGENT_NODE_SPEC = "@sleep2agi/agent-node@2.5.0-preview.105";
+export declare const OPENCODE_AGENT_NETWORK_VERSION = "2.3.0-preview.138";
+export declare const OPENCODE_AGENT_NODE_VERSION = "2.5.0-preview.105";
+export declare const OPENCODE_AGENT_NODE_SPEC = "@sleep2agi/agent-node@2.5.0-preview.105";
 export type PairedAgentNodeResolution = {
     spec: string;
     args: string[];

package/dist/src/opencode-generation-record.d.ts

@@ -0,0 +1,24 @@
+import { type OpencodeGeneration } from "./opencode-versions";
+export declare const OPENCODE_GENERATION_FIELD = "opencodeGeneration";
+/** Profile about to be serialised by saveProfile: add the generation when it
+ *  is missing, otherwise return the very same object. */
+export declare function stampOpencodeGeneration<T extends Record<string, any>>(profile: T, generation?: OpencodeGeneration): T;
+/**
+ * Raw `config.json` text → the same text with `opencodeGeneration` appended,
+ * or null when nothing should be written:
+ *   – the field is already present (whatever its value), or
+ *   – the file is not valid JSON / not an object, or
+ *   – the file is not in the canonical `JSON.stringify(_, null, 2) + "\n"`
+ *     form saveProfile writes (hand-edited). Re-serialising such a file could
+ *     touch bytes of other fields, and an absent field already means V1.
+ * In the canonical case the result differs from the input only by the one
+ * appended key, so every other field keeps its exact bytes.
+ */
+export declare function recordOpencodeGenerationInConfigText(raw: string, generation?: OpencodeGeneration): string | null;
+/** Start-time backfill for a node created before #542. IO is injected so the
+ *  caller keeps its own symlink-safe private-file reader/writer. Never throws:
+ *  the record is advisory and an absent field already reads as V1. */
+export declare function backfillOpencodeGeneration(io: {
+    read: () => string | undefined;
+    write: (body: string) => void;
+}): boolean;

package/dist/src/opencode-package-binary.d.ts

@@ -24,3 +24,18 @@ export declare function validateOpencodePackageBinary(rawBinary: string, options
 export declare const OPENCODE_VERIFIER_PLATFORMS: ReadonlySet<NodeJS.Platform>;
 export declare function opencodeVerifierSupportsPlatform(platform?: NodeJS.Platform): boolean;
 export declare function resolveOpencodePackageBinaryFromPath(searchPath: string, options: ValidateOpencodePackageBinaryOptions, platform?: NodeJS.Platform): string;
+/**
+ * Board #541 — resolve the first trusted package entrypoint matching any of
+ * `acceptedVersions`, trying each version across the whole PATH in order (the
+ * release pin first), and report which exact version was admitted. Every
+ * candidate still goes through the full `validateOpencodePackageBinary`
+ * identity gate; only the accepted version set is wider. When nothing matches,
+ * the error from the first (release-pin) attempt is rethrown so diagnostics
+ * keep naming the pin the operator should install.
+ */
+export declare function resolveAcceptedOpencodePackageBinaryFromPath(searchPath: string, options: Omit<ValidateOpencodePackageBinaryOptions, "expectedVersion"> & {
+    acceptedVersions: readonly string[];
+}, platform?: NodeJS.Platform): {
+    binary: string;
+    version: string;
+};

package/dist/src/opencode-pin.d.ts

@@ -1,8 +1,25 @@
 /**
  * Version this branch was validated against by the maintainers.
- * Bumped when a new opencode-ai release passes the full Docker/E2E gate.
+ * Bumped when a new opencode-ai release passes the full Docker/E2E gate —
+ * in the shared supported-versions table (`opencode-versions.ts`, #542),
+ * which agent-node's package gate reads from its byte-identical copy.
  */
-export declare const OPENCODE_BUILTIN_PIN = "1.18.1";
+export declare const OPENCODE_BUILTIN_PIN = "1.18.34";
+/**
+ * Earlier release pins that remain accepted for one transition window so a
+ * host still holding the previous exact install keeps starting after an anet
+ * upgrade (board #541). Each entry passed the full Docker/E2E gate when it was
+ * the pin; start prints `opencodeLegacyPinNote()` so the operator upgrades.
+ * Derived from the shared supported-versions table (#542: v1 accepted
+ * versions minus the pin) — agent-node's gate reads the same table.
+ */
+export declare const OPENCODE_TRANSITION_VERSIONS: readonly string[];
+/** Versions a start may accept, preferred first: the release pin, then the
+ * transition versions. The order matters — a PATH holding both resolves to
+ * the release pin. */
+export declare function acceptedOpencodeVersions(pin?: string): string[];
+/** One-line upgrade note when a start accepted a transition version, else null. */
+export declare function opencodeLegacyPinNote(found: string, pin?: string): string | null;
 /** Exact upstream remediation shared by every CLI failure path. */
 export declare function opencodeExactInstallCommand(version?: string): string;
 /** Preserve package-identity diagnostics while always leaving a missing or

package/dist/src/opencode-versions.d.ts

@@ -0,0 +1,32 @@
+export type OpencodeGeneration = "v1" | "v2";
+export type OpencodeSupportStatus = "supported" | "preview" | "unsupported";
+export interface OpencodeGenerationSupport {
+    readonly generation: OpencodeGeneration;
+    /** npm package that provides the `opencode` executable. */
+    readonly packageName: string;
+    /** Release pin: the exact version a fresh install is told to use.
+     *  null when no version of this generation is vetted. */
+    readonly pin: string | null;
+    /** Every exact version a start may accept, preferred first (pin first).
+     *  Empty when the generation is unsupported. */
+    readonly acceptedVersions: readonly string[];
+    readonly status: OpencodeSupportStatus;
+}
+/** The V1 release pin. Kept as its own literal line so shell suites can
+ *  read it with a single anchored sed (tests/test1225…/run.sh). */
+export declare const OPENCODE_V1_PIN = "1.18.34";
+export declare const OPENCODE_SUPPORTED_VERSIONS: readonly OpencodeGenerationSupport[];
+/** Generation assumed for every node record that does not name one. */
+export declare const OPENCODE_DEFAULT_GENERATION: OpencodeGeneration;
+export declare function isOpencodeGeneration(value: unknown): value is OpencodeGeneration;
+export declare function opencodeGenerationSupport(generation: OpencodeGeneration): OpencodeGenerationSupport;
+/** Exact versions a start may accept for `generation`, preferred first.
+ *  Always empty for an unsupported generation. */
+export declare function acceptedOpencodeVersionsFor(generation: OpencodeGeneration): readonly string[];
+export declare function isAcceptedOpencodeVersionFor(generation: OpencodeGeneration, version: string): boolean;
+/** Generation recorded on a node config; a config without one (every node
+ *  created before #542) is V1. An unrecognised value is returned as
+ *  undefined so callers can refuse it instead of guessing. */
+export declare function opencodeGenerationOfConfig(config: {
+    opencodeGeneration?: unknown;
+} | null | undefined): OpencodeGeneration | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleep2agi/agent-network",
-  "version": "2.3.0-preview.136",
+  "version": "2.3.0-preview.138",
   "description": "AI Agent Network CLI — Local-first multi-agent orchestration across 6 runtimes (Claude Code CLI / Claude Agent SDK / Codex SDK / Codex app-server / Grok Build ACP / OpenCode CLI) and 8+ LLM providers. Apache 2.0.",
   "type": "module",
   "main": "dist/src/client.js",