Hacktoberfest 2026：维护者为十月标记出来的 issue，仍然开放、适合新手。 浏览 Hacktoberfest issue

Python: [Feature]: Official first-class TypeScript SDK support

未关闭
  • 哪里不对？
#9,226 0 条评论 0 个 reaction 已指派 1 人 在 GitHub 查看

维护者通常 1 天内回复

@rogerbarreto 已经在做这个了。

开始于 2026年10月8日。

评估

这个 Issue 还没有评估数据。

描述

.NET agents python
Problem

Microsoft Agent Framework currently provides official SDKs for .NET and Python, but not TypeScript. For applications whose frontend, backend, shared domain models, tooling, and deployment are primarily TypeScript, adopting Agent Framework requires introducing and operating a separate .NET or Python service.

That adds another runtime, dependency ecosystem, build pipeline, deployment unit, security-patching process, and set of duplicated contracts. It also makes it harder to share validated types and business logic between the existing application and its agents.

This is related to #1216, but this request is specifically for an official, first-class TypeScript implementation: authored and maintained as TypeScript, distributed through npm with native typed APIs, and treated as a supported Agent Framework SDK rather than only a generic JavaScript runtime package or protocol client.

Use Case and Evidence

We are evaluating Agent Framework for an application that is predominantly TypeScript. The application already uses TypeScript across its UI and server components, and its developers, domain models, validation schemas, tests, and operational tooling are centered on the Node.js ecosystem.

To use Agent Framework today, we would need to:

  • Build a separate Python or .NET agent service.
  • Recreate or generate contracts between TypeScript and the agent service.
  • Operate an additional runtime and deployment lifecycle.
  • Duplicate authentication, authorization, telemetry, error handling, and configuration integration.
  • Split debugging and local development across language boundaries.

These costs can determine whether a team adopts Agent Framework or chooses a TypeScript-native alternative, even when Agent Framework otherwise provides the preferred capabilities.

Desired Outcome

Provide an officially supported TypeScript SDK that allows Node.js and TypeScript applications to build Agent Framework agents and workflows without introducing a Python or .NET service.

A successful outcome would provide idiomatic, strongly typed TypeScript APIs for the core framework capabilities, with clear compatibility and feature-parity documentation relative to the .NET and Python SDKs. A phased implementation would be valuable even if complete parity cannot be delivered initially.

Alternatives Considered
  • Python or .NET sidecar service: Technically workable, but adds operational complexity and prevents direct reuse of TypeScript domain code and types.
  • AG-UI, A2A, or custom HTTP integration: Useful for connecting a TypeScript client to a remote agent, but does not let TypeScript developers author Agent Framework agents and workflows natively.
  • Direct model-provider SDKs: Support model calls and tool calling, but do not provide the same Agent Framework abstractions and cross-language consistency.
  • Other TypeScript-native agent frameworks: Avoid the additional runtime but mean giving up Agent Framework compatibility and Microsoft's unified framework direction.
Proposed Direction

Consider an official npm package, such as @microsoft/agent-framework, initially covering a focused set of core capabilities:

  • Agents, messages, tools, structured output, and streaming
  • Workflow composition and agent handoffs
  • Session and conversation-state abstractions
  • Middleware and observability hooks
  • MCP, A2A, and AG-UI interoperability
  • Microsoft Foundry and common model-provider integrations

Publishing a support matrix and roadmap would help teams adopt an initial release while understanding differences from the .NET and Python implementations.

Scope and Non-Goals
  • This request does not require immediate one-to-one parity with every .NET and Python integration.
  • A modern Node.js/TypeScript baseline and phased delivery would be reasonable.
  • This is not only a request for generated type declarations over an unrelated JavaScript client; the goal is an officially maintained TypeScript Agent Framework SDK with idiomatic APIs and a documented compatibility commitment.
Language

Other / Not Applicable

Contribution Intent

I am willing to implement this

Acknowledgements
  • I searched existing issues and did not find a duplicate.
  • I will wait for explicit maintainer agreement before starting implementation of a non-trivial change.
主要语言
Python
星标
14.3k
派生
2.5k
平均合并
2 天 19 小时
30 天内合并 PR
382

环境准备

在 Codespaces 中打开

在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

microsoft/agent-framework 的其他 Issue

查看 microsoft/agent-framework 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。