@agentdocumentformat/cli 0.7.8 → 0.8.1

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

@@ -5,15 +5,21 @@ const require = __adfCreateRequire(import.meta.url);
 const __filename = __adfFileURLToPath(import.meta.url);
 const __dirname = __adfDirname(__filename);
 import {
-  external_exports
-} from "./chunk-ZJKXHM4Q.mjs";
+  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-CD3ATSXE.mjs";
+  START_IN_STATES,
+  hasLoopGoal
+} from "./chunk-BR3AD5QZ.mjs";
+import {
+  external_exports
+} from "./chunk-ZJKXHM4Q.mjs";
 
 // src/shared/types/umbilical-events.ts
 var UMBILICAL_EVENT_TYPES = [
@@ -375,7 +381,8 @@ var StreamBindEndpointSchema = external_exports.union([
   provider: external_exports.string().min(1),
   model_id: external_exports.string().default(""),
   temperature: external_exports.number().min(0).max(2).nullable().default(0.7),
-  max_tokens: external_exports.number().int().positive().nullable().default(4096),
+  /** Output cap per response. Unset, null or 0: the model's own limit. */
+  max_tokens: external_exports.number().int().nonnegative().nullable().optional(),
   top_p: external_exports.number().min(0).max(1).nullable().optional(),
   /** @deprecated folded into `reasoning.max_tokens` on config load. */
   thinking_budget: external_exports.number().int().positive().nullable().optional(),
@@ -397,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."
@@ -416,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,
@@ -450,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),
@@ -465,11 +491,19 @@ var StreamBindEndpointSchema = external_exports.union([
   autonomous: external_exports.boolean().default(!1),
   autostart: external_exports.boolean().optional(),
   model: ModelConfigSchema,
-  instructions: external_exports.string().min(1),
+  // Empty is valid: new agents and templates start with no instructions.
+  instructions: external_exports.string(),
   include_base_prompt: external_exports.boolean().optional(),
   bare_prompt: external_exports.boolean().optional(),
   context: external_exports.object({
     compact_threshold: external_exports.number().int().positive().nullable().optional(),
+    // Request media limit (ADF spec §13.1). Same bounds as compact_threshold:
+    // positive, no upper limit.
+    max_request_media_files: external_exports.number().int().positive().nullable().optional().describe("Most referenced files one request carries. Absent or null: 20. Past it the oldest are left out, down to half."),
+    max_request_media_mb: external_exports.number().int().positive().nullable().optional().describe("Most MiB of referenced files one request carries. Absent or null: 20. Past it the oldest are left out, down to half."),
+    compaction_model: ModelConfigSchema.nullable().optional().describe(
+      "Model that writes the compaction summary. Absent = the agent's own model. `provider` may name any configured provider; credentials are resolved by that provider id. If it cannot be built, the compaction fails (history kept, compaction_failed logged) \u2014 it never falls back to the agent's model."
+    ),
     audit: external_exports.object({
       loop: external_exports.boolean().default(!0),
       inbox: external_exports.boolean().default(!1),
@@ -580,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(),
@@ -717,10 +752,11 @@ export {
   LOOP_NAME_RULE,
   LOOP_GOAL_MAX_CHARS,
   LOOP_TOOLS_MAX,
-  MAX_SIDE_LOOPS,
   LoopConfigSchema,
   LoopsConfigSchema,
   PreLlmHookConfigSchema,
+  AgentCommandSchema,
+  AgentCommandsSchema,
   AgentConfigSchema,
   TimerScheduleSchema
 };