@toolkit-cli/toolkode 1.3.8 → 1.3.9

package/test/fixture/fixture.ts

@@ -1,141 +0,0 @@
-import { $ } from "bun"
-import * as fs from "fs/promises"
-import os from "os"
-import path from "path"
-import { Effect, FileSystem, ServiceMap } from "effect"
-import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process"
-import type { Config } from "../../src/config/config"
-import { Instance } from "../../src/project/instance"
-
-// Strip null bytes from paths (defensive fix for CI environment issues)
-function sanitizePath(p: string): string {
-  return p.replace(/\0/g, "")
-}
-
-function exists(dir: string) {
-  return fs
-    .stat(dir)
-    .then(() => true)
-    .catch(() => false)
-}
-
-function clean(dir: string) {
-  return fs.rm(dir, {
-    recursive: true,
-    force: true,
-    maxRetries: 5,
-    retryDelay: 100,
-  })
-}
-
-async function stop(dir: string) {
-  if (!(await exists(dir))) return
-  await $`git fsmonitor--daemon stop`.cwd(dir).quiet().nothrow()
-}
-
-type TmpDirOptions<T> = {
-  git?: boolean
-  config?: Partial<Config.Info>
-  init?: (dir: string) => Promise<T>
-  dispose?: (dir: string) => Promise<T>
-}
-export async function tmpdir<T>(options?: TmpDirOptions<T>) {
-  const dirpath = sanitizePath(path.join(os.tmpdir(), "opencode-test-" + Math.random().toString(36).slice(2)))
-  await fs.mkdir(dirpath, { recursive: true })
-  if (options?.git) {
-    await $`git init`.cwd(dirpath).quiet()
-    await $`git config core.fsmonitor false`.cwd(dirpath).quiet()
-    await $`git config user.email "test@opencode.test"`.cwd(dirpath).quiet()
-    await $`git config user.name "Test"`.cwd(dirpath).quiet()
-    await $`git commit --allow-empty -m "root commit ${dirpath}"`.cwd(dirpath).quiet()
-  }
-  if (options?.config) {
-    await Bun.write(
-      path.join(dirpath, "opencode.json"),
-      JSON.stringify({
-        $schema: "https://toolkode.com/config.json",
-        ...options.config,
-      }),
-    )
-  }
-  const realpath = sanitizePath(await fs.realpath(dirpath))
-  const extra = await options?.init?.(realpath)
-  const result = {
-    [Symbol.asyncDispose]: async () => {
-      try {
-        await options?.dispose?.(realpath)
-      } finally {
-        if (options?.git) await stop(realpath).catch(() => undefined)
-        await clean(realpath).catch(() => undefined)
-      }
-    },
-    path: realpath,
-    extra: extra as T,
-  }
-  return result
-}
-
-/** Effectful scoped tmpdir. Cleaned up when the scope closes. Make sure these stay in sync */
-export function tmpdirScoped(options?: { git?: boolean; config?: Partial<Config.Info> }) {
-  return Effect.gen(function* () {
-    const fs = yield* FileSystem.FileSystem
-    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner
-    const dir = yield* fs.makeTempDirectoryScoped({ prefix: "opencode-test-" })
-
-    const git = (...args: string[]) =>
-      spawner.spawn(ChildProcess.make("git", args, { cwd: dir })).pipe(Effect.flatMap((handle) => handle.exitCode))
-
-    if (options?.git) {
-      yield* git("init")
-      yield* git("config", "core.fsmonitor", "false")
-      yield* git("config", "user.email", "test@opencode.test")
-      yield* git("config", "user.name", "Test")
-      yield* git("commit", "--allow-empty", "-m", "root commit")
-    }
-
-    if (options?.config) {
-      yield* fs.writeFileString(
-        path.join(dir, "opencode.json"),
-        JSON.stringify({ $schema: "https://toolkode.com/config.json", ...options.config }),
-      )
-    }
-
-    return dir
-  })
-}
-
-export const provideInstance =
-  (directory: string) =>
-  <A, E, R>(self: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> =>
-    Effect.servicesWith((services: ServiceMap.ServiceMap<R>) =>
-      Effect.promise<A>(async () =>
-        Instance.provide({
-          directory,
-          fn: () => Effect.runPromiseWith(services)(self),
-        }),
-      ),
-    )
-
-export function provideTmpdirInstance<A, E, R>(
-  self: (path: string) => Effect.Effect<A, E, R>,
-  options?: { git?: boolean; config?: Partial<Config.Info> },
-) {
-  return Effect.gen(function* () {
-    const path = yield* tmpdirScoped(options)
-    let provided = false
-
-    yield* Effect.addFinalizer(() =>
-      provided
-        ? Effect.promise(() =>
-            Instance.provide({
-              directory: path,
-              fn: () => Instance.dispose(),
-            }),
-          ).pipe(Effect.ignore)
-        : Effect.void,
-    )
-
-    provided = true
-    return yield* self(path).pipe(provideInstance(path))
-  })
-}

package/test/fixture/flock-worker.ts

@@ -1,72 +0,0 @@
-import fs from "fs/promises"
-import { Flock } from "../../src/util/flock"
-
-type Msg = {
-  key: string
-  dir: string
-  staleMs?: number
-  timeoutMs?: number
-  baseDelayMs?: number
-  maxDelayMs?: number
-  holdMs?: number
-  ready?: string
-  active?: string
-  done?: string
-}
-
-function sleep(ms: number) {
-  return new Promise<void>((resolve) => {
-    setTimeout(resolve, ms)
-  })
-}
-
-function input() {
-  const raw = process.argv[2]
-  if (!raw) {
-    throw new Error("Missing flock worker input")
-  }
-
-  return JSON.parse(raw) as Msg
-}
-
-async function job(input: Msg) {
-  if (input.ready) {
-    await fs.writeFile(input.ready, String(process.pid))
-  }
-
-  if (input.active) {
-    await fs.writeFile(input.active, String(process.pid), { flag: "wx" })
-  }
-
-  try {
-    if (input.holdMs && input.holdMs > 0) {
-      await sleep(input.holdMs)
-    }
-
-    if (input.done) {
-      await fs.appendFile(input.done, "1\n")
-    }
-  } finally {
-    if (input.active) {
-      await fs.rm(input.active, { force: true })
-    }
-  }
-}
-
-async function main() {
-  const msg = input()
-
-  await Flock.withLock(msg.key, () => job(msg), {
-    dir: msg.dir,
-    staleMs: msg.staleMs,
-    timeoutMs: msg.timeoutMs,
-    baseDelayMs: msg.baseDelayMs,
-    maxDelayMs: msg.maxDelayMs,
-  })
-}
-
-await main().catch((err) => {
-  const text = err instanceof Error ? (err.stack ?? err.message) : String(err)
-  process.stderr.write(text)
-  process.exit(1)
-})

package/test/fixture/lsp/fake-lsp-server.js

@@ -1,77 +0,0 @@
-// Simple JSON-RPC 2.0 LSP-like fake server over stdio
-// Implements a minimal LSP handshake and triggers a request upon notification
-
-const net = require("net")
-
-let nextId = 1
-
-function encode(message) {
-  const json = JSON.stringify(message)
-  const header = `Content-Length: ${Buffer.byteLength(json, "utf8")}\r\n\r\n`
-  return Buffer.concat([Buffer.from(header, "utf8"), Buffer.from(json, "utf8")])
-}
-
-function decodeFrames(buffer) {
-  const results = []
-  let idx
-  while ((idx = buffer.indexOf("\r\n\r\n")) !== -1) {
-    const header = buffer.slice(0, idx).toString("utf8")
-    const m = /Content-Length:\s*(\d+)/i.exec(header)
-    const len = m ? parseInt(m[1], 10) : 0
-    const bodyStart = idx + 4
-    const bodyEnd = bodyStart + len
-    if (buffer.length < bodyEnd) break
-    const body = buffer.slice(bodyStart, bodyEnd).toString("utf8")
-    results.push(body)
-    buffer = buffer.slice(bodyEnd)
-  }
-  return { messages: results, rest: buffer }
-}
-
-let readBuffer = Buffer.alloc(0)
-
-process.stdin.on("data", (chunk) => {
-  readBuffer = Buffer.concat([readBuffer, chunk])
-  const { messages, rest } = decodeFrames(readBuffer)
-  readBuffer = rest
-  for (const m of messages) handle(m)
-})
-
-function send(msg) {
-  process.stdout.write(encode(msg))
-}
-
-function sendRequest(method, params) {
-  const id = nextId++
-  send({ jsonrpc: "2.0", id, method, params })
-  return id
-}
-
-function handle(raw) {
-  let data
-  try {
-    data = JSON.parse(raw)
-  } catch {
-    return
-  }
-  if (data.method === "initialize") {
-    send({ jsonrpc: "2.0", id: data.id, result: { capabilities: {} } })
-    return
-  }
-  if (data.method === "initialized") {
-    return
-  }
-  if (data.method === "workspace/didChangeConfiguration") {
-    return
-  }
-  if (data.method === "test/trigger") {
-    const method = data.params && data.params.method
-    if (method) sendRequest(method, {})
-    return
-  }
-  if (typeof data.id !== "undefined") {
-    // Respond OK to any request from client to keep transport flowing
-    send({ jsonrpc: "2.0", id: data.id, result: null })
-    return
-  }
-}

package/test/fixture/plug-worker.ts

@@ -1,93 +0,0 @@
-import path from "path"
-
-import { createPlugTask, type PlugCtx, type PlugDeps } from "../../src/cli/cmd/plug"
-import { Filesystem } from "../../src/util/filesystem"
-
-type Msg = {
-  dir: string
-  target: string
-  mod: string
-  global?: boolean
-  force?: boolean
-  globalDir?: string
-  vcs?: string
-  worktree?: string
-  directory?: string
-  holdMs?: number
-}
-
-function sleep(ms: number) {
-  return new Promise<void>((resolve) => {
-    setTimeout(resolve, ms)
-  })
-}
-
-function input() {
-  const raw = process.argv[2]
-  if (!raw) {
-    throw new Error("Missing plug worker input")
-  }
-
-  const msg = JSON.parse(raw) as Partial<Msg>
-  if (!msg.dir || !msg.target || !msg.mod) {
-    throw new Error("Invalid plug worker input")
-  }
-
-  return msg as Msg
-}
-
-function deps(msg: Msg): PlugDeps {
-  return {
-    spinner: () => ({
-      start() {},
-      stop() {},
-    }),
-    log: {
-      error() {},
-      info() {},
-      success() {},
-    },
-    resolve: async () => msg.target,
-    readText: (file) => Filesystem.readText(file),
-    write: async (file, text) => {
-      if (msg.holdMs && msg.holdMs > 0) {
-        await sleep(msg.holdMs)
-      }
-      await Filesystem.write(file, text)
-    },
-    exists: (file) => Filesystem.exists(file),
-    files: (dir, name) => [path.join(dir, `${name}.jsonc`), path.join(dir, `${name}.json`)],
-    global: msg.globalDir ?? path.join(msg.dir, ".global"),
-  }
-}
-
-function ctx(msg: Msg): PlugCtx {
-  return {
-    vcs: msg.vcs ?? "git",
-    worktree: msg.worktree ?? msg.dir,
-    directory: msg.directory ?? msg.dir,
-  }
-}
-
-async function main() {
-  const msg = input()
-  const run = createPlugTask(
-    {
-      mod: msg.mod,
-      global: msg.global,
-      force: msg.force,
-    },
-    deps(msg),
-  )
-
-  const ok = await run(ctx(msg))
-  if (!ok) {
-    throw new Error("Plug task failed")
-  }
-}
-
-await main().catch((err) => {
-  const text = err instanceof Error ? (err.stack ?? err.message) : String(err)
-  process.stderr.write(text)
-  process.exit(1)
-})

package/test/fixture/plugin-meta-worker.ts

@@ -1,26 +0,0 @@
-type Msg = {
-  file: string
-  spec: string
-  target: string
-  id: string
-}
-
-const raw = process.argv[2]
-if (!raw) throw new Error("Missing worker payload")
-
-const value = JSON.parse(raw)
-if (!value || typeof value !== "object") {
-  throw new Error("Invalid worker payload")
-}
-
-const msg = Object.fromEntries(Object.entries(value))
-if (typeof msg.file !== "string" || typeof msg.spec !== "string" || typeof msg.target !== "string") {
-  throw new Error("Invalid worker payload")
-}
-if (typeof msg.id !== "string") throw new Error("Invalid worker payload")
-
-process.env.OPENCODE_PLUGIN_META_FILE = msg.file
-
-const { PluginMeta } = await import("../../src/plugin/meta")
-
-await PluginMeta.touch(msg.spec, msg.target, msg.id)

package/test/fixture/skills/agents-sdk/SKILL.md

@@ -1,152 +0,0 @@
----
-name: agents-sdk
-description: Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, or chat applications. Covers Agent class, state management, callable RPC, Workflows integration, and React hooks.
----
-
-# Cloudflare Agents SDK
-
-**STOP.** Your knowledge of the Agents SDK may be outdated. Prefer retrieval over pre-training for any Agents SDK task.
-
-## Documentation
-
-Fetch current docs from `https://github.com/cloudflare/agents/tree/main/docs` before implementing.
-
-| Topic               | Doc                           | Use for                                        |
-| ------------------- | ----------------------------- | ---------------------------------------------- |
-| Getting started     | `docs/getting-started.md`     | First agent, project setup                     |
-| State               | `docs/state.md`               | `setState`, `validateStateChange`, persistence |
-| Routing             | `docs/routing.md`             | URL patterns, `routeAgentRequest`, `basePath`  |
-| Callable methods    | `docs/callable-methods.md`    | `@callable`, RPC, streaming, timeouts          |
-| Scheduling          | `docs/scheduling.md`          | `schedule()`, `scheduleEvery()`, cron          |
-| Workflows           | `docs/workflows.md`           | `AgentWorkflow`, durable multi-step tasks      |
-| HTTP/WebSockets     | `docs/http-websockets.md`     | Lifecycle hooks, hibernation                   |
-| Email               | `docs/email.md`               | Email routing, secure reply resolver           |
-| MCP client          | `docs/mcp-client.md`          | Connecting to MCP servers                      |
-| MCP server          | `docs/mcp-servers.md`         | Building MCP servers with `McpAgent`           |
-| Client SDK          | `docs/client-sdk.md`          | `useAgent`, `useAgentChat`, React hooks        |
-| Human-in-the-loop   | `docs/human-in-the-loop.md`   | Approval flows, pausing workflows              |
-| Resumable streaming | `docs/resumable-streaming.md` | Stream recovery on disconnect                  |
-
-Cloudflare docs: https://developers.cloudflare.com/agents/
-
-## Capabilities
-
-The Agents SDK provides:
-
-- **Persistent state** - SQLite-backed, auto-synced to clients
-- **Callable RPC** - `@callable()` methods invoked over WebSocket
-- **Scheduling** - One-time, recurring (`scheduleEvery`), and cron tasks
-- **Workflows** - Durable multi-step background processing via `AgentWorkflow`
-- **MCP integration** - Connect to MCP servers or build your own with `McpAgent`
-- **Email handling** - Receive and reply to emails with secure routing
-- **Streaming chat** - `AIChatAgent` with resumable streams
-- **React hooks** - `useAgent`, `useAgentChat` for client apps
-
-## FIRST: Verify Installation
-
-```bash
-npm ls agents  # Should show agents package
-```
-
-If not installed:
-
-```bash
-npm install agents
-```
-
-## Wrangler Configuration
-
-```jsonc
-{
-  "durable_objects": {
-    "bindings": [{ "name": "MyAgent", "class_name": "MyAgent" }],
-  },
-  "migrations": [{ "tag": "v1", "new_sqlite_classes": ["MyAgent"] }],
-}
-```
-
-## Agent Class
-
-```typescript
-import { Agent, routeAgentRequest, callable } from "agents"
-
-type State = { count: number }
-
-export class Counter extends Agent<Env, State> {
-  initialState = { count: 0 }
-
-  // Validation hook - runs before state persists (sync, throwing rejects the update)
-  validateStateChange(nextState: State, source: Connection | "server") {
-    if (nextState.count < 0) throw new Error("Count cannot be negative")
-  }
-
-  // Notification hook - runs after state persists (async, non-blocking)
-  onStateUpdate(state: State, source: Connection | "server") {
-    console.log("State updated:", state)
-  }
-
-  @callable()
-  increment() {
-    this.setState({ count: this.state.count + 1 })
-    return this.state.count
-  }
-}
-
-export default {
-  fetch: (req, env) => routeAgentRequest(req, env) ?? new Response("Not found", { status: 404 }),
-}
-```
-
-## Routing
-
-Requests route to `/agents/{agent-name}/{instance-name}`:
-
-| Class      | URL                        |
-| ---------- | -------------------------- |
-| `Counter`  | `/agents/counter/user-123` |
-| `ChatRoom` | `/agents/chat-room/lobby`  |
-
-Client: `useAgent({ agent: "Counter", name: "user-123" })`
-
-## Core APIs
-
-| Task                | API                                                    |
-| ------------------- | ------------------------------------------------------ |
-| Read state          | `this.state.count`                                     |
-| Write state         | `this.setState({ count: 1 })`                          |
-| SQL query           | `` this.sql`SELECT * FROM users WHERE id = ${id}` ``   |
-| Schedule (delay)    | `await this.schedule(60, "task", payload)`             |
-| Schedule (cron)     | `await this.schedule("0 * * * *", "task", payload)`    |
-| Schedule (interval) | `await this.scheduleEvery(30, "poll")`                 |
-| RPC method          | `@callable() myMethod() { ... }`                       |
-| Streaming RPC       | `@callable({ streaming: true }) stream(res) { ... }`   |
-| Start workflow      | `await this.runWorkflow("ProcessingWorkflow", params)` |
-
-## React Client
-
-```tsx
-import { useAgent } from "agents/react"
-
-function App() {
-  const [state, setLocalState] = useState({ count: 0 })
-
-  const agent = useAgent({
-    agent: "Counter",
-    name: "my-instance",
-    onStateUpdate: (newState) => setLocalState(newState),
-    onIdentity: (name, agentType) => console.log(`Connected to ${name}`),
-  })
-
-  return <button onClick={() => agent.setState({ count: state.count + 1 })}>Count: {state.count}</button>
-}
-```
-
-## References
-
-- **[references/workflows.md](references/workflows.md)** - Durable Workflows integration
-- **[references/callable.md](references/callable.md)** - RPC methods, streaming, timeouts
-- **[references/state-scheduling.md](references/state-scheduling.md)** - State persistence, scheduling
-- **[references/streaming-chat.md](references/streaming-chat.md)** - AIChatAgent, resumable streams
-- **[references/mcp.md](references/mcp.md)** - MCP server integration
-- **[references/email.md](references/email.md)** - Email routing and handling
-- **[references/codemode.md](references/codemode.md)** - Code Mode (experimental)

package/test/fixture/skills/agents-sdk/references/callable.md

@@ -1,92 +0,0 @@
-# Callable Methods
-
-Fetch `docs/callable-methods.md` from `https://github.com/cloudflare/agents/tree/main/docs` for complete documentation.
-
-## Overview
-
-`@callable()` exposes agent methods to clients via WebSocket RPC.
-
-```typescript
-import { Agent, callable } from "agents"
-
-export class MyAgent extends Agent<Env, State> {
-  @callable()
-  async greet(name: string): Promise<string> {
-    return `Hello, ${name}!`
-  }
-
-  @callable()
-  async processData(data: unknown): Promise<Result> {
-    // Long-running work
-    return result
-  }
-}
-```
-
-## Client Usage
-
-```typescript
-// Basic call
-const greeting = await agent.call("greet", ["World"])
-
-// With timeout
-const result = await agent.call("processData", [data], {
-  timeout: 5000, // 5 second timeout
-})
-```
-
-## Streaming Responses
-
-```typescript
-import { Agent, callable, StreamingResponse } from "agents"
-
-export class MyAgent extends Agent<Env, State> {
-  @callable({ streaming: true })
-  async streamResults(stream: StreamingResponse, query: string) {
-    for await (const item of fetchResults(query)) {
-      stream.send(JSON.stringify(item))
-    }
-    stream.close()
-  }
-
-  @callable({ streaming: true })
-  async streamWithError(stream: StreamingResponse) {
-    try {
-      // ... work
-    } catch (error) {
-      stream.error(error.message) // Signal error to client
-      return
-    }
-    stream.close()
-  }
-}
-```
-
-Client with streaming:
-
-```typescript
-await agent.call("streamResults", ["search term"], {
-  stream: {
-    onChunk: (data) => console.log("Chunk:", data),
-    onDone: () => console.log("Complete"),
-    onError: (error) => console.error("Error:", error),
-  },
-})
-```
-
-## Introspection
-
-```typescript
-// Get list of callable methods on an agent
-const methods = await agent.call("getCallableMethods", [])
-// Returns: ["greet", "processData", "streamResults", ...]
-```
-
-## When to Use
-
-| Scenario                             | Use                         |
-| ------------------------------------ | --------------------------- |
-| Browser/mobile calling agent         | `@callable()`               |
-| External service calling agent       | `@callable()`               |
-| Worker calling agent (same codebase) | DO RPC directly             |
-| Agent calling another agent          | `getAgentByName()` + DO RPC |