@cleocode/cleo 2026.4.58 → 2026.4.59

package/dist/cli/commands/agent-profile-status.js

@@ -0,0 +1,71 @@
+/**
+ * Pure helper for computing the human-readable `profile` status string
+ * surfaced by `cleo agent start`.
+ *
+ * Extracted from `agent.ts` so it can be unit-tested without spinning up
+ * the full daemon, the SignalDock registry, or the Pi runtime. The
+ * helper has zero side effects and accepts only plain inputs — that is
+ * the entire point of pulling it out.
+ *
+ * **Daemon vs. Pi session.** The status this helper produces describes
+ * what `cleo agent start` did with the on-disk `.cant` profile file. It
+ * is purely informational. The daemon NEVER interprets the profile —
+ * profile-driven workflow execution lives inside the Pi extension at
+ * `packages/cleo/templates/cleoos-hub/pi-extensions/cant-bridge.ts`,
+ * not inside the daemon process. See ADR-035 §D5 (Option Y addendum)
+ * for the rationale.
+ *
+ * @see ../commands/agent.ts
+ * @see .cleo/adrs/ADR-035-pi-v2-v3-harness.md §D5 + Addendum
+ *
+ * @packageDocumentation
+ */
+/**
+ * Compute the human-readable profile status string for the
+ * `cleo agent start` command output.
+ *
+ * @remarks
+ * This is a pure function with three branches:
+ *
+ * 1. `profile === null` → `'none'` — no file existed at the resolved path.
+ * 2. `validation === null` → `'loaded (unvalidated)'` — file was read
+ *    but the optional validator was not available.
+ * 3. `validation.valid === true` → `'validated'`
+ * 4. `validation.valid === false` → `` `invalid (${N} errors)` ``
+ *    where N is `validation.errors.length`.
+ *
+ * The function NEVER consults `createRuntime`, the registry, or any
+ * other side-effecting subsystem. It exists exactly so the
+ * profile-status branch can be exercised in unit tests without booting
+ * the daemon.
+ *
+ * @param profile - The contents of the `.cant` file, or `null` when no
+ *   file was present at the resolved path.
+ * @param validation - The result of running `@cleocode/cant`'s
+ *   `validate()` against `profile`, or `null` when the validator was
+ *   not available in the current build.
+ * @returns A status string suitable for the `profile` field of the
+ *   `cleo agent start` LAFS envelope.
+ *
+ * @example
+ * ```typescript
+ * computeProfileStatus(null, null);                        // 'none'
+ * computeProfileStatus('agent foo:', null);                // 'loaded (unvalidated)'
+ * computeProfileStatus('agent foo:', { valid: true, errors: [] });
+ * // 'validated'
+ * computeProfileStatus('agent foo:', { valid: false, errors: ['e1', 'e2'] });
+ * // 'invalid (2 errors)'
+ * ```
+ *
+ * @public
+ */
+export function computeProfileStatus(profile, validation) {
+    if (profile === null)
+        return 'none';
+    if (validation === null)
+        return 'loaded (unvalidated)';
+    if (validation.valid)
+        return 'validated';
+    return `invalid (${validation.errors.length} errors)`;
+}
+//# sourceMappingURL=agent-profile-status.js.map

package/dist/cli/commands/agent-profile-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-profile-status.js","sourceRoot":"","sources":["../../../src/cli/commands/agent-profile-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA2CH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAsB,EACtB,UAAoC;IAEpC,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACpC,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,sBAAsB,CAAC;IACvD,IAAI,UAAU,CAAC,KAAK;QAAE,OAAO,WAAW,CAAC;IACzC,OAAO,YAAY,UAAU,CAAC,MAAM,CAAC,MAAM,UAAU,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,41 @@
+/**
+ * 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
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the `cleo agent` command group.
+ */
+export declare function registerAgentCommand(program: Command): void;
+//# 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;AASH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAInE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqrE3D"}