diff --git a/HOW_TO_BUILD.md b/HOW_TO_BUILD.md index 8999b175..a8a41f5e 100644 --- a/HOW_TO_BUILD.md +++ b/HOW_TO_BUILD.md @@ -1,6 +1,6 @@ -# How to Build Agent365 Node.js SDK +# How to Build Microsoft Agent 365 Node.js SDK -This guide provides instructions for building and developing the Agent365 Node.js SDK packages. +This guide provides instructions for building and developing the Microsoft Agent 365 Node.js SDK packages. ## Prerequisites @@ -10,7 +10,7 @@ This guide provides instructions for building and developing the Agent365 Node.j ## Project Structure -The Agent365 Node.js SDK is organized as a monorepo with the following structure: +The Microsoft Agent 365 Node.js SDK is organized as a monorepo with the following structure: ``` nodejs/ @@ -216,7 +216,6 @@ When ready to publish packages: ## Additional Resources -- [Agent365 Documentation](../../README.md) -- [Sample Applications](../samples/) +- [Microsoft Agent 365 Documentation](../../README.md) - [Contributing Guidelines](../../CONTRIBUTING.md) -- [Security Policy](../../SECURITY.md) \ No newline at end of file +- [Security Policy](../../SECURITY.md) diff --git a/HOW_TO_RELEASE.md b/HOW_TO_RELEASE.md index 121c4a14..66fb2446 100644 --- a/HOW_TO_RELEASE.md +++ b/HOW_TO_RELEASE.md @@ -1,6 +1,6 @@ # How to Create an Official Release -This guide describes the process for creating an official release of the Agent365 SDK for Node.js using our semantic versioning system powered by Nerdbank.GitVersioning. +This guide describes the process for creating an official release of the Microsoft Agent 365 SDK for Node.js using our semantic versioning system powered by Nerdbank.GitVersioning. ## 📋 Table of Contents @@ -147,7 +147,7 @@ The version will automatically be calculated as a stable release (without `-prev ```bash # Clone fresh to test -git clone https://github.com/microsoft/Agent365.git test-release +git clone https://github.com/microsoft/Agent365-nodejs.git test-release cd test-release/nodejs git checkout v1.1.0 @@ -176,9 +176,9 @@ grep -r "\"version\"" packages/*/package.json ### Step 7: Create GitHub Release -1. Go to: https://github.com/microsoft/Agent365/releases/new +1. Go to: https://github.com/microsoft/Agent365-nodejs/releases/new 2. Choose the tag: `v1.1.0` -3. Set release title: `Agent365 SDK for Node.js v1.1.0` +3. Set release title: `Microsoft Agent 365 SDK for Node.js v1.1.0` 4. Add release notes (see template below) 5. Attach build artifacts (if any) 6. Check "Set as the latest release" (if applicable) @@ -186,7 +186,7 @@ grep -r "\"version\"" packages/*/package.json **Release Notes Template:** ```markdown -# Agent365 SDK for Node.js v1.1.0 +# Microsoft Agent 365 SDK for Node.js v1.1.0 ## 🎉 What's New @@ -225,7 +225,7 @@ All packages in this release: npm install @microsoft/agents-a365-runtime@1.1.0 ``` -**Full Changelog**: https://github.com/microsoft/Agent365/compare/v1.0.0...v1.1.0 +**Full Changelog**: https://github.com/microsoft/Agent365-nodejs/compare/v1.0.0...v1.1.0 ``` ### Step 8: Publish to NPM (Optional) @@ -524,3 +524,5 @@ git push origin main **Document Version**: 1.0 **Last Updated**: November 2, 2025 **Maintained By**: DevOps Team + + diff --git a/package.json b/package.json index 17bff46e..a803db8b 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "@microsoft/agent365-monorepo", "version": "0.0.0-placeholder", - "description": "Agent365 SDK monorepo for AI agents built with TypeScript/Node.js", + "description": "Microsoft Agent 365 SDK monorepo for AI agents built with TypeScript/Node.js", "private": true, "type": "module", "scripts": { diff --git a/packages/agents-a365-observability-extensions-openai/package.json b/packages/agents-a365-observability-extensions-openai/package.json index 513abd93..6a1864d2 100644 --- a/packages/agents-a365-observability-extensions-openai/package.json +++ b/packages/agents-a365-observability-extensions-openai/package.json @@ -1,7 +1,7 @@ { "name": "@microsoft/agents-a365-observability-extensions-openai", "version": "0.0.0-placeholder", - "description": "Agent365 SDK OpenAI Agents instrumentation extensions for telemetry and observability", + "description": "Microsoft Agent 365 SDK OpenAI Agents instrumentation extensions for telemetry and observability", "keywords": [ "agent365", "openai", diff --git a/packages/agents-a365-observability-extensions-openai/src/index.ts b/packages/agents-a365-observability-extensions-openai/src/index.ts index 5135f854..a2c48499 100644 --- a/packages/agents-a365-observability-extensions-openai/src/index.ts +++ b/packages/agents-a365-observability-extensions-openai/src/index.ts @@ -3,7 +3,7 @@ // ------------------------------------------------------------------------------ /** - * Wraps the OpenAI Agents SDK tracer to integrate with Agent365 Observability. + * Wraps the OpenAI Agents SDK tracer to integrate with Agent 365 Observability. */ export { OpenAIAgentsTraceInstrumentor, OpenAIAgentsInstrumentationConfig } from './OpenAIAgentsTraceInstrumentor'; diff --git a/packages/agents-a365-observability/package.json b/packages/agents-a365-observability/package.json index 42f78633..4519a511 100644 --- a/packages/agents-a365-observability/package.json +++ b/packages/agents-a365-observability/package.json @@ -33,8 +33,8 @@ "license": "See license file", "repository": { "type": "git", - "url": "https://github.com/microsoft/Agent365.git", - "directory": "nodejs/packages/agents-a365-observability" + "url": "https://github.com/microsoft/Agent365-nodejs.git", + "directory": "packages/agents-a365-observability" }, "dependencies": { "@azure/monitor-opentelemetry-exporter": "*", diff --git a/packages/agents-a365-observability/src/ObservabilityBuilder.ts b/packages/agents-a365-observability/src/ObservabilityBuilder.ts index becc1004..cd26049c 100644 --- a/packages/agents-a365-observability/src/ObservabilityBuilder.ts +++ b/packages/agents-a365-observability/src/ObservabilityBuilder.ts @@ -12,7 +12,7 @@ import { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions'; import { trace } from '@opentelemetry/api'; import { ClusterCategory } from '@microsoft/agents-a365-runtime'; /** - * Configuration options for Agent365 Observability Builder + * Configuration options for Agent 365 Observability Builder */ export interface BuilderOptions { /** Custom service name for telemetry */ @@ -28,7 +28,7 @@ export interface BuilderOptions { } /** - * Builder for configuring Agent365 with OpenTelemetry tracing + * Builder for configuring Agent 365 with OpenTelemetry tracing */ export class ObservabilityBuilder { private options: BuilderOptions = {}; @@ -48,7 +48,7 @@ export class ObservabilityBuilder { } /** - * Configures the token resolver for Agent365 exporter + * Configures the token resolver for Agent 365 exporter * @param tokenResolver Function to resolve authentication tokens * @returns The builder instance for method chaining */ @@ -58,7 +58,7 @@ export class ObservabilityBuilder { } /** - * Configures the cluster category for Agent365 exporter + * Configures the cluster category for Agent 365 exporter * @param clusterCategory The cluster category (e.g., "preprod", "prod") * @returns The builder instance for method chaining */ @@ -70,7 +70,7 @@ export class ObservabilityBuilder { private getTraceExporter() { if (isAgent365ExporterEnabled()){ if (!this.options.tokenResolver) { - throw new Error('tokenResolver must be provided when Agent365 exporter is enabled'); + throw new Error('tokenResolver must be provided when Agent 365 exporter is enabled'); } return new Agent365Exporter( this.options.tokenResolver, @@ -92,7 +92,7 @@ export class ObservabilityBuilder { } /** - * Builds and initializes the Agent365 configuration + * Builds and initializes the Agent 365 configuration * @returns The configured NodeSDK instance */ public build(): boolean { diff --git a/packages/agents-a365-observability/src/ObservabilityManager.ts b/packages/agents-a365-observability/src/ObservabilityManager.ts index f227c141..8bc09dea 100644 --- a/packages/agents-a365-observability/src/ObservabilityManager.ts +++ b/packages/agents-a365-observability/src/ObservabilityManager.ts @@ -5,14 +5,14 @@ import { ObservabilityBuilder, BuilderOptions } from './ObservabilityBuilder'; /** - * Main entry point for Agent365 providing OpenTelemetry tracing for AI agents and tools + * Main entry point for Agent 365 providing OpenTelemetry tracing for AI agents and tools */ export class ObservabilityManager { private static instance?: ObservabilityBuilder; /** - * Configures Agent365 with OpenTelemetry tracing for AI agents and tools + * Configures Agent 365 with OpenTelemetry tracing for AI agents and tools * @param configure Optional configuration callback for the Builder * @returns The configured Builder instance */ @@ -28,7 +28,7 @@ export class ObservabilityManager { } /** - * Configures and starts Agent365 with simplified options + * Configures and starts Agent 365 with simplified options * @param options Configuration options * @returns The configured and started Builder instance */ @@ -54,7 +54,7 @@ export class ObservabilityManager { } /** - * Gets the current Agent365 instance + * Gets the current Agent 365 instance * @returns The current instance or null if not configured */ public static getInstance(): ObservabilityBuilder | null { @@ -62,7 +62,7 @@ export class ObservabilityManager { } /** - * Shuts down Agent365 + * Shuts down Agent 365 */ public static async shutdown(): Promise { if (ObservabilityManager.instance) { @@ -70,4 +70,4 @@ export class ObservabilityManager { ObservabilityManager.instance = undefined; } } -} \ No newline at end of file +} diff --git a/packages/agents-a365-observability/src/tracing/constants.ts b/packages/agents-a365-observability/src/tracing/constants.ts index 1a5d5da5..162c91a2 100644 --- a/packages/agents-a365-observability/src/tracing/constants.ts +++ b/packages/agents-a365-observability/src/tracing/constants.ts @@ -3,7 +3,7 @@ // ------------------------------------------------------------------------------ /** - * OpenTelemetry constants for Agent365 + * OpenTelemetry constants for Agent 365 */ export class OpenTelemetryConstants { // Span operation names diff --git a/packages/agents-a365-observability/src/tracing/exporter/utils.ts b/packages/agents-a365-observability/src/tracing/exporter/utils.ts index d0f12574..1a63dfc1 100644 --- a/packages/agents-a365-observability/src/tracing/exporter/utils.ts +++ b/packages/agents-a365-observability/src/tracing/exporter/utils.ts @@ -109,13 +109,13 @@ export function partitionByIdentity( } /** - * Check if agent365 exporter is enabled via environment variable + * Check if Agent 365 exporter is enabled via environment variable */ export function isAgent365ExporterEnabled(): boolean { const a365Env = process.env[OpenTelemetryConstants.ENABLE_A365_OBSERVABILITY_EXPORTER]?.toLowerCase() || ''; const validValues = ['true', '1', 'yes', 'on']; const enabled: boolean = validValues.includes(a365Env); - logger.info(`[Agent365Exporter] Agent365 exporter enabled: ${enabled}`); + logger.info(`[Agent365Exporter] Agent 365 exporter enabled: ${enabled}`); return enabled; } diff --git a/packages/agents-a365-observability/src/utils/logging.ts b/packages/agents-a365-observability/src/utils/logging.ts index 0e1a3a4d..bc00c540 100644 --- a/packages/agents-a365-observability/src/utils/logging.ts +++ b/packages/agents-a365-observability/src/utils/logging.ts @@ -13,7 +13,7 @@ export function formatError(error: unknown): string { } /** - * Simple logger for Agent365 observability + * Simple logger for Agent 365 observability * * Usage: * import logger from './logging'; @@ -92,4 +92,4 @@ const logger = { } }; -export default logger; \ No newline at end of file +export default logger; diff --git a/packages/agents-a365-runtime/package.json b/packages/agents-a365-runtime/package.json index de597cd1..b26657b9 100644 --- a/packages/agents-a365-runtime/package.json +++ b/packages/agents-a365-runtime/package.json @@ -29,8 +29,8 @@ "license": "See license file", "repository": { "type": "git", - "url": "https://github.com/microsoft/Agent365.git", - "directory": "nodejs/packages/agents-a365-runtime" + "url": "https://github.com/microsoft/Agent365-nodejs.git", + "directory": "packages/agents-a365-runtime" }, "dependencies": { "@microsoft/agents-hosting": "*", diff --git a/packages/agents-a365-tooling-extensions-claude/package.json b/packages/agents-a365-tooling-extensions-claude/package.json index 5b5c517c..e63946a6 100644 --- a/packages/agents-a365-tooling-extensions-claude/package.json +++ b/packages/agents-a365-tooling-extensions-claude/package.json @@ -30,8 +30,8 @@ "license": "See license file", "repository": { "type": "git", - "url": "https://github.com/microsoft/Agent365.git", - "directory": "nodejs/packages/agents-a365-tooling-extensions-claude" + "url": "https://github.com/microsoft/Agent365-nodejs.git", + "directory": "packages/agents-a365-tooling-extensions-claude" }, "dependencies": { "@microsoft/agents-a365-tooling": "workspace:*", diff --git a/packages/agents-a365-tooling-extensions-langchain/package.json b/packages/agents-a365-tooling-extensions-langchain/package.json index b43eebf0..72ddad0a 100644 --- a/packages/agents-a365-tooling-extensions-langchain/package.json +++ b/packages/agents-a365-tooling-extensions-langchain/package.json @@ -30,8 +30,8 @@ "license": "See license file", "repository": { "type": "git", - "url": "https://github.com/microsoft/Agent365.git", - "directory": "nodejs/packages/agents-a365-tooling-extensions-langchain" + "url": "https://github.com/microsoft/Agent365-nodejs.git", + "directory": "packages/agents-a365-tooling-extensions-langchain" }, "dependencies": { "@microsoft/agents-a365-tooling": "workspace:*", diff --git a/packages/agents-a365-tooling-extensions-openai/package.json b/packages/agents-a365-tooling-extensions-openai/package.json index bcdd67f2..6886704f 100644 --- a/packages/agents-a365-tooling-extensions-openai/package.json +++ b/packages/agents-a365-tooling-extensions-openai/package.json @@ -30,8 +30,8 @@ "license": "See license file", "repository": { "type": "git", - "url": "https://github.com/microsoft/Agent365.git", - "directory": "nodejs/packages/agents-a365-tooling-extensions-openai" + "url": "https://github.com/microsoft/Agent365-nodejs.git", + "directory": "packages/agents-a365-tooling-extensions-openai" }, "dependencies": { "@microsoft/agents-a365-tooling": "workspace:*", diff --git a/packages/agents-a365-tooling/package.json b/packages/agents-a365-tooling/package.json index e248d0a5..fe9d5d74 100644 --- a/packages/agents-a365-tooling/package.json +++ b/packages/agents-a365-tooling/package.json @@ -29,8 +29,8 @@ "license": "See license file", "repository": { "type": "git", - "url": "https://github.com/microsoft/Agent365.git", - "directory": "nodejs/packages/agents-a365-tooling" + "url": "https://github.com/microsoft/Agent365-nodejs.git", + "directory": "packages/agents-a365-tooling" }, "dependencies": { "@microsoft/agents-a365-runtime": "workspace:*", diff --git a/tests-agent/basic-agent-sdk-sample/README.md b/tests-agent/basic-agent-sdk-sample/README.md index 8c5662d4..a84c0ca9 100644 --- a/tests-agent/basic-agent-sdk-sample/README.md +++ b/tests-agent/basic-agent-sdk-sample/README.md @@ -1,8 +1,8 @@ -# Basic Agent365 SDK Sample +# Basic Microsoft Agent 365 SDK Sample -This project shows how a simple agent can be created using Agents SDK and Agent365 SDK in Node.js. +This project shows how a simple agent can be created using Microsoft 365 Agents SDK and Microsoft Agent 365 SDK in Node.js. -To try it out, make sure the Agent365 Node.js SDK has been built: +To try it out, make sure the Microsoft Agent 365 Node.js SDK has been built: ```sh $ cd nodejs/src @@ -47,14 +47,14 @@ In the first terminal, where you are running the agent application, you should s 'process.executable.name': 'C:\\WINDOWS\\system32\\cmd.exe ', 'process.executable.path': 'C:\\Program Files\\nodejs\\node.exe', 'process.command_args': [ - 'D:\\Agent365\\nodejs\\node_modules\\ts-node\\dist\\bin.js', - 'D:\\Agent365\\nodejs\\node_modules\\ts-node\\dist\\bin.js', - 'D:\\Agent365\\nodejs\\samples\\basic-agent-sdk-sample\\src\\index.ts' + 'D:\\Agent365-nodejs\\node_modules\\ts-node\\dist\\bin.js', + 'D:\\Agent365-nodejs\\node_modules\\ts-node\\dist\\bin.js', + 'D:\\Agent365-nodejs\\tests-agent\\basic-agent-sdk-sample\\src\\index.ts' ], 'process.runtime.version': '20.12.2', 'process.runtime.name': 'nodejs', 'process.runtime.description': 'Node.js', - 'process.command': 'D:\\Agent365\\nodejs\\samples\\basic-agent-sdk-sample\\src\\index.ts', + 'process.command': 'D:\\Agent365-nodejs\\tests-agent\\basic-agent-sdk-sample\\src\\index.ts', 'process.owner': 'XXXX', 'telemetry.sdk.language': 'nodejs', 'telemetry.sdk.name': 'opentelemetry', diff --git a/tests-agent/basic-agent-sdk-sample/src/index.ts b/tests-agent/basic-agent-sdk-sample/src/index.ts index f445680a..4fe6762e 100644 --- a/tests-agent/basic-agent-sdk-sample/src/index.ts +++ b/tests-agent/basic-agent-sdk-sample/src/index.ts @@ -43,7 +43,7 @@ const server = app.listen(port, () => { await a365Observability.shutdown(); process.exit(1); }).on('close', async () => { - console.log('Agent365 observability is shutting down...'); + console.log('Agent 365 observability is shutting down...'); await a365Observability.shutdown(); }); diff --git a/tests-agent/openai-agent-auto-instrument-sample/.env.example b/tests-agent/openai-agent-auto-instrument-sample/.env.example index 2593e73c..2117620b 100644 --- a/tests-agent/openai-agent-auto-instrument-sample/.env.example +++ b/tests-agent/openai-agent-auto-instrument-sample/.env.example @@ -4,7 +4,7 @@ TOOLS_MODE=MockMCPServer MCP_AUTH_TOKEN= -# Agent365 Authentication Configuration +# Agent 365 Authentication Configuration AGENT_APPLICATION_ID= AGENT_CLIENT_SECRET= AGENT_ID= @@ -25,4 +25,3 @@ OPENAI_AGENTS_DISABLE_TRACING=false OTEL_SDK_DISABLED=false AGENT_ID='REPLACE-WITH-YOUR-AGENT-ID-BUT-THIS-WILL-GO-AWAY-SOON' CONNECTION_STRING='REPLACE-WITH-YOUR-CONNECTION-STRING-BUT-THIS-WILL-GO-AWAY-SOON' - \ No newline at end of file diff --git a/tests-agent/openai-agent-auto-instrument-sample/README.md b/tests-agent/openai-agent-auto-instrument-sample/README.md index 2a55926d..9a3a013e 100644 --- a/tests-agent/openai-agent-auto-instrument-sample/README.md +++ b/tests-agent/openai-agent-auto-instrument-sample/README.md @@ -1,10 +1,10 @@ # Sample Agent - Node.js OpenAI -This directory contains a sample OpenAI agent implementation using the Agent365 framework with Node.js and Agent365 OpenAI Agents SDK instrumentation extensions. +This directory contains a sample OpenAI agent implementation using the Microsoft Agent 365 SDK with Node.js and OpenAI Agents SDK instrumentation extensions. ## Demonstrates -This sample demonstrates how to build auto instrument for Agent365 using OpenAI Agents SDK instrumentation extensions for telemetry and observability. +This sample demonstrates how to build auto instrument for Microsoft Agent 365 using OpenAI Agents SDK instrumentation extensions for telemetry and observability. @@ -36,7 +36,7 @@ $ npm run build Create the required `.env` file out of the provided example `.env.example`. Just copying it as-is should be enough. -If you'd like to use Agentic authentication, you should set the values under Agent365 Authentication Configuration. +If you'd like to use Agentic authentication, you should set the values under Agent 365 Authentication Configuration. Otherwise, you can set the value `MCP_AUTH_TOKEN` to authentication against your MCP servers. `NODE_ENV` should be set to `Development` if you'd like to use your tooling manifest. Otherwise, the tooling sdk will @@ -144,7 +144,7 @@ This sample includes a VS Code debug configuration. To debug: - You can get an API key from: https://platform.openai.com/api-keys 2. **Launch the debugger**: - - Open VS Code in the root Agent365 directory + - Open VS Code in the root Agent 365 directory - Go to Run and Debug (Ctrl+Shift+D) - Select "Debug OpenAI Agent with Instrumentation" from the dropdown - Press F5 or click the green play button diff --git a/tests-agent/openai-agent-auto-instrument-sample/package.json b/tests-agent/openai-agent-auto-instrument-sample/package.json index c9444e18..acb5a515 100644 --- a/tests-agent/openai-agent-auto-instrument-sample/package.json +++ b/tests-agent/openai-agent-auto-instrument-sample/package.json @@ -25,7 +25,7 @@ ], "author": "Microsoft Corporation", "license": "MIT", - "description": "Sample OpenAI agent with instrumentation using Agent365 SDK", + "description": "Sample OpenAI agent with instrumentation using Microsoft Agent 365 SDK", "dependencies": { "@microsoft/agents-hosting": "*", "@microsoft/agents-activity": "*", diff --git a/tests/observability/core/observabilityManager.test.ts b/tests/observability/core/observabilityManager.test.ts index 6846046b..5eb0d850 100644 --- a/tests/observability/core/observabilityManager.test.ts +++ b/tests/observability/core/observabilityManager.test.ts @@ -1,7 +1,7 @@ import { describe, it, expect, afterEach } from '@jest/globals'; import { ObservabilityManager, Builder } from '@microsoft/agents-a365-observability'; -describe('Agent365 SDK', () => { +describe('Agent 365 SDK', () => { afterEach(async () => { // Clean up after each test await ObservabilityManager.shutdown(); diff --git a/tests/observability/integration/conftest.ts b/tests/observability/integration/conftest.ts index 9e2911e2..b43dd53f 100644 --- a/tests/observability/integration/conftest.ts +++ b/tests/observability/integration/conftest.ts @@ -29,7 +29,7 @@ export interface AzureOpenAIConfig { } /** - * Agent365 configuration interface + * Agent 365 configuration interface */ export interface Agent365Config { tenantId?: string; @@ -58,7 +58,7 @@ export function getAzureOpenAIConfig(): AzureOpenAIConfig | null { } /** - * Get Agent365 configuration from environment variables + * Get Agent 365 configuration from environment variables */ export function getAgent365Config(): Agent365Config { return { diff --git a/tests/package.json b/tests/package.json index 3f843c7c..dd428804 100644 --- a/tests/package.json +++ b/tests/package.json @@ -30,8 +30,8 @@ "license": "See license file", "repository": { "type": "git", - "url": "https://github.com/microsoft/Agent365.git", - "directory": "nodejs/tests" + "url": "https://github.com/microsoft/Agent365-nodejs.git", + "directory": "tests" }, "dependencies": { "@microsoft/agents-a365-observability": "workspace:*",