@holon-run/agentinbox 1.3.0 → 1.3.1

package/dist/src/service.js

@@ -17,6 +17,8 @@ const DEFAULT_ACTIVATION_MAX_ITEMS = 20;
 const DEFAULT_NOTIFY_LEASE_MS = 10 * 60 * 1000;
 const DEFAULT_NOTIFY_RETRY_MS = 5_000;
 const MAX_TERMINAL_DEFER_RETRY_MS = 5 * 60 * 1000;
+const MAX_WEBHOOK_RETRY_MS = 5 * 60 * 1000;
+const MAX_WEBHOOK_CONSECUTIVE_FAILURES = 12;
 const DEFAULT_ACKED_RETENTION_MS = 24 * 60 * 60 * 1000;
 const DEFAULT_OFFLINE_AGENT_TTL_MS = 7 * 24 * 60 * 60 * 1000;
 const DEFAULT_GC_INTERVAL_MS = 60 * 1000;
@@ -2097,6 +2099,10 @@ class AgentInboxService {
                         : uniqueSorted(entries.map((entry) => entry.sourceId)),
                     entries: unackedItems,
                 });
+                // Permanent errors and max-retries-exceeded signal "offline":
+                if (dispatched === "offline") {
+                    this.store.deleteActivationDispatchState(buffer.agentId, buffer.targetId);
+                }
                 if (dispatched === "retryable_failure") {
                     if (state && state.status === "dirty" && state.leaseExpiresAt == null) {
                         this.store.upsertActivationDispatchState({
@@ -2276,10 +2282,17 @@ class AgentInboxService {
             return;
         }
         if (dispatched === "retryable_failure") {
+            let backoffMs = DEFAULT_NOTIFY_RETRY_MS;
+            if (target.kind === "webhook") {
+                const updatedTarget = this.getActivationTargetIfExists(agentId, targetId);
+                if (updatedTarget) {
+                    backoffMs = webhookDeferRetryMs(updatedTarget.consecutiveFailures);
+                }
+            }
             this.store.upsertActivationDispatchState({
                 ...state,
                 status: "dirty",
-                leaseExpiresAt: new Date(Date.now() + DEFAULT_NOTIFY_RETRY_MS).toISOString(),
+                leaseExpiresAt: new Date(Date.now() + backoffMs).toISOString(),
                 deferReason: null,
                 deferAttempts: 0,
                 firstDeferredAt: null,
@@ -2548,6 +2561,35 @@ class AgentInboxService {
                     return "offline";
                 }
             }
+            if (target.kind === "webhook") {
+                const statusCode = extractHttpStatus(error);
+                // 404 / 410: endpoint gone
+                // 409 / 422: expired or invalid webhook config
+                if (statusCode === 404 || statusCode === 410 || statusCode === 409 || statusCode === 422) {
+                    this.logger.info("activation.webhook_permanent_error", {
+                        agentId: input.agentId,
+                        targetId: target.targetId,
+                        statusCode,
+                        message,
+                    });
+                    this.markActivationTargetOffline(target.targetId, message);
+                    this.reconcileAgentStatus(target.agentId);
+                    return "offline";
+                }
+                // Max consecutive transient failures exceeded
+                if (target.consecutiveFailures + 1 >= MAX_WEBHOOK_CONSECUTIVE_FAILURES) {
+                    this.logger.info("activation.webhook_max_retries_exceeded", {
+                        agentId: input.agentId,
+                        targetId: target.targetId,
+                        consecutiveFailures: target.consecutiveFailures + 1,
+                        maxRetries: MAX_WEBHOOK_CONSECUTIVE_FAILURES,
+                    });
+                    this.markActivationTargetOffline(target.targetId, message);
+                    this.reconcileAgentStatus(target.agentId);
+                    return "offline";
+                }
+                // Transient error: fall through to markActivationTargetDispatchFailure
+            }
             this.markActivationTargetDispatchFailure(target.targetId, message);
             return "retryable_failure";
         }
@@ -3374,7 +3416,9 @@ class ActivationDispatcher {
                 body: JSON.stringify(activation),
             });
             if (!response.ok) {
-                throw new Error(`activation dispatch failed for ${targetUrl}: ${response.status}`);
+                const error = new Error(`activation dispatch failed for ${targetUrl}: ${response.status}`);
+                error.statusCode = response.status;
+                throw error;
             }
         }
         catch (error) {
@@ -3593,6 +3637,19 @@ function terminalDeferRetryMs(attempts) {
     const multiplier = 2 ** (normalizedAttempts - 1);
     return Math.min(DEFAULT_NOTIFY_RETRY_MS * multiplier, MAX_TERMINAL_DEFER_RETRY_MS);
 }
+function webhookDeferRetryMs(consecutiveFailures) {
+    const normalized = Math.max(1, consecutiveFailures);
+    const multiplier = 2 ** (normalized - 1);
+    return Math.min(DEFAULT_NOTIFY_RETRY_MS * multiplier, MAX_WEBHOOK_RETRY_MS);
+}
+function extractHttpStatus(error) {
+    if (error instanceof Error) {
+        const code = error.statusCode;
+        if (typeof code === "number")
+            return code;
+    }
+    return null;
+}
 function summarizeSourceEvent(sourceType, sourceKey, eventVariant) {
     if (sourceType === "github_repo_ci") {
         const parts = eventVariant.split(".");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holon-run/agentinbox",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Local event subscription and delivery service for agents.",
   "license": "Apache-2.0",
   "repository": {

package/skills/agentinbox/SKILL.md

@@ -193,6 +193,43 @@ agentinbox source invoke <sourceId> --operation get_message_context --input-json
 agentinbox deliver invoke --handle-json '<deliveryHandle-json>' --operation send_text --input-json '{"text":"Acknowledged","uxcAuth":"feishu-default"}'
 ```
 
+Feishu messages may carry files, images, or cloud document links. List the
+attachments first and then save them locally:
+
+```bash
+# List attachments for a message
+agentinbox source invoke <sourceId> \
+  --operation list_message_attachments \
+  --input-json '{"messageId":"<messageId>"}'
+
+# Save one attachment by messageId + attachmentId
+agentinbox source invoke <sourceId> \
+  --operation save_attachment \
+  --input-json '{"messageId":"<messageId>","attachmentId":"<attachmentId>","outputDir":"/tmp/agentinbox-feishu"}'
+
+# Save with explicit output path and identity
+agentinbox source invoke <sourceId> \
+  --operation save_attachment \
+  --input-json '{"messageId":"<messageId>","attachmentId":"<attachmentId>","outputPath":"/tmp/report.pdf","identity":"bot"}'
+```
+
+Output formats by attachment kind:
+
+| Kind | Default | `format` options |
+|---|---|---|
+| `image` / `file` | original binary | `"original"` only |
+| `doc` / `docx` / `wiki` | `.md` (Markdown) | N/A |
+| `sheet` | `.xlsx` | `"csv"` (requires `subId`) |
+| `bitable` / `base` | `.base` | `"csv"` (requires `subId`) |
+| `drive_file` | original file | `"original"` only |
+
+Optional `save_attachment` parameters: `outputPath`, `outputDir`, `fileName`,
+`format`, `subId`, `identity` (`"user"` or `"bot"`), `overwrite`.
+
+Rich text and file replies are available through `send_post`, `send_file`,
+and `send_file_from_path` delivery operations. Use `deliver actions` to
+inspect available schemas.
+
 Advanced source/subscription commands:
 
 ```bash