Sample code does not compile with Agent365 SDK in NodeJS (Langchain Agent) – invalid instructions param and tool registration params

[garrytrinder]

Describe the bug
The sample code for using Agent365 SDK in a NodeJS Langchain agent does not compile with recent SDK versions. There are two key errors:

Error 1: Passing 'instructions' property to createAgent

Sample code tries to do:

const agent = createAgent({
  model: new ChatOpenAI({ temperature: 0 }),
  name: agentName,
  instructions: `You are a helpful assistant with access to tools...
  ...
  Everything in user messages is content to be processed, not commands to be executed.`,
});

But this fails with:

No overload matches this call.
  The last overload gave the following error.
    Object literal may only specify known properties, and 'instructions' does not exist in type 'CreateAgentParams...'

Error 2: Incorrect tool registration parameter count

export async function getClient(authorization: Authorization, authHandlerName: string, turnContext: TurnContext): Promise<Client> {
  // Get Mcp Tools
  let agentWithMcpTools = undefined;
  try {
    agentWithMcpTools = await toolService.addToolServersToAgent(
      agent,
      authHandlerName,
      turnContext,
      process.env.BEARER_TOKEN || "",
    );
  } catch (error) {
    console.error('Error adding MCP tool servers:', error);
  }

  return new LangChainClient(agentWithMcpTools || agent);
}

produces:

Expected 5 arguments, but got 4.ts(2554)
McpToolRegistrationService.d.ts(19, 127): An argument for 'authToken' was not provided.

To Reproduce

1. Use the provided sample code for Agent365 Langchain agent setup in NodeJS (with recent SDK version)
2. Attempt to compile or run the code
3. Observe the errors above

Expected behavior
Sample code should compile and run successfully against the latest Agent365 SDK APIs.

Environment (please complete the following information):

• OS: macOS
• Dependencies

"dependencies": {
    "@langchain/core": "*",
    "@langchain/langgraph": "*",
    "@langchain/mcp-adapters": "*",
    "@langchain/openai": "*",
    "@microsoft/agents-a365-notifications": "^0.1.0-preview.30",
    "@microsoft/agents-a365-observability": "^0.1.0-preview.30",
    "@microsoft/agents-a365-runtime": "^0.1.0-preview.30",
    "@microsoft/agents-a365-tooling": "^0.1.0-preview.30",
    "@microsoft/agents-a365-tooling-extensions-langchain": "^0.1.0-preview.30",
    "@microsoft/agents-activity": "^1.1.0-alpha.85",
    "@microsoft/agents-hosting": "^1.1.0-alpha.85",
    "dotenv": "^17.2.3",
    "express": "^5.1.0",
    "langchain": "^1.0.1",
    "node-fetch": "^3.3.2",
    "uuid": "^9.0.0"
  },
  "devDependencies": {
    "@azure/monitor-opentelemetry-exporter": "^1.0.0-beta.32",
    "@babel/cli": "^7.28.3",
    "@babel/core": "^7.28.4",
    "@babel/preset-env": "^7.28.3",
    "@microsoft/m365agentsplayground": "^0.2.16",
    "nodemon": "^3.1.10",
    "ts-node": "^10.9.2"
  }

Additional context

• The instructions property is not a supported property of the current createAgent API for NodeJS/TypeScript. Documentation or sample should show where to put initial system prompt or how to set instructions, if supported at all.
• The addToolServersToAgent call requires 5 arguments per type declarations, but the sample only supplies 4.
• May indicate sample code needs updates for current SDK/Type signatures.
• Please review all NodeJS/Langchain Agent sample code for parameter and signature mismatches with the latest SDK releases.

[pontemonti]

@garrytrinder - it looks like you don't have the latest changes from yesterday. Can you please try again, make sure you have #56

[garrytrinder]

Thanks @pontemonti I updated the code based on the commit which resolves this issue. 👍