aimeat 1.7.0 → 1.9.0

package/dist/src/services/webhook-dispatcher.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @file webhook-dispatcher.ts
+ * @description Webhook delivery service for the AIMEAT push layer.
+ *   Loads an agent's webhook configuration, validates the target URL,
+ *   signs the payload with HMAC-SHA256, and fires HTTP POST with retry.
+ *   Auto-disables webhooks after 10 consecutive failures.
+ *   Logs every delivery attempt (success or failure) and prunes old entries.
+ *
+ * @structure
+ *   - createWebhookDispatcher({ config, storage }) -- factory, returns { dispatchWebhookEvent }
+ *   - dispatchWebhookEvent(agentGaii, event, data) -- main entry point
+ *   - fireWithRetry(url, body, secret, attempt) -- recursive retry with backoff
+ *   - onSuccess(agentGaii) -- resets fail counter
+ *   - onFailure(agentGaii, failCount) -- increments counter, auto-disables at threshold
+ *   - logDelivery(agentGaii, event, payload, result) -- persists + prunes
+ *
+ * @usage
+ *   import { createWebhookDispatcher } from '../services/webhook-dispatcher.js';
+ *   const { dispatchWebhookEvent } = createWebhookDispatcher({ config, storage });
+ *   await dispatchWebhookEvent('claude#alice@node', 'task.queued', { task_id: '...' });
+ *
+ * @maintenance Adding a new webhook event type:
+ *   1. Define the payload schema in webhook-schemas.ts:
+ *      - Add a Zod schema for the new event's `data` field
+ *      - Use snake_case for all field names (vendor contract)
+ *      - Include the standard envelope (version, event, timestamp, node_id, agent_gaii)
+ *      - Document "Expected agent action" in a comment above the schema
+ *   2. Add the event constant to WEBHOOK_EVENTS in webhook-schemas.ts
+ *   3. Add the dispatch call in the relevant route handler:
+ *      - Import dispatchWebhookEvent from webhook-dispatcher.ts
+ *      - Call it AFTER the storage write succeeds, BEFORE res.json()
+ *      - Pass the agent's GAII so the dispatcher can resolve webhook config
+ *   4. Add MCP notification (parallel delivery):
+ *      - In the same route handler, call mcpServer.notify() with the matching event name
+ *      - MCP uses the same event name (e.g., 'notifications/tasks/failed')
+ *   5. Update the skill bundle SKILL.md template:
+ *      - Add the event to the "Events you may receive" list
+ *      - Document the expected agent action
+ *   6. Update openapi.yaml:
+ *      - Add the event to the webhook events enum
+ *      - Add the payload schema to components/schemas
+ *   7. Update locales (en.json + fi.json):
+ *      - Add delivery log display string for the event
+ *   8. Add E2E test:
+ *      - Test that the event fires on the correct trigger
+ *      - Test payload shape matches schema
+ *      - Test HMAC signature is valid
+ *   9. Update this header's event list below.
+ *
+ *   Current event types (v1):
+ *     task.queued, task.approved, task.updated, task.paused,
+ *     message.inbound, directive.updated, onboarding.step
+ *
+ *   Versioning: new event types are non-breaking (v1 stays).
+ *   Consumers MUST ignore unknown event types.
+ *   See: docs/superpowers/specs/2026-05-23-agent-integration-architecture-design.md, Appendix A
+ *
+ * @version-history
+ *   v1.0.0 -- 2026-05-23 -- Initial creation with retry, HMAC signing, auto-disable
+ */
+import type { Storage } from '../storage/interface.js';
+import type { AimeatConfig } from '../config.js';
+import { type WebhookEventType } from '../models/webhook-schemas.js';
+export interface DispatchOptions {
+    config: AimeatConfig;
+    storage: Storage;
+}
+export declare function createWebhookDispatcher({ config, storage }: DispatchOptions): {
+    dispatchWebhookEvent: (agentGaii: string, event: WebhookEventType, data: Record<string, unknown>) => Promise<void>;
+};
+//# sourceMappingURL=webhook-dispatcher.d.ts.map

package/dist/src/services/webhook-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/services/webhook-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EAAE,KAAK,gBAAgB,EAA6C,MAAM,8BAA8B,CAAC;AAkBhH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAYD,wBAAgB,uBAAuB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,eAAe;sCAO7D,MAAM,SACV,gBAAgB,QACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,IAAI,CAAC;EAwNjB"}

package/dist/src/services/webhook-dispatcher.js

@@ -0,0 +1,259 @@
+/**
+ * @file webhook-dispatcher.ts
+ * @description Webhook delivery service for the AIMEAT push layer.
+ *   Loads an agent's webhook configuration, validates the target URL,
+ *   signs the payload with HMAC-SHA256, and fires HTTP POST with retry.
+ *   Auto-disables webhooks after 10 consecutive failures.
+ *   Logs every delivery attempt (success or failure) and prunes old entries.
+ *
+ * @structure
+ *   - createWebhookDispatcher({ config, storage }) -- factory, returns { dispatchWebhookEvent }
+ *   - dispatchWebhookEvent(agentGaii, event, data) -- main entry point
+ *   - fireWithRetry(url, body, secret, attempt) -- recursive retry with backoff
+ *   - onSuccess(agentGaii) -- resets fail counter
+ *   - onFailure(agentGaii, failCount) -- increments counter, auto-disables at threshold
+ *   - logDelivery(agentGaii, event, payload, result) -- persists + prunes
+ *
+ * @usage
+ *   import { createWebhookDispatcher } from '../services/webhook-dispatcher.js';
+ *   const { dispatchWebhookEvent } = createWebhookDispatcher({ config, storage });
+ *   await dispatchWebhookEvent('claude#alice@node', 'task.queued', { task_id: '...' });
+ *
+ * @maintenance Adding a new webhook event type:
+ *   1. Define the payload schema in webhook-schemas.ts:
+ *      - Add a Zod schema for the new event's `data` field
+ *      - Use snake_case for all field names (vendor contract)
+ *      - Include the standard envelope (version, event, timestamp, node_id, agent_gaii)
+ *      - Document "Expected agent action" in a comment above the schema
+ *   2. Add the event constant to WEBHOOK_EVENTS in webhook-schemas.ts
+ *   3. Add the dispatch call in the relevant route handler:
+ *      - Import dispatchWebhookEvent from webhook-dispatcher.ts
+ *      - Call it AFTER the storage write succeeds, BEFORE res.json()
+ *      - Pass the agent's GAII so the dispatcher can resolve webhook config
+ *   4. Add MCP notification (parallel delivery):
+ *      - In the same route handler, call mcpServer.notify() with the matching event name
+ *      - MCP uses the same event name (e.g., 'notifications/tasks/failed')
+ *   5. Update the skill bundle SKILL.md template:
+ *      - Add the event to the "Events you may receive" list
+ *      - Document the expected agent action
+ *   6. Update openapi.yaml:
+ *      - Add the event to the webhook events enum
+ *      - Add the payload schema to components/schemas
+ *   7. Update locales (en.json + fi.json):
+ *      - Add delivery log display string for the event
+ *   8. Add E2E test:
+ *      - Test that the event fires on the correct trigger
+ *      - Test payload shape matches schema
+ *      - Test HMAC signature is valid
+ *   9. Update this header's event list below.
+ *
+ *   Current event types (v1):
+ *     task.queued, task.approved, task.updated, task.paused,
+ *     message.inbound, directive.updated, onboarding.step
+ *
+ *   Versioning: new event types are non-breaking (v1 stays).
+ *   Consumers MUST ignore unknown event types.
+ *   See: docs/superpowers/specs/2026-05-23-agent-integration-architecture-design.md, Appendix A
+ *
+ * @version-history
+ *   v1.0.0 -- 2026-05-23 -- Initial creation with retry, HMAC signing, auto-disable
+ */
+import { createHmac, randomUUID } from 'node:crypto';
+import { validateOutboundUrl } from '../utils/url-validator.js';
+import { logger } from '../utils/logger.js';
+import { buildWebhookEnvelope } from '../models/webhook-schemas.js';
+// ── Constants ──────────────────────────────────────────────────────────
+/** Retry delays in ms: 5s, 30s, 2min */
+const RETRY_DELAYS_MS = [5_000, 30_000, 120_000];
+/** Auto-disable webhook after this many consecutive failures */
+const MAX_CONSECUTIVE_FAILURES = 10;
+/** Keep only the last N delivery log entries per agent */
+const DELIVERY_LOG_KEEP = 50;
+/** HTTP timeout for each delivery attempt */
+const FETCH_TIMEOUT_MS = 10_000;
+// ── Factory ────────────────────────────────────────────────────────────
+export function createWebhookDispatcher({ config, storage }) {
+    /**
+     * Main entry point: dispatch a webhook event to an agent's configured URL.
+     * Returns silently if the agent has no webhook configured or it is disabled.
+     */
+    async function dispatchWebhookEvent(agentGaii, event, data) {
+        // Load agent record
+        const agent = await storage.getAgent(agentGaii);
+        if (!agent) {
+            logger.warn('Webhook dispatch: agent not found', { agentGaii, event });
+            return;
+        }
+        // Check webhook is configured and enabled
+        if (!agent.webhookUrl || !agent.webhookEnabled) {
+            logger.debug('Webhook dispatch: skipped (not configured or disabled)', { agentGaii, event });
+            return;
+        }
+        if (!agent.webhookSecret) {
+            logger.warn('Webhook dispatch: skipped (no secret configured)', { agentGaii, event });
+            return;
+        }
+        // Validate URL (SSRF protection)
+        const urlCheck = await validateOutboundUrl(agent.webhookUrl);
+        if (!urlCheck.valid) {
+            logger.warn('Webhook dispatch: URL validation failed', {
+                agentGaii,
+                event,
+                url: agent.webhookUrl,
+                reason: urlCheck.reason,
+            });
+            await onFailure(agentGaii, agent.webhookFailCount ?? 0);
+            await logDelivery(agentGaii, event, data, {
+                status: 'failed',
+                errorMessage: `URL validation failed: ${urlCheck.reason}`,
+                attemptCount: 0,
+                latencyMs: 0,
+            });
+            return;
+        }
+        // Build the signed payload
+        const envelope = buildWebhookEnvelope(event, config.nodeId, agentGaii, data);
+        const body = JSON.stringify(envelope);
+        // Fire with retry (async, does not block the caller's response)
+        fireWithRetry(agentGaii, agent.webhookUrl, body, agent.webhookSecret, event, data, 0);
+    }
+    /**
+     * Fire HTTP POST with exponential backoff retry.
+     * Each attempt has a 10s timeout. Retries are scheduled via setTimeout
+     * so the caller is not blocked.
+     */
+    function fireWithRetry(agentGaii, url, body, secret, event, data, attempt) {
+        const startMs = Date.now();
+        // HMAC-SHA256 signature
+        const signature = createHmac('sha256', secret).update(body).digest('hex');
+        fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-AIMEAT-Signature': `sha256=${signature}`,
+                'X-AIMEAT-Event': event,
+                'X-AIMEAT-Delivery': randomUUID(),
+            },
+            body,
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+        })
+            .then(async (response) => {
+            const latencyMs = Date.now() - startMs;
+            if (response.ok) {
+                // Success (2xx)
+                logger.info('Webhook delivered', { agentGaii, event, attempt: attempt + 1, httpStatus: response.status, latencyMs });
+                await onSuccess(agentGaii);
+                await logDelivery(agentGaii, event, data, {
+                    status: 'success',
+                    httpStatus: response.status,
+                    attemptCount: attempt + 1,
+                    latencyMs,
+                });
+            }
+            else {
+                // Non-2xx response -- treat as failure
+                const errorMessage = `HTTP ${response.status} ${response.statusText}`;
+                logger.warn('Webhook delivery failed (non-2xx)', { agentGaii, event, attempt: attempt + 1, httpStatus: response.status });
+                await handleRetryOrFail(agentGaii, url, body, secret, event, data, attempt, errorMessage, response.status, latencyMs);
+            }
+        })
+            .catch(async (err) => {
+            const latencyMs = Date.now() - startMs;
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            logger.warn('Webhook delivery failed (network)', { agentGaii, event, attempt: attempt + 1, error: errorMessage });
+            await handleRetryOrFail(agentGaii, url, body, secret, event, data, attempt, errorMessage, undefined, latencyMs);
+        });
+    }
+    /**
+     * Decide whether to retry or record final failure.
+     */
+    async function handleRetryOrFail(agentGaii, url, body, secret, event, data, attempt, errorMessage, httpStatus, latencyMs) {
+        if (attempt < RETRY_DELAYS_MS.length) {
+            // Schedule retry
+            const delayMs = RETRY_DELAYS_MS[attempt];
+            logger.info('Webhook retry scheduled', { agentGaii, event, attempt: attempt + 1, nextAttempt: attempt + 2, delayMs });
+            setTimeout(() => {
+                fireWithRetry(agentGaii, url, body, secret, event, data, attempt + 1);
+            }, delayMs);
+        }
+        else {
+            // All retries exhausted
+            logger.error('Webhook delivery failed permanently', { agentGaii, event, totalAttempts: attempt + 1 });
+            // Load current fail count (may have changed during retries)
+            const agent = await storage.getAgent(agentGaii);
+            const currentFailCount = agent?.webhookFailCount ?? 0;
+            await onFailure(agentGaii, currentFailCount);
+            await logDelivery(agentGaii, event, data, {
+                status: 'failed',
+                httpStatus,
+                errorMessage,
+                attemptCount: attempt + 1,
+                latencyMs,
+            });
+        }
+    }
+    /**
+     * Handle successful delivery: reset fail counter and record timestamp.
+     */
+    async function onSuccess(agentGaii) {
+        try {
+            await storage.updateAgent(agentGaii, {
+                webhookFailCount: 0,
+                webhookLastSuccess: new Date().toISOString(),
+            });
+        }
+        catch (err) {
+            logger.error('Failed to update agent webhook success state', { agentGaii, error: err });
+        }
+    }
+    /**
+     * Handle failed delivery: increment fail counter, auto-disable at threshold.
+     */
+    async function onFailure(agentGaii, currentFailCount) {
+        const newFailCount = currentFailCount + 1;
+        try {
+            const updates = {
+                webhookFailCount: newFailCount,
+                webhookLastFailure: new Date().toISOString(),
+            };
+            if (newFailCount >= MAX_CONSECUTIVE_FAILURES) {
+                updates.webhookEnabled = false;
+                logger.warn('Webhook auto-disabled after consecutive failures', {
+                    agentGaii,
+                    failCount: newFailCount,
+                    threshold: MAX_CONSECUTIVE_FAILURES,
+                });
+            }
+            await storage.updateAgent(agentGaii, updates);
+        }
+        catch (err) {
+            logger.error('Failed to update agent webhook failure state', { agentGaii, error: err });
+        }
+    }
+    /**
+     * Persist a delivery log entry and prune old records.
+     */
+    async function logDelivery(agentGaii, event, data, result) {
+        const log = {
+            id: randomUUID(),
+            agentGaii,
+            event,
+            payload: data,
+            status: result.status,
+            httpStatus: result.httpStatus,
+            errorMessage: result.errorMessage,
+            attemptCount: result.attemptCount,
+            latencyMs: result.latencyMs,
+            createdAt: new Date().toISOString(),
+        };
+        try {
+            await storage.appendDeliveryLog(log);
+            await storage.pruneDeliveryLog(agentGaii, DELIVERY_LOG_KEEP);
+        }
+        catch (err) {
+            logger.error('Failed to persist webhook delivery log', { agentGaii, event, error: err });
+        }
+    }
+    return { dispatchWebhookEvent };
+}
+//# sourceMappingURL=webhook-dispatcher.js.map

package/dist/src/services/webhook-dispatcher.js.map

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

package/dist/src/storage/interface.d.ts

@@ -30,6 +30,18 @@ export interface AgentRecord {
     technicalCapabilities?: AgentTechnicalCapability[];
     domainCapabilities?: string[];
     activityStats?: AgentActivityStats;
+    modulesLoaded?: string[];
+    agentLimitations?: string[];
+    webhookUrl?: string;
+    webhookSecret?: string;
+    webhookEnabled?: boolean;
+    webhookLastSuccess?: string;
+    webhookLastFailure?: string;
+    webhookFailCount?: number;
+    platform?: string;
+    platformVersion?: string;
+    platformDetectedBy?: 'auto' | 'self_report' | 'message_reply';
+    tags?: string[];
 }
 export interface MemoryRecord {
     key: string;
@@ -1297,7 +1309,7 @@ export interface AgentTaskRecord {
         memoryPrefixes?: string[];
     };
     todos: AgentTaskTodo[];
-    status: 'draft' | 'queued' | 'active' | 'stalled' | 'done' | 'failed';
+    status: 'draft' | 'queued' | 'active' | 'paused' | 'stalled' | 'done' | 'failed';
     parentTaskId?: string;
     workTrackingCode?: string;
     telemetry?: {
@@ -1335,12 +1347,19 @@ export interface DirectiveResource {
     reference: string;
     description: string;
 }
+export interface BudgetLimits {
+    maxTokensPerTask?: number;
+    maxTokensPerDay?: number;
+    maxTasksPerDay?: number;
+    alertThreshold?: number;
+}
 export interface AgentDirectivesRecord {
     agentGaii: string;
     purpose: string;
     rules: DirectiveRule[];
     memoryAreas: DirectiveMemoryArea[];
     resources: DirectiveResource[];
+    budgetLimits?: BudgetLimits;
     updatedAt: string;
 }
 export interface OwnerAgentDefaults {
@@ -1415,6 +1434,65 @@ export interface AgentMessageRecord {
     createdAt: string;
     processedAt?: string;
 }
+export interface TelemetryEvent {
+    id: string;
+    agentGaii: string;
+    type: 'llm_call' | 'tool_call' | 'agent_report';
+    data: Record<string, unknown>;
+    sessionId?: string;
+    taskId?: string;
+    createdAt: string;
+}
+export interface WebhookDeliveryLog {
+    id: string;
+    agentGaii: string;
+    event: string;
+    payload: Record<string, unknown>;
+    status: 'success' | 'failed';
+    httpStatus?: number;
+    errorMessage?: string;
+    attemptCount: number;
+    latencyMs: number;
+    createdAt: string;
+}
+export interface AgentOnboardingStep {
+    id: string;
+    order: number;
+    title: string;
+    description: string;
+    status: 'pending' | 'passed' | 'failed' | 'skipped';
+    required: boolean;
+    validatedAt?: string;
+    validationMethod: 'automatic' | 'api_call' | 'owner_confirm';
+    details?: Record<string, unknown>;
+    failureReason?: string;
+}
+export interface AgentOnboardingRecord {
+    agentGaii: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'failed';
+    startedAt: string;
+    completedAt?: string;
+    steps: AgentOnboardingStep[];
+    readinessScore?: number;
+    readinessLevel?: 'basic' | 'standard' | 'full' | 'expert';
+    detectedPlatform?: string;
+    installedRuntime?: string;
+    onboardingBaseline?: number;
+    operationalHealth?: number;
+    healthComponents?: {
+        deliveryHealth: number;
+        telemetryContinuity: number;
+        taskCompletion: number;
+    };
+    healthRecalculatedAt?: string;
+    readinessOverride?: {
+        level: 'basic' | 'standard' | 'full' | 'expert';
+        setBy: string;
+        setAt: string;
+        expiresAt: string;
+        reason?: string;
+    };
+}
 import type { OwnerRepository } from './repositories/owner.repository.js';
 import type { AgentRepository } from './repositories/agent.repository.js';
 import type { MemoryRepository } from './repositories/memory.repository.js';
@@ -1459,6 +1537,8 @@ import type { AgentDirectivesRepository } from './repositories/agent-directives.
 import type { SharingGroupRepository } from './repositories/sharing-group.repository.js';
 import type { AgentActivityRepository } from './repositories/agent-activity.repository.js';
 import type { AgentMessageRepository } from './repositories/agent-message.repository.js';
-export interface Storage extends OwnerRepository, AgentRepository, MemoryRepository, ActionRepository, WorkRepository, WalletRepository, BoardRepository, OtkRepository, DisputeRepository, MicroMemoryRepository, FileRepository, IdentityRepository, SchemaRepository, ConsentRepository, CatalogueRepository, ModerationRepository, OrganismRepository, MarketplaceRepository, FederationRepository, NodeRepository, NotificationRepository, AuthRepository, SessionRepository, AppRepository, AppMarketplaceRepository, ConfigRepository, NotificationTemplateRepository, KnowledgeRepository, SchedulerRepository, ExtensionInstanceRepository, ReplicationQueueRepository, DeviceAuthRepository, OAuthRepository, SystemPromptRepository, PackageRepository, TemplateListingRepository, PackageInstanceRepository, CapabilityRepository, AgentTaskRepository, AgentDirectivesRepository, SharingGroupRepository, AgentActivityRepository, AgentMessageRepository, StatsRepository {
+import type { AgentTelemetryRepository, AgentWebhookRepository } from './repositories/agent-webhook.repository.js';
+import type { AgentOnboardingRepository } from './repositories/agent-onboarding.repository.js';
+export interface Storage extends OwnerRepository, AgentRepository, MemoryRepository, ActionRepository, WorkRepository, WalletRepository, BoardRepository, OtkRepository, DisputeRepository, MicroMemoryRepository, FileRepository, IdentityRepository, SchemaRepository, ConsentRepository, CatalogueRepository, ModerationRepository, OrganismRepository, MarketplaceRepository, FederationRepository, NodeRepository, NotificationRepository, AuthRepository, SessionRepository, AppRepository, AppMarketplaceRepository, ConfigRepository, NotificationTemplateRepository, KnowledgeRepository, SchedulerRepository, ExtensionInstanceRepository, ReplicationQueueRepository, DeviceAuthRepository, OAuthRepository, SystemPromptRepository, PackageRepository, TemplateListingRepository, PackageInstanceRepository, CapabilityRepository, AgentTaskRepository, AgentDirectivesRepository, SharingGroupRepository, AgentActivityRepository, AgentMessageRepository, AgentTelemetryRepository, AgentWebhookRepository, AgentOnboardingRepository, StatsRepository {
 }
 //# sourceMappingURL=interface.d.ts.map