feat!: Update langchain to v1

.changeset/clean-dolls-tap.md

@@ -0,0 +1,7 @@
+---
+'@sap-ai-sdk/prompt-registry': minor
+'@sap-ai-sdk/orchestration': minor
+'@sap-ai-sdk/langchain': minor
+---
+
+[Compatibility Note] `zod` was upgraded to v4

.changeset/crisp-animals-move.md

@@ -0,0 +1,5 @@
+---
+'@sap-ai-sdk/langchain': minor
+---
+
+[feat] Bump langchain to v1

.github/dependabot.yml

@@ -12,14 +12,11 @@ updates:
       # We only want to do major node updates on purpose, so don't create dependabot PRs for major versions
       - dependency-name: '@types/node'
         update-types: ['version-update:semver-major']
-      # Skip v1-release until compability is handled throughout the project
-      - dependency-name: 'langchain'
-        update-types: ['version-update:semver-major']
-      - dependency-name: '@langchain/*'
-        update-types: ['version-update:semver-major']
     groups:
       sap-cloud-sdk:
         patterns: ['@sap-cloud-sdk/*']
+      langchain:
+        patterns: ['langchain', '@langchain/*']
   - package-ecosystem: npm
     directory: '/'
     target-branch: 'v1-main'

package.json

@@ -33,15 +33,12 @@
     "check:deps": "pnpm -r -F !./tests/smoke-tests -F !./sample-cap exec depcheck --ignores=\"nock,@jest/globals\" --quiet"
   },
   "devDependencies": {
-    "orval": "^7.17.0",
-    "zod": "^3.25.76",
     "@changesets/cli": "^2.29.7",
     "@jest/globals": "^30.2.0",
     "@sap-ai-sdk/ai-api": "workspace:^",
     "@sap-ai-sdk/core": "workspace:^",
     "@sap-ai-sdk/foundation-models": "workspace:^",
     "@sap-ai-sdk/orchestration": "workspace:^",
-    "tsx": "^4.20.6",
     "@sap-cloud-sdk/connectivity": "^4.1.2",
     "@sap-cloud-sdk/eslint-config": "^4.1.2",
     "@sap-cloud-sdk/generator-common": "^4.1.2",
@@ -59,9 +56,12 @@
     "jsonwebtoken": "^9.0.2",
     "mock-fs": "^5.5.0",
     "nock": "^14.0.10",
+    "orval": "^7.17.0",
     "prettier": "^3.6.2",
     "ts-jest": "^29.4.5",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "zod": "^4.1.13"
   }
 }

packages/langchain/package.json

@@ -25,19 +25,19 @@
   ],
   "scripts": {
     "compile": "tsc",
-    "compile:cjs": "tsc -p tsconfig.cjs.json",
+    "compile:cjs": "mv package.json package.json.bak && echo '{ \"type\": \"commonjs\" }' > package.json && tsc -p tsconfig.cjs.json && mv package.json.bak package.json",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest",
     "lint": "eslint \"**/*.ts\" && prettier . --config ../../.prettierrc --ignore-path ../../.prettierignore -c",
     "lint:fix": "eslint \"**/*.ts\" --fix && prettier . --config ../../.prettierrc --ignore-path ../../.prettierignore -w --log-level error"
   },
   "dependencies": {
+    "@langchain/core": "^1.0.6",
     "@sap-ai-sdk/ai-api": "workspace:^",
     "@sap-ai-sdk/core": "workspace:^",
     "@sap-ai-sdk/foundation-models": "workspace:^",
     "@sap-ai-sdk/orchestration": "workspace:^",
     "@sap-cloud-sdk/connectivity": "^4.1.2",
     "@sap-cloud-sdk/util": "^4.1.2",
-    "uuid": "^13.0.0",
-    "@langchain/core": "0.3.79"
+    "uuid": "^13.0.0"
   }
 }

packages/langchain/src/openai/__snapshots__/chat.test.ts.snap

@@ -30,7 +30,9 @@ exports[`Chat client streaming supports streaming responses 1`] = `
     "tool_call_chunks": [],
     "tool_calls": [],
     "usage_metadata": {
+      "input_token_details": {},
       "input_tokens": 14,
+      "output_token_details": {},
       "output_tokens": 7,
       "total_tokens": 21,
     },
@@ -98,7 +100,9 @@ exports[`Chat client streaming supports streaming responses with tool calls 1`]
       },
     ],
     "usage_metadata": {
+      "input_token_details": {},
       "input_tokens": 52,
+      "output_token_details": {},
       "output_tokens": 18,
       "total_tokens": 70,
     },

packages/langchain/src/openai/__snapshots__/util.test.ts.snap

@@ -25,6 +25,11 @@ exports[`Mapping Functions should parse an OpenAI response to a (LangChain) chat
           "invalid_tool_calls": [],
           "response_metadata": {},
           "tool_calls": [],
+          "usage_metadata": {
+            "input_tokens": 0,
+            "output_tokens": 0,
+            "total_tokens": 0,
+          },
         },
         "lc": 1,
         "type": "constructor",

packages/langchain/src/openai/chat.ts

@@ -207,7 +207,7 @@ export class AzureOpenAiChatClient extends BaseChatModel<AzureOpenAiChatCallOpti
           }
         },
         ls_structured_output_format: {
-          kwargs: { method: 'jsonSchema' },
+          kwargs: { method: 'functionCalling' },
           schema: asJsonSchema
         }
       } as Partial<AzureOpenAiChatCallOptions>);

packages/langchain/src/openai/util.ts

@@ -127,6 +127,11 @@ export function mapOutputToChatResult(
         tool_calls: mapAzureOpenAiToLangChainToolCall(
           choice.message.tool_calls
         ),
+        usage_metadata: {
+          input_tokens: choice.message.usage?.prompt_tokens ?? 0,
+          output_tokens: choice.message.usage?.completion_tokens ?? 0,
+          total_tokens: choice.message.usage?.total_tokens ?? 0
+        },
         additional_kwargs: {
           function_call: choice.message.function_call,
           tool_calls: choice.message.tool_calls
@@ -248,19 +253,23 @@ function mapSystemMessageToAzureOpenAiSystemMessage(
 function mapBaseMessageToAzureOpenAiChatMessage(
   message: BaseMessage
 ): AzureOpenAiChatCompletionRequestMessage {
-  switch (message.getType()) {
+  switch (message.type) {
     case 'ai':
-      return mapAiMessageToAzureOpenAiAssistantMessage(message);
+      return mapAiMessageToAzureOpenAiAssistantMessage(message as AIMessage);
     case 'human':
-      return mapHumanMessageToAzureOpenAiUserMessage(message);
+      return mapHumanMessageToAzureOpenAiUserMessage(message as HumanMessage);
     case 'system':
-      return mapSystemMessageToAzureOpenAiSystemMessage(message);
+      return mapSystemMessageToAzureOpenAiSystemMessage(
+        message as SystemMessage
+      );
     case 'function':
-      return mapFunctionMessageToAzureOpenAiFunctionMessage(message);
+      return mapFunctionMessageToAzureOpenAiFunctionMessage(
+        message as FunctionMessage
+      );
     case 'tool':
       return mapToolMessageToAzureOpenAiToolMessage(message as ToolMessage);
     default:
-      throw new Error(`Unsupported message type: ${message.getType()}`);
+      throw new Error(`Unsupported message type: ${message.type}`);
   }
 }
 

packages/langchain/src/orchestration/__snapshots__/client.test.ts.snap

@@ -28,6 +28,11 @@ exports[`orchestration service client resilience returns successful response whe
       "tool_calls": undefined,
     },
     "tool_calls": [],
+    "usage_metadata": {
+      "input_tokens": 9,
+      "output_tokens": 10,
+      "total_tokens": 19,
+    },
   },
   "lc": 1,
   "type": "constructor",
@@ -62,6 +67,11 @@ exports[`orchestration service client resilience returns successful response whe
       "tool_calls": undefined,
     },
     "tool_calls": [],
+    "usage_metadata": {
+      "input_tokens": 9,
+      "output_tokens": 10,
+      "total_tokens": 19,
+    },
   },
   "lc": 1,
   "type": "constructor",
@@ -157,7 +167,9 @@ Overall, the SAP Cloud SDK is an essential tool for developers looking to build
     "tool_call_chunks": [],
     "tool_calls": [],
     "usage_metadata": {
+      "input_token_details": {},
       "input_tokens": 17,
+      "output_token_details": {},
       "output_tokens": 271,
       "total_tokens": 288,
     },

packages/langchain/src/orchestration/client.test.ts

@@ -210,7 +210,7 @@ describe('orchestration service client', () => {
       );
       const client = new OrchestrationClient(config, { maxRetries: 0 });
       await expect(client.stream('Hello!', { timeout: 1000 })).rejects.toThrow(
-        'AbortError'
+        'Aborted'
       );
     });
   });

packages/langchain/src/orchestration/util.ts

@@ -108,17 +108,19 @@ export function isTemplateRef(
  */
 // TODO: Add mapping of refusal property, once LangChain base class supports it natively.
 function mapBaseMessageToChatMessage(message: BaseMessage): ChatMessage {
-  switch (message.getType()) {
+  switch (message.type) {
     case 'ai':
-      return mapAiMessageToOrchestrationAssistantMessage(message);
+      return mapAiMessageToOrchestrationAssistantMessage(message as AIMessage);
     case 'human':
-      return mapHumanMessageToChatMessage(message);
+      return mapHumanMessageToChatMessage(message as HumanMessage);
     case 'system':
-      return mapSystemMessageToOrchestrationSystemMessage(message);
+      return mapSystemMessageToOrchestrationSystemMessage(
+        message as SystemMessage
+      );
     case 'tool':
       return mapToolMessageToOrchestrationToolMessage(message as ToolMessage);
     default:
-      throw new Error(`Unsupported message type: ${message.getType()}`);
+      throw new Error(`Unsupported message type: ${message.type}`);
   }
 }
 
@@ -280,7 +282,12 @@ export function mapOutputToChatResult(
         content: choice.message.content ?? '',
         tool_calls: mapOrchestrationToLangChainToolCall(
           choice.message.tool_calls
-        )
+        ),
+        usage_metadata: {
+          input_tokens: usage?.prompt_tokens ?? 0,
+          output_tokens: usage?.completion_tokens ?? 0,
+          total_tokens: usage?.total_tokens ?? 0
+        }
       }),
       additional_kwargs: {
         tool_calls: choice.message.tool_calls,

packages/langchain/tsconfig.cjs.json

@@ -1,7 +1,7 @@
 {
   "extends": "./tsconfig.json",
   "compilerOptions": {
-    "module": "CommonJS",
+    "module": "nodenext",
     "outDir": "./dist-cjs"
   }
 }

packages/orchestration/src/orchestration-client.test.ts

@@ -597,13 +597,12 @@ describe('orchestration service client', () => {
     ).toThrowErrorMatchingInlineSnapshot(`
      "Prompt Template YAML does not conform to the defined type. Validation errors: [
        {
-         "code": "invalid_type",
          "expected": "object",
-         "received": "undefined",
+         "code": "invalid_type",
          "path": [
            "spec"
          ],
-         "message": "Required"
+         "message": "Invalid input: expected object, received undefined"
        }
      ]"
     `);

packages/prompt-registry/package.json

@@ -36,6 +36,6 @@
   },
   "dependencies": {
     "@sap-ai-sdk/core": "workspace:^",
-    "zod": "^3.25.76"
+    "zod": "^4.1.12"
   }
 }

packages/prompt-registry/src/zod/prompt-registry.zod.ts

@@ -190,7 +190,7 @@ export const registryControllerPromptControllerCreateUpdatePromptTemplateBody =
 export const registryControllerPromptControllerCreateUpdatePromptTemplateResponse =
   zod.object({
     message: zod.string(),
-    id: zod.string().uuid(),
+    id: zod.uuid(),
     scenario: zod.string(),
     name: zod.string(),
     version: zod.string()
@@ -234,7 +234,7 @@ export const registryControllerPromptControllerListPromptTemplatesResponse =
     count: zod.number(),
     resources: zod.array(
       zod.object({
-        id: zod.string().uuid().optional(),
+        id: zod.uuid().optional(),
         name: zod.string().optional(),
         version: zod.string().optional(),
         scenario: zod.string().optional(),
@@ -416,7 +416,7 @@ export const registryControllerPromptControllerListPromptTemplateHistoryResponse
     count: zod.number(),
     resources: zod.array(
       zod.object({
-        id: zod.string().uuid().optional(),
+        id: zod.uuid().optional(),
         name: zod.string().optional(),
         version: zod.string().optional(),
         scenario: zod.string().optional(),
@@ -575,7 +575,7 @@ export const registryControllerPromptControllerListPromptTemplateHistoryResponse
  */
 export const registryControllerPromptControllerGetPromptTemplateByUuidParams =
   zod.object({
-    promptTemplateId: zod.string().uuid()
+    promptTemplateId: zod.uuid()
   });
 
 export const registryControllerPromptControllerGetPromptTemplateByUuidResponseSpecTemplateItemContentItemImageUrlDetailDefault =
@@ -593,7 +593,7 @@ export const registryControllerPromptControllerGetPromptTemplateByUuidResponseSp
 
 export const registryControllerPromptControllerGetPromptTemplateByUuidResponse =
   zod.object({
-    id: zod.string().uuid().optional(),
+    id: zod.uuid().optional(),
     name: zod.string().optional(),
     version: zod.string().optional(),
     scenario: zod.string().optional(),
@@ -748,7 +748,7 @@ export const registryControllerPromptControllerGetPromptTemplateByUuidResponse =
  */
 export const registryControllerPromptControllerDeletePromptTemplateParams =
   zod.object({
-    promptTemplateId: zod.string().uuid()
+    promptTemplateId: zod.uuid()
   });
 
 export const registryControllerPromptControllerDeletePromptTemplateResponse =
@@ -767,7 +767,7 @@ export const registryControllerPromptControllerImportPromptTemplateBody =
 export const registryControllerPromptControllerImportPromptTemplateResponse =
   zod.object({
     message: zod.string(),
-    id: zod.string().uuid(),
+    id: zod.uuid(),
     scenario: zod.string(),
     name: zod.string(),
     version: zod.string()
@@ -778,15 +778,15 @@ export const registryControllerPromptControllerImportPromptTemplateResponse =
  */
 export const registryControllerPromptControllerExportPromptTemplateParams =
   zod.object({
-    promptTemplateId: zod.string().uuid()
+    promptTemplateId: zod.uuid()
   });
 
 /**
  * Parse prompt template by ID.
  */
 export const registryControllerPromptControllerParsePromptTemplateByIdParams =
   zod.object({
-    promptTemplateId: zod.string().uuid()
+    promptTemplateId: zod.uuid()
   });
 
 export const registryControllerPromptControllerParsePromptTemplateByIdQueryMetadataDefault = false;
@@ -852,7 +852,7 @@ export const registryControllerPromptControllerParsePromptTemplateByIdResponse =
       .optional(),
     resource: zod
       .object({
-        id: zod.string().uuid().optional(),
+        id: zod.uuid().optional(),
         name: zod.string().optional(),
         version: zod.string().optional(),
         scenario: zod.string().optional(),
@@ -1079,7 +1079,7 @@ export const registryControllerPromptControllerParsePromptTemplateByNameVersionR
       .optional(),
     resource: zod
       .object({
-        id: zod.string().uuid().optional(),
+        id: zod.uuid().optional(),
         name: zod.string().optional(),
         version: zod.string().optional(),
         scenario: zod.string().optional(),