@cleocode/cleo 2026.4.158 → 2026.5.0

package/dist/cli/commands/agent.d.ts

@@ -0,0 +1,47 @@
+/**
+ * CLI agent command group — agent credential management (unified registry).
+ *
+ * Provides:
+ *   cleo agent register   — register a new agent credential
+ *   cleo agent list       — list all registered agent credentials
+ *   cleo agent get <id>   — get a specific agent credential
+ *   cleo agent remove <id> — remove an agent credential
+ *   cleo agent rotate-key <id> — rotate an agent's API key
+ *   cleo agent poll       — one-shot message check
+ *   cleo agent send       — send a message to an agent or conversation
+ *   cleo agent start      — start the daemon poller for an agent
+ *   cleo agent install    — install an agent from .cantz archive or directory
+ *   cleo agent pack       — package an agent directory as .cantz archive
+ *   cleo agent create     — scaffold a new agent package with persona.cant and manifest.json
+ *
+ * **Daemon vs. Pi session — important distinction.** The daemon spawned
+ * by `cleo agent start` ONLY polls SignalDock for inbound messages and
+ * keeps the cloud status indicator green. It does NOT execute CANT
+ * workflow profiles inside the daemon process. CANT workflow execution
+ * (sessions, parallel arms, conditionals, approval gates, discretion
+ * evaluation, etc.) lives entirely inside the
+ * `cant-bridge.ts` Pi extension at
+ * `packages/cleo/templates/cleoos-hub/pi-extensions/cant-bridge.ts`,
+ * which interprets `.cant` files via shell-out to the `cleo cant`
+ * command family. Operators who want profile-driven behaviour should
+ * start a Pi session and use `/cant:load <file>` followed by
+ * `/cant:run <file> <workflowName>`. The daemon and the Pi session are
+ * distinct runtimes with distinct purposes, by design (see ADR-035 §D5
+ * "Option Y" addendum).
+ *
+ * @see docs/specs/SIGNALDOCK-UNIFIED-AGENT-REGISTRY.md Section 3.4
+ * @see .cleo/adrs/ADR-035-pi-v2-v3-harness.md §D5 + Addendum
+ * @task T178
+ */
+/**
+ * Root agent command group — agent lifecycle, credentials, and messaging.
+ *
+ * Registers all agent subcommands. See file-level TSDoc for the full
+ * command surface and daemon vs. Pi session architectural distinction.
+ *
+ * @see docs/specs/SIGNALDOCK-UNIFIED-AGENT-REGISTRY.md Section 3.4
+ * @see .cleo/adrs/ADR-035-pi-v2-v3-harness.md §D5
+ * @task T178
+ */
+export declare const agentCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/cli/commands/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AA01FH;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,qDAoCvB,CAAC"}