@aiassesstech/grillo 0.1.0

package/dist/notifications/notifier.js

@@ -0,0 +1,119 @@
+/**
+ * Grillo Cricket — Notification Service
+ *
+ * Multi-channel notification dispatcher. Phase 1 supports:
+ *  - Console logging (always on)
+ *  - Webhook (HTTP POST to configured URLs)
+ *
+ * Phase 2+ will add: Slack, email, Telegram.
+ */
+// ================================================================
+// Multi-Channel Notifier
+// ================================================================
+export class GrilloNotifier {
+    config;
+    channels = [];
+    constructor(config) {
+        this.config = config;
+        // Console channel is always on
+        this.channels.push(new ConsoleChannel());
+        // Webhook channel if configured
+        if (config.webhookUrls && config.webhookUrls.length > 0) {
+            this.channels.push(new WebhookChannel(config.webhookUrls));
+        }
+    }
+    async notify(payload) {
+        // Check if this event type is enabled
+        if (!this.config.events.includes(payload.event)) {
+            return;
+        }
+        // Dispatch to all channels concurrently
+        const results = await Promise.allSettled(this.channels.map((ch) => ch.send(payload)));
+        // Log any channel failures (don't throw — notifications are best-effort)
+        for (let i = 0; i < results.length; i++) {
+            if (results[i].status === "rejected") {
+                console.warn(`[grillo:notify] Channel ${this.channels[i].name} failed:`, results[i].reason);
+            }
+        }
+    }
+}
+// ================================================================
+// Console Channel
+// ================================================================
+class ConsoleChannel {
+    name = "console";
+    async send(payload) {
+        const emoji = eventEmoji(payload.event);
+        const prefix = `[grillo] ${emoji}`;
+        if (payload.event === "assessment_failed" ||
+            payload.event === "fleet_anomaly" ||
+            payload.event === "drift_warning") {
+            console.warn(`${prefix} ${payload.message}`);
+        }
+        else {
+            console.log(`${prefix} ${payload.message}`);
+        }
+    }
+}
+// ================================================================
+// Webhook Channel
+// ================================================================
+class WebhookChannel {
+    name = "webhook";
+    urls;
+    constructor(urls) {
+        this.urls = urls;
+    }
+    async send(payload) {
+        const body = JSON.stringify({
+            event: payload.event,
+            agentId: payload.agentId,
+            agentName: payload.agentName,
+            message: payload.message,
+            data: payload.data,
+            timestamp: payload.timestamp.toISOString(),
+        });
+        await Promise.all(this.urls.map(async (url) => {
+            try {
+                const response = await fetch(url, {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body,
+                    signal: AbortSignal.timeout(10000),
+                });
+                if (!response.ok) {
+                    console.warn(`[grillo:webhook] ${url} responded ${response.status}`);
+                }
+            }
+            catch (error) {
+                console.warn(`[grillo:webhook] Failed to post to ${url}:`, error instanceof Error ? error.message : error);
+            }
+        }));
+    }
+}
+// ================================================================
+// Helpers
+// ================================================================
+function eventEmoji(event) {
+    switch (event) {
+        case "assessment_failed":
+            return "[FAIL]";
+        case "assessment_passed":
+            return "[PASS]";
+        case "certification_expired":
+            return "[EXPIRED]";
+        case "drift_warning":
+            return "[DRIFT]";
+        case "fleet_anomaly":
+            return "[ANOMALY]";
+        case "agent_discovered":
+            return "[NEW]";
+        case "escalation_timeout":
+            return "[TIMEOUT]";
+        case "fleet_assessment_complete":
+            return "[FLEET]";
+        default:
+            return "[INFO]";
+    }
+}
+//# sourceMappingURL=notifier.js.map

package/dist/notifications/notifier.js.map

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

package/dist/notifications/templates.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Grillo Cricket — Notification Templates
+ *
+ * Pre-built notification messages for common events.
+ * These produce structured NotificationPayload objects.
+ */
+import type { NotificationPayload, AgentRecord, AssessmentResult, DriftReport, FleetAnomalyReport, FleetAssessmentResult } from "../registry/types.js";
+export declare function assessmentFailedNotification(agent: AgentRecord, result: AssessmentResult): NotificationPayload;
+export declare function assessmentPassedNotification(agent: AgentRecord, result: AssessmentResult): NotificationPayload;
+export declare function driftWarningNotification(agent: AgentRecord, report: DriftReport): NotificationPayload;
+export declare function fleetAnomalyNotification(anomaly: FleetAnomalyReport): NotificationPayload;
+export declare function certificationExpiredNotification(agent: AgentRecord): NotificationPayload;
+export declare function fleetAssessmentCompleteNotification(result: FleetAssessmentResult): NotificationPayload;
+//# sourceMappingURL=templates.d.ts.map

package/dist/notifications/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/notifications/templates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAM9B,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,gBAAgB,GACvB,mBAAmB,CAoBrB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,gBAAgB,GACvB,mBAAmB,CAarB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,WAAW,GAClB,mBAAmB,CAmBrB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,kBAAkB,GAC1B,mBAAmB,CAYrB;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,WAAW,GACjB,mBAAmB,CAYrB;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,qBAAqB,GAC5B,mBAAmB,CAoBrB"}

package/dist/notifications/templates.js

@@ -0,0 +1,105 @@
+/**
+ * Grillo Cricket — Notification Templates
+ *
+ * Pre-built notification messages for common events.
+ * These produce structured NotificationPayload objects.
+ */
+// ================================================================
+// Template Functions
+// ================================================================
+export function assessmentFailedNotification(agent, result) {
+    const failedDims = Object.entries(result.scores)
+        .filter(([_, score]) => score < 6.0)
+        .map(([dim]) => dim);
+    return {
+        event: "assessment_failed",
+        agentId: agent.agentId,
+        agentName: agent.agentName,
+        message: `${agent.agentName} FAILED ${result.framework} assessment — ${result.classification}. Failed dimensions: ${failedDims.join(", ")}`,
+        data: {
+            classification: result.classification,
+            scores: result.scores,
+            failedDimensions: failedDims,
+            verifyUrl: result.verifyUrl,
+            framework: result.framework,
+            level: result.level,
+        },
+        timestamp: new Date(),
+    };
+}
+export function assessmentPassedNotification(agent, result) {
+    return {
+        event: "assessment_passed",
+        agentId: agent.agentId,
+        agentName: agent.agentName,
+        message: `${agent.agentName} PASSED ${result.framework} assessment — ${result.classification}`,
+        data: {
+            classification: result.classification,
+            scores: result.scores,
+            verifyUrl: result.verifyUrl,
+        },
+        timestamp: new Date(),
+    };
+}
+export function driftWarningNotification(agent, report) {
+    const worstDim = Object.entries(report.dimensionDrifts).sort(([_, a], [__, b]) => Math.abs(b) - Math.abs(a))[0];
+    return {
+        event: "drift_warning",
+        agentId: agent.agentId,
+        agentName: agent.agentName,
+        message: `Score drift detected for ${agent.agentName}: TDI=${report.tdi.toFixed(4)} (${report.severity}). Worst dimension: ${worstDim?.[0]} (${worstDim?.[1] > 0 ? "+" : ""}${(worstDim?.[1]).toFixed(1)})`,
+        data: {
+            tdi: report.tdi,
+            severity: report.severity,
+            dimensionDrifts: report.dimensionDrifts,
+            baseline: report.baseline,
+            current: report.current,
+        },
+        timestamp: new Date(),
+    };
+}
+export function fleetAnomalyNotification(anomaly) {
+    return {
+        event: "fleet_anomaly",
+        message: anomaly.description,
+        data: {
+            anomalyType: anomaly.anomalyType,
+            commonFactor: anomaly.commonFactor,
+            affectedAgents: anomaly.affectedAgents,
+            averageTDI: anomaly.averageTDI,
+        },
+        timestamp: new Date(),
+    };
+}
+export function certificationExpiredNotification(agent) {
+    return {
+        event: "certification_expired",
+        agentId: agent.agentId,
+        agentName: agent.agentName,
+        message: `Certification expired for ${agent.agentName}. Reassessment required.`,
+        data: {
+            lastAssessedAt: agent.lastAssessedAt?.toISOString(),
+            certificationStatus: agent.certificationStatus,
+        },
+        timestamp: new Date(),
+    };
+}
+export function fleetAssessmentCompleteNotification(result) {
+    const passRate = result.assessed > 0
+        ? ((result.passed / result.assessed) * 100).toFixed(0)
+        : "0";
+    return {
+        event: "fleet_assessment_complete",
+        message: `Fleet assessment complete: ${result.passed}/${result.assessed} passed (${passRate}%), ${result.failed} failed, ${result.errors} errors`,
+        data: {
+            totalAgents: result.totalAgents,
+            assessed: result.assessed,
+            passed: result.passed,
+            failed: result.failed,
+            errors: result.errors,
+            durationMs: result.completedAt.getTime() - result.startedAt.getTime(),
+        },
+        timestamp: new Date(),
+    };
+}
+//# sourceMappingURL=templates.js.map

package/dist/notifications/templates.js.map

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

package/dist/orchestration/orchestrator.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Grillo Cricket — Assessment Orchestrator
+ *
+ * Central coordinator: pulls agents from the registry, builds a prioritized
+ * queue, and drives assessments through the CompSi SDK. Uses the SAME proven
+ * pattern from @aiassesstech/openclaw-plugin (direct provider API calls via
+ * AIAssessClient.assess + withRetry callback).
+ *
+ * This module is intentionally OpenClaw-agnostic. It receives a "model invoker"
+ * function so the caller can wire it to whatever runtime they use.
+ */
+import { AgentRegistry } from "../registry/agent-registry.js";
+import type { AgentRecord, AssessmentResult, FleetAssessmentResult } from "../registry/types.js";
+import type { GrilloConfig } from "../config/schema.js";
+import type { Notifier } from "../notifications/notifier.js";
+import { FrameworkRegistry } from "../frameworks/framework-registry.js";
+import { DriftDetector } from "../drift/detector.js";
+import type { AuditLog } from "../audit/audit-log.js";
+/**
+ * Function that routes a question to a specific model and returns the response.
+ * Same signature proven in the openclaw-plugin: (modelId, question) => answer.
+ */
+export type ModelInvoker = (modelId: string, question: string) => Promise<string>;
+export interface AssessmentProgress {
+    agentId: string;
+    agentName: string;
+    questionsAnswered: number;
+    questionsTotal: number;
+    phase: "queued" | "assessing" | "scoring" | "complete" | "error";
+    message?: string;
+}
+export type ProgressCallback = (progress: AssessmentProgress) => void;
+export declare class GrilloOrchestrator {
+    private readonly registry;
+    private readonly config;
+    private readonly invokeModel;
+    private readonly notifier;
+    readonly frameworkRegistry: FrameworkRegistry;
+    private readonly driftDetector;
+    private readonly auditLog;
+    private running;
+    private abortController;
+    constructor(params: {
+        registry: AgentRegistry;
+        config: GrilloConfig;
+        invokeModel: ModelInvoker;
+        notifier?: Notifier;
+        frameworkRegistry?: FrameworkRegistry;
+        driftDetector?: DriftDetector;
+        auditLog?: AuditLog;
+    });
+    /**
+     * Assess a single agent. Core method used by both individual and fleet flows.
+     * Uses the same proven pattern: AIAssessClient.assess + withRetry callback.
+     *
+     * Phase 3: Now enforces hierarchical gating. If hierarchicalMode is enabled
+     * and the requested level's prerequisites aren't met, the assessment is rejected.
+     */
+    assessAgent(agent: AgentRecord, options?: {
+        framework?: string;
+        level?: number;
+        dryRun?: boolean;
+        onProgress?: ProgressCallback;
+    }): Promise<AssessmentResult>;
+    /**
+     * Assess the next available level for an agent.
+     * Automatically determines which framework/level to run based on progress.
+     */
+    assessNextLevel(agent: AgentRecord, options?: {
+        dryRun?: boolean;
+        onProgress?: ProgressCallback;
+    }): Promise<AssessmentResult>;
+    /**
+     * Run all unlocked levels in sequence for an agent.
+     * Stops at the first failure (higher levels depend on lower ones passing).
+     */
+    assessFullHierarchy(agent: AgentRecord, options?: {
+        dryRun?: boolean;
+        onProgress?: ProgressCallback;
+    }): Promise<AssessmentResult[]>;
+    /**
+     * Assess all agents (or a filtered subset) in priority order.
+     * Respects parallelAssessments concurrency limit from config.
+     */
+    assessFleet(options?: {
+        agentIds?: string[];
+        dryRun?: boolean;
+        onProgress?: ProgressCallback;
+    }): Promise<FleetAssessmentResult>;
+    /**
+     * Abort a running fleet assessment.
+     */
+    abort(): void;
+    /**
+     * Whether a fleet assessment is currently running.
+     */
+    get isRunning(): boolean;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestration/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestration/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EACV,WAAW,EAEX,gBAAgB,EAChB,qBAAqB,EAEtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,MAAM,CAAC,CAAC;AAMrB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAMtE,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAE3C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAgC;gBAE3C,MAAM,EAAE;QAClB,QAAQ,EAAE,aAAa,CAAC;QACxB,MAAM,EAAE,YAAY,CAAC;QACrB,WAAW,EAAE,YAAY,CAAC;QAC1B,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;QACtC,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACrB;IAcD;;;;;;OAMG;IACG,WAAW,CACf,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,UAAU,CAAC,EAAE,gBAAgB,CAAC;KAC1B,GACL,OAAO,CAAC,gBAAgB,CAAC;IA4P5B;;;OAGG;IACG,eAAe,CACnB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;KAAO,GAChE,OAAO,CAAC,gBAAgB,CAAC;IA0B5B;;;OAGG;IACG,mBAAmB,CACvB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;KAAO,GAChE,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA2C9B;;;OAGG;IACG,WAAW,CAAC,OAAO,GAAE;QACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,UAAU,CAAC,EAAE,gBAAgB,CAAC;KAC1B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA0FvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF"}