@cleocode/cleo-os 2026.4.64 → 2026.4.66

package/dist/cli.js

@@ -13,6 +13,8 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { AgentRegistry } from './registry/agent-registry.js';
+import { ProviderMatrix } from './registry/provider-matrix.js';
 import { resolveCleoOsPaths } from './xdg.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 /**
@@ -61,6 +63,55 @@ function handleVersionFlags(args) {
     }
     return false;
 }
+/**
+ * Handle CleoOS sovereignty-surface diagnostic flags before delegating to Pi.
+ *
+ * These flags surface the harness sovereignty modules (ADR-050) without
+ * requiring a full Pi startup — useful for scripts, CI probes, and the
+ * future `cleo-os doctor` command.
+ *
+ * - `--providers` / `cleoos providers`: prints the provider matrix (which of
+ *   the 9 adapters are installed, have spawn implementations, and their
+ *   hook-event counts).
+ * - `--agents` / `cleoos agents`: prints the agent registry (seed agents
+ *   bundled with CleoOS + user agents discovered in provider paths).
+ *
+ * @param args - User-supplied CLI arguments.
+ * @returns `true` if a diagnostic flag was handled, `false` otherwise.
+ */
+async function handleDiagnosticsFlags(args) {
+    const wantProviders = args.includes('--providers') || args[0] === 'providers';
+    const wantAgents = args.includes('--agents') || args[0] === 'agents';
+    if (wantProviders) {
+        const matrix = new ProviderMatrix();
+        const rows = await matrix.getMatrix();
+        console.log('CleoOS Provider Matrix (ADR-050)');
+        console.log('═══════════════════════════════════════════════════════════');
+        console.log(`  ${'provider'.padEnd(18)} ${'installed'.padEnd(10)} ${'spawn'.padEnd(7)} ${'hooks'.padEnd(5)} adapter`);
+        console.log('  ─────────────────────────────────────────────────────────');
+        for (const r of rows) {
+            const installed = r.installed ? 'yes' : 'no';
+            const spawn = r.spawnImplemented ? 'yes' : 'stub';
+            console.log(`  ${r.providerId.padEnd(18)} ${installed.padEnd(10)} ${spawn.padEnd(7)} ${String(r.hookSupport).padEnd(5)} ${r.adapterClass}`);
+        }
+        return true;
+    }
+    if (wantAgents) {
+        const registry = new AgentRegistry();
+        const agents = await registry.listAll();
+        console.log('CleoOS Agent Registry (ADR-050)');
+        console.log('═══════════════════════════════════════════════════════════');
+        if (agents.length === 0) {
+            console.log('  (no agents found — run `cleo admin install-global` to seed)');
+            return true;
+        }
+        for (const a of agents) {
+            console.log(`  [${a.source.padEnd(4)}] ${a.id.padEnd(28)} ${a.provider.padEnd(14)} ${a.name}`);
+        }
+        return true;
+    }
+    return false;
+}
 /**
  * Collect CleoOS extension paths that exist on disk.
  *
@@ -128,6 +179,11 @@ async function main() {
     if (handleVersionFlags(userArgs)) {
         return;
     }
+    // Intercept sovereignty diagnostic flags (ADR-050) before touching Pi.
+    // These surface the CleoOS-specific harness layer without a Pi startup.
+    if (await handleDiagnosticsFlags(userArgs)) {
+        return;
+    }
     // Dynamically import Pi — it's a peerDependency, may not be installed
     let piMain;
     try {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,eAAuB;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;QACpD,OAAO,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,kBAAkB,CAAC,IAAc;IACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpC,kEAAkE;QAClE,IAAI,WAAW,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CACtB,SAAS,EACT,IAAI,EACJ,cAAc,EACd,WAAW,EACX,MAAM,EACN,cAAc,CACf,CAAC;YACF,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,aAAa,WAAW,EAAE,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,qBAAqB;IAC5B,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IAC9D,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;IACjE,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,0EAA0E;IAC1E,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;IACvE,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,2CAA2C;IAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;IACpE,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,SAAS,CAAC,QAAkB,EAAE,cAAwB;IAC7D,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,cAAc,EAAE,GAAG,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,IAAI;IACjB,yEAAyE;IACzE,yEAAyE;IACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,OAAO;IACT,CAAC;IAED,sEAAsE;IACtE,IAAI,MAAyC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;QACzD,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CACX,oDAAoD;YAClD,qDAAqD;YACrD,wBAAwB,CAC3B,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAEjD,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/policies/memory-policy.d.ts

@@ -0,0 +1,134 @@
+/**
+ * CleoOS Memory Policy — governs what gets written to `brain.db`.
+ *
+ * Enforces owner learning L-fe4ba2dc: *"Chat logs are NOT memory. Real memory
+ * is extracted artifacts — patterns, decisions, learnings. Raw conversation
+ * history should never be stored directly in brain.db."*
+ *
+ * The default policy allows structured memory types (`observation`, `decision`,
+ * `pattern`, `learning`) and rejects raw transcript types (`chatlog`,
+ * `transcript`). The policy is configurable via `MemoryPolicyConfig` for
+ * extension without adding feature toggles to the skeleton.
+ *
+ * @see ADR-050 — CleoOS Sovereign Harness: Distribution Binding Charter
+ * @see D008 — 7-technique memory architecture (owner decision 2026-04-13)
+ * @see L-fe4ba2dc — Chat logs are NOT memory
+ * @task T640
+ * @epic T636
+ * @packageDocumentation
+ */
+/**
+ * Discriminated union of memory item types recognised by the CleoOS memory gate.
+ *
+ * @remarks
+ * The `chatlog` and `transcript` variants exist to allow callers to explicitly
+ * pass raw conversation data through the policy — which will then be rejected
+ * with a human-readable reason. This makes the rejection point observable
+ * rather than silent.
+ */
+export type MemoryItemType = 'observation' | 'decision' | 'pattern' | 'learning' | 'chatlog' | 'transcript';
+/**
+ * A candidate item for storage in `brain.db`.
+ *
+ * The `type` field is the primary discriminant used by `MemoryPolicy.shouldStore()`.
+ * The `text` field is the raw content. `metadata` carries any supplementary
+ * structured data (source, confidence, timestamps, etc.).
+ */
+export interface MemoryItem {
+    /** Semantic classification of this memory item. */
+    type: MemoryItemType;
+    /** Raw text content of the memory item. */
+    text: string;
+    /**
+     * Optional supplementary metadata.
+     *
+     * Callers may include fields such as `source`, `confidence`, `taskId`, or
+     * `timestamp`. The policy does not inspect metadata when making its decision —
+     * type and text alone are sufficient for the current skeleton.
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Configuration object for `MemoryPolicy`.
+ *
+ * All fields are optional; the default values implement the owner-mandated
+ * L-fe4ba2dc rule. Override only when a specific distribution profile needs
+ * different behaviour (e.g. a development harness that stores transcripts for
+ * debugging — explicitly opt-in, not on by default).
+ */
+export interface MemoryPolicyConfig {
+    /**
+     * Set of `MemoryItemType` values that are ALLOWED through the gate.
+     *
+     * Defaults to `['observation', 'decision', 'pattern', 'learning']`.
+     * Items whose type is NOT in this set are rejected.
+     */
+    allowedTypes: ReadonlySet<MemoryItemType>;
+    /**
+     * Minimum character length for `item.text` to be stored.
+     *
+     * Items with text shorter than this threshold are rejected as likely noise.
+     * Defaults to `10`.
+     */
+    minTextLength: number;
+}
+/**
+ * Gate that decides whether a memory item should be written to `brain.db`.
+ *
+ * @remarks
+ * Owner learning L-fe4ba2dc (2026-04-13):
+ * *"Chat logs are NOT memory. Real memory is extracted artifacts — patterns,
+ * decisions, learnings. Raw conversation history should never be stored
+ * directly in brain.db. The extraction pipeline (extraction→consolidation→
+ * retrieval) must transform raw transcripts into structured knowledge before
+ * storage."*
+ *
+ * The default configuration enforces this rule. Override via
+ * `MemoryPolicyConfig` for specialised distribution profiles.
+ *
+ * @example
+ * ```ts
+ * const policy = new MemoryPolicy();
+ *
+ * const obs: MemoryItem = { type: 'observation', text: 'File walker now handles symlinks' };
+ * policy.shouldStore(obs); // true
+ *
+ * const log: MemoryItem = { type: 'chatlog', text: 'User: how does this work?' };
+ * policy.shouldStore(log); // false
+ * policy.reason(log);      // "chatlog items are excluded: store extracted artifacts, not raw chat history"
+ * ```
+ */
+export declare class MemoryPolicy {
+    private readonly config;
+    /**
+     * Construct a `MemoryPolicy` with optional configuration overrides.
+     *
+     * @param config - Partial overrides merged with {@link DEFAULT_POLICY_CONFIG}.
+     *   Omitted fields retain their defaults.
+     */
+    constructor(config?: Partial<MemoryPolicyConfig>);
+    /**
+     * Return `true` if `item` should be stored in `brain.db`.
+     *
+     * Applies two checks in order:
+     * 1. **Type gate** — item type must be in `config.allowedTypes`.
+     * 2. **Length gate** — `item.text.length` must meet `config.minTextLength`.
+     *
+     * Both checks must pass for `shouldStore` to return `true`.
+     *
+     * @param item - Candidate memory item to evaluate.
+     * @returns Whether the item passes the memory gate.
+     */
+    shouldStore(item: MemoryItem): boolean;
+    /**
+     * Return a human-readable explanation of the policy decision for `item`.
+     *
+     * Always returns a string — callers can surface this in logs or diagnostic
+     * output regardless of whether `shouldStore` returned `true` or `false`.
+     *
+     * @param item - Memory item to explain the policy decision for.
+     * @returns Human-readable rationale string.
+     */
+    reason(item: MemoryItem): string;
+}
+//# sourceMappingURL=memory-policy.d.ts.map

package/dist/policies/memory-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-policy.d.ts","sourceRoot":"","sources":["../../src/policies/memory-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,YAAY,CAAC;AAEjB;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,IAAI,EAAE,cAAc,CAAC;IACrB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAuBD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C;;;;;OAKG;gBACS,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC;IAOhD;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAUtC;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;CAejC"}

package/dist/policies/memory-policy.js

@@ -0,0 +1,120 @@
+/**
+ * CleoOS Memory Policy — governs what gets written to `brain.db`.
+ *
+ * Enforces owner learning L-fe4ba2dc: *"Chat logs are NOT memory. Real memory
+ * is extracted artifacts — patterns, decisions, learnings. Raw conversation
+ * history should never be stored directly in brain.db."*
+ *
+ * The default policy allows structured memory types (`observation`, `decision`,
+ * `pattern`, `learning`) and rejects raw transcript types (`chatlog`,
+ * `transcript`). The policy is configurable via `MemoryPolicyConfig` for
+ * extension without adding feature toggles to the skeleton.
+ *
+ * @see ADR-050 — CleoOS Sovereign Harness: Distribution Binding Charter
+ * @see D008 — 7-technique memory architecture (owner decision 2026-04-13)
+ * @see L-fe4ba2dc — Chat logs are NOT memory
+ * @task T640
+ * @epic T636
+ * @packageDocumentation
+ */
+// ---------------------------------------------------------------------------
+// Default configuration
+// ---------------------------------------------------------------------------
+/**
+ * Default memory policy configuration.
+ *
+ * @remarks
+ * Implements owner learning L-fe4ba2dc: chat logs and transcripts are
+ * categorically excluded from `brain.db`. Only extracted, typed memory
+ * artifacts pass through.
+ */
+const DEFAULT_POLICY_CONFIG = {
+    allowedTypes: new Set(['observation', 'decision', 'pattern', 'learning']),
+    minTextLength: 10,
+};
+// ---------------------------------------------------------------------------
+// MemoryPolicy
+// ---------------------------------------------------------------------------
+/**
+ * Gate that decides whether a memory item should be written to `brain.db`.
+ *
+ * @remarks
+ * Owner learning L-fe4ba2dc (2026-04-13):
+ * *"Chat logs are NOT memory. Real memory is extracted artifacts — patterns,
+ * decisions, learnings. Raw conversation history should never be stored
+ * directly in brain.db. The extraction pipeline (extraction→consolidation→
+ * retrieval) must transform raw transcripts into structured knowledge before
+ * storage."*
+ *
+ * The default configuration enforces this rule. Override via
+ * `MemoryPolicyConfig` for specialised distribution profiles.
+ *
+ * @example
+ * ```ts
+ * const policy = new MemoryPolicy();
+ *
+ * const obs: MemoryItem = { type: 'observation', text: 'File walker now handles symlinks' };
+ * policy.shouldStore(obs); // true
+ *
+ * const log: MemoryItem = { type: 'chatlog', text: 'User: how does this work?' };
+ * policy.shouldStore(log); // false
+ * policy.reason(log);      // "chatlog items are excluded: store extracted artifacts, not raw chat history"
+ * ```
+ */
+export class MemoryPolicy {
+    config;
+    /**
+     * Construct a `MemoryPolicy` with optional configuration overrides.
+     *
+     * @param config - Partial overrides merged with {@link DEFAULT_POLICY_CONFIG}.
+     *   Omitted fields retain their defaults.
+     */
+    constructor(config) {
+        this.config = {
+            allowedTypes: config?.allowedTypes ?? DEFAULT_POLICY_CONFIG.allowedTypes,
+            minTextLength: config?.minTextLength ?? DEFAULT_POLICY_CONFIG.minTextLength,
+        };
+    }
+    /**
+     * Return `true` if `item` should be stored in `brain.db`.
+     *
+     * Applies two checks in order:
+     * 1. **Type gate** — item type must be in `config.allowedTypes`.
+     * 2. **Length gate** — `item.text.length` must meet `config.minTextLength`.
+     *
+     * Both checks must pass for `shouldStore` to return `true`.
+     *
+     * @param item - Candidate memory item to evaluate.
+     * @returns Whether the item passes the memory gate.
+     */
+    shouldStore(item) {
+        if (!this.config.allowedTypes.has(item.type)) {
+            return false;
+        }
+        if (item.text.length < this.config.minTextLength) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Return a human-readable explanation of the policy decision for `item`.
+     *
+     * Always returns a string — callers can surface this in logs or diagnostic
+     * output regardless of whether `shouldStore` returned `true` or `false`.
+     *
+     * @param item - Memory item to explain the policy decision for.
+     * @returns Human-readable rationale string.
+     */
+    reason(item) {
+        if (!this.config.allowedTypes.has(item.type)) {
+            return (`${item.type} items are excluded: store extracted artifacts, not raw ` +
+                `${item.type === 'chatlog' || item.type === 'transcript' ? 'chat history' : 'unstructured content'}`);
+        }
+        if (item.text.length < this.config.minTextLength) {
+            return (`text too short (${item.text.length} chars < minimum ${this.config.minTextLength}): ` +
+                `likely noise or empty observation`);
+        }
+        return `${item.type} item accepted (${item.text.length} chars)`;
+    }
+}
+//# sourceMappingURL=memory-policy.js.map

package/dist/policies/memory-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-policy.js","sourceRoot":"","sources":["../../src/policies/memory-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAsEH,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,qBAAqB,GAAuB;IAChD,YAAY,EAAE,IAAI,GAAG,CAAiB,CAAC,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACzF,aAAa,EAAE,EAAE;CAClB,CAAC;AAEF,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,YAAY;IACN,MAAM,CAAqB;IAE5C;;;;;OAKG;IACH,YAAY,MAAoC;QAC9C,IAAI,CAAC,MAAM,GAAG;YACZ,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,qBAAqB,CAAC,YAAY;YACxE,aAAa,EAAE,MAAM,EAAE,aAAa,IAAI,qBAAqB,CAAC,aAAa;SAC5E,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,IAAgB;QAC1B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAgB;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,OAAO,CACL,GAAG,IAAI,CAAC,IAAI,0DAA0D;gBACtE,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,sBAAsB,EAAE,CACrG,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YACjD,OAAO,CACL,mBAAmB,IAAI,CAAC,IAAI,CAAC,MAAM,oBAAoB,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK;gBACrF,mCAAmC,CACpC,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,IAAI,mBAAmB,IAAI,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC;IAClE,CAAC;CACF"}

package/dist/registry/agent-registry.d.ts

@@ -0,0 +1,106 @@
+/**
+ * CleoOS Agent Registry — catalog of installed agents across all provider adapters.
+ *
+ * Discovers agents from two sources:
+ *   1. **Seed agents** — bundled with CleoOS in `packages/cleo-os/seed-agents/`.
+ *   2. **User agents** — installed by individual provider adapters into their
+ *      provider-specific agent directories (e.g. `~/.claude/agents/`).
+ *
+ * This module is read-only. It does not install, remove, or modify agents.
+ * Provider adapter logic stays in `packages/adapters/`. CleoOS consumes the
+ * filesystem artifacts that adapters produce.
+ *
+ * @remarks
+ * Long-term: `loadUserAgents()` should call `adapter.paths?.getAgentInstallDir()`
+ * dynamically once T639 exposes the provider-folder contract. For now the 9 paths
+ * are hard-coded from each provider's `AdapterPathProvider` defaults.
+ *
+ * @see ADR-050 — CleoOS Sovereign Harness: Distribution Binding Charter
+ * @task T640
+ * @epic T636
+ * @packageDocumentation
+ */
+/**
+ * A single agent known to the CleoOS agent catalog.
+ *
+ * Agents are discovered at runtime from seed directories and provider-specific
+ * agent installation folders. The `source` discriminant distinguishes bundled
+ * agents from user-installed ones.
+ */
+export interface AgentDefinition {
+    /** Stable unique identifier for this agent (derived from file name sans extension). */
+    id: string;
+    /** Human-readable display name (defaults to `id` when no metadata is available). */
+    name: string;
+    /**
+     * Provider that manages this agent's execution context.
+     *
+     * One of the 9 known CLEO provider IDs: `"claude-code"`, `"claude-sdk"`,
+     * `"codex"`, `"cursor"`, `"gemini-cli"`, `"kimi"`, `"openai-sdk"`,
+     * `"opencode"`, `"pi"`. Seed agents use `"cleo-os"`.
+     */
+    provider: string;
+    /** Absolute path to the agent definition file on disk. */
+    path: string;
+    /**
+     * Free-form capability tags describing what this agent can do.
+     *
+     * Common values: `"spawn"`, `"orchestrate"`, `"memory"`, `"review"`, `"test"`.
+     * May be empty when no metadata file is available.
+     */
+    capabilities: string[];
+    /**
+     * Origin of this agent definition.
+     *
+     * - `"seed"` — bundled with CleoOS under `packages/cleo-os/seed-agents/`
+     * - `"user"` — installed by a provider adapter into its agent directory
+     */
+    source: 'seed' | 'user';
+}
+/**
+ * Read-only catalog of CleoOS agents discovered across all provider adapters.
+ *
+ * Combines seed agents (bundled with CleoOS) with user-installed agents from
+ * each of the 9 provider adapter directories. Results are deduplicated by
+ * `path` — a path present in both sources appears once as `"seed"`.
+ *
+ * @example
+ * ```ts
+ * const registry = new AgentRegistry();
+ * const all = await registry.listAll();
+ * console.log(all.length, 'agents discovered');
+ * ```
+ */
+export declare class AgentRegistry {
+    /**
+     * Load seed agents bundled with CleoOS.
+     *
+     * Reads `packages/cleo-os/seed-agents/` and returns one `AgentDefinition`
+     * per agent file found. Returns an empty array when the directory is absent
+     * or empty (the directory is created during T640 but initially unpopulated).
+     *
+     * @returns Array of seed agent definitions; empty if none are installed.
+     */
+    loadSeedAgents(): Promise<AgentDefinition[]>;
+    /**
+     * Load user-installed agents from all known provider agent directories.
+     *
+     * Iterates the 9 provider adapter directories and returns one
+     * `AgentDefinition` per agent file found. Directories that do not exist
+     * or are unreadable are silently skipped.
+     *
+     * @returns Array of user agent definitions across all providers.
+     */
+    loadUserAgents(): Promise<AgentDefinition[]>;
+    /**
+     * Return all known agents — seed agents followed by user-installed agents.
+     *
+     * Seed agents take precedence: if the same absolute path appears in both
+     * sources (uncommon but possible in development), the seed entry wins and
+     * the user entry is omitted.
+     *
+     * @returns Deduplicated array of all discovered agent definitions.
+     */
+    listAll(): Promise<AgentDefinition[]>;
+}
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/registry/agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../../src/registry/agent-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAcH;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,EAAE,EAAE,MAAM,CAAC;IACX,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAuFD;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAa;IACxB;;;;;;;;OAQG;IACG,cAAc,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAelD;;;;;;;;OAQG;IACG,cAAc,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAqBlD;;;;;;;;OAQG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;CAY5C"}

package/dist/registry/agent-registry.js

@@ -0,0 +1,195 @@
+/**
+ * CleoOS Agent Registry — catalog of installed agents across all provider adapters.
+ *
+ * Discovers agents from two sources:
+ *   1. **Seed agents** — bundled with CleoOS in `packages/cleo-os/seed-agents/`.
+ *   2. **User agents** — installed by individual provider adapters into their
+ *      provider-specific agent directories (e.g. `~/.claude/agents/`).
+ *
+ * This module is read-only. It does not install, remove, or modify agents.
+ * Provider adapter logic stays in `packages/adapters/`. CleoOS consumes the
+ * filesystem artifacts that adapters produce.
+ *
+ * @remarks
+ * Long-term: `loadUserAgents()` should call `adapter.paths?.getAgentInstallDir()`
+ * dynamically once T639 exposes the provider-folder contract. For now the 9 paths
+ * are hard-coded from each provider's `AdapterPathProvider` defaults.
+ *
+ * @see ADR-050 — CleoOS Sovereign Harness: Distribution Binding Charter
+ * @task T640
+ * @epic T636
+ * @packageDocumentation
+ */
+import { existsSync } from 'node:fs';
+import { readdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Absolute path to the CleoOS seed-agents directory.
+ *
+ * Located at `packages/cleo-os/seed-agents/` relative to this source file's
+ * compiled output (`dist/registry/`), so we go up two levels from `__dirname`.
+ */
+const SEED_AGENTS_DIR = join(__dirname, '..', '..', 'seed-agents');
+/**
+ * Known provider IDs and their default agent installation directories.
+ *
+ * Derived from each provider's `AdapterPathProvider.getAgentInstallDir()` defaults.
+ * Update here when a provider changes its agent directory structure.
+ *
+ * @remarks
+ * Long-term replacement: call `adapter.paths?.getAgentInstallDir()` once T639
+ * exposes the provider-folder contract via a dynamic registry surface.
+ */
+const PROVIDER_AGENT_DIRS = [
+    { providerId: 'claude-code', dir: join(homedir(), '.claude', 'agents') },
+    { providerId: 'claude-sdk', dir: join(homedir(), '.claude', 'agents') },
+    { providerId: 'codex', dir: join(homedir(), '.codex', 'agents') },
+    { providerId: 'cursor', dir: join(homedir(), '.cursor', 'agents') },
+    { providerId: 'gemini-cli', dir: join(homedir(), '.gemini', 'agents') },
+    { providerId: 'kimi', dir: join(homedir(), '.kimi', 'agents') },
+    { providerId: 'openai-sdk', dir: join(homedir(), '.openai', 'agents') },
+    { providerId: 'opencode', dir: join(homedir(), '.opencode', 'agents') },
+    { providerId: 'pi', dir: join(homedir(), '.pi', 'agents') },
+];
+/**
+ * File extensions recognised as agent definition files.
+ *
+ * Excludes README.md and other documentation files in seed-agents/.
+ */
+const AGENT_EXTENSIONS = new Set(['.md', '.json', '.yaml', '.yml', '.ts', '.js']);
+/**
+ * Derive a stable agent `id` from a file name by stripping the extension.
+ *
+ * @param fileName - Base file name (e.g. `"cleo-prime.md"`).
+ * @returns ID string (e.g. `"cleo-prime"`).
+ */
+function idFromFileName(fileName) {
+    const dot = fileName.lastIndexOf('.');
+    return dot > 0 ? fileName.slice(0, dot) : fileName;
+}
+/**
+ * Read agent file names from a directory, returning an empty array when the
+ * directory does not exist or cannot be read.
+ *
+ * Filters to known agent file extensions and skips `README` files.
+ *
+ * @param dir - Absolute path to the directory to scan.
+ * @returns Array of base file names matching the agent extension filter.
+ */
+async function readAgentFileNames(dir) {
+    if (!existsSync(dir)) {
+        return [];
+    }
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isFile())
+            .map((e) => e.name)
+            .filter((name) => {
+            const dot = name.lastIndexOf('.');
+            if (dot < 0)
+                return false;
+            const ext = name.slice(dot);
+            return AGENT_EXTENSIONS.has(ext) && !name.toLowerCase().startsWith('readme');
+        });
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// AgentRegistry
+// ---------------------------------------------------------------------------
+/**
+ * Read-only catalog of CleoOS agents discovered across all provider adapters.
+ *
+ * Combines seed agents (bundled with CleoOS) with user-installed agents from
+ * each of the 9 provider adapter directories. Results are deduplicated by
+ * `path` — a path present in both sources appears once as `"seed"`.
+ *
+ * @example
+ * ```ts
+ * const registry = new AgentRegistry();
+ * const all = await registry.listAll();
+ * console.log(all.length, 'agents discovered');
+ * ```
+ */
+export class AgentRegistry {
+    /**
+     * Load seed agents bundled with CleoOS.
+     *
+     * Reads `packages/cleo-os/seed-agents/` and returns one `AgentDefinition`
+     * per agent file found. Returns an empty array when the directory is absent
+     * or empty (the directory is created during T640 but initially unpopulated).
+     *
+     * @returns Array of seed agent definitions; empty if none are installed.
+     */
+    async loadSeedAgents() {
+        const fileNames = await readAgentFileNames(SEED_AGENTS_DIR);
+        return fileNames.map((fileName) => {
+            const id = idFromFileName(fileName);
+            return {
+                id,
+                name: id,
+                provider: 'cleo-os',
+                path: join(SEED_AGENTS_DIR, fileName),
+                capabilities: [],
+                source: 'seed',
+            };
+        });
+    }
+    /**
+     * Load user-installed agents from all known provider agent directories.
+     *
+     * Iterates the 9 provider adapter directories and returns one
+     * `AgentDefinition` per agent file found. Directories that do not exist
+     * or are unreadable are silently skipped.
+     *
+     * @returns Array of user agent definitions across all providers.
+     */
+    async loadUserAgents() {
+        const results = [];
+        for (const { providerId, dir } of PROVIDER_AGENT_DIRS) {
+            const fileNames = await readAgentFileNames(dir);
+            for (const fileName of fileNames) {
+                const id = idFromFileName(fileName);
+                results.push({
+                    id,
+                    name: id,
+                    provider: providerId,
+                    path: join(dir, fileName),
+                    capabilities: [],
+                    source: 'user',
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Return all known agents — seed agents followed by user-installed agents.
+     *
+     * Seed agents take precedence: if the same absolute path appears in both
+     * sources (uncommon but possible in development), the seed entry wins and
+     * the user entry is omitted.
+     *
+     * @returns Deduplicated array of all discovered agent definitions.
+     */
+    async listAll() {
+        const [seed, user] = await Promise.all([this.loadSeedAgents(), this.loadUserAgents()]);
+        const seenPaths = new Set(seed.map((a) => a.path));
+        const deduped = user.filter((a) => {
+            if (seenPaths.has(a.path))
+                return false;
+            seenPaths.add(a.path);
+            return true;
+        });
+        return [...seed, ...deduped];
+    }
+}
+//# sourceMappingURL=agent-registry.js.map