@aiassesstech/grillo 0.1.0

package/dist/dashboard/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/dashboard/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,mEAAmE;AACnE,2BAA2B;AAC3B,mEAAmE;AAEnE,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,EAAE,WAAW,IAAI,gBAAgB,CAAC;IACvE,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,EAAE,YAAY,IAAI,SAAS,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,YAAY,IAAI,mDAAmD,CAAC;IAEtG,OAAO;;;;;WAKE,WAAW;;;mBAGH,YAAY;yBACN,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4b3B,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA0GI,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8WvB,CAAC;AACT,CAAC"}

package/dist/discovery/discovery-adapter.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Grillo Cricket — Agent Discovery Protocol
+ *
+ * Pluggable adapter interface for discovering agents from various
+ * orchestration platforms (OpenClaw, LangChain, CrewAI, AutoGen, etc.).
+ *
+ * Grillo doesn't care HOW agents are hosted — it only needs a
+ * standardized discovery result. Each platform provides an adapter.
+ */
+import type { AgentCategory, RiskTier } from "../registry/types.js";
+export interface DiscoveredAgent {
+    /** External ID from the orchestration platform */
+    externalId: string;
+    /** Human-readable agent name */
+    name: string;
+    /** Agent type (e.g., 'bot', 'assistant', 'tool', 'skill') */
+    agentType: string;
+    /** Model being used (e.g., 'gpt-4', 'claude-3-opus') */
+    model: string;
+    /** Provider (e.g., 'openai', 'anthropic') */
+    provider: string;
+    /** Suggested category for Grillo's registry */
+    category?: AgentCategory;
+    /** Suggested risk tier */
+    riskTier?: RiskTier;
+    /** Tags from the platform */
+    tags?: string[];
+    /** Additional platform-specific metadata */
+    metadata?: Record<string, unknown>;
+    /** The orchestration framework this agent runs on */
+    framework?: string;
+    /** When this agent was created/deployed */
+    deployedAt?: Date;
+    /** Whether the agent is currently active */
+    active?: boolean;
+}
+export interface DiscoveryResult {
+    /** Agents found by the adapter */
+    agents: DiscoveredAgent[];
+    /** Platform/adapter that produced this result */
+    source: string;
+    /** When the scan was performed */
+    scannedAt: Date;
+    /** Any errors encountered during discovery */
+    errors?: string[];
+    /** Additional metadata from the scan */
+    metadata?: Record<string, unknown>;
+}
+export interface DiscoveryAdapter {
+    /** Unique identifier for this adapter (e.g., 'openclaw', 'langchain') */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Discover agents from the platform */
+    discover(): Promise<DiscoveryResult>;
+    /** Test connectivity to the platform */
+    healthCheck(): Promise<boolean>;
+}
+export interface OpenClawDiscoveryConfig {
+    /** OpenClaw Gateway URL (e.g., http://127.0.0.1:18789) */
+    gatewayUrl: string;
+    /** API key for authentication */
+    apiKey?: string;
+    /** Timeout for discovery requests */
+    timeoutMs?: number;
+}
+/**
+ * Discovery adapter for OpenClaw deployments.
+ *
+ * Queries the OpenClaw Gateway's agent API to enumerate all
+ * registered agents, their models, and configurations.
+ */
+export declare class OpenClawDiscoveryAdapter implements DiscoveryAdapter {
+    readonly id = "openclaw";
+    readonly name = "OpenClaw Gateway";
+    private readonly config;
+    constructor(config: OpenClawDiscoveryConfig);
+    discover(): Promise<DiscoveryResult>;
+    healthCheck(): Promise<boolean>;
+}
+/**
+ * Static discovery adapter that returns a fixed set of agents.
+ * Useful for testing, demos, and environments without a live
+ * orchestration platform.
+ */
+export declare class StaticDiscoveryAdapter implements DiscoveryAdapter {
+    readonly id = "static";
+    readonly name = "Static Configuration";
+    private readonly agents;
+    constructor(agents: DiscoveredAgent[]);
+    discover(): Promise<DiscoveryResult>;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=discovery-adapter.d.ts.map

package/dist/discovery/discovery-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-adapter.d.ts","sourceRoot":"","sources":["../../src/discovery/discovery-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAMpE,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACrC,wCAAwC;IACxC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAMD,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,IAAI,sBAAsB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;gBAErC,MAAM,EAAE,uBAAuB;IAIrC,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;IAsEpC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAiBtC;AAMD;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,IAAI,0BAA0B;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAE/B,MAAM,EAAE,eAAe,EAAE;IAI/B,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;IAQpC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/discovery/discovery-adapter.js

@@ -0,0 +1,114 @@
+/**
+ * Grillo Cricket — Agent Discovery Protocol
+ *
+ * Pluggable adapter interface for discovering agents from various
+ * orchestration platforms (OpenClaw, LangChain, CrewAI, AutoGen, etc.).
+ *
+ * Grillo doesn't care HOW agents are hosted — it only needs a
+ * standardized discovery result. Each platform provides an adapter.
+ */
+/**
+ * Discovery adapter for OpenClaw deployments.
+ *
+ * Queries the OpenClaw Gateway's agent API to enumerate all
+ * registered agents, their models, and configurations.
+ */
+export class OpenClawDiscoveryAdapter {
+    id = "openclaw";
+    name = "OpenClaw Gateway";
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async discover() {
+        const scannedAt = new Date();
+        const errors = [];
+        try {
+            const url = `${this.config.gatewayUrl}/v1/agents`;
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), this.config.timeoutMs ?? 10000);
+            try {
+                const response = await fetch(url, {
+                    headers: {
+                        ...(this.config.apiKey
+                            ? { Authorization: `Bearer ${this.config.apiKey}` }
+                            : {}),
+                    },
+                    signal: controller.signal,
+                });
+                clearTimeout(timeout);
+                if (!response.ok) {
+                    errors.push(`OpenClaw API returned ${response.status}: ${response.statusText}`);
+                    return { agents: [], source: this.id, scannedAt, errors };
+                }
+                const data = (await response.json());
+                const agents = (data.agents ?? []).map((raw) => ({
+                    externalId: String(raw.id ?? ""),
+                    name: String(raw.name ?? raw.id ?? "unknown"),
+                    agentType: String(raw.type ?? "bot"),
+                    model: String(raw.model ?? "unknown"),
+                    provider: String(raw.provider ?? "unknown"),
+                    tags: raw.tags ?? [],
+                    metadata: raw.metadata ?? {},
+                    framework: "openclaw",
+                    deployedAt: raw.created_at ? new Date(raw.created_at) : undefined,
+                    active: raw.active ?? true,
+                }));
+                return { agents, source: this.id, scannedAt };
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            errors.push(`OpenClaw discovery failed: ${msg}`);
+            return { agents: [], source: this.id, scannedAt, errors };
+        }
+    }
+    async healthCheck() {
+        try {
+            const url = `${this.config.gatewayUrl}/v1/health`;
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 5000);
+            try {
+                const response = await fetch(url, { signal: controller.signal });
+                clearTimeout(timeout);
+                return response.ok;
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// ================================================================
+// Static Adapter (for testing and manual configurations)
+// ================================================================
+/**
+ * Static discovery adapter that returns a fixed set of agents.
+ * Useful for testing, demos, and environments without a live
+ * orchestration platform.
+ */
+export class StaticDiscoveryAdapter {
+    id = "static";
+    name = "Static Configuration";
+    agents;
+    constructor(agents) {
+        this.agents = agents;
+    }
+    async discover() {
+        return {
+            agents: [...this.agents],
+            source: this.id,
+            scannedAt: new Date(),
+        };
+    }
+    async healthCheck() {
+        return true;
+    }
+}
+//# sourceMappingURL=discovery-adapter.js.map

package/dist/discovery/discovery-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-adapter.js","sourceRoot":"","sources":["../../src/discovery/discovery-adapter.ts"],"names":[],"mappings":"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"}

package/dist/discovery/discovery-service.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Grillo Cricket — Discovery Service
+ *
+ * Orchestrates agent discovery across multiple adapters, reconciles
+ * discovered agents against the existing registry, and handles
+ * registration of new agents.
+ */
+import type { AgentRegistry } from "../registry/agent-registry.js";
+import type { AuditLog } from "../audit/audit-log.js";
+import type { Notifier } from "../notifications/notifier.js";
+import type { DiscoveryAdapter, DiscoveredAgent, DiscoveryResult } from "./discovery-adapter.js";
+export interface ReconciliationResult {
+    /** Newly registered agents */
+    registered: DiscoveredAgent[];
+    /** Agents already known to Grillo */
+    existing: DiscoveredAgent[];
+    /** Agents in Grillo's registry but NOT found by any adapter (stale?) */
+    orphaned: string[];
+    /** Agents that were skipped (inactive, filtered, etc.) */
+    skipped: DiscoveredAgent[];
+    /** Errors from adapters */
+    errors: string[];
+    /** Total scan time in ms */
+    durationMs: number;
+}
+export declare class DiscoveryService {
+    private readonly adapters;
+    private readonly registry;
+    private readonly auditLog;
+    private readonly notifier;
+    constructor(params: {
+        registry: AgentRegistry;
+        auditLog?: AuditLog;
+        notifier?: Notifier;
+    });
+    /**
+     * Register a discovery adapter.
+     */
+    addAdapter(adapter: DiscoveryAdapter): void;
+    /**
+     * Remove a discovery adapter.
+     */
+    removeAdapter(id: string): void;
+    /**
+     * List registered adapters.
+     */
+    listAdapters(): {
+        id: string;
+        name: string;
+    }[];
+    /**
+     * Run discovery across all registered adapters.
+     */
+    discover(): Promise<DiscoveryResult[]>;
+    /**
+     * Discover agents and reconcile against the registry.
+     * New agents are auto-registered; orphaned agents are flagged.
+     */
+    discoverAndReconcile(options?: {
+        autoRegister?: boolean;
+        skipInactive?: boolean;
+    }): Promise<ReconciliationResult>;
+    /**
+     * Check health of all registered adapters.
+     */
+    healthCheck(): Promise<Record<string, boolean>>;
+    /**
+     * Build a Grillo-internal agent ID from a discovered agent.
+     * Format: {framework}-{externalId} or just {externalId} if no framework.
+     */
+    private buildAgentId;
+    /**
+     * Format discovery results as human-readable text.
+     */
+    formatResults(result: ReconciliationResult): string;
+}
+//# sourceMappingURL=discovery-service.d.ts.map

package/dist/discovery/discovery-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-service.d.ts","sourceRoot":"","sources":["../../src/discovery/discovery-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAOhC,MAAM,WAAW,oBAAoB;IACnC,8BAA8B;IAC9B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0DAA0D;IAC1D,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,2BAA2B;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAE/B,MAAM,EAAE;QAClB,QAAQ,EAAE,aAAa,CAAC;QACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACrB;IAUD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAI3C;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,YAAY,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;IAW9C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAsB5C;;;OAGG;IACG,oBAAoB,CAAC,OAAO,CAAC,EAAE;QACnC,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoHjC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAkBrD;;;OAGG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM;CAuCpD"}

package/dist/discovery/discovery-service.js

@@ -0,0 +1,240 @@
+/**
+ * Grillo Cricket — Discovery Service
+ *
+ * Orchestrates agent discovery across multiple adapters, reconciles
+ * discovered agents against the existing registry, and handles
+ * registration of new agents.
+ */
+import { AgentCategory, RiskTier } from "../registry/types.js";
+// ================================================================
+// Discovery Service
+// ================================================================
+export class DiscoveryService {
+    adapters = new Map();
+    registry;
+    auditLog;
+    notifier;
+    constructor(params) {
+        this.registry = params.registry;
+        this.auditLog = params.auditLog ?? null;
+        this.notifier = params.notifier ?? null;
+    }
+    // ============================================================
+    // Adapter Management
+    // ============================================================
+    /**
+     * Register a discovery adapter.
+     */
+    addAdapter(adapter) {
+        this.adapters.set(adapter.id, adapter);
+    }
+    /**
+     * Remove a discovery adapter.
+     */
+    removeAdapter(id) {
+        this.adapters.delete(id);
+    }
+    /**
+     * List registered adapters.
+     */
+    listAdapters() {
+        return Array.from(this.adapters.values()).map((a) => ({
+            id: a.id,
+            name: a.name,
+        }));
+    }
+    // ============================================================
+    // Discovery + Reconciliation
+    // ============================================================
+    /**
+     * Run discovery across all registered adapters.
+     */
+    async discover() {
+        const results = [];
+        for (const adapter of this.adapters.values()) {
+            try {
+                const result = await adapter.discover();
+                results.push(result);
+            }
+            catch (error) {
+                results.push({
+                    agents: [],
+                    source: adapter.id,
+                    scannedAt: new Date(),
+                    errors: [
+                        `Adapter ${adapter.id} threw: ${error instanceof Error ? error.message : String(error)}`,
+                    ],
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Discover agents and reconcile against the registry.
+     * New agents are auto-registered; orphaned agents are flagged.
+     */
+    async discoverAndReconcile(options) {
+        const startTime = Date.now();
+        const autoRegister = options?.autoRegister ?? true;
+        const skipInactive = options?.skipInactive ?? true;
+        const discoveryResults = await this.discover();
+        const registered = [];
+        const existing = [];
+        const skipped = [];
+        const errors = [];
+        const discoveredIds = new Set();
+        // Process all discovered agents
+        for (const result of discoveryResults) {
+            if (result.errors?.length) {
+                errors.push(...result.errors);
+            }
+            for (const agent of result.agents) {
+                // Skip inactive agents if configured
+                if (skipInactive && agent.active === false) {
+                    skipped.push(agent);
+                    continue;
+                }
+                // Build the Grillo agent ID from the external ID
+                const agentId = this.buildAgentId(agent);
+                discoveredIds.add(agentId);
+                // Check if already registered
+                const existingAgent = this.registry.get(agentId);
+                if (existingAgent) {
+                    existing.push(agent);
+                }
+                else if (autoRegister) {
+                    // Register new agent
+                    this.registry.register({
+                        agentId,
+                        agentName: agent.name,
+                        agentType: agent.agentType,
+                        provider: agent.provider,
+                        model: agent.model,
+                        category: agent.category ?? AgentCategory.INTERNAL_UTILITY,
+                        riskTier: agent.riskTier ?? RiskTier.MEDIUM,
+                        tags: agent.tags ?? [],
+                        metadata: {
+                            ...agent.metadata,
+                            discoveredBy: result.source,
+                            discoveredAt: result.scannedAt.toISOString(),
+                            framework: agent.framework,
+                        },
+                    });
+                    registered.push(agent);
+                    this.auditLog?.append({
+                        action: "agent_discovered",
+                        actor: "discovery-service",
+                        agentId,
+                        description: `Auto-registered ${agent.name} (${agent.model}@${agent.provider}) from ${result.source}.`,
+                    });
+                }
+                else {
+                    skipped.push(agent);
+                }
+            }
+        }
+        // Find orphaned agents (in registry but not discovered)
+        const orphaned = [];
+        if (this.adapters.size > 0) {
+            for (const agent of this.registry.all()) {
+                if (!discoveredIds.has(agent.agentId)) {
+                    orphaned.push(agent.agentId);
+                }
+            }
+        }
+        const durationMs = Date.now() - startTime;
+        // Notify if new agents were found
+        if (registered.length > 0 && this.notifier) {
+            await this.notifier.notify({
+                event: "agent_discovered",
+                message: `Discovery scan found ${registered.length} new agent(s). Auto-registered.`,
+                data: {
+                    newAgents: registered.map((a) => a.name),
+                    adapters: discoveryResults.map((r) => r.source),
+                },
+                timestamp: new Date(),
+            });
+        }
+        this.auditLog?.append({
+            action: "agent_discovered",
+            actor: "discovery-service",
+            description: `Discovery scan complete: ${registered.length} new, ${existing.length} existing, ` +
+                `${orphaned.length} orphaned, ${skipped.length} skipped, ${errors.length} errors. ` +
+                `Duration: ${durationMs}ms.`,
+        });
+        return {
+            registered,
+            existing,
+            orphaned,
+            skipped,
+            errors,
+            durationMs,
+        };
+    }
+    // ============================================================
+    // Health Checks
+    // ============================================================
+    /**
+     * Check health of all registered adapters.
+     */
+    async healthCheck() {
+        const results = {};
+        for (const adapter of this.adapters.values()) {
+            try {
+                results[adapter.id] = await adapter.healthCheck();
+            }
+            catch {
+                results[adapter.id] = false;
+            }
+        }
+        return results;
+    }
+    // ============================================================
+    // Helpers
+    // ============================================================
+    /**
+     * Build a Grillo-internal agent ID from a discovered agent.
+     * Format: {framework}-{externalId} or just {externalId} if no framework.
+     */
+    buildAgentId(agent) {
+        if (agent.framework) {
+            return `${agent.framework}-${agent.externalId}`;
+        }
+        return agent.externalId;
+    }
+    /**
+     * Format discovery results as human-readable text.
+     */
+    formatResults(result) {
+        const lines = [
+            "## Discovery Scan Results",
+            "",
+            `**Duration:** ${result.durationMs}ms`,
+            `**New agents registered:** ${result.registered.length}`,
+            `**Already known:** ${result.existing.length}`,
+            `**Orphaned (in registry, not discovered):** ${result.orphaned.length}`,
+            `**Skipped:** ${result.skipped.length}`,
+        ];
+        if (result.registered.length > 0) {
+            lines.push("", "### Newly Registered");
+            for (const a of result.registered) {
+                lines.push(`- **${a.name}** — ${a.model}@${a.provider} (${a.framework ?? "unknown"})`);
+            }
+        }
+        if (result.orphaned.length > 0) {
+            lines.push("", "### Orphaned Agents");
+            lines.push("_These agents are in Grillo's registry but were not found by any discovery adapter:_");
+            for (const id of result.orphaned) {
+                lines.push(`- \`${id}\``);
+            }
+        }
+        if (result.errors.length > 0) {
+            lines.push("", "### Errors");
+            for (const e of result.errors) {
+                lines.push(`- ${e}`);
+            }
+        }
+        return lines.join("\n");
+    }
+}
+//# sourceMappingURL=discovery-service.js.map

package/dist/discovery/discovery-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-service.js","sourceRoot":"","sources":["../../src/discovery/discovery-service.ts"],"names":[],"mappings":"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"}

package/dist/drift/detector.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Grillo Cricket — Drift Detector
+ *
+ * Temporal Drift Index (TDI) calculator. Detects when an agent's scores
+ * drift from its established baseline. Framework-agnostic: works with
+ * any dimension set (LCSH, virtue, ethics, opex).
+ *
+ * TDI = sqrt(sum((current_i - baseline_i)^2) / n)
+ *
+ * The baseline is an EMA (exponential moving average) of all historical
+ * scores, so it adapts to legitimate model improvements while flagging
+ * sudden drops.
+ */
+import type { DimensionScores, DriftReport, AgentRecord } from "../registry/types.js";
+import type { GrilloConfig } from "../config/schema.js";
+/**
+ * Calculate the Temporal Drift Index between current scores and baseline.
+ *
+ * @returns TDI value (0 = no drift, higher = more drift)
+ */
+export declare function calculateTDI(current: DimensionScores, baseline: DimensionScores): number;
+/**
+ * Determine drift severity from TDI value.
+ */
+export declare function driftSeverity(tdi: number, config: GrilloConfig): "none" | "low" | "medium" | "high" | "critical";
+/**
+ * Per-dimension drift breakdown.
+ */
+export declare function dimensionDrifts(current: DimensionScores, baseline: DimensionScores): Record<string, number>;
+export declare class DriftDetector {
+    private readonly config;
+    constructor(config: GrilloConfig);
+    /**
+     * Analyze drift for a single agent given their current scores.
+     */
+    analyze(agent: AgentRecord, currentScores: DimensionScores): DriftReport;
+    /**
+     * Update the baseline using EMA (exponential moving average).
+     * Returns the updated baseline.
+     */
+    updateBaseline(currentBaseline: DimensionScores, newScores: DimensionScores): DimensionScores;
+    /**
+     * Check if a drift report should trigger a notification.
+     */
+    shouldNotify(report: DriftReport): boolean;
+    /**
+     * Format a drift report as a human-readable summary.
+     */
+    formatReport(report: DriftReport): string;
+}
+//# sourceMappingURL=detector.d.ts.map

package/dist/drift/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/drift/detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,eAAe,GACxB,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,YAAY,GACnB,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAQjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,eAAe,GACxB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAIhC;;OAEG;IACH,OAAO,CACL,KAAK,EAAE,WAAW,EAClB,aAAa,EAAE,eAAe,GAC7B,WAAW;IAiCd;;;OAGG;IACH,cAAc,CACZ,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,eAAe,GACzB,eAAe;IAoBlB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAI1C;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;CAoB1C"}