@openagentpack/cli 0.2.0-beta.0 → 0.3.0

package/dist/bin/agents.js

@@ -3,7 +3,7 @@ import {
   configureLogger,
   log,
   program
-} from "../chunk-W5APGQN3.js";
+} from "../chunk-YXWT5OMX.js";
 
 // bin/agents.ts
 import { UserError } from "@openagentpack/sdk";

package/dist/{chunk-W5APGQN3.js → chunk-YXWT5OMX.js}

@@ -360,6 +360,8 @@ import {
   getDeploymentDetailsForContext,
   getDeploymentRuntimeProviderForContext,
   listDeploymentsForContext,
+  listRemoteDeploymentsForContext,
+  pauseDeploymentForContext,
   runDeploymentForContext,
   UserError as UserError3
 } from "@openagentpack/sdk";
@@ -388,9 +390,56 @@ function printTableFooter() {
   console.log();
 }
 
+// src/utils/pagination.ts
+async function fetchAllPages(fetchPage, all) {
+  const first = await fetchPage();
+  const items = [...first.items];
+  let hasMore = first.hasMore;
+  let nextPage = first.nextPage;
+  while (all && nextPage) {
+    const next = await fetchPage(nextPage);
+    items.push(...next.items);
+    hasMore = next.hasMore;
+    nextPage = next.nextPage;
+  }
+  return { items, hasMore, nextPage };
+}
+
 // src/commands/deployment.ts
 async function deploymentListCommand(options) {
   const ctx = await buildCliRuntime(options.file);
+  if (options.remote) {
+    if (!options.provider) throw new UserError3("Remote deployment listing requires --provider.");
+    if (options.provider === "claude" && options.status && options.includeArchived) {
+      throw new UserError3("Claude remote deployment listing cannot combine --status with --include-archived.");
+    }
+    const { items, hasMore } = await fetchAllPages(async (page) => {
+      const result = await listRemoteDeploymentsForContext(ctx, options.provider, {
+        status: options.status,
+        include_archived: options.includeArchived,
+        agent_id: options.agentId,
+        limit: options.limit,
+        page
+      });
+      return { items: result.deployments, hasMore: result.has_more, nextPage: result.next_page };
+    }, options.all);
+    if (items.length === 0) {
+      log.info("No remote deployments found.");
+      return;
+    }
+    printTableTitle("Remote Deployments", items.length);
+    printTableHeader(["Name".padEnd(24), "ID".padEnd(28), "Status".padEnd(10), "Schedule"], 82);
+    for (const item of items) {
+      const raw = item.attributes ?? {};
+      const name = String(raw.name ?? "").slice(0, 22).padEnd(24);
+      const id = String(item.id ?? "").slice(0, 26).padEnd(28);
+      const schedule = item.schedule?.expression ?? "manual";
+      printTableRow([chalk5.bold(name), id, item.status.padEnd(10), schedule]);
+    }
+    printTableFooter();
+    if (hasMore) log.info("More deployments available. Use --all to fetch all.");
+    return;
+  }
   const rows = listDeploymentsForContext(ctx, options.provider);
   if (rows.length === 0) {
     log.info("No deployments in state. Run `agents apply` first.");
@@ -411,6 +460,12 @@ async function deploymentListCommand(options) {
   }
   printTableFooter();
 }
+async function deploymentPauseCommand(name, options, paused = true) {
+  const ctx = await buildCliRuntime(options.file);
+  const info = await pauseDeploymentForContext(ctx, name, paused, options.provider);
+  log.success(`Deployment '${name}' ${paused ? "paused" : "unpaused"}.`);
+  console.log(`  Status: ${info.status}`);
+}
 async function deploymentGetCommand(name, options) {
   const ctx = await buildCliRuntime(options.file);
   const { bindings, provider, info } = await getDeploymentDetailsForContext(ctx, name, void 0, options.provider);
@@ -670,9 +725,9 @@ async function initCommand() {
   p4.log.success(`Created ${configPath}`, { output: process.stderr });
   const gitignorePath = ".gitignore";
   if (await fileExists(gitignorePath)) {
-    const content = await readFile(gitignorePath, "utf8");
-    if (!content.includes("agents.state.json")) {
-      await writeFile(gitignorePath, content + GITIGNORE_ADDITIONS, "utf8");
+    const content2 = await readFile(gitignorePath, "utf8");
+    if (!content2.includes("agents.state.json")) {
+      await writeFile(gitignorePath, content2 + GITIGNORE_ADDITIONS, "utf8");
       p4.log.success("Updated .gitignore", { output: process.stderr });
     }
   } else {
@@ -685,15 +740,244 @@ async function initCommand() {
   });
 }
 
+// src/commands/memory.ts
+import { readFile as readFile2 } from "fs/promises";
+import {
+  archiveMemoryStore,
+  batchCreateMemories,
+  createMemory,
+  createMemoryStore,
+  deleteMemory,
+  deleteMemoryStore,
+  getMemory,
+  getMemoryStore,
+  getMemoryVersion,
+  listMemories,
+  listMemoryStores,
+  listMemoryVersions,
+  redactMemoryVersion,
+  UserError as UserError5,
+  updateMemory,
+  updateMemoryStore
+} from "@openagentpack/sdk";
+
+// src/runtime.ts
+import { listProviderNames, UserError as UserError4 } from "@openagentpack/sdk";
+import { Command, InvalidArgumentError, Option } from "commander";
+var DEFAULT_CONFIG_FILE = "agents.yaml";
+function isExplicitSource(source) {
+  return source !== void 0 && source !== "default";
+}
+function rootCommand(command) {
+  let current = command;
+  while (current.parent) current = current.parent;
+  return current;
+}
+function configFileArgs(args = process.argv.slice(2)) {
+  const values = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (!arg) continue;
+    if (arg === "--") break;
+    if (arg === "-f" || arg === "--file") {
+      const value = args[i + 1];
+      if (value) {
+        values.push(value);
+        i += 1;
+        continue;
+      }
+    }
+    if (arg.startsWith("--file=")) {
+      values.push(arg.slice("--file=".length));
+      continue;
+    }
+    if (arg.startsWith("-f") && arg.length > 2) {
+      values.push(arg.slice(2));
+    }
+  }
+  return values;
+}
+function configFileOption() {
+  return new Option("-f, --file <path>", "Config file path");
+}
+function resolveConfigFile(command) {
+  const explicitFiles = [...new Set(configFileArgs())];
+  if (explicitFiles.length > 1) {
+    throw new UserError4(
+      `Conflicting config files supplied: ${explicitFiles.join(" and ")}. Use only one --file value.`
+    );
+  }
+  const root = rootCommand(command);
+  const rootFile = root.getOptionValue("file");
+  const rootSource = root.getOptionValueSource("file");
+  const localFile = command.getOptionValue("file");
+  const localSource = command.getOptionValueSource("file");
+  if (isExplicitSource(rootSource) && isExplicitSource(localSource) && rootFile && localFile && rootFile !== localFile) {
+    throw new UserError4(`Conflicting config files supplied: ${rootFile} and ${localFile}. Use only one --file value.`);
+  }
+  if (isExplicitSource(localSource) && localFile) return localFile;
+  if (rootFile) return rootFile;
+  return DEFAULT_CONFIG_FILE;
+}
+function withResolvedConfigFile(handler) {
+  return async (...args) => {
+    const command = args[args.length - 1];
+    if (!(command instanceof Command)) {
+      await handler(...args);
+      return;
+    }
+    const handlerArgs = args.slice(0, -1);
+    const options = handlerArgs[handlerArgs.length - 1];
+    if (options && typeof options === "object") {
+      options.file = resolveConfigFile(command);
+    }
+    await handler(...handlerArgs);
+  };
+}
+function registeredProviderNames() {
+  return listProviderNames();
+}
+function providerOption(description, opts = {}) {
+  const choices = opts.allowAll ? ["all", ...registeredProviderNames()] : registeredProviderNames();
+  const option = new Option("--provider <name>", description).choices(choices);
+  if (opts.defaultValue !== void 0) option.default(opts.defaultValue);
+  return option;
+}
+function parsePositiveInteger(value) {
+  if (!/^\d+$/.test(value)) {
+    throw new InvalidArgumentError("must be a positive integer");
+  }
+  const parsed = Number(value);
+  if (!Number.isSafeInteger(parsed) || parsed <= 0) {
+    throw new InvalidArgumentError("must be a positive integer");
+  }
+  return parsed;
+}
+function parseBooleanOption(value) {
+  if (value === "true") return true;
+  if (value === "false") return false;
+  throw new InvalidArgumentError("must be true or false");
+}
+function writeJson(value) {
+  process.stdout.write(`${JSON.stringify(value, null, 2)}
+`);
+}
+function writeJsonLine(value) {
+  process.stdout.write(`${JSON.stringify(value)}
+`);
+}
+
+// src/commands/memory.ts
+async function runtime(options) {
+  const ctx = await buildCliRuntime(options.file);
+  const provider = options.provider ?? (ctx.providers.size === 1 ? ctx.providers.keys().next().value : void 0);
+  if (!provider) throw new UserError5("Select a provider with --provider when multiple providers are configured.");
+  return { ctx, provider };
+}
+async function content(options) {
+  if (options.content !== void 0 && options.contentFile)
+    throw new UserError5("Use either --content or --content-file, not both.");
+  if (options.contentFile) return readFile2(options.contentFile, "utf8");
+  if (options.content !== void 0) return options.content;
+  throw new UserError5("Memory content is required; use --content or --content-file.");
+}
+async function memoryStoreListCommand(options) {
+  const { ctx, provider } = await runtime(options);
+  writeJson(await listMemoryStores(ctx.providers, provider, options));
+}
+async function memoryStoreCreateCommand(name, options) {
+  const { ctx, provider } = await runtime(options);
+  writeJson(await createMemoryStore(ctx.providers, provider, { name, description: options.description }));
+}
+async function memoryStoreDeleteCommand(id, options) {
+  const { ctx, provider } = await runtime(options);
+  await deleteMemoryStore(ctx.providers, provider, id);
+  writeJson({ id, type: "memory_store_deleted" });
+}
+async function memoryStoreGetCommand(id, options) {
+  const { ctx, provider } = await runtime(options);
+  writeJson(await getMemoryStore(ctx.providers, provider, id));
+}
+async function memoryStoreUpdateCommand(id, options) {
+  const { ctx, provider } = await runtime(options);
+  writeJson(
+    await updateMemoryStore(ctx.providers, provider, id, { name: options.name, description: options.description })
+  );
+}
+async function memoryStoreArchiveCommand(id, options) {
+  const { ctx, provider } = await runtime(options);
+  writeJson(await archiveMemoryStore(ctx.providers, provider, id));
+}
+async function memoryCreateCommand(storeId, path, options) {
+  const { ctx, provider } = await runtime(options);
+  writeJson(await createMemory(ctx.providers, provider, storeId, { path, content: await content(options) }));
+}
+async function memoryBatchCreateCommand(storeId, inputFile, options) {
+  const { ctx, provider } = await runtime(options);
+  const parsed = JSON.parse(await readFile2(inputFile, "utf8"));
+  if (!Array.isArray(parsed)) throw new UserError5("Batch input must be a JSON array of {path, content} objects.");
+  const items = parsed.map((item) => {
+    if (!item || typeof item !== "object" || typeof item.path !== "string" || typeof item.content !== "string") {
+      throw new UserError5("Every batch item must contain string path and content fields.");
+    }
+    return item;
+  });
+  writeJson(await batchCreateMemories(ctx.providers, provider, storeId, { items, on_conflict: options.onConflict }));
+}
+async function memoryListCommand(storeId, options) {
+  const { ctx, provider } = await runtime(options);
+  writeJson(
+    await listMemories(ctx.providers, provider, storeId, { ...options, view: options.full ? "full" : "basic" })
+  );
+}
+async function memoryGetCommand(storeId, memoryId, options) {
+  const { ctx, provider } = await runtime(options);
+  writeJson(await getMemory(ctx.providers, provider, storeId, memoryId));
+}
+async function memoryUpdateCommand(storeId, memoryId, options) {
+  const { ctx, provider } = await runtime(options);
+  const nextContent = options.content !== void 0 || options.contentFile ? await content(options) : void 0;
+  writeJson(
+    await updateMemory(ctx.providers, provider, storeId, memoryId, {
+      path: options.path,
+      content: nextContent,
+      expected_content_sha256: options.expectedSha256
+    })
+  );
+}
+async function memoryDeleteCommand(storeId, memoryId, options) {
+  const { ctx, provider } = await runtime(options);
+  await deleteMemory(ctx.providers, provider, storeId, memoryId, options.expectedSha256);
+  writeJson({ id: memoryId, type: "memory_deleted" });
+}
+async function memoryVersionListCommand(storeId, options) {
+  const { ctx, provider } = await runtime(options);
+  writeJson(
+    await listMemoryVersions(ctx.providers, provider, storeId, {
+      ...options,
+      memory_id: options.memoryId,
+      view: options.full ? "full" : "basic"
+    })
+  );
+}
+async function memoryVersionGetCommand(storeId, versionId, options) {
+  const { ctx, provider } = await runtime(options);
+  writeJson(await getMemoryVersion(ctx.providers, provider, storeId, versionId));
+}
+async function memoryVersionRedactCommand(storeId, versionId, options) {
+  const { ctx, provider } = await runtime(options);
+  writeJson(await redactMemoryVersion(ctx.providers, provider, storeId, versionId));
+}
+
 // src/commands/migrate.ts
 import { writeFile as writeFile2 } from "fs/promises";
-import { migrateConfig, UserError as UserError4 } from "@openagentpack/sdk";
+import { migrateConfig, UserError as UserError6 } from "@openagentpack/sdk";
 async function migrateCommand(options) {
   const fromPath = options.from ?? "agents.synced.yaml";
   const toPath = options.to ?? "agents.yaml";
   const toExists = await fileExists(toPath);
   if (!toExists) {
-    throw new UserError4(
+    throw new UserError6(
       `Target file '${toPath}' not found. Create a agents.yaml first (e.g. \`agents init\`), then run migrate.`
     );
   }
@@ -806,116 +1090,8 @@ function formatPrice(factor) {
 }
 
 // src/commands/plan.ts
-import { UserError as UserError6 } from "@openagentpack/sdk";
+import { UserError as UserError7 } from "@openagentpack/sdk";
 import chalk8 from "chalk";
-
-// src/runtime.ts
-import { listProviderNames, UserError as UserError5 } from "@openagentpack/sdk";
-import { Command, InvalidArgumentError, Option } from "commander";
-var DEFAULT_CONFIG_FILE = "agents.yaml";
-function isExplicitSource(source) {
-  return source !== void 0 && source !== "default";
-}
-function rootCommand(command) {
-  let current = command;
-  while (current.parent) current = current.parent;
-  return current;
-}
-function configFileArgs(args = process.argv.slice(2)) {
-  const values = [];
-  for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i];
-    if (!arg) continue;
-    if (arg === "--") break;
-    if (arg === "-f" || arg === "--file") {
-      const value = args[i + 1];
-      if (value) {
-        values.push(value);
-        i += 1;
-        continue;
-      }
-    }
-    if (arg.startsWith("--file=")) {
-      values.push(arg.slice("--file=".length));
-      continue;
-    }
-    if (arg.startsWith("-f") && arg.length > 2) {
-      values.push(arg.slice(2));
-    }
-  }
-  return values;
-}
-function configFileOption() {
-  return new Option("-f, --file <path>", "Config file path");
-}
-function resolveConfigFile(command) {
-  const explicitFiles = [...new Set(configFileArgs())];
-  if (explicitFiles.length > 1) {
-    throw new UserError5(
-      `Conflicting config files supplied: ${explicitFiles.join(" and ")}. Use only one --file value.`
-    );
-  }
-  const root = rootCommand(command);
-  const rootFile = root.getOptionValue("file");
-  const rootSource = root.getOptionValueSource("file");
-  const localFile = command.getOptionValue("file");
-  const localSource = command.getOptionValueSource("file");
-  if (isExplicitSource(rootSource) && isExplicitSource(localSource) && rootFile && localFile && rootFile !== localFile) {
-    throw new UserError5(`Conflicting config files supplied: ${rootFile} and ${localFile}. Use only one --file value.`);
-  }
-  if (isExplicitSource(localSource) && localFile) return localFile;
-  if (rootFile) return rootFile;
-  return DEFAULT_CONFIG_FILE;
-}
-function withResolvedConfigFile(handler) {
-  return async (...args) => {
-    const command = args[args.length - 1];
-    if (!(command instanceof Command)) {
-      await handler(...args);
-      return;
-    }
-    const handlerArgs = args.slice(0, -1);
-    const options = handlerArgs[handlerArgs.length - 1];
-    if (options && typeof options === "object") {
-      options.file = resolveConfigFile(command);
-    }
-    await handler(...handlerArgs);
-  };
-}
-function registeredProviderNames() {
-  return listProviderNames();
-}
-function providerOption(description, opts = {}) {
-  const choices = opts.allowAll ? ["all", ...registeredProviderNames()] : registeredProviderNames();
-  const option = new Option("--provider <name>", description).choices(choices);
-  if (opts.defaultValue !== void 0) option.default(opts.defaultValue);
-  return option;
-}
-function parsePositiveInteger(value) {
-  if (!/^\d+$/.test(value)) {
-    throw new InvalidArgumentError("must be a positive integer");
-  }
-  const parsed = Number(value);
-  if (!Number.isSafeInteger(parsed) || parsed <= 0) {
-    throw new InvalidArgumentError("must be a positive integer");
-  }
-  return parsed;
-}
-function parseBooleanOption(value) {
-  if (value === "true") return true;
-  if (value === "false") return false;
-  throw new InvalidArgumentError("must be true or false");
-}
-function writeJson(value) {
-  process.stdout.write(`${JSON.stringify(value, null, 2)}
-`);
-}
-function writeJsonLine(value) {
-  process.stdout.write(`${JSON.stringify(value)}
-`);
-}
-
-// src/commands/plan.ts
 async function planCommand(options) {
   const ctx = await buildCliRuntime(options.file);
   assertProviderConfigured(ctx, options.provider);
@@ -927,13 +1103,13 @@ async function planCommand(options) {
   if (options.json) {
     writeJson(plan);
     if (plan.diagnostics.some((d) => d.severity === "error")) {
-      throw new UserError6("Plan contains errors.");
+      throw new UserError7("Plan contains errors.");
     }
     return;
   }
   renderDiagnostics(plan.diagnostics);
   if (diagnosticsHaveErrors(plan.diagnostics)) {
-    throw new UserError6("Plan contains errors.");
+    throw new UserError7("Plan contains errors.");
   }
   const creates = plan.actions.filter((a) => a.action === "create");
   const updates = plan.actions.filter((a) => a.action === "update");
@@ -1137,27 +1313,10 @@ import {
   sendSessionMessageStreaming,
   startSessionRun,
   startSessionRunPolling,
-  UserError as UserError7
+  UserError as UserError8
 } from "@openagentpack/sdk";
 import { sanitizeSessionEvent, sanitizeSessionEvents } from "@openagentpack/sdk/session-events";
 import chalk9 from "chalk";
-
-// src/utils/pagination.ts
-async function fetchAllPages(fetchPage, all) {
-  const first = await fetchPage();
-  const items = [...first.items];
-  let hasMore = first.hasMore;
-  let nextPage = first.nextPage;
-  while (all && nextPage) {
-    const next = await fetchPage(nextPage);
-    items.push(...next.items);
-    hasMore = next.hasMore;
-    nextPage = next.nextPage;
-  }
-  return { items, hasMore, nextPage };
-}
-
-// src/commands/session.ts
 function formatTimestamp(iso) {
   const d = new Date(iso);
   if (Number.isNaN(d.getTime())) return iso;
@@ -1179,7 +1338,7 @@ async function sessionCreateCommand(agentNameOrOptions, maybeOptions) {
   const options = maybeOptions ?? agentNameOrOptions;
   const positionalAgent = typeof agentNameOrOptions === "string" ? agentNameOrOptions : void 0;
   if (positionalAgent && options.agent && positionalAgent !== options.agent) {
-    throw new UserError7("Specify agent either positionally or with --agent, not both.");
+    throw new UserError8("Specify agent either positionally or with --agent, not both.");
   }
   const ctx = await buildCliRuntime(options.file);
   const run = await createSessionForAgent(ctx, {
@@ -1327,13 +1486,16 @@ function renderCollectedEvents(result, json) {
     renderTerminalStatus(result.terminalStatus, json);
   }
 }
+function shouldStreamSession(options) {
+  return options.stream === true && options.noStream !== true;
+}
 async function sessionRunCommand(promptOrAgent, promptOrOptions, maybeOptions) {
   const hasPositionalAgent = typeof promptOrOptions === "string";
   const positionalAgent = hasPositionalAgent ? promptOrAgent : void 0;
   const prompt = hasPositionalAgent ? promptOrOptions : promptOrAgent;
   const options = hasPositionalAgent ? maybeOptions : promptOrOptions ?? maybeOptions;
   if (positionalAgent && options.agent && positionalAgent !== options.agent) {
-    throw new UserError7("Specify agent either positionally or with --agent, not both.");
+    throw new UserError8("Specify agent either positionally or with --agent, not both.");
   }
   const runOptions = {
     agent: positionalAgent ?? options.agent,
@@ -1348,25 +1510,26 @@ async function sessionRunCommand(promptOrAgent, promptOrOptions, maybeOptions) {
     title: options.title
   };
   const ctx = await buildCliRuntime(options.file);
-  const run = options.noStream ? await startSessionRunPolling(ctx, prompt, runOptions) : await startSessionRun(ctx, prompt, runOptions);
+  const stream = shouldStreamSession(options);
+  const run = stream ? await startSessionRun(ctx, prompt, runOptions) : await startSessionRunPolling(ctx, prompt, runOptions);
   const session = run.session;
   if (!options.json) {
     log.success(`Session created: ${chalk9.bold(session.id)}`);
   }
-  if (options.noStream) {
-    renderCollectedEvents(run, !!options.json);
-  } else {
+  if (stream) {
     await streamAndRender(run.events, !!options.json);
+  } else {
+    renderCollectedEvents(run, !!options.json);
   }
 }
 async function sessionSendCommand(sessionId, message, options) {
   const ctx = await buildCliRuntime(options.file);
-  if (options.noStream) {
-    const result = await sendSessionMessagePolling(ctx, sessionId, message, { provider: options.provider });
-    renderCollectedEvents(result, !!options.json);
-  } else {
+  if (shouldStreamSession(options)) {
     const events = await sendSessionMessageStreaming(ctx, sessionId, message, { provider: options.provider });
     await streamAndRender(events, !!options.json);
+  } else {
+    const result = await sendSessionMessagePolling(ctx, sessionId, message, { provider: options.provider });
+    renderCollectedEvents(result, !!options.json);
   }
 }
 async function sessionEventsCommand(sessionId, options) {
@@ -1418,7 +1581,7 @@ function parseMemoryStores(value) {
 }
 
 // src/commands/state.ts
-import { importResource, parseStateAddress, UserError as UserError8 } from "@openagentpack/sdk";
+import { importResource, parseStateAddress, UserError as UserError9 } from "@openagentpack/sdk";
 import chalk10 from "chalk";
 async function stateListCommand(options) {
   const ctx = await buildCliRuntime(options.file);
@@ -1442,14 +1605,14 @@ async function stateShowCommand(address, options) {
   const ctx = await buildCliRuntime(options.file);
   const parsed = parseStateAddress(address, { requireProvider: false });
   const found = ctx.state.findResource(parsed);
-  if (!found) throw new UserError8(`Resource not found: ${address}`);
+  if (!found) throw new UserError9(`Resource not found: ${address}`);
   console.log(JSON.stringify(found, null, 2));
 }
 async function stateRemoveCommand(address, options) {
   const ctx = await buildCliRuntime(options.file);
   const parsed = parseStateAddress(address, { requireProvider: false });
   const found = ctx.state.findResource(parsed);
-  if (!found) throw new UserError8(`Resource not found: ${address}`);
+  if (!found) throw new UserError9(`Resource not found: ${address}`);
   ctx.state.removeResource(found.address);
   await ctx.state.save();
   log.success(`Removed ${address} from state (remote resource not deleted).`);
@@ -1470,14 +1633,14 @@ import {
   resolveSyncProvider,
   syncProviderResourcesFromContext,
   syncProviderResourcesFromEnv,
-  UserError as UserError9
+  UserError as UserError10
 } from "@openagentpack/sdk";
 import { stringify as stringifyYaml } from "yaml";
 var DEFAULT_SYNC_OUTPUT = "agents.synced.yaml";
 function ensureSyncOutputWritable(outPath, force) {
   if (force) return;
   if (fileExistsSync(outPath)) {
-    throw new UserError9(
+    throw new UserError10(
       `Output file '${outPath}' already exists. Use --force to overwrite, or -o/--out to write elsewhere.`
     );
   }
@@ -1539,7 +1702,7 @@ async function syncFromConfig(configPath, explicitProvider) {
 }
 async function syncFromEnv(explicitProvider) {
   if (!explicitProvider) {
-    throw new UserError9(
+    throw new UserError10(
       "agents sync requires --provider when no config file exists, e.g. `agents sync --provider claude`."
     );
   }
@@ -1586,8 +1749,8 @@ async function promptSecretValues(placeholders) {
 function loadExistingEnv(path) {
   const keys = /* @__PURE__ */ new Set();
   if (!fileExistsSync(path)) return keys;
-  const content = readFileSync2(path, "utf8");
-  for (const line of content.split("\n")) {
+  const content2 = readFileSync2(path, "utf8");
+  for (const line of content2.split("\n")) {
     const trimmed = line.trim();
     if (!trimmed || trimmed.startsWith("#")) continue;
     const eqIdx = trimmed.indexOf("=");
@@ -1598,16 +1761,16 @@ function loadExistingEnv(path) {
   return keys;
 }
 function appendEnvLine(path, key, value) {
-  let content = "";
+  let content2 = "";
   if (fileExistsSync(path)) {
-    content = readFileSync2(path, "utf8");
-    if (content.length > 0 && !content.endsWith("\n")) {
-      content += "\n";
+    content2 = readFileSync2(path, "utf8");
+    if (content2.length > 0 && !content2.endsWith("\n")) {
+      content2 += "\n";
     }
   }
-  content += `${key}=${value}
+  content2 += `${key}=${value}
 `;
-  writeFileSync(path, content);
+  writeFileSync(path, content2);
 }
 async function promptCustomSkillFiles(config, baseDir) {
   const skills = config.skills ?? {};
@@ -1751,7 +1914,7 @@ async function serializeConfig(config) {
 
 // src/commands/validate.ts
 import { resolve as resolve4 } from "path";
-import { resolveProjectConfig as resolveProjectConfig2, UserError as UserError10, validateProjectConfig } from "@openagentpack/sdk";
+import { resolveProjectConfig as resolveProjectConfig2, UserError as UserError11, validateProjectConfig } from "@openagentpack/sdk";
 async function validateCommand(options) {
   ensureCredentials();
   const configPath = resolve4(options.file);
@@ -1766,7 +1929,7 @@ async function validateCommand(options) {
   }
   const errorCount = diagnostics.filter((d) => d.severity === "error").length;
   if (errorCount > 0) {
-    throw new UserError10(`Validation failed with ${errorCount} error(s).`);
+    throw new UserError11(`Validation failed with ${errorCount} error(s).`);
   }
   log.success("Configuration is valid.");
 }
@@ -1847,13 +2010,33 @@ sessionCmd.command("create [agent-name]").description("Create a new session for
 sessionCmd.command("list").description("List sessions from the provider").addOption(configFileOption()).option("--agent <name>", "Filter by agent name").option("--all", "Fetch all pages by following the cursor").addOption(providerOption("Target provider")).action(withResolvedConfigFile(sessionListCommand));
 sessionCmd.command("get <session-id>").description("Get details of a session").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile(sessionGetCommand));
 sessionCmd.command("delete <session-id>").description("Delete a session").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile(sessionDeleteCommand));
-sessionCmd.command("run <prompt-or-agent> [prompt]").description("Create a session, send a message, and stream the response").addOption(configFileOption()).option("--agent <name>", "Agent name (auto-detected when only one agent is configured)").option("--identity-id <id>", "Override the configured Qoder Forward Identity").option("--environment <name>", "Override agent's declared environment").option("--environment-id <id>", "Use an explicit remote environment id instead of the configured one").option("--tunnel <name>", "Override agent's declared tunnel").option("--tunnel-id <id>", "Use an explicit remote tunnel id instead of the configured one").option("--vault <name>", "Override agent's declared vault").option("--memory-stores <names>", "Override agent's declared memory stores (comma-separated)").option("--title <title>", "Session title").addOption(providerOption("Target provider")).option("--json", "Output events as JSONL").option("--no-stream", "Use polling instead of SSE streaming").action(withResolvedConfigFile(sessionRunCommand));
-sessionCmd.command("send <session-id> <message>").description("Send a message to an existing session and stream the response").addOption(configFileOption()).addOption(providerOption("Target provider")).option("--json", "Output events as JSONL").option("--no-stream", "Use polling instead of SSE streaming").action(withResolvedConfigFile(sessionSendCommand));
+sessionCmd.command("run <prompt-or-agent> [prompt]").description("Create a session, send a message, and wait for the response").addOption(configFileOption()).option("--agent <name>", "Agent name (auto-detected when only one agent is configured)").option("--identity-id <id>", "Override the configured Qoder Forward Identity").option("--environment <name>", "Override agent's declared environment").option("--environment-id <id>", "Use an explicit remote environment id instead of the configured one").option("--tunnel <name>", "Override agent's declared tunnel").option("--tunnel-id <id>", "Use an explicit remote tunnel id instead of the configured one").option("--vault <name>", "Override agent's declared vault").option("--memory-stores <names>", "Override agent's declared memory stores (comma-separated)").option("--title <title>", "Session title").addOption(providerOption("Target provider")).option("--json", "Output events as JSONL").addOption(new Option2("--stream", "Stream events over SSE instead of polling").conflicts("noStream")).addOption(new Option2("--no-stream", "Use polling (deprecated; polling is now the default)").hideHelp()).action(withResolvedConfigFile(sessionRunCommand));
+sessionCmd.command("send <session-id> <message>").description("Send a message to an existing session and wait for the response").addOption(configFileOption()).addOption(providerOption("Target provider")).option("--json", "Output events as JSONL").addOption(new Option2("--stream", "Stream events over SSE instead of polling").conflicts("noStream")).addOption(new Option2("--no-stream", "Use polling (deprecated; polling is now the default)").hideHelp()).action(withResolvedConfigFile(sessionSendCommand));
 sessionCmd.command("events <session-id>").description("List event history for a session").addOption(configFileOption()).addOption(providerOption("Target provider")).addOption(new Option2("--limit <count>", "Maximum number of events to fetch").argParser(parsePositiveInteger)).option("--all", "Fetch all pages by following the cursor").option("--json", "Output as JSON").action(withResolvedConfigFile(sessionEventsCommand));
 var deploymentCmd = program.command("deployment").description("Manage agent deployments (scheduled / triggered runs)");
-deploymentCmd.command("list").description("List deployments tracked in state").addOption(configFileOption()).addOption(providerOption("Filter by provider")).action(withResolvedConfigFile(deploymentListCommand));
+deploymentCmd.command("list").description("List deployments tracked in state").addOption(configFileOption()).addOption(providerOption("Filter by provider")).option("--remote", "List deployments from the provider API").addOption(new Option2("--status <status>", "Filter remote deployments by status").choices(["active", "paused"])).option("--include-archived", "Include archived remote deployments").option("--agent-id <id>", "Filter remote deployments by agent ID").option("--limit <count>", "Maximum remote deployments per page", parsePositiveInteger).option("--all", "Fetch all remote pages").action(withResolvedConfigFile(deploymentListCommand));
 deploymentCmd.command("get <name>").description("Show a deployment's status and resolved bindings").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile(deploymentGetCommand));
-deploymentCmd.command("run <name>").description("Trigger a deployment run (native on Claude, emulated as a session on Qoder)").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile(deploymentRunCommand));
+deploymentCmd.command("pause <name>").description("Pause a native deployment's scheduled runs").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile((name, options) => deploymentPauseCommand(name, options, true)));
+deploymentCmd.command("unpause <name>").description("Resume a paused native deployment").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile((name, options) => deploymentPauseCommand(name, options, false)));
+deploymentCmd.command("run <name>").description("Trigger a deployment run (native on Qoder/Claude, emulated on Bailian/Ark)").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile(deploymentRunCommand));
+var memoryStoreCmd = program.command("memory-store").description("Manage persistent memory stores");
+memoryStoreCmd.command("create <name>").addOption(configFileOption()).addOption(providerOption("Target provider")).option("--description <description>").action(withResolvedConfigFile(memoryStoreCreateCommand));
+memoryStoreCmd.command("list").addOption(configFileOption()).addOption(providerOption("Target provider")).option("--limit <n>", "Page size", parsePositiveInteger).option("--cursor <cursor>").option("--include-archived").action(withResolvedConfigFile(memoryStoreListCommand));
+memoryStoreCmd.command("get <store-id>").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile(memoryStoreGetCommand));
+memoryStoreCmd.command("update <store-id>").addOption(configFileOption()).addOption(providerOption("Target provider")).option("--name <name>").option("--description <description>").action(withResolvedConfigFile(memoryStoreUpdateCommand));
+memoryStoreCmd.command("archive <store-id>").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile(memoryStoreArchiveCommand));
+memoryStoreCmd.command("delete <store-id>").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile(memoryStoreDeleteCommand));
+var memoryCmd = program.command("memory").description("Manage memories inside a store");
+memoryCmd.command("create <store-id> <path>").addOption(configFileOption()).addOption(providerOption("Target provider")).option("--content <text>").option("--content-file <path>").action(withResolvedConfigFile(memoryCreateCommand));
+memoryCmd.command("batch-create <store-id> <json-file>").addOption(configFileOption()).addOption(providerOption("Target provider")).addOption(new Option2("--on-conflict <mode>", "Conflict handling (Ark)").choices(["overwrite", "fail"])).action(withResolvedConfigFile(memoryBatchCreateCommand));
+memoryCmd.command("list <store-id>").addOption(configFileOption()).addOption(providerOption("Target provider")).option("--limit <n>", "Page size", parsePositiveInteger).option("--cursor <cursor>").option("--prefix <path>").option("--depth <n>", "Hierarchy depth", parsePositiveInteger).option("--full", "Include content").action(withResolvedConfigFile(memoryListCommand));
+memoryCmd.command("get <store-id> <memory-id>").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile(memoryGetCommand));
+memoryCmd.command("update <store-id> <memory-id>").addOption(configFileOption()).addOption(providerOption("Target provider")).option("--path <path>").option("--content <text>").option("--content-file <path>").option("--expected-sha256 <sha256>", "Optimistic concurrency precondition").action(withResolvedConfigFile(memoryUpdateCommand));
+memoryCmd.command("delete <store-id> <memory-id>").addOption(configFileOption()).addOption(providerOption("Target provider")).option("--expected-sha256 <sha256>", "Optimistic concurrency precondition").action(withResolvedConfigFile(memoryDeleteCommand));
+var memoryVersionCmd = memoryCmd.command("version").description("Inspect immutable memory history");
+memoryVersionCmd.command("list <store-id>").addOption(configFileOption()).addOption(providerOption("Target provider")).option("--limit <n>", "Page size", parsePositiveInteger).option("--cursor <cursor>").option("--memory-id <id>").option("--full", "Include version content").action(withResolvedConfigFile(memoryVersionListCommand));
+memoryVersionCmd.command("get <store-id> <version-id>").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile(memoryVersionGetCommand));
+memoryVersionCmd.command("redact <store-id> <version-id>").addOption(configFileOption()).addOption(providerOption("Target provider")).action(withResolvedConfigFile(memoryVersionRedactCommand));
 var modelsCmd = program.command("models").description("Discover available models from providers");
 modelsCmd.command("list").description("List models available on the configured provider(s)").addOption(configFileOption()).addOption(providerOption("Target provider")).option("--json", "Output as JSON").action(withResolvedConfigFile(modelsListCommand));
 

package/dist/src/program.js

@@ -1,6 +1,6 @@
 import {
   program
-} from "../chunk-W5APGQN3.js";
+} from "../chunk-YXWT5OMX.js";
 export {
   program
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openagentpack/cli",
-  "version": "0.2.0-beta.0",
+  "version": "0.3.0",
   "description": "Open Agent Pack — Declaratively manage AI agent infrastructure",
   "license": "Apache-2.0",
   "keywords": [
@@ -49,12 +49,12 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@openagentpack/playground": "0.2.0-beta.0",
+    "@openagentpack/playground": "0.3.0",
     "@types/bun": "^1.3.14",
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@openagentpack/sdk": "0.2.0-beta.0",
+    "@openagentpack/sdk": "0.3.0",
     "@clack/prompts": "^1.5.1",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",