@agent-controller/runtime-opencode 0.3.1

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+export interface CompiledSpec {
+    v: 1;
+    metadata: SpecMetadata;
+    model: Model;
+    persona?: Persona;
+    task: string;
+    tools: ResolvedRef[];
+    extensions: ResolvedRef[];
+    skills: ResolvedRef[];
+    mcpServers?: MCPServer[];
+    subagents?: ResolvedRef[];
+    /**
+     * Deprecated: use spec.extensions[].source instead.
+     * When non-empty the runtime emits a deprecation warning to stderr.
+     * Still passed through unchanged; `agentctl install --from` uses it.
+     */
+    installs?: string[];
+    runtime: RuntimeConfig;
+    guardrails?: Guardrails;
+    /** Set by CLI when user passes --resume <id>. Runtime opens/continues the named session. */
+    sessionId?: string;
+}
+/**
+ * Per-session safety guardrail configuration. Defaults are applied at use
+ * site in adapter.ts so this object can be `undefined` (no guardrails block
+ * in the spec) without forcing the compiler to materialize defaults.
+ */
+export interface Guardrails {
+    /**
+     * How the runtime reacts when the assistant fabricates tool-call XML in
+     * its message body. Defaults to "block" when absent. See honesty.ts for
+     * the behavior of each mode.
+     */
+    hallucinationDetector?: HallucinationMode;
+}
+export type HallucinationMode = "warn" | "block" | "correct";
+/** One MCP server declared in spec.mcpServers[]. Mirrors MCPServer in types.go. */
+export interface MCPServer {
+    name: string;
+    transport: "stdio" | "streamable-http" | "sse";
+    lifecycle?: "eager" | "lazy";
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+}
+export interface SpecMetadata {
+    name: string;
+    owner?: string;
+    description?: string;
+}
+export interface Model {
+    provider: "anthropic" | "openai" | "google";
+    name: string;
+    temperature?: number;
+}
+export interface Persona {
+    role?: string;
+    instructions?: string;
+}
+export interface ResolvedRef {
+    name: string;
+    /**
+     * Absolute path to the Pi extension entrypoint. Blank when source is
+     * set OR when builtin is true (Pi ships the implementation).
+     */
+    entrypoint?: string;
+    /**
+     * Pi-builtin tool (bash, read, edit, write). The runtime adds the name
+     * to Pi's tool allowlist without loading any entrypoint.
+     */
+    builtin?: boolean;
+    /**
+     * Self-install source, e.g. "npm:pi-mcp-extension".
+     * When set the runtime installs the package if missing and resolves
+     * the entrypoint from the package's pi.extensions manifest field.
+     * Only "npm:" prefix is supported at v0.1.6.
+     */
+    source?: string;
+    config?: Record<string, unknown>;
+}
+export interface RuntimeConfig {
+    /**
+     * Which adapter the CLI dispatches the CompiledSpec to. `local` is the
+     * v0.1.x legacy alias for `local-pi` (this Pi adapter) and remains
+     * accepted by the schema for backwards compatibility. `local-opencode`
+     * routes to the opencode adapter (runtime-opencode/), added in v0.2
+     * slice 2.1. Mirror of the enum in schemas/adl.v1alpha1.json.
+     */
+    type: "local" | "local-pi" | "local-opencode";
+    /**
+     * v0.3.1 additive field: free-form capability requirements the runtime
+     * must satisfy. Boolean flags consumed in two steps: v0.3.2 adds the
+     * RuntimeBinding schema (resource advertising what capabilities a
+     * target provides), and v0.3.3 wires Backend.Resolve() to compare the
+     * two. Today (v0.3.1) it passes through CompiledSpec unchanged and
+     * the opencode adapter does not act on it. Reserved well-known keys:
+     * streaming, sandbox, gpu, restrictedNetwork, ephemeralFilesystem.
+     * Arbitrary keys are accepted so capability bundles can advertise
+     * their own flags (e.g. spark, notebookContext).
+     */
+    requirements?: Record<string, boolean>;
+}
+export type WireEventType = "session.started" | "model.request" | "model.response" | "tool.call" | "tool.result" | "message" | "session.ended" | "warning" | "error";
+export interface WireEvent<T = unknown> {
+    v: 1;
+    type: WireEventType;
+    ts: string;
+    sessionId: string;
+    data: T;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+// Mirror of cli/internal/adl/types.go and the spec §6 stdin payload.
+export {};

package/dist/wire.d.ts

@@ -0,0 +1,5 @@
+import type { WireEvent, WireEventType } from "./types.js";
+/** Build a wire envelope from a session id, event type, and payload. */
+export declare function stamp<T>(sessionId: string, type: WireEventType, data: T): WireEvent<T>;
+/** Write one wire event as a single NDJSON line via the provided writer. */
+export declare function emit<T>(write: (s: string) => void, ev: WireEvent<T>): void;

package/dist/wire.js

@@ -0,0 +1,8 @@
+/** Build a wire envelope from a session id, event type, and payload. */
+export function stamp(sessionId, type, data) {
+    return { v: 1, type, ts: new Date().toISOString(), sessionId, data };
+}
+/** Write one wire event as a single NDJSON line via the provided writer. */
+export function emit(write, ev) {
+    write(JSON.stringify(ev) + "\n");
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@agent-controller/runtime-opencode",
+  "version": "0.3.1",
+  "description": "opencode runtime adapter for agent-controller — runs an ADL CompiledSpec against an opencode session via @opencode-ai/sdk and emits the NDJSON wire-event stream.",
+  "keywords": [
+    "agent-controller",
+    "adl",
+    "opencode",
+    "agent",
+    "ai-agents",
+    "llm",
+    "anthropic",
+    "runtime-adapter"
+  ],
+  "homepage": "https://github.com/CCDevelopForFun/agent-controller#readme",
+  "bugs": "https://github.com/CCDevelopForFun/agent-controller/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CCDevelopForFun/agent-controller.git",
+    "directory": "runtime-opencode"
+  },
+  "license": "MIT",
+  "author": "CCDevelopForFun",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p .",
+    "test": "npm run build && vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@opencode-ai/sdk": "^1.15.12"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "typescript": "latest",
+    "vitest": "latest"
+  }
+}