artificial-code 1.17.13 → 1.17.14

package/bin/ac

@@ -1,5 +1,16 @@
 #!/usr/bin/env node
 
+/**
+ * Launcher for Artificial Code (ac).
+ *
+ * Resolves the pre-compiled native binary from the platform-specific
+ * opencode-* npm packages (the same packages used by opencode-ai) and
+ * runs it, forwarding all arguments and signals.
+ *
+ * Override the binary path with the AC_BIN_PATH environment variable,
+ * or point to a cached binary with the .ac file next to this script.
+ */
+
 const childProcess = require("child_process")
 const fs = require("fs")
 const path = require("path")
@@ -43,14 +54,18 @@ function run(target) {
   })
 }
 
+// ── Environment override ──────────────────────────────────────────────────────
+
 const envPath = process.env.AC_BIN_PATH
 
 const scriptPath = fs.realpathSync(__filename)
 const scriptDir = path.dirname(scriptPath)
 
-//
+// A manually cached binary written next to this script takes second priority.
 const cached = path.join(scriptDir, ".ac")
 
+// ── Platform detection ────────────────────────────────────────────────────────
+
 const platformMap = {
   darwin: "darwin",
   linux: "linux",
@@ -62,16 +77,14 @@ const archMap = {
   arm: "arm",
 }
 
-let platform = platformMap[os.platform()]
-if (!platform) {
-  platform = os.platform()
-}
-let arch = archMap[os.arch()]
-if (!arch) {
-  arch = os.arch()
-}
-const base = "ac-" + platform + "-" + arch
-const binary = platform === "windows" ? "ac.exe" : "ac"
+const platform = platformMap[os.platform()] || os.platform()
+const arch = archMap[os.arch()] || os.arch()
+
+// The platform packages use the "opencode-<os>-<arch>" naming convention and
+// contain a binary called "opencode" (or "opencode.exe" on Windows).
+// These are the packages that opencode-ai depends on and that are published to npm.
+const pkgPrefix = "opencode-" + platform + "-" + arch
+const binary = platform === "windows" ? "opencode.exe" : "opencode"
 
 function supportsAvx2() {
   if (arch !== "x64") return false
@@ -123,7 +136,9 @@ function supportsAvx2() {
   return false
 }
 
-const names = (() => {
+// Build the ordered list of package names to try, from most-specific to least.
+// Mirrors the priority used by opencode-ai's own wrapper.
+const pkgNames = (() => {
   const avx2 = supportsAvx2()
   const baseline = arch === "x64" && !avx2
 
@@ -134,7 +149,6 @@ const names = (() => {
       } catch {
         // ignore
       }
-
       try {
         const result = childProcess.spawnSync("ldd", ["--version"], { encoding: "utf8" })
         const text = ((result.stdout || "") + (result.stderr || "")).toLowerCase()
@@ -142,56 +156,67 @@ const names = (() => {
       } catch {
         // ignore
       }
-
       return false
     })()
 
     if (musl) {
       if (arch === "x64") {
-        if (baseline) return [`${base}-baseline-musl`, `${base}-musl`, `${base}-baseline`, base]
-        return [`${base}-musl`, `${base}-baseline-musl`, base, `${base}-baseline`]
+        if (baseline) return [`${pkgPrefix}-baseline-musl`, `${pkgPrefix}-musl`, `${pkgPrefix}-baseline`, pkgPrefix]
+        return [`${pkgPrefix}-musl`, `${pkgPrefix}-baseline-musl`, pkgPrefix, `${pkgPrefix}-baseline`]
       }
-      return [`${base}-musl`, base]
+      return [`${pkgPrefix}-musl`, pkgPrefix]
     }
 
     if (arch === "x64") {
-      if (baseline) return [`${base}-baseline`, base, `${base}-baseline-musl`, `${base}-musl`]
-      return [base, `${base}-baseline`, `${base}-musl`, `${base}-baseline-musl`]
+      if (baseline) return [`${pkgPrefix}-baseline`, pkgPrefix, `${pkgPrefix}-baseline-musl`, `${pkgPrefix}-musl`]
+      return [pkgPrefix, `${pkgPrefix}-baseline`, `${pkgPrefix}-musl`, `${pkgPrefix}-baseline-musl`]
     }
-    return [base, `${base}-musl`]
+    return [pkgPrefix, `${pkgPrefix}-musl`]
   }
 
   if (arch === "x64") {
-    if (baseline) return [`${base}-baseline`, base]
-    return [base, `${base}-baseline`]
+    if (baseline) return [`${pkgPrefix}-baseline`, pkgPrefix]
+    return [pkgPrefix, `${pkgPrefix}-baseline`]
   }
-  return [base]
+  return [pkgPrefix]
 })()
 
+// ── Binary resolution ─────────────────────────────────────────────────────────
+
 function findBinary(startDir) {
   let current = startDir
   for (;;) {
     const modules = path.join(current, "node_modules")
     if (fs.existsSync(modules)) {
-      for (const name of names) {
-        const candidate = path.join(modules, name, "bin", binary)
+      for (const pkg of pkgNames) {
+        const candidate = path.join(modules, pkg, "bin", binary)
         if (fs.existsSync(candidate)) return candidate
       }
     }
     const parent = path.dirname(current)
-    if (parent === current) {
-      return
-    }
+    if (parent === current) return undefined
     current = parent
   }
 }
 
 const resolved = envPath || (fs.existsSync(cached) ? cached : findBinary(scriptDir))
+
 if (!resolved) {
   console.error(
-    "It seems that your package manager failed to install the right version of the Artificial Code CLI for your platform. You can try manually installing " +
-      names.map((n) => `"${n}"`).join(" or ") +
-      " package",
+    [
+      "Error: Artificial Code binary not found for your platform.",
+      "",
+      "This usually means the platform package was not installed.",
+      "Try reinstalling:",
+      "  npm install -g artificial-code",
+      "  pnpm add -g artificial-code",
+      "  bun add -g artificial-code",
+      "",
+      "You can also override the binary path:",
+      "  AC_BIN_PATH=/path/to/opencode ac",
+      "",
+      "Expected package (one of): " + pkgNames.join(", "),
+    ].join("\n"),
   )
   process.exit(1)
 }

package/bin/ac.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+
+/**
+ * Launcher for Artificial Code (ac).
+ *
+ * Resolves the pre-compiled native binary from the platform-specific
+ * opencode-* npm packages (the same packages used by opencode-ai) and
+ * runs it, forwarding all arguments and signals.
+ *
+ * Override the binary path with the AC_BIN_PATH environment variable,
+ * or point to a cached binary with the .ac file next to this script.
+ */
+
+const childProcess = require("child_process")
+const fs = require("fs")
+const path = require("path")
+const os = require("os")
+
+const forwardedSignals = ["SIGINT", "SIGTERM", "SIGHUP"]
+
+function run(target) {
+  const child = childProcess.spawn(target, process.argv.slice(2), {
+    stdio: "inherit",
+  })
+
+  child.on("error", (error) => {
+    console.error(error.message)
+    process.exit(1)
+  })
+
+  const forwarders = {}
+  for (const signal of forwardedSignals) {
+    forwarders[signal] = () => {
+      try {
+        child.kill(signal)
+      } catch {
+        // The child may have already exited.
+      }
+    }
+    process.on(signal, forwarders[signal])
+  }
+
+  child.on("exit", (code, signal) => {
+    for (const forwardedSignal of forwardedSignals) {
+      process.removeListener(forwardedSignal, forwarders[forwardedSignal])
+    }
+
+    if (signal) {
+      process.kill(process.pid, signal)
+      return
+    }
+
+    process.exit(typeof code === "number" ? code : 0)
+  })
+}
+
+// ── Environment override ──────────────────────────────────────────────────────
+
+const envPath = process.env.AC_BIN_PATH
+
+const scriptPath = fs.realpathSync(__filename)
+const scriptDir = path.dirname(scriptPath)
+
+// A manually cached binary written next to this script takes second priority.
+const cached = path.join(scriptDir, ".ac")
+
+// ── Platform detection ────────────────────────────────────────────────────────
+
+const platformMap = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+}
+const archMap = {
+  x64: "x64",
+  arm64: "arm64",
+  arm: "arm",
+}
+
+const platform = platformMap[os.platform()] || os.platform()
+const arch = archMap[os.arch()] || os.arch()
+
+// The platform packages use the "opencode-<os>-<arch>" naming convention and
+// contain a binary called "opencode" (or "opencode.exe" on Windows).
+// These are the packages that opencode-ai depends on and that are published to npm.
+const pkgPrefix = "opencode-" + platform + "-" + arch
+const binary = platform === "windows" ? "opencode.exe" : "opencode"
+
+function supportsAvx2() {
+  if (arch !== "x64") return false
+
+  if (platform === "linux") {
+    try {
+      return /(^|\s)avx2(\s|$)/i.test(fs.readFileSync("/proc/cpuinfo", "utf8"))
+    } catch {
+      return false
+    }
+  }
+
+  if (platform === "darwin") {
+    try {
+      const result = childProcess.spawnSync("sysctl", ["-n", "hw.optional.avx2_0"], {
+        encoding: "utf8",
+        timeout: 1500,
+      })
+      if (result.status !== 0) return false
+      return (result.stdout || "").trim() === "1"
+    } catch {
+      return false
+    }
+  }
+
+  if (platform === "windows") {
+    const cmd =
+      '(Add-Type -MemberDefinition "[DllImport(""kernel32.dll"")] public static extern bool IsProcessorFeaturePresent(int ProcessorFeature);" -Name Kernel32 -Namespace Win32 -PassThru)::IsProcessorFeaturePresent(40)'
+
+    for (const exe of ["powershell.exe", "pwsh.exe", "pwsh", "powershell"]) {
+      try {
+        const result = childProcess.spawnSync(exe, ["-NoProfile", "-NonInteractive", "-Command", cmd], {
+          encoding: "utf8",
+          timeout: 3000,
+          windowsHide: true,
+        })
+        if (result.status !== 0) continue
+        const out = (result.stdout || "").trim().toLowerCase()
+        if (out === "true" || out === "1") return true
+        if (out === "false" || out === "0") return false
+      } catch {
+        continue
+      }
+    }
+
+    return false
+  }
+
+  return false
+}
+
+// Build the ordered list of package names to try, from most-specific to least.
+// Mirrors the priority used by opencode-ai's own wrapper.
+const pkgNames = (() => {
+  const avx2 = supportsAvx2()
+  const baseline = arch === "x64" && !avx2
+
+  if (platform === "linux") {
+    const musl = (() => {
+      try {
+        if (fs.existsSync("/etc/alpine-release")) return true
+      } catch {
+        // ignore
+      }
+      try {
+        const result = childProcess.spawnSync("ldd", ["--version"], { encoding: "utf8" })
+        const text = ((result.stdout || "") + (result.stderr || "")).toLowerCase()
+        if (text.includes("musl")) return true
+      } catch {
+        // ignore
+      }
+      return false
+    })()
+
+    if (musl) {
+      if (arch === "x64") {
+        if (baseline) return [`${pkgPrefix}-baseline-musl`, `${pkgPrefix}-musl`, `${pkgPrefix}-baseline`, pkgPrefix]
+        return [`${pkgPrefix}-musl`, `${pkgPrefix}-baseline-musl`, pkgPrefix, `${pkgPrefix}-baseline`]
+      }
+      return [`${pkgPrefix}-musl`, pkgPrefix]
+    }
+
+    if (arch === "x64") {
+      if (baseline) return [`${pkgPrefix}-baseline`, pkgPrefix, `${pkgPrefix}-baseline-musl`, `${pkgPrefix}-musl`]
+      return [pkgPrefix, `${pkgPrefix}-baseline`, `${pkgPrefix}-musl`, `${pkgPrefix}-baseline-musl`]
+    }
+    return [pkgPrefix, `${pkgPrefix}-musl`]
+  }
+
+  if (arch === "x64") {
+    if (baseline) return [`${pkgPrefix}-baseline`, pkgPrefix]
+    return [pkgPrefix, `${pkgPrefix}-baseline`]
+  }
+  return [pkgPrefix]
+})()
+
+// ── Binary resolution ─────────────────────────────────────────────────────────
+
+function findBinary(startDir) {
+  let current = startDir
+  for (;;) {
+    const modules = path.join(current, "node_modules")
+    if (fs.existsSync(modules)) {
+      for (const pkg of pkgNames) {
+        const candidate = path.join(modules, pkg, "bin", binary)
+        if (fs.existsSync(candidate)) return candidate
+      }
+    }
+    const parent = path.dirname(current)
+    if (parent === current) return undefined
+    current = parent
+  }
+}
+
+const resolved = envPath || (fs.existsSync(cached) ? cached : findBinary(scriptDir))
+
+if (!resolved) {
+  console.error(
+    [
+      "Error: Artificial Code binary not found for your platform.",
+      "",
+      "This usually means the platform package was not installed.",
+      "Try reinstalling:",
+      "  npm install -g artificial-code",
+      "  pnpm add -g artificial-code",
+      "  bun add -g artificial-code",
+      "",
+      "You can also override the binary path:",
+      "  AC_BIN_PATH=/path/to/opencode ac",
+      "",
+      "Expected package (one of): " + pkgNames.join(", "),
+    ].join("\n"),
+  )
+  process.exit(1)
+}
+
+run(resolved)

package/package.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
-  "version": "1.17.13",
+  "version": "1.17.14",
   "name": "artificial-code",
   "type": "module",
   "license": "MIT",
@@ -11,7 +11,7 @@
     "dev": "bun run --conditions=browser ./src/index.ts"
   },
   "bin": {
-    "ac": "./bin/ac"
+    "ac": "bin/ac.js"
   },
   "exports": {
     "./*": "./src/*.ts"
@@ -150,6 +150,20 @@
     "drizzle-orm": "catalog:"
   },
   "description": "Artificial Code — open-source AI coding agent for the terminal",
+  "optionalDependencies": {
+    "opencode-linux-x64": "1.17.13",
+    "opencode-linux-arm64": "1.17.13",
+    "opencode-linux-x64-baseline": "1.17.13",
+    "opencode-linux-x64-musl": "1.17.13",
+    "opencode-linux-arm64-musl": "1.17.13",
+    "opencode-linux-x64-baseline-musl": "1.17.13",
+    "opencode-darwin-arm64": "1.17.13",
+    "opencode-darwin-x64": "1.17.13",
+    "opencode-darwin-x64-baseline": "1.17.13",
+    "opencode-windows-x64": "1.17.13",
+    "opencode-windows-arm64": "1.17.13",
+    "opencode-windows-x64-baseline": "1.17.13"
+  },
   "publishConfig": {
     "access": "public"
   }

package/AGENTS.md

@@ -1,131 +0,0 @@
-# opencode database guide
-
-## Database
-
-- **Schema**: Drizzle schema lives in `packages/core/src/**/*.sql.ts`.
-- **Migrations**: database migrations live in `packages/core` and are applied by core.
-
-## Development server
-
-- Running `Run `bun dev` from `packages/opencode` to start the live interactive TUI. Do not run it as a blocking foreground command when you need to inspect the result.. Do not run it as a blocking foreground command when you need to inspect the result.
-- Start it in `tmux` instead: `tmux new-session -d -s ac-dev 'bun dev'`.
-- Capture the current TUI output with: `tmux capture-pane -pt ac-dev`.
-- Stop the session explicitly when done: `tmux kill-session -t ac-dev`.
-
-# Module shape
-
-Do not use `export namespace Foo { ... }` for module organization. It is not
-standard ESM, it prevents tree-shaking, and it breaks Node's native TypeScript
-runner. Use flat top-level exports combined with a self-reexport at the bottom
-of the file:
-
-```ts
-// src/foo/foo.ts
-export interface Interface { ... }
-export class Service extends Context.Service<Service, Interface>()("@opencode/Foo") {}
-export const layer = Layer.effect(Service, ...)
-export const defaultLayer = layer.pipe(...)
-
-export * as Foo from "./foo"
-```
-
-Consumers import the namespace projection:
-
-```ts
-import { Foo } from "@/foo/foo"
-
-yield * Foo.Service
-Foo.layer
-Foo.defaultLayer
-```
-
-Namespace-private helpers stay as non-exported top-level declarations in the
-same file — they remain inaccessible to consumers (they are not projected by
-`export * as`) but are usable by the file's own code.
-
-## When the file is an `index.ts`
-
-If the module is `foo/index.ts` (single-namespace directory), use `"."` for
-the self-reexport source rather than `"./index"`:
-
-```ts
-// src/foo/index.ts
-export const thing = ...
-
-export * as Foo from "."
-```
-
-## Multi-sibling directories
-
-For directories with several independent modules (e.g. `src/session/`,
-`src/config/`), keep each sibling as its own file with its own self-reexport,
-and do not add a barrel `index.ts`. Consumers import the specific sibling:
-
-```ts
-import { SessionRetry } from "@/session/retry"
-import { SessionStatus } from "@/session/status"
-```
-
-Barrels in multi-sibling directories force every import through the barrel to
-evaluate every sibling, which defeats tree-shaking and slows module load.
-
-# opencode Effect rules
-
-Use these rules when writing or migrating Effect code.
-
-See `specs/effect/migration.md` for the compact pattern reference and examples.
-
-## Core
-
-- Use `Effect.gen(function* () { ... })` for composition.
-- Use `Effect.fn("Domain.method")` for named/traced effects and `Effect.fnUntraced` for internal helpers.
-- `Effect.fn` / `Effect.fnUntraced` accept pipeable operators as extra arguments, so avoid unnecessary outer `.pipe()` wrappers.
-- Use `Effect.callback` for callback-based APIs.
-- Use `Effect.void` instead of `Effect.succeed(undefined)` or `Effect.succeed(void 0)`.
-- Prefer `DateTime.nowAsDate` over `new Date(yield* Clock.currentTimeMillis)` when you need a `Date`.
-
-## Module conventions
-
-- In `src/config`, follow the existing self-export pattern at the top of the file (for example `export * as ConfigAgent from "./agent"`) when adding a new config module.
-
-## Schemas and errors
-
-- Use `Schema.Class` for multi-field data.
-- Use branded schemas (`Schema.brand`) for single-value types.
-- Use `Schema.TaggedErrorClass` for typed errors.
-- Use `Schema.Defect` instead of `unknown` for defect-like causes.
-- In `Effect.gen` / `Effect.fn`, prefer `yield* new MyError(...)` over `yield* Effect.fail(new MyError(...))` for direct early-failure branches.
-
-## Runtime vs InstanceState
-
-- Use `makeRuntime` (from `src/effect/run-service.ts`) for all services. It returns `{ runPromise, runFork, runCallback }` backed by a shared `memoMap` that deduplicates layers.
-- Use `InstanceState` (from `src/effect/instance-state.ts`) for per-directory or per-project state that needs per-instance cleanup. It uses `ScopedCache` keyed by directory — each open project gets its own state, automatically cleaned up on disposal.
-- If two open directories should not share one copy of the service, it needs `InstanceState`.
-- Do the work directly in the `InstanceState.make` closure — `ScopedCache` handles run-once semantics. Don't add fibers, `ensure()` callbacks, or `started` flags on top.
-- Use `Effect.addFinalizer` or `Effect.acquireRelease` inside the `InstanceState.make` closure for cleanup (subscriptions, process teardown, etc.).
-- Use `Effect.forkScoped` inside the closure for background stream consumers — the fiber is interrupted when the instance is disposed.
-- To make a service's `init()` non-blocking, fork `InstanceState.get(state)` at the `init()` call site (e.g. `Effect.forkIn(scope)`), not by forking work inside the `InstanceState.make` closure. Forking inside the closure leaves state incomplete for other methods that read it.
-- `src/project/bootstrap.ts` already wraps every service `init()` in `Effect.forkDetach`, so `init()` is fire-and-forget in production. Keep `init()` methods synchronous internally; the caller controls concurrency.
-
-## Effect v4 beta API
-
-- `Effect.fork` and `Effect.forkDaemon` do not exist. Use `Effect.forkIn(scope)` to fork a fiber into a specific scope.
-
-## Preferred Effect services
-
-- In effectified services, prefer yielding existing Effect services over dropping down to ad hoc platform APIs.
-- Prefer `FileSystem.FileSystem` instead of raw `fs/promises` for effectful file I/O.
-- Prefer `ChildProcessSpawner.ChildProcessSpawner` with `ChildProcess.make(...)` instead of custom process wrappers.
-- Prefer `HttpClient.HttpClient` instead of raw `fetch`.
-- Prefer `Path.Path`, `Config`, `Clock`, and `DateTime` when those concerns are already inside Effect code.
-- For background loops or scheduled tasks, use `Effect.repeat` or `Effect.schedule` with `Effect.forkScoped` in the layer definition.
-
-## Effect.cached for deduplication
-
-Use `Effect.cached` when multiple concurrent callers should share a single in-flight computation rather than storing `Fiber | undefined` or `Promise | undefined` manually. See `specs/effect/migration.md` for the full pattern.
-
-## Callback boundaries
-
-Use `EffectBridge` for native or external callbacks (`@parcel/watcher`, `node-pty`, native `fs.watch`, plugin callbacks, etc.) that need to re-enter Effect services with instance/workspace context.
-
-Plain async code should pass explicit context or stay inside an Effect fiber; do not add ambient instance context shims.

package/Dockerfile

@@ -1,18 +0,0 @@
-FROM alpine AS base
-
-# Disable the runtime transpiler cache by default inside Docker containers.
-# On ephemeral containers, the cache is not useful
-ARG BUN_RUNTIME_TRANSPILER_CACHE_PATH=0
-ENV BUN_RUNTIME_TRANSPILER_CACHE_PATH=${BUN_RUNTIME_TRANSPILER_CACHE_PATH}
-RUN apk add libgcc libstdc++ ripgrep
-
-FROM base AS build-amd64
-COPY dist/ac-linux-x64-baseline-musl/bin/ac /usr/local/bin/ac
-
-FROM base AS build-arm64
-COPY dist/ac-linux-arm64-musl/bin/ac /usr/local/bin/ac
-
-ARG TARGETARCH
-FROM build-${TARGETARCH}
-RUN ac --version
-ENTRYPOINT ["ac"]

package/bunfig.toml

@@ -1,7 +0,0 @@
-preload = ["@opentui/solid/preload"]
-
-[test]
-preload = ["@opentui/solid/preload", "./test/preload.ts"]
-# timeout is not actually parsed from bunfig.toml (see src/bunfig.zig in oven-sh/bun)
-# using --timeout in package.json scripts instead
-# https://github.com/oven-sh/bun/issues/7789

package/migration/20260511173437_session-metadata/migration.sql

@@ -1 +0,0 @@
-ALTER TABLE `session` ADD `metadata` text;