@getbourdon/participants 0.2.0 → 0.2.1

package/dist/index.d.cts

@@ -605,6 +605,329 @@ declare class OpenClawParticipant implements BourdonParticipant {
     healthCheck(): HealthStatus;
 }
 
+/**
+ * Claude Code automations participant — publishes background-run memory as L5
+ * evidence. Port of `participants/claude_code_automations.py`.
+ *
+ * Convention-file reader over the `~/.claude/automations/<id>/` tree:
+ *   automation.toml — id, name, status, schedule (rrule), kind, cwds
+ *   memory.md       — dated bullet entries, one block per run
+ *
+ * Each `automation.toml` becomes a known Entity (`type: automation`); each dated
+ * section of `memory.md` becomes a recent Session. Mirrors the Codex automation
+ * publisher — it covers the federation gap that the interactive-only
+ * `claude-code` participant leaves behind (automations whose work never touches
+ * claude-brain / auto-memory / the MCP knowledge graph).
+ *
+ * Privacy: every native string routes through the redaction SSOT
+ * (`redactText`, == the oracle's `_safe_native_memory_text`); the visibility
+ * policy filters PRIVATE entities before emission. `healthCheck` never throws.
+ */
+
+/** External participant for Claude Code automation memory artifacts. */
+declare class ClaudeCodeAutomationsParticipant implements BourdonParticipant {
+    agentId: string;
+    agentType: string;
+    nativePath: string;
+    private readonly automationsDir;
+    private readonly policy;
+    /**
+     * Conventional Claude Code automations dir (`~/.claude/automations`). Provided
+     * for protocol uniformity — the setup wizard wires the parent `claude-code`
+     * participant and skips `-automations` sub-surfaces.
+     */
+    static defaultNativePath(home?: string): string;
+    constructor(automationsDir?: string, claudeHome?: string);
+    discover(): AgentStore;
+    exportSessions(since?: Date, limit?: number): SessionModel[];
+    exportL5(since?: Date): L5ManifestModel;
+    healthCheck(): HealthStatus;
+    private runs;
+}
+
+/**
+ * Codex automations participant — publishes read-only Codex background/automation
+ * run memory into Bourdon as L5 evidence. Port of
+ * `participants/codex_automations.py`.
+ *
+ * Store convention (NOT SQLite, NOT network): a CONVENTION-FILE directory tree at
+ * `~/.codex/automations/<id>/`, each holding an `automation.toml` config and an
+ * optional `memory.md` run log. The reader parses the TOML config and extracts
+ * dated "runs" from the markdown memory, normalizing them into L5 sessions +
+ * entities (the automation itself, plus inferred projects and signal classes).
+ *
+ * Source-resolution order for the automations dir:
+ *   1. explicit `automationsDir` constructor arg
+ *   2. `codexHome` constructor arg → `<codexHome>/automations`
+ *   3. `CODEX_HOME` env-var → `$CODEX_HOME/automations`
+ *   4. `~/.codex/automations`  (default convention path)
+ *
+ * Privacy: every native string routes through the redaction SSOT
+ * (`redactText(v, 180)` == the oracle's `_safe_native_memory_text`); the
+ * visibility policy filters PRIVATE entities before emission. Defensive
+ * throughout — a missing dir raises {@link ParticipantDiscoveryError} from
+ * `discover()`, malformed TOML/markdown degrades to empty rather than raising,
+ * and `healthCheck` never throws.
+ *
+ * NOTE: does NOT depend on the full codex reader — only the redaction helper it
+ * imports (`_safe_native_memory_text`, reproduced inline as {@link safeNativeMemoryText}).
+ */
+
+/**
+ * External participant for Codex automation memory artifacts. Reads
+ * `~/.codex/automations/<id>/{automation.toml,memory.md}` and normalizes dated
+ * runs into an L5 manifest.
+ */
+declare class CodexAutomationsParticipant implements BourdonParticipant {
+    agentId: string;
+    agentType: string;
+    private readonly automationsDir;
+    private readonly policy;
+    /**
+     * Conventional Codex automations dir (`~/.codex/automations`). Provided for
+     * protocol uniformity — the setup wizard wires the parent `codex` participant
+     * and skips `-automations` sub-surfaces rather than detecting this one.
+     */
+    static defaultNativePath(home?: string): string;
+    constructor(automationsDir?: string, codexHome?: string);
+    get nativePath(): string;
+    discover(): AgentStore;
+    exportSessions(since?: Date, limit?: number): SessionModel[];
+    exportL5(since?: Date): L5ManifestModel;
+    healthCheck(): HealthStatus;
+    private runs;
+}
+
+/**
+ * GitHub Copilot · Automations participant — convention-file reader. Port of
+ * `participants/copilot_automations.py`.
+ *
+ * GitHub Copilot can be triggered by GitHub Actions workflows, scheduled tasks,
+ * and event-driven automations (issue triage, PR review, etc.). These run on a
+ * separate memory surface from both the CLI agent and the VS Code extension.
+ * Copilot automations have no standardized local state dump, so — mirroring the
+ * codex-automations reader — this participant uses a CONVENTION directory:
+ *
+ *   ~/.copilot-bourdon/automations/<automation-id>/
+ *       automation.toml   — id, name, status, trigger, kind, repos
+ *       memory.md         — dated bullet entries, one block per run
+ *
+ * Each `automation.toml` describes a recurring automation; each dated section of
+ * `memory.md` captures what happened in that run. Users or CI scripts maintain
+ * these files.
+ *
+ * Path resolution (matches the oracle):
+ *   1. `COPILOT_AUTOMATIONS_HOME` env-var override (verbatim, → /automations skipped:
+ *      the override IS the automations dir).
+ *   2. `~/.copilot-bourdon/automations/` (default convention path).
+ *
+ * Defensive throughout: a missing automations directory raises
+ * {@link ParticipantDiscoveryError} from `discover()`; a malformed
+ * `automation.toml` or unreadable `memory.md` is logged and skipped rather than
+ * raising; `healthCheck` never throws.
+ */
+
+/**
+ * Convention-based Bourdon participant for Copilot automation memory artifacts.
+ * Users or CI scripts maintain `automation.toml` + `memory.md` files at
+ * `~/.copilot-bourdon/automations/<id>/`.
+ */
+declare class CopilotAutomationsParticipant implements BourdonParticipant {
+    agentId: string;
+    agentType: string;
+    displayName: string;
+    private readonly automationsDir;
+    private readonly policy;
+    /** Conventional automations dir (`~/.copilot-bourdon/automations`). Does NOT
+     * consult `COPILOT_AUTOMATIONS_HOME` (matches Python `default_native_path`). */
+    static defaultNativePath(home?: string): string;
+    constructor(automationsDir?: string | null);
+    get nativePath(): string;
+    discover(): AgentStore;
+    exportSessions(since?: Date, limit?: number): SessionModel[];
+    exportL5(since?: Date): L5ManifestModel;
+    healthCheck(): HealthStatus;
+    private runs;
+}
+
+/**
+ * Cursor automations participant — publish background agent run memory as L5
+ * evidence. Port of `participants/cursor_automations.py`.
+ *
+ * Reads the `~/.cursor/automations/<id>/` CONVENTION (file-based, no SQLite):
+ *
+ *   automation.toml  — id, name, status, schedule (rrule), kind, cwds
+ *   memory.md        — dated bullet entries, one block per run
+ *
+ * Each `automation.toml` becomes a known Entity; each dated section of
+ * `memory.md` becomes a recent Session. This covers the federation gap the
+ * interactive-only `cursor` participant leaves behind: Cursor Cloud Agent
+ * background tasks whose work never touches the interactive SQLite state.
+ *
+ * Path resolution (default dir):
+ *   1. explicit `cursorHome` ctor arg → `<cursorHome>/automations`
+ *   2. `CURSOR_DIR` or `CURSOR_HOME` env → `<env>/automations`
+ *   3. `~/.cursor/automations`
+ *
+ * Redaction: every native action string passes through the redaction SSOT
+ * (`redactText(v, 180)` == Python `_safe_native_memory_text`). Visibility policy
+ * filters PRIVATE entities BEFORE emission. `healthCheck` never throws.
+ */
+
+/** External participant for Cursor Cloud Agent automation memory artifacts. */
+declare class CursorAutomationsParticipant implements BourdonParticipant {
+    agentId: string;
+    agentType: string;
+    private readonly automationsDir;
+    private readonly policy;
+    constructor(automationsDir?: string | null, cursorHome?: string | null);
+    get nativePath(): string;
+    discover(): AgentStore;
+    exportSessions(since?: Date, limit?: number): SessionModel[];
+    exportL5(since?: Date): L5ManifestModel;
+    healthCheck(): HealthStatus;
+    private runs;
+}
+
+/**
+ * Claude Desktop · Code participant — the Claude desktop app's GUI "Claude Code"
+ * surface. Port of `participants/claude_desktop_code.py` (+ the shared
+ * `participants/_claude_desktop.py` helpers it needs).
+ *
+ * The desktop GUI's Claude Code keeps **metadata-only** state on disk — there is
+ * no transcript. State files live at:
+ *
+ *     <desktop>/claude-code-sessions/<accountUUID>/<orgUUID>/local_<id>.json
+ *
+ * This participant emits **recognition metadata only** and routes every emitted
+ * string through the shared redactor + a length cap (defense in depth): title,
+ * cwd→project, model, effort, `enabledMcpTools` *count*, timestamps. It never
+ * emits `planPath` contents or any free-form text beyond the redacted title.
+ *
+ * Distinct from the interactive-CLI {@link ClaudeCodeParticipant} and the richer
+ * Co-Work surface. Convention: file/JSON reader (no SQLite, no network).
+ */
+
+/**
+ * External participant for the Claude desktop app's GUI Claude Code surface.
+ * File/JSON reader — metadata-only, no transcript, no SQLite, no network.
+ */
+declare class ClaudeDesktopCodeParticipant implements BourdonParticipant {
+    agentId: string;
+    agentType: string;
+    displayName: string;
+    private readonly storeDir;
+    private readonly policy;
+    /**
+     * The Claude Code sub-store dir the setup wizard probes for presence. Resolves
+     * to `<desktop>/claude-code-sessions`. Falls back to a non-existent sentinel
+     * under `home` on an unrecognized platform so the wizard reports "not found".
+     */
+    static defaultNativePath(home?: string): string;
+    constructor(storeDir?: string, home?: string);
+    get nativePath(): string;
+    discover(): AgentStore;
+    exportSessions(since?: Date, limit?: number): SessionModel[];
+    exportL5(since?: Date): L5ManifestModel;
+    healthCheck(): HealthStatus;
+    private collectConversations;
+    private conversations;
+}
+
+/**
+ * Claude Desktop · Co-Work participant — the richest of the two Claude-desktop
+ * surfaces. Port of `participants/claude_desktop_cowork.py` (+ the shared
+ * `participants/_claude_desktop.py` extraction helpers, inlined here).
+ *
+ * The desktop app stores each Co-Work / local-agent run as a state file plus a
+ * sibling audit transcript:
+ *
+ *     <desktop>/local-agent-mode-sessions/<acct>/<org>/local_<id>.json   (state)
+ *     <desktop>/local-agent-mode-sessions/<acct>/<org>/local_<id>/audit.jsonl
+ *
+ * This participant emits **recognition metadata only**. From the state file it
+ * reads surface scalars (title, cwd, model, permission mode, timestamps,
+ * `enabledMcpTools` *count*, `userSelectedFolders` *basenames*). From the
+ * sibling `audit.jsonl` it reads ONLY the `system`/`init` capability *counts*
+ * and the `result` safe scalars (cost, turns, error flag). It NEVER reads
+ * conversation content. Every emitted string passes through the redaction SSOT
+ * + a length cap, and TEAM entities are visibility-filtered before emission.
+ *
+ * Storage kind: file/convention (glob + JSON + JSONL), so this reads like the
+ * claude-code / cascade file readers — no SQLite, no network.
+ */
+
+/** External participant for the Claude desktop app's Co-Work surface. */
+declare class ClaudeDesktopCoworkParticipant implements BourdonParticipant {
+    agentId: string;
+    agentType: string;
+    displayName: string;
+    private readonly storeDir;
+    private readonly policy;
+    /**
+     * The Co-Work sub-store dir the setup wizard probes for presence. Resolves to
+     * `<desktop>/local-agent-mode-sessions`. When the desktop dir cannot be
+     * resolved on this platform, falls back to a non-existent sentinel under
+     * `home` so the wizard reports "not found" rather than crashing.
+     */
+    static defaultNativePath(home?: string): string;
+    constructor(storeDir?: string, home?: string);
+    get nativePath(): string;
+    discover(): AgentStore;
+    exportSessions(since?: Date, limit?: number): SessionModel[];
+    exportL5(since?: Date): L5ManifestModel;
+    healthCheck(): HealthStatus;
+    private collectRuns;
+    private runs;
+}
+
+/**
+ * GitHub Copilot · VS Code participant — reads the GUI Copilot Chat extension's
+ * per-workspace transcripts + repo-scoped memory. Port of
+ * `participants/copilot_vscode.py`.
+ *
+ * VS Code's Copilot Chat extension stores per-workspace data at
+ * `<workspaceStorage>/<hash>/GitHub.copilot-chat/`:
+ *   - `transcripts/<session-uuid>.jsonl` — event stream per chat session
+ *   - `memory-tool/memories/**\/*.md`    — per-repo memory (markdown bullets)
+ *
+ * This is a FILE/CONVENTION reader (not SQLite, not network): it walks the
+ * workspaceStorage tree read-only, parses JSONL transcripts + markdown memory
+ * files, aggregates across every workspace hash, redacts every native string,
+ * applies the visibility filter BEFORE emission, and is deterministic.
+ * `healthCheck` never throws.
+ *
+ * Distinct from:
+ *   - `copilot`        (convention-file at `~/.copilot-bourdon/memory.md`)
+ *   - `copilot-cli`    (terminal agent, `~/.copilot/session-store.db`, SQLite)
+ *   - `github-copilot` (network reader — GitHub-embedded Copilot)
+ */
+
+/**
+ * External participant for GitHub Copilot in VS Code. Reads transcripts and
+ * memory-tool files from VS Code's workspaceStorage read-only, aggregating
+ * across all workspace hashes.
+ */
+declare class CopilotVscodeParticipant implements BourdonParticipant {
+    agentId: string;
+    agentType: string;
+    displayName: string;
+    private readonly workspaceStorage;
+    /** The workspaceStorage dir the setup wizard probes for presence. */
+    static defaultNativePath(home?: string): string;
+    constructor(workspaceStorage?: string);
+    get nativePath(): string;
+    private resolveWs;
+    discover(): AgentStore;
+    exportSessions(since?: Date, limit?: number): SessionModel[];
+    exportL5(since?: Date): L5ManifestModel;
+    healthCheck(): HealthStatus;
+    /** Collect and parse all transcripts across all workspaces. */
+    private allTranscripts;
+    /** Collect all memory-tool files across all workspaces. */
+    private allMemories;
+}
+
 /**
  * Participant discovery — a STATIC TS registry replacing Python's `pkgutil`
  * package scan + entry-point duck-type (`participants/__init__.py`).
@@ -626,10 +949,9 @@ declare class OpenClawParticipant implements BourdonParticipant {
 type ParticipantCtor = new () => BourdonParticipant;
 /**
  * The first-party reader registry. Order here is irrelevant — discovery sorts by
- * `agentId`. (cursor / copilot-cli are the heavier SQLite readers; copilot is the
- * convention-file reader; cascade reads Windsurf; openclaw is the quarantined-
- * class network reader. codex — the ~2.6k-line turn-compiler reader — is still
- * deferred.)
+ * `agentId`. Covers the base agents, their background-run "automations" variants,
+ * the Claude-desktop surfaces, and the quarantined-class openclaw network reader.
+ * codex — the ~2.6k-line turn-compiler reader — is the only one still deferred.
  */
 declare const FIRST_PARTY: ParticipantCtor[];
 /**
@@ -646,4 +968,4 @@ declare function discoverParticipants(ctors?: ParticipantCtor[]): BourdonPartici
  */
 declare function resolvePluginParticipants(): ParticipantCtor[];
 
-export { type AgentStore, type AuthProvider, type BourdonParticipant, CONTRACT_VERSION, CacheEntry, CascadeParticipant, ClaudeCodeParticipant, CopilotCliParticipant, CopilotParticipant, CursorParticipant, DEFAULT_CACHE_TTL_SECONDS, FIRST_PARTY, GitHubCopilotParticipant, type HealthStatus, HermesParticipant, MIN_PATCHED_VERSION, NETWORK_CONTRACT_VERSION, NetworkParticipant, type NetworkParticipantOptions, NetworkUnavailable, OpenClawApiClient, OpenClawParticipant, type OpenReadonlyOptions, ParticipantAuthError, type ParticipantCtor, ParticipantDiscoveryError, ParticipantError, ParticipantExportError, ParticipantVersionMismatchError, PayloadCache, SPEC_VERSION, type SqliteDatabase, defaultCacheRoot, discoverParticipants, envAuthProvider, epochToIsoDate, epochToIsoDatetime, friendlyLabel, ghTokenProvider, isParticipant, openReadonly, projectKeyFromCwd, resolvePluginParticipants, sqliteAvailable, tableColumns, tableExists, tryOpenReadonly, verifyInstance };
+export { type AgentStore, type AuthProvider, type BourdonParticipant, CONTRACT_VERSION, CacheEntry, CascadeParticipant, ClaudeCodeAutomationsParticipant, ClaudeCodeParticipant, ClaudeDesktopCodeParticipant, ClaudeDesktopCoworkParticipant, CodexAutomationsParticipant, CopilotAutomationsParticipant, CopilotCliParticipant, CopilotParticipant, CopilotVscodeParticipant, CursorAutomationsParticipant, CursorParticipant, DEFAULT_CACHE_TTL_SECONDS, FIRST_PARTY, GitHubCopilotParticipant, type HealthStatus, HermesParticipant, MIN_PATCHED_VERSION, NETWORK_CONTRACT_VERSION, NetworkParticipant, type NetworkParticipantOptions, NetworkUnavailable, OpenClawApiClient, OpenClawParticipant, type OpenReadonlyOptions, ParticipantAuthError, type ParticipantCtor, ParticipantDiscoveryError, ParticipantError, ParticipantExportError, ParticipantVersionMismatchError, PayloadCache, SPEC_VERSION, type SqliteDatabase, defaultCacheRoot, discoverParticipants, envAuthProvider, epochToIsoDate, epochToIsoDatetime, friendlyLabel, ghTokenProvider, isParticipant, openReadonly, projectKeyFromCwd, resolvePluginParticipants, sqliteAvailable, tableColumns, tableExists, tryOpenReadonly, verifyInstance };