napbox 0.0.0-stage → 0.1.1

package/dist/protocol.js

@@ -0,0 +1,210 @@
+// napboxd 本地 socket 协议的 TypeScript 这一份，对应 native/Sources/NapboxProtocol/Protocol.swift。
+// 类型都由 schema 推出来，发回的内容也按同一份 schema 核对，类型和实际校验不会各写各的；
+// 这份和 Swift 对不对得上由 test/contract.test.ts 逐字段比较。字段含义看 Protocol.swift，这里不重复。
+import { z } from "zod";
+const isoDate = z.iso.datetime();
+const base64 = z.base64();
+/** 错误码，napboxd 原样给什么这里就是什么 */
+export const errorCodes = [
+    "daemon_unavailable",
+    "bad_request",
+    "unknown_method",
+    "protocol_error",
+    "usage_error",
+    "internal_error",
+    "compose_not_found",
+    "compose_invalid",
+    "compose_unsupported",
+    "not_in_repository",
+    "port_unavailable",
+    "state_corrupted",
+    "environment_not_found",
+    "runtime_unavailable",
+    "image_unavailable",
+    "image_build_failed",
+    "service_failed",
+    "service_not_found",
+    "volume_not_found",
+    "healthcheck_timeout",
+    "address_unavailable",
+    "name_taken",
+    "owner_mismatch",
+];
+export const methods = {
+    status: "status",
+    up: "up",
+    down: "down",
+    sleep: "sleep",
+    egress: "egress",
+    environment: "environment",
+    logs: "logs",
+    exec: "exec",
+    subscribe: "subscribe",
+    run: "run",
+    reset: "reset",
+    imageImport: "image.import",
+    create: "create",
+    wake: "wake",
+    runs: "runs",
+};
+// code 不收窄成 errorCodes：新版 napboxd 加的错误码也要原样带给调用方
+export const NapboxErrorBody = z.object({ code: z.string(), message: z.string() });
+export const EnvironmentState = z.enum(["running", "sleeping"]);
+export const EgressMode = z.enum(["open", "none"]);
+export const ServiceExitRestart = z.enum(["none", "restarting", "gave_up"]);
+export const RunPurpose = z.enum(["up", "wake", "reset", "restart"]);
+export const Readiness = z.enum(["healthcheck", "port", "process"]);
+export const OutputStream = z.enum(["stdout", "stderr"]);
+export const EventKind = z.enum([
+    "started",
+    "start_failed",
+    "slept",
+    "service_exited",
+    "destroyed",
+]);
+export const SleepReason = z.enum(["idle", "request", "host_address", "shutdown", "vm_lost"]);
+export const PortInfo = z.object({
+    service: z.string(),
+    containerPort: z.int(),
+    hostPort: z.int(),
+    variable: z.string(),
+});
+export const ServiceExit = z.object({
+    service: z.string(),
+    exitCode: z.int(),
+    at: isoDate,
+    restart: ServiceExitRestart,
+});
+export const EnvironmentInfo = z.object({
+    name: z.string(),
+    owner: z.string().optional(),
+    state: EnvironmentState,
+    worktree: z.string(),
+    ports: z.array(PortInfo),
+    egress: EgressMode,
+    variables: z.record(z.string(), z.string()),
+    unsetVariables: z.array(z.string()),
+    lastError: z.string().optional(),
+    watchError: z.string().optional(),
+    serviceExits: z.array(ServiceExit),
+});
+export const StatusResult = z.object({
+    version: z.string(),
+    pid: z.int(),
+    startedAt: isoDate,
+    environments: z.array(EnvironmentInfo),
+});
+/** 操作哪个环境：worktree 持有的写 `{ cwd }`（它的临时环境再带上 `temp`），调用方持有的写 `{ name, owner }` */
+export const EnvironmentTarget = z.union([
+    z.object({ cwd: z.string(), temp: z.string().optional() }),
+    z.object({ name: z.string(), owner: z.string() }),
+]);
+export const UpParams = z.object({
+    cwd: z.string(),
+    files: z.array(z.string()),
+    profiles: z.array(z.string()),
+    environment: z.record(z.string(), z.string()),
+    build: z.boolean(),
+    temp: z.string().optional(),
+});
+export const RunParams = z.object({
+    cwd: z.string(),
+    files: z.array(z.string()),
+    profiles: z.array(z.string()),
+    environment: z.record(z.string(), z.string()),
+    build: z.boolean(),
+    egress: EgressMode.optional(),
+    service: z.string(),
+    command: z.array(z.string()),
+    noDeps: z.boolean(),
+});
+export const EnvironmentParams = z.object({ target: EnvironmentTarget });
+export const CreateParams = z.object({
+    name: z.string(),
+    owner: z.string(),
+    directory: z.string(),
+    files: z.array(z.string()),
+    profiles: z.array(z.string()),
+    environment: z.record(z.string(), z.string()),
+    egress: EgressMode.optional(),
+});
+export const ResetParams = z.object({ target: EnvironmentTarget, volume: z.string() });
+export const EgressParams = z.object({ target: EnvironmentTarget, mode: EgressMode });
+export const DownResult = z.object({
+    name: z.string(),
+    releasedPorts: z.array(z.int()),
+    keptDataAt: z.string().optional(),
+});
+export const ImageImportParams = z.object({ reference: z.string() });
+export const ImageImportResult = z.object({ reference: z.string(), digest: z.string() });
+export const StreamOutput = z.object({ stream: OutputStream, data: base64 });
+export const StdinMessage = z.object({ data: base64.optional(), end: z.boolean().optional() });
+export const LogsParams = z.object({
+    target: EnvironmentTarget,
+    service: z.string(),
+    tail: z.int().optional(),
+    follow: z.boolean(),
+});
+export const LogsResult = z.object({ ended: z.string().optional() });
+export const ExecParams = z.object({
+    target: EnvironmentTarget,
+    service: z.string(),
+    command: z.array(z.string()),
+});
+export const ExecResult = z.object({ exitCode: z.int() });
+export const ServiceRun = z.object({
+    service: z.string(),
+    image: z.string(),
+    digest: z.string(),
+    platformDigest: z.string(),
+    skipped: z.boolean(),
+    startedAt: isoDate.optional(),
+    readyAt: isoDate.optional(),
+    readiness: Readiness.optional(),
+});
+export const RunRecord = z.object({
+    id: z.string(),
+    environment: z.string(),
+    purpose: RunPurpose,
+    startedAt: isoDate,
+    finishedAt: isoDate,
+    error: NapboxErrorBody.optional(),
+    definitionDigest: z.string(),
+    egress: EgressMode,
+    ports: z.array(PortInfo),
+    services: z.array(ServiceRun),
+});
+export const RunsResult = z.object({ runs: z.array(RunRecord) });
+export const SubscribeParams = z.object({
+    owner: z.string().optional(),
+    names: z.array(z.string()).optional(),
+});
+export const EnvironmentEvent = z.object({
+    at: isoDate,
+    environment: z.string(),
+    owner: z.string().optional(),
+    type: EventKind,
+    purpose: RunPurpose.optional(),
+    runId: z.string().optional(),
+    error: NapboxErrorBody.optional(),
+    sleepReason: SleepReason.optional(),
+    reason: z.string().optional(),
+    service: z.string().optional(),
+    exitCode: z.int().optional(),
+    restart: ServiceExitRestart.optional(),
+});
+/** subscribe 正常结束时的结果（调用方先断开写端才会有，这个客户端不这样断开） */
+export const EmptyResult = z.object({});
+export const Request = z.object({
+    id: z.int(),
+    method: z.string(),
+    params: z.unknown().optional(),
+});
+export const Response = z.object({
+    id: z.int(),
+    result: z.unknown().optional(),
+    error: NapboxErrorBody.optional(),
+    output: StreamOutput.optional(),
+    subscribed: z.boolean().optional(),
+    event: EnvironmentEvent.optional(),
+});

package/dist/server-launcher.mjs

@@ -0,0 +1,79 @@
+// 由 scripts/plugins.ts 从 scripts/server-launcher.mjs 生成。
+// 启动固定版本的 napbox MCP 服务，就在这个进程里。这个版本只在第一次安装一次，装进 napbox 的缓存目录，
+// 之后不需要 npm 和网络。npm 在缓存目录里运行，项目自己的 npm 设置和依赖不会影响安装结果。
+import { spawn } from "node:child_process";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+
+const VERSION = "0.1.1";
+
+// 和 src/agent/locations.ts 的 cacheDirectory 同一个目录
+const versions = path.join(homedir(), "Library/Caches/napbox/versions");
+const home = path.join(versions, VERSION);
+const installed = path.join(home, "node_modules/napbox");
+const manifest = path.join(installed, "package.json");
+
+// 运行这个脚本的 Node 自带的 npm，没有就用 PATH 上的
+const npm = () => {
+  const directory = path.dirname(process.execPath);
+  for (const cli of [
+    path.join(directory, "node_modules/npm/bin/npm-cli.js"),
+    path.join(directory, "../lib/node_modules/npm/bin/npm-cli.js"),
+  ])
+    if (existsSync(cli)) return [process.execPath, [cli]];
+  return ["npm", []];
+};
+
+// 装进单独的目录，完整了才改名到位：不会从装了一半的地方启动，两个同时启动也只留先改名的那个
+async function install() {
+  mkdirSync(versions, { recursive: true, mode: 0o700 });
+  const staging = mkdtempSync(path.join(versions, `.${VERSION}-`));
+  process.stderr.write(`napbox：用 npm 安装 napbox@${VERSION}\n`);
+  const [command, prefix] = npm();
+  const args = [
+    ...prefix,
+    "install",
+    `napbox@${VERSION}`,
+    "--prefix",
+    staging,
+    "--prefer-online",
+    "--omit=dev",
+    "--no-audit",
+    "--no-fund",
+    "--no-update-notifier",
+    "--loglevel=error",
+  ];
+  await new Promise((resolve, reject) => {
+    const child = spawn(command, args, { cwd: staging, stdio: ["ignore", "pipe", "pipe"] });
+    let output = "";
+    child.stdout.on("data", (data) => (output += data));
+    child.stderr.on("data", (data) => (output += data));
+    child.on("error", reject);
+    child.on("close", (code) =>
+      code === 0 ? resolve() : reject(new Error(`npm 退出码 ${code}\n${output.trim()}`)),
+    );
+  }).catch((error) => {
+    rmSync(staging, { recursive: true, force: true });
+    throw error;
+  });
+  try {
+    renameSync(staging, home);
+  } catch (error) {
+    rmSync(staging, { recursive: true, force: true });
+    if (!existsSync(manifest)) throw error;
+  }
+}
+
+try {
+  if (!existsSync(manifest)) await install();
+  // 一周没启动过的版本会从缓存里删掉（src/agent/cache.ts）
+  writeFileSync(path.join(home, "last-used"), "");
+  const entry = path.join(installed, JSON.parse(readFileSync(manifest, "utf8")).bin.napbox);
+  process.argv = [process.argv[0], entry, "mcp"];
+  await import(pathToFileURL(entry).href);
+} catch (error) {
+  process.stderr.write(`napbox：启动不了 ${VERSION}：${error?.message ?? error}\n`);
+  process.exit(1);
+}

package/native/napboxd

@@ -0,0 +1,4 @@
+[diffend] Oversized file quarantined before diffing.
+name: package/native/napboxd
+size: 48788320 bytes
+sha256: 082a181fd142838ec8e0f60b475ccf5eeb569d56fb3ce09f55b90944f980e1ad

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "napbox",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Local dev environments for coding agents on Apple silicon Macs, without Docker: an isolated set of compose services for every git worktree.",
+  "type": "module",
+  "bin": {
+    "napbox": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "native",
+    "NOTICE",
+    "THIRD_PARTY_NOTICES.txt",
+    "README.zh-CN.md"
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22.22"
+  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "dependencies": {
+    "zod": "4.4.3"
+  },
+  "homepage": "https://github.com/coffeecoproject/napbox",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/coffeecoproject/napbox.git"
+  },
+  "keywords": [
+    "docker-compose",
+    "worktree",
+    "dev-environment",
+    "mcp",
+    "claude-code",
+    "macos"
+  ]
+}