@giselles-ai/agent-kit 0.1.21 → 0.1.23

package/dist/cli.js

@@ -4,9 +4,35 @@
 // src/cli.ts
 import process from "process";
 
+// src/build-agent.ts
+import { register } from "module";
+import path from "path";
+import { pathToFileURL } from "url";
+async function buildAgent(options) {
+  register("tsx/esm", import.meta.url);
+  const resolved = path.resolve(options.agentPath);
+  const mod = await import(pathToFileURL(resolved).href);
+  const agent = mod.agent ?? mod.default;
+  if (!agent) {
+    throw new Error(
+      `No agent config found in ${options.agentPath}. Export a named "agent" or default export.`
+    );
+  }
+  const { requestBuild } = await import("@giselles-ai/agent");
+  const result = await requestBuild(agent, {
+    baseUrl: options.baseUrl,
+    token: options.token
+  });
+  if (result.cached) {
+    console.log(`[agent-kit] Build cached: snapshot_id=${result.snapshot_id}`);
+  } else {
+    console.log(`[agent-kit] Build success: snapshot_id=${result.snapshot_id}`);
+  }
+}
+
 // src/build-snapshot.ts
 import { readdir, readFile, stat } from "fs/promises";
-import path from "path";
+import path2 from "path";
 import { Sandbox } from "@vercel/sandbox";
 
 // src/sandbox-utils.ts
@@ -46,7 +72,7 @@ var SKIP_DIR_NAMES = /* @__PURE__ */ new Set([
   ".jj"
 ]);
 function toPosixPath(inputPath) {
-  return inputPath.split(path.sep).join("/");
+  return inputPath.split(path2.sep).join("/");
 }
 async function collectFiles(targetPath, acc) {
   const targetStat = await stat(targetPath);
@@ -59,7 +85,7 @@ async function collectFiles(targetPath, acc) {
   }
   const entries = await readdir(targetPath, { withFileTypes: true });
   for (const entry of entries) {
-    const absolutePath = path.join(targetPath, entry.name);
+    const absolutePath = path2.join(targetPath, entry.name);
     if (entry.isDirectory()) {
       if (SKIP_DIR_NAMES.has(entry.name)) {
         continue;
@@ -78,7 +104,7 @@ async function collectFiles(targetPath, acc) {
 async function buildUploadFileList(repoRoot, includePaths) {
   const files = [];
   for (const relativePath of includePaths) {
-    const absolutePath = path.join(repoRoot, relativePath);
+    const absolutePath = path2.join(repoRoot, relativePath);
     await collectFiles(absolutePath, files);
   }
   files.sort();
@@ -129,10 +155,10 @@ async function setupBrowserToolFromLocal(sandbox, sandboxRoot, repoRoot, include
   console.log(`[snapshot] files to upload: ${uploadFiles.length}`);
   const filesForSandbox = await Promise.all(
     uploadFiles.map(async (absolutePath) => {
-      const relativePath = path.relative(repoRoot, absolutePath);
+      const relativePath = path2.relative(repoRoot, absolutePath);
       const content = await readFile(absolutePath);
       return {
-        path: toPosixPath(path.join(sandboxRoot, relativePath)),
+        path: toPosixPath(path2.join(sandboxRoot, relativePath)),
         content
       };
     })
@@ -325,9 +351,19 @@ async function buildSnapshot(options = {}) {
 // src/cli.ts
 function printUsage() {
   const usage = `Usage:
+  agent-kit build --agent <path> [options]
   agent-kit build-snapshot [options]
 
-Options:
+Commands:
+  build             Build an agent snapshot via the API
+  build-snapshot    Build a base sandbox snapshot locally
+
+Build options:
+  --agent <path>           Path to the agent config file (required)
+  --base-url <url>         Agent API base URL (env: GISELLE_AGENT_BASE_URL)
+  --token <token>          API token (env: GISELLE_AGENT_API_KEY)
+
+Build-snapshot options:
   --local                  Copy local files instead of npm install (monorepo only)
   --repo-root <path>       Monorepo root directory (required with --local)
   --base-snapshot-id <id>  Reuse an existing base snapshot
@@ -335,6 +371,8 @@ Options:
   --runtime <runtime>      Sandbox runtime (default: node24)
   --timeout-ms <ms>        Sandbox timeout in ms (default: 2700000)
   --browser-tool-version <version>  Version of @giselles-ai/browser-tool to install
+
+General:
   --help, -h               Show this help message
 `;
   process.stderr.write(usage);
@@ -369,16 +407,19 @@ function parseArgs(argv) {
   }
   return { command, options };
 }
-async function main() {
-  const { command, options } = parseArgs(process.argv);
-  if (options.help) {
-    printUsage();
-    process.exit(0);
-  }
-  if (command !== "build-snapshot") {
-    printUsage();
-    process.exit(command ? 1 : 1);
+async function runBuild(options) {
+  const agentPath = options.agent;
+  if (!agentPath) {
+    console.error("Error: --agent <path> is required for the build command.");
+    process.exit(1);
   }
+  await buildAgent({
+    agentPath,
+    baseUrl: options["base-url"] ?? void 0,
+    token: options.token ?? void 0
+  });
+}
+async function runBuildSnapshot(options) {
   const isLocal = options.local === true;
   const repoRoot = options["repo-root"] ?? process.env.BROWSER_TOOL_REPO_ROOT?.trim();
   if (isLocal && !repoRoot) {
@@ -391,18 +432,29 @@ async function main() {
     console.error(`Error: Invalid timeout-ms: ${timeoutMsRaw}`);
     process.exit(1);
   }
-  try {
-    await buildSnapshot({
-      local: isLocal,
-      repoRoot,
-      baseSnapshotId: options["base-snapshot-id"] ?? process.env.BASE_SNAPSHOT_ID?.trim(),
-      sandboxRoot: options["sandbox-root"] ?? process.env.BROWSER_TOOL_SANDBOX_ROOT?.trim(),
-      runtime: options.runtime ?? process.env.BROWSER_TOOL_SNAPSHOT_RUNTIME?.trim(),
-      timeoutMs,
-      browserToolVersion: options["browser-tool-version"]
-    });
-  } catch {
-    process.exitCode = 1;
+  await buildSnapshot({
+    local: isLocal,
+    repoRoot,
+    baseSnapshotId: options["base-snapshot-id"] ?? process.env.BASE_SNAPSHOT_ID?.trim(),
+    sandboxRoot: options["sandbox-root"] ?? process.env.BROWSER_TOOL_SANDBOX_ROOT?.trim(),
+    runtime: options.runtime ?? process.env.BROWSER_TOOL_SNAPSHOT_RUNTIME?.trim(),
+    timeoutMs,
+    browserToolVersion: options["browser-tool-version"]
+  });
+}
+async function main() {
+  const { command, options } = parseArgs(process.argv);
+  if (options.help) {
+    printUsage();
+    process.exit(0);
+  }
+  if (command === "build") {
+    await runBuild(options);
+  } else if (command === "build-snapshot") {
+    await runBuildSnapshot(options);
+  } else {
+    printUsage();
+    process.exit(1);
   }
 }
 main().catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@giselles-ai/agent-kit",
-	"version": "0.1.21",
+	"version": "0.1.23",
 	"private": false,
 	"type": "module",
 	"bin": {
@@ -36,12 +36,13 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@vercel/sandbox": "1.8.0"
+		"@giselles-ai/agent": "0.1.23",
+		"@vercel/sandbox": "1.8.0",
+		"tsx": "4.21.0"
 	},
 	"devDependencies": {
 		"@types/node": "25.3.0",
 		"tsup": "8.5.1",
-		"tsx": "4.21.0",
 		"typescript": "5.9.3"
 	}
 }