@getbourdon/participants 0.1.1 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getbourdon/participants",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Bourdon participants — the external-agent → L5 reader layer (BUSL-1.1). Each participant normalizes a foreign agent's native memory store into a visibility-filtered, redacted L5 manifest: read-only SQLite readers (better-sqlite3 mode=ro: hermes), file/convention readers (claude-code), and network readers (github-copilot) with a TTL JSON cache + lazy AuthProvider that never persists a token. Four invariants enforced in code, not by trust: visibility-filter-before-emission, deterministic exportL5, healthCheck never throws, redact every native string. Discovery is a static TS registry (agent_id-sorted, first-wins, log-and-skip) replacing Python's pkgutil scan. Python (pip install bourdon) is the oracle; this mirror asserts against @getbourdon/conformance native_stores fixtures.",
   "license": "BUSL-1.1",
   "type": "module",
@@ -29,23 +29,24 @@
   "homepage": "https://bourdon.ai",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/getbourdon/bourdon-js.git",
+    "url": "git+https://gitlab.com/getbourdon/bourdon-js.git",
     "directory": "packages/participants"
   },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
+  },
   "dependencies": {
-    "yaml": "^2.6.1",
-    "@getbourdon/l5": "0.1.1",
-    "@getbourdon/redaction": "0.1.1"
+    "@getbourdon/l5": "workspace:*",
+    "@getbourdon/redaction": "workspace:*",
+    "smol-toml": "^1.7.0",
+    "yaml": "^2.6.1"
   },
   "optionalDependencies": {
     "better-sqlite3": "^12.2.0"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.12",
-    "@getbourdon/conformance": "0.1.0"
-  },
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run"
+    "@getbourdon/conformance": "workspace:*",
+    "@types/better-sqlite3": "^7.6.12"
   }
-}
+}

package/dist/base.d.ts

@@ -1,81 +0,0 @@
-/**
- * Bourdon participant base — the Protocol → TS interface, errors, and the
- * AgentStore / HealthStatus types. Faithful port of `participants/base.py`.
- *
- * The L5 dataclass model (AgentInfo/Entity/Session/VisibilityPolicy/L5Manifest),
- * the `toDict` omission rules, and the visibility helpers all live in
- * `@getbourdon/l5` and are reused verbatim — only THAT output shape is the parity
- * contract. This module owns the participant CONTRACT surface around them.
- *
- * Contract semantics (enforced by every reader, asserted by the conformance
- * fixtures, never by trust):
- *   1. visibility filter BEFORE emission (`filterForFederation`) — private wins.
- *   2. deterministic / idempotent `exportL5` — same store → identical `toDict`.
- *   3. `healthCheck` NEVER throws — catch-all → degraded/blocked.
- *   4. every native string through `@getbourdon/redaction` before it enters L5.
- */
-import type { L5ManifestModel, SessionModel } from "@getbourdon/l5";
-/** Tied to Bourdon spec v0.1 — same literals as the Python oracle. */
-export declare const CONTRACT_VERSION = "0.1";
-export declare const SPEC_VERSION = "0.1";
-/** Base class for participant errors. */
-export declare class ParticipantError extends Error {
-    constructor(message?: string);
-}
-/** Raised by `discover()` when the native store cannot be found or read.
- * Non-fatal: L6 skips this agent rather than aborting the whole export. */
-export declare class ParticipantDiscoveryError extends ParticipantError {
-}
-/** Raised by `exportL5()` / `exportSessions()` when an export fails mid-op
- * (the store WAS present — distinct from a discovery miss). */
-export declare class ParticipantExportError extends ParticipantError {
-}
-/** Raised when the native store's version is outside the supported range.
- * Subtype of discovery error (a version mismatch is a discovery-time miss). */
-export declare class ParticipantVersionMismatchError extends ParticipantDiscoveryError {
-}
-/** Metadata describing the native agent store. Returned by `discover()`. */
-export interface AgentStore {
-    path: string;
-    version: string;
-    metadata: Record<string, unknown>;
-}
-/** Returned by `healthCheck()`. Consumed by the `bourdon doctor` CLI. */
-export interface HealthStatus {
-    status: "ok" | "degraded" | "blocked";
-    reason?: string;
-    details: Record<string, unknown>;
-    /** A human-runnable command to remedy a non-ok status. */
-    proposedFix?: string;
-}
-/**
- * Structural interface every participant must satisfy (the Python
- * `@runtime_checkable Protocol`). Duck-typed at registration: a class is a
- * participant iff it has `agentId` + `agentType` + `exportL5` + `healthCheck`.
- *
- * Optional members (`displayName`, a `defaultNativePath` static) are documented
- * here as in the Python Protocol; discovery + the setup wizard fall back to
- * sensible defaults when absent.
- */
-export interface BourdonParticipant {
-    agentId: string;
-    agentType: string;
-    nativePath: string;
-    /** Human-friendly label (e.g. "GitHub Copilot"). Optional. */
-    displayName?: string;
-    /** Confirm the native store exists; return metadata. Throws
-     * {@link ParticipantDiscoveryError} when missing/unreadable. */
-    discover(): AgentStore;
-    /** Build the L5 manifest from native memory, applying the visibility filter
-     * BEFORE return. Deterministic — same store yields the same manifest. */
-    exportL5(since?: Date): L5ManifestModel;
-    /** Export recent sessions in normalized schema. */
-    exportSessions(since?: Date, limit?: number): SessionModel[];
-    /** Return ok / degraded / blocked with a reason. MUST NOT throw. */
-    healthCheck(): HealthStatus;
-}
-/**
- * Tiny structural guard mirroring Python's `_PARTICIPANT_MARKER_ATTRS`
- * duck-type: a value is a participant iff it carries the four marker members.
- */
-export declare function isParticipant(obj: unknown): obj is BourdonParticipant;

package/dist/base.js

@@ -1,52 +0,0 @@
-/**
- * Bourdon participant base — the Protocol → TS interface, errors, and the
- * AgentStore / HealthStatus types. Faithful port of `participants/base.py`.
- *
- * The L5 dataclass model (AgentInfo/Entity/Session/VisibilityPolicy/L5Manifest),
- * the `toDict` omission rules, and the visibility helpers all live in
- * `@getbourdon/l5` and are reused verbatim — only THAT output shape is the parity
- * contract. This module owns the participant CONTRACT surface around them.
- *
- * Contract semantics (enforced by every reader, asserted by the conformance
- * fixtures, never by trust):
- *   1. visibility filter BEFORE emission (`filterForFederation`) — private wins.
- *   2. deterministic / idempotent `exportL5` — same store → identical `toDict`.
- *   3. `healthCheck` NEVER throws — catch-all → degraded/blocked.
- *   4. every native string through `@getbourdon/redaction` before it enters L5.
- */
-/** Tied to Bourdon spec v0.1 — same literals as the Python oracle. */
-export const CONTRACT_VERSION = "0.1";
-export const SPEC_VERSION = "0.1";
-// -- Errors -------------------------------------------------------------------
-/** Base class for participant errors. */
-export class ParticipantError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = new.target.name;
-    }
-}
-/** Raised by `discover()` when the native store cannot be found or read.
- * Non-fatal: L6 skips this agent rather than aborting the whole export. */
-export class ParticipantDiscoveryError extends ParticipantError {
-}
-/** Raised by `exportL5()` / `exportSessions()` when an export fails mid-op
- * (the store WAS present — distinct from a discovery miss). */
-export class ParticipantExportError extends ParticipantError {
-}
-/** Raised when the native store's version is outside the supported range.
- * Subtype of discovery error (a version mismatch is a discovery-time miss). */
-export class ParticipantVersionMismatchError extends ParticipantDiscoveryError {
-}
-/**
- * Tiny structural guard mirroring Python's `_PARTICIPANT_MARKER_ATTRS`
- * duck-type: a value is a participant iff it carries the four marker members.
- */
-export function isParticipant(obj) {
-    if (obj === null || typeof obj !== "object")
-        return false;
-    const o = obj;
-    return (typeof o["agentId"] === "string" &&
-        typeof o["agentType"] === "string" &&
-        typeof o["exportL5"] === "function" &&
-        typeof o["healthCheck"] === "function");
-}

package/dist/network-base.d.ts

@@ -1,108 +0,0 @@
-/**
- * Network-shaped participant base — port of `participants/_network_base.py`
- * (v0.3 adapter contract). Same `exportL5` / `exportSessions` half as a file
- * participant; only the discovery half differs (fetch from an authenticated
- * API). The base provides the three guarantees so adapters don't reimplement:
- *
- *   1. Local TTL cache under `~/.cache/bourdon/<slug>/payload.json` storing ONLY
- *      `{fetched_at, payload}` — NEVER the token. A cache hit = zero network.
- *   2. Graceful degradation: network down → serve the most recent cached payload
- *      (even expired) and report `degraded` (not silence).
- *   3. Auth boundary: an injected lazy {@link AuthProvider} (env / keychain).
- *      An invalid token (401/403 non-ratelimit) ALWAYS propagates as `blocked`
- *      and is NEVER masked by stale cache; a missing token serves stale when a
- *      cache exists, else blocks; rate-limit degrades.
- *
- * A subclass sets `participantSlug` / `agentId` / `agentType` (+ `nativePath`)
- * and implements `fetchPayload(token)` + `payloadToL5(payload)` (pure, no I/O).
- */
-import type { L5ManifestModel, SessionModel } from "@getbourdon/l5";
-import { ParticipantError, type AgentStore, type BourdonParticipant, type HealthStatus } from "./base.js";
-export declare const NETWORK_CONTRACT_VERSION = "0.3";
-/** Default cache TTL — adapters override via `cacheTtlSeconds`. */
-export declare const DEFAULT_CACHE_TTL_SECONDS: number;
-/** Transport failure / timeout / 5xx / rate-limit — recoverable via cache fallback. */
-export declare class NetworkUnavailable extends ParticipantError {
-}
-/** 401/403 / missing credential — NOT recoverable via cache. The user must fix
- * auth; surfaced as `blocked`, never silently served from stale cache (stale
- * data would mask a broken token indefinitely). */
-export declare class ParticipantAuthError extends ParticipantError {
-}
-/** A zero-arg callable returning the token string, or null if no credential is
- * available. Kept a callable (not a bare string) so the token is fetched lazily
- * at call time and never sits in the participant's fields or the cache. */
-export type AuthProvider = () => string | null;
-/** Auth provider that reads a token from an environment variable. */
-export declare function envAuthProvider(varName: string): AuthProvider;
-/** `$XDG_CACHE_HOME/bourdon` or `~/.cache/bourdon`. */
-export declare function defaultCacheRoot(): string;
-/** A cached payload + the wall-clock time it was fetched (epoch seconds). */
-export declare class CacheEntry {
-    readonly fetchedAt: number;
-    readonly payload: Record<string, unknown>;
-    constructor(fetchedAt: number, payload: Record<string, unknown>);
-    get ageSeconds(): number;
-    isFresh(ttlSeconds: number): boolean;
-}
-/**
- * A tiny JSON file cache, one file per participant slug. Stores only
- * `{fetched_at, payload}` — never the auth token. Read/write are best-effort: a
- * corrupt or unwritable cache degrades to "no cache", never raises.
- */
-export declare class PayloadCache {
-    readonly slug: string;
-    readonly root: string;
-    readonly path: string;
-    constructor(slug: string, rootDir?: string);
-    read(): CacheEntry | null;
-    write(payload: Record<string, unknown>): void;
-}
-export interface NetworkParticipantOptions {
-    authProvider?: AuthProvider | null;
-    cacheRoot?: string;
-}
-/**
- * Base for participants whose native state lives behind an authenticated API.
- * Caching, degradation, the auth boundary, and the
- * `discover`/`exportL5`/`exportSessions`/`healthCheck` plumbing live here;
- * subclasses provide only `fetchPayload` + `payloadToL5`.
- */
-export declare abstract class NetworkParticipant implements BourdonParticipant {
-    participantSlug: string;
-    agentId: string;
-    agentType: string;
-    cacheTtlSeconds: number;
-    nativePath: string;
-    protected readonly authProvider: AuthProvider | null;
-    private readonly cacheRoot?;
-    private cacheInstance?;
-    constructor(opts?: NetworkParticipantOptions);
-    /** Lazily built so it reads the SUBCLASS's `participantSlug` — subclass field
-     * initializers run after `super()`, so building the cache in the constructor
-     * would capture the base "network" slug instead. */
-    protected get cache(): PayloadCache;
-    /** Do the authenticated API call; return a JSON-serializable dict. Raise
-     * {@link NetworkUnavailable} on transport/5xx/rate-limit (→ cache fallback) or
-     * {@link ParticipantAuthError} on 401/403 (→ blocked, no fallback). */
-    abstract fetchPayload(token: string): Record<string, unknown>;
-    /** Normalize a (fresh or cached) payload into an L5 manifest. Pure, no I/O. */
-    abstract payloadToL5(payload: Record<string, unknown>): L5ManifestModel;
-    /**
-     * Resolve (payload, source) where source is 'cache' | 'network' | 'stale-cache'.
-     *   1. Fresh cache hit           → 'cache'        (no network)
-     *   2. Miss/expired + token      → 'network'      (fetch + refresh cache)
-     *   3. Net fails + any cache     → 'stale-cache'  (serve last good payload)
-     *   4. Net fails + no cache      → raise
-     * Auth errors are never swallowed — they propagate so health surfaces
-     * 'blocked' rather than serving stale data behind a dead token.
-     */
-    protected getPayload(): {
-        payload: Record<string, unknown>;
-        source: string;
-    };
-    discover(): AgentStore;
-    exportL5(_since?: Date): L5ManifestModel;
-    exportSessions(since?: Date, limit?: number): SessionModel[];
-    healthCheck(): HealthStatus;
-}

package/dist/network-base.js

@@ -1,248 +0,0 @@
-/**
- * Network-shaped participant base — port of `participants/_network_base.py`
- * (v0.3 adapter contract). Same `exportL5` / `exportSessions` half as a file
- * participant; only the discovery half differs (fetch from an authenticated
- * API). The base provides the three guarantees so adapters don't reimplement:
- *
- *   1. Local TTL cache under `~/.cache/bourdon/<slug>/payload.json` storing ONLY
- *      `{fetched_at, payload}` — NEVER the token. A cache hit = zero network.
- *   2. Graceful degradation: network down → serve the most recent cached payload
- *      (even expired) and report `degraded` (not silence).
- *   3. Auth boundary: an injected lazy {@link AuthProvider} (env / keychain).
- *      An invalid token (401/403 non-ratelimit) ALWAYS propagates as `blocked`
- *      and is NEVER masked by stale cache; a missing token serves stale when a
- *      cache exists, else blocks; rate-limit degrades.
- *
- * A subclass sets `participantSlug` / `agentId` / `agentType` (+ `nativePath`)
- * and implements `fetchPayload(token)` + `payloadToL5(payload)` (pure, no I/O).
- */
-import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { ParticipantError, } from "./base.js";
-export const NETWORK_CONTRACT_VERSION = "0.3";
-/** Default cache TTL — adapters override via `cacheTtlSeconds`. */
-export const DEFAULT_CACHE_TTL_SECONDS = 15 * 60; // 15 minutes
-// -- Network-specific errors --------------------------------------------------
-/** Transport failure / timeout / 5xx / rate-limit — recoverable via cache fallback. */
-export class NetworkUnavailable extends ParticipantError {
-}
-/** 401/403 / missing credential — NOT recoverable via cache. The user must fix
- * auth; surfaced as `blocked`, never silently served from stale cache (stale
- * data would mask a broken token indefinitely). */
-export class ParticipantAuthError extends ParticipantError {
-}
-/** Auth provider that reads a token from an environment variable. */
-export function envAuthProvider(varName) {
-    return () => process.env[varName] || null;
-}
-// -- Cache --------------------------------------------------------------------
-/** `$XDG_CACHE_HOME/bourdon` or `~/.cache/bourdon`. */
-export function defaultCacheRoot() {
-    const xdg = process.env.XDG_CACHE_HOME;
-    const base = xdg ? xdg : join(homedir(), ".cache");
-    return join(base, "bourdon");
-}
-/** A cached payload + the wall-clock time it was fetched (epoch seconds). */
-export class CacheEntry {
-    fetchedAt;
-    payload;
-    constructor(fetchedAt, payload) {
-        this.fetchedAt = fetchedAt;
-        this.payload = payload;
-    }
-    get ageSeconds() {
-        return Math.max(0, Date.now() / 1000 - this.fetchedAt);
-    }
-    isFresh(ttlSeconds) {
-        return this.ageSeconds < ttlSeconds;
-    }
-}
-/**
- * A tiny JSON file cache, one file per participant slug. Stores only
- * `{fetched_at, payload}` — never the auth token. Read/write are best-effort: a
- * corrupt or unwritable cache degrades to "no cache", never raises.
- */
-export class PayloadCache {
-    slug;
-    root;
-    path;
-    constructor(slug, rootDir) {
-        this.slug = slug;
-        this.root = join(rootDir ?? defaultCacheRoot(), slug);
-        this.path = join(this.root, "payload.json");
-    }
-    read() {
-        let raw;
-        try {
-            raw = JSON.parse(readFileSync(this.path, "utf8"));
-        }
-        catch {
-            return null;
-        }
-        if (typeof raw !== "object" || raw === null || !("payload" in raw))
-            return null;
-        const obj = raw;
-        let fetchedAt = Number(obj["fetched_at"] ?? 0);
-        if (!Number.isFinite(fetchedAt))
-            fetchedAt = 0;
-        const payload = obj["payload"];
-        if (typeof payload !== "object" || payload === null || Array.isArray(payload))
-            return null;
-        return new CacheEntry(fetchedAt, payload);
-    }
-    write(payload) {
-        try {
-            mkdirSync(this.root, { recursive: true });
-            const tmp = `${this.path}.tmp`;
-            writeFileSync(tmp, JSON.stringify({ fetched_at: Date.now() / 1000, payload }), "utf8");
-            renameSync(tmp, this.path); // atomic
-        }
-        catch {
-            /* best-effort; a write failure degrades to "no cache" */
-        }
-    }
-}
-// -- Base participant ---------------------------------------------------------
-/**
- * Base for participants whose native state lives behind an authenticated API.
- * Caching, degradation, the auth boundary, and the
- * `discover`/`exportL5`/`exportSessions`/`healthCheck` plumbing live here;
- * subclasses provide only `fetchPayload` + `payloadToL5`.
- */
-export class NetworkParticipant {
-    participantSlug = "network";
-    agentId = "network";
-    agentType = "other";
-    cacheTtlSeconds = DEFAULT_CACHE_TTL_SECONDS;
-    nativePath = "network://";
-    authProvider;
-    cacheRoot;
-    cacheInstance;
-    constructor(opts = {}) {
-        this.authProvider = opts.authProvider ?? null;
-        this.cacheRoot = opts.cacheRoot;
-    }
-    /** Lazily built so it reads the SUBCLASS's `participantSlug` — subclass field
-     * initializers run after `super()`, so building the cache in the constructor
-     * would capture the base "network" slug instead. */
-    get cache() {
-        if (!this.cacheInstance) {
-            this.cacheInstance = new PayloadCache(this.participantSlug, this.cacheRoot);
-        }
-        return this.cacheInstance;
-    }
-    // -- Core fetch-with-cache-and-degrade -------------------------------------
-    /**
-     * Resolve (payload, source) where source is 'cache' | 'network' | 'stale-cache'.
-     *   1. Fresh cache hit           → 'cache'        (no network)
-     *   2. Miss/expired + token      → 'network'      (fetch + refresh cache)
-     *   3. Net fails + any cache     → 'stale-cache'  (serve last good payload)
-     *   4. Net fails + no cache      → raise
-     * Auth errors are never swallowed — they propagate so health surfaces
-     * 'blocked' rather than serving stale data behind a dead token.
-     */
-    getPayload() {
-        const cached = this.cache.read();
-        if (cached !== null && cached.isFresh(this.cacheTtlSeconds)) {
-            return { payload: cached.payload, source: "cache" };
-        }
-        const token = this.authProvider ? this.authProvider() : null;
-        if (!token) {
-            // No credential: if we have any cache, serve it stale; else blocked.
-            if (cached !== null)
-                return { payload: cached.payload, source: "stale-cache" };
-            throw new ParticipantAuthError(`${this.participantSlug}: no auth token available and no cache`);
-        }
-        let payload;
-        try {
-            payload = this.fetchPayload(token);
-        }
-        catch (err) {
-            if (err instanceof ParticipantAuthError)
-                throw err; // never mask a bad token
-            if (err instanceof NetworkUnavailable) {
-                if (cached !== null)
-                    return { payload: cached.payload, source: "stale-cache" };
-                throw err;
-            }
-            throw err;
-        }
-        this.cache.write(payload);
-        return { payload, source: "network" };
-    }
-    // -- Participant protocol ---------------------------------------------------
-    discover() {
-        const { source } = this.getPayload();
-        return {
-            path: this.nativePath,
-            version: `${this.participantSlug}-network-v1`,
-            metadata: { source, contract_version: NETWORK_CONTRACT_VERSION },
-        };
-    }
-    exportL5(_since) {
-        const { payload } = this.getPayload();
-        return this.payloadToL5(payload);
-    }
-    exportSessions(since, limit = 100) {
-        const manifest = this.exportL5(since);
-        let sessions = manifest.recent_sessions ?? [];
-        if (since) {
-            const cutoff = since.toISOString().slice(0, 10);
-            sessions = sessions.filter((s) => (s.date || "") >= cutoff);
-        }
-        return sessions.slice(0, limit);
-    }
-    healthCheck() {
-        let source;
-        try {
-            source = this.getPayload().source;
-        }
-        catch (err) {
-            if (err instanceof ParticipantAuthError) {
-                return {
-                    status: "blocked",
-                    reason: String(err.message),
-                    details: { participant: this.participantSlug },
-                    proposedFix: `Provide a valid credential for ${this.participantSlug} ` +
-                        "(see the adapter docs for the auth path) and re-run `bourdon export-all`.",
-                };
-            }
-            if (err instanceof NetworkUnavailable) {
-                return {
-                    status: "degraded",
-                    reason: `network unavailable and no cache: ${err.message}`,
-                    details: { participant: this.participantSlug },
-                    proposedFix: "Check connectivity, then re-run `bourdon export-all`.",
-                };
-            }
-            // Defense in depth: health_check must NEVER raise. An adapter's
-            // fetchPayload should only raise the two contract errors; anything else is
-            // reported as blocked rather than propagated.
-            return {
-                status: "blocked",
-                reason: `unexpected error resolving payload: ${String(err)}`,
-                details: { participant: this.participantSlug },
-                proposedFix: `${this.participantSlug} raised an unexpected error during healthCheck; ` +
-                    "its fetchPayload should only raise ParticipantAuthError / NetworkUnavailable.",
-            };
-        }
-        const cached = this.cache.read();
-        const details = { participant: this.participantSlug, source };
-        if (cached !== null) {
-            details["cache_age_seconds"] = Math.round(cached.ageSeconds * 10) / 10;
-            details["cache_fetched_at"] = new Date(cached.fetchedAt * 1000)
-                .toISOString()
-                .replace(/\.\d{3}Z$/, "+00:00");
-        }
-        if (source === "stale-cache") {
-            return {
-                status: "degraded",
-                reason: "serving stale cache (network unavailable or no token)",
-                details,
-                proposedFix: "Restore connectivity / refresh the token to update.",
-            };
-        }
-        return { status: "ok", details };
-    }
-}

package/dist/readers/claude-code.d.ts

@@ -1,33 +0,0 @@
-/**
- * Claude Code participant — reads claude-brain + auto-memory + MCP knowledge
- * graph. Port of `participants/claude_code.py`.
- *
- * Three optional sources (the participant degrades gracefully):
- *   1. claude-brain/                  — git-synced markdown records
- *   2. ~/.claude/projects/<ws>/memory/ — per-machine auto-memory frontmatter
- *   3. ~/claude-memory/memory.jsonl   — MCP knowledge-graph JSONL
- *
- * Privacy: entities typed `person` (+ family/contact variants) and observations
- * containing credential-like strings default to PRIVATE and are filtered before
- * federation. Entities are deduped by case-insensitive name and sorted
- * alphabetically.
- */
-import { type L5ManifestModel, type SessionModel } from "@getbourdon/l5";
-import { type AgentStore, type BourdonParticipant, type HealthStatus } from "../base.js";
-/** External participant for Anthropic's Claude Code CLI. */
-export declare class ClaudeCodeParticipant implements BourdonParticipant {
-    agentId: string;
-    agentType: string;
-    nativePath: string;
-    /** Public so a hermetic test can seed the discovered sources directly (path
-     * RESOLUTION is not the parity contract — only the export output shape is). */
-    brainPath: string | null;
-    autoMemoryPath: string | null;
-    knowledgeGraphPath: string | null;
-    static defaultNativePath(home?: string): string;
-    constructor();
-    discover(): AgentStore;
-    exportL5(since?: Date): L5ManifestModel;
-    exportSessions(since?: Date, limit?: number): SessionModel[];
-    healthCheck(): HealthStatus;
-}