@amends-dev/harness-opencode 0.0.0-stage → 0.2.0

package/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * opencode as an agent for the `@amends-dev/harness` contract, working in a sandbox behind its
+ * bridge, which the agent's template installs there with opencode itself. opencode has two
+ * versions, each with a session API of its own, and the package an agent for each: `OpencodeAgent`
+ * runs opencode 1, which takes everything a turn gives, and `Opencode2Agent` runs opencode 2, which
+ * records a session started on another agent as its own but does not answer in JSON yet.
+ *
+ * @since 0.1.0
+ */
+/**
+ * @since 0.1.0
+ */
+export * as Opencode2Agent from "./Opencode2Agent.ts";
+/**
+ * @since 0.1.0
+ */
+export * as OpencodeAgent from "./OpencodeAgent.ts";
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;GAEG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA"}

package/index.js

@@ -0,0 +1,19 @@
+/**
+ * opencode as an agent for the `@amends-dev/harness` contract, working in a sandbox behind its
+ * bridge, which the agent's template installs there with opencode itself. opencode has two
+ * versions, each with a session API of its own, and the package an agent for each: `OpencodeAgent`
+ * runs opencode 1, which takes everything a turn gives, and `Opencode2Agent` runs opencode 2, which
+ * records a session started on another agent as its own but does not answer in JSON yet.
+ *
+ * @since 0.1.0
+ */
+// @barrel: Auto-generated exports. Do not edit manually.
+/**
+ * @since 0.1.0
+ */
+export * as Opencode2Agent from "./Opencode2Agent.js";
+/**
+ * @since 0.1.0
+ */
+export * as OpencodeAgent from "./OpencodeAgent.js";
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,yDAAyD;AAEzD;;GAEG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;GAEG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA"}

package/internal/agent.d.ts

@@ -0,0 +1,29 @@
+/**
+ * What `OpencodeAgent` and `Opencode2Agent` make: the agent over one version of opencode, whose
+ * sessions reach it through the bridge its installation launches in each sandbox.
+ */
+import { type Agent, HarnessError } from "@amends-dev/harness";
+import type { Sandbox } from "@amends-dev/sandbox";
+import type * as Crypto from "effect/Crypto";
+import * as Effect from "effect/Effect";
+import type * as Redacted from "effect/Redacted";
+import type * as Schema from "effect/Schema";
+import type * as Socket from "effect/socket/Socket";
+import { type Version } from "./template.ts";
+/** What each version's agent is made with, as its module documents. */
+export interface Options extends Agent.Options {
+    readonly token: (id: Sandbox.SandboxId) => Redacted.Redacted<string>;
+    readonly config?: {
+        readonly [key: string]: Schema.Json;
+    };
+    readonly env?: Readonly<Record<string, string>>;
+}
+/** Which opencode an agent runs, the id hosts know it by, and how long its tools' names may be. */
+export interface Kind {
+    readonly id: string;
+    readonly version: Version;
+    readonly maxToolNameLength?: number;
+}
+/** The agent of `kind`, made with `options`. */
+export declare const make: (kind: Kind, options: Options) => Effect.Effect<Agent.Agent, HarnessError.HarnessError | import("effect/PlatformError").PlatformError, Crypto.Crypto | Socket.WebSocketConstructor>;
+//# sourceMappingURL=agent.d.ts.map

package/internal/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/internal/agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAgB,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,KAAK,MAAM,MAAM,sBAAsB,CAAA;AAGnD,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AAE9D,uEAAuE;AACvE,MAAM,WAAW,OAAQ,SAAQ,KAAK,CAAC,OAAO;IAC5C,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,CAAA;KAAE,CAAA;IACzD,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAChD;AAED,mGAAmG;AACnG,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CACpC;AAED,gDAAgD;AAChD,eAAO,MAAM,IAAI,qLAyBf,CAAA"}

package/internal/agent.js

@@ -0,0 +1,34 @@
+/**
+ * What `OpencodeAgent` and `Opencode2Agent` make: the agent over one version of opencode, whose
+ * sessions reach it through the bridge its installation launches in each sandbox.
+ */
+import { BridgeClient, HarnessError } from "@amends-dev/harness";
+import * as Effect from "effect/Effect";
+import { modelsOf } from "./models.js";
+import { makeInstallation } from "./template.js";
+/** The agent of `kind`, made with `options`. */
+export const make = Effect.fnUntraced(function* (kind, options) {
+    const models = yield* Effect.fromResult(modelsOf(kind.version, options)).pipe(Effect.mapError((reason) => new HarnessError.HarnessError({ agent: kind.id, reason })));
+    const installation = yield* makeInstallation(kind.version);
+    const services = yield* Effect.context();
+    const bridge = {
+        id: kind.id,
+        ...installation,
+        token: options.token,
+        agentOptions: {
+            model: models.model,
+            models: models.models,
+            config: { ...options.config, ...models.config },
+            env: { ...options.env, ...models.env }
+        }
+    };
+    const agent = {
+        id: kind.id,
+        requiresSandbox: true,
+        template: installation.template,
+        ...(kind.maxToolNameLength !== undefined && { maxToolNameLength: kind.maxToolNameLength }),
+        createSession: (sessionOptions) => Effect.provide(BridgeClient.createSession(bridge, sessionOptions), services)
+    };
+    return agent;
+});
+//# sourceMappingURL=agent.js.map

package/internal/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/internal/agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAG5E,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAKvC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAgB,MAAM,eAAe,CAAA;AAgB9D,gDAAgD;AAChD,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,IAAU,EAAE,OAAgB;IAC3E,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAC3E,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CACvF,CAAA;IACD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,EAA+C,CAAA;IACrF,MAAM,MAAM,GAAyB;QACnC,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,GAAG,YAAY;QACf,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,YAAY,EAAE;YACZ,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE;YAC/C,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE;SACf;KAC1B,CAAA;IACD,MAAM,KAAK,GAAgB;QACzB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,eAAe,EAAE,IAAI;QACrB,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,GAAG,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC1F,aAAa,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,QAAQ,CAAC;KAChH,CAAA;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAC,CAAA"}

package/internal/bridge/bunBridge.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Runs a bridge program from Bun: `runProgram` makes opencode's driver from the launch options a
+ * host gave, and `serve` serves it on every interface of the sandbox, at a port the sandbox picks,
+ * until the bridge exits idle or another takes its place.
+ *
+ * Bun's server never finishes stopping once a WebSocket has been open, so it runs in a scope of its
+ * own, which the bridge gives a second to close after the bridge's own finalizers have run, rather
+ * than wait for hosts to close their connections.
+ */
+import { type Bridge, BridgeServer, HostToolRelay } from "@amends-dev/harness";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+import * as Driver from "./driver.ts";
+/**
+ * Runs the bridge program of the agent `agent`, which a host launches in its sandbox. It reads the
+ * launch options the host gave it on standard input, makes opencode's driver from the agent options
+ * among them, with the sessions `makeCreateSession` creates, and serves the driver to hosts until
+ * it exits idle or another bridge takes its place. opencode's server exiting by itself ends it too,
+ * for the next host to launch both again.
+ *
+ * Beside the bridge it serves the `HostToolRelay`, through which opencode calls the host's tools,
+ * on 127.0.0.1 only, where opencode's server reaches it. The driver runs the opencode in
+ * `directory`, where the template installs it beside the program, unless the agent options name
+ * another command.
+ */
+export declare const runProgram: (agent: string, directory: string, makeCreateSession: (relay: HostToolRelay.HostToolRelay["Service"]) => Driver.CreateSession) => void;
+/**
+ * Serves `driver` to hosts as `launch` says, until the bridge exits idle, after `idleTimeout`, or
+ * another takes its place.
+ */
+export declare const serve: (driver: Bridge.Driver, launch: Bridge.LaunchOptions, options?: Pick<BridgeServer.Options, "idleTimeout"> | undefined) => Effect.Effect<undefined, import("effect/PlatformError").PlatformError | Schema.SchemaError | import("effect/http/HttpServerError").ServeError, Scope.Scope>;
+//# sourceMappingURL=bunBridge.d.ts.map

package/internal/bridge/bunBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bunBridge.d.ts","sourceRoot":"","sources":["../../../src/internal/bridge/bunBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAI9E,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAMvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,UACd,MAAM,aACF,MAAM,qBACE,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,aAAa,SAmBzF,CAAA;AAUH;;;GAGG;AACH,eAAO,MAAM,KAAK,uRAuBhB,CAAA"}

package/internal/bridge/bunBridge.js

@@ -0,0 +1,62 @@
+/**
+ * Runs a bridge program from Bun: `runProgram` makes opencode's driver from the launch options a
+ * host gave, and `serve` serves it on every interface of the sandbox, at a port the sandbox picks,
+ * until the bridge exits idle or another takes its place.
+ *
+ * Bun's server never finishes stopping once a WebSocket has been open, so it runs in a scope of its
+ * own, which the bridge gives a second to close after the bridge's own finalizers have run, rather
+ * than wait for hosts to close their connections.
+ */
+import { BridgeServer, HostToolRelay } from "@amends-dev/harness";
+import * as BunHttpServer from "@effect/platform-bun/BunHttpServer";
+import * as BunRuntime from "@effect/platform-bun/BunRuntime";
+import * as BunServices from "@effect/platform-bun/BunServices";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Fiber from "effect/Fiber";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+import * as Driver from "./driver.js";
+/**
+ * Runs the bridge program of the agent `agent`, which a host launches in its sandbox. It reads the
+ * launch options the host gave it on standard input, makes opencode's driver from the agent options
+ * among them, with the sessions `makeCreateSession` creates, and serves the driver to hosts until
+ * it exits idle or another bridge takes its place. opencode's server exiting by itself ends it too,
+ * for the next host to launch both again.
+ *
+ * Beside the bridge it serves the `HostToolRelay`, through which opencode calls the host's tools,
+ * on 127.0.0.1 only, where opencode's server reaches it. The driver runs the opencode in
+ * `directory`, where the template installs it beside the program, unless the agent options name
+ * another command.
+ */
+export const runProgram = (agent, directory, makeCreateSession) => BunRuntime.runMain(Effect.gen(function* () {
+    const launch = yield* BridgeServer.readLaunchOptions;
+    const options = yield* Schema.decodeUnknownEffect(Driver.Options)(launch.agentOptions);
+    const relay = yield* HostToolRelay.HostToolRelay;
+    const driver = yield* Driver.make(agent, { command: `${directory}/opencode`, ...options }, makeCreateSession(relay));
+    return yield* serve(driver, launch).pipe(Effect.raceFirst(Effect.andThen(driver.serverExited, Effect.fail("opencode's server exited by itself"))));
+}).pipe(Effect.scoped, Effect.provide(layerRelay.pipe(Layer.provideMerge(Layer.merge(BunServices.layer, FetchHttpClient.layer))))));
+/**
+ * The relay, on a server of its own. A call of a host's tool waits for the host for as long as an
+ * approval takes, so the server never closes a connection for being idle.
+ */
+const layerRelay = HostToolRelay.layer().pipe(Layer.provide(BunHttpServer.layer({ hostname: "127.0.0.1", port: 0, idleTimeout: 0 })));
+/**
+ * Serves `driver` to hosts as `launch` says, until the bridge exits idle, after `idleTimeout`, or
+ * another takes its place.
+ */
+export const serve = Effect.fnUntraced(function* (driver, launch, options = {}) {
+    const serverScope = yield* Scope.make();
+    yield* Effect.addFinalizer(() => Effect.forkDetach(Scope.close(serverScope, Exit.void)).pipe(Effect.flatMap(Fiber.await), Effect.timeout("1 second"), Effect.ignore));
+    const server = yield* Layer.buildWithScope(BunHttpServer.layer({ hostname: "0.0.0.0", port: 0, disablePreemptiveShutdown: true }), serverScope);
+    return yield* BridgeServer.serve(driver, {
+        token: Redacted.make(launch.token),
+        bridge: launch.bridge,
+        stateDirectory: launch.stateDirectory,
+        ...options
+    }).pipe(Effect.provideContext(server));
+});
+//# sourceMappingURL=bunBridge.js.map

package/internal/bridge/bunBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bunBridge.js","sourceRoot":"","sources":["../../../src/internal/bridge/bunBridge.ts"],"names":[],"mappings":"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"}

package/internal/bridge/driver.d.ts

@@ -0,0 +1,81 @@
+/**
+ * opencode's driver, which runs opencode for the bridge in its sandbox. One opencode server, which
+ * the driver starts when the first session starts, serves every session there, each an opencode
+ * session in the session's directory. The sessions are those of the API the bridge's version of
+ * opencode speaks: `v1/session.ts` creates them over opencode 1's session API, and `v2/session.ts`
+ * over opencode 2's, and each bridge program makes the driver with its own.
+ *
+ * opencode's server runs until the bridge stops. A server that fails to start is started again by
+ * the next session, and one that exits by itself completes `serverExited`, for the bridge to exit
+ * with it.
+ */
+import type { Bridge, HarnessError } from "@amends-dev/harness";
+import type * as Crypto from "effect/Crypto";
+import * as Effect from "effect/Effect";
+import type * as FileSystem from "effect/FileSystem";
+import type * as HttpClient from "effect/http/HttpClient";
+import type * as Path from "effect/Path";
+import type * as ChildProcessSpawner from "effect/process/ChildProcessSpawner";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+import * as Server from "./server.ts";
+/** A model, as opencode names one: its provider, its id there, and a variant such as `high`. */
+export declare const ModelRef: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly providerID: Schema.String;
+    readonly variant: Schema.optionalKey<Schema.String>;
+}>;
+export interface ModelRef extends Schema.Schema.Type<typeof ModelRef> {
+}
+/** What the host gives the bridge for opencode, as its agent options. */
+export declare const Options: Schema.Struct<{
+    /** The model a turn runs on when it names none. */
+    readonly model: Schema.Struct<{
+        readonly id: Schema.String;
+        readonly providerID: Schema.String;
+        readonly variant: Schema.optionalKey<Schema.String>;
+    }>;
+    /**
+     * The models a turn can name, by name. A turn that names another fails with
+     * `UnsupportedError`.
+     */
+    readonly models: Schema.$Record<Schema.String, Schema.Struct<{
+        readonly id: Schema.String;
+        readonly providerID: Schema.String;
+        readonly variant: Schema.optionalKey<Schema.String>;
+    }>>;
+    /**
+     * The command that runs opencode in the sandbox, when it is not the opencode the template
+     * installs beside the bridge program.
+     */
+    readonly command: Schema.optionalKey<Schema.String>;
+    /**
+     * opencode's configuration, as its `opencode.json` takes it, with the providers of the models.
+     */
+    readonly config: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    /** Environment variables opencode runs with. */
+    readonly env: Schema.$Record<Schema.String, Schema.String>;
+}>;
+export interface Options extends Schema.Schema.Type<typeof Options> {
+}
+export interface Driver extends Bridge.Driver {
+    /**
+     * Completes when opencode's server exits before the bridge stops it, for the bridge to exit with
+     * it.
+     */
+    readonly serverExited: Effect.Effect<void>;
+}
+/**
+ * Creates a session on opencode's server, as the API of one version of opencode does: the
+ * session's turns run on `options`' models, and `sessionOptions` say where it works and what
+ * conversation it starts from. It reads the sandbox's files with the bridge's file system, and
+ * makes ids with its `Crypto`.
+ */
+export type CreateSession = (server: Server.Server, options: Pick<Options, "model" | "models">, sessionOptions: Bridge.CreateSessionOptions) => Effect.Effect<Bridge.DriverSession, HarnessError.HarnessError, Scope.Scope | FileSystem.FileSystem | Crypto.Crypto>;
+/**
+ * The driver of the agent `id`, which starts opencode's server with `options` when the first
+ * session starts, and creates each session on it with `createSession`. The server runs in the
+ * scope the driver is made in.
+ */
+export declare const make: (id: string, options: Required<Options>, createSession: CreateSession) => Effect.Effect<Driver, never, ChildProcessSpawner.ChildProcessSpawner | Crypto.Crypto | FileSystem.FileSystem | HttpClient.HttpClient | Path.Path | Scope.Scope>;
+//# sourceMappingURL=driver.d.ts.map

package/internal/bridge/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../src/internal/bridge/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAE5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,UAAU,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,KAAK,UAAU,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,KAAK,mBAAmB,MAAM,oCAAoC,CAAA;AAE9E,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,gGAAgG;AAChG,eAAO,MAAM,QAAQ;;;;EAInB,CAAA;AAEF,MAAM,WAAW,QAAS,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC;CAAG;AAExE,yEAAyE;AACzE,eAAO,MAAM,OAAO;IAClB,mDAAmD;;;;;;IAGnD;;;OAGG;;;;;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH,gDAAgD;;EAEhD,CAAA;AAEF,MAAM,WAAW,OAAQ,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC;CAAG;AAEtE,MAAM,WAAW,MAAO,SAAQ,MAAM,CAAC,MAAM;IAC3C;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAC3C;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC,EAC1C,cAAc,EAAE,MAAM,CAAC,oBAAoB,KACxC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;AAExH;;;;GAIG;AACH,eAAO,MAAM,IAAI,2OAyCf,CAAA"}

package/internal/bridge/driver.js

@@ -0,0 +1,82 @@
+/**
+ * opencode's driver, which runs opencode for the bridge in its sandbox. One opencode server, which
+ * the driver starts when the first session starts, serves every session there, each an opencode
+ * session in the session's directory. The sessions are those of the API the bridge's version of
+ * opencode speaks: `v1/session.ts` creates them over opencode 1's session API, and `v2/session.ts`
+ * over opencode 2's, and each bridge program makes the driver with its own.
+ *
+ * opencode's server runs until the bridge stops. A server that fails to start is started again by
+ * the next session, and one that exits by itself completes `serverExited`, for the bridge to exit
+ * with it.
+ */
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+import * as Semaphore from "effect/Semaphore";
+import * as Server from "./server.js";
+/** A model, as opencode names one: its provider, its id there, and a variant such as `high`. */
+export const ModelRef = Schema.Struct({
+    id: Schema.String,
+    providerID: Schema.String,
+    variant: Schema.optionalKey(Schema.String)
+});
+/** What the host gives the bridge for opencode, as its agent options. */
+export const Options = Schema.Struct({
+    /** The model a turn runs on when it names none. */
+    model: ModelRef,
+    /**
+     * The models a turn can name, by name. A turn that names another fails with
+     * `UnsupportedError`.
+     */
+    models: Schema.Record(Schema.String, ModelRef),
+    /**
+     * The command that runs opencode in the sandbox, when it is not the opencode the template
+     * installs beside the bridge program.
+     */
+    command: Schema.optionalKey(Schema.String),
+    /**
+     * opencode's configuration, as its `opencode.json` takes it, with the providers of the models.
+     */
+    config: Schema.Record(Schema.String, Schema.Json),
+    /** Environment variables opencode runs with. */
+    env: Schema.Record(Schema.String, Schema.String)
+});
+/**
+ * The driver of the agent `id`, which starts opencode's server with `options` when the first
+ * session starts, and creates each session on it with `createSession`. The server runs in the
+ * scope the driver is made in.
+ */
+export const make = Effect.fnUntraced(function* (id, options, createSession) {
+    const services = yield* Effect.context();
+    const driverScope = yield* Effect.scope;
+    const serverExited = yield* Deferred.make();
+    const running = yield* Ref.make(undefined);
+    /** Held while the server starts, so that sessions starting together start one. */
+    const starting = yield* Semaphore.make(1);
+    /** opencode's server, which the first session to need it starts. */
+    const startedServer = Semaphore.withPermit(starting, Effect.gen(function* () {
+        const current = yield* Ref.get(running);
+        if (current !== undefined)
+            return current;
+        const serverScope = yield* Scope.fork(driverScope);
+        const server = yield* Server.start({
+            agent: id,
+            command: options.command,
+            config: options.config,
+            env: options.env
+        }).pipe(Scope.provide(serverScope), Effect.onError((cause) => Scope.close(serverScope, Exit.failCause(cause))));
+        yield* Effect.forkIn(Effect.andThen(server.exited, Deferred.succeed(serverExited, undefined)), serverScope);
+        yield* Ref.set(running, server);
+        return server;
+    })).pipe(Effect.provide(services));
+    const driver = {
+        id,
+        serverExited: Deferred.await(serverExited),
+        createSession: (sessionOptions) => Effect.flatMap(startedServer, (server) => createSession(server, options, sessionOptions).pipe(Effect.provide(services)))
+    };
+    return driver;
+});
+//# sourceMappingURL=driver.js.map

package/internal/bridge/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/internal/bridge/driver.ts"],"names":[],"mappings":"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"}

package/internal/bridge/hostTools.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The host's tools as both versions of opencode reach them: through the bridge's `HostToolRelay`,
+ * an MCP server that opencode connects to for each session's directory as `host`, presenting the
+ * session's token. opencode lists an MCP server's tools when it connects, so the session connects
+ * it again whenever a turn's tools change, and disconnects it for a turn without any.
+ */
+import type { Bridge, HarnessError, HostToolRelay } from "@amends-dev/harness";
+import * as Effect from "effect/Effect";
+/** The name the relay's MCP server has in opencode. */
+export declare const serverName = "host";
+/** An MCP server the agent connects to over HTTP, presenting `headers`. */
+export interface RemoteMcpServer {
+    readonly url: string;
+    readonly headers: Readonly<Record<string, string>>;
+}
+/** How a session's directory adds, connects, and disconnects the relay's MCP server. */
+export interface McpServers {
+    readonly add: (server: RemoteMcpServer) => Effect.Effect<void, HarnessError.HarnessError>;
+    readonly reconnect: Effect.Effect<void, HarnessError.HarnessError>;
+    readonly disconnect: Effect.Effect<void, HarnessError.HarnessError>;
+}
+/**
+ * The function that has opencode list a turn's `tools` from the relay at `relayUrl` for the
+ * session `relaySession` opened, through `mcpServers`, doing nothing while they are the ones it
+ * lists already.
+ */
+export declare const makeLister: (relayUrl: string, relaySession: HostToolRelay.RelaySession, mcpServers: McpServers) => Effect.Effect<(tools: readonly Bridge.ToolDefinition[]) => Effect.Effect<void, HarnessError.HarnessError, never>, never, never>;
+//# sourceMappingURL=hostTools.d.ts.map

package/internal/bridge/hostTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostTools.d.ts","sourceRoot":"","sources":["../../../src/internal/bridge/hostTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC9E,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAIvC,uDAAuD;AACvD,eAAO,MAAM,UAAU,SAAS,CAAA;AAEhC,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACnD;AAED,wFAAwF;AACxF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,YAAY,CAAC,CAAA;IACzF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,YAAY,CAAC,CAAA;IAClE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,YAAY,CAAC,CAAA;CACpE;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,yNAwBrB,CAAA"}

package/internal/bridge/hostTools.js

@@ -0,0 +1,41 @@
+/**
+ * The host's tools as both versions of opencode reach them: through the bridge's `HostToolRelay`,
+ * an MCP server that opencode connects to for each session's directory as `host`, presenting the
+ * session's token. opencode lists an MCP server's tools when it connects, so the session connects
+ * it again whenever a turn's tools change, and disconnects it for a turn without any.
+ */
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import * as Ref from "effect/Ref";
+/** The name the relay's MCP server has in opencode. */
+export const serverName = "host";
+/**
+ * The function that has opencode list a turn's `tools` from the relay at `relayUrl` for the
+ * session `relaySession` opened, through `mcpServers`, doing nothing while they are the ones it
+ * lists already.
+ */
+export const makeLister = Effect.fnUntraced(function* (relayUrl, relaySession, mcpServers) {
+    /** The tools opencode lists, as JSON, or nothing while it lists none. */
+    const listed = yield* Ref.make(undefined);
+    const added = yield* Ref.make(false);
+    return Effect.fnUntraced(function* (tools) {
+        const wanted = tools.length === 0 ? undefined : JSON.stringify(tools);
+        if (wanted === (yield* Ref.get(listed)))
+            return;
+        if (wanted === undefined) {
+            yield* mcpServers.disconnect;
+        }
+        else if (yield* Ref.get(added)) {
+            yield* mcpServers.reconnect;
+        }
+        else {
+            yield* mcpServers.add({
+                url: relayUrl,
+                headers: { authorization: `Bearer ${Redacted.value(relaySession.token)}` }
+            });
+            yield* Ref.set(added, true);
+        }
+        yield* Ref.set(listed, wanted);
+    });
+});
+//# sourceMappingURL=hostTools.js.map

package/internal/bridge/hostTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostTools.js","sourceRoot":"","sources":["../../../src/internal/bridge/hostTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,GAAG,MAAM,YAAY,CAAA;AAEjC,uDAAuD;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAA;AAehC;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EACnD,QAAgB,EAChB,YAAwC,EACxC,UAAsB;IAEtB,yEAAyE;IACzE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAqB,SAAS,CAAC,CAAA;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,KAA2C;QAC7E,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACrE,IAAI,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAAE,OAAM;QAC/C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAA;QAC9B,CAAC;aAAM,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,CAAC,UAAU,CAAC,SAAS,CAAA;QAC7B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;gBACpB,GAAG,EAAE,QAAQ;gBACb,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE;aAC3E,CAAC,CAAA;YACF,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAC7B,CAAC;QACD,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/internal/bridge/server.d.ts

@@ -0,0 +1,64 @@
+/**
+ * opencode's server, which the bridge starts in its sandbox. One server serves every session in the
+ * sandbox, each in its own directory. `start` runs the server until the scope closes, listening
+ * only on 127.0.0.1, behind a password that `start` makes and gives the server in its environment.
+ * `start` picks a free port for it, since opencode takes port 0 as its default port, 4096, where
+ * the server of a bridge with other options may listen already. The bridge is the server's only
+ * client and lives exactly as long as it, so the password is kept nowhere else. The requests the
+ * bridge makes of the server are those of the API its version of opencode speaks, in `v1/api.ts`
+ * and `v2/api.ts`, over the client `start` returns.
+ *
+ * opencode reads the configuration `start` is given from a directory that `start` makes for it and
+ * removes when the scope closes, in place of the global configuration of the sandbox's user, which
+ * opencode would read from under the home directory. A project's own configuration, in the
+ * directory a session works in, applies over it.
+ *
+ * opencode's tools run with the server's environment, so the agent can read the password; it keeps
+ * out everything else on the machine. A failed request fails with the `HarnessError` the driver
+ * reports, naming the agent, as `requestError` maps it.
+ */
+import { HarnessError } from "@amends-dev/harness";
+import * as Crypto from "effect/Crypto";
+import * as Effect from "effect/Effect";
+import type * as Sse from "effect/encoding/Sse";
+import * as FileSystem from "effect/FileSystem";
+import * as HttpClient from "effect/http/HttpClient";
+import type * as HttpClientError from "effect/http/HttpClientError";
+import * as Path from "effect/Path";
+import * as ChildProcessSpawner from "effect/process/ChildProcessSpawner";
+import type * as Record from "effect/Record";
+import type * as Schema from "effect/Schema";
+export interface Options {
+    /** The agent the server runs for, which its errors name, such as `opencode`. */
+    readonly agent: string;
+    /** The command that runs opencode, such as `opencode`. */
+    readonly command: string;
+    /** opencode's configuration, as its `opencode.json` takes it. */
+    readonly config: {
+        readonly [key: string]: Schema.Json;
+    };
+    /** Environment variables opencode runs with. */
+    readonly env: Record.ReadonlyRecord<string, string>;
+}
+export interface Server {
+    /** The agent the server runs for, which the errors of its requests name. */
+    readonly agent: string;
+    /** Completes when the server exits, which it does before the scope closes only when it fails. */
+    readonly exited: Effect.Effect<void>;
+    /** A client of the server, at its URL, presenting its password. It answers every status. */
+    readonly client: HttpClient.HttpClient;
+    /** `client`, failing with the responses whose status is not a success. */
+    readonly clientOk: HttpClient.HttpClient;
+}
+/** Starts the server, which runs until the scope closes, and waits until it listens. */
+export declare const start: (options: Options) => Effect.Effect<Server, HarnessError.HarnessError, ChildProcessSpawner.ChildProcessSpawner | Crypto.Crypto | FileSystem.FileSystem | HttpClient.HttpClient | Path.Path | import("effect/Scope").Scope>;
+/** The error that `agent` reports for `reason`. */
+export declare const harnessError: (agent: string, reason: HarnessError.HarnessErrorReason, cause?: unknown) => HarnessError.HarnessError;
+/**
+ * The error `agent` reports for a request that failed with `error`: `UnavailableError` for a server
+ * it cannot reach, one that asks to be retried, or one that failed; `NotFoundError` for what the
+ * server has no record of; `AgentContractError` for an answer the agent cannot read; and
+ * `UnknownError` for the rest.
+ */
+export declare const requestError: (agent: string) => (error: HttpClientError.HttpClientError | Schema.SchemaError | Sse.SseError | Sse.Retry) => HarnessError.HarnessError;
+//# sourceMappingURL=server.d.ts.map

package/internal/bridge/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/internal/bridge/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,GAAG,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAA;AAE/C,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,KAAK,eAAe,MAAM,6BAA6B,CAAA;AAGnE,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AAGnC,OAAO,KAAK,mBAAmB,MAAM,oCAAoC,CAAA;AACzE,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAE5C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAG5C,MAAM,WAAW,OAAO;IACtB,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,CAAA;KAAE,CAAA;IAExD,gDAAgD;IAChD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,MAAM;IACrB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAEpC,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAA;IAEtC,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAA;CACzC;AAED,wFAAwF;AACxF,eAAO,MAAM,KAAK,4NAkDjB,CAAA;AA0CD,mDAAmD;AACnD,eAAO,MAAM,YAAY,UAAW,MAAM,UAAU,YAAY,CAAC,kBAAkB,UAAU,OAAO,8BAC3C,CAAA;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,UACf,MAAM,aAAa,eAAe,CAAC,eAAe,GAAG,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,KAAK,8BAyBtG,CAAA"}