@salesforce/sfdx-agent-harness-mastra 0.65.0 → 0.66.0

package/CHANGELOG.md

@@ -3,6 +3,11 @@
 All notable changes to `@salesforce/sfdx-agent-harness-mastra` are documented in this file.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.66.0] - 2026-09-02
+
+### Features
+- **agent-sdk,harness-mastra,harness-claude,harness-openai**: classify context-window overflow as a typed CONTEXT_LENGTH_EXCEEDED error @W-24074717@ ([#788](https://github.com/forcedotcom/agentic-dx/pull/788))
+
 ## [0.65.0] - 2026-09-02
 
 _No changes — released alongside dependent packages._

package/dist/mastra-event-adapter.js

@@ -2,6 +2,7 @@
  * Copyright 2026, Salesforce, Inc. All rights reserved.
  * See LICENSE.txt for license terms.
  */
+import { CONTEXT_LENGTH_EXCEEDED_CODE, createContextLengthExceededError } from '@salesforce/sfdx-agent-sdk';
 import { isClassifiedStreamError } from './stream-errors.js';
 /**
  * Adapts Mastra `ChunkType` stream events to our {@link ChatEvent} discriminated union.
@@ -153,10 +154,19 @@ export class MastraEventAdapter {
             }
             case 'error': {
                 const rawError = chunk.payload.error;
+                const code = isClassifiedStreamError(rawError) ? rawError.code : undefined;
+                const baseError = rawError instanceof Error ? rawError : new Error(String(rawError));
+                // Context-window overflow is the one classified error we upgrade to
+                // the SDK's typed `AgentSDKError(CONTEXT_LENGTH_EXCEEDED)` so the
+                // in-stream signal matches the pre-flight throw and carries the
+                // actionable message; the raw ValidationStreamError rides on `.cause`.
+                if (code === CONTEXT_LENGTH_EXCEEDED_CODE) {
+                    return { type: 'error', error: createContextLengthExceededError(baseError), code };
+                }
                 return {
                     type: 'error',
-                    error: rawError instanceof Error ? rawError : new Error(String(rawError)),
-                    ...(isClassifiedStreamError(rawError) ? { code: rawError.code } : {}),
+                    error: baseError,
+                    ...(code !== undefined ? { code } : {}),
                 };
             }
             case 'tripwire':

package/dist/stream-errors.d.ts

@@ -1,6 +1,13 @@
 export declare const NETWORK_ERROR_CODE: 'network-error';
 export declare const EMPTY_STREAM_ERROR_CODE: 'empty-stream';
-export declare const CONTEXT_OVERFLOW_ERROR_CODE: 'context-window-exceeded';
+/**
+ * The overflow `ErrorEvent.code`. Aliased to the SDK-owned
+ * {@link CONTEXT_LENGTH_EXCEEDED_CODE} so this harness and the cross-harness
+ * contract can never drift on the wire value; the adapter upgrades a
+ * ValidationStreamError carrying this code to the typed
+ * `AgentSDKError(CONTEXT_LENGTH_EXCEEDED)` before it reaches the consumer.
+ */
+export declare const CONTEXT_OVERFLOW_ERROR_CODE: "context-window-exceeded";
 export declare const VALIDATION_ERROR_CODE: 'validation-error';
 export declare const GATEWAY_RESPONSE_ERROR_CODE: 'gateway-error';
 /**

package/dist/stream-errors.js

@@ -2,9 +2,17 @@
  * Copyright 2026, Salesforce, Inc. All rights reserved.
  * See LICENSE.txt for license terms.
  */
+import { CONTEXT_LENGTH_EXCEEDED_CODE, isContextWindowOverflowMessage } from '@salesforce/sfdx-agent-sdk';
 export const NETWORK_ERROR_CODE = 'network-error';
 export const EMPTY_STREAM_ERROR_CODE = 'empty-stream';
-export const CONTEXT_OVERFLOW_ERROR_CODE = 'context-window-exceeded';
+/**
+ * The overflow `ErrorEvent.code`. Aliased to the SDK-owned
+ * {@link CONTEXT_LENGTH_EXCEEDED_CODE} so this harness and the cross-harness
+ * contract can never drift on the wire value; the adapter upgrades a
+ * ValidationStreamError carrying this code to the typed
+ * `AgentSDKError(CONTEXT_LENGTH_EXCEEDED)` before it reaches the consumer.
+ */
+export const CONTEXT_OVERFLOW_ERROR_CODE = CONTEXT_LENGTH_EXCEEDED_CODE;
 export const VALIDATION_ERROR_CODE = 'validation-error';
 export const GATEWAY_RESPONSE_ERROR_CODE = 'gateway-error';
 /**
@@ -109,12 +117,6 @@ export function isStreamTransportError(error) {
     }
     return false;
 }
-/**
- * Messages Bedrock / Anthropic use for a context-window overflow — the subset of
- * `ValidationException` worth surfacing with the more specific
- * `context-window-exceeded` code (ties into spike item 04).
- */
-const CONTEXT_OVERFLOW_PATTERNS = /input is too long|prompt is too long|too many (input )?tokens|maximum context length|context (window|length)|exceed(s|ed)? (the )?(maximum )?context/i;
 /**
  * Recognizes the Bedrock `ValidationException` shape (8d), walking the `cause`
  * chain and duck-typing the several ways `@anthropic-ai/bedrock-sdk` /
@@ -131,7 +133,7 @@ export function recognizeBedrockValidationError(error) {
         seen.add(current);
         const message = extractValidationExceptionMessage(current);
         if (message !== undefined) {
-            const code = CONTEXT_OVERFLOW_PATTERNS.test(message) ? CONTEXT_OVERFLOW_ERROR_CODE : VALIDATION_ERROR_CODE;
+            const code = isContextWindowOverflowMessage(message) ? CONTEXT_OVERFLOW_ERROR_CODE : VALIDATION_ERROR_CODE;
             return new ValidationStreamError(message, code);
         }
         current = current.cause;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sfdx-agent-harness-mastra",
-  "version": "0.65.0",
+  "version": "0.66.0",
   "description": "Mastra-backed AgentHarness implementation for @salesforce/sfdx-agent-sdk",
   "type": "module",
   "main": "dist/index.js",
@@ -42,12 +42,12 @@
     "openai": "^7.0.0"
   },
   "peerDependencies": {
-    "@salesforce/sfdx-agent-sdk": "0.66.0"
+    "@salesforce/sfdx-agent-sdk": "0.67.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@salesforce/harness-conformance": "0.0.1",
-    "@salesforce/sfdx-agent-sdk": "0.66.0",
+    "@salesforce/sfdx-agent-sdk": "0.67.0",
     "@types/node": "^22.20.1",
     "@vitest/coverage-istanbul": "^4.1.10",
     "@vitest/eslint-plugin": "^1.6.27",