@uipath/uipath-typescript 1.0.0-beta.10

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright 2025 UiPath
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/Readme.md

@@ -0,0 +1,260 @@
+# UiPath TypeScript SDK
+
+[View Full API Reference ↗](https://uipath.github.io/uipath-typescript/getting-started/)
+
+A comprehensive TypeScript SDK for interacting with UiPath Platform services.
+
+## Installation
+
+```bash
+npm install @uipath/uipath-typescript
+# or
+yarn add @uipath/uipath-typescript
+# or
+pnpm add @uipath/uipath-typescript
+```
+
+
+## Quick Start
+
+```typescript
+import { UiPath } from '@uipath/uipath-typescript';
+
+// Initialize the SDK
+const sdk = new UiPath({
+  baseUrl: 'https://cloud.uipath.com',
+  orgName: 'your-organization',
+  tenantName: 'your-tenant',
+  secret: 'your-secret' //PAT Token or Bearer Token 
+});
+
+// Use the services
+const processes = await sdk.maestro.processes.getAll();
+const tasks = await sdk.tasks.getAll();
+```
+
+## Authentication
+
+The SDK supports two authentication methods:
+
+### 1. Secret-based Authentication
+```typescript
+const sdk = new UiPath({
+  baseUrl: 'https://cloud.uipath.com',
+  orgName: 'your-organization',
+  tenantName: 'your-tenant',
+  secret: 'your-secret' //PAT Token or Bearer Token 
+});
+```
+
+For OAuth, first create a non confidential [External App](https://docs.uipath.com/automation-cloud/automation-cloud/latest/admin-guide/managing-external-applications) with the required scopes and provide the clientId, redirectUri, and scope here.
+
+### 2. OAuth Authentication
+```typescript
+const sdk = new UiPath({
+  baseUrl: 'https://cloud.uipath.com',
+  orgName: 'your-organization',
+  tenantName: 'your-tenant',
+  clientId: 'your-client-id',
+  redirectUri: 'your-redirect-uri',
+  scope: 'your-scopes'
+});
+
+// IMPORTANT: OAuth requires calling initialize()
+await sdk.initialize();
+```
+
+## SDK Initialization - The initialize() Method
+
+### When to Use initialize()
+
+The `initialize()` method completes the authentication process for the SDK:
+
+- **Secret Authentication**: Auto-initializes when creating the SDK instance - **no need to call initialize()**
+- **OAuth Authentication**: **MUST call** `await sdk.initialize()` before using any SDK services
+
+### Example: Secret Authentication (Auto-initialized)
+```typescript
+const sdk = new UiPath({
+  baseUrl: 'https://cloud.uipath.com',
+  orgName: 'your-organization',
+  tenantName: 'your-tenant',
+  secret: 'your-secret' //PAT Token or Bearer Token 
+});
+
+// Ready to use immediately - no initialize() needed
+const tasks = await sdk.tasks.getAll();
+```
+
+### Example: OAuth Authentication (Requires initialize)
+```typescript
+const sdk = new UiPath({
+  baseUrl: 'https://cloud.uipath.com',
+  orgName: 'your-organization',
+  tenantName: 'your-tenant',
+  clientId: 'your-client-id',
+  redirectUri: 'http://localhost:3000',
+  scope: 'your-scopes'
+});
+
+// Must initialize before using services
+try {
+  await sdk.initialize();
+  console.log('SDK initialized successfully');
+  
+  // Now you can use the SDK
+  const tasks = await sdk.tasks.getAll();
+} catch (error) {
+  console.error('Failed to initialize SDK:', error);
+}
+```
+
+## Available Services
+
+The SDK provides access to the following services through a consistent API:
+
+- `sdk.maestro.processes` - Manage agentic maestro processes
+- `sdk.maestro.processes.instances` - Manage maestro process executions
+- `sdk.tasks` - Create and manage tasks
+- `sdk.entities` - Data Fabric entity operations
+- `sdk.processes` - Manage Orchestrator processes
+- `sdk.buckets` - Manage storage buckets in Orchestrator
+- `sdk.queues` - Manage Orchestrator queues
+- `sdk.assets` - Manage Orchestrator assets
+
+
+**Example usage**:
+```typescript
+// Get all processes
+const bpmnProcesses = await sdk.maestro.processes.getAll();
+
+// Get a specific task
+const task = await sdk.tasks.getById('task-id');
+
+// Create a new entity
+const entity = await sdk.entities.create({...});
+
+// Get all buckets 
+const buckets = await sdk.buckets.getAll();
+
+// Get a specific process and start it
+const process = await sdk.processes.getAll({ 
+  filter: "name eq 'MyProcess'" 
+});
+const job = await sdk.processes.start({
+  processKey: process[0].key
+}, 'folder-id');
+
+// Get all queues
+const queues = await sdk.queues.getAll();
+
+// Get all assets
+const assets = await sdk.assets.getAll();
+//Get assets in a folder
+const assets = await sdk.assets.getAll({folderId: 'folder-id'});
+```
+
+## TypeScript Support
+
+The SDK is fully typed and exports all types for better developer experience and LLM-friendly coding:
+
+```typescript
+import { 
+  UiPath,
+  // Task types
+  TaskCreateOptions,
+  TaskPriority,
+  TaskStatus,
+  
+  // Process types  
+  ProcessStartRequest,
+  ProcessStartResponse,
+  ProcessGetResponse,
+  
+  // Entity types
+  EntityGetResponse,
+  EntityInsertOptions,
+  
+  // Asset/Queue/Bucket types
+  AssetGetResponse,
+  QueueGetResponse,
+  BucketGetResponse,
+  
+  // Maestro types
+  ProcessInstanceGetResponse,
+  MaestroProcessGetAllResponse
+} from '@uipath/uipath-typescript';
+
+// TypeScript will provide full intellisense
+const taskOptions: TaskCreateOptions = {
+  title: 'Review Document',
+  priority: TaskPriority.High
+};
+
+const task = await sdk.tasks.create(taskOptions);
+```
+
+## Error Handling
+
+The SDK provides comprehensive error handling with typed errors:
+
+```typescript
+import { UiPathError } from '@uipath/uipath-typescript';
+
+try {
+  const process = await sdk.maestro.processes.getById('invalid-id');
+} catch (error) {
+  if (error instanceof UiPathError) {
+    // Access common error properties
+    console.log('Error Type:', error.type);
+    console.log('Message:', error.message);
+    console.log('Status Code:', error.statusCode);
+    console.log('Request ID:', error.requestId);
+    console.log('Timestamp:', error.timestamp);
+    console.log('error stack trace:', error.stack);
+
+    // Get detailed debug information including stack trace
+    const debugInfo = error.getDebugInfo();
+  }
+}
+```
+
+## Pagination
+
+The SDK provides built-in pagination support:
+
+### Cursor-based Navigation
+
+```typescript
+// Navigate through pages using cursors
+let currentPage = await sdk.assets.getAll({ pageSize: 10 }) as PaginatedResponse<AssetGetResponse>;
+
+while (currentPage.hasNextPage) {
+  // Process current page items
+  currentPage.items.forEach(item => console.log(item.name));
+  
+  // Get next page using cursor
+    currentPage = await sdk.assets.getAll({ 
+    cursor: currentPage.nextCursor 
+  }) as PaginatedResponse<AssetGetResponse>;
+}
+```
+
+### Page Jumping
+
+```typescript
+// Jump directly to page 5 (when supported)
+const page5 = await sdk.assets.getAll({
+  jumpToPage: 5,
+  pageSize: 20
+});
+
+// Check if page jumping is supported
+if (page5.supportsPageJump) {
+  console.log(`Currently on page ${page5.currentPage} of ${page5.totalPages}`);
+}
+```
+
+## Development
+
+Before submitting a pull request, please review our [Contribution Guidelines](https://uipath.github.io/uipath-typescript/CONTRIBUTING/).

package/dist/core/auth/service.d.ts

@@ -0,0 +1,72 @@
+import { BaseService } from '../../services/base';
+import { Config } from '../config/config';
+import { ExecutionContext } from '../context/execution';
+import { TokenManager } from './token-manager';
+import { TokenInfo } from './types';
+export declare class AuthService extends BaseService {
+    private tokenManager;
+    constructor(config: Config, executionContext: ExecutionContext);
+    /**
+     * Get the token manager instance
+     */
+    getTokenManager(): TokenManager;
+    /**
+     * Authenticates the user based on the provided SDK configuration.
+     * This method handles OAuth 2.0 authentication flow only.
+     * For secret-based authentication, see authenticateWithSecret().
+     * @param config The SDK configuration object.
+     * @returns A promise that resolves to true if authentication is successful, otherwise false.
+     * In an OAuth flow, this method will trigger a page redirect and the promise will not resolve.
+     */
+    authenticate(config: Config): Promise<boolean>;
+    /**
+     * Authenticate using OAuth flow
+     */
+    private _authenticateWithOAuth;
+    /**
+     * Authenticate using API secret
+     */
+    authenticateWithSecret(secret: string): boolean;
+    /**
+     * Updates the access token used for API requests
+     * @param tokenInfo The token information containing the access token, type, expiration, and refresh token
+     */
+    updateToken(tokenInfo: TokenInfo): void;
+    /**
+     * Checks if the current token is valid
+     */
+    hasValidToken(): boolean;
+    /**
+     * Get the current token
+     */
+    getToken(): string | undefined;
+    /**
+     * Generates a random code verifier for PKCE
+     */
+    generateCodeVerifier(): string;
+    /**
+     * Generates a code challenge from the code verifier
+     */
+    generateCodeChallenge(codeVerifier: string): Promise<string>;
+    /**
+     * Gets the authorization URL for the OAuth flow
+     */
+    getAuthorizationUrl(params: {
+        clientId: string;
+        redirectUri: string;
+        codeChallenge: string;
+        scope: string;
+        state?: string;
+    }): string;
+    /**
+     * Exchanges the authorization code for an access token and automatically updates the current token
+     */
+    private _getAccessToken;
+    /**
+     * Base64URL encodes an array buffer
+     */
+    private _base64URLEncode;
+    private _initiateOAuthFlow;
+    private _handleOAuthCallback;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/core/auth/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/core/auth/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAa,SAAS,EAAE,MAAM,SAAS,CAAC;AAK/C,qBAAa,WAAY,SAAQ,WAAW;IAC1C,OAAO,CAAC,YAAY,CAAe;gBAEvB,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB;IAO9D;;OAEG;IACI,eAAe,IAAI,YAAY;IAItC;;;;;;;OAOG;IACU,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB3D;;OAEG;YACW,sBAAsB;IA0CpC;;OAEG;IACI,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAUtD;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIvC;;OAEG;IACI,aAAa,IAAI,OAAO;IAI/B;;OAEG;IACI,QAAQ,IAAI,MAAM,GAAG,SAAS;IAOrC;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAgB9B;;OAEG;IACG,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBlE;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,MAAM;IAgBV;;OAEG;YACW,eAAe;IAyC7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;YAQV,kBAAkB;YAgBlB,oBAAoB;CAmBnC"}

package/dist/core/auth/service.js

@@ -0,0 +1,244 @@
+import { BaseService } from '../../services/base';
+import { TokenManager } from './token-manager';
+import { hasOAuthConfig } from '../config/sdk-config';
+import { isBrowser } from '../../utils/platform';
+import { IDENTITY_ENDPOINTS } from '../../utils/constants/endpoints';
+export class AuthService extends BaseService {
+    constructor(config, executionContext) {
+        const isOAuth = hasOAuthConfig(config);
+        const tokenManager = new TokenManager(executionContext, config, isOAuth);
+        super(config, executionContext, tokenManager);
+        this.tokenManager = tokenManager;
+    }
+    /**
+     * Get the token manager instance
+     */
+    getTokenManager() {
+        return this.tokenManager;
+    }
+    /**
+     * Authenticates the user based on the provided SDK configuration.
+     * This method handles OAuth 2.0 authentication flow only.
+     * For secret-based authentication, see authenticateWithSecret().
+     * @param config The SDK configuration object.
+     * @returns A promise that resolves to true if authentication is successful, otherwise false.
+     * In an OAuth flow, this method will trigger a page redirect and the promise will not resolve.
+     */
+    async authenticate(config) {
+        // Try to load token from storage first (only works for OAuth tokens)
+        const loadedFromStorage = this.tokenManager.loadFromStorage();
+        // If we have a valid token from storage, return true
+        if (loadedFromStorage && this.tokenManager.hasValidToken()) {
+            return true;
+        }
+        // If we don't have a valid token from storage, authenticate with OAuth
+        if (hasOAuthConfig(config)) {
+            return await this._authenticateWithOAuth(config.clientId, config.redirectUri, config.scope);
+        }
+        return false;
+    }
+    /**
+     * Authenticate using OAuth flow
+     */
+    async _authenticateWithOAuth(clientId, redirectUri, scope) {
+        if (!isBrowser) {
+            throw new Error('OAuth flow is only supported in browser environments');
+        }
+        // Check if we have a stored code verifier indicating we're in an OAuth flow
+        const codeVerifier = sessionStorage.getItem('uipath_sdk_code_verifier');
+        const isInOAuthFlow = codeVerifier !== null;
+        const urlParams = new URLSearchParams(window.location.search);
+        const code = urlParams.get('code');
+        // If we're in an OAuth flow (server-controlled code verifier exists), handle the callback
+        if (isInOAuthFlow) {
+            // We're expecting a callback - validate parameters
+            if (!code) {
+                // Clear stored state on error
+                sessionStorage.removeItem('uipath_sdk_code_verifier');
+                throw new Error('Authorization code missing in OAuth callback');
+            }
+            // Validate the authorization code format before using it
+            // OAuth authorization codes should be alphanumeric with some special characters
+            const codePattern = /^[A-Za-z0-9\-._~+/]+=*$/;
+            if (!codePattern.test(code)) {
+                // Clear stored state on error
+                sessionStorage.removeItem('uipath_sdk_code_verifier');
+                throw new Error('Invalid authorization code format');
+            }
+            // Authorization code is present and validated, so we can exchange it for a token.
+            await this._handleOAuthCallback(code, clientId, redirectUri);
+            return this.hasValidToken();
+        }
+        else {
+            // Not in an OAuth flow - initiate one
+            // Ignore any URL parameters that might be present
+            await this._initiateOAuthFlow(clientId, redirectUri, scope);
+            // This line is not expected to be reached due to redirect
+            return false;
+        }
+    }
+    /**
+     * Authenticate using API secret
+     */
+    authenticateWithSecret(secret) {
+        try {
+            this.updateToken({ token: secret, type: 'secret' });
+            return true;
+        }
+        catch (error) {
+            console.error('Failed to authenticate with secret', error);
+            return false;
+        }
+    }
+    /**
+     * Updates the access token used for API requests
+     * @param tokenInfo The token information containing the access token, type, expiration, and refresh token
+     */
+    updateToken(tokenInfo) {
+        this.tokenManager.setToken(tokenInfo);
+    }
+    /**
+     * Checks if the current token is valid
+     */
+    hasValidToken() {
+        return this.tokenManager.hasValidToken();
+    }
+    /**
+     * Get the current token
+     */
+    getToken() {
+        if (!this.tokenManager.hasValidToken()) {
+            return undefined;
+        }
+        return this.tokenManager.getToken();
+    }
+    /**
+     * Generates a random code verifier for PKCE
+     */
+    generateCodeVerifier() {
+        if (isBrowser) {
+            const array = new Uint8Array(32);
+            crypto.getRandomValues(array);
+            return this._base64URLEncode(array);
+        }
+        else {
+            // In Node.js environment
+            const crypto = require('crypto');
+            return crypto.randomBytes(32)
+                .toString('base64')
+                .replace(/\+/g, '-')
+                .replace(/\//g, '_')
+                .replace(/=/g, '');
+        }
+    }
+    /**
+     * Generates a code challenge from the code verifier
+     */
+    async generateCodeChallenge(codeVerifier) {
+        if (isBrowser) {
+            const encoder = new TextEncoder();
+            const data = encoder.encode(codeVerifier);
+            const hash = await crypto.subtle.digest('SHA-256', data);
+            return this._base64URLEncode(new Uint8Array(hash));
+        }
+        else {
+            // In Node.js environment
+            const crypto = require('crypto');
+            return crypto.createHash('sha256')
+                .update(codeVerifier)
+                .digest('base64')
+                .replace(/\+/g, '-')
+                .replace(/\//g, '_')
+                .replace(/=/g, '');
+        }
+    }
+    /**
+     * Gets the authorization URL for the OAuth flow
+     */
+    getAuthorizationUrl(params) {
+        const orgName = this.config.orgName;
+        const queryParams = new URLSearchParams({
+            response_type: 'code',
+            client_id: params.clientId,
+            redirect_uri: params.redirectUri,
+            code_challenge: params.codeChallenge,
+            code_challenge_method: 'S256',
+            scope: params.scope + ' offline_access',
+            state: params.state || this.generateCodeVerifier().slice(0, 16)
+        });
+        return `${this.config.baseUrl}/${orgName}/${IDENTITY_ENDPOINTS.AUTHORIZE}?${queryParams.toString()}`;
+    }
+    /**
+     * Exchanges the authorization code for an access token and automatically updates the current token
+     */
+    async _getAccessToken(params) {
+        const orgName = this.config.orgName;
+        const body = new URLSearchParams({
+            grant_type: 'authorization_code',
+            client_id: params.clientId,
+            code: params.code,
+            redirect_uri: params.redirectUri,
+            code_verifier: params.codeVerifier
+        });
+        const response = await fetch(`${this.config.baseUrl}/${orgName}/${IDENTITY_ENDPOINTS.TOKEN}`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded'
+            },
+            body: body.toString()
+        });
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({ message: response.statusText }));
+            console.error("OAuth error:", errorData);
+            throw new Error(`Failed to get access token: ${JSON.stringify(errorData)}`);
+        }
+        const token = await response.json();
+        this.updateToken({
+            token: token.access_token,
+            type: 'oauth',
+            expiresAt: token.expires_in ? new Date(Date.now() + token.expires_in * 1000) : undefined,
+            refreshToken: token.refresh_token
+        });
+        return token;
+    }
+    /**
+     * Base64URL encodes an array buffer
+     */
+    _base64URLEncode(buffer) {
+        const base64 = btoa(String.fromCharCode(...buffer));
+        return base64
+            .replace(/\+/g, '-')
+            .replace(/\//g, '_')
+            .replace(/=/g, '');
+    }
+    async _initiateOAuthFlow(clientId, redirectUri, scope) {
+        const codeVerifier = this.generateCodeVerifier();
+        const codeChallenge = await this.generateCodeChallenge(codeVerifier);
+        sessionStorage.setItem('uipath_sdk_code_verifier', codeVerifier);
+        const authUrl = this.getAuthorizationUrl({
+            clientId,
+            redirectUri,
+            codeChallenge,
+            scope
+        });
+        window.location.href = authUrl;
+    }
+    async _handleOAuthCallback(code, clientId, redirectUri) {
+        const codeVerifier = sessionStorage.getItem('uipath_sdk_code_verifier');
+        if (!codeVerifier) {
+            throw new Error('Code verifier not found in session storage. Authentication may have been interrupted.');
+        }
+        sessionStorage.removeItem('uipath_sdk_code_verifier');
+        await this._getAccessToken({
+            clientId,
+            redirectUri,
+            code,
+            codeVerifier
+        });
+        const url = new URL(window.location.href);
+        url.searchParams.delete('code');
+        url.searchParams.delete('state');
+        window.history.replaceState({}, '', url.toString());
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/core/auth/service.js.map

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

package/dist/core/auth/token-manager.d.ts

@@ -0,0 +1,82 @@
+import { ExecutionContext } from '../context/execution';
+import { AuthToken, TokenInfo } from './types';
+import { Config } from '../config/config';
+/**
+ * TokenManager is responsible for managing authentication tokens.
+ * It provides token operations for a specific client ID.
+ * - For OAuth tokens: Uses session storage with client ID-based keys
+ * - For Secret tokens: Stores only in memory, allowing multiple instances
+ */
+export declare class TokenManager {
+    private executionContext;
+    private config;
+    private isOAuth;
+    private currentToken?;
+    private readonly STORAGE_KEY_PREFIX;
+    private refreshPromise;
+    /**
+     * Creates a new TokenManager instance
+     * @param executionContext The execution context
+     * @param config The SDK configuration
+     * @param isOAuth Whether this is an OAuth-based authentication
+     */
+    constructor(executionContext: ExecutionContext, config: Config, isOAuth?: boolean);
+    /**
+     * Checks if a token is expired
+     * @param tokenInfo The token info to check
+     * @returns true if the token is expired, false otherwise
+     */
+    isTokenExpired(tokenInfo?: TokenInfo): boolean;
+    /**
+     * Gets the storage key for this TokenManager instance
+     */
+    private _getStorageKey;
+    /**
+     * Loads token from session storage if available
+     * @returns true if a valid token was loaded, false otherwise
+     */
+    loadFromStorage(): boolean;
+    /**
+     * Parse and validate token info from storage
+     * @param storedToken JSON string from storage
+     * @returns Valid TokenInfo or undefined if invalid
+     */
+    private _parseTokenInfo;
+    /**
+     * Sets a new token and updates all necessary contexts
+     */
+    setToken(tokenInfo: TokenInfo): void;
+    /**
+     * Gets the current token information
+     */
+    getTokenInfo(): TokenInfo | undefined;
+    /**
+     * Gets just the token string
+     */
+    getToken(): string | undefined;
+    /**
+     * Checks if we have a valid token
+     */
+    hasValidToken(): boolean;
+    /**
+     * Clears the current token
+     */
+    clearToken(): void;
+    /**
+     * Updates execution context with token information
+     */
+    private _updateExecutionContext;
+    /**
+     * Refreshes the access token using the stored refresh token.
+     * This method only works for OAuth flow.
+     * Uses a lock mechanism to prevent multiple simultaneous refreshes.
+     * @returns A promise that resolves to the new AuthToken
+     * @throws Error if not in OAuth flow, refresh token is missing, or the request fails
+     */
+    refreshAccessToken(): Promise<AuthToken>;
+    /**
+     * Internal method to perform the actual token refresh
+     */
+    private _doRefreshToken;
+}
+//# sourceMappingURL=token-manager.d.ts.map