kylon-cli 0.3.1-next.492 → 0.3.1-next.494

package/README.md

@@ -281,10 +281,25 @@ instead of waiting out inactivity timeouts and heartbeat intervals.
 - `codex` — OpenAI Codex CLI
 - `claude-code` — Anthropic Claude Code CLI
 - `hermes` — Hermes CLI using `hermes -z <prompt>`
-- `openclaw` — OpenClaw CLI using `openclaw agent --message <prompt> --json`
+- `openclaw` — OpenClaw CLI using `openclaw agent --message <prompt> --json`.
+  A message too large for the command line is delivered as a file via
+  `--message-file <path>` instead (requires OpenClaw 2026.6.11 or newer; the
+  OpenClaw CLI has no stdin message channel).
 - `generic` - provider-neutral wrapper. Runs a `kylon-provider`
   executable on `PATH` and expects newline-delimited JSON events matching
   `docs/journal_docs/05_25_external_agent_provider_adapter_contract.md`.
+  Delivery: `--prompt <text> --workdir <dir> [--system-prompt <text>]
+  [--resume <id>]`. When the payload is too large for the platform's
+  command-line budget (cmd.exe caps its input line at 8,191 chars; Linux caps
+  one argv string at 128 KiB), the gateway instead writes the payloads to
+  owner-only temp files and passes `--prompt-file <path>`
+  (`--system-prompt-file <path>` for the system prompt), with the same paths
+  exported as `KYLON_PROMPT_FILE`/`KYLON_SYSTEM_PROMPT_FILE`. File delivery is
+  used only when the wrapper opts in by advertising
+  `kylon-provider-caps: prompt-file, system-prompt-file` anywhere in its
+  `--version` output (the one probe every wrapper already supports); a wrapper
+  without the advertisement fails over-budget assignments with a named error
+  instead of receiving flags it would misparse.
 
 ## State Model