aimeat 1.7.0 → 1.9.0

package/dist/src/services/skill-bundle/generic-adapter.js

@@ -0,0 +1,96 @@
+/**
+ * @file generic-adapter.ts
+ * @description Generic fallback runtime adapter for skill bundle generation.
+ *   Produces aimeat-agent bundle with minimal SKILL.md + references only.
+ *   Used for runtimes without a dedicated adapter.
+ * @version-history
+ *   v1.0.0 -- 2026-05-23 -- Initial creation for Agent Integration Phase A
+ */
+import { computeBundleVersion } from './generator.js';
+export class GenericAdapter {
+    runtime = 'generic';
+    bundleName = 'aimeat-agent';
+    generate(ctx, references) {
+        const files = [
+            { path: 'SKILL.md', content: this.renderSkillMd(ctx) },
+            ...references,
+        ];
+        const metadata = {
+            bundleName: this.bundleName,
+            runtime: this.runtime,
+            version: '',
+            agentName: ctx.agentName,
+            agentGaii: ctx.agentGaii,
+            nodeId: ctx.nodeId,
+            nodeUrl: ctx.nodeUrl,
+            generatedAt: new Date().toISOString(),
+        };
+        const bundle = { metadata, files };
+        bundle.metadata.version = computeBundleVersion(bundle);
+        return bundle;
+    }
+    renderSkillMd(ctx) {
+        const rulesBlock = ctx.directives.rules.length > 0
+            ? ctx.directives.rules.map((r, i) => `${i + 1}. ${r.description}`).join('\n')
+            : 'No specific rules configured.';
+        return `# AIMEAT Agent Integration
+
+## Identity
+- Agent: ${ctx.agentName}
+- GAII: ${ctx.agentGaii}
+- Node: ${ctx.nodeUrl} (${ctx.nodeId})
+
+## Quick Start
+1. Authenticate with your Bearer token
+2. Check inbox: GET ${ctx.nodeUrl}/v1/agents/me/inbox
+3. Propose todos for queued tasks: PATCH /v1/agents/me/tasks/{id}
+4. Wait for owner approval before executing
+5. Report progress via task events
+6. Complete tasks when done
+
+## Directives
+${rulesBlock}
+
+## Setup (Manual)
+This is a generic skill bundle. You will need to manually configure:
+- Polling: set up a cron job or scheduled task to poll the inbox endpoint
+- Telemetry: POST to /v1/agents/me/telemetry after each LLM call
+- Webhook (optional): PUT /v1/agents/me/webhook to register a push endpoint
+
+See the references/ directory for full API documentation.
+
+## After Onboarding: Register Commands and Config
+
+These steps are required after completing Hello Integration. They make your capabilities visible in the owner's dashboard.
+
+### Register Commands (owner sees these in Messages tab)
+\`\`\`
+POST ${ctx.nodeUrl}/v1/memory
+{ "key": "agents.${ctx.agentName}.commands", "value": [
+  { "name": "/status", "description": "Show current agent status", "category": "general" },
+  { "name": "/inbox", "description": "Check inbox for tasks and messages", "category": "tasks" }
+], "visibility": "owner" }
+\`\`\`
+The value MUST be a flat array of { name, description, category }. Each name starts with /.
+
+### Push Config Files (owner sees these in Agent Config tab)
+\`\`\`
+POST ${ctx.nodeUrl}/v1/memory
+{ "key": "agents.config.watchdog", "value": {
+  "script": "path/to/your/watchdog",
+  "poll_interval": "60s",
+  "platform": "your-platform"
+}, "visibility": "owner" }
+\`\`\`
+
+## References
+- references/api-overview.md -- Endpoints, auth, response format
+- references/task-lifecycle.md -- Task states and flow
+- references/message-protocol.md -- Messages, threads, slash commands
+- references/telemetry-protocol.md -- Token usage reporting
+- references/capability-report.md -- Declaring capabilities
+- references/error-protocol.md -- Error handling and retry strategy
+`;
+    }
+}
+//# sourceMappingURL=generic-adapter.js.map

package/dist/src/services/skill-bundle/generic-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-adapter.js","sourceRoot":"","sources":["../../../../src/services/skill-bundle/generic-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,MAAM,OAAO,cAAc;IAChB,OAAO,GAAG,SAAS,CAAC;IACpB,UAAU,GAAG,cAAc,CAAC;IAErC,QAAQ,CAAC,GAAkB,EAAE,UAAwB;QACnD,MAAM,KAAK,GAAiB;YAC1B,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE;YACtD,GAAG,UAAU;SACd,CAAC;QAEF,MAAM,QAAQ,GAAG;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QAEF,MAAM,MAAM,GAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAClD,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,aAAa,CAAC,GAAkB;QACtC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAChD,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC7E,CAAC,CAAC,+BAA+B,CAAC;QAEpC,OAAO;;;WAGA,GAAG,CAAC,SAAS;UACd,GAAG,CAAC,SAAS;UACb,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,MAAM;;;;sBAId,GAAG,CAAC,OAAO;;;;;;;EAO/B,UAAU;;;;;;;;;;;;;;;;OAgBL,GAAG,CAAC,OAAO;mBACC,GAAG,CAAC,SAAS;;;;;;;;;OASzB,GAAG,CAAC,OAAO;;;;;;;;;;;;;;;CAejB,CAAC;IACA,CAAC;CACF"}

package/dist/src/services/skill-bundle/hermes-adapter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file hermes-adapter.ts
+ * @description Hermes (OpenClaw) runtime adapter for skill bundle generation.
+ *   Produces aimeat-hermes bundle with SKILL.md, scripts/, and config/ directories.
+ * @structure
+ *   - HermesAdapter class implementing RuntimeAdapter
+ *   - SKILL.md template with on-wake protocol
+ *   - Shell scripts: poll-inbox.sh, post-telemetry.sh, test-connection.sh
+ *   - YAML configs: webhook-route.yaml, hooks.yaml
+ * @version-history
+ *   v1.0.0 -- 2026-05-23 -- Initial creation for Agent Integration Phase A
+ */
+import type { RuntimeAdapter, BundleContext, BundleFile, BundleContent } from './types.js';
+export declare class HermesAdapter implements RuntimeAdapter {
+    readonly runtime = "hermes";
+    readonly bundleName = "aimeat-hermes";
+    generate(ctx: BundleContext, references: BundleFile[]): BundleContent;
+    private renderSkillMd;
+    private renderPollInbox;
+    private renderPostTelemetry;
+    private renderTestConnection;
+    private renderWebhookRoute;
+    private renderHooksYaml;
+}
+//# sourceMappingURL=hermes-adapter.d.ts.map

package/dist/src/services/skill-bundle/hermes-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-adapter.d.ts","sourceRoot":"","sources":["../../../../src/services/skill-bundle/hermes-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3F,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,OAAO,YAAY;IAC5B,QAAQ,CAAC,UAAU,mBAAmB;IAEtC,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,aAAa;IA2BrE,OAAO,CAAC,aAAa;IAoFrB,OAAO,CAAC,eAAe;IAkEvB,OAAO,CAAC,mBAAmB;IAmC3B,OAAO,CAAC,oBAAoB;IA2C5B,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,eAAe;CAaxB"}

package/dist/src/services/skill-bundle/hermes-adapter.js

@@ -0,0 +1,302 @@
+/**
+ * @file hermes-adapter.ts
+ * @description Hermes (OpenClaw) runtime adapter for skill bundle generation.
+ *   Produces aimeat-hermes bundle with SKILL.md, scripts/, and config/ directories.
+ * @structure
+ *   - HermesAdapter class implementing RuntimeAdapter
+ *   - SKILL.md template with on-wake protocol
+ *   - Shell scripts: poll-inbox.sh, post-telemetry.sh, test-connection.sh
+ *   - YAML configs: webhook-route.yaml, hooks.yaml
+ * @version-history
+ *   v1.0.0 -- 2026-05-23 -- Initial creation for Agent Integration Phase A
+ */
+import { computeBundleVersion } from './generator.js';
+export class HermesAdapter {
+    runtime = 'hermes';
+    bundleName = 'aimeat-hermes';
+    generate(ctx, references) {
+        const files = [
+            { path: 'SKILL.md', content: this.renderSkillMd(ctx) },
+            ...references,
+            { path: 'scripts/poll-inbox.sh', content: this.renderPollInbox(ctx) },
+            { path: 'scripts/post-telemetry.sh', content: this.renderPostTelemetry(ctx) },
+            { path: 'scripts/test-connection.sh', content: this.renderTestConnection(ctx) },
+            { path: 'config/webhook-route.yaml', content: this.renderWebhookRoute(ctx) },
+            { path: 'config/hooks.yaml', content: this.renderHooksYaml(ctx) },
+        ];
+        const metadata = {
+            bundleName: this.bundleName,
+            runtime: this.runtime,
+            version: '',
+            agentName: ctx.agentName,
+            agentGaii: ctx.agentGaii,
+            nodeId: ctx.nodeId,
+            nodeUrl: ctx.nodeUrl,
+            generatedAt: new Date().toISOString(),
+        };
+        const bundle = { metadata, files };
+        bundle.metadata.version = computeBundleVersion(bundle);
+        return bundle;
+    }
+    renderSkillMd(ctx) {
+        const rulesBlock = ctx.directives.rules.length > 0
+            ? ctx.directives.rules.map((r, i) => `${i + 1}. ${r.description}`).join('\n')
+            : 'No specific rules configured.';
+        return `---
+name: aimeat-hermes
+description: AIMEAT node integration for ${ctx.nodeId}
+trigger: when user mentions AIMEAT, tasks, inbox, or this skill is invoked
+---
+
+## Identity
+You are ${ctx.agentName} on AIMEAT node ${ctx.nodeUrl}
+Your GAII: ${ctx.agentGaii}
+
+## On First Run
+1. Complete Hello Integration: GET /v1/agents/me/onboarding (steps auto-validate, test task auto-starts)
+2. Install the watchdog cron job (this delivers AIMEAT messages to you automatically):
+   \`\`\`
+   cp scripts/poll-inbox.sh ~/.hermes/scripts/
+   chmod +x ~/.hermes/scripts/poll-inbox.sh
+   (crontab -l 2>/dev/null; echo "*/5 * * * * ~/.hermes/scripts/poll-inbox.sh") | crontab -
+   \`\`\`
+3. Install the telemetry hook:
+   \`\`\`
+   cp config/hooks.yaml ~/.hermes/config/
+   hermes reload_skills
+   \`\`\`
+4. Register your commands and config in AIMEAT memory (see "After Setup" section in references)
+
+## On Every Wake
+1. Check inbox: GET ${ctx.nodeUrl}/v1/agents/me/inbox?since={cursor}
+2. Queued tasks without todos -> propose plan (PATCH with todos)
+3. Active tasks -> execute next pending todo
+4. Pending messages -> read and respond
+5. Report capabilities if changed
+
+## Directives
+${rulesBlock}
+
+## Events You May Receive (via webhook)
+- task.queued -- Owner created a new task. Fetch and propose todos.
+- task.approved -- Owner approved your plan. Start executing.
+- task.updated -- Owner edited the task. Re-fetch and adjust.
+- task.paused -- Owner paused the task. Stop work immediately.
+- message.inbound -- Owner sent a message. Read and respond.
+- directive.updated -- Directives changed. Re-fetch via GET /directives.
+- onboarding.step -- Onboarding step needs attention.
+
+## After Onboarding: Register Commands and Config
+
+These steps are required after completing Hello Integration.
+
+### Register Commands (owner sees these in Messages tab)
+\`\`\`
+POST ${ctx.nodeUrl}/v1/memory
+{ "key": "agents.${ctx.agentName}.commands", "value": [
+  { "name": "/status", "description": "Show current agent status", "category": "general" },
+  { "name": "/inbox", "description": "Check inbox for tasks and messages", "category": "tasks" }
+], "visibility": "owner" }
+\`\`\`
+The value MUST be a flat array of { name, description, category }. Each name starts with /.
+
+### Push Config Files (owner sees these in Agent Config tab)
+\`\`\`
+POST ${ctx.nodeUrl}/v1/memory
+{ "key": "agents.config.watchdog", "value": {
+  "script": "~/.hermes/aimeat_watchdog.sh",
+  "poll_interval": "60s",
+  "platform": "hermes-agent"
+}, "visibility": "owner" }
+\`\`\`
+
+## References
+See references/ directory for detailed API documentation:
+- api-overview.md -- Endpoints, auth, response format
+- task-lifecycle.md -- Task states and flow
+- message-protocol.md -- Messages, threads, slash commands
+- telemetry-protocol.md -- Token usage reporting
+- capability-report.md -- Declaring capabilities
+- error-protocol.md -- Error handling and retry strategy
+`;
+    }
+    renderPollInbox(ctx) {
+        return `#!/bin/bash
+# poll-inbox.sh -- Cron script for Tier 3 polling fallback
+# Runs in no_agent mode (zero LLM cost). Only wakes the agent if new items exist.
+#
+# Install: copy to ~/.hermes/scripts/ and add to crontab:
+#   */5 * * * * ~/.hermes/scripts/poll-inbox.sh
+
+set -euo pipefail
+
+NODE_URL="${ctx.nodeUrl}"
+AGENT_NAME="${ctx.agentName}"
+CURSOR_FILE="$HOME/.hermes/state/aimeat-cursor"
+
+# Load auth token
+TOKEN=$(hermes auth token 2>/dev/null || echo "")
+if [ -z "$TOKEN" ]; then
+  echo "No auth token available, skipping poll"
+  exit 0
+fi
+
+# Read cursor from previous poll
+CURSOR=""
+if [ -f "$CURSOR_FILE" ]; then
+  CURSOR=$(cat "$CURSOR_FILE")
+fi
+
+# Build URL
+if [ -n "$CURSOR" ]; then
+  URL="$NODE_URL/v1/agents/$AGENT_NAME/inbox?since=$CURSOR"
+else
+  URL="$NODE_URL/v1/agents/$AGENT_NAME/inbox"
+fi
+
+# Poll inbox
+RESPONSE=$(curl -s -w "\\n%{http_code}" \\
+  -H "Authorization: Bearer $TOKEN" \\
+  -H "Accept: application/json" \\
+  "$URL")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | head -n -1)
+
+if [ "$HTTP_CODE" != "200" ]; then
+  echo "Inbox poll failed with HTTP $HTTP_CODE"
+  exit 1
+fi
+
+# Save next cursor
+NEXT_CURSOR=$(echo "$BODY" | jq -r '.data.next_cursor // empty')
+if [ -n "$NEXT_CURSOR" ]; then
+  mkdir -p "$(dirname "$CURSOR_FILE")"
+  echo "$NEXT_CURSOR" > "$CURSOR_FILE"
+fi
+
+# Check if there are new items
+TASK_COUNT=$(echo "$BODY" | jq '.data.queued_tasks | length')
+MSG_COUNT=$(echo "$BODY" | jq '.data.pending_messages | length')
+
+if [ "$TASK_COUNT" -gt 0 ] || [ "$MSG_COUNT" -gt 0 ]; then
+  echo "New items: $TASK_COUNT tasks, $MSG_COUNT messages -- waking agent"
+  hermes wake --reason "AIMEAT inbox: $TASK_COUNT tasks, $MSG_COUNT messages" 2>/dev/null || true
+fi
+`;
+    }
+    renderPostTelemetry(ctx) {
+        return `#!/bin/bash
+# post-telemetry.sh -- Hook script for automatic telemetry reporting
+# Registered as Hermes post_llm_call hook. Fires after every LLM API call.
+#
+# Environment variables set by Hermes:
+#   HERMES_TOKENS_IN, HERMES_TOKENS_OUT, HERMES_MODEL,
+#   HERMES_DURATION_MS, HERMES_SESSION_ID
+
+set -euo pipefail
+
+NODE_URL="${ctx.nodeUrl}"
+AGENT_NAME="${ctx.agentName}"
+
+TOKEN=$(hermes auth token 2>/dev/null || echo "")
+if [ -z "$TOKEN" ]; then
+  exit 0
+fi
+
+curl -s -X POST \\
+  -H "Authorization: Bearer $TOKEN" \\
+  -H "Content-Type: application/json" \\
+  -d "{
+    \\"type\\": \\"llm_call\\",
+    \\"tokens_in\\": \${HERMES_TOKENS_IN:-0},
+    \\"tokens_out\\": \${HERMES_TOKENS_OUT:-0},
+    \\"model\\": \\"\${HERMES_MODEL:-unknown}\\",
+    \\"duration_ms\\": \${HERMES_DURATION_MS:-0},
+    \\"session_id\\": \\"\${HERMES_SESSION_ID:-}\\",
+    \\"timestamp\\": \\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\\"
+  }" \\
+  "$NODE_URL/v1/agents/$AGENT_NAME/telemetry" > /dev/null 2>&1 || true
+`;
+    }
+    renderTestConnection(ctx) {
+        return `#!/bin/bash
+# test-connection.sh -- Healthcheck script
+# Verifies auth token works and inbox endpoint is reachable.
+#
+# Usage: ./test-connection.sh
+
+set -euo pipefail
+
+NODE_URL="${ctx.nodeUrl}"
+AGENT_NAME="${ctx.agentName}"
+
+TOKEN=$(hermes auth token 2>/dev/null || echo "")
+if [ -z "$TOKEN" ]; then
+  echo "FAIL: No auth token available"
+  echo "Run: hermes auth login"
+  exit 1
+fi
+
+echo "Testing connection to $NODE_URL..."
+
+HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \\
+  -H "Authorization: Bearer $TOKEN" \\
+  "$NODE_URL/v1/agents/$AGENT_NAME/inbox")
+
+if [ "$HTTP_CODE" = "200" ]; then
+  echo "OK: Connection successful (HTTP 200)"
+  exit 0
+elif [ "$HTTP_CODE" = "401" ]; then
+  echo "FAIL: Authentication failed (HTTP 401)"
+  echo "Token may have expired. Run: hermes auth login"
+  exit 1
+elif [ "$HTTP_CODE" = "404" ]; then
+  echo "FAIL: Agent not found (HTTP 404)"
+  echo "Agent '$AGENT_NAME' may not exist on this node."
+  exit 1
+else
+  echo "FAIL: Unexpected response (HTTP $HTTP_CODE)"
+  exit 1
+fi
+`;
+    }
+    renderWebhookRoute(ctx) {
+        return `# webhook-route.yaml -- Hermes webhook route configuration
+# Copy this file to your Hermes config directory.
+#
+# This configures Hermes to accept incoming webhook events from AIMEAT
+# and wake the agent when relevant events arrive.
+
+route:
+  path: /webhooks/aimeat
+  method: POST
+  handler: wake_agent
+  validation:
+    signature_header: X-AIMEAT-Signature
+    algorithm: hmac-sha256
+  events:
+    - task.queued
+    - task.approved
+    - task.updated
+    - task.paused
+    - message.inbound
+    - directive.updated
+    - onboarding.step
+`;
+    }
+    renderHooksYaml(ctx) {
+        return `# hooks.yaml -- Hermes hook registration
+# Copy this file to your Hermes config directory.
+#
+# Registers post_llm_call hook for automatic telemetry reporting.
+
+hooks:
+  post_llm_call:
+    - script: scripts/post-telemetry.sh
+      description: Report token usage to AIMEAT node
+      enabled: true
+`;
+    }
+}
+//# sourceMappingURL=hermes-adapter.js.map

package/dist/src/services/skill-bundle/hermes-adapter.js.map

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

package/dist/src/services/skill-bundle/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @file types.ts
+ * @description Shared types for the skill bundle generator and runtime adapters.
+ * @version-history
+ *   v1.0.0 -- 2026-05-23 -- Initial creation for Agent Integration Phase A
+ */
+export interface BundleFile {
+    path: string;
+    content: string;
+}
+export interface BundleMetadata {
+    bundleName: string;
+    runtime: string;
+    version: string;
+    agentName: string;
+    agentGaii: string;
+    nodeId: string;
+    nodeUrl: string;
+    generatedAt: string;
+}
+export interface BundleContent {
+    metadata: BundleMetadata;
+    files: BundleFile[];
+}
+export interface BundleContext {
+    agentName: string;
+    agentGaii: string;
+    nodeId: string;
+    nodeUrl: string;
+    directives: {
+        purpose?: string;
+        rules: Array<{
+            id: string;
+            description: string;
+            source: string;
+        }>;
+        memoryAreas?: string[];
+        resources?: Array<{
+            key: string;
+            description?: string;
+        }>;
+    };
+    capabilities: {
+        technical?: string[];
+        domain?: string[];
+    };
+    webhookUrl?: string;
+}
+export interface RuntimeAdapter {
+    readonly runtime: string;
+    readonly bundleName: string;
+    generate(ctx: BundleContext, references: BundleFile[]): BundleContent;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/services/skill-bundle/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/skill-bundle/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAClE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,SAAS,CAAC,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC1D,CAAC;IACF,YAAY,EAAE;QACZ,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC;CACvE"}

package/dist/src/services/skill-bundle/types.js

@@ -0,0 +1,8 @@
+/**
+ * @file types.ts
+ * @description Shared types for the skill bundle generator and runtime adapters.
+ * @version-history
+ *   v1.0.0 -- 2026-05-23 -- Initial creation for Agent Integration Phase A
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/services/skill-bundle/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/services/skill-bundle/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/src/services/task-stall-detector.d.ts

@@ -1,10 +1,18 @@
 import type { Storage } from '../storage/interface.js';
 import type { AimeatConfig } from '../config.js';
+export interface AgentStallCondition {
+    gaii: string;
+    condition: 'unreachable' | 'webhook_down';
+}
 /**
  * Find active tasks that have had no events for longer than the threshold
  * and mark them as stalled. Appends a 'failed' event explaining the reason.
- *
- * @returns Number of tasks marked as stalled
  */
 export declare function detectStalledTasks(storage: Storage, config: AimeatConfig): Promise<number>;
+/**
+ * Check all agents for connectivity stall conditions:
+ * - unreachable: no activity for 2h AND no webhook configured
+ * - webhook_down: 10+ consecutive webhook delivery failures
+ */
+export declare function detectAgentStallConditions(storage: Storage): Promise<AgentStallCondition[]>;
 //# sourceMappingURL=task-stall-detector.d.ts.map

package/dist/src/services/task-stall-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-stall-detector.d.ts","sourceRoot":"","sources":["../../../src/services/task-stall-detector.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBhG"}
+{"version":3,"file":"task-stall-detector.d.ts","sourceRoot":"","sources":["../../../src/services/task-stall-detector.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,GAAG,cAAc,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBhG;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAyBjG"}

package/dist/src/services/task-stall-detector.js

@@ -1,18 +1,21 @@
 /**
  * @file task-stall-detector.ts
- * @description Background job that detects and marks stalled agent tasks.
- *   A task is considered stalled when it has been in 'active' status with no
- *   events for longer than the configured threshold (default 30 minutes).
+ * @description Background job that detects stalled agent tasks and agent-level
+ *   connectivity issues (unreachable, webhook_down).
+ * @structure
+ *   - detectStalledTasks() -- marks active tasks with no events as stalled
+ *   - detectAgentStallConditions() -- checks agent-level unreachable/webhook_down
  * @version-history
+ *   v1.1.0 -- 2026-05-24 -- Add unreachable + webhook_down agent stall conditions
  *   v1.0.0 -- 2026-05-21 -- Initial creation for Agent Dashboard Phase 1
  */
 import { randomUUID } from 'node:crypto';
 import { logger } from '../utils/logger.js';
+const UNREACHABLE_THRESHOLD_MS = 2 * 60 * 60 * 1000; // 2 hours
+const WEBHOOK_DOWN_THRESHOLD = 10;
 /**
  * Find active tasks that have had no events for longer than the threshold
  * and mark them as stalled. Appends a 'failed' event explaining the reason.
- *
- * @returns Number of tasks marked as stalled
  */
 export async function detectStalledTasks(storage, config) {
     const stalled = await storage.findStalledTasks(config.taskStallThresholdMinutes);
@@ -35,4 +38,30 @@ export async function detectStalledTasks(storage, config) {
     }
     return stalled.length;
 }
+/**
+ * Check all agents for connectivity stall conditions:
+ * - unreachable: no activity for 2h AND no webhook configured
+ * - webhook_down: 10+ consecutive webhook delivery failures
+ */
+export async function detectAgentStallConditions(storage) {
+    const agents = await storage.listAgents();
+    const now = Date.now();
+    const conditions = [];
+    for (const agent of agents) {
+        const lastSeenMs = new Date(agent.lastSeen).getTime();
+        const hasWebhook = agent.webhookEnabled && agent.webhookUrl;
+        if (!hasWebhook && (now - lastSeenMs) > UNREACHABLE_THRESHOLD_MS) {
+            conditions.push({ gaii: agent.gaii, condition: 'unreachable' });
+        }
+        if ((agent.webhookFailCount ?? 0) >= WEBHOOK_DOWN_THRESHOLD) {
+            conditions.push({ gaii: agent.gaii, condition: 'webhook_down' });
+        }
+    }
+    if (conditions.length > 0) {
+        const unreachable = conditions.filter(c => c.condition === 'unreachable').length;
+        const webhookDown = conditions.filter(c => c.condition === 'webhook_down').length;
+        logger.info(`Stall detector: ${unreachable} unreachable agent(s), ${webhookDown} webhook_down agent(s)`);
+    }
+    return conditions;
+}
 //# sourceMappingURL=task-stall-detector.js.map

package/dist/src/services/task-stall-detector.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-stall-detector.js","sourceRoot":"","sources":["../../../src/services/task-stall-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAgB,EAAE,MAAoB;IAC7E,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;IACjF,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE;YACrC,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,eAAe,CAAC;YAC5B,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,+BAA+B,MAAM,CAAC,yBAAyB,UAAU;YAClF,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAC,MAAM,qBAAqB,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC"}
+{"version":3,"file":"task-stall-detector.js","sourceRoot":"","sources":["../../../src/services/task-stall-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,UAAU;AAC/D,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAOlC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAgB,EAAE,MAAoB;IAC7E,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;IACjF,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE;YACrC,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,eAAe,CAAC;YAC5B,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,+BAA+B,MAAM,CAAC,yBAAyB,UAAU;YAClF,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAC,MAAM,qBAAqB,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAAgB;IAC/D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,UAAU,GAA0B,EAAE,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QACtD,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,UAAU,CAAC;QAE5D,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,wBAAwB,EAAE,CAAC;YACjE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC,IAAI,sBAAsB,EAAE,CAAC;YAC5D,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,aAAa,CAAC,CAAC,MAAM,CAAC;QACjF,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,cAAc,CAAC,CAAC,MAAM,CAAC;QAClF,MAAM,CAAC,IAAI,CAAC,mBAAmB,WAAW,0BAA0B,WAAW,wBAAwB,CAAC,CAAC;IAC3G,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}