larkin 0.5.2 → 0.5.4

package/dist/feishu/host-shell.cjs

@@ -57,6 +57,7 @@ const host_channel_business_js_1 = require("./host-channel-business.cjs");
 const interaction_orchestrator_js_1 = require("./interaction-orchestrator.cjs");
 const message_policy_js_1 = require("./message-policy.cjs");
 const runtime_readiness_js_1 = require("../runtime/runtime-readiness.cjs");
+const provider_error_classifier_js_1 = require("../runtime/provider-error-classifier.cjs");
 const callback_capability_js_1 = require("../platform/callback-capability.cjs");
 const config_js_1 = require("../platform/config.cjs");
 const internal_command_js_1 = require("../app/internal-command.cjs");
@@ -119,6 +120,9 @@ function memberNamesFromPayloads(payloads) {
     return names;
 }
 function errorMessage(error) { return error instanceof Error ? error.message : String(error); }
+function safeRuntimeStatusDiagnostic(error) {
+    return (0, provider_error_classifier_js_1.safeProviderDiagnostic)(error, "Runtime entered an error state", 500);
+}
 function agentConfigSignature(agent) {
     return JSON.stringify({
         agentId: agent.agentId, runtime: agent.runtime, model: agent.model, effort: agent.effort ?? null,
@@ -233,17 +237,40 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
         }
         hostState.updateStatus(agent, { runtimeReadiness: { runtime: agent.runtime, state: "ready", observedAt } });
     };
+    const projectFallbackRuntimeReadiness = (agent, observedAt, fallback, preserveCurrentUnavailableDiagnostic = false) => {
+        const failure = unresolvedCurrentAuth(agent);
+        if (failure) {
+            hostState.updateStatus(agent, {
+                runtimeReadiness: { ...(0, runtime_readiness_js_1.readinessForPersistedAuthFailure)(failure), observedAt },
+            });
+            return;
+        }
+        const currentReadiness = hostState.readStatus(agent).runtimeReadiness;
+        const observedMs = Date.parse(String(currentReadiness?.observedAt || ""));
+        const daemonStartedMs = Date.parse(daemonStartedAt);
+        const currentEpoch = currentReadiness?.runtime === agent.runtime
+            && Number.isFinite(observedMs) && Number.isFinite(daemonStartedMs) && observedMs >= daemonStartedMs;
+        if (currentEpoch && (currentReadiness?.state === "missing" || currentReadiness?.state === "unauthenticated" || currentReadiness?.state === "incompatible"))
+            return;
+        if (currentEpoch && preserveCurrentUnavailableDiagnostic && currentReadiness?.state === "unavailable"
+            && typeof currentReadiness.reason === "string" && currentReadiness.reason.trim()) {
+            hostState.updateStatus(agent, {
+                runtimeReadiness: { ...currentReadiness, runtime: agent.runtime, state: "unavailable", observedAt },
+            });
+            return;
+        }
+        hostState.updateStatus(agent, {
+            runtimeReadiness: { runtime: agent.runtime, ...fallback, observedAt },
+        });
+    };
     const recordInboundDeliveryFailure = (agent, code) => {
         const at = new Date().toISOString();
         const reason = "Inbound Runtime delivery failed non-retryably; durable Inbox/ledger state is retained for recovery.";
         const nextAction = "Inspect the delivery/status error, correct the Runtime or canonical Inbox state, then restart to replay safely.";
-        const currentReadiness = hostState.readStatus(agent).runtimeReadiness;
         hostState.updateStatus(agent, {
             inboundDeliveryHealth: { state: "error", code, at, reason, nextAction },
-            ...(currentReadiness?.state === "unauthenticated" ? {} : {
-                runtimeReadiness: { runtime: agent.runtime, state: "incompatible", reason, nextAction },
-            }),
         });
+        projectFallbackRuntimeReadiness(agent, at, { state: "unavailable", reason, nextAction }, true);
         hostState.recordStatusError(agent, `${reason} ${nextAction} code=${code}`);
     };
     const agentStates = new Map();
@@ -397,13 +424,57 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
     for (const agent of agents)
         prepareAgentState(agent);
     const reminder = new host_reminder_orchestrator_js_1.HostReminderOrchestrator({ agents, stateStore, envelopeProjector, deliveryTarget: runtimeHost, log });
+    const auditRegistry = (0, missed_outbound_scan_js_1.inboxAuditRegistryFile)(larkinHome);
+    const auditRetryJournal = (0, missed_outbound_scan_js_1.inboxAuditRetryFile)(larkinHome);
+    let auditRetryTimer = null;
+    let auditRetryAttempt = 0;
+    const reconcileAuditRetries = () => {
+        try {
+            return (0, missed_outbound_scan_js_1.reconcileInboxAuditTargetRetries)(auditRegistry, auditRetryJournal).remaining;
+        }
+        catch (error) {
+            log(`inbox audit retry 读取失败: ${(0, inbox_audit_heartbeat_js_1.boundedInboxAuditDiagnostic)(error)}`);
+            return 1;
+        }
+    };
+    const scheduleAuditRetry = () => {
+        if (auditRetryTimer || auditRetryAttempt >= 5)
+            return;
+        const delay = [100, 250, 1_000, 3_000, 10_000][auditRetryAttempt++];
+        auditRetryTimer = setTimeout(() => {
+            auditRetryTimer = null;
+            if (reconcileAuditRetries() > 0)
+                scheduleAuditRetry();
+            else
+                auditRetryAttempt = 0;
+        }, delay);
+        auditRetryTimer.unref?.();
+    };
     const inboxAudit = new inbox_audit_heartbeat_js_1.InboxAuditHeartbeat({
         agents,
         stateStore,
         runtimeHost,
         log,
+        configFile: node_path_1.default.join(larkinHome, "config.json"),
+        schedule(agent) {
+            try {
+                return (0, config_js_1.resolveInboxAuditSchedule)((0, config_js_1.loadConfig)(env).config, agent.agentId);
+            }
+            catch (error) {
+                log(`inbox audit schedule 读取失败 agent=${agent.agentId}: ${errorMessage(error)}`);
+                return { enabled: false, intervalMs: inbox_audit_heartbeat_js_1.INBOX_AUDIT_CADENCE_MS };
+            }
+        },
+        shouldDispatch(agent) {
+            try {
+                return (0, missed_outbound_scan_js_1.hasPendingInboxAuditTargets)(auditRegistry, agent.agentId);
+            }
+            catch (error) {
+                log(`inbox audit pending 读取失败 agent=${agent.agentId}: ${errorMessage(error)}`);
+                return false;
+            }
+        },
     });
-    const auditRegistry = (0, missed_outbound_scan_js_1.inboxAuditRegistryFile)(larkinHome);
     const seenEventIds = new Set();
     const inFlightEventIds = new Set();
     const onFeishuMessage = async (agent, event, options) => {
@@ -450,14 +521,23 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
                 // append/dedupe decision is durable. Agent model-seen state is untouched.
                 if (event.event_id)
                     seenEventIds.add(eventKey);
+                if (append.status === "duplicate_consumed")
+                    return null;
+                const auditSourceSeq = Number(append.envelope.target_seq);
                 try {
-                    (0, missed_outbound_scan_js_1.observeInboxAuditTarget)(auditRegistry, agent.agentId, event);
+                    (0, missed_outbound_scan_js_1.observeInboxAuditTarget)(auditRegistry, agent.agentId, { ...event, wake, source_seq: auditSourceSeq });
+                    (0, missed_outbound_scan_js_1.discardInboxAuditTargetRetry)(auditRetryJournal, agent.agentId, { ...event, source_seq: auditSourceSeq });
                 }
                 catch (error) {
-                    log(`inbox audit target 未持久化: ${error.message}`);
+                    try {
+                        (0, missed_outbound_scan_js_1.enqueueInboxAuditTargetRetry)(auditRetryJournal, agent.agentId, { ...event, wake, source_seq: auditSourceSeq });
+                        scheduleAuditRetry();
+                        log(`inbox audit target 延后重试: ${(0, inbox_audit_heartbeat_js_1.boundedInboxAuditDiagnostic)(error)}`);
+                    }
+                    catch (retryError) {
+                        log(`inbox audit target 未持久化: ${(0, inbox_audit_heartbeat_js_1.boundedInboxAuditDiagnostic)(retryError)}`);
+                    }
                 }
-                if (append.status === "duplicate_consumed")
-                    return null;
                 const inboxEnvelope = append.envelope;
                 if (append.status === "appended")
                     hostState.appendConversation(agent, {
@@ -1312,15 +1392,21 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
         if (message.type === "agent-status") {
             log("agent:status", message.agentId, message.status);
             const observedAt = new Date().toISOString();
-            if (message.status === "error" || message.status === "inactive")
-                hostState.updateStatus(agent, {
-                    runtimeReadiness: message.readiness?.state && message.readiness.state !== "ready" ? { ...message.readiness, observedAt } : {
-                        runtime: agent.runtime,
-                        state: message.status === "error" ? "incompatible" : "missing",
-                        reason: message.status === "error" ? message.error || "Runtime entered an error state" : "Runtime is inactive",
-                        observedAt,
-                    },
-                });
+            if (message.status === "error" || message.status === "inactive") {
+                if (message.readiness?.state && message.readiness.state !== "ready") {
+                    hostState.updateStatus(agent, { runtimeReadiness: { ...message.readiness, observedAt } });
+                }
+                else {
+                    projectFallbackRuntimeReadiness(agent, observedAt, message.status === "error" ? {
+                        state: "unavailable",
+                        reason: safeRuntimeStatusDiagnostic(message.error),
+                        nextAction: "Inspect the Runtime status error, correct the Runtime availability issue, then retry.",
+                    } : {
+                        state: "missing",
+                        reason: "Runtime is inactive",
+                    });
+                }
+            }
             else if (message.readiness) {
                 if (message.readiness.state === "ready" && unresolvedCurrentAuth(agent)) {
                     projectReadyUnlessUnresolvedAuth(agent, observedAt);
@@ -1338,7 +1424,7 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
                 redeliveryTimer.unref?.();
             }
             if (message.status === "error" && message.error)
-                hostState.recordStatusError(agent, message.error);
+                hostState.recordStatusError(agent, safeRuntimeStatusDiagnostic(message.error));
             if (message.status === "error" || message.status === "inactive") {
                 processingEyes.clear(agent, `agent-status:${message.status}`);
             }
@@ -1419,6 +1505,9 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
             eventSourceStartTimer = null;
             await Promise.resolve(eventSourceStop());
             reminder.stopSync();
+            if (auditRetryTimer)
+                clearTimeout(auditRetryTimer);
+            auditRetryTimer = null;
             inboxAudit.stop();
             interaction.stopSync();
             await runtimeHost.shutdown(reason);
@@ -1637,6 +1726,8 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
                     previousSession: agentStates.get(agent.agentId)?.state.previousSessions?.[agent.runtime] ?? null,
                 })));
                 reminder.startSync();
+                if (reconcileAuditRetries() > 0)
+                    scheduleAuditRetry();
                 inboxAudit.start();
                 interaction.startSync();
                 eventSourceStartTimer = setTimeout(() => { eventSourceStartTimer = null; startEventSource(); }, eventSourceStartDelayMs);

package/dist/feishu/host-shell.mjs

@@ -11,14 +11,15 @@ import { HostEnvelopeProjector, HostStateProjection, SenderIdentityCache, projec
 import { ProcessingEyeOrchestrator } from "./host-processing-eye.mjs";
 import { projectInboxEnvelope, targetKeyOfInboxEnvelope } from "../agent/inbox-projection.mjs";
 import { HostReminderOrchestrator } from "../agent/host-reminder-orchestrator.mjs";
-import { InboxAuditHeartbeat } from "../agent/inbox-audit-heartbeat.mjs";
-import { inboxAuditRegistryFile, observeInboxAuditTarget } from "../agent/missed-outbound-scan.mjs";
+import { boundedInboxAuditDiagnostic, InboxAuditHeartbeat, INBOX_AUDIT_CADENCE_MS } from "../agent/inbox-audit-heartbeat.mjs";
+import { discardInboxAuditTargetRetry, enqueueInboxAuditTargetRetry, hasPendingInboxAuditTargets, inboxAuditRegistryFile, inboxAuditRetryFile, observeInboxAuditTarget, reconcileInboxAuditTargetRetries } from "../agent/missed-outbound-scan.mjs";
 import { HostChannelBusiness } from "./host-channel-business.mjs";
 import { HostInteractionOrchestrator } from "./interaction-orchestrator.mjs";
 import { targetFor } from "./message-policy.mjs";
 import { authFailureAppliesTo, parsePersistedAuthFailure, providerAuthenticationFailureReadiness, readinessForPersistedAuthFailure, RuntimePrerequisiteError, } from "../runtime/runtime-readiness.mjs";
+import { safeProviderDiagnostic } from "../runtime/provider-error-classifier.mjs";
 import { readDocumentCommentSubscription, verifyCallbackProbe } from "../platform/callback-capability.mjs";
-import { loadConfig, resolveMentionPolicy } from "../platform/config.mjs";
+import { loadConfig, resolveInboxAuditSchedule, resolveMentionPolicy } from "../platform/config.mjs";
 import { processCommandToken } from "../app/internal-command.mjs";
 import { managedOfficialLarkCli } from "../app/agent-lark-cli-workspace.mjs";
 import { isChannelReconnecting, isRuntimeReadinessCurrent } from "../app/agent-readiness.mjs";
@@ -79,6 +80,9 @@ export function memberNamesFromPayloads(payloads) {
     return names;
 }
 function errorMessage(error) { return error instanceof Error ? error.message : String(error); }
+function safeRuntimeStatusDiagnostic(error) {
+    return safeProviderDiagnostic(error, "Runtime entered an error state", 500);
+}
 function agentConfigSignature(agent) {
     return JSON.stringify({
         agentId: agent.agentId, runtime: agent.runtime, model: agent.model, effort: agent.effort ?? null,
@@ -193,17 +197,40 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
         }
         hostState.updateStatus(agent, { runtimeReadiness: { runtime: agent.runtime, state: "ready", observedAt } });
     };
+    const projectFallbackRuntimeReadiness = (agent, observedAt, fallback, preserveCurrentUnavailableDiagnostic = false) => {
+        const failure = unresolvedCurrentAuth(agent);
+        if (failure) {
+            hostState.updateStatus(agent, {
+                runtimeReadiness: { ...readinessForPersistedAuthFailure(failure), observedAt },
+            });
+            return;
+        }
+        const currentReadiness = hostState.readStatus(agent).runtimeReadiness;
+        const observedMs = Date.parse(String(currentReadiness?.observedAt || ""));
+        const daemonStartedMs = Date.parse(daemonStartedAt);
+        const currentEpoch = currentReadiness?.runtime === agent.runtime
+            && Number.isFinite(observedMs) && Number.isFinite(daemonStartedMs) && observedMs >= daemonStartedMs;
+        if (currentEpoch && (currentReadiness?.state === "missing" || currentReadiness?.state === "unauthenticated" || currentReadiness?.state === "incompatible"))
+            return;
+        if (currentEpoch && preserveCurrentUnavailableDiagnostic && currentReadiness?.state === "unavailable"
+            && typeof currentReadiness.reason === "string" && currentReadiness.reason.trim()) {
+            hostState.updateStatus(agent, {
+                runtimeReadiness: { ...currentReadiness, runtime: agent.runtime, state: "unavailable", observedAt },
+            });
+            return;
+        }
+        hostState.updateStatus(agent, {
+            runtimeReadiness: { runtime: agent.runtime, ...fallback, observedAt },
+        });
+    };
     const recordInboundDeliveryFailure = (agent, code) => {
         const at = new Date().toISOString();
         const reason = "Inbound Runtime delivery failed non-retryably; durable Inbox/ledger state is retained for recovery.";
         const nextAction = "Inspect the delivery/status error, correct the Runtime or canonical Inbox state, then restart to replay safely.";
-        const currentReadiness = hostState.readStatus(agent).runtimeReadiness;
         hostState.updateStatus(agent, {
             inboundDeliveryHealth: { state: "error", code, at, reason, nextAction },
-            ...(currentReadiness?.state === "unauthenticated" ? {} : {
-                runtimeReadiness: { runtime: agent.runtime, state: "incompatible", reason, nextAction },
-            }),
         });
+        projectFallbackRuntimeReadiness(agent, at, { state: "unavailable", reason, nextAction }, true);
         hostState.recordStatusError(agent, `${reason} ${nextAction} code=${code}`);
     };
     const agentStates = new Map();
@@ -357,13 +384,57 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
     for (const agent of agents)
         prepareAgentState(agent);
     const reminder = new HostReminderOrchestrator({ agents, stateStore, envelopeProjector, deliveryTarget: runtimeHost, log });
+    const auditRegistry = inboxAuditRegistryFile(larkinHome);
+    const auditRetryJournal = inboxAuditRetryFile(larkinHome);
+    let auditRetryTimer = null;
+    let auditRetryAttempt = 0;
+    const reconcileAuditRetries = () => {
+        try {
+            return reconcileInboxAuditTargetRetries(auditRegistry, auditRetryJournal).remaining;
+        }
+        catch (error) {
+            log(`inbox audit retry 读取失败: ${boundedInboxAuditDiagnostic(error)}`);
+            return 1;
+        }
+    };
+    const scheduleAuditRetry = () => {
+        if (auditRetryTimer || auditRetryAttempt >= 5)
+            return;
+        const delay = [100, 250, 1_000, 3_000, 10_000][auditRetryAttempt++];
+        auditRetryTimer = setTimeout(() => {
+            auditRetryTimer = null;
+            if (reconcileAuditRetries() > 0)
+                scheduleAuditRetry();
+            else
+                auditRetryAttempt = 0;
+        }, delay);
+        auditRetryTimer.unref?.();
+    };
     const inboxAudit = new InboxAuditHeartbeat({
         agents,
         stateStore,
         runtimeHost,
         log,
+        configFile: path.join(larkinHome, "config.json"),
+        schedule(agent) {
+            try {
+                return resolveInboxAuditSchedule(loadConfig(env).config, agent.agentId);
+            }
+            catch (error) {
+                log(`inbox audit schedule 读取失败 agent=${agent.agentId}: ${errorMessage(error)}`);
+                return { enabled: false, intervalMs: INBOX_AUDIT_CADENCE_MS };
+            }
+        },
+        shouldDispatch(agent) {
+            try {
+                return hasPendingInboxAuditTargets(auditRegistry, agent.agentId);
+            }
+            catch (error) {
+                log(`inbox audit pending 读取失败 agent=${agent.agentId}: ${errorMessage(error)}`);
+                return false;
+            }
+        },
     });
-    const auditRegistry = inboxAuditRegistryFile(larkinHome);
     const seenEventIds = new Set();
     const inFlightEventIds = new Set();
     const onFeishuMessage = async (agent, event, options) => {
@@ -410,14 +481,23 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
                 // append/dedupe decision is durable. Agent model-seen state is untouched.
                 if (event.event_id)
                     seenEventIds.add(eventKey);
+                if (append.status === "duplicate_consumed")
+                    return null;
+                const auditSourceSeq = Number(append.envelope.target_seq);
                 try {
-                    observeInboxAuditTarget(auditRegistry, agent.agentId, event);
+                    observeInboxAuditTarget(auditRegistry, agent.agentId, { ...event, wake, source_seq: auditSourceSeq });
+                    discardInboxAuditTargetRetry(auditRetryJournal, agent.agentId, { ...event, source_seq: auditSourceSeq });
                 }
                 catch (error) {
-                    log(`inbox audit target 未持久化: ${error.message}`);
+                    try {
+                        enqueueInboxAuditTargetRetry(auditRetryJournal, agent.agentId, { ...event, wake, source_seq: auditSourceSeq });
+                        scheduleAuditRetry();
+                        log(`inbox audit target 延后重试: ${boundedInboxAuditDiagnostic(error)}`);
+                    }
+                    catch (retryError) {
+                        log(`inbox audit target 未持久化: ${boundedInboxAuditDiagnostic(retryError)}`);
+                    }
                 }
-                if (append.status === "duplicate_consumed")
-                    return null;
                 const inboxEnvelope = append.envelope;
                 if (append.status === "appended")
                     hostState.appendConversation(agent, {
@@ -1272,15 +1352,21 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
         if (message.type === "agent-status") {
             log("agent:status", message.agentId, message.status);
             const observedAt = new Date().toISOString();
-            if (message.status === "error" || message.status === "inactive")
-                hostState.updateStatus(agent, {
-                    runtimeReadiness: message.readiness?.state && message.readiness.state !== "ready" ? { ...message.readiness, observedAt } : {
-                        runtime: agent.runtime,
-                        state: message.status === "error" ? "incompatible" : "missing",
-                        reason: message.status === "error" ? message.error || "Runtime entered an error state" : "Runtime is inactive",
-                        observedAt,
-                    },
-                });
+            if (message.status === "error" || message.status === "inactive") {
+                if (message.readiness?.state && message.readiness.state !== "ready") {
+                    hostState.updateStatus(agent, { runtimeReadiness: { ...message.readiness, observedAt } });
+                }
+                else {
+                    projectFallbackRuntimeReadiness(agent, observedAt, message.status === "error" ? {
+                        state: "unavailable",
+                        reason: safeRuntimeStatusDiagnostic(message.error),
+                        nextAction: "Inspect the Runtime status error, correct the Runtime availability issue, then retry.",
+                    } : {
+                        state: "missing",
+                        reason: "Runtime is inactive",
+                    });
+                }
+            }
             else if (message.readiness) {
                 if (message.readiness.state === "ready" && unresolvedCurrentAuth(agent)) {
                     projectReadyUnlessUnresolvedAuth(agent, observedAt);
@@ -1298,7 +1384,7 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
                 redeliveryTimer.unref?.();
             }
             if (message.status === "error" && message.error)
-                hostState.recordStatusError(agent, message.error);
+                hostState.recordStatusError(agent, safeRuntimeStatusDiagnostic(message.error));
             if (message.status === "error" || message.status === "inactive") {
                 processingEyes.clear(agent, `agent-status:${message.status}`);
             }
@@ -1379,6 +1465,9 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
             eventSourceStartTimer = null;
             await Promise.resolve(eventSourceStop());
             reminder.stopSync();
+            if (auditRetryTimer)
+                clearTimeout(auditRetryTimer);
+            auditRetryTimer = null;
             inboxAudit.stop();
             interaction.stopSync();
             await runtimeHost.shutdown(reason);
@@ -1597,6 +1686,8 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
                     previousSession: agentStates.get(agent.agentId)?.state.previousSessions?.[agent.runtime] ?? null,
                 })));
                 reminder.startSync();
+                if (reconcileAuditRetries() > 0)
+                    scheduleAuditRetry();
                 inboxAudit.start();
                 interaction.startSync();
                 eventSourceStartTimer = setTimeout(() => { eventSourceStartTimer = null; startEventSource(); }, eventSourceStartDelayMs);