@topolo/sdk 0.10.3 → 0.10.5

package/dist/index.d.cts

@@ -31,6 +31,12 @@ interface AgentIdentity {
     agentName?: string;
 }
 
+declare const TOPOLO_RUNTIME_ENVIRONMENTS: readonly ["production", "staging", "development", "local"];
+type TopoloRuntimeEnvironment = (typeof TOPOLO_RUNTIME_ENVIRONMENTS)[number];
+declare const TOPOLO_ENVIRONMENT_SERVICE_URLS: Record<TopoloRuntimeEnvironment, Record<string, string>>;
+declare function assertTopoloServiceUrlEnvironment(service: string, value: string, environment: TopoloRuntimeEnvironment): string;
+declare function topoloServiceOrigins(serviceUrls: Record<string, string> | undefined, environment: TopoloRuntimeEnvironment): Record<string, string>;
+
 interface TopoloActionValidationIssue {
     path: string;
     code: string;
@@ -80,6 +86,8 @@ interface TopoloClientOptions {
     agent: AgentIdentity;
     /** Per-service URL overrides. Useful for staging/dev. */
     serviceUrls?: Record<string, string>;
+    /** Explicit environment used to reject cross-environment service and action origins. */
+    environment?: TopoloRuntimeEnvironment;
     /** Per-service TopoloAuth app id overrides from the owning app/deployment. */
     appIds?: Record<string, string>;
     /**
@@ -223,6 +231,7 @@ interface TopoloActionCatalogEntry {
     path: string;
     permissionName: string;
     requiredPermission: string;
+    principalAccess?: 'platform_admin' | 'platform_super_admin' | null;
     /** Static RBAC, contextual runtime policy, or an explicit public/service exception. */
     authorizationMode?: 'static' | 'runtime' | 'public' | 'service';
     allowedServices?: string[];
@@ -283,6 +292,18 @@ interface TopoloActionPlan {
     rollbackActionId: string | null;
     nextActionIds: string[];
 }
+interface TopoloActionPreparation {
+    action: TopoloActionCatalogEntry;
+    example: {
+        title?: string;
+        description?: string;
+        input: Record<string, unknown>;
+    } | null;
+    input: Record<string, unknown>;
+    inputSource: 'provided' | 'example' | 'empty';
+    missingFields: string[];
+    plan: TopoloActionPlan;
+}
 interface TopoloCatalogPage {
     nextCursor: string | null;
     hasMore: boolean;
@@ -309,6 +330,7 @@ declare class TopoloClient {
     private credential;
     private readonly agent;
     private readonly serviceUrls?;
+    private readonly environment?;
     private readonly appIds?;
     private readonly requireConfirmForWrites;
     private readonly timeoutMs;
@@ -340,6 +362,8 @@ declare class TopoloClient {
     request<T = unknown>(opts: RequestOptions): Promise<T>;
     private loadCurrentCredential;
     private refreshRejectedAccessToken;
+    private validatedServiceOrigin;
+    private validatedActionEntry;
     private resolveRequestService;
     private resolveLiveCallableService;
     /**
@@ -419,6 +443,14 @@ declare class TopoloClient {
             resourceId: string;
         };
     }): Promise<TopoloActionPlan>;
+    prepareAction(action: string, input?: Record<string, unknown>, options?: {
+        confirm?: boolean;
+        resource?: {
+            resourceType: string;
+            resourceId: string;
+        };
+    }): Promise<TopoloActionPreparation>;
+    private planResolvedAction;
     readAction<T = unknown>(action: string, input?: Record<string, unknown>, options?: {
         resource?: {
             resourceType: string;
@@ -743,6 +775,72 @@ declare function compactActionPlan(plan: TopoloActionPlan): {
     rollbackActionId: string | null;
     nextActionIds: string[];
 };
+interface TopoloAgentExecutionContext {
+    environment: TopoloRuntimeEnvironment;
+    contextKey: string | null;
+    user: {
+        id: string;
+        email: string;
+        name: string | null;
+        role: string;
+    };
+    organization: {
+        id: string;
+        slug: string;
+        name: string;
+    } | null;
+    serviceOrigins: Record<string, string>;
+}
+declare function createTopoloAgentExecutionContext(input: {
+    environment: TopoloRuntimeEnvironment;
+    contextKey: string | null;
+    identity: CredentialIntrospection;
+    serviceUrls?: Record<string, string>;
+}): TopoloAgentExecutionContext;
+declare function compactActionPreparationCore(preparation: TopoloActionPreparation): {
+    action: {
+        id: string;
+        title: string;
+        docsUrl: string | null;
+    };
+    example: {
+        title: string | null;
+        input: Record<string, unknown>;
+    } | null;
+    input: {
+        source: "example";
+        value?: undefined;
+    } | {
+        source: "provided" | "empty";
+        value: Record<string, unknown>;
+    };
+    missingFields: string[];
+    valid: boolean;
+    errors: TopoloActionValidationIssue[];
+    request: {
+        method: TopoloActionCatalogEntry["method"];
+        service: string;
+        apiBaseUrl: string | null;
+        path: string;
+        query?: Record<string, string | number | boolean>;
+        body?: unknown;
+        resource?: {
+            resourceType: string;
+            resourceId: string;
+        };
+    } | null;
+    confirmation: {
+        required: boolean;
+        provided: boolean;
+    };
+    executable: boolean;
+    verification: string[];
+    rollbackActionId: string | null;
+};
+declare function compactActionPreparation(preparation: TopoloActionPreparation): ReturnType<typeof compactActionPreparationCore>;
+declare function compactActionPreparation(preparation: TopoloActionPreparation, context: TopoloAgentExecutionContext): ReturnType<typeof compactActionPreparationCore> & {
+    context: TopoloAgentExecutionContext;
+};
 declare function compactApplicationAudit(report: ApplicationRequirementsAuditReport): {
     version: string;
     applications: {
@@ -761,6 +859,7 @@ interface TopoloActionDigestInput {
     path: string;
     permission?: string | null;
     permissionName?: string | null;
+    principalAccess?: 'platform_admin' | 'platform_super_admin' | null;
     authorizationMode?: string | null;
     allowedServices?: string[] | null;
     target?: string | null;
@@ -2077,6 +2176,10 @@ declare class TopoloSdkError extends Error {
     readonly code: string;
     constructor(code: string, message: string);
 }
+declare function canonicalTopoloErrorCode(value: unknown): string | null;
+declare function canonicalTopoloRequestId(value: unknown): string | undefined;
+declare function canonicalTopoloRetryAfter(value: unknown): string | undefined;
+declare function canonicalTopoloRequired(value: unknown): string[];
 declare class TopoloAuthError extends TopoloSdkError {
     readonly status: number;
     readonly body: unknown;
@@ -2084,6 +2187,7 @@ declare class TopoloAuthError extends TopoloSdkError {
     readonly path?: string;
     readonly requestId?: string;
     readonly retryAfter?: string;
+    readonly details: unknown;
     constructor(message: string, code?: string, options?: HttpErrorContext);
 }
 declare class TopoloPermissionError extends TopoloSdkError {
@@ -2094,16 +2198,31 @@ declare class TopoloPermissionError extends TopoloSdkError {
     readonly path?: string;
     readonly requestId?: string;
     readonly retryAfter?: string;
+    readonly details: unknown;
     constructor(message: string, required: string[], options?: HttpErrorContext);
 }
 interface HttpErrorContext {
+    code?: string;
     status?: number;
     body?: unknown;
     service?: string;
     path?: string;
     requestId?: string;
     retryAfter?: string;
+    details?: unknown;
 }
+declare function extractTopoloServiceErrorCode(body: unknown): string | null;
+declare function extractTopoloServiceErrorDetails(body: unknown): unknown;
+declare function publicTopoloErrorMessage(error: string | {
+    code?: string;
+    body?: unknown;
+    status?: number;
+    message?: string;
+}): string;
+declare function topoloErrorHint(error: string | {
+    code?: string;
+    body?: unknown;
+}): string | undefined;
 declare class TopoloConfirmationRequiredError extends TopoloSdkError {
     constructor(message: string);
 }
@@ -2114,6 +2233,7 @@ declare class TopoloHttpError extends TopoloSdkError {
     readonly path: string;
     readonly requestId?: string;
     readonly retryAfter?: string;
+    readonly details: unknown;
     constructor(service: string, path: string, status: number, body: unknown, message?: string, options?: HttpErrorContext);
 }
 
@@ -2661,4 +2781,4 @@ declare function createTopolo(options: TopoloClientOptions): {
 };
 type Topolo = ReturnType<typeof createTopolo>;
 
-export { ACTION_CATALOG_DIGEST_ALGORITHM, APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type ActionContractManifest, type ActionContractSource, type AgentIdentity, type AppApiId, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationDirectory, type ApplicationDirectoryApplication, type ApplicationDirectoryClient, type ApplicationDirectorySource, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_APP_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, type P2PActionDetail, type P2PActionRequestInput, type P2PActionRequestResult, type P2PActionRow, type P2PActionRun, type P2PCapability, type P2PConnection, type P2PHold, type P2PLedgerEntry, P2PModule, type P2PPolicy, type P2PPricingModel, type P2PSettlementBatch, type P2PSettlementGroup, type PublishCapabilityInput, type RequestOptions, type ServiceCatalogUrlEntry, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, type TopoloActionAgentContract, type TopoloActionCatalogEntry, type TopoloActionCatalogSummary, type TopoloActionDigestInput, type TopoloActionPlan, type TopoloActionUploadOptions, type TopoloActionValidationIssue, type TopoloActionValidationResult, type TopoloApiKeyResourceMetadata, TopoloAuthError, type TopoloBindableResource, type TopoloBindableResourceCatalog, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, TopoloConfirmationRequiredError, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloInlineBase64UploadContract, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, TopoloSdkError, type TopoloServiceCatalogEntry, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetSnapshotMetadata, type TopoloWidgetSnapshotMetric, type TopoloWidgetType, type TopoloWidgetValidationResult, type TopoloWorkspace, type TopoloWorkspaceListResult, type TopoloWorkspaceMutationResult, type TopoloWorkspacePolicy, WorkspacesModule, actionContractCompleteness, applicationEntryFromCatalog, applicationRequirementScopes, auditAllApplicationRequirements, auditApplicationEntries, auditApplicationRequirements, compactActionCatalogEntry, compactActionPlan, compactActionValidation, compactApplicationAudit, createTopolo, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, digestTopoloActionCatalog, enrichActionContract, formatDirectoryApplicationIds, friendlyAppId, listApplicationDirectory, parseTopoloActionUploadContract, prepareTopoloActionBase64UploadInput, prepareTopoloActionUploadInput, requirementsForApplication, resolveApplicationDirectoryEntry, resolveCatalogServiceUrl, resolveServiceUrl, staticApplicationDirectory, validateTopoloActionInput, validateTopoloWidgetResponse };
+export { ACTION_CATALOG_DIGEST_ALGORITHM, APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type ActionContractManifest, type ActionContractSource, type AgentIdentity, type AppApiId, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationDirectory, type ApplicationDirectoryApplication, type ApplicationDirectoryClient, type ApplicationDirectorySource, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_APP_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, type P2PActionDetail, type P2PActionRequestInput, type P2PActionRequestResult, type P2PActionRow, type P2PActionRun, type P2PCapability, type P2PConnection, type P2PHold, type P2PLedgerEntry, P2PModule, type P2PPolicy, type P2PPricingModel, type P2PSettlementBatch, type P2PSettlementGroup, type PublishCapabilityInput, type RequestOptions, type ServiceCatalogUrlEntry, TOPOLO_ENVIRONMENT_SERVICE_URLS, TOPOLO_RUNTIME_ENVIRONMENTS, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, type TopoloActionAgentContract, type TopoloActionCatalogEntry, type TopoloActionCatalogSummary, type TopoloActionDigestInput, type TopoloActionPlan, type TopoloActionPreparation, type TopoloActionUploadOptions, type TopoloActionValidationIssue, type TopoloActionValidationResult, type TopoloAgentExecutionContext, type TopoloApiKeyResourceMetadata, TopoloAuthError, type TopoloBindableResource, type TopoloBindableResourceCatalog, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, TopoloConfirmationRequiredError, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloInlineBase64UploadContract, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, type TopoloRuntimeEnvironment, TopoloSdkError, type TopoloServiceCatalogEntry, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetSnapshotMetadata, type TopoloWidgetSnapshotMetric, type TopoloWidgetType, type TopoloWidgetValidationResult, type TopoloWorkspace, type TopoloWorkspaceListResult, type TopoloWorkspaceMutationResult, type TopoloWorkspacePolicy, WorkspacesModule, actionContractCompleteness, applicationEntryFromCatalog, applicationRequirementScopes, assertTopoloServiceUrlEnvironment, auditAllApplicationRequirements, auditApplicationEntries, auditApplicationRequirements, canonicalTopoloErrorCode, canonicalTopoloRequestId, canonicalTopoloRequired, canonicalTopoloRetryAfter, compactActionCatalogEntry, compactActionPlan, compactActionPreparation, compactActionValidation, compactApplicationAudit, createTopolo, createTopoloAgentExecutionContext, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, digestTopoloActionCatalog, enrichActionContract, extractTopoloServiceErrorCode, extractTopoloServiceErrorDetails, formatDirectoryApplicationIds, friendlyAppId, listApplicationDirectory, parseTopoloActionUploadContract, prepareTopoloActionBase64UploadInput, prepareTopoloActionUploadInput, publicTopoloErrorMessage, requirementsForApplication, resolveApplicationDirectoryEntry, resolveCatalogServiceUrl, resolveServiceUrl, staticApplicationDirectory, topoloErrorHint, topoloServiceOrigins, validateTopoloActionInput, validateTopoloWidgetResponse };

package/dist/index.d.ts

@@ -31,6 +31,12 @@ interface AgentIdentity {
     agentName?: string;
 }
 
+declare const TOPOLO_RUNTIME_ENVIRONMENTS: readonly ["production", "staging", "development", "local"];
+type TopoloRuntimeEnvironment = (typeof TOPOLO_RUNTIME_ENVIRONMENTS)[number];
+declare const TOPOLO_ENVIRONMENT_SERVICE_URLS: Record<TopoloRuntimeEnvironment, Record<string, string>>;
+declare function assertTopoloServiceUrlEnvironment(service: string, value: string, environment: TopoloRuntimeEnvironment): string;
+declare function topoloServiceOrigins(serviceUrls: Record<string, string> | undefined, environment: TopoloRuntimeEnvironment): Record<string, string>;
+
 interface TopoloActionValidationIssue {
     path: string;
     code: string;
@@ -80,6 +86,8 @@ interface TopoloClientOptions {
     agent: AgentIdentity;
     /** Per-service URL overrides. Useful for staging/dev. */
     serviceUrls?: Record<string, string>;
+    /** Explicit environment used to reject cross-environment service and action origins. */
+    environment?: TopoloRuntimeEnvironment;
     /** Per-service TopoloAuth app id overrides from the owning app/deployment. */
     appIds?: Record<string, string>;
     /**
@@ -223,6 +231,7 @@ interface TopoloActionCatalogEntry {
     path: string;
     permissionName: string;
     requiredPermission: string;
+    principalAccess?: 'platform_admin' | 'platform_super_admin' | null;
     /** Static RBAC, contextual runtime policy, or an explicit public/service exception. */
     authorizationMode?: 'static' | 'runtime' | 'public' | 'service';
     allowedServices?: string[];
@@ -283,6 +292,18 @@ interface TopoloActionPlan {
     rollbackActionId: string | null;
     nextActionIds: string[];
 }
+interface TopoloActionPreparation {
+    action: TopoloActionCatalogEntry;
+    example: {
+        title?: string;
+        description?: string;
+        input: Record<string, unknown>;
+    } | null;
+    input: Record<string, unknown>;
+    inputSource: 'provided' | 'example' | 'empty';
+    missingFields: string[];
+    plan: TopoloActionPlan;
+}
 interface TopoloCatalogPage {
     nextCursor: string | null;
     hasMore: boolean;
@@ -309,6 +330,7 @@ declare class TopoloClient {
     private credential;
     private readonly agent;
     private readonly serviceUrls?;
+    private readonly environment?;
     private readonly appIds?;
     private readonly requireConfirmForWrites;
     private readonly timeoutMs;
@@ -340,6 +362,8 @@ declare class TopoloClient {
     request<T = unknown>(opts: RequestOptions): Promise<T>;
     private loadCurrentCredential;
     private refreshRejectedAccessToken;
+    private validatedServiceOrigin;
+    private validatedActionEntry;
     private resolveRequestService;
     private resolveLiveCallableService;
     /**
@@ -419,6 +443,14 @@ declare class TopoloClient {
             resourceId: string;
         };
     }): Promise<TopoloActionPlan>;
+    prepareAction(action: string, input?: Record<string, unknown>, options?: {
+        confirm?: boolean;
+        resource?: {
+            resourceType: string;
+            resourceId: string;
+        };
+    }): Promise<TopoloActionPreparation>;
+    private planResolvedAction;
     readAction<T = unknown>(action: string, input?: Record<string, unknown>, options?: {
         resource?: {
             resourceType: string;
@@ -743,6 +775,72 @@ declare function compactActionPlan(plan: TopoloActionPlan): {
     rollbackActionId: string | null;
     nextActionIds: string[];
 };
+interface TopoloAgentExecutionContext {
+    environment: TopoloRuntimeEnvironment;
+    contextKey: string | null;
+    user: {
+        id: string;
+        email: string;
+        name: string | null;
+        role: string;
+    };
+    organization: {
+        id: string;
+        slug: string;
+        name: string;
+    } | null;
+    serviceOrigins: Record<string, string>;
+}
+declare function createTopoloAgentExecutionContext(input: {
+    environment: TopoloRuntimeEnvironment;
+    contextKey: string | null;
+    identity: CredentialIntrospection;
+    serviceUrls?: Record<string, string>;
+}): TopoloAgentExecutionContext;
+declare function compactActionPreparationCore(preparation: TopoloActionPreparation): {
+    action: {
+        id: string;
+        title: string;
+        docsUrl: string | null;
+    };
+    example: {
+        title: string | null;
+        input: Record<string, unknown>;
+    } | null;
+    input: {
+        source: "example";
+        value?: undefined;
+    } | {
+        source: "provided" | "empty";
+        value: Record<string, unknown>;
+    };
+    missingFields: string[];
+    valid: boolean;
+    errors: TopoloActionValidationIssue[];
+    request: {
+        method: TopoloActionCatalogEntry["method"];
+        service: string;
+        apiBaseUrl: string | null;
+        path: string;
+        query?: Record<string, string | number | boolean>;
+        body?: unknown;
+        resource?: {
+            resourceType: string;
+            resourceId: string;
+        };
+    } | null;
+    confirmation: {
+        required: boolean;
+        provided: boolean;
+    };
+    executable: boolean;
+    verification: string[];
+    rollbackActionId: string | null;
+};
+declare function compactActionPreparation(preparation: TopoloActionPreparation): ReturnType<typeof compactActionPreparationCore>;
+declare function compactActionPreparation(preparation: TopoloActionPreparation, context: TopoloAgentExecutionContext): ReturnType<typeof compactActionPreparationCore> & {
+    context: TopoloAgentExecutionContext;
+};
 declare function compactApplicationAudit(report: ApplicationRequirementsAuditReport): {
     version: string;
     applications: {
@@ -761,6 +859,7 @@ interface TopoloActionDigestInput {
     path: string;
     permission?: string | null;
     permissionName?: string | null;
+    principalAccess?: 'platform_admin' | 'platform_super_admin' | null;
     authorizationMode?: string | null;
     allowedServices?: string[] | null;
     target?: string | null;
@@ -2077,6 +2176,10 @@ declare class TopoloSdkError extends Error {
     readonly code: string;
     constructor(code: string, message: string);
 }
+declare function canonicalTopoloErrorCode(value: unknown): string | null;
+declare function canonicalTopoloRequestId(value: unknown): string | undefined;
+declare function canonicalTopoloRetryAfter(value: unknown): string | undefined;
+declare function canonicalTopoloRequired(value: unknown): string[];
 declare class TopoloAuthError extends TopoloSdkError {
     readonly status: number;
     readonly body: unknown;
@@ -2084,6 +2187,7 @@ declare class TopoloAuthError extends TopoloSdkError {
     readonly path?: string;
     readonly requestId?: string;
     readonly retryAfter?: string;
+    readonly details: unknown;
     constructor(message: string, code?: string, options?: HttpErrorContext);
 }
 declare class TopoloPermissionError extends TopoloSdkError {
@@ -2094,16 +2198,31 @@ declare class TopoloPermissionError extends TopoloSdkError {
     readonly path?: string;
     readonly requestId?: string;
     readonly retryAfter?: string;
+    readonly details: unknown;
     constructor(message: string, required: string[], options?: HttpErrorContext);
 }
 interface HttpErrorContext {
+    code?: string;
     status?: number;
     body?: unknown;
     service?: string;
     path?: string;
     requestId?: string;
     retryAfter?: string;
+    details?: unknown;
 }
+declare function extractTopoloServiceErrorCode(body: unknown): string | null;
+declare function extractTopoloServiceErrorDetails(body: unknown): unknown;
+declare function publicTopoloErrorMessage(error: string | {
+    code?: string;
+    body?: unknown;
+    status?: number;
+    message?: string;
+}): string;
+declare function topoloErrorHint(error: string | {
+    code?: string;
+    body?: unknown;
+}): string | undefined;
 declare class TopoloConfirmationRequiredError extends TopoloSdkError {
     constructor(message: string);
 }
@@ -2114,6 +2233,7 @@ declare class TopoloHttpError extends TopoloSdkError {
     readonly path: string;
     readonly requestId?: string;
     readonly retryAfter?: string;
+    readonly details: unknown;
     constructor(service: string, path: string, status: number, body: unknown, message?: string, options?: HttpErrorContext);
 }
 
@@ -2661,4 +2781,4 @@ declare function createTopolo(options: TopoloClientOptions): {
 };
 type Topolo = ReturnType<typeof createTopolo>;
 
-export { ACTION_CATALOG_DIGEST_ALGORITHM, APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type ActionContractManifest, type ActionContractSource, type AgentIdentity, type AppApiId, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationDirectory, type ApplicationDirectoryApplication, type ApplicationDirectoryClient, type ApplicationDirectorySource, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_APP_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, type P2PActionDetail, type P2PActionRequestInput, type P2PActionRequestResult, type P2PActionRow, type P2PActionRun, type P2PCapability, type P2PConnection, type P2PHold, type P2PLedgerEntry, P2PModule, type P2PPolicy, type P2PPricingModel, type P2PSettlementBatch, type P2PSettlementGroup, type PublishCapabilityInput, type RequestOptions, type ServiceCatalogUrlEntry, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, type TopoloActionAgentContract, type TopoloActionCatalogEntry, type TopoloActionCatalogSummary, type TopoloActionDigestInput, type TopoloActionPlan, type TopoloActionUploadOptions, type TopoloActionValidationIssue, type TopoloActionValidationResult, type TopoloApiKeyResourceMetadata, TopoloAuthError, type TopoloBindableResource, type TopoloBindableResourceCatalog, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, TopoloConfirmationRequiredError, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloInlineBase64UploadContract, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, TopoloSdkError, type TopoloServiceCatalogEntry, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetSnapshotMetadata, type TopoloWidgetSnapshotMetric, type TopoloWidgetType, type TopoloWidgetValidationResult, type TopoloWorkspace, type TopoloWorkspaceListResult, type TopoloWorkspaceMutationResult, type TopoloWorkspacePolicy, WorkspacesModule, actionContractCompleteness, applicationEntryFromCatalog, applicationRequirementScopes, auditAllApplicationRequirements, auditApplicationEntries, auditApplicationRequirements, compactActionCatalogEntry, compactActionPlan, compactActionValidation, compactApplicationAudit, createTopolo, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, digestTopoloActionCatalog, enrichActionContract, formatDirectoryApplicationIds, friendlyAppId, listApplicationDirectory, parseTopoloActionUploadContract, prepareTopoloActionBase64UploadInput, prepareTopoloActionUploadInput, requirementsForApplication, resolveApplicationDirectoryEntry, resolveCatalogServiceUrl, resolveServiceUrl, staticApplicationDirectory, validateTopoloActionInput, validateTopoloWidgetResponse };
+export { ACTION_CATALOG_DIGEST_ALGORITHM, APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type ActionContractManifest, type ActionContractSource, type AgentIdentity, type AppApiId, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationDirectory, type ApplicationDirectoryApplication, type ApplicationDirectoryClient, type ApplicationDirectorySource, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_APP_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, type P2PActionDetail, type P2PActionRequestInput, type P2PActionRequestResult, type P2PActionRow, type P2PActionRun, type P2PCapability, type P2PConnection, type P2PHold, type P2PLedgerEntry, P2PModule, type P2PPolicy, type P2PPricingModel, type P2PSettlementBatch, type P2PSettlementGroup, type PublishCapabilityInput, type RequestOptions, type ServiceCatalogUrlEntry, TOPOLO_ENVIRONMENT_SERVICE_URLS, TOPOLO_RUNTIME_ENVIRONMENTS, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, type TopoloActionAgentContract, type TopoloActionCatalogEntry, type TopoloActionCatalogSummary, type TopoloActionDigestInput, type TopoloActionPlan, type TopoloActionPreparation, type TopoloActionUploadOptions, type TopoloActionValidationIssue, type TopoloActionValidationResult, type TopoloAgentExecutionContext, type TopoloApiKeyResourceMetadata, TopoloAuthError, type TopoloBindableResource, type TopoloBindableResourceCatalog, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, TopoloConfirmationRequiredError, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloInlineBase64UploadContract, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, type TopoloRuntimeEnvironment, TopoloSdkError, type TopoloServiceCatalogEntry, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetSnapshotMetadata, type TopoloWidgetSnapshotMetric, type TopoloWidgetType, type TopoloWidgetValidationResult, type TopoloWorkspace, type TopoloWorkspaceListResult, type TopoloWorkspaceMutationResult, type TopoloWorkspacePolicy, WorkspacesModule, actionContractCompleteness, applicationEntryFromCatalog, applicationRequirementScopes, assertTopoloServiceUrlEnvironment, auditAllApplicationRequirements, auditApplicationEntries, auditApplicationRequirements, canonicalTopoloErrorCode, canonicalTopoloRequestId, canonicalTopoloRequired, canonicalTopoloRetryAfter, compactActionCatalogEntry, compactActionPlan, compactActionPreparation, compactActionValidation, compactApplicationAudit, createTopolo, createTopoloAgentExecutionContext, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, digestTopoloActionCatalog, enrichActionContract, extractTopoloServiceErrorCode, extractTopoloServiceErrorDetails, formatDirectoryApplicationIds, friendlyAppId, listApplicationDirectory, parseTopoloActionUploadContract, prepareTopoloActionBase64UploadInput, prepareTopoloActionUploadInput, publicTopoloErrorMessage, requirementsForApplication, resolveApplicationDirectoryEntry, resolveCatalogServiceUrl, resolveServiceUrl, staticApplicationDirectory, topoloErrorHint, topoloServiceOrigins, validateTopoloActionInput, validateTopoloWidgetResponse };