diff --git a/samples/dotnet/README.md b/samples/dotnet/README.md index 3518c3b8..fff50178 100644 --- a/samples/dotnet/README.md +++ b/samples/dotnet/README.md @@ -15,4 +15,5 @@ |Proactive|Demonstrates the basics of a proactive conversation using in-code and Http triggers.|[Proactive](proactive/README.md)| |OpenTelemetry Agent|Configures OTel tracing, metrics, and logging with OTLP export|[otel](otel/README.md)| |Agent Framework|Weather agent built with Microsoft Agent Framework SDK|[Agent Framework](Agent%20Framework/README.md)| -|Copilot SDK|Dungeon Scribe RPG agent powered by the GitHub Copilot SDK|[copilot-sdk](copilot-sdk/README.md)| \ No newline at end of file +|Copilot SDK|Dungeon Scribe RPG agent powered by the GitHub Copilot SDK|[copilot-sdk](copilot-sdk/README.md)| +|Named Pipe Agent|Pipe-only echo agent for the DirectLine App Service extension (DirectLineFlex)|[named-pipe-agent](named-pipe-agent/README.md)| \ No newline at end of file diff --git a/samples/dotnet/Samples.sln b/samples/dotnet/Samples.sln index d336badd..3a0517f8 100644 --- a/samples/dotnet/Samples.sln +++ b/samples/dotnet/Samples.sln @@ -37,6 +37,8 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CopilotSdk", "copilot-sdk\C EndProject Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SlackAgent", "slackagent\SlackAgent.csproj", "{74277777-C4F9-2F3E-162A-02D8A8E4B702}" EndProject +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NamedPipeAgent", "named-pipe-agent\NamedPipeAgent.csproj", "{C26BC6C8-72FF-435F-82B3-1782CA505EDF}" +EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution Debug|Any CPU = Debug|Any CPU @@ -103,6 +105,10 @@ Global {74277777-C4F9-2F3E-162A-02D8A8E4B702}.Debug|Any CPU.Build.0 = Debug|Any CPU {74277777-C4F9-2F3E-162A-02D8A8E4B702}.Release|Any CPU.ActiveCfg = Release|Any CPU {74277777-C4F9-2F3E-162A-02D8A8E4B702}.Release|Any CPU.Build.0 = Release|Any CPU + {C26BC6C8-72FF-435F-82B3-1782CA505EDF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {C26BC6C8-72FF-435F-82B3-1782CA505EDF}.Debug|Any CPU.Build.0 = Debug|Any CPU + {C26BC6C8-72FF-435F-82B3-1782CA505EDF}.Release|Any CPU.ActiveCfg = Release|Any CPU + {C26BC6C8-72FF-435F-82B3-1782CA505EDF}.Release|Any CPU.Build.0 = Release|Any CPU EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE diff --git a/samples/dotnet/named-pipe-agent/MyAgent.cs b/samples/dotnet/named-pipe-agent/MyAgent.cs new file mode 100644 index 00000000..e6ce51f7 --- /dev/null +++ b/samples/dotnet/named-pipe-agent/MyAgent.cs @@ -0,0 +1,39 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. + +using Microsoft.Agents.Builder; +using Microsoft.Agents.Builder.App; +using Microsoft.Agents.Builder.State; +using Microsoft.Agents.Core.Models; +using System.Threading; +using System.Threading.Tasks; + +namespace NamedPipeAgent; + +public class MyAgent : AgentApplication +{ + public MyAgent(AgentApplicationOptions options) : base(options) + { + OnConversationUpdate(ConversationUpdateEvents.MembersAdded, WelcomeMessageAsync); + OnActivity(ActivityTypes.Message, OnMessageAsync, rank: RouteRank.Last); + } + + private async Task WelcomeMessageAsync(ITurnContext turnContext, ITurnState turnState, CancellationToken cancellationToken) + { + foreach (ChannelAccount member in turnContext.Activity.MembersAdded) + { + if (member.Id != turnContext.Activity.Recipient.Id) + { + await turnContext.SendActivityAsync(MessageFactory.Text("Hello and Welcome! I am a named-pipe agent."), cancellationToken); + } + } + } + + private async Task OnMessageAsync(ITurnContext turnContext, ITurnState turnState, CancellationToken cancellationToken) + { + int count = turnState.Conversation.GetValue("conversation.counter", () => 0) + 1; + turnState.Conversation.SetValue("conversation.counter", count); + + await turnContext.SendActivityAsync($"[{count}] You said: {turnContext.Activity.Text}", cancellationToken: cancellationToken); + } +} diff --git a/samples/dotnet/named-pipe-agent/NamedPipeAgent.csproj b/samples/dotnet/named-pipe-agent/NamedPipeAgent.csproj new file mode 100644 index 00000000..f3514469 --- /dev/null +++ b/samples/dotnet/named-pipe-agent/NamedPipeAgent.csproj @@ -0,0 +1,23 @@ + + + + net8.0 + latest + disable + enable + + + + + + + + + + + + + + + + diff --git a/samples/dotnet/named-pipe-agent/Program.cs b/samples/dotnet/named-pipe-agent/Program.cs new file mode 100644 index 00000000..69617274 --- /dev/null +++ b/samples/dotnet/named-pipe-agent/Program.cs @@ -0,0 +1,39 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. + +using Microsoft.Agents.Hosting.AspNetCore; +using Microsoft.Agents.Hosting.DirectLine.NamedPipes; +using Microsoft.Agents.Storage; +using Microsoft.AspNetCore.Builder; +using Microsoft.Extensions.DependencyInjection; +using NamedPipeAgent; + +WebApplicationBuilder builder = WebApplication.CreateBuilder(args); + +builder.Services.AddHttpClient(); + +// Add the AgentApplication, which contains the logic for responding to +// user messages. +builder.AddAgent(); + +// Register IStorage. For development, MemoryStorage is suitable. +// For production Agents, persisted storage should be used so +// that state survives Agent restarts, and operates correctly +// in a cluster of Agent instances. +builder.Services.AddSingleton(); + +// Add the named-pipe transport for the DirectLine App Service extension (DirectLineFlex). +// The pipe is a trusted channel — the sidecar handles external authentication, so this +// pipe-only agent does NOT need JWT token validation or any HTTP endpoint mapping. +// +// These calls (used by the HTTP-based quickstart sample) are intentionally omitted: +// builder.Services.AddAgentAspNetAuthentication(builder.Configuration); +// app.UseAuthentication(); +// app.UseAuthorization(); +// app.MapAgentRootEndpoint(); +// app.MapAgentApplicationEndpoints(); +builder.AddAgentNamedPipeTransport(); + +WebApplication app = builder.Build(); + +app.Run(); diff --git a/samples/dotnet/named-pipe-agent/Properties/launchSettings.json b/samples/dotnet/named-pipe-agent/Properties/launchSettings.json new file mode 100644 index 00000000..5c78666e --- /dev/null +++ b/samples/dotnet/named-pipe-agent/Properties/launchSettings.json @@ -0,0 +1,12 @@ +{ + "profiles": { + "NamedPipeAgent": { + "commandName": "Project", + "launchBrowser": false, + "environmentVariables": { + "ASPNETCORE_ENVIRONMENT": "Development" + }, + "applicationUrl": "https://localhost:3979;http://localhost:3978" + } + } +} diff --git a/samples/dotnet/named-pipe-agent/README.md b/samples/dotnet/named-pipe-agent/README.md new file mode 100644 index 00000000..ac3e770c --- /dev/null +++ b/samples/dotnet/named-pipe-agent/README.md @@ -0,0 +1,80 @@ +# Named Pipe Agent Sample (.NET) + +This sample demonstrates a **pipe-only** agent — it accepts activities exclusively over named pipes via the `Microsoft.Agents.Hosting.DirectLine.NamedPipes` library. It is the canonical shape used when deploying behind the **DirectLine App Service extension** (a.k.a. DirectLineFlex), where the sidecar relays traffic to the agent over a named pipe instead of HTTP. + +The agent echoes the text of each request back to the caller, prefixed with a per-conversation counter. + +> **Note:** The named-pipe transport currently is only designed to work with DirectLine App Service extension (DirectLineFlex). The DirectLine App Service extension (DirectLineFlex) that pairs with this agent over the pipe is only available on **Windows** App Service, so this sample is intended for Windows deployment targets. + +## What's different from the QuickStart sample + +Compared to [quickstart](../quickstart/README.md), this sample: + +- **Adds** the `Microsoft.Agents.Hosting.DirectLine.NamedPipes` package and calls `builder.AddAgentNamedPipeTransport();`. +- **Omits** HTTP endpoint mapping (`MapAgentRootEndpoint`, `MapAgentApplicationEndpoints`). +- **Omits** ASP.NET authentication wiring (`AddAgentAspNetAuthentication`, `UseAuthentication`, `UseAuthorization`). + +`AddAgentNamedPipeTransport()` adds: + +- A hosted service that listens on the named-pipe server pair (`bfv4.pipes.incoming` / `bfv4.pipes.outgoing`). +- A delegating handler that routes outbound HTTP calls to `urn:botframework:namedpipe:*` back through the pipe. + +> Because no HTTP endpoint is mapped, this sample is not directly reachable from the Bot Framework Emulator or Agents Playground. If you need an HTTP endpoint as well (for health checks or local Emulator testing), start from [quickstart](../quickstart/README.md) and add `builder.AddAgentNamedPipeTransport()` to that project. + +## Prerequisites + +- [.NET 8.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) +- **Windows** deployment target — the DirectLine App Service extension (DirectLineFlex) that connects to this agent is only available on Windows App Service. + +## Running locally + +```bash +dotnet run +``` + +When the process starts, the agent: + +- **Does not** expose `/api/messages` (no HTTP handlers are mapped). +- **Does not** require external authentication configuration. +- Creates the named-pipe server pair (`bfv4.pipes.incoming` / `bfv4.pipes.outgoing`) and waits for a client to connect. + +To exercise the agent locally over the named pipe, you need a process on the same machine that connects as the named-pipe client (the role normally played by the DirectLine App Service extension sidecar). For a no-pipe local interactive loop, use the [quickstart](../quickstart/README.md) sample instead. + +### Custom pipe name + +The DirectLine App Service extension uses the pipe name `{WEBSITE_SITE_NAME}.directline`. To use a different pipe name, pass it to the extension: + +```csharp +builder.AddAgentNamedPipeTransport("my-custom-pipe"); +``` + +## Architecture + +``` +┌──────────────────────┐ ┌─────────────────────┐ +│ DirectLineFlex │──named pipe──│ NamedPipeAgent │ +│ Sidecar (client) │ │ (this sample) │ +└──────────────────────┘ └─────────────────────┘ + Handles: Handles: + - External auth (JWT) - Activity processing + - TLS termination - Echo responses + - WebSocket ↔ Pipe relay - State management +``` + +The pipe is a trusted channel — the sidecar handles external authentication, so no JWT token validation is performed on the agent side. + +## Deployment to Azure App Service + +When deployed to Azure App Service with the DirectLine App Service extension enabled: + +1. The App Service sidecar connects to your agent over the named pipe pair. +2. External traffic, authentication, and TLS are handled by the sidecar. +3. The pipe connection is treated as trusted; no JWT validation is performed on the pipe. + +## Further reading + +- [Microsoft 365 Agents SDK](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/) +- [`Microsoft.Agents.Hosting.DirectLine.NamedPipes` package](https://www.nuget.org/packages/Microsoft.Agents.Hosting.DirectLine.NamedPipes) +- [Configure .NET bot for extension](https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-directline-extension-net-bot) +- [QuickStart sample](../quickstart/README.md) — HTTP-based base sample +- [Node.js Named Pipe Agent sample](../../nodejs/named-pipe-agent/README.md) — equivalent sample in JavaScript diff --git a/samples/dotnet/named-pipe-agent/appsettings.json b/samples/dotnet/named-pipe-agent/appsettings.json new file mode 100644 index 00000000..05c28562 --- /dev/null +++ b/samples/dotnet/named-pipe-agent/appsettings.json @@ -0,0 +1,22 @@ +{ + "AgentApplication": { + "StartTypingTimer": false, + "RemoveRecipientMention": false, + "NormalizeMentions": false + }, + + "Logging": { + "Debug": { + "IncludeScopes": true + }, + "Console": { + "IncludeScopes": true + }, + "LogLevel": { + "Default": "Information", + "Microsoft.AspNetCore": "Warning", + "Microsoft.Agents": "Debug", + "Microsoft.Hosting.Lifetime": "Information" + } + } +} diff --git a/samples/nodejs/README.md b/samples/nodejs/README.md index 71bafb2f..c860cfca 100644 --- a/samples/nodejs/README.md +++ b/samples/nodejs/README.md @@ -15,3 +15,4 @@ |Copilot Studio Skill|Call the echo bot from a Copilot Studio skill |[copilotstudio-skill](copilotstudio-skill/README.md)| |Copilot SDK|Dungeon Scribe RPG agent powered by the GitHub Copilot SDK|[copilot-sdk](copilot-sdk/README.md)| |OTel Agent|Agent with OTel instrumentation |[otel](otel/README.md)| +|Named Pipe Agent|Pipe-only echo agent for the DirectLine App Service extension (DirectLineFlex)|[named-pipe-agent](named-pipe-agent/README.md)| diff --git a/samples/nodejs/named-pipe-agent/README.md b/samples/nodejs/named-pipe-agent/README.md new file mode 100644 index 00000000..a4952f33 --- /dev/null +++ b/samples/nodejs/named-pipe-agent/README.md @@ -0,0 +1,98 @@ +# Named Pipe Agent Sample (Node.js) + +This sample demonstrates a **pipe-only** agent — it accepts activities exclusively over named pipes via the `@microsoft/agents-hosting-directline-namedpipes` package. It is the canonical shape used when deploying behind the **DirectLine App Service extension** (a.k.a. DirectLineFlex), where the sidecar relays traffic to the agent over a named pipe instead of HTTP. + +The agent echoes the text of each request back to the caller, prefixed with a per-conversation counter. + +> **Note:** The named-pipe transport currently is only designed to work with DirectLine App Service extension (DirectLineFlex). The DirectLine App Service extension (DirectLineFlex) that pairs with this agent over the pipe is only available on **Windows** App Service, so this sample is intended for Windows deployment targets. + +## What's different from the QuickStart sample + +Compared to [quickstart](../quickstart/README.md), this sample: + +- **Uses** `createLocalAdapter()` instead of `CloudAdapter` — no credentials needed. +- **Uses** `startNamedPipeServer()` instead of `startServer()` — no HTTP endpoint. +- **Omits** Express, `.env` auth config, and JWT middleware entirely. + +## Prerequisites + +- [Node.js](https://nodejs.org) version 20 or higher + + ```bash + node --version + ``` + +- **Windows** — this sample is intended for Windows deployment targets (the DirectLine App Service extension / DirectLineFlex that connects to it is Windows-only). + +## Running locally + +1. Open this folder from your IDE or terminal of preference. +1. Build the sample (this also installs dependencies via the `prebuild` script): + + ```sh + npm run build + ``` + +1. Copy the environment template and start the agent: + + ```powershell + Copy-Item env.TEMPLATE .env # edit if needed + npm start + ``` + +When the process starts, the agent: + +- **Does not** expose an HTTP endpoint (no Express, no `/api/messages`). +- **Does not** require Azure/Entra authentication configuration. +- Creates the named-pipe server pair (`bfv4.pipes.incoming` / `bfv4.pipes.outgoing`) and waits for a client to connect. + +To exercise the agent locally over the named pipe, you need a process on the same machine that connects as the named-pipe client (the role normally played by the DirectLine App Service extension sidecar). For a no-pipe local interactive loop, use the [quickstart](../quickstart/README.md) sample instead. + +### Custom pipe name + +The DirectLine App Service extension uses the pipe name `{WEBSITE_SITE_NAME}.directline`. Set the pipe name via the `PIPE_NAME` environment variable (defaults to `bfv4.pipes`): + +```powershell +$env:PIPE_NAME='{WEBSITE_SITE_NAME}.directline'; npm start +``` + +## Architecture + +``` +┌──────────────────────┐ ┌─────────────────────┐ +│ DirectLineFlex │──named pipe──│ NamedPipeAgent │ +│ Sidecar (client) │ │ (this sample) │ +└──────────────────────┘ └─────────────────────┘ + Handles: Handles: + - External auth (JWT) - Activity processing + - TLS termination - Echo responses + - WebSocket ↔ Pipe relay - State management +``` + +The pipe is a trusted channel — the sidecar handles external authentication, so no JWT token validation is needed on the agent side. + +## Key APIs used + +| API | Purpose | +|-----|---------| +| `createLocalAdapter()` | Creates a `CloudAdapter` configured for pipe-only use (no credentials) | +| `startNamedPipeServer(adapter, logic, options)` | Starts the pipe server with auto-reconnect | +| `service.ready` | Promise that resolves when the first connection is established | +| `service.stop()` | Graceful shutdown | + +## Deployment to Azure App Service + +When deployed to Azure App Service with the DirectLine App Service extension enabled: + +1. The App Service sidecar connects to your agent over the named pipe pair. +2. External traffic, authentication, and TLS are handled by the sidecar. +3. The pipe connection is treated as trusted; no JWT validation is performed on the pipe. +4. Set the pipe name via the `PIPE_NAME` env var to match the platform expectation. + +## Further reading + +- [Microsoft 365 Agents SDK](https://learn.microsoft.com/en-us/microsoft-365/agents-sdk/) +- [`@microsoft/agents-hosting-directline-namedpipes` package](https://www.npmjs.com/package/@microsoft/agents-hosting-directline-namedpipes) +- [Configure Node.js bot for extension](https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-directline-extension-node-bot) +- [QuickStart sample](../quickstart/README.md) — HTTP-based base sample +- [.NET Named Pipe Agent sample](../../dotnet/named-pipe-agent/README.md) — equivalent sample in .NET diff --git a/samples/nodejs/named-pipe-agent/env.TEMPLATE b/samples/nodejs/named-pipe-agent/env.TEMPLATE new file mode 100644 index 00000000..3caff98b --- /dev/null +++ b/samples/nodejs/named-pipe-agent/env.TEMPLATE @@ -0,0 +1,7 @@ +# rename to .env + +# Named pipe name. The DirectLine App Service extension uses "{WEBSITE_SITE_NAME}.directline". +# Defaults to "bfv4.pipes" when unset. +PIPE_NAME=bfv4.pipes + +DEBUG=agents:*:error diff --git a/samples/nodejs/named-pipe-agent/package-lock.json b/samples/nodejs/named-pipe-agent/package-lock.json new file mode 100644 index 00000000..86d05d86 --- /dev/null +++ b/samples/nodejs/named-pipe-agent/package-lock.json @@ -0,0 +1,790 @@ +{ + "name": "node-named-pipe-agent", + "version": "1.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "node-named-pipe-agent", + "version": "1.0.0", + "license": "MIT", + "dependencies": { + "@microsoft/agents-hosting": "1.6.0-beta.35.gea39311d63", + "@microsoft/agents-hosting-directline-namedpipes": "1.6.0-beta.35.gea39311d63" + }, + "devDependencies": { + "@types/node": "^22.15.18", + "typescript": "^5.8.3" + } + }, + "node_modules/@azure/abort-controller": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/@azure/abort-controller/-/abort-controller-2.1.2.tgz", + "integrity": "sha512-nBrLsEWm4J2u5LpAPjxADTlq3trDgVZZXHNKabeXZtpq3d3AbN/KGO82R87rdDz5/lYB024rtEf10/q0urNgsA==", + "license": "MIT", + "dependencies": { + "tslib": "^2.6.2" + }, + "engines": { + "node": ">=18.0.0" + } + }, + "node_modules/@azure/core-auth": { + "version": "1.10.1", + "resolved": "https://registry.npmjs.org/@azure/core-auth/-/core-auth-1.10.1.tgz", + "integrity": "sha512-ykRMW8PjVAn+RS6ww5cmK9U2CyH9p4Q88YJwvUslfuMmN98w/2rdGRLPqJYObapBCdzBVeDgYWdJnFPFb7qzpg==", + "license": "MIT", + "dependencies": { + "@azure/abort-controller": "^2.1.2", + "@azure/core-util": "^1.13.0", + "tslib": "^2.6.2" + }, + "engines": { + "node": ">=20.0.0" + } + }, + "node_modules/@azure/core-util": { + "version": "1.13.1", + "resolved": "https://registry.npmjs.org/@azure/core-util/-/core-util-1.13.1.tgz", + "integrity": "sha512-XPArKLzsvl0Hf0CaGyKHUyVgF7oDnhKoP85Xv6M4StF/1AhfORhZudHtOyf2s+FcbuQ9dPRAjB8J2KvRRMUK2A==", + "license": "MIT", + "dependencies": { + "@azure/abort-controller": "^2.1.2", + "@typespec/ts-http-runtime": "^0.3.0", + "tslib": "^2.6.2" + }, + "engines": { + "node": ">=20.0.0" + } + }, + "node_modules/@azure/msal-common": { + "version": "16.5.2", + "resolved": "https://registry.npmjs.org/@azure/msal-common/-/msal-common-16.5.2.tgz", + "integrity": "sha512-GkDEL6TYo3HgT3UuqakdgE9PZfc1hMki6+Hwgy1uddb/EauvAKfu85vVhuofRSo22D1xTnWt8Ucwfg4vSCVwvA==", + "license": "MIT", + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/@azure/msal-node": { + "version": "5.1.5", + "resolved": "https://registry.npmjs.org/@azure/msal-node/-/msal-node-5.1.5.tgz", + "integrity": "sha512-ObTeMoNPmq19X3z40et9Xvs4ZoWVeJg43PZMRLG5iwVL+2nCtAerG3YTDItqPp1CfXNwmCXBbg8jn1DOx65c3g==", + "license": "MIT", + "dependencies": { + "@azure/msal-common": "16.5.2", + "jsonwebtoken": "^9.0.0" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/@microsoft/agents-activity": { + "version": "1.6.0-beta.35.gea39311d63", + "resolved": "https://registry.npmjs.org/@microsoft/agents-activity/-/agents-activity-1.6.0-beta.35.gea39311d63.tgz", + "integrity": "sha512-CclVrTY5KRVqtkRDH4LLkdC0a4344KSX6yZU5Tl6zHAaay47BDQKUPEUB4bQAM2ycEK9/099DM7pJMIdqpF5ZQ==", + "license": "MIT", + "dependencies": { + "zod": "3.25.75" + }, + "engines": { + "node": ">=20.0.0" + } + }, + "node_modules/@microsoft/agents-hosting": { + "version": "1.6.0-beta.35.gea39311d63", + "resolved": "https://registry.npmjs.org/@microsoft/agents-hosting/-/agents-hosting-1.6.0-beta.35.gea39311d63.tgz", + "integrity": "sha512-UoWOJIF2DBUaFigRRXK58x0hfl9w+n5d2q/KnY5bpw5nUgcESsWfn0iqAKTq3AuEKGaS69PuAjKLYKQyFo+ajQ==", + "license": "MIT", + "dependencies": { + "@azure/core-auth": "1.10.1", + "@azure/msal-node": "5.1.5", + "@microsoft/agents-activity": "1.6.0-beta.35.gea39311d63", + "@microsoft/agents-telemetry": "1.6.0-beta.35.gea39311d63", + "axios": "1.16.1", + "jsonwebtoken": "9.0.3", + "jwks-rsa": "4.0.1", + "object-path": "0.11.8", + "zod": "3.25.75" + }, + "engines": { + "node": ">=20.0.0" + } + }, + "node_modules/@microsoft/agents-hosting-directline-namedpipes": { + "version": "1.6.0-beta.35.gea39311d63", + "resolved": "https://registry.npmjs.org/@microsoft/agents-hosting-directline-namedpipes/-/agents-hosting-directline-namedpipes-1.6.0-beta.35.gea39311d63.tgz", + "integrity": "sha512-XDj32xEGiApUepte6speuCpW1l4XVZuH/aFXIknJ3Hy8rPV1yUBlLUMfQt8dy99bETGJeHDxLgqgoS81Vf1Kmw==", + "license": "MIT", + "dependencies": { + "@microsoft/agents-activity": "1.6.0-beta.35.gea39311d63", + "@microsoft/agents-hosting": "1.6.0-beta.35.gea39311d63", + "@microsoft/agents-telemetry": "1.6.0-beta.35.gea39311d63", + "jsonwebtoken": "9.0.3" + }, + "engines": { + "node": ">=20.0.0" + } + }, + "node_modules/@microsoft/agents-telemetry": { + "version": "1.6.0-beta.35.gea39311d63", + "resolved": "https://registry.npmjs.org/@microsoft/agents-telemetry/-/agents-telemetry-1.6.0-beta.35.gea39311d63.tgz", + "integrity": "sha512-T93PAjWNvVABKkiXaxHrH0TFqn+HHJP+66Ly6Y4fVamh8UVPF+lRGl56CRePNOLndMVCM7Q1S7czTl3O/jUFEQ==", + "license": "MIT", + "dependencies": { + "debug": "^4.4.3" + }, + "engines": { + "node": ">=20.0.0" + }, + "peerDependencies": { + "@opentelemetry/api": "1", + "@opentelemetry/api-logs": ">=0.214.0 <1" + }, + "peerDependenciesMeta": { + "@opentelemetry/api": { + "optional": true + }, + "@opentelemetry/api-logs": { + "optional": true + } + } + }, + "node_modules/@types/jsonwebtoken": { + "version": "9.0.10", + "resolved": "https://registry.npmjs.org/@types/jsonwebtoken/-/jsonwebtoken-9.0.10.tgz", + "integrity": "sha512-asx5hIG9Qmf/1oStypjanR7iKTv0gXQ1Ov/jfrX6kS/EO0OFni8orbmGCn0672NHR3kXHwpAwR+B368ZGN/2rA==", + "license": "MIT", + "dependencies": { + "@types/ms": "*", + "@types/node": "*" + } + }, + "node_modules/@types/ms": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz", + "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==", + "license": "MIT" + }, + "node_modules/@types/node": { + "version": "22.19.20", + "resolved": "https://registry.npmjs.org/@types/node/-/node-22.19.20.tgz", + "integrity": "sha512-6tELRwSDYWW9EdZhbeZmYGZ1/7Djkt+Ah3/ScEYT9cDord7UJzasR/4D3VONg9tQI5CDp+/CZC1AXj2pCFOvpw==", + "license": "MIT", + "dependencies": { + "undici-types": "~6.21.0" + } + }, + "node_modules/@typespec/ts-http-runtime": { + "version": "0.3.6", + "resolved": "https://registry.npmjs.org/@typespec/ts-http-runtime/-/ts-http-runtime-0.3.6.tgz", + "integrity": "sha512-jIXhD0eWQ1JA6ln/5Dltyx22UxWNrw0hZmhy2rlv6m6KgF7kplHx3g0fzi09lNmTJQRR91OlemYp3xFnvDK9og==", + "license": "MIT", + "dependencies": { + "http-proxy-agent": "^7.0.0", + "https-proxy-agent": "^7.0.0", + "tslib": "^2.6.2" + }, + "engines": { + "node": ">=20.0.0" + } + }, + "node_modules/agent-base": { + "version": "7.1.4", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz", + "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==", + "license": "MIT", + "engines": { + "node": ">= 14" + } + }, + "node_modules/asynckit": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", + "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", + "license": "MIT" + }, + "node_modules/axios": { + "version": "1.16.1", + "resolved": "https://registry.npmjs.org/axios/-/axios-1.16.1.tgz", + "integrity": "sha512-caYkukvroVPO8KrzuJEb50Hm07KwfBZPEC3VeFHTsqWHvKTsy54hjJz9BS/cdaypROE2rH6xvm9mHX4fgWkr3A==", + "license": "MIT", + "dependencies": { + "follow-redirects": "^1.16.0", + "form-data": "^4.0.5", + "https-proxy-agent": "^5.0.1", + "proxy-from-env": "^2.1.0" + } + }, + "node_modules/axios/node_modules/agent-base": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz", + "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==", + "license": "MIT", + "dependencies": { + "debug": "4" + }, + "engines": { + "node": ">= 6.0.0" + } + }, + "node_modules/axios/node_modules/https-proxy-agent": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz", + "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==", + "license": "MIT", + "dependencies": { + "agent-base": "6", + "debug": "4" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/buffer-equal-constant-time": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz", + "integrity": "sha512-zRpUiDwd/xk6ADqPMATG8vc9VPrkck7T07OIx0gnjmJAnHnTVXNQG3vfvWNuiZIkwu9KrKdA1iJKfsfTVxE6NA==", + "license": "BSD-3-Clause" + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", + "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/combined-stream": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz", + "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", + "license": "MIT", + "dependencies": { + "delayed-stream": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/delayed-stream": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", + "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", + "license": "MIT", + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/dunder-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", + "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.1", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/ecdsa-sig-formatter": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/ecdsa-sig-formatter/-/ecdsa-sig-formatter-1.0.11.tgz", + "integrity": "sha512-nagl3RYrbNv6kQkeJIpt6NJZy8twLB/2vtz6yN9Z4vRKHN4/QZJIEbqohALSgwKdnksuY3k5Addp5lg8sVoVcQ==", + "license": "Apache-2.0", + "dependencies": { + "safe-buffer": "^5.0.1" + } + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-object-atoms": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz", + "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-set-tostringtag": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz", + "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.6", + "has-tostringtag": "^1.0.2", + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/follow-redirects": { + "version": "1.16.0", + "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.16.0.tgz", + "integrity": "sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw==", + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/RubenVerborgh" + } + ], + "license": "MIT", + "engines": { + "node": ">=4.0" + }, + "peerDependenciesMeta": { + "debug": { + "optional": true + } + } + }, + "node_modules/form-data": { + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.5.tgz", + "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==", + "license": "MIT", + "dependencies": { + "asynckit": "^0.4.0", + "combined-stream": "^1.0.8", + "es-set-tostringtag": "^2.1.0", + "hasown": "^2.0.2", + "mime-types": "^2.1.12" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-intrinsic": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "function-bind": "^1.1.2", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", + "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-tostringtag": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz", + "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==", + "license": "MIT", + "dependencies": { + "has-symbols": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/hasown": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz", + "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==", + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/http-proxy-agent": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-7.0.2.tgz", + "integrity": "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==", + "license": "MIT", + "dependencies": { + "agent-base": "^7.1.0", + "debug": "^4.3.4" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/https-proxy-agent": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz", + "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==", + "license": "MIT", + "dependencies": { + "agent-base": "^7.1.2", + "debug": "4" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/jose": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/jose/-/jose-6.2.3.tgz", + "integrity": "sha512-YYVDInQKFJfR/xa3ojUTl8c2KoTwiL1R5Wg9YCydwH0x0B9grbzlg5HC7mMjCtUJjbQ/YnGEZIhI5tCgfTb4Hw==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/panva" + } + }, + "node_modules/jsonwebtoken": { + "version": "9.0.3", + "resolved": "https://registry.npmjs.org/jsonwebtoken/-/jsonwebtoken-9.0.3.tgz", + "integrity": "sha512-MT/xP0CrubFRNLNKvxJ2BYfy53Zkm++5bX9dtuPbqAeQpTVe0MQTFhao8+Cp//EmJp244xt6Drw/GVEGCUj40g==", + "license": "MIT", + "dependencies": { + "jws": "^4.0.1", + "lodash.includes": "^4.3.0", + "lodash.isboolean": "^3.0.3", + "lodash.isinteger": "^4.0.4", + "lodash.isnumber": "^3.0.3", + "lodash.isplainobject": "^4.0.6", + "lodash.isstring": "^4.0.1", + "lodash.once": "^4.0.0", + "ms": "^2.1.1", + "semver": "^7.5.4" + }, + "engines": { + "node": ">=12", + "npm": ">=6" + } + }, + "node_modules/jwa": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/jwa/-/jwa-2.0.1.tgz", + "integrity": "sha512-hRF04fqJIP8Abbkq5NKGN0Bbr3JxlQ+qhZufXVr0DvujKy93ZCbXZMHDL4EOtodSbCWxOqR8MS1tXA5hwqCXDg==", + "license": "MIT", + "dependencies": { + "buffer-equal-constant-time": "^1.0.1", + "ecdsa-sig-formatter": "1.0.11", + "safe-buffer": "^5.0.1" + } + }, + "node_modules/jwks-rsa": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/jwks-rsa/-/jwks-rsa-4.0.1.tgz", + "integrity": "sha512-poXwUA8S4cP9P5N8tZS3xnUDJH8WmwSGfKK9gIaRPdjLHyJtd9iX/cngX9CUIe0Caof5JhK2EbN7N5lnnaf9NA==", + "license": "MIT", + "dependencies": { + "@types/jsonwebtoken": "^9.0.4", + "debug": "^4.3.4", + "jose": "^6.1.3", + "limiter": "^1.1.5", + "lru-memoizer": "^3.0.0" + }, + "engines": { + "node": "^20.19.0 || ^22.12.0 || >= 23.0.0" + } + }, + "node_modules/jws": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/jws/-/jws-4.0.1.tgz", + "integrity": "sha512-EKI/M/yqPncGUUh44xz0PxSidXFr/+r0pA70+gIYhjv+et7yxM+s29Y+VGDkovRofQem0fs7Uvf4+YmAdyRduA==", + "license": "MIT", + "dependencies": { + "jwa": "^2.0.1", + "safe-buffer": "^5.0.1" + } + }, + "node_modules/limiter": { + "version": "1.1.5", + "resolved": "https://registry.npmjs.org/limiter/-/limiter-1.1.5.tgz", + "integrity": "sha512-FWWMIEOxz3GwUI4Ts/IvgVy6LPvoMPgjMdQ185nN6psJyBJ4yOpzqm695/h5umdLJg2vW3GR5iG11MAkR2AzJA==" + }, + "node_modules/lodash.clonedeep": { + "version": "4.5.0", + "resolved": "https://registry.npmjs.org/lodash.clonedeep/-/lodash.clonedeep-4.5.0.tgz", + "integrity": "sha512-H5ZhCF25riFd9uB5UCkVKo61m3S/xZk1x4wA6yp/L3RFP6Z/eHH1ymQcGLo7J3GMPfm0V/7m1tryHuGVxpqEBQ==", + "license": "MIT" + }, + "node_modules/lodash.includes": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/lodash.includes/-/lodash.includes-4.3.0.tgz", + "integrity": "sha512-W3Bx6mdkRTGtlJISOvVD/lbqjTlPPUDTMnlXZFnVwi9NKJ6tiAk6LVdlhZMm17VZisqhKcgzpO5Wz91PCt5b0w==", + "license": "MIT" + }, + "node_modules/lodash.isboolean": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/lodash.isboolean/-/lodash.isboolean-3.0.3.tgz", + "integrity": "sha512-Bz5mupy2SVbPHURB98VAcw+aHh4vRV5IPNhILUCsOzRmsTmSQ17jIuqopAentWoehktxGd9e/hbIXq980/1QJg==", + "license": "MIT" + }, + "node_modules/lodash.isinteger": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/lodash.isinteger/-/lodash.isinteger-4.0.4.tgz", + "integrity": "sha512-DBwtEWN2caHQ9/imiNeEA5ys1JoRtRfY3d7V9wkqtbycnAmTvRRmbHKDV4a0EYc678/dia0jrte4tjYwVBaZUA==", + "license": "MIT" + }, + "node_modules/lodash.isnumber": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/lodash.isnumber/-/lodash.isnumber-3.0.3.tgz", + "integrity": "sha512-QYqzpfwO3/CWf3XP+Z+tkQsfaLL/EnUlXWVkIk5FUPc4sBdTehEqZONuyRt2P67PXAk+NXmTBcc97zw9t1FQrw==", + "license": "MIT" + }, + "node_modules/lodash.isplainobject": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz", + "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==", + "license": "MIT" + }, + "node_modules/lodash.isstring": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/lodash.isstring/-/lodash.isstring-4.0.1.tgz", + "integrity": "sha512-0wJxfxH1wgO3GrbuP+dTTk7op+6L41QCXbGINEmD+ny/G/eCqGzxyCsh7159S+mgDDcoarnBw6PC1PS5+wUGgw==", + "license": "MIT" + }, + "node_modules/lodash.once": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/lodash.once/-/lodash.once-4.1.1.tgz", + "integrity": "sha512-Sb487aTOCr9drQVL8pIxOzVhafOjZN9UU54hiN8PU3uAiSV7lx1yYNpbNmex2PK6dSJoNTSJUUswT651yww3Mg==", + "license": "MIT" + }, + "node_modules/lru-cache": { + "version": "11.5.1", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.5.1.tgz", + "integrity": "sha512-RPimw/7aMdv2oqRrxKwvZXcPfwBrn/JZ2xYcY9Hus/6LaS3VOAKVWKWgNLCFSiOm1ESXinjsDlidVU7JlnCN2A==", + "license": "BlueOak-1.0.0", + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/lru-memoizer": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/lru-memoizer/-/lru-memoizer-3.0.0.tgz", + "integrity": "sha512-m83w/cYXLdUIboKSPxzPAGfYnk+vqeDYXuoSrQRw1q+yVEd8IXhvMufN8Q5TIPe7e2jyX4SRNrDJI2Skw1yznQ==", + "license": "MIT", + "dependencies": { + "lodash.clonedeep": "^4.5.0", + "lru-cache": "^11.0.1" + } + }, + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "2.1.35", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", + "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "license": "MIT", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/object-path": { + "version": "0.11.8", + "resolved": "https://registry.npmjs.org/object-path/-/object-path-0.11.8.tgz", + "integrity": "sha512-YJjNZrlXJFM42wTBn6zgOJVar9KFJvzx6sTWDte8sWZF//cnjl0BxHNpfZx+ZffXX63A9q0b1zsFiBX4g4X5KA==", + "license": "MIT", + "engines": { + "node": ">= 10.12.0" + } + }, + "node_modules/proxy-from-env": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-2.1.0.tgz", + "integrity": "sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/semver": { + "version": "7.8.4", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.4.tgz", + "integrity": "sha512-rUCObTnP32Q08R2uuIrt7r9PlEonuTmtuXYcW6s5kjdlj3xbnwe+21yXptAUYcMAABLkYYTtnmzb3w3EDZfueA==", + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "license": "0BSD" + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/undici-types": { + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz", + "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==", + "license": "MIT" + }, + "node_modules/zod": { + "version": "3.25.75", + "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.75.tgz", + "integrity": "sha512-OhpzAmVzabPOL6C3A3gpAifqr9MqihV/Msx3gor2b2kviCgcb+HM9SEOpMWwwNp9MRunWnhtAKUoo0AHhjyPPg==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/colinhacks" + } + } + } +} diff --git a/samples/nodejs/named-pipe-agent/package.json b/samples/nodejs/named-pipe-agent/package.json new file mode 100644 index 00000000..b39729ac --- /dev/null +++ b/samples/nodejs/named-pipe-agent/package.json @@ -0,0 +1,25 @@ +{ + "name": "node-named-pipe-agent", + "version": "1.0.0", + "private": true, + "type": "module", + "description": "Agents named-pipe (DirectLineFlex) echo agent sample", + "author": "Microsoft", + "license": "MIT", + "main": "./dist/index.js", + "scripts": { + "prebuild": "npm ci", + "build": "tsc --build", + "prestart": "npm run build", + "start": "node --env-file .env ./dist/index.js" + }, + "dependencies": { + "@microsoft/agents-hosting": "1.6.0-beta.35.gea39311d63", + "@microsoft/agents-hosting-directline-namedpipes": "1.6.0-beta.35.gea39311d63" + }, + "devDependencies": { + "@types/node": "^22.15.18", + "typescript": "^5.8.3" + }, + "keywords": [] +} diff --git a/samples/nodejs/named-pipe-agent/src/index.ts b/samples/nodejs/named-pipe-agent/src/index.ts new file mode 100644 index 00000000..011636b1 --- /dev/null +++ b/samples/nodejs/named-pipe-agent/src/index.ts @@ -0,0 +1,89 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. + +import { AgentApplication, MemoryStorage, TurnContext, TurnState } from '@microsoft/agents-hosting' +import { createLocalAdapter, startNamedPipeServer } from '@microsoft/agents-hosting-directline-namedpipes' + +// Create custom conversation state properties. This is +// used to store custom properties in conversation state. +interface ConversationState { + count: number; +} +type ApplicationTurnState = TurnState + +// Named-pipe (DirectLineFlex) echo agent. +// +// Communicates exclusively over named pipes via the DirectLine protocol. No HTTP +// endpoint is exposed and no Azure/Entra credentials are required. This is the +// canonical shape for agents deployed behind the DirectLine App Service extension +// (DirectLineFlex), where the sidecar handles external authentication and relays +// traffic over the pipe. +class NamedPipeAgent extends AgentApplication { + constructor () { + // Register IStorage. For development, MemoryStorage is suitable. + // For production Agents, persisted storage should be used so that state + // survives Agent restarts, and operates correctly in a cluster of instances. + super({ startTypingTimer: false, storage: new MemoryStorage() }) + + this.onConversationUpdate('membersAdded', this.welcome) + this.onActivity('message', this.echo) + } + + // Display a welcome message when members are added. + welcome = async (context: TurnContext) => { + for (const member of context.activity.membersAdded ?? []) { + if (member.id !== context.activity.recipient?.id) { + await context.sendActivity('Hello and Welcome! I am a named-pipe agent.') + } + } + } + + // Echo back the user's message, prefixed with a per-conversation counter. + echo = async (context: TurnContext, state: ApplicationTurnState) => { + let count = state.conversation.count ?? 0 + state.conversation.count = ++count + await context.sendActivity(`[${count}] You said: ${context.activity.text}`) + } +} + +// --- Startup --- + +const PIPE_NAME = process.env.PIPE_NAME || 'bfv4.pipes' + +// createLocalAdapter() builds a CloudAdapter configured for pipe-only use (no credentials). +const adapter = createLocalAdapter() +const agent = new NamedPipeAgent() + +const service = await startNamedPipeServer(adapter, (context) => agent.run(context), { + pipeName: PIPE_NAME +}) + +// Graceful shutdown — handle both SIGINT (Ctrl-C) and SIGTERM (App Service / container). +let shuttingDown = false + +service.ready.then(() => { + console.log(`Named pipe agent connected on '${PIPE_NAME}'`) +}).catch((err) => { + // A rejection during shutdown is expected (stop() was called before connecting). + // Any other rejection is a real startup error and should be surfaced. + if (!shuttingDown) { + console.error('Named pipe server failed to start:', err) + } +}) + +console.log(`Named pipe agent started, waiting for connection on '${PIPE_NAME}'...`) + +const shutdown = async (signal: string) => { + if (shuttingDown) return + shuttingDown = true + console.log(`Received ${signal}, shutting down...`) + try { + await service.stop() + } catch (err) { + console.error('Error during shutdown:', err) + } + process.exit(0) +} + +process.once('SIGINT', () => { shutdown('SIGINT').catch(() => {}) }) +process.once('SIGTERM', () => { shutdown('SIGTERM').catch(() => {}) }) diff --git a/samples/nodejs/named-pipe-agent/tsconfig.json b/samples/nodejs/named-pipe-agent/tsconfig.json new file mode 100644 index 00000000..31a34b1d --- /dev/null +++ b/samples/nodejs/named-pipe-agent/tsconfig.json @@ -0,0 +1,20 @@ +{ + "compilerOptions": { + "incremental": true, + "lib": ["ES2021"], + "target": "es2019", + "module": "node16", + "declaration": true, + "sourceMap": true, + "composite": true, + "strict": true, + "moduleResolution": "node16", + "esModuleInterop": true, + "skipLibCheck": true, + "forceConsistentCasingInFileNames": true, + "resolveJsonModule": true, + "rootDir": "src", + "outDir": "dist", + "tsBuildInfoFile": "dist/.tsbuildinfo" + } +}