@agentdocumentformat/cli 0.8.0 → 0.8.1

package/dist/chunks/{chunk-WX6QCUWI.mjs → chunk-RJDOVMM4.mjs}

@@ -14,20 +14,25 @@ import {
   cjs
 } from "./chunk-SGUTYISF.mjs";
 import {
-  loop_parser_exports
-} from "./chunk-4OGZFUKA.mjs";
+  loop_parser_exports,
+  owner_command_row_exports
+} from "./chunk-7JZXMDDF.mjs";
 import {
   require_react
 } from "./chunk-6GJ4QHRI.mjs";
 import {
   file_ref_exports
 } from "./chunk-LKFHERRV.mjs";
+import {
+  agent_commands_exports
+} from "./chunk-VENQBMOA.mjs";
 import {
   __toESM
 } from "./chunk-M2RX3S2T.mjs";
 
 // src/main/tui/state/store.tsx
 var import_react = __toESM(require_react(), 1);
+import { randomUUID } from "node:crypto";
 
 // src/main/tui/api/types.ts
 var shared = cjs(types_exports), MAIN_LOOP = shared.MAIN_LOOP, DaemonError = shared.DaemonError, isCredentialsLocked = shared.isCredentialsLocked, SUPPORTED_CLIENT_API_VERSION = shared.SUPPORTED_CLIENT_API_VERSION;
@@ -192,7 +197,13 @@ function historyToItems(entries) {
         items.push({ ...base, kind: "user", text: entry.content, origin: "runtime" });
         break;
       case "context":
-        meta.category === "loop" && typeof meta.fromLoop == "string" ? items.push({ ...base, kind: "user", text: entry.content, origin: "loop", from: meta.fromLoop }) : meta.category === "runtime" ? items.push({ ...base, kind: "user", text: entry.content, origin: "runtime" }) : items.push({ ...base, kind: "context", category: String(meta.category ?? "context"), text: entry.content });
+        meta.category === "loop" && typeof meta.fromLoop == "string" ? items.push({ ...base, kind: "user", text: entry.content, origin: "loop", from: meta.fromLoop }) : meta.category === "runtime" ? items.push({ ...base, kind: "user", text: entry.content, origin: "runtime" }) : items.push({
+          ...base,
+          kind: "context",
+          category: String(meta.category ?? "context"),
+          text: entry.content,
+          ...meta.category === "owner_command" ? { ownerCommand: meta.ownerCommand } : {}
+        });
         break;
       case "compaction":
         items.push({ ...base, kind: "context", category: "compaction", text: entry.content });
@@ -243,7 +254,7 @@ function mergeHistory(existing, incoming) {
     if (item.kind !== "tool" || item.taskRef === void 0 || !item.toolUseId) return item;
     let live = finished.get(item.toolUseId);
     return live ? { ...item, status: live.status, result: live.result, completedAt: live.completedAt } : item;
-  }), historyTools = /* @__PURE__ */ new Set(), historyTexts = /* @__PURE__ */ new Map(), countText = (key) => historyTexts.set(key, (historyTexts.get(key) ?? 0) + 1);
+  }), historyTools = /* @__PURE__ */ new Set(), historyCommands = new Set(history.flatMap((item) => item.kind === "context" && item.ownerCommand ? [item.ownerCommand.id] : [])), historyTexts = /* @__PURE__ */ new Map(), countText = (key) => historyTexts.set(key, (historyTexts.get(key) ?? 0) + 1);
   for (let item of history)
     item.kind === "tool" && item.toolUseId && historyTools.add(item.toolUseId), (item.kind === "user" || item.kind === "assistant" || item.kind === "thinking") && countText(`${item.kind}:${item.text.trim()}`), item.kind === "tool" && item.name === "ask" && countText(`ask:${askQuestion(item.input).trim()}`);
   let consume = (key) => {
@@ -259,7 +270,7 @@ function mergeHistory(existing, incoming) {
       case "thinking":
         return !consume(`${item.kind}:${item.text.trim()}`);
       case "context":
-        return !1;
+        return !!item.ownerCommand && !historyCommands.has(item.ownerCommand.id);
       case "ask":
         return !consume(`ask:${item.question.trim()}`);
       default:
@@ -272,7 +283,9 @@ function prependHistory(existing, older) {
   let ids = new Set(existing.map((item) => item.id)), orphans = /* @__PURE__ */ new Map();
   for (let item of existing)
     item.kind === "tool" && !item.local && item.toolUseId && item.status !== "running" && orphans.set(item.toolUseId, item);
-  let merged = /* @__PURE__ */ new Set();
+  let merged = /* @__PURE__ */ new Set(), commands = new Set(older.flatMap((item) => item.kind === "context" && item.ownerCommand ? [item.ownerCommand.id] : []));
+  for (let item of existing)
+    item.local && item.kind === "context" && item.ownerCommand && commands.has(item.ownerCommand.id) && (merged.add(item), ids.delete(item.id));
   return [...older.filter((item) => !ids.has(item.id)).map((item) => {
     if (item.kind !== "tool" || item.status !== "running" || !item.toolUseId) return item;
     let result = orphans.get(item.toolUseId);
@@ -675,6 +688,13 @@ function tuiReducer(state, action) {
       return patchTranscript(state, action.key, (t) => ({ ...t, loading: !1, error: action.error }));
     case "transcript/append":
       return patchTranscript(state, action.key, (t) => ({ ...t, items: [...t.items, action.item] }));
+    case "transcript/owner-command":
+      return patchTranscript(state, action.key, (t) => {
+        let matches = (item) => item.kind === "context" && item.ownerCommand?.id === action.item.ownerCommand?.id, existing = t.items.find(matches);
+        return existing?.seq !== void 0 && (action.item.seq === void 0 || existing.seq === action.item.seq) ? t : { ...t, items: [...t.items.filter((item) => !matches(item)), action.item] };
+      });
+    case "transcript/remove":
+      return patchTranscript(state, action.key, (t) => ({ ...t, items: t.items.filter((item) => item.id !== action.id || item.seq !== void 0) }));
     case "transcript/update":
       return patchTranscript(state, action.key, (t) => {
         let index = t.items.findIndex((item) => item.id === action.id);
@@ -868,7 +888,7 @@ function num(value) {
 }
 
 // src/main/tui/state/client-stream.ts
-var MAIN = "main", NONE = { frames: [] };
+var { parseOwnerCommandRow } = cjs(owner_command_row_exports), TUI_CLIENT_NAME = "tui", MAIN = "main", NONE = { frames: [] };
 function clientFrameEffects(frame) {
   if (frame.kind === "umbilical") return { frames: [{ cursor: frame.cursor, event: frame.event }] };
   if (frame.kind === "push" && frame.topic === "daemon_orphan_hold") {
@@ -878,6 +898,20 @@ function clientFrameEffects(frame) {
   if (frame.kind !== "executor") return NONE;
   let { event, agentId } = frame, loop = frame.loop ?? event.loop ?? MAIN, payload = event.payload ?? {};
   switch (event.type) {
+    case "context_injected": {
+      if (payload.category !== "owner_command") return NONE;
+      let record = typeof payload.content == "string" ? parseOwnerCommandRow(payload.content) : null;
+      return !record || typeof payload.seq != "number" ? { frames: [], reload: { agentId, loop } } : { frames: [], ownerCommand: { agentId, loop, item: {
+        id: `command:${record.header.id}`,
+        at: event.timestamp,
+        local: !0,
+        seq: payload.seq,
+        kind: "context",
+        category: "owner_command",
+        ownerCommand: record.header,
+        text: record.body
+      } } };
+    }
     case "text_delta":
     case "text_delta_batch":
     case "thinking_delta":
@@ -994,7 +1028,7 @@ function serverText(server) {
 }
 
 // src/main/tui/state/store.tsx
-var import_jsx_runtime = __toESM(require_jsx_runtime(), 1), TUI_MIN_CLIENT_API_VERSION = 1, REFRESH_DEBOUNCE_MS = 120, WEB_EVENT_DEBOUNCE_MS = 900, RESUME_VERDICT_MS = 1500, WEB_POLL_MS = 2e4, TRACKED_POLL_MS = 15e3, FOLDER_OVERLAY = "fleet.track", PROMPT_PREFILL_KEY = "shell.prompt.prefill", CHAT_VIEW_ID = "chat";
+var import_jsx_runtime = __toESM(require_jsx_runtime(), 1), { parseAuthorizeToken } = cjs(agent_commands_exports), TUI_MIN_CLIENT_API_VERSION = 1, REFRESH_DEBOUNCE_MS = 120, WEB_EVENT_DEBOUNCE_MS = 900, RESUME_VERDICT_MS = 1500, WEB_POLL_MS = 2e4, TRACKED_POLL_MS = 15e3, FOLDER_OVERLAY = "fleet.track", PROMPT_PREFILL_KEY = "shell.prompt.prefill", CHAT_VIEW_ID = "chat";
 function createTuiStore(options) {
   let client = options.client, plain = options.client, current = new WeakSet([client]), pageSize = options.pageSize ?? 100, state = initialState(client.baseUrl, options.initialView), selectionRevision = 0, listeners = /* @__PURE__ */ new Set(), confirmResolvers = /* @__PURE__ */ new Map(), toastTimers = /* @__PURE__ */ new Map(), debounced = /* @__PURE__ */ new Map(), stream = null, sessionId = null, fallbackNoticed = !1, sessionRetry = !1, reopening = !1, focusSent, focusInFlight = !1, focusRetryAt = 0, lastResyncAt = 0, webTick = null, trackedTick = null, stopped = !1, needsResync = !1, resumeFallback = null, getState = () => state, dispatch = (action) => {
     let next = tuiReducer(state, action);
@@ -1282,6 +1316,45 @@ function createTuiStore(options) {
         return dispatch({ type: "transcript/update", key, id: item.id, patch: { pending: !1 } }), dispatch({ type: "transcript/append", key, item: { id: localId(), at: Date.now(), local: !0, kind: "error", text: `Not sent: ${describe(err)}` } }), !1;
       }
     },
+    async runAgentCommand(agentId, loop, name, rawArgs) {
+      let c = client;
+      if (isTrackedKey(agentId)) {
+        toast(`Agent is off. Start it, then run /${name} again.`, "warn");
+        return;
+      }
+      if (rawArgs.includes(`
+`) || rawArgs.includes("\r") || rawArgs.length > 4096) {
+        toast(`/${name}: arguments must be one line of at most 4096 characters.`, "warn");
+        return;
+      }
+      let { args, authorize } = parseAuthorizeToken(rawArgs), requestId = randomUUID(), key = transcriptKey(agentId, loop), registered = state.agents[agentId]?.config?.commands, lambda = Array.isArray(registered) ? registered.find((command) => command?.name === name)?.lambda : void 0, item = {
+        id: `command:${requestId}`,
+        at: Date.now(),
+        local: !0,
+        kind: "context",
+        category: "owner_command",
+        text: "",
+        ownerCommand: { v: 1, id: requestId, command: `/${name}${args ? ` ${args}` : ""}`, lambda: typeof lambda == "string" ? lambda : "", authorized: authorize, status: "running", duration_ms: 0 }
+      };
+      dispatch({ type: "transcript/owner-command", key, item });
+      try {
+        let result = await c.runCommand(agentId, name, { args, authorize, loop, requestId });
+        if (stale(c) || stopped) return;
+        dispatch({ type: "transcript/owner-command", key, item: {
+          ...item,
+          seq: result.seq,
+          text: result.result,
+          deferred: result.deferred,
+          unrecorded: !result.deferred && result.seq === void 0,
+          ownerCommand: { ...item.ownerCommand, authorized: result.authorized, status: result.status, duration_ms: result.durationMs }
+        } });
+        let label = `${agentLabel(agentId)} /${name} (${loop})`;
+        toast(`${label}: ${result.status === "denied" ? "permission denied; add !authorize for one authorized run" : result.status}${result.deferred ? " \u2014 recording after the current step" : ""}`, result.status === "ok" ? "success" : result.status === "denied" ? "warn" : "error");
+      } catch (err) {
+        if (stale(c) || stopped) return;
+        dispatch({ type: "transcript/remove", key, id: item.id }), err instanceof DaemonError && err.unreachable && dispatch({ type: "daemon/reachable", reachable: !1 }), toast(`/${name}: ${describe(err)}`, "error");
+      }
+    },
     async clearLoopHistory(agentId, loop) {
       await run("Clear", (c) => c.clearChat(agentId, loop)) && (dispatch({ type: "transcript/reset", key: transcriptKey(agentId, loop) }), toast(`Cleared ${loop} history`, "success"), await actions.refreshLoops(agentId));
     },
@@ -1451,6 +1524,11 @@ function createTuiStore(options) {
     }, WEB_EVENT_DEBOUNCE_MS), !agentId || !state.agents[agentId]) return;
     let loop = eventLoop(event), key = transcriptKey(agentId, loop);
     switch (event.event_type) {
+      case "context.injected":
+        event.payload?.category === "owner_command" && debounce(`t:${key}`, () => {
+          actions.loadTranscript(agentId, loop);
+        });
+        break;
       case "turn.completed":
       case "loop.cleared":
       case "loop.compacted":
@@ -1534,6 +1612,11 @@ function createTuiStore(options) {
   function onClientFrame(frame) {
     let effects = clientFrameEffects(frame);
     for (let envelope of effects.frames) onFrame(envelope);
+    if (effects.ownerCommand) {
+      flushFrames();
+      let { agentId, loop, item } = effects.ownerCommand;
+      dispatch({ type: "transcript/owner-command", key: transcriptKey(agentId, loop), item });
+    }
     if (effects.toolResult) {
       flushFrames();
       let { agentId, loop, toolUseId, result, isError } = effects.toolResult;
@@ -1558,7 +1641,7 @@ function createTuiStore(options) {
       return err instanceof DaemonError && err.unreachable ? (sessionRetry = !0, null) : (noticeFallback(err instanceof DaemonError && err.status === 404 ? "the daemon has no client sessions (an older version)" : `GET /version failed (${describe(err)})`), null);
     }
     try {
-      return (await c.createClientSession({ client: "tui", version: options.clientVersion ?? process.env.ADF_VERSION ?? "dev", umbilical: !0 })).sessionId;
+      return (await c.createClientSession({ client: TUI_CLIENT_NAME, version: options.clientVersion ?? process.env.ADF_VERSION ?? "dev", umbilical: !0 })).sessionId;
     } catch (err) {
       return err instanceof DaemonError && err.unreachable ? (sessionRetry = !0, null) : (noticeFallback(err instanceof DaemonError && err.status === 404 ? "the daemon has no client sessions (an older version)" : `opening a client session failed (${describe(err)})`), null);
     }
@@ -1697,14 +1780,14 @@ export {
   MAIN_LOOP,
   DaemonError,
   isCredentialsLocked,
-  emptyTranscript,
-  isAsyncInput,
-  askQuestion,
   isTrackedKey,
   folderName,
   stoppedLabel,
   stoppedError,
   findTracked,
+  emptyTranscript,
+  isAsyncInput,
+  askQuestion,
   transcriptKey,
   isBusyState,
   parseServer,

package/dist/chunks/{chunk-G6NBFYG5.mjs → chunk-SOSPQPEN.mjs}

@@ -163,6 +163,193 @@ function reconcileHostApprovedRegistrations(prev, next, approved, approvedSource
   return { approved: result, sources };
 }
 
+// src/shared/constants/provider-catalog.ts
+var provider_catalog_exports = {};
+__export(provider_catalog_exports, {
+  PROVIDER_CATALOG: () => PROVIDER_CATALOG,
+  PROVIDER_CATALOG_GROUPS: () => PROVIDER_CATALOG_GROUPS,
+  catalogEntryForProvider: () => catalogEntryForProvider,
+  findCatalogEntry: () => findCatalogEntry,
+  isSubscriptionType: () => isSubscriptionType,
+  nextProviderName: () => nextProviderName,
+  providerTypeHint: () => providerTypeHint
+});
+var PROVIDER_CATALOG_GROUPS = [
+  { id: "subscription", label: "Subscriptions", hint: "Sign in with an existing consumer plan. No API key." },
+  { id: "api", label: "APIs", hint: "Pay-as-you-go endpoints. Paste an API key." },
+  { id: "local", label: "Local", hint: "Servers running on this machine. Usually no key." },
+  { id: "other", label: "Other", hint: "Anything that speaks the OpenAI API." }
+], oc = (key, label, baseUrl, description, extra = {}) => ({
+  key,
+  label,
+  type: "openai-compatible",
+  group: "api",
+  baseUrl,
+  description,
+  keyPlaceholder: "API key",
+  modelPlaceholder: "model id",
+  ...extra
+}), local = (key, label, baseUrl, description, extra = {}) => ({
+  key,
+  label,
+  type: "openai-compatible",
+  group: "local",
+  baseUrl,
+  description,
+  keyPlaceholder: "Usually not needed",
+  modelPlaceholder: "loaded model id",
+  keyOptional: !0,
+  ...extra
+}), PROVIDER_CATALOG = [
+  // ---- Subscriptions --------------------------------------------------------
+  {
+    key: "chatgpt-subscription",
+    label: "ChatGPT",
+    type: "chatgpt-subscription",
+    group: "subscription",
+    description: "Use your ChatGPT Plus / Pro plan. Sign in with your OpenAI account.",
+    modelPlaceholder: "e.g. gpt-5.6-sol",
+    iconKey: "openai"
+  },
+  {
+    key: "grok-subscription",
+    label: "Grok",
+    type: "grok-subscription",
+    group: "subscription",
+    description: "Use your SuperGrok or X Premium plan. Sign in with xAI.",
+    modelPlaceholder: "e.g. grok-4.5",
+    iconKey: "x"
+  },
+  {
+    key: "claude-subscription",
+    label: "Claude",
+    type: "claude-subscription",
+    group: "subscription",
+    description: "Use your Claude Pro or Max plan, via Claude Code.",
+    modelPlaceholder: "e.g. claude-sonnet-5-5",
+    iconKey: "anthropic"
+  },
+  // ---- First-party APIs -----------------------------------------------------
+  {
+    key: "anthropic",
+    label: "Anthropic",
+    type: "anthropic",
+    group: "api",
+    description: "Claude models via the Anthropic API.",
+    keyPlaceholder: "sk-ant-...",
+    modelPlaceholder: "e.g. claude-sonnet-4-5",
+    iconKey: "anthropic",
+    keysUrl: "https://console.anthropic.com/settings/keys"
+  },
+  {
+    key: "openai",
+    label: "OpenAI",
+    type: "openai",
+    group: "api",
+    description: "GPT and o-series models via the OpenAI API.",
+    keyPlaceholder: "sk-...",
+    modelPlaceholder: "e.g. gpt-4o, o3-mini",
+    iconKey: "openai",
+    keysUrl: "https://platform.openai.com/api-keys"
+  },
+  {
+    key: "openrouter",
+    label: "OpenRouter",
+    type: "openrouter",
+    group: "api",
+    description: "One key for hundreds of models across providers.",
+    keyPlaceholder: "sk-or-...",
+    modelPlaceholder: "e.g. anthropic/claude-sonnet-4",
+    iconKey: "openrouter",
+    keysUrl: "https://openrouter.ai/keys"
+  },
+  // ---- OpenAI-compatible hosted APIs ---------------------------------------
+  oc("gemini", "Google Gemini", "https://generativelanguage.googleapis.com/v1beta/openai", "Gemini models through the OpenAI-compatible endpoint.", { iconKey: "gemini", keysUrl: "https://aistudio.google.com/apikey", modelPlaceholder: "e.g. gemini-2.5-pro" }),
+  oc("xai", "xAI", "https://api.x.ai/v1", "Grok models via the xAI API.", { iconKey: "x", keysUrl: "https://console.x.ai", modelPlaceholder: "e.g. grok-4" }),
+  oc("mistral", "Mistral", "https://api.mistral.ai/v1", "Mistral and Codestral models.", { iconKey: "mistral", keysUrl: "https://console.mistral.ai/api-keys", modelPlaceholder: "e.g. mistral-large-latest" }),
+  oc("deepseek", "DeepSeek", "https://api.deepseek.com/v1", "DeepSeek chat and reasoner models.", { iconKey: "deepseek", keysUrl: "https://platform.deepseek.com/api_keys", modelPlaceholder: "e.g. deepseek-chat" }),
+  oc("groq", "Groq", "https://api.groq.com/openai/v1", "Fast inference for open models on LPUs.", { keysUrl: "https://console.groq.com/keys", modelPlaceholder: "e.g. llama-3.3-70b-versatile" }),
+  oc("cerebras", "Cerebras", "https://api.cerebras.ai/v1", "Very fast inference for open models.", { keysUrl: "https://cloud.cerebras.ai", modelPlaceholder: "e.g. llama-3.3-70b" }),
+  oc("together", "Together AI", "https://api.together.xyz/v1", "Open models, fine-tunes, and dedicated endpoints.", { keysUrl: "https://api.together.ai/settings/api-keys", modelPlaceholder: "e.g. meta-llama/Llama-3.3-70B-Instruct-Turbo" }),
+  oc("fireworks", "Fireworks AI", "https://api.fireworks.ai/inference/v1", "Fast serverless inference for open models.", { keysUrl: "https://fireworks.ai/account/api-keys", modelPlaceholder: "e.g. accounts/fireworks/models/llama-v3p3-70b-instruct" }),
+  oc("perplexity", "Perplexity", "https://api.perplexity.ai", "Sonar models with built-in web search.", { iconKey: "perplexity", keysUrl: "https://www.perplexity.ai/settings/api", modelPlaceholder: "e.g. sonar-pro" }),
+  oc("cohere", "Cohere", "https://api.cohere.ai/compatibility/v1", "Command models through the compatibility API.", { keysUrl: "https://dashboard.cohere.com/api-keys", modelPlaceholder: "e.g. command-a-03-2025" }),
+  oc("huggingface", "Hugging Face", "https://router.huggingface.co/v1", "Inference Providers router. Uses your HF token.", { iconKey: "huggingface", keysUrl: "https://huggingface.co/settings/tokens", keyPlaceholder: "hf_...", modelPlaceholder: "e.g. meta-llama/Llama-3.3-70B-Instruct" }),
+  oc("nvidia", "NVIDIA NIM", "https://integrate.api.nvidia.com/v1", "Hosted NIM endpoints on build.nvidia.com.", { iconKey: "nvidia", keysUrl: "https://build.nvidia.com", keyPlaceholder: "nvapi-...", modelPlaceholder: "e.g. meta/llama-3.3-70b-instruct" }),
+  oc("vercel-ai-gateway", "Vercel AI Gateway", "https://ai-gateway.vercel.sh/v1", "Route to many providers through one Vercel key.", { iconKey: "vercel", keysUrl: "https://vercel.com/dashboard/ai-gateway", modelPlaceholder: "e.g. anthropic/claude-sonnet-4" }),
+  oc("cloudflare", "Cloudflare Workers AI", "https://api.cloudflare.com/client/v4/accounts/YOUR_ACCOUNT_ID/ai/v1", "Open models at the edge. Replace YOUR_ACCOUNT_ID in the base URL.", { iconKey: "cloudflare", keysUrl: "https://dash.cloudflare.com/profile/api-tokens", modelPlaceholder: "e.g. @cf/meta/llama-3.3-70b-instruct-fp8-fast" }),
+  oc("azure-openai", "Azure OpenAI", "https://YOUR_RESOURCE.openai.azure.com/openai/v1", "Azure-hosted OpenAI models. Replace YOUR_RESOURCE in the base URL.", { keysUrl: "https://portal.azure.com", modelPlaceholder: "your deployment name" }),
+  oc("deepinfra", "DeepInfra", "https://api.deepinfra.com/v1/openai", "Low-cost hosting for open models.", { keysUrl: "https://deepinfra.com/dash/api_keys", modelPlaceholder: "e.g. meta-llama/Llama-3.3-70B-Instruct" }),
+  oc("sambanova", "SambaNova", "https://api.sambanova.ai/v1", "Fast inference on SambaNova RDUs.", { keysUrl: "https://cloud.sambanova.ai/apis", modelPlaceholder: "e.g. Meta-Llama-3.3-70B-Instruct" }),
+  oc("nebius", "Nebius", "https://api.studio.nebius.com/v1", "Nebius AI Studio open-model endpoints.", { keysUrl: "https://studio.nebius.com/settings/api-keys", modelPlaceholder: "e.g. meta-llama/Llama-3.3-70B-Instruct" }),
+  oc("hyperbolic", "Hyperbolic", "https://api.hyperbolic.xyz/v1", "Open models on decentralized GPU capacity.", { keysUrl: "https://app.hyperbolic.xyz/settings", modelPlaceholder: "e.g. meta-llama/Llama-3.3-70B-Instruct" }),
+  oc("novita", "Novita AI", "https://api.novita.ai/v3/openai", "Serverless open-model inference.", { keysUrl: "https://novita.ai/settings/key-management", modelPlaceholder: "e.g. meta-llama/llama-3.3-70b-instruct" }),
+  oc("baseten", "Baseten", "https://inference.baseten.co/v1", "Model APIs and dedicated deployments.", { keysUrl: "https://app.baseten.co/settings/api_keys", modelPlaceholder: "e.g. deepseek-ai/DeepSeek-V3-0324" }),
+  oc("scaleway", "Scaleway", "https://api.scaleway.ai/v1", "EU-hosted generative APIs.", { iconKey: "scaleway", keysUrl: "https://console.scaleway.com/iam/api-keys", modelPlaceholder: "e.g. llama-3.3-70b-instruct" }),
+  oc("venice", "Venice", "https://api.venice.ai/api/v1", "Private, uncensored open-model inference.", { keysUrl: "https://venice.ai/settings/api", modelPlaceholder: "e.g. llama-3.3-70b" }),
+  oc("kluster", "kluster.ai", "https://api.kluster.ai/v1", "Open-model inference with batch pricing.", { keysUrl: "https://platform.kluster.ai/apikeys", modelPlaceholder: "e.g. deepseek-ai/DeepSeek-V3-0324" }),
+  oc("moonshot", "Moonshot (Kimi)", "https://api.moonshot.ai/v1", "Kimi models from Moonshot AI.", { iconKey: "kimi", keysUrl: "https://platform.moonshot.ai/console/api-keys", modelPlaceholder: "e.g. kimi-k2-0711-preview" }),
+  oc("zai", "Z.ai (GLM)", "https://api.z.ai/api/paas/v4", "GLM models from Zhipu / Z.ai.", { keysUrl: "https://z.ai/manage-apikey/apikey-list", modelPlaceholder: "e.g. glm-4.5" }),
+  oc("qwen", "Qwen (Alibaba)", "https://dashscope-intl.aliyuncs.com/compatible-mode/v1", "Qwen models via Model Studio (international).", { iconKey: "qwen", keysUrl: "https://modelstudio.console.alibabacloud.com/?tab=playground#/api-key", modelPlaceholder: "e.g. qwen-plus" }),
+  oc("minimax", "MiniMax", "https://api.minimax.io/v1", "MiniMax text models.", { iconKey: "minimax", keysUrl: "https://platform.minimax.io/user-center/basic-information/interface-key", modelPlaceholder: "e.g. MiniMax-M1" }),
+  oc("inception", "Inception", "https://api.inceptionlabs.ai/v1", "Mercury diffusion language models.", { keysUrl: "https://platform.inceptionlabs.ai", modelPlaceholder: "e.g. mercury-coder" }),
+  // ---- Local servers ---------------------------------------------------------
+  local("lmstudio", "LM Studio", "http://localhost:1234/v1", "Local server from the LM Studio app.", { iconKey: "lmstudio" }),
+  local("ollama", "Ollama", "http://localhost:11434/v1", "Local models served by Ollama.", { iconKey: "ollama", modelPlaceholder: "e.g. llama3.3" }),
+  local("vllm", "vLLM", "http://localhost:8000/v1", "vLLM OpenAI-compatible server.", { iconKey: "vllm" }),
+  local("llamacpp", "llama.cpp", "http://localhost:8080/v1", "llama-server from llama.cpp."),
+  local("litellm", "LiteLLM", "http://localhost:4000/v1", "LiteLLM proxy in front of any provider.", { keyOptional: !1, keyPlaceholder: "Proxy key, if set" }),
+  local("jan", "Jan", "http://localhost:1337/v1", "Local server from the Jan app."),
+  local("localai", "LocalAI", "http://localhost:8080/v1", "LocalAI drop-in OpenAI server."),
+  local("tgwui", "text-generation-webui", "http://localhost:5000/v1", "oobabooga OpenAI extension."),
+  // ---- Other -----------------------------------------------------------------
+  {
+    key: "openai-compatible",
+    label: "OpenAI-compatible",
+    type: "openai-compatible",
+    group: "other",
+    description: "Any endpoint that speaks the OpenAI chat API. Enter the base URL.",
+    keyPlaceholder: "Optional",
+    modelPlaceholder: "model id"
+  }
+], BY_KEY = new Map(PROVIDER_CATALOG.map((e) => [e.key, e]));
+function findCatalogEntry(key) {
+  return key ? BY_KEY.get(key) : void 0;
+}
+function catalogEntryForProvider(p) {
+  return findCatalogEntry(p.preset) ?? findCatalogEntry(p.type);
+}
+function nextProviderName(label, existing) {
+  let taken = new Set(existing.map((p) => p.name.trim().toLowerCase()));
+  if (!taken.has(label.toLowerCase())) return label;
+  for (let n = 2; n < 1e3; n++) {
+    let candidate = `${label} ${n}`;
+    if (!taken.has(candidate.toLowerCase())) return candidate;
+  }
+  return `${label} ${Date.now()}`;
+}
+function providerTypeHint(type) {
+  switch (type) {
+    case "anthropic":
+      return "Anthropic API";
+    case "openai":
+      return "OpenAI API";
+    case "openrouter":
+      return "OpenRouter API";
+    case "openai-compatible":
+      return "OpenAI-compatible API";
+    case "chatgpt-subscription":
+      return "ChatGPT subscription (OAuth)";
+    case "grok-subscription":
+      return "Grok subscription (OAuth)";
+    case "claude-subscription":
+      return "Claude subscription (via Claude Code)";
+  }
+}
+function isSubscriptionType(type) {
+  return type === "chatgpt-subscription" || type === "grok-subscription" || type === "claude-subscription";
+}
+
 // src/shared/constants/mcp-registry.ts
 var mcp_registry_exports = {};
 __export(mcp_registry_exports, {
@@ -1793,6 +1980,8 @@ export {
   isRegistrationAgentVisible,
   deriveRegistrationTestPlan,
   mcp_config_exports,
+  isSubscriptionType,
+  provider_catalog_exports,
   parseMcpRegistryDocument,
   MCP_REGISTRY,
   BUNDLED_REGISTRY_UPDATED_AT,

package/dist/chunks/chunk-VENQBMOA.mjs

@@ -0,0 +1,62 @@
+import { createRequire as __adfCreateRequire } from 'node:module';
+import { fileURLToPath as __adfFileURLToPath } from 'node:url';
+import { dirname as __adfDirname } from 'node:path';
+const require = __adfCreateRequire(import.meta.url);
+const __filename = __adfFileURLToPath(import.meta.url);
+const __dirname = __adfDirname(__filename);
+import {
+  __export
+} from "./chunk-M2RX3S2T.mjs";
+
+// src/shared/utils/agent-commands.ts
+var agent_commands_exports = {};
+__export(agent_commands_exports, {
+  COMMAND_NAME_PATTERN: () => COMMAND_NAME_PATTERN,
+  RESERVED_COMMAND_NAMES: () => RESERVED_COMMAND_NAMES,
+  parseAuthorizeToken: () => parseAuthorizeToken,
+  parseLambdaRef: () => parseLambdaRef,
+  splitArgv: () => splitArgv,
+  validateAgentCommands: () => validateAgentCommands
+});
+var COMMAND_NAME_PATTERN = /^[a-z](?:[a-z0-9-]{0,30}[a-z0-9])?$/, RESERVED_COMMAND_NAMES = ["compact", "clear", "skills", "idle", "hibernate", "stop", "off"];
+function parseLambdaRef(ref) {
+  let colon = typeof ref == "string" ? ref.lastIndexOf(":") : -1, file = colon > 0 ? ref.slice(0, colon) : "", fn = colon > 0 ? ref.slice(colon + 1) : "";
+  return !/\.(ts|js|mjs)$/.test(file) || !/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(fn) ? { error: `Lambda must be "path/file.ts:functionName" (got "${ref}").` } : { file, fn };
+}
+function validateAgentCommands(commands) {
+  if (!Array.isArray(commands)) return [{ index: -1, field: "commands", message: "Commands must be an array. Replace the malformed value with a list of commands." }];
+  let issues = [], seen = /* @__PURE__ */ new Set();
+  return commands.forEach((command, index) => {
+    let add = (field, message) => {
+      issues.push({ index, field, message });
+    };
+    if (!command || typeof command != "object") {
+      add("name", "Provide a command with a name, description and lambda.");
+      return;
+    }
+    let name = command.name;
+    if ((typeof name != "string" || !COMMAND_NAME_PATTERN.test(name)) && add("name", `Command "${name}" is not a valid name: use 1\u201332 lowercase letters, digits and hyphens, starting with a letter and ending with a letter or digit.`), RESERVED_COMMAND_NAMES.includes(name) && add("name", `"/${name}" is a built-in command. Pick another name.`), typeof name == "string") {
+      let key = name.toLowerCase();
+      seen.has(key) && add("name", `Command "${name}" is duplicated. Pick a unique name.`), seen.add(key);
+    }
+    (typeof command.description != "string" || command.description.length < 1 || command.description.length > 200) && add("description", "Description must contain 1\u2013200 characters."), command.usage !== void 0 && (typeof command.usage != "string" || command.usage.length > 100) && add("usage", "Usage must contain at most 100 characters.");
+    let ref = parseLambdaRef(command.lambda);
+    "error" in ref && add("lambda", ref.error);
+  }), commands.length > 64 && issues.push({ index: 64, field: "name", message: "Register at most 64 commands." }), issues;
+}
+function splitArgv(args) {
+  return args.split(/\s+/).filter(Boolean);
+}
+function parseAuthorizeToken(args) {
+  let authorize = !1;
+  return { args: splitArgv(args).filter((token) => token !== "!authorize" ? !0 : (authorize = !0, !1)).map((token) => token === "\\!authorize" ? "!authorize" : token).join(" "), authorize };
+}
+
+export {
+  COMMAND_NAME_PATTERN,
+  RESERVED_COMMAND_NAMES,
+  parseLambdaRef,
+  validateAgentCommands,
+  splitArgv,
+  agent_commands_exports
+};

package/dist/chunks/{chunk-XT2BJUFC.mjs → chunk-YRBFIDLB.mjs}

@@ -4,13 +4,19 @@ import { dirname as __adfDirname } from 'node:path';
 const require = __adfCreateRequire(import.meta.url);
 const __filename = __adfFileURLToPath(import.meta.url);
 const __dirname = __adfDirname(__filename);
+import {
+  COMMAND_NAME_PATTERN,
+  RESERVED_COMMAND_NAMES,
+  validateAgentCommands
+} from "./chunk-VENQBMOA.mjs";
 import {
   AGENT_STATES,
   LOOP_PROHIBITED_TOOLS,
   MESSAGING_MODES,
   RESERVED_AGENT_PATH_SEGMENTS,
-  START_IN_STATES
-} from "./chunk-NZO5O4VN.mjs";
+  START_IN_STATES,
+  hasLoopGoal
+} from "./chunk-BR3AD5QZ.mjs";
 import {
   external_exports
 } from "./chunk-ZJKXHM4Q.mjs";
@@ -398,13 +404,18 @@ var StreamBindEndpointSchema = external_exports.union([
   }).optional(),
   params: external_exports.array(external_exports.object({ key: external_exports.string(), value: external_exports.string() })).optional(),
   provider_params: external_exports.record(external_exports.unknown()).optional()
-}), PROHIBITED_LOOP_TOOL_NAMES = LOOP_PROHIBITED_TOOLS, LOOP_NAME_PATTERN = /^[a-z0-9][a-z0-9_-]{0,31}$/, LOOP_NAME_RULE = 'loop name must be 1-32 characters of lowercase letters, digits, "_" or "-", starting with a letter or digit', LOOP_GOAL_MAX_CHARS = 4e3, LOOP_TOOLS_MAX = 64, MAX_SIDE_LOOPS = 16, LoopConfigSchema = external_exports.object({
+}), PROHIBITED_LOOP_TOOL_NAMES = LOOP_PROHIBITED_TOOLS, LOOP_NAME_PATTERN = /^[a-z0-9][a-z0-9_-]{0,31}$/, LOOP_NAME_RULE = 'loop name must be 1-32 characters of lowercase letters, digits, "_" or "-", starting with a letter or digit', LOOP_GOAL_MAX_CHARS = 4e3, LOOP_TOOLS_MAX = 64;
+var LoopConfigSchema = external_exports.object({
   name: external_exports.string().regex(LOOP_NAME_PATTERN, { message: LOOP_NAME_RULE }).refine((n) => n !== "main", {
     message: "'main' is the implicit host loop and cannot be declared as an inner loop"
   }),
-  goal: external_exports.string().min(1).max(LOOP_GOAL_MAX_CHARS),
+  // Optional and may be empty: the derived preamble alone is a usable
+  // instruction set, and a blank loop takes its work from whoever addresses it.
+  goal: external_exports.string().max(LOOP_GOAL_MAX_CHARS).optional().describe("Appended to the loop's instructions. Optional; required (non-empty) when autostart is true."),
   enabled: external_exports.boolean(),
-  autostart: external_exports.boolean().optional().describe("Run a first turn on the goal at create and whenever the agent starts, instead of waiting to be addressed."),
+  // The goal rule is restated here because zodToJsonSchema drops the
+  // superRefine below that enforces it.
+  autostart: external_exports.boolean().optional().describe("Run a first turn on the goal at create and whenever the agent starts, instead of waiting to be addressed. Requires a non-empty goal."),
   autonomous: external_exports.boolean().optional().describe("Keep turning after text-only responses until the loop calls sys_set_state. Per-loop; not inherited from the host. Default false."),
   model: ModelConfigSchema.optional().describe(
     "Overrides the parent's model for this loop only. Absent = inherit. `provider` may name a different configured provider than the parent's (e.g. a grok-subscription loop under a chatgpt-subscription host); credentials are resolved by that provider id. A loop whose provider cannot be built does not start."
@@ -417,6 +428,11 @@ var StreamBindEndpointSchema = external_exports.union([
   ),
   tools: external_exports.array(external_exports.string().min(1)).max(LOOP_TOOLS_MAX).optional().describe("Absolute allow-list, intersected with host-enabled tools at derive time. Nothing is implicit \u2014 loop_send/loop_list must be listed to be granted.")
 }).superRefine((loop, ctx) => {
+  loop.autostart === !0 && !hasLoopGoal(loop) && ctx.addIssue({
+    code: external_exports.ZodIssueCode.custom,
+    message: `loop "${loop.name}" has autostart on but no goal; add a goal or turn autostart off`,
+    path: ["autostart"]
+  });
   for (let tool of loop.tools ?? [])
     PROHIBITED_LOOP_TOOL_NAMES.includes(tool) && ctx.addIssue({
       code: external_exports.ZodIssueCode.custom,
@@ -451,6 +467,15 @@ var StreamBindEndpointSchema = external_exports.union([
     });
   } else hook.loops !== void 0 && ctx.addIssue({ code: external_exports.ZodIssueCode.custom, message: 'loops is only allowed when pre_llm_hook.scope is "loops"', path: ["loops"] });
   hook.scope !== "loops" && hook.include_main !== void 0 && ctx.addIssue({ code: external_exports.ZodIssueCode.custom, message: 'include_main is only allowed when pre_llm_hook.scope is "loops"', path: ["include_main"] });
+}), AgentCommandSchema = external_exports.object({
+  name: external_exports.string().regex(COMMAND_NAME_PATTERN).describe(`Typed after the slash. 1\u201332 lowercase letters, digits, hyphens; starts with a letter. Not one of: ${RESERVED_COMMAND_NAMES.join(", ")}. Unique in commands.`),
+  description: external_exports.string().min(1).max(200),
+  usage: external_exports.string().max(100).optional(),
+  lambda: external_exports.string().min(1).describe('"path/file.ts:functionName". The function receives one object: { command, args, argv, invoker, loop, authorized, id }.'),
+  locked: external_exports.boolean().optional()
+}), AgentCommandsSchema = external_exports.array(AgentCommandSchema).max(64).superRefine((commands, ctx) => {
+  for (let issue of validateAgentCommands(commands))
+    ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: [issue.index, issue.field], message: issue.message });
 }), AgentConfigSchema = external_exports.object({
   adf_version: external_exports.literal("0.2"),
   id: external_exports.string().min(1),
@@ -589,6 +614,7 @@ var StreamBindEndpointSchema = external_exports.union([
   logging: LoggingConfigSchema.optional(),
   adapters: external_exports.record(AdapterInstanceConfigSchema).optional(),
   serving: ServingConfigSchema.optional(),
+  commands: AgentCommandsSchema.optional(),
   ws_connections: external_exports.array(WsConnectionConfigSchema).optional(),
   stream_bind: StreamBindConfigSchema.optional(),
   stream_bindings: external_exports.array(StreamBindingDeclarationSchema).optional(),
@@ -726,10 +752,11 @@ export {
   LOOP_NAME_RULE,
   LOOP_GOAL_MAX_CHARS,
   LOOP_TOOLS_MAX,
-  MAX_SIDE_LOOPS,
   LoopConfigSchema,
   LoopsConfigSchema,
   PreLlmHookConfigSchema,
+  AgentCommandSchema,
+  AgentCommandsSchema,
   AgentConfigSchema,
   TimerScheduleSchema
 };

package/dist/chunks/{claude-subscription-33BMZB6I.mjs → claude-subscription-EB4LAAVV.mjs}

@@ -8,8 +8,8 @@ import {
   CLAUDE_SUBSCRIPTION_MODELS,
   createClaudeSubscriptionProvider,
   listClaudeSubscriptionModels
-} from "./chunk-C4GA5SI4.mjs";
-import "./chunk-LCMANRYY.mjs";
+} from "./chunk-KCIRFUZH.mjs";
+import "./chunk-E7LC6SHP.mjs";
 import "./chunk-NZ7JTHEO.mjs";
 import "./chunk-JZFONJSL.mjs";
 import "./chunk-TKXIH27X.mjs";
@@ -17,7 +17,7 @@ import "./chunk-LKFHERRV.mjs";
 import {
   getClaudeAuthManager
 } from "./chunk-MZRXFWPQ.mjs";
-import "./chunk-NZO5O4VN.mjs";
+import "./chunk-BR3AD5QZ.mjs";
 import "./chunk-ZJKXHM4Q.mjs";
 import "./chunk-RIX34QHC.mjs";
 import "./chunk-M2RX3S2T.mjs";

package/dist/chunks/{cli-I47IFDHJ.mjs → cli-PCVFB6B4.mjs}

@@ -33,8 +33,8 @@ import {
 } from "./chunk-M2F7C2UJ.mjs";
 import {
   daemonPaths
-} from "./chunk-PRPTKMQW.mjs";
-import "./chunk-JVPZIMXW.mjs";
+} from "./chunk-RHBGCOS3.mjs";
+import "./chunk-D7A77SNL.mjs";
 import {
   DEFAULT_DAEMON_PORT,
   DEFAULT_DAEMON_URL,
@@ -58,8 +58,8 @@ import {
   storeRemoteToken,
   tunnelTokenHint,
   updateRemotes
-} from "./chunk-V2T6NZX2.mjs";
-import "./chunk-WVTPPOKK.mjs";
+} from "./chunk-AEAJDCVK.mjs";
+import "./chunk-BS3USVEA.mjs";
 import "./chunk-WJGPNHGX.mjs";
 import "./chunk-PAK5JCO2.mjs";
 import "./chunk-ZPB3HYM7.mjs";
@@ -531,7 +531,7 @@ function tuiInvocation(argv) {
   return argv.filter((a) => a !== "--json");
 }
 async function defaultLaunchTui(argv) {
-  let { runTui } = await import("./tui-SPSPDADM.mjs");
+  let { runTui } = await import("./tui-RAUVFOYY.mjs");
   return await runTui(argv);
 }
 function urlFromArgv(argv, env) {