glove-foundry 0.3.3 → 0.4.0

package/dist/{chunk-3GCUECPA.js → chunk-GKZLWD5M.js}

@@ -9,7 +9,7 @@ async function readResponse(response) {
 function routePath(route) {
   return route.split("/").map(encodeURIComponent).join("/");
 }
-var FoundryRunHandle = class {
+var FoundryRunHandle = class _FoundryRunHandle {
   id;
   initial;
   client;
@@ -24,6 +24,14 @@ var FoundryRunHandle = class {
   cancel() {
     return this.client.cancelRun(this.id);
   }
+  async steer(message) {
+    const result = await this.client.steerRun(this.id, message);
+    return {
+      fromRunId: result.fromRunId,
+      interrupted: result.interrupted,
+      run: new _FoundryRunHandle(result.run.id, result.run, this.client)
+    };
+  }
   events() {
     return this.client.getEvents({ runId: this.id });
   }
@@ -62,7 +70,16 @@ var FoundryClient = class {
       /\/$/,
       ""
     );
-    this.fetcher = options.fetch ?? globalThis.fetch;
+    const fetcher = options.fetch ?? globalThis.fetch;
+    this.fetcher = options.authorization ? async (input, init = {}) => {
+      const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+      const method = init.method ?? (input instanceof Request ? input.method : "GET");
+      const headers = new Headers(input instanceof Request ? input.headers : void 0);
+      new Headers(init.headers).forEach((value, key) => headers.set(key, value));
+      const authorized = new Headers(await options.authorization.headers({ url, method }));
+      authorized.forEach((value, key) => headers.set(key, value));
+      return fetcher(input, { ...init, headers });
+    } : fetcher;
   }
   async health() {
     return readResponse(await this.fetcher(`${this.baseUrl}/health`));
@@ -119,6 +136,24 @@ var FoundryClient = class {
   async conversations(agentId) {
     return readResponse(await this.fetcher(`${this.baseUrl}/api/conversations?agent=${encodeURIComponent(agentId)}`));
   }
+  async updateConversation(agentId, conversationId, options) {
+    return readResponse(await this.fetcher(
+      `${this.baseUrl}/api/conversations/${encodeURIComponent(conversationId)}`,
+      {
+        method: "PATCH",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ agentId, ...options })
+      }
+    ));
+  }
+  async conversationTranscript(agentId, conversationId, options = {}) {
+    const query = new URLSearchParams({ agent: agentId });
+    if (options.offset !== void 0) query.set("offset", String(options.offset));
+    if (options.limit !== void 0) query.set("limit", String(options.limit));
+    return readResponse(await this.fetcher(
+      `${this.baseUrl}/api/conversations/${encodeURIComponent(conversationId)}/messages?${query}`
+    ));
+  }
   async workspaceEntries(workspaceId) {
     return readResponse(await this.fetcher(`${this.baseUrl}/api/workspaces/${encodeURIComponent(workspaceId)}/entries`));
   }
@@ -252,6 +287,18 @@ var FoundryClient = class {
     const payload = await readResponse(response);
     return payload.cancelled;
   }
+  async steerRun(runId, message) {
+    return readResponse(
+      await this.fetcher(
+        `${this.baseUrl}/api/runs/${encodeURIComponent(runId)}/steer`,
+        {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({ message })
+        }
+      )
+    );
+  }
   async getEvents(filter) {
     const query = new URLSearchParams();
     if (filter?.runId) query.set("runId", filter.runId);
@@ -265,6 +312,23 @@ var FoundryClient = class {
     );
     return readResponse(response);
   }
+  async approvals(filter = {}) {
+    const query = new URLSearchParams();
+    if (filter.runId) query.set("runId", filter.runId);
+    if (filter.status) query.set("status", filter.status);
+    const suffix = query.size ? `?${query}` : "";
+    return readResponse(await this.fetcher(`${this.baseUrl}/api/approvals${suffix}`));
+  }
+  async resolveApproval(approvalId, decision) {
+    return readResponse(await this.fetcher(
+      `${this.baseUrl}/api/approvals/${encodeURIComponent(approvalId)}`,
+      {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ decision })
+      }
+    ));
+  }
   async manifest() {
     return readResponse(
       await this.fetcher(`${this.baseUrl}/api/manifest`)

package/dist/cli.js

@@ -3,20 +3,20 @@ import {
   FoundryRuntime,
   FoundryServer,
   writeGeneratedTypes
-} from "./chunk-P65RT7H5.js";
+} from "./chunk-25BGNRJN.js";
 import {
   DEFAULT_FOUNDRY_CONFIG
 } from "./chunk-ZFNMFE3T.js";
 import {
   EMPTY_FOUNDRY_APPLICATION,
   isFoundryApplication
-} from "./chunk-CRWY7M66.js";
+} from "./chunk-5LDW2N2E.js";
 
 // src/cli.ts
 import { watch } from "node:fs";
 import { access as access2 } from "node:fs/promises";
-import { spawn } from "node:child_process";
-import { relative as relative2, resolve as resolve3, sep as sep2 } from "node:path";
+import { spawn as spawn2 } from "node:child_process";
+import { relative as relative2, resolve as resolve4, sep as sep2 } from "node:path";
 import { fileURLToPath as fileURLToPath3, pathToFileURL } from "node:url";
 import process2 from "node:process";
 
@@ -73,16 +73,16 @@ var TEMPLATE_DEPENDENCIES = [
 ];
 var FALLBACK_RANGES = Object.freeze({
   effect: "^3.22.1",
-  "glove-core": "^3.6.0",
-  "glove-js": "^0.4.0",
-  "glove-lisp": "^0.4.0",
-  "glove-mcp": "^1.1.0",
-  "glove-memory": "^1.1.0",
-  "glove-python": "^0.3.0",
-  "glove-working-environment": "^0.6.0",
+  "glove-core": "^4.0.0",
+  "glove-js": "^0.4.3",
+  "glove-lisp": "^0.4.3",
+  "glove-mcp": "^1.1.3",
+  "glove-memory": "^2.0.0",
+  "glove-python": "^0.3.3",
+  "glove-working-environment": "^0.6.1",
   zod: "^4.3.6"
 });
-var FALLBACK_FOUNDRY_RANGE = "^0.1.0";
+var FALLBACK_FOUNDRY_RANGE = "^0.3.3";
 function toRange(value) {
   if (typeof value !== "string" || value.length === 0) return null;
   if (value.startsWith("workspace:") || value.startsWith("link:") || value.startsWith("file:")) {
@@ -105,7 +105,19 @@ async function resolveTemplateVersions() {
   const dependencies = { ...FALLBACK_RANGES };
   const fellBack = [];
   for (const name of TEMPLATE_DEPENDENCIES) {
-    const range = toRange(declared[name]);
+    let range = toRange(declared[name]);
+    if (!range && typeof declared[name] === "string" && declared[name].startsWith("workspace:")) {
+      try {
+        const dependency = JSON.parse(await readFile2(resolve(
+          dirname(fileURLToPath(import.meta.url)),
+          "../node_modules",
+          name,
+          "package.json"
+        ), "utf8"));
+        range = toRange(dependency.version);
+      } catch {
+      }
+    }
     if (range) dependencies[name] = range;
     else fellBack.push(name);
   }
@@ -196,6 +208,7 @@ async function detectPackageManager(rootDir) {
   if (await exists(resolve2(rootDir, "pnpm-lock.yaml"))) return "pnpm";
   if (await exists(resolve2(rootDir, "yarn.lock"))) return "yarn";
   if (await exists(resolve2(rootDir, "bun.lockb"))) return "bun";
+  if (await exists(resolve2(rootDir, "bun.lock"))) return "bun";
   if (await exists(resolve2(rootDir, "package-lock.json"))) return "npm";
   const agent = process.env.npm_config_user_agent ?? "";
   if (agent.startsWith("yarn")) return "yarn";
@@ -520,6 +533,85 @@ function displayPath(rootDir) {
   return relative(process.cwd(), rootDir) || ".";
 }
 
+// src/init.ts
+import { spawn } from "node:child_process";
+import { resolve as resolve3 } from "node:path";
+var InitCancelled = class extends Error {
+};
+async function promptInit(options) {
+  const ui = await import("@clack/prompts");
+  ui.intro("Glove Foundry \xB7 Build an agent application");
+  const answer = (value) => {
+    if (ui.isCancel(value)) {
+      ui.cancel("Setup cancelled. No project files were created.");
+      throw new InitCancelled();
+    }
+    return value;
+  };
+  const directory = options.directory ?? answer(await ui.text({
+    message: "Where should the project live?",
+    placeholder: "my-agent-app",
+    defaultValue: "my-agent-app",
+    validate: (value) => !value?.trim() ? "Enter a directory, or . for this directory." : void 0
+  }));
+  const detected = await detectScaffoldTarget(resolve3(directory));
+  const target = options.target ?? answer(await ui.select({
+    message: "How will you use Foundry?",
+    initialValue: detected,
+    options: [
+      { value: "standalone", label: "Standalone agent application", hint: "runtime + inspector; connect any frontend" },
+      { value: "nextjs", label: "Add to a Next.js app", hint: "colocated agents; preserve existing app files" }
+    ]
+  }));
+  const template = options.template ?? answer(await ui.select({
+    message: "Choose your starting point",
+    initialValue: "travel-concierge",
+    options: [
+      { value: "travel-concierge", label: "Guided example", hint: "recommended \xB7 keyless demo, tools, apps, memory, schedules, VFS + REPL" },
+      { value: "minimal", label: "Minimal agent", hint: "one agent and one tool; bring an OpenRouter key" }
+    ]
+  }));
+  const packageManager = options.packageManager ?? answer(await ui.select({
+    message: "Which package manager do you use?",
+    initialValue: await detectPackageManager(resolve3(directory)),
+    options: ["pnpm", "npm", "yarn", "bun"].map((value) => ({
+      value,
+      label: value
+    }))
+  }));
+  const install = options.install ?? answer(await ui.confirm({
+    message: "Install dependencies after creating the project?",
+    initialValue: true
+  }));
+  ui.note([
+    `Directory: ${resolve3(directory)}`,
+    `Project: ${target === "nextjs" ? "Existing Next.js app" : "Standalone"}`,
+    `Starter: ${template === "minimal" ? "Minimal agent" : "Guided travel concierge"}`,
+    `Packages: ${packageManager}${install ? " \xB7 install now" : " \xB7 install later"}`,
+    "Templates use disposable demo storage. The README explains production persistence.",
+    "No API keys are requested or stored by this wizard."
+  ].join("\n"), "Review your project");
+  if (!answer(await ui.confirm({ message: "Create this project?", initialValue: true }))) {
+    ui.cancel("Setup cancelled. No project files were created.");
+    throw new InitCancelled();
+  }
+  return { directory: directory.trim(), target, template, packageManager, install };
+}
+async function installProject(directory, manager) {
+  await new Promise((done, reject) => {
+    const command = process.platform === "win32" ? "cmd.exe" : manager;
+    const args = process.platform === "win32" ? ["/d", "/s", "/c", `${manager} install`] : ["install"];
+    const child = spawn(command, args, { cwd: directory, stdio: "inherit", shell: false });
+    child.once("error", reject);
+    child.once("exit", (code) => code === 0 ? done() : reject(new Error(`Dependency installation exited with code ${code ?? "signal"}.`)));
+  });
+}
+function useInteractiveInit(flags, terminal) {
+  if (flags.interactive && (flags.yes || flags["no-interactive"])) throw new Error("--interactive cannot be combined with --yes or --no-interactive.");
+  if (flags.interactive && !terminal) throw new Error("Interactive setup needs a terminal. Use --yes with explicit options in scripts.");
+  return terminal && !flags.yes && !flags["no-interactive"];
+}
+
 // src/cli.ts
 var HELP = `Glove Foundry \u2014 a file-routed runtime for agents
 
@@ -541,6 +633,10 @@ Create options:
                                     Next.js app gets the nextjs target, which adds
                                     agents under foundry/ and leaves the app alone.
   --package-manager <name>        pnpm, npm, yarn, or bun (detected by lockfile)
+  --yes                          Use defaults without interactive prompts
+  --no-interactive               Same non-interactive behavior, suitable for CI
+  --interactive                  Require an interactive terminal
+  --install / --no-install       Install dependencies now / leave installation to you
 
 Run options:
   --root <directory>              Project root (default: current directory)
@@ -557,13 +653,17 @@ function parseArgs(raw) {
   const args = [...raw];
   const gloveSyntax = args[0] === "foundry";
   if (gloveSyntax) args.shift();
-  const command = args[0];
+  const command = args[0]?.startsWith("--") ? void 0 : args[0];
   const positional = [];
   const flags = {};
-  for (let index = 1; index < args.length; index++) {
+  for (let index = command ? 1 : 0; index < args.length; index++) {
     const value = args[index];
     if (value.startsWith("--")) {
       const name = value.slice(2);
+      if (["yes", "no-interactive", "interactive", "install", "no-install", "help", "no-watch"].includes(name)) {
+        flags[name] = true;
+        continue;
+      }
       const next = args[index + 1];
       if (next && !next.startsWith("--")) {
         flags[name] = next;
@@ -588,7 +688,7 @@ async function pathExists(path) {
 async function loadConfig(rootDir) {
   const candidates = ["foundry.config.ts", "foundry.config.mts", "foundry.config.js", "foundry.config.mjs"];
   for (const candidate of candidates) {
-    const path = resolve3(rootDir, candidate);
+    const path = resolve4(rootDir, candidate);
     if (!await pathExists(path)) continue;
     const url = pathToFileURL(path);
     url.searchParams.set("t", String(Date.now()));
@@ -602,7 +702,7 @@ async function loadConfig(rootDir) {
 }
 async function loadApplication(rootDir, config) {
   const relativePath = config.applicationFile ?? DEFAULT_FOUNDRY_CONFIG.applicationFile;
-  const path = resolve3(rootDir, relativePath);
+  const path = resolve4(rootDir, relativePath);
   if (!await pathExists(path)) return EMPTY_FOUNDRY_APPLICATION;
   const url = pathToFileURL(path);
   url.searchParams.set("t", String(Date.now()));
@@ -613,18 +713,18 @@ async function loadApplication(rootDir, config) {
   return imported.default;
 }
 async function runWorker(parsed) {
-  const rootDir = resolve3(
+  const rootDir = resolve4(
     typeof parsed.flags.root === "string" ? parsed.flags.root : process2.cwd()
   );
-  await loadEnvFile(resolve3(rootDir, ".env"));
-  await loadEnvFile(resolve3(rootDir, ".env.local"));
+  await loadEnvFile(resolve4(rootDir, ".env"));
+  await loadEnvFile(resolve4(rootDir, ".env.local"));
   const config = await loadConfig(rootDir);
   const application = await loadApplication(rootDir, config);
-  const applicationFilePath = resolve3(
+  const applicationFilePath = resolve4(
     rootDir,
     config.applicationFile ?? DEFAULT_FOUNDRY_CONFIG.applicationFile
   );
-  const agentsDir = resolve3(
+  const agentsDir = resolve4(
     rootDir,
     config.agentsDir ?? DEFAULT_FOUNDRY_CONFIG.agentsDir
   );
@@ -643,7 +743,9 @@ async function runWorker(parsed) {
   await runtime.start();
   const server = new FoundryServer(runtime, {
     host: typeof parsed.flags.host === "string" ? parsed.flags.host : config.server?.host ?? DEFAULT_FOUNDRY_CONFIG.server.host,
-    port: typeof parsed.flags.port === "string" ? Number(parsed.flags.port) : config.server?.port ?? DEFAULT_FOUNDRY_CONFIG.server.port
+    port: typeof parsed.flags.port === "string" ? Number(parsed.flags.port) : config.server?.port ?? DEFAULT_FOUNDRY_CONFIG.server.port,
+    branding: config.branding,
+    messageBodyBytes: config.server?.messageBodyBytes
   });
   const listening = await server.listen();
   await runtime.health();
@@ -672,11 +774,11 @@ async function runWorker(parsed) {
 }
 function shouldRestart(rootDir, changed, agentsDir) {
   if (!changed) return false;
-  const normalized = relative2(rootDir, resolve3(rootDir, changed)).split(sep2).join("/");
+  const normalized = relative2(rootDir, resolve4(rootDir, changed)).split(sep2).join("/");
   return normalized.startsWith(`${agentsDir}/`) || normalized === ".env" || normalized === ".env.local" || /^(?:[\w.-]+\/)*foundry\.application\.(?:ts|mts|js|mjs)$/.test(normalized) || /^foundry\.config\.(?:ts|mts|js|mjs)$/.test(normalized);
 }
 async function superviseDev(parsed) {
-  const rootDir = resolve3(
+  const rootDir = resolve4(
     typeof parsed.flags.root === "string" ? parsed.flags.root : process2.cwd()
   );
   const agentsDir = (await loadConfig(rootDir)).agentsDir ?? DEFAULT_FOUNDRY_CONFIG.agentsDir;
@@ -698,7 +800,7 @@ async function superviseDev(parsed) {
     ...typeof parsed.flags.host === "string" ? ["--host", parsed.flags.host] : []
   ];
   const start = () => {
-    child = spawn(process2.execPath, workerArgs, {
+    child = spawn2(process2.execPath, workerArgs, {
       cwd: rootDir,
       env: process2.env,
       stdio: "inherit"
@@ -742,7 +844,7 @@ async function superviseDev(parsed) {
           (_event, filename) => onChange(filename?.toString() ?? null)
         )
       );
-      const watchedAgentsDir = resolve3(rootDir, agentsDir);
+      const watchedAgentsDir = resolve4(rootDir, agentsDir);
       if (await pathExists(watchedAgentsDir)) {
         watchers.push(
           watch(
@@ -761,7 +863,7 @@ async function superviseDev(parsed) {
         "memory",
         "inboxes"
       ]) {
-        const watched = resolve3(rootDir, directory);
+        const watched = resolve4(rootDir, directory);
         if (await pathExists(watched)) {
           watchers.push(
             watch(
@@ -791,10 +893,10 @@ async function superviseDev(parsed) {
   process2.once("SIGTERM", stop);
 }
 async function superviseStart(parsed) {
-  const rootDir = resolve3(
+  const rootDir = resolve4(
     typeof parsed.flags.root === "string" ? parsed.flags.root : process2.cwd()
   );
-  const child = spawn(
+  const child = spawn2(
     process2.execPath,
     [
       "--import",
@@ -842,6 +944,10 @@ function flagValue(parsed, name, allowed) {
   return raw;
 }
 async function create(directory, parsed) {
+  const supported = /* @__PURE__ */ new Set(["template", "target", "package-manager", "yes", "no-interactive", "interactive", "install", "no-install"]);
+  for (const flag of Object.keys(parsed.flags)) if (!supported.has(flag)) throw new UsageError(`Unknown create option --${flag}.`);
+  if (parsed.positional.length > 1) throw new UsageError("Provide only one project directory.");
+  if (parsed.flags.install && parsed.flags["no-install"]) throw new UsageError("Choose either --install or --no-install.");
   const template = flagValue(parsed, "template", FOUNDRY_TEMPLATES);
   const target = flagValue(parsed, "target", ["standalone", "nextjs"]);
   const packageManager = flagValue(
@@ -849,12 +955,45 @@ async function create(directory, parsed) {
     "package-manager",
     ["pnpm", "npm", "yarn", "bun"]
   );
-  const result = await scaffoldFoundryProject({
-    directory,
+  let interactive;
+  try {
+    interactive = useInteractiveInit(parsed.flags, Boolean(process2.stdin.isTTY && process2.stdout.isTTY));
+  } catch (error) {
+    throw new UsageError(error instanceof Error ? error.message : String(error));
+  }
+  const selected = {
+    ...directory ? { directory } : {},
     ...template ? { template } : {},
     ...target ? { target } : {},
-    ...packageManager ? { packageManager } : {}
-  });
+    ...packageManager ? { packageManager } : {},
+    ...parsed.flags.install ? { install: true } : parsed.flags["no-install"] ? { install: false } : {}
+  };
+  const options = interactive ? await promptInit(selected) : { ...selected, directory: directory ?? "glove-foundry-app", install: selected.install ?? false };
+  const ui = interactive ? await import("@clack/prompts") : void 0;
+  const progress = ui?.spinner();
+  progress?.start("Creating your agent application");
+  let result;
+  try {
+    result = await scaffoldFoundryProject(options);
+  } catch (error) {
+    progress?.stop("Project was not created");
+    throw error;
+  }
+  progress?.stop("Project files are ready");
+  let installed = false;
+  if (options.install) {
+    ui?.log.step(`Installing dependencies with ${result.packageManager}`);
+    try {
+      await installProject(result.rootDir, result.packageManager);
+      installed = true;
+    } catch (error) {
+      process2.exitCode = 1;
+      const message = `Project files are safe. Installation failed: ${error instanceof Error ? error.message : String(error)} Run ${result.packageManager} install in the project to retry.`;
+      if (ui) ui.log.warn(message);
+      else process2.stderr.write(`${message}
+`);
+    }
+  }
   const where = displayPath(result.rootDir);
   const pm = result.packageManager;
   const run = (script) => pm === "npm" ? `npm run ${script}` : `${pm} ${script}`;
@@ -870,7 +1009,7 @@ async function create(directory, parsed) {
     lines.push("");
     lines.push("  Next:");
     if (where !== ".") lines.push(`    cd ${where}`);
-    lines.push(`    ${install}`);
+    if (!installed) lines.push(`    ${install}`);
     lines.push(`    ${run("foundry:dev")}      # runtime + inspector on :4141`);
     lines.push(`    ${run("dev")}              # your Next.js app`);
   } else {
@@ -883,7 +1022,7 @@ async function create(directory, parsed) {
     lines.push("  Next:");
     if (where !== ".") lines.push(`    cd ${where}`);
     lines.push("    cp .env.example .env.local");
-    lines.push(`    ${install}`);
+    if (!installed) lines.push(`    ${install}`);
     lines.push(`    ${run("dev")}`);
     lines.push("");
     lines.push("  Then open http://127.0.0.1:4141 and press Start a run.");
@@ -898,7 +1037,10 @@ async function create(directory, parsed) {
     lines.push(`    ${result.versions.fellBack.join(", ")}`);
   }
   lines.push("");
-  process2.stdout.write(lines.join("\n"));
+  if (ui) {
+    ui.note(lines.join("\n").trim(), "Next steps");
+    ui.outro(process2.exitCode ? "Project created. Retry dependency installation before starting." : "Your agent application is ready to explore. Open the README to begin.");
+  } else process2.stdout.write(lines.join("\n"));
 }
 async function main() {
   const parsed = parseArgs(process2.argv.slice(2));
@@ -906,13 +1048,13 @@ async function main() {
     await runWorker(parsed);
     return;
   }
-  if (["help", "--help", "-h"].includes(parsed.command ?? "")) {
+  if (parsed.flags.help || ["help", "--help", "-h"].includes(parsed.command ?? "")) {
     process2.stdout.write(HELP);
     return;
   }
   const createByGloveSyntax = parsed.gloveSyntax && parsed.command !== "dev" && parsed.command !== "start";
-  if (parsed.command === "init" || createByGloveSyntax || parsed.gloveSyntax && !parsed.command) {
-    const directory = parsed.command === "init" ? parsed.positional[0] ?? "glove-foundry-app" : parsed.command ?? "glove-foundry-app";
+  if (parsed.command === "init" || createByGloveSyntax || !parsed.command && (process2.stdin.isTTY || parsed.flags.yes)) {
+    const directory = parsed.command === "init" ? parsed.positional[0] : parsed.command ?? parsed.positional[0];
     await create(directory, parsed);
     return;
   }
@@ -927,6 +1069,10 @@ async function main() {
   process2.stdout.write(HELP);
 }
 main().catch((error) => {
+  if (error instanceof InitCancelled) {
+    process2.exitCode = 130;
+    return;
+  }
   if (error instanceof UsageError) {
     process2.stderr.write(`
   ${error.message}