@microsoft/agents-a365-tooling 0.1.0-preview.95 → 0.2.0-preview.3

package/dist/esm/configuration/ToolingConfiguration.js

@@ -0,0 +1,113 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { RuntimeConfiguration } from '@microsoft/agents-a365-runtime';
+// Constants for tooling-specific settings
+const MCP_PLATFORM_PROD_BASE_URL = 'https://agent365.svc.cloud.microsoft';
+const PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE = 'ea9ffc3e-8a23-4a7d-836d-234d7c7565c1/.default';
+/**
+ * Resolve the OAuth scope to request for a given MCP server.
+ *
+ * V2 servers carry their own audience in the `audience` field and get a per-audience token.
+ * V1 servers (no `audience`, or audience matching the shared scope's own audience in plain
+ * or api:// form) fall back to `sharedScope` — the configured mcpPlatformAuthenticationScope.
+ *
+ * @param server     The MCP server config returned by the gateway or manifest.
+ * @param sharedScope The configured shared scope (mcpPlatformAuthenticationScope).
+ *   Defaults to the prod ATG scope so that external callers without a custom config
+ *   continue to work without passing the argument.
+ */
+export function resolveTokenScopeForServer(server, sharedScope = PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE) {
+    if (server.audience) {
+        // Extract the audience portion of sharedScope (everything before the last '/').
+        // e.g. 'ea9ffc3e-.../.default'      → 'ea9ffc3e-...'
+        //      'api://ea9ffc3e-.../.default' → 'api://ea9ffc3e-...'
+        const sharedAudience = sharedScope.slice(0, sharedScope.lastIndexOf('/'));
+        // Build the alternate form so we match both 'guid' and 'api://guid'.
+        const sharedAudienceAlt = sharedAudience.startsWith('api://')
+            ? sharedAudience.slice(6) // 'api://guid' → 'guid'
+            : `api://${sharedAudience}`; // 'guid'       → 'api://guid'
+        if (server.audience !== sharedAudience && server.audience !== sharedAudienceAlt) {
+            // V2 server: use its own audience with explicit scope or /.default fallback.
+            return server.scope
+                ? `${server.audience}/${server.scope}`
+                : `${server.audience}/.default`;
+        }
+    }
+    // V1 server: no audience, or audience matches the shared ATG audience.
+    return sharedScope;
+}
+/**
+ * Normalize URL by trimming whitespace and removing trailing slashes.
+ * Prevents double-slash issues in URL construction (e.g., "https://example.com//api").
+ */
+function normalizeUrl(url) {
+    return url.trim().replace(/\/+$/, '');
+}
+/**
+ * Configuration for tooling package.
+ * Inherits runtime settings and adds tooling-specific settings.
+ */
+export class ToolingConfiguration extends RuntimeConfiguration {
+    // Type-safe access to tooling overrides
+    get toolingOverrides() {
+        return this.overrides;
+    }
+    constructor(overrides) {
+        super(overrides);
+    }
+    // Inherited: clusterCategory, isDevelopmentEnvironment, isNodeEnvDevelopment
+    get mcpPlatformEndpoint() {
+        const override = this.toolingOverrides.mcpPlatformEndpoint?.();
+        if (override)
+            return normalizeUrl(override);
+        const envValue = process.env.MCP_PLATFORM_ENDPOINT?.trim();
+        if (envValue)
+            return normalizeUrl(envValue);
+        return MCP_PLATFORM_PROD_BASE_URL;
+    }
+    /**
+     * Whether to use the ToolingManifest.json file instead of gateway discovery.
+     * Returns true when NODE_ENV is set to 'development' (case-insensitive), or
+     * when explicitly overridden via configuration.
+     */
+    get useToolingManifest() {
+        const override = this.toolingOverrides.useToolingManifest?.();
+        if (override !== undefined)
+            return override;
+        return this.isNodeEnvDevelopment;
+    }
+    /**
+     * Gets the MCP platform authentication scope.
+     * Used by AgenticAuthenticationService for token exchange.
+     * Trims whitespace to prevent token exchange failures.
+     */
+    get mcpPlatformAuthenticationScope() {
+        const override = this.toolingOverrides.mcpPlatformAuthenticationScope?.()?.trim();
+        if (override)
+            return override;
+        const envValue = process.env.MCP_PLATFORM_AUTHENTICATION_SCOPE?.trim();
+        if (envValue)
+            return envValue;
+        return PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE;
+    }
+    /**
+     * Returns the dev-mode bearer token for an MCP server by name.
+     * Checks BEARER_TOKEN_<SERVERNAME_UPPER> first, then falls back to BEARER_TOKEN.
+     * Returns undefined when the variable is not set (no Authorization header will be attached).
+     */
+    getBearerTokenForServer(mcpServerName) {
+        const key = mcpServerName.toUpperCase();
+        return process.env[`BEARER_TOKEN_${key}`] ?? process.env['BEARER_TOKEN'];
+    }
+    /**
+     * Returns true when a per-server bearer token env var (BEARER_TOKEN_<SERVERNAME_UPPER>)
+     * is explicitly set for the given server, false when only the shared BEARER_TOKEN fallback
+     * would be used. Used to detect V2 servers that are silently falling back to a
+     * wrong-audience token in dev mode.
+     */
+    hasPerServerBearerToken(mcpServerName) {
+        const key = mcpServerName.toUpperCase();
+        return !!process.env[`BEARER_TOKEN_${key}`];
+    }
+}
+//# sourceMappingURL=ToolingConfiguration.js.map

package/dist/esm/configuration/ToolingConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolingConfiguration.js","sourceRoot":"","sources":["../../../src/configuration/ToolingConfiguration.ts"],"names":[],"mappings":"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"}

package/dist/esm/configuration/ToolingConfigurationOptions.d.ts

@@ -0,0 +1,23 @@
+import { RuntimeConfigurationOptions } from '@microsoft/agents-a365-runtime';
+/**
+ * Tooling configuration options - extends runtime options.
+ * All overrides are functions called on each property access.
+ *
+ * Inherited from RuntimeConfigurationOptions:
+ * - clusterCategory
+ * - isNodeEnvDevelopment
+ */
+export type ToolingConfigurationOptions = RuntimeConfigurationOptions & {
+    mcpPlatformEndpoint?: () => string;
+    /**
+     * Override for using ToolingManifest.json vs gateway discovery.
+     * Falls back to inherited isNodeEnvDevelopment.
+     */
+    useToolingManifest?: () => boolean;
+    /**
+     * Override for MCP platform authentication scope.
+     * Falls back to MCP_PLATFORM_AUTHENTICATION_SCOPE env var, then production default.
+     */
+    mcpPlatformAuthenticationScope?: () => string;
+};
+//# sourceMappingURL=ToolingConfigurationOptions.d.ts.map

package/dist/esm/configuration/ToolingConfigurationOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolingConfigurationOptions.d.ts","sourceRoot":"","sources":["../../../src/configuration/ToolingConfigurationOptions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,MAAM,2BAA2B,GAAG,2BAA2B,GAAG;IACtE,mBAAmB,CAAC,EAAE,MAAM,MAAM,CAAC;IACnC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC;IACnC;;;OAGG;IACH,8BAA8B,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/C,CAAC"}

package/dist/esm/configuration/ToolingConfigurationOptions.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=ToolingConfigurationOptions.js.map

package/dist/esm/configuration/ToolingConfigurationOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolingConfigurationOptions.js","sourceRoot":"","sources":["../../../src/configuration/ToolingConfigurationOptions.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC"}

package/dist/esm/configuration/index.d.ts

@@ -0,0 +1,9 @@
+import { DefaultConfigurationProvider } from '@microsoft/agents-a365-runtime';
+import { ToolingConfiguration } from './ToolingConfiguration';
+export * from './ToolingConfigurationOptions';
+export * from './ToolingConfiguration';
+/**
+ * Shared default provider for ToolingConfiguration.
+ */
+export declare const defaultToolingConfigurationProvider: DefaultConfigurationProvider<ToolingConfiguration>;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/configuration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/configuration/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,mCAAmC,oDACoB,CAAC"}

package/dist/esm/configuration/index.js

@@ -0,0 +1,11 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { DefaultConfigurationProvider } from '@microsoft/agents-a365-runtime';
+import { ToolingConfiguration } from './ToolingConfiguration';
+export * from './ToolingConfigurationOptions';
+export * from './ToolingConfiguration';
+/**
+ * Shared default provider for ToolingConfiguration.
+ */
+export const defaultToolingConfigurationProvider = new DefaultConfigurationProvider(() => new ToolingConfiguration());
+//# sourceMappingURL=index.js.map

package/dist/esm/configuration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/configuration/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAC9C,IAAI,4BAA4B,CAAC,GAAG,EAAE,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/esm/contracts.d.ts

@@ -2,10 +2,16 @@ export interface MCPServerConfig {
     mcpServerName: string;
     url: string;
     headers?: Record<string, string>;
+    audience?: string;
+    scope?: string;
+    publisher?: string;
 }
 export type MCPServerManifestEntry = {
     url?: string;
     headers?: Record<string, string>;
+    audience?: string;
+    scope?: string;
+    publisher?: string;
 } & ({
     mcpServerName: string;
     mcpServerUniqueName?: string;

package/dist/esm/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/contracts.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GAAG,CACA;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,mBAAmB,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAC1D,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/contracts.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,CACA;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,mBAAmB,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAC1D,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/esm/index.d.ts

@@ -2,4 +2,5 @@ export * from './Utility';
 export * from './McpToolServerConfigurationService';
 export * from './contracts';
 export * from './models';
+export * from './configuration';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,qCAAqC,CAAC;AACpD,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,WAAW,CAAC;AAC1B,cAAc,qCAAqC,CAAC;AACpD,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/dist/esm/index.js

@@ -1,5 +1,8 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
 export * from './Utility';
 export * from './McpToolServerConfigurationService';
 export * from './contracts';
 export * from './models';
+export * from './configuration';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,qCAAqC,CAAC;AACpD,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,cAAc,WAAW,CAAC;AAC1B,cAAc,qCAAqC,CAAC;AACpD,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/agents-a365-tooling",
-  "version": "0.1.0-preview.95",
+  "version": "0.2.0-preview.3",
   "description": "Agent 365 Tooling SDK for AI agents built with TypeScript/Node.js",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -19,8 +19,8 @@
     "directory": "packages/agents-a365-tooling"
   },
   "dependencies": {
-    "@microsoft/agents-a365-runtime": "0.1.0-preview.95",
-    "@microsoft/agents-hosting": "^1.1.0-alpha.85",
+    "@microsoft/agents-a365-runtime": "0.2.0-preview.3",
+    "@microsoft/agents-hosting": "^1.3.1",
     "@modelcontextprotocol/sdk": "^1.25.2",
     "express": "^5.2.0",
     "hono": "^4.11.7"