Skip to content

nanocoai/nanoclaw / .claude/skills/add-opencode

add-opencode

Verified

Use OpenCode as an agent provider. OpenRouter, OpenAI, Google, DeepSeek, etc. via OpenCode config — not the Anthropic Agent SDK. Per group via `ncl groups config update --provider opencode`; host passes OPENCODE_* and XDG mount when spawning containers.

FileKindSize
ARCHITECTURE.mdmarkdown8.0 KB
REMOVE.mdmarkdown3.4 KB
SKILL.mdskill md19.8 KB
apply-fixtures.jsonconfig303 B
payload/container/agent-runner/src/provider-contracts/opencode.tsscript866 B
payload/container/agent-runner/src/providers/mcp-to-opencode.test.tsscript2.7 KB
payload/container/agent-runner/src/providers/mcp-to-opencode.tsscript1.6 KB
payload/container/agent-runner/src/providers/opencode-auth.test.tsscript3.1 KB
payload/container/agent-runner/src/providers/opencode-auth.tsscript1.7 KB
payload/container/agent-runner/src/providers/opencode-config.tsscript10.0 KB
payload/container/agent-runner/src/providers/opencode-memory.tsscript4.4 KB
payload/container/agent-runner/src/providers/opencode-registration.test.tsscript625 B
payload/container/agent-runner/src/providers/opencode-turn.tsscript14.1 KB
payload/container/agent-runner/src/providers/opencode.config.test.tsscript16.2 KB
payload/container/agent-runner/src/providers/opencode.conformance.test.tsscript253 B
payload/container/agent-runner/src/providers/opencode.empty-resume.test.tsscript14.7 KB
payload/container/agent-runner/src/providers/opencode.factory.test.tsscript331 B
payload/container/agent-runner/src/providers/opencode.memory.test.tsscript6.9 KB
payload/container/agent-runner/src/providers/opencode.native.test.tsscript17.6 KB
payload/container/agent-runner/src/providers/opencode.question.test.tsscript7.6 KB
payload/container/agent-runner/src/providers/opencode.shared-runtime.test.tsscript30.9 KB
payload/container/agent-runner/src/providers/opencode.sse-cleanup.test.tsscript6.4 KB
payload/container/agent-runner/src/providers/opencode.tsscript24.9 KB
payload/scripts/opencode-auth-config.test.tsscript27.1 KB
payload/scripts/opencode-auth.test.tsscript19.7 KB
payload/scripts/opencode-auth.tsscript21.4 KB
payload/scripts/opencode-gateway.test.tsscript7.1 KB
payload/scripts/opencode-host.test.tsscript13.4 KB
payload/scripts/opencode-host.tsscript8.9 KB
payload/scripts/opencode-model-config.tsscript8.6 KB
payload/scripts/opencode-models.test.tsscript10.6 KB
payload/scripts/opencode-models.tsscript4.0 KB
payload/scripts/opencode-vault.test.tsscript3.3 KB
payload/scripts/opencode-vault.tsscript2.7 KB
payload/scripts/tsconfig.opencode-auth.jsonconfig171 B
payload/setup/providers/opencode.test.tsscript1.2 KB
payload/setup/providers/opencode.tsscript806 B
payload/src/provider-contracts/opencode.tsscript2.9 KB
payload/src/providers/opencode-auth-stub.tsscript909 B
payload/src/providers/opencode-registration.test.tsscript8.5 KB
payload/src/providers/opencode.tsscript2.7 KB

payload/container/agent-runner/src/providers/opencode.sse-cleanup.test.ts

View on GitHub
import { afterEach, beforeEach, describe, expect, it } from 'bun:test';
import type { ChildProcess } from 'node:child_process';
import { EventEmitter } from 'node:events';
import { createServer, type ServerResponse } from 'node:http';
import { mkdtempSync, rmSync } from 'node:fs';
import { tmpdir } from 'node:os';
import path from 'node:path';
import { initTestSessionDb, closeSessionDb } from '../mailbox/sqlite/connection.js';
import { registerAgentMailbox, resetAgentMailboxForTesting } from '../mailbox/index.js';
import { SqliteAgentMailbox } from '../mailbox/sqlite/index.js';
import type { OpenCodeMessage } from './opencode-turn.js';
import { createOpencodeClient } from '@opencode-ai/sdk';
import {
  destroySharedRuntime,
  OpenCodeProvider,
  setSharedRuntimeDepsForTesting,
  type SseSubscribeOptions,
} from './opencode.js';

let directory: string;
let previousXdg: string | undefined;
let previousMailbox: ReturnType<typeof resetAgentMailboxForTesting>;
beforeEach(() => {
  directory = mkdtempSync(path.join(tmpdir(), 'opencode-sse-'));
  previousXdg = process.env.XDG_DATA_HOME;
  process.env.XDG_DATA_HOME = directory;
  previousMailbox = resetAgentMailboxForTesting();
  initTestSessionDb();
  registerAgentMailbox(() => new SqliteAgentMailbox());
});
afterEach(() => {
  destroySharedRuntime();
  setSharedRuntimeDepsForTesting();
  if (previousXdg === undefined) delete process.env.XDG_DATA_HOME;
  else process.env.XDG_DATA_HOME = previousXdg;
  resetAgentMailboxForTesting();
  closeSessionDb();
  if (previousMailbox) registerAgentMailbox(previousMailbox);
  rmSync(directory, { recursive: true, force: true });
});

// Exercise the pinned generated SDK, whose reader.cancel() abort rejection is
// invisible to the provider's fake event streams. No global rejection handler.
describe('real SDK event-stream teardown', () => {
  for (const phase of ['yield', 'read', 'backoff'] as const) {
    it(`releases during ${phase} without unhandled rejection or retry`, async () => {
      let response: ServerResponse | undefined;
      let requests = 0;
      let signalPrompt!: () => void;
      const prompted = new Promise<void>((resolve) => {
        signalPrompt = resolve;
      });
      let signalSleep!: () => void;
      const sleeping = new Promise<void>((resolve) => {
        signalSleep = resolve;
      });
      const send = (value: unknown) => response!.write(`data: ${JSON.stringify(value)}\n\n`);
      const server = createServer((_req, res) => {
        requests++;
        response = res;
        res.writeHead(200, { 'content-type': 'text/event-stream' });
        send({ type: 'server.connected', properties: {} });
        if (phase === 'yield') {
          send({ type: 'session.idle', properties: { sessionID: 'ses_fixture' } });
        } else if (phase === 'backoff') {
          setTimeout(() => res.destroy(), 5);
        }
      });
      await new Promise<void>((resolve) => server.listen(0, '127.0.0.1', resolve));
      const address = server.address() as { port: number };
      const url = `http://127.0.0.1:${address.port}`;
      const sdk = createOpencodeClient({ baseUrl: url });
      const proc = Object.assign(new EventEmitter(), {
        pid: undefined,
        exitCode: null,
        signalCode: null,
        kill: () => {
          server.closeAllConnections();
          return true;
        },
      }) as unknown as ChildProcess;
      const history: OpenCodeMessage[] = [];
      let finishPrompt: ((result: { error: unknown }) => void) | undefined;
      setSharedRuntimeDepsForTesting({
        spawnServer: async () => ({ url, proc }),
        createClient: () => ({
          session: {
            create: async () => ({ data: { id: 'ses_fixture' } }),
            messages: async () => ({ data: history }),
            abort: async () => {
              finishPrompt?.({ error: { name: 'MessageAbortedError' } });
              return {};
            },
            prompt: async (params) => {
              history.push({
                info: { id: params.body.messageID, role: 'user', time: { created: Date.now() } },
                parts: [],
              });
              signalPrompt();
              if (phase !== 'yield')
                return await new Promise((resolve) => {
                  finishPrompt = resolve;
                });
              const answer: OpenCodeMessage = {
                info: {
                  id: 'msg_answer',
                  role: 'assistant',
                  parentID: params.body.messageID,
                  time: { created: Date.now() },
                },
                parts: [{ id: 'prt_answer', type: 'text', text: 'done' }],
              };
              history.push(answer);
              return { data: answer };
            },
          },
          event: {
            subscribe: (options?: SseSubscribeOptions) =>
              sdk.event.subscribe({
                ...options,
                sseSleepFn: async () => {
                  signalSleep();
                  await options!.sseSleepFn!(30_000);
                },
              }),
          },
        }),
        createQuestionClient: () => ({
          question: { reply: async () => ({ data: true }), list: async () => ({ data: [] }) },
        }),
      });
      try {
        const provider = new OpenCodeProvider();
        provider.registerMemorySessionHook({ command: 'true', legacyCommands: [], sources: [] });
        const query = provider.query({ prompt: 'test', cwd: '/tmp' });
        query.end();
        const collected = (async () => {
          for await (const _event of query.events) {
          }
        })();
        // Attach a rejection handler before provoking the expected termination.
        const settled = collected.then(
          () => 'finished',
          () => 'stream-ended',
        );
        await prompted;
        if (phase === 'yield') await collected;
        else if (phase === 'backoff') await sleeping;
        else while (!response) await Bun.sleep(1);
        destroySharedRuntime();
        let timeout: ReturnType<typeof setTimeout>;
        try {
          await Promise.race([
            settled,
            new Promise((_, reject) => {
              timeout = setTimeout(() => reject(new Error('teardown did not wake stream')), 1000);
            }),
          ]);
        } finally {
          clearTimeout(timeout!);
        }
        await Bun.sleep(10);
        expect(requests).toBe(1);
      } finally {
        destroySharedRuntime();
        server.closeAllConnections();
        server.close();
      }
    });
  }
});
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall