### Get Configuration (`getConfiguration`)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Retrieves the configuration object passed to the extension contribution at load time. Use this to access custom settings defined in the extension manifest.

```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const config = SDK.getConfiguration();
// config: { [key: string]: any }
// e.g. { "widgetSize": { "columnSpan": 2, "rowSpan": 2 }, "customSetting": "value" }

const size = config["widgetSize"];
if (size) {
  console.log(`Widget spans ${size.columnSpan} columns × ${size.rowSpan} rows`);
}
```

--------------------------------

### Get Extension Context (`getExtensionContext`)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Fetches details about the currently running extension, including its ID, publisher, version, and base URI for assets. Useful for constructing URLs to bundled resources.

```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const ext = SDK.getExtensionContext();
// ext: IExtensionContext
// {
//   id: "my-publisher.my-extension",
//   publisherId: "my-publisher",
//   extensionId: "my-extension",
//   version: "1.2.3",
//   baseUri: "https://extmgmt.dev.azure.com/..."
// }

// Build a URL to a static asset bundled with the extension
const iconUrl = `${ext.baseUri}/images/icon.png`;
console.log(`Extension ${ext.id} v${ext.version} loaded`);
```

--------------------------------

### Get Team Context (`getTeamContext`)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Retrieves the context of the currently active team, including its ID and name. This is essential for operations that are team-specific.

```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const team = SDK.getTeamContext();
// team: ITeamContext
// {
//   id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
//   name: "Contoso Team"
// }
console.log(`Active team: ${team.name} (${team.id})`);
```

--------------------------------

### Get Host Context (`getHost`)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Retrieves information about the Azure DevOps host (organization or server). Use this to determine if running on Azure DevOps Services or Server and to access host details like name and version.

```typescript
import * as SDK from "azure-devops-extension-sdk";
import { HostType } from "azure-devops-extension-sdk";

await SDK.init();

const host = SDK.getHost();
// host: IHostContext
// {
//   id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
//   name: "my-organization",
//   serviceVersion: "19.218.34106.5",
//   type: HostType.Organization,  // 4
//   isHosted: true
// }

if (host.isHosted) {
  console.log(`Running on Azure DevOps Services: ${host.name}`);
} else {
  console.log(`Running on Azure DevOps Server v${host.serviceVersion}`);
}
```

--------------------------------

### Get Current User Context

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Retrieve the `IUserContext` object after initialization to access details about the signed-in user, such as their display name and image URL. Use the `imageUrl` to display the user's avatar.

```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const user = SDK.getUser();
// user: IUserContext
// {
//   id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
//   descriptor: "aad.BASE64ENCODEDVALUE",
//   name: "user@contoso.com",
//   displayName: "Jane Doe",
//   imageUrl: "https://dev.azure.com/_api/_common/identityImage?id=..."
// }
console.log(`Signed in as: ${user.displayName} (${user.name})`);

// Use imageUrl to display an avatar
const avatar = document.createElement("img");
avatar.src = user.imageUrl;
avatar.alt = user.displayName;
document.body.appendChild(avatar);
```

--------------------------------

### Get Page Context (`getPageContext`)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Obtains comprehensive context for the current Azure DevOps page, including globalization settings (culture, theme, timezone) and web context (project and team identifiers).

```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const page = SDK.getPageContext();
// page.globalization: { culture: "en-US", theme: "dark", timeZoneId: "UTC", ... }
// page.webContext.project: { id: "...", name: "MyProject" }
// page.webContext.team: { id: "...", name: "MyTeam" }

const { culture, theme } = page.globalization;
console.log(`Page culture: ${culture}, theme: ${theme}`);
console.log(`Project: ${page.webContext.project.name}`);
```

--------------------------------

### Get Contribution ID (`getContributionId`)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Returns the unique ID of the contribution that initiated the extension's loading. This is useful for identifying the specific extension point being used.

```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const contributionId = SDK.getContributionId();
// e.g. "my-publisher.my-extension.my-hub"
console.log(`Loaded via contribution: ${contributionId}`);
```

--------------------------------

### Get a user-identity token

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Returns a signed JWT token to identify the current user to a back-end service. This is useful for lightweight user-identity verification without requiring full API access.

```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const appToken = await SDK.getAppToken();
// appToken: "eyJ0eXAiOiJKV1Q..."

// Send to your own back-end for verification
const resp = await fetch("https://my-backend.example.com/api/verify-user", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ token: appToken })
});
const result = await resp.json();
console.log("User verified:", result.verified);
```

--------------------------------

### Get Remote Object Proxy with XDM

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Use channel.getRemoteObjectProxy to obtain a proxy for a remote object, enabling direct method calls on the remote service. This is useful for typed interfaces to complex remote services.

```typescript
import { channelManager } from "azure-devops-extension-sdk/XDM";

interface IRemoteCalculator {
  add(a: number, b: number): Promise<number>;
  multiply(a: number, b: number): Promise<number>;
}

const iframe = document.getElementById("calc-frame") as HTMLIFrameElement;
const channel = channelManager.addChannel(iframe.contentWindow!);

const calculator = await channel.getRemoteObjectProxy<IRemoteCalculator>("calculator");
const sum = await calculator.add(3, 4);       // 7
const product = await calculator.multiply(3, 4); // 12
console.log(`3 + 4 = ${sum}, 3 × 4 = ${product}`);
```

--------------------------------

### Get an Azure DevOps REST API access token

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Retrieves a bearer token for authenticating REST calls to Azure DevOps services. The token is scoped to the current organization and can be used to access resources on behalf of the user.

```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const token = await SDK.getAccessToken();
// token: "eyJ0eXAiOiJKV1Q..."

const host = SDK.getHost();
const response = await fetch(
  `https://dev.azure.com/${host.name}/_apis/projects?api-version=7.1`,
  {
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);
const projects = await response.json();
console.log("Projects:", projects.value.map((p: any) => p.name));
```

--------------------------------

### ready()

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Returns a Promise that resolves once `init()` has completed its handshake with the host. This is useful for synchronizing code execution that depends on the SDK being fully initialized.

```APIDOC
## ready()

### Description
Await completion of initialization. Returns a Promise that resolves once `init()` has completed its handshake with the host. Use this in any code path that may run before or concurrently with `init()`, to safely gate SDK context calls.

### Method
`ready(): Promise<void>`

### Response Example
```typescript
import * as SDK from "azure-devops-extension-sdk";

SDK.init({ loaded: false });

// Independently running code that needs SDK to be ready
SDK.ready().then(() => {
  const user = SDK.getUser();
  console.log(`Hello, ${user.displayName}!`);
  SDK.notifyLoadSucceeded();
});
```
```

--------------------------------

### Initialize SDK

Source: https://github.com/microsoft/azure-devops-extension-sdk/blob/master/README.md

Call SDK.init() after rendering your extension content to notify the host frame that your extension is ready. This ensures your content is displayed correctly.

```typescript
import * as SDK from "azure-devops-extension-sdk";

SDK.init();
```

--------------------------------

### init(options?)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Initializes the extension and performs the handshake with the Azure DevOps host frame. This method must be called before accessing context data. It can be configured to automatically signal load completion or allow manual notification.

```APIDOC
## init(options?)

### Description
Initiates the handshake with the Azure DevOps host frame. Must be called before any other SDK method that returns context data. Accepts an optional `IExtensionInitOptions` object to control whether the extension signals load completion automatically (`loaded: true`, the default) or manually via `notifyLoadSucceeded()`, and whether to apply the host's CSS theme to the extension content.

### Method
`init(options?: IExtensionInitOptions)`

### Parameters
#### Optional Parameters
- **options** (`IExtensionInitOptions`) - An object to configure initialization behavior.
  - **loaded** (`boolean`) - Optional. If `true` (default), the host is automatically notified of load completion. If `false`, manual notification via `notifyLoadSucceeded()` is required.
  - **applyTheme** (`boolean`) - Optional. If `true`, the host's CSS theme is applied to the extension content.

### Request Example
```typescript
import * as SDK from "azure-devops-extension-sdk";

// Option 1: Auto-notify host that extension is ready after handshake
await SDK.init();
console.log("Extension initialized and visible to host");

// Option 2: Defer load notification (useful for async data fetching before display)
await SDK.init({ loaded: false, applyTheme: true });
// ... perform async setup work ...
try {
  await fetchMyExtensionData();
  await SDK.notifyLoadSucceeded(); // Tell host to stop showing the spinner
} catch (e) {
  await SDK.notifyLoadFailed(e as Error); // Tell host the extension failed
}
```
```

--------------------------------

### Await Initialization Completion

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Use SDK.ready() to ensure the SDK is initialized before accessing context data. This is useful when SDK calls might occur before or concurrently with SDK.init().

```typescript
import * as SDK from "azure-devops-extension-sdk";

SDK.init({ loaded: false });

// Independently running code that needs SDK to be ready
SDK.ready().then(() => {
  const user = SDK.getUser();
  console.log(`Hello, ${user.displayName}!`);
  SDK.notifyLoadSucceeded();
});
```

--------------------------------

### Initialize Extension and Perform Handshake

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Call SDK.init() to establish communication with the host frame. Use `{ loaded: false }` to manually control load completion with `notifyLoadSucceeded()` or `notifyLoadFailed()`.

```typescript
import * as SDK from "azure-devops-extension-sdk";

// Option 1: Auto-notify host that extension is ready after handshake
await SDK.init();
console.log("Extension initialized and visible to host");

// Option 2: Defer load notification (useful for async data fetching before display)
await SDK.init({ loaded: false, applyTheme: true });
// ... perform async setup work ...
try {
  await fetchMyExtensionData();
  await SDK.notifyLoadSucceeded(); // Tell host to stop showing the spinner
} catch (e) {
  await SDK.notifyLoadFailed(e as Error); // Tell host the extension failed
}
```

--------------------------------

### Import SDK using AMD Modules

Source: https://github.com/microsoft/azure-devops-extension-sdk/blob/master/README.md

Use this method to import the SDK if your project is using AMD modules. No changes are needed for existing AMD projects.

```javascript
require(['azure-devops-extension-sdk'], function(SDK) {
  // Use the module here
});
```

--------------------------------

### getConfiguration()

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Retrieves the initial configuration object provided to the extension by the host.

```APIDOC
## getConfiguration()

### Description
Returns the initial configuration object passed by the host to this extension contribution at load time. Useful for reading properties defined in the extension manifest's contribution properties.

### Usage
```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const config = SDK.getConfiguration();
// config: { [key: string]: any }
// e.g. { "widgetSize": { "columnSpan": 2, "rowSpan": 2 }, "customSetting": "value" }

const size = config["widgetSize"];
if (size) {
  console.log(`Widget spans ${size.columnSpan} columns × ${size.rowSpan} rows`);
}
```
```

--------------------------------

### Import SDK using ES Modules

Source: https://github.com/microsoft/azure-devops-extension-sdk/blob/master/README.md

Use this method to import the SDK for projects utilizing ES modules. This offers performance improvements and reduces application size.

```javascript
import * as SDK from 'azure-devops-extension-sdk';
// Use the module here
```

--------------------------------

### getHost()

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Retrieves the host organization context, including details about whether the instance is hosted or on-premises.

```APIDOC
## getHost()

### Description
Returns an `IHostContext` describing the Azure DevOps organization (or server instance) the extension is running in, including the host type (`Organization`, `Enterprise`, or `Deployment`) and whether it is a hosted (Azure DevOps Services) or on-premises (Azure DevOps Server) instance.

### Usage
```typescript
import * as SDK from "azure-devops-extension-sdk";
import { HostType } from "azure-devops-extension-sdk";

await SDK.init();

const host = SDK.getHost();
// host: IHostContext
// {
//   id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
//   name: "my-organization",
//   serviceVersion: "19.218.34106.5",
//   type: HostType.Organization,  // 4
//   isHosted: true
// }

if (host.isHosted) {
  console.log(`Running on Azure DevOps Services: ${host.name}`);
} else {
  console.log(`Running on Azure DevOps Server v${host.serviceVersion}`);
}
```
```

--------------------------------

### resize(width?, height?)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Requests the host to resize the extension iframe. Defaults to the current `document.body.scrollWidth` and `document.body.scrollHeight` if dimensions are omitted.

```APIDOC
## resize(width?, height?)

### Description
Requests the parent Azure DevOps frame to resize the iframe container for this extension. Defaults to the current `document.body.scrollWidth` and `document.body.scrollHeight` if dimensions are omitted.

### Parameters
- **width** (number) - Optional - The desired width of the iframe in pixels.
- **height** (number) - Optional - The desired height of the iframe in pixels.

### Example
```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

// Auto-resize to fit content
SDK.resize();

// Or specify exact dimensions (pixels)
SDK.resize(800, 600);

// Useful after dynamic content updates
function renderContent(items: string[]) {
  const list = document.getElementById("list")!;
  list.innerHTML = items.map(i => `<li>${i}</li>`).join("");
  SDK.resize(); // Fit the new content height
}
```
```

--------------------------------

### notifyLoadSucceeded()

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Signals to the host frame that the extension has successfully finished loading and its UI is ready. This is only necessary when `init()` is called with the `loaded: false` option.

```APIDOC
## notifyLoadSucceeded()

### Description
Signal successful extension load. Notifies the host frame that the extension has finished loading and its UI is ready to be displayed. Only required when `init()` is called with `{ loaded: false }`.

### Method
`notifyLoadSucceeded(): Promise<void>`

### Request Example
```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init({ loaded: false });

const data = await fetch("/my-extension-data").then(r => r.json());
renderUI(data);

await SDK.notifyLoadSucceeded();
// Host removes loading spinner and shows extension content
```
```

--------------------------------

### applyTheme(themeData)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Injects a `<style>` element into the document `<head>` containing CSS custom properties derived from the host's current theme data. Also dispatches a `themeApplied` window event. Called automatically during `init()` when `applyTheme: true` (the default), but can be called manually.

```APIDOC
## applyTheme(themeData)

### Description
Applies Azure DevOps theme CSS variables by injecting a `<style>` element into the document `<head>`. This element contains CSS custom properties derived from the host's current theme data. It also dispatches a `themeApplied` window event. This function is called automatically during `init()` when `applyTheme: true` (the default), but can be invoked manually.

### Parameters
- **themeData** (object) - Required - An object where keys are CSS variable names (e.g., `--background-color`) and values are their corresponding string values.

### Example
```typescript
import * as SDK from "azure-devops-extension-sdk";

// Manual theme application example
await SDK.init({ applyTheme: false }); // skip auto-apply

const themeData: { [varName: string]: string } = {
  "background-color": "#1e1e1e",
  "text-primary-color": "#ffffff",
  "communication-foreground": "#0078d4"
};

SDK.applyTheme(themeData);
// Injects: :root { --background-color: #1e1e1e; --text-primary-color: #ffffff; ... }
// body { color: var(--text-primary-color) }

// Listen for theme change events dispatched by the host
window.addEventListener("themeApplied", (e: any) => {
  console.log("Theme applied:", e.detail);
});
```
```

--------------------------------

### getExtensionContext()

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Retrieves the extension's identity information, including its ID, publisher, version, and base URI.

```APIDOC
## getExtensionContext()

### Description
Returns an `IExtensionContext` with the full id, publisher, version, and base asset URI of the currently running extension.

### Usage
```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const ext = SDK.getExtensionContext();
// ext: IExtensionContext
// {
//   id: "my-publisher.my-extension",
//   publisherId: "my-publisher",
//   extensionId: "my-extension",
//   version: "1.2.3",
//   baseUri: "https://extmgmt.dev.azure.com/..."
// }

// Build a URL to a static asset bundled with the extension
const iconUrl = `${ext.baseUri}/images/icon.png`;
console.log(`Extension ${ext.id} v${ext.version} loaded`);
```
```

--------------------------------

### register(instanceId, instance)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Registers an object or factory function under a given ID so that the host frame can invoke its methods via XDM. Used to implement contribution callbacks, action providers, and custom context menus.

```APIDOC
## register(instanceId, instance)

### Description
Registers an object or factory function under a given ID so that the host frame (or other channels) can invoke its methods via XDM. Used to implement contribution callbacks, action providers, and custom context menus.

### Parameters
- **instanceId** (string) - Required - The unique identifier for the object or factory function.
- **instance** (object | function) - Required - The object or factory function to register.

### Example
```typescript
import * as SDK from "azure-devops-extension-sdk";

// Register a menu action handler that the host will call
SDK.register("my-publisher.my-extension.my-action", {
  execute: (actionContext: any) => {
    console.log("Action executed with context:", actionContext);
    return { success: true };
  }
});

await SDK.init();
```
```

--------------------------------

### Signal Successful Extension Load

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Call SDK.notifyLoadSucceeded() when the extension has finished loading and is ready to be displayed. This is only necessary when `init()` was called with `{ loaded: false }`.

```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init({ loaded: false });

const data = await fetch("/my-extension-data").then(r => r.json());
renderUI(data);

await SDK.notifyLoadSucceeded();
// Host removes loading spinner and shows extension content
```

--------------------------------

### Resolve Host Service (`getService`)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Obtains a proxy to a service provided by the Azure DevOps host. This is the primary method for extensions to interact with platform services like build or work item tracking.

```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

// Example: retrieve the build service provided by Azure DevOps
interface IBuildService {
  getDefinitions(projectId: string): Promise<{ id: number; name: string }[]>;
}

const buildService = await SDK.getService<IBuildService>(
  "ms.vss-build-web.build-service"
);

const host = SDK.getHost();
const definitions = await buildService.getDefinitions(host.id);
definitions.forEach(def => console.log(`Build def: ${def.name} (${def.id})`));
```

--------------------------------

### getUser()

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Retrieves the current user's context, returning an `IUserContext` object with identity information. This method must be called after `init()` has successfully resolved.

```APIDOC
## getUser()

### Description
Get current user context. Returns an `IUserContext` object containing identity information about the currently signed-in Azure DevOps user. Must be called after `init()` resolves.

### Method
`getUser(): IUserContext`

### Response
#### Success Response
- **IUserContext** (`object`) - An object containing user details.
  - **id** (`string`) - The unique identifier for the user.
  - **descriptor** (`string`) - A descriptor for the user.
  - **name** (`string`) - The user's login name or email.
  - **displayName** (`string`) - The user's display name.
  - **imageUrl** (`string`) - The URL for the user's profile image.

### Request Example
```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const user = SDK.getUser();
// user: IUserContext
// {
//   id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
//   descriptor: "aad.BASE64ENCODEDVALUE",
//   name: "user@contoso.com",
//   displayName: "Jane Doe",
//   imageUrl: "https://dev.azure.com/_api/_common/identityImage?id=..."
// }
console.log(`Signed in as: ${user.displayName} (${user.name})`);

// Use imageUrl to display an avatar
const avatar = document.createElement("img");
avatar.src = user.imageUrl;
avatar.alt = user.displayName;
document.body.appendChild(avatar);
```
```

--------------------------------

### Register an object with the SDK

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Use this to expose an object or factory function to the host frame for invocation. It's essential for implementing contribution callbacks and action providers.

```typescript
import * as SDK from "azure-devops-extension-sdk";

// Register a menu action handler that the host will call
SDK.register("my-publisher.my-extension.my-action", {
  execute: (actionContext: any) => {
    console.log("Action executed with context:", actionContext);
    return { success: true };
  }
});

await SDK.init();
```

--------------------------------

### Create Cross-Frame Communication Channel with XDM

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Use channelManager.addChannel to establish communication with a target iframe. Register handlers in the global registry for cross-frame method invocation. Remember to clean up channels using removeChannel.

```typescript
import { channelManager, globalObjectRegistry } from "azure-devops-extension-sdk/XDM";

// Register a handler in the global registry accessible to all channels
globalObjectRegistry.register("my-service", {
  greet: (name: string) => `Hello, ${name}!`
});

// Create a channel to a child iframe
const iframe = document.getElementById("my-iframe") as HTMLIFrameElement;
const channel = channelManager.addChannel(iframe.contentWindow!, "https://my-extension-host.example.com");

// Invoke a method on an object registered in the remote (child) iframe
const result = await channel.invokeRemoteMethod<
string>(
  "greet",            // method name
  "remote-service",   // registered instance ID on the remote side
  ["World"]           // method arguments
);
console.log(result); // "Hello, World!"

// Clean up when done
channelManager.removeChannel(channel);
```

--------------------------------

### Signal Extension Load Failure

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Use SDK.notifyLoadFailed(error) to inform the host that the extension encountered an error during loading. The host will then display an error state.

```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init({ loaded: false });

try {
  await riskyInitialization();
  await SDK.notifyLoadSucceeded();
} catch (err) {
  await SDK.notifyLoadFailed(err as Error);
  // Expected output: host shows error panel with message from err
}
```

--------------------------------

### Request host to resize the extension iframe

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Asks the parent Azure DevOps frame to resize the iframe container for this extension. Defaults to current content dimensions if omitted. Useful after dynamic content updates.

```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

// Auto-resize to fit content
SDK.resize();

// Or specify exact dimensions (pixels)
SDK.resize(800, 600);

// Useful after dynamic content updates
function renderContent(items: string[]) {
  const list = document.getElementById("list")!;
  list.innerHTML = items.map(i => `<li>${i}</li>`).join("");
  SDK.resize(); // Fit the new content height
}
```

--------------------------------

### getPageContext()

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Fetches the complete context of the current Azure DevOps page, including globalization and web settings.

```APIDOC
## getPageContext()

### Description
Returns an `IPageContext` containing globalization settings (culture, theme, timezone) and the web context (project and team identifiers) for the current Azure DevOps page request.

### Usage
```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const page = SDK.getPageContext();
// page.globalization: { culture: "en-US", theme: "dark", timeZoneId: "UTC", ... }
// page.webContext.project: { id: "...", name: "MyProject" }
// page.webContext.team: { id: "...", name: "MyTeam" }

const { culture, theme } = page.globalization;
console.log(`Page culture: ${culture}, theme: ${theme}`);
console.log(`Project: ${page.webContext.project.name}`);
```
```

--------------------------------

### Apply Azure DevOps theme CSS variables

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Injects CSS custom properties derived from the host's theme into the document. Can be called manually or is applied automatically during `init()`.

```typescript
import * as SDK from "azure-devops-extension-sdk";

// Manual theme application example
await SDK.init({ applyTheme: false }); // skip auto-apply

const themeData: { [varName: string]: string } = {
  "background-color": "#1e1e1e",
  "text-primary-color": "#ffffff",
  "communication-foreground": "#0078d4"
};

SDK.applyTheme(themeData);
// Injects: :root { --background-color: #1e1e1e; --text-primary-color: #ffffff; ... }
// body { color: var(--text-primary-color) }

// Listen for theme change events dispatched by the host
window.addEventListener("themeApplied", (e: any) => {
  console.log("Theme applied:", e.detail);
});
```

--------------------------------

### getService<T>(contributionId)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Resolves and retrieves a service proxy provided by the host, identified by its contribution ID.

```APIDOC
## getService<T>(contributionId)

### Description
Retrieves a remote service proxy registered by the host frame under the given contribution ID. The generic type parameter `T` should be the expected service interface. This is the primary mechanism for calling into Azure DevOps platform services from an extension.

### Usage
```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

// Example: retrieve the build service provided by Azure DevOps
interface IBuildService {
  getDefinitions(projectId: string): Promise<{ id: number; name: string }[]>;
}

const buildService = await SDK.getService<IBuildService>(
  "ms.vss-build-web.build-service"
);

const host = SDK.getHost();
const definitions = await buildService.getDefinitions(host.id);
definitions.forEach(def => console.log(`Build def: ${def.name} (${def.id})`));
```
```

--------------------------------

### notifyLoadFailed(error)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Notifies the host frame that the extension failed to load, causing the host to display an error state instead of the extension content.

```APIDOC
## notifyLoadFailed(error)

### Description
Signal extension load failure. Notifies the host frame that the extension failed to load. The host will display an error state instead of the extension content.

### Method
`notifyLoadFailed(error: Error): Promise<void>`

### Parameters
#### Path Parameters
- **error** (`Error`) - Required - The error object indicating the reason for load failure.

### Request Example
```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init({ loaded: false });

try {
  await riskyInitialization();
  await SDK.notifyLoadSucceeded();
} catch (err) {
  await SDK.notifyLoadFailed(err as Error);
  // Expected output: host shows error panel with message from err
}
```
```

--------------------------------

### getAppToken()

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Returns a signed JWT token that can be used to identify the current user to a back-end service without needing full API access. Useful for lightweight user-identity verification in extension back-ends.

```APIDOC
## getAppToken()

### Description
Fetches a user-identity token. This signed JWT token can be used to identify the current user to a back-end service without requiring full API access, useful for lightweight user-identity verification in extension back-ends.

### Returns
- **Promise<string>** - A promise that resolves to the application token string.

### Example
```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const appToken = await SDK.getAppToken();
// appToken: "eyJ0eXAiOiJKV1Q..."

// Send to your own back-end for verification
const resp = await fetch("https://my-backend.example.com/api/verify-user", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ token: appToken })
});
const result = await resp.json();
console.log("User verified:", result.verified);
```
```

--------------------------------

### channel.getRemoteObjectProxy

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Returns a proxy that represents an entire object registered on the remote side of the channel. Calling any method on the returned proxy automatically issues an XDM RPC call. Useful for obtaining a typed interface to a complex remote service.

```APIDOC
## channel.getRemoteObjectProxy<T>(instanceId, contextData?)

### Description
Returns a proxy that represents an entire object registered on the remote side of the channel. Calling any method on the returned proxy automatically issues an XDM RPC call. Useful for obtaining a typed interface to a complex remote service.

### Method
`channel.getRemoteObjectProxy<T>(instanceId, contextData?)`

### Parameters
#### Path Parameters
- **instanceId** (string) - Required - The ID of the remote object instance.
- **contextData** (any) - Optional - Additional context data to pass to the remote object.

### Request Example
```typescript
import { channelManager } from "azure-devops-extension-sdk/XDM";

interface IRemoteCalculator {
  add(a: number, b: number): Promise<number>;
  multiply(a: number, b: number): Promise<number>;
}

const iframe = document.getElementById("calc-frame") as HTMLIFrameElement;
const channel = channelManager.addChannel(iframe.contentWindow!);

const calculator = await channel.getRemoteObjectProxy<IRemoteCalculator>("calculator");
const sum = await calculator.add(3, 4);       // 7
const product = await calculator.multiply(3, 4); // 12
console.log(`3 + 4 = ${sum}, 3 × 4 = ${product}`);
```

### Response
#### Success Response (Proxy Object)
- Returns a proxy object that implements the specified generic type `T`, allowing typed access to remote object methods.
```

--------------------------------

### channelManager.addChannel

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Creates a new XDMChannel for communicating with a target iframe window. The channelManager manages all active channels and routes incoming postMessage events to the correct channel. This is a low-level API; most extensions use the high-level SDK functions instead.

```APIDOC
## channelManager.addChannel(window, targetOrigin?)

### Description
Creates a new `XDMChannel` for communicating with a target iframe window. The `channelManager` manages all active channels and routes incoming `postMessage` events to the correct channel. This is a low-level API; most extensions use the high-level `SDK` functions instead.

### Method
`channelManager.addChannel(window, targetOrigin?)`

### Parameters
#### Path Parameters
- **window** (Window) - Required - The target iframe window object.
- **targetOrigin** (string) - Optional - The target origin for the iframe.

### Request Example
```typescript
import { channelManager, globalObjectRegistry } from "azure-devops-extension-sdk/XDM";

// Register a handler in the global registry accessible to all channels
globalObjectRegistry.register("my-service", {
  greet: (name: string) => `Hello, ${name}!`
});

// Create a channel to a child iframe
const iframe = document.getElementById("my-iframe") as HTMLIFrameElement;
const channel = channelManager.addChannel(iframe.contentWindow!, "https://my-extension-host.example.com");

// Invoke a method on an object registered in the remote (child) iframe
const result = await channel.invokeRemoteMethod<
string>(
  "greet",            // method name
  "remote-service",   // registered instance ID on the remote side
  ["World"]           // method arguments
);
console.log(result); // "Hello, World!"

// Clean up when done
channelManager.removeChannel(channel);
```

### Response
#### Success Response (XDMChannel)
- Returns an `XDMChannel` object representing the communication channel.
```

--------------------------------

### getTeamContext()

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Retrieves the context of the currently active team within Azure DevOps.

```APIDOC
## getTeamContext()

### Description
Returns an `ITeamContext` with the id and name of the Azure DevOps team associated with the current page.

### Usage
```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const team = SDK.getTeamContext();
// team: ITeamContext
// {
//   id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
//   name: "Contoso Team"
// }
console.log(`Active team: ${team.name} (${team.id})`);
```
```

--------------------------------

### unregister(instanceId)

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Removes a previously registered object from the channel's object registry, preventing further invocations from the host frame.

```APIDOC
## unregister(instanceId)

### Description
Removes a previously registered object from the channel's object registry, preventing further invocations from the host frame.

### Parameters
- **instanceId** (string) - Required - The unique identifier of the object to unregister.

### Example
```typescript
import * as SDK from "azure-devops-extension-sdk";

const instanceId = "my-publisher.my-extension.my-handler";

SDK.register(instanceId, { handle: (data: any) => console.log(data) });
await SDK.init();

// Later, when the handler is no longer needed:
SDK.unregister(instanceId);
console.log(`${instanceId} unregistered`);
```
```

--------------------------------

### getContributionId()

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Obtains the unique identifier of the contribution that initiated the extension's loading.

```APIDOC
## getContributionId()

### Description
Returns the string contribution ID that caused this extension content to be loaded by the host.

### Usage
```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const contributionId = SDK.getContributionId();
// e.g. "my-publisher.my-extension.my-hub"
console.log(`Loaded via contribution: ${contributionId}`);
```
```

--------------------------------

### getAccessToken()

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Retrieves a bearer token that can be used to authenticate REST calls to Azure DevOps services on behalf of the current user. The token is scoped to the current organization.

```APIDOC
## getAccessToken()

### Description
Fetches an Azure DevOps REST API access token. This token can be used to authenticate REST calls to Azure DevOps services on behalf of the current user and is scoped to the current organization.

### Returns
- **Promise<string>** - A promise that resolves to the access token string.

### Example
```typescript
import * as SDK from "azure-devops-extension-sdk";

await SDK.init();

const token = await SDK.getAccessToken();
// token: "eyJ0eXAiOiJKV1Q..."

const host = SDK.getHost();
const response = await fetch(
  `https://dev.azure.com/${host.name}/_apis/projects?api-version=7.1`,
  {
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);
const projects = await response.json();
console.log("Projects:", projects.value.map((p: any) => p.name));
```
```

--------------------------------

### Unregister a previously registered object

Source: https://context7.com/microsoft/azure-devops-extension-sdk/llms.txt

Removes a registered object from the channel's registry, stopping further invocations from the host frame. Ensure you unregister when a handler is no longer needed.

```typescript
import * as SDK from "azure-devops-extension-sdk";

const instanceId = "my-publisher.my-extension.my-handler";

SDK.register(instanceId, { handle: (data: any) => console.log(data) });
await SDK.init();

// Later, when the handler is no longer needed:
SDK.unregister(instanceId);
console.log(`${instanceId} unregistered`);
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.