larkin 0.5.11 → 0.5.12

package/dist/feishu/host-shell.cjs

@@ -1484,7 +1484,11 @@ function createHostShell({ env = process.env, runtimeHost, channelPackage, event
             }
             else {
                 const category = message.event.errorCategory || "provider";
-                hostState.recordStatusError(agent, `${category}: Runtime input failed ${message.event.retryable ? "retryably" : "non-retryably"}; inspect delivery health and Runtime/provider configuration`);
+                // Surface the provider's finish reason when the Runtime text names one we
+                // recognize (allow-listed token only; raw Runtime text never reaches status).
+                const finishReason = (0, provider_error_classifier_js_1.providerFinishReason)(message.event.message);
+                const detail = finishReason ? ` (provider finish_reason=${finishReason})` : "";
+                hostState.recordStatusError(agent, `${category}: Runtime input failed ${message.event.retryable ? "retryably" : "non-retryably"}${detail}; inspect delivery health and Runtime/provider configuration`);
             }
         }
     };

package/dist/feishu/host-shell.mjs

@@ -17,7 +17,7 @@ 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 { providerFinishReason, safeProviderDiagnostic } from "../runtime/provider-error-classifier.mjs";
 import { readDocumentCommentSubscription, verifyCallbackProbe } from "../platform/callback-capability.mjs";
 import { loadConfig, resolveInboxAuditSchedule, resolveMentionPolicy } from "../platform/config.mjs";
 import { processCommandToken } from "../app/internal-command.mjs";
@@ -1444,7 +1444,11 @@ export function createHostShell({ env = process.env, runtimeHost, channelPackage
             }
             else {
                 const category = message.event.errorCategory || "provider";
-                hostState.recordStatusError(agent, `${category}: Runtime input failed ${message.event.retryable ? "retryably" : "non-retryably"}; inspect delivery health and Runtime/provider configuration`);
+                // Surface the provider's finish reason when the Runtime text names one we
+                // recognize (allow-listed token only; raw Runtime text never reaches status).
+                const finishReason = providerFinishReason(message.event.message);
+                const detail = finishReason ? ` (provider finish_reason=${finishReason})` : "";
+                hostState.recordStatusError(agent, `${category}: Runtime input failed ${message.event.retryable ? "retryably" : "non-retryably"}${detail}; inspect delivery health and Runtime/provider configuration`);
             }
         }
     };

package/dist/runtime/provider-error-classifier.cjs

@@ -4,6 +4,7 @@ exports.INTERNAL_CONTEXT_WINDOW_PROJECTION_REASON = exports.CANONICAL_CONTEXT_WI
 exports.safeProviderDiagnostic = safeProviderDiagnostic;
 exports.buildStrictProviderErrorInput = buildStrictProviderErrorInput;
 exports.classifyStrictProviderError = classifyStrictProviderError;
+exports.providerFinishReason = providerFinishReason;
 exports.CODEX_ERROR_PREFIX = "Codex error: ";
 exports.CANONICAL_CONTEXT_WINDOW_MESSAGE = "Your input exceeds the context window of this model. Please adjust your input and try again.";
 exports.INTERNAL_CONTEXT_WINDOW_PROJECTION_REASON = "provider rejected the input because the context window was exceeded";
@@ -51,3 +52,27 @@ function classifyStrictProviderError(error) {
     }
     return undefined;
 }
+/**
+ * Finish reasons we are willing to quote into user-visible status. The list is
+ * deliberately closed: Runtime/provider text is never echoed, so only a token
+ * validated against this vocabulary can reach `status`.
+ */
+const SURFACED_FINISH_REASONS = new Set([
+    "stop", "length", "content_filter", "tool_calls", "function_call",
+    "end_turn", "max_tokens", "stop_sequence", "tool_use", "refusal",
+    "safety", "recitation", "blocklist", "prohibited_content", "spii", "malformed_function_call", "other",
+    "error", "timeout", "rate_limit", "overloaded", "cancelled", "aborted",
+]);
+/**
+ * Narrow, allow-listed extraction of a provider finish reason from Runtime text
+ * (e.g. "Provider finish_reason: content_filter"). Returns the validated token
+ * only — the surrounding payload never leaves this function, so a status line
+ * can say why a reply was withheld without echoing raw Runtime data.
+ */
+function providerFinishReason(value) {
+    if (typeof value !== "string" || value.length === 0 || value.length > 8_192)
+        return null;
+    const match = /(?:finish[_-]?reason|rawstopreason)\s*[:=]\s*"?([A-Za-z_]{2,32})"?/i.exec(value);
+    const token = match?.[1]?.toLowerCase() ?? "";
+    return SURFACED_FINISH_REASONS.has(token) ? token : null;
+}

package/dist/runtime/provider-error-classifier.mjs

@@ -45,3 +45,27 @@ export function classifyStrictProviderError(error) {
     }
     return undefined;
 }
+/**
+ * Finish reasons we are willing to quote into user-visible status. The list is
+ * deliberately closed: Runtime/provider text is never echoed, so only a token
+ * validated against this vocabulary can reach `status`.
+ */
+const SURFACED_FINISH_REASONS = new Set([
+    "stop", "length", "content_filter", "tool_calls", "function_call",
+    "end_turn", "max_tokens", "stop_sequence", "tool_use", "refusal",
+    "safety", "recitation", "blocklist", "prohibited_content", "spii", "malformed_function_call", "other",
+    "error", "timeout", "rate_limit", "overloaded", "cancelled", "aborted",
+]);
+/**
+ * Narrow, allow-listed extraction of a provider finish reason from Runtime text
+ * (e.g. "Provider finish_reason: content_filter"). Returns the validated token
+ * only — the surrounding payload never leaves this function, so a status line
+ * can say why a reply was withheld without echoing raw Runtime data.
+ */
+export function providerFinishReason(value) {
+    if (typeof value !== "string" || value.length === 0 || value.length > 8_192)
+        return null;
+    const match = /(?:finish[_-]?reason|rawstopreason)\s*[:=]\s*"?([A-Za-z_]{2,32})"?/i.exec(value);
+    const token = match?.[1]?.toLowerCase() ?? "";
+    return SURFACED_FINISH_REASONS.has(token) ? token : null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "larkin",
-  "version": "0.5.11",
+  "version": "0.5.12",
   "private": false,
   "larkinPackageRole": "npm-published",
   "files": [