Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
9dbc44b
Fix formatting and spacing in HOW_TO_BUILD.md
pontemonti Nov 13, 2025
3060460
Update HOW_TO_RELEASE.md with release process details
pontemonti Nov 13, 2025
475145d
Fix typo in Agent 365 exporter log message
pontemonti Nov 13, 2025
c54cd44
Update description formatting in package.json
pontemonti Nov 13, 2025
04ce96b
Update comments to use 'Agent 365' instead of 'Agent365'
pontemonti Nov 13, 2025
f4ce22c
Update repository URL and directory in package.json
pontemonti Nov 13, 2025
b296dd6
Fix typos in comments for ObservabilityManager
pontemonti Nov 13, 2025
9bea756
Update repository URL and directory in package.json
pontemonti Nov 13, 2025
344e048
Fix typo in OpenTelemetry constants comment
pontemonti Nov 14, 2025
198e394
Fix typo in documentation comment for index.ts
pontemonti Nov 14, 2025
87dad7f
Fix typo in logging documentation
pontemonti Nov 14, 2025
2ffd17a
Update repository URL in package.json
pontemonti Nov 14, 2025
63b3d8e
Update repository URL and directory in package.json
pontemonti Nov 14, 2025
f3055f2
Update repository URL and directory in package.json
pontemonti Nov 14, 2025
6017db3
Fix description formatting in package.json
pontemonti Nov 14, 2025
8d17864
Update repository URL in package.json
pontemonti Nov 14, 2025
17e75c1
Fix formatting in Agent 365 configuration comments
pontemonti Nov 14, 2025
0ac9313
Fix test suite description for Agent 365 SDK
pontemonti Nov 14, 2025
f7b272a
Fix typo in Agent 365 Authentication comment
pontemonti Nov 14, 2025
efb7a12
Fix log message for observability shutdown
pontemonti Nov 14, 2025
f58d250
Update package.json
pontemonti Nov 14, 2025
01fa72c
Fix description formatting in package.json
pontemonti Nov 14, 2025
2638b62
Fix README formatting and update paths
pontemonti Nov 14, 2025
214be5c
Update README for Agent 365 terminology
pontemonti Nov 14, 2025
1a9899b
Update references to 'Agent 365' to 'Microsoft Agent 365'
pontemonti Nov 14, 2025
357f106
Revise HOW_TO_RELEASE.md for official release process
pontemonti Nov 14, 2025
43da760
Update package description to include 'Microsoft'
pontemonti Nov 14, 2025
e1f8058
Update package description for clarity
pontemonti Nov 14, 2025
6c7d9bb
Update README to include 'Microsoft' in SDK names
pontemonti Nov 14, 2025
17422ca
Update tests-agent/openai-agent-auto-instrument-sample/.env.example
pontemonti Nov 14, 2025
1081681
Update README to correct Microsoft Agent 365 reference
pontemonti Nov 14, 2025
db3d025
Update package.json description for clarity
pontemonti Nov 14, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 5 additions & 6 deletions HOW_TO_BUILD.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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/
Expand Down Expand Up @@ -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)
- [Security Policy](../../SECURITY.md)
14 changes: 8 additions & 6 deletions HOW_TO_RELEASE.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -176,17 +176,17 @@ 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)
7. Click "Publish release"

**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

Expand Down Expand Up @@ -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)
Expand Down Expand Up @@ -524,3 +524,5 @@ git push origin main
**Document Version**: 1.0
**Last Updated**: November 2, 2025
**Maintained By**: DevOps Team


2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -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": {
Expand Down
Original file line number Diff line number Diff line change
@@ -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",
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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';
Expand Down
4 changes: 2 additions & 2 deletions packages/agents-a365-observability/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": "*",
Expand Down
12 changes: 6 additions & 6 deletions packages/agents-a365-observability/src/ObservabilityBuilder.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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 */
Expand All @@ -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 = {};
Expand All @@ -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
*/
Expand All @@ -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
*/
Expand All @@ -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,
Expand All @@ -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 {
Expand Down
12 changes: 6 additions & 6 deletions packages/agents-a365-observability/src/ObservabilityManager.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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
*/
Expand All @@ -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
*/
Expand All @@ -54,20 +54,20 @@ 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 {
return ObservabilityManager.instance || null;
}

/**
* Shuts down Agent365
* Shuts down Agent 365
*/
public static async shutdown(): Promise<void> {
if (ObservabilityManager.instance) {
await ObservabilityManager.instance.shutdown();
ObservabilityManager.instance = undefined;
}
}
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
// ------------------------------------------------------------------------------

/**
* OpenTelemetry constants for Agent365
* OpenTelemetry constants for Agent 365
*/
export class OpenTelemetryConstants {
// Span operation names
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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;
}

Expand Down
4 changes: 2 additions & 2 deletions packages/agents-a365-observability/src/utils/logging.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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';
Expand Down Expand Up @@ -92,4 +92,4 @@ const logger = {
}
};

export default logger;
export default logger;
4 changes: 2 additions & 2 deletions packages/agents-a365-runtime/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": "*",
Expand Down
4 changes: 2 additions & 2 deletions packages/agents-a365-tooling-extensions-claude/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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:*",
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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:*",
Expand Down
4 changes: 2 additions & 2 deletions packages/agents-a365-tooling-extensions-openai/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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:*",
Expand Down
4 changes: 2 additions & 2 deletions packages/agents-a365-tooling/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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:*",
Expand Down
14 changes: 7 additions & 7 deletions tests-agent/basic-agent-sdk-sample/README.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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',
Expand Down
2 changes: 1 addition & 1 deletion tests-agent/basic-agent-sdk-sample/src/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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();
});

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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=
Expand All @@ -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'

Loading
Loading