pybao-xc-sdk 1.5.53 → 1.5.54

package/README.md

@@ -15,3 +15,7 @@ pybao-xc-sdk is an SDK for integrating with PYB server capabilities across Web,
 - Custom frontend console integration with PYB
 - Electron desktop applications powered by PYB
 - Middleware services orchestrating PYB capabilities
+
+## Facade Example
+
+- `client.session.create(...)`

package/dist/index.d.mts

@@ -2259,6 +2259,89 @@ interface SessionInfo {
         agent: string;
     };
 }
+interface ProviderRef {
+    providerID: string;
+    displayName: string;
+    connected: boolean;
+}
+interface ModelRef {
+    providerID: string;
+    modelID: string;
+    displayName: string;
+    capabilities: string[];
+}
+interface ProviderAuthMethod {
+    providerID: string;
+    type: 'oauth' | 'api';
+    label: string;
+    scopes: string[];
+}
+interface ProviderListResponse {
+    all: ProviderRef[];
+    default: ModelRef | null;
+    connected: string[];
+}
+interface ProviderOAuthAuthorizeRequest {
+    redirectUri?: string;
+    scope?: string;
+}
+interface ProviderOAuthAuthorizeResponse {
+    providerID: string;
+    authorizationUrl: string;
+    state: string;
+    codeChallengeMethod: 'S256';
+}
+interface ProviderOAuthCallbackRequest {
+    code: string;
+    state: string;
+}
+interface ProviderOAuthCallbackResponse {
+    providerID: string;
+    connected: boolean;
+    method: 'oauth';
+}
+interface AuthSetRequest {
+    apiKey: string;
+}
+interface AuthSetResponse {
+    providerID: string;
+    connected: boolean;
+    method: 'api';
+}
+interface AuthRemoveResponse {
+    providerID: string;
+    removed: boolean;
+}
+interface SetDefaultModelRequest {
+    providerID: string;
+    modelID: string;
+    scope?: 'global' | 'workspace';
+}
+interface SetDefaultModelResponse {
+    scope: 'global';
+    requestedScope: 'global' | 'workspace';
+    applied: boolean;
+    fallbackReason: string | null;
+    current: ModelRef;
+}
+interface ModelPoolSourceRecord {
+    pluginSpec: string;
+    pluginID: string;
+    sourceID: string;
+    sourceType: 'marketplace' | 'github' | 'npm' | 'local';
+}
+interface ModelPoolStatusItem {
+    modelPoolID: string;
+    state: 'registered' | 'active' | 'inactive';
+    pluginCount: number;
+    sourceRecords: ModelPoolSourceRecord[];
+    metadata: Record<string, string>;
+}
+interface ModelPoolStatusResponse {
+    total: number;
+    active: number;
+    pools: ModelPoolStatusItem[];
+}
 interface CreateSessionRequest {
     resumeFrom?: string;
     config?: {
@@ -2399,6 +2482,25 @@ declare class PybClient {
         get: () => Promise<unknown>;
         update: (config: Record<string, unknown>) => Promise<unknown>;
     };
+    readonly provider: {
+        list: () => Promise<ProviderListResponse>;
+        authMethods: () => Promise<ProviderAuthMethod[]>;
+        oauth: {
+            authorize: (providerID: string, request?: ProviderOAuthAuthorizeRequest) => Promise<ProviderOAuthAuthorizeResponse>;
+            callback: (providerID: string, request: ProviderOAuthCallbackRequest) => Promise<ProviderOAuthCallbackResponse>;
+        };
+    };
+    readonly model: {
+        getDefault: () => Promise<ModelRef | null>;
+        setDefault: (request: SetDefaultModelRequest) => Promise<SetDefaultModelResponse>;
+    };
+    readonly auth: {
+        set: (providerID: string, request: AuthSetRequest) => Promise<AuthSetResponse>;
+        remove: (providerID: string) => Promise<AuthRemoveResponse>;
+    };
+    readonly modelPool: {
+        status: () => Promise<ModelPoolStatusResponse>;
+    };
     constructor(config?: PybClientConfig);
     getHealth(): Promise<HealthResponse>;
     private createSessionRequest;
@@ -2418,6 +2520,15 @@ declare class PybClient {
     private executeToolRequest;
     private getConfigRequest;
     private updateConfigRequest;
+    private getProvidersRequest;
+    private getProviderAuthMethodsRequest;
+    private authorizeProviderOAuthRequest;
+    private callbackProviderOAuthRequest;
+    private getDefaultModelRequest;
+    private setDefaultModelRequest;
+    private setProviderAuthRequest;
+    private removeProviderAuthRequest;
+    private getModelPoolStatusRequest;
     private listMCPServersRequest;
     private connectMCPServerRequest;
     private disconnectMCPServerRequest;
@@ -3253,6 +3364,143 @@ declare function resolveDefaultBackendFromEnv(input?: {
     routeSource: SessionBackendRouteSource;
 };
 
+type OpenworkFieldMapping = {
+    openworkField: string;
+    pybField: string;
+};
+type OpenworkEndpointMapping = {
+    openworkEndpoint: string;
+    pybEndpoint: string;
+};
+type OpenworkErrorMapping = {
+    openworkErrorCode: string;
+    pybErrorCode: string;
+};
+type OpenworkMigrationMap = {
+    fieldMappings: OpenworkFieldMapping[];
+    endpointMappings: OpenworkEndpointMapping[];
+    errorMappings: OpenworkErrorMapping[];
+};
+type OpenworkMigrationMapV2 = OpenworkMigrationMap & {
+    version: 'v2';
+};
+type OpenworkCompatibilitySampleInput = {
+    providerID: string;
+    modelID: string;
+    apiKey: string;
+    scope?: 'global' | 'workspace';
+};
+type OpenworkProviderPickerSample = {
+    providers: Array<{
+        id: string;
+        label: string;
+        connected: boolean;
+        isDefault: boolean;
+    }>;
+};
+type OpenworkAuthModalSample = {
+    providerID: string;
+    method: 'api';
+    connected: boolean;
+};
+type OpenworkModelSetSample = {
+    scope: 'global';
+    fallbackReason: string | null;
+    current: ModelRef;
+};
+type OpenworkGoNoGoResult = {
+    decision: 'go' | 'no-go';
+    reasons: string[];
+    rollbackPlan: string[];
+};
+type OpenworkCompatibilitySampleResult = {
+    providerPicker: OpenworkProviderPickerSample;
+    authModal: OpenworkAuthModalSample;
+    modelSet: OpenworkModelSetSample;
+    modelPoolStatus: ModelPoolStatusResponse;
+    compatibilityScore: number;
+    goNoGo: OpenworkGoNoGoResult;
+};
+type ProviderFacadeEnvironment = 'internal' | 'beta' | 'production';
+type ProviderFacadeFeatureFlag = {
+    enabled: boolean;
+    environment: ProviderFacadeEnvironment;
+    workspaceAllowlist: string[];
+};
+type CompatibilityWindowPolicy = {
+    minorVersions: number;
+    deprecatedEndpoints: string[];
+};
+type ProviderFacadeReleaseState = {
+    featureFlag: ProviderFacadeFeatureFlag;
+    compatibilityWindow: CompatibilityWindowPolicy;
+};
+type ProviderFacadeRolloutInput = {
+    p0IncidentCount: number;
+    rollbackSwitchLatencyMs: number;
+    fallbackReasonDistribution: Record<string, number>;
+    authFailureRate: number;
+    compatibilityMinorVersions: number;
+};
+type ProviderFacadeRolloutResult = {
+    decision: 'go' | 'no-go';
+    reasons: string[];
+};
+type ProviderFacadeAccessInput = {
+    workspaceID: string;
+};
+type ProviderFacadeAccessResult = {
+    allowed: boolean;
+    reason?: 'feature_disabled' | 'workspace_not_allowlisted';
+};
+type ProviderFacadeDeprecationChecklist = {
+    compatibilityMinorVersions: number;
+    deprecatedEndpoints: string[];
+    readyForRetirement: boolean;
+};
+type ModelPlatformDebtSeverity = 'D0' | 'D1' | 'D2';
+type ModelPlatformDebtStatus = 'open' | 'closed';
+type ModelPlatformDebtItem = {
+    id: string;
+    title: string;
+    severity: ModelPlatformDebtSeverity;
+    owner: string;
+    batch: string;
+    status: ModelPlatformDebtStatus;
+};
+type ModelPlatformAuditEvidence = {
+    testsPassed: boolean;
+    lintPassed: boolean;
+    typecheckPassed: boolean;
+    rollbackDrillPassed: boolean;
+};
+type ModelPlatformDebtCloseoutInput = {
+    debts: ModelPlatformDebtItem[];
+    auditEvidence: ModelPlatformAuditEvidence;
+};
+type ModelPlatformDebtCloseoutSummary = {
+    openD0: number;
+    openD1: number;
+    openD2: number;
+    invalidBatchOwnershipCount: number;
+    evidenceCompleteness: number;
+};
+type ModelPlatformDebtCloseoutResult = {
+    decision: 'go' | 'no-go';
+    reasonCodes: string[];
+    summary: ModelPlatformDebtCloseoutSummary;
+    riskStatement: string;
+};
+declare function getProviderFacadeReleaseState(): ProviderFacadeReleaseState;
+declare function setProviderFacadeReleaseState(input: Partial<ProviderFacadeReleaseState>): ProviderFacadeReleaseState;
+declare function evaluateProviderFacadeRollout(input: ProviderFacadeRolloutInput): ProviderFacadeRolloutResult;
+declare function evaluateProviderFacadeAccess(input: ProviderFacadeAccessInput): ProviderFacadeAccessResult;
+declare function getProviderFacadeDeprecationChecklist(): ProviderFacadeDeprecationChecklist;
+declare function evaluateModelPlatformDebtCloseout(input: ModelPlatformDebtCloseoutInput): ModelPlatformDebtCloseoutResult;
+declare function getOpenworkMigrationMap(): OpenworkMigrationMap;
+declare function getOpenworkMigrationMapV2(): OpenworkMigrationMapV2;
+declare function runOpenworkCompatibilitySample(client: PybClient, input: OpenworkCompatibilitySampleInput): Promise<OpenworkCompatibilitySampleResult>;
+
 /**
  * @pyb/sdk - PYB-CLI Server SDK
  *
@@ -3261,4 +3509,4 @@ declare function resolveDefaultBackendFromEnv(input?: {
 
 declare const SDK_VERSION = "0.1.0";
 
-export { type APIError, type Attachment, type BackendKind, BackendKindSchema, type CanUseToolCallback, type CanUseToolDecision, type ContentBlock, ContentBlockSchema, type CreateSessionRequest, type CreateSessionResponse, DEFAULT_SESSION_BACKEND_ROUTER_CONFIG, type DualTrackMetrics, DualTrackMetricsSchema, type DualTrackRawStats, DualTrackRawStatsSchema, type DualTrackThresholds, DualTrackThresholdsSchema, type ErrorEvent, ErrorEventSchema, type ErrorStreamEvent, ErrorStreamEventSchema, FALLBACK_TRIGGER_MATRIX, type FallbackTriggerReason, FallbackTriggerReasonSchema, type HealthResponse, type Message, type MessageCompletedEvent, MessageCompletedEventSchema, type MessageCreatedEvent, MessageCreatedEventSchema, MessageSchema, type MessageUpdatedEvent, MessageUpdatedEventSchema, PROTOCOL_ERROR_TO_RUNTIME_ERROR_TYPE, type PermissionEvaluator, type PermissionMode, type PermissionRequestedEvent, PermissionRequestedEventSchema, type PermissionRespondedEvent, PermissionRespondedEventSchema, type PermissionResponseRequest, type PermissionTimeoutEvent, PermissionTimeoutEventSchema, type PromptRequest, type PromptResponse, type ProtocolErrorCode, ProtocolErrorCodeSchema, type ProtocolErrorMapping, ProtocolErrorMappingSchema, type ProtocolSessionStreamBinding, ProtocolSessionStreamBindingManager, PybClient, type PybSSEEvent, PybSSEEventSchema, type QuerySessionExecutor, type RequestCompletedEvent, RequestCompletedEventSchema, type RequestStartedEvent, RequestStartedEventSchema, type ResolvePermissionDecisionInput, type RuntimeBackendErrorPhase, type RuntimeCompatibleLegacyEvent, type RuntimeEvent, type RuntimeEventDomain, RuntimeEventDomainSchema, type RuntimeEventErrorType, RuntimeEventErrorTypeSchema, RuntimeEventSchema, type RuntimePermissionPolicy, type RuntimeSession, type RuntimeSessionConfig, type RuntimeSessionEvent, RuntimeSessionEventSchema, type RuntimeSessionInput, RuntimeSessionInputSchema, type RuntimeSessionStatus, RuntimeSessionStatusSchema, S4_PROTOCOL_ERROR_TOP_CODES, S5_A0_EQUIVALENCE_SAMPLE_SET, SDK_VERSION, SESSION_BACKEND_CONFIG_CONTRACT_VERSION, SESSION_BACKEND_ENV_KEY, SESSION_BACKEND_OBSERVABILITY_SPEC, SSEClient, type SSEDedupEvent, SSEDedupEventSchema, type SSEEvent, type SSEReplayEvent, SSEReplayEventSchema, type SSEReplayGapEvent, SSEReplayGapEventSchema, type ServerConnectedEvent, ServerConnectedEventSchema, type ServerHeartbeatEvent, ServerHeartbeatEventSchema, type ServerStatusEvent, ServerStatusEventSchema, type SessionBackend, type SessionBackendRouteSource, type SessionBackendRouterConfig, SessionBackendRouterConfigSchema, type SessionBackendSession, type SessionBackendUserConfig, type SessionCreatedEvent, SessionCreatedEventSchema, type SessionDeletedEvent, SessionDeletedEventSchema, type SessionEventPublisher, type SessionInfo, type SessionUpdatedEvent, SessionUpdatedEventSchema, type ToolCompletedEvent, ToolCompletedEventSchema, type ToolErrorEvent, ToolErrorEventSchema, type ToolInfo, type ToolPermissionContext, type ToolProgressEvent, ToolProgressEventSchema, type ToolResolver, type ToolStartedEvent, ToolStartedEventSchema, type V2Message, V2MessageSchema, V2RequestStatusSchema, type V2Session, V2SessionSchema, type V2SessionStatus, V2SessionStatusSchema, type V2ToolUseContext, V2ToolUseContextSchema, buildDefaultDualTrackThresholds, buildV2ToolUseContextFromPromptRequest, canTransitionV2SessionStatus, createDefaultToolPermissionContextForSdk, createProtocolSessionBackend, createRuntimePermissionContextForSession, createRuntimeSession, createRuntimeSessionBackend, createSSEClient, createSessionBackendRouter, emitBackendConfigWarning, evaluateDualTrackMetrics, evaluateV1DeprecationReadiness, getRuntimeEventMappingRules, isToolAutoExecutableInContext, mapProtocolErrorCodeToRuntimeErrorType, mapRuntimeBackendErrorToRuntimeEvent, mapRuntimeMessageToV2, mapRuntimeSessionStatusToV2, mapV1MessageToV2, mapV1SessionStatusToV2, projectLegacyEventToRuntimeEvent, projectRuntimeEventToLegacyEvent, resolveDefaultBackend, resolveDefaultBackendFromEnv, resolvePermissionDecision, resolvePermissionModeForSdk, resolveRouterBackendKind, shouldTriggerFallback, validateV2Message, validateV2Session, validateV2ToolUseContext };
+export { type APIError, type Attachment, type AuthRemoveResponse, type AuthSetRequest, type AuthSetResponse, type BackendKind, BackendKindSchema, type CanUseToolCallback, type CanUseToolDecision, type CompatibilityWindowPolicy, type ContentBlock, ContentBlockSchema, type CreateSessionRequest, type CreateSessionResponse, DEFAULT_SESSION_BACKEND_ROUTER_CONFIG, type DualTrackMetrics, DualTrackMetricsSchema, type DualTrackRawStats, DualTrackRawStatsSchema, type DualTrackThresholds, DualTrackThresholdsSchema, type ErrorEvent, ErrorEventSchema, type ErrorStreamEvent, ErrorStreamEventSchema, FALLBACK_TRIGGER_MATRIX, type FallbackTriggerReason, FallbackTriggerReasonSchema, type HealthResponse, type Message, type MessageCompletedEvent, MessageCompletedEventSchema, type MessageCreatedEvent, MessageCreatedEventSchema, MessageSchema, type MessageUpdatedEvent, MessageUpdatedEventSchema, type ModelPlatformAuditEvidence, type ModelPlatformDebtCloseoutInput, type ModelPlatformDebtCloseoutResult, type ModelPlatformDebtCloseoutSummary, type ModelPlatformDebtItem, type ModelPlatformDebtSeverity, type ModelPlatformDebtStatus, type ModelPoolSourceRecord, type ModelPoolStatusItem, type ModelPoolStatusResponse, type ModelRef, type OpenworkAuthModalSample, type OpenworkCompatibilitySampleInput, type OpenworkCompatibilitySampleResult, type OpenworkEndpointMapping, type OpenworkErrorMapping, type OpenworkFieldMapping, type OpenworkGoNoGoResult, type OpenworkMigrationMap, type OpenworkMigrationMapV2, type OpenworkModelSetSample, type OpenworkProviderPickerSample, PROTOCOL_ERROR_TO_RUNTIME_ERROR_TYPE, type PermissionEvaluator, type PermissionMode, type PermissionRequestedEvent, PermissionRequestedEventSchema, type PermissionRespondedEvent, PermissionRespondedEventSchema, type PermissionResponseRequest, type PermissionTimeoutEvent, PermissionTimeoutEventSchema, type PromptRequest, type PromptResponse, type ProtocolErrorCode, ProtocolErrorCodeSchema, type ProtocolErrorMapping, ProtocolErrorMappingSchema, type ProtocolSessionStreamBinding, ProtocolSessionStreamBindingManager, type ProviderAuthMethod, type ProviderFacadeAccessInput, type ProviderFacadeAccessResult, type ProviderFacadeDeprecationChecklist, type ProviderFacadeEnvironment, type ProviderFacadeFeatureFlag, type ProviderFacadeReleaseState, type ProviderFacadeRolloutInput, type ProviderFacadeRolloutResult, type ProviderListResponse, type ProviderOAuthAuthorizeRequest, type ProviderOAuthAuthorizeResponse, type ProviderOAuthCallbackRequest, type ProviderOAuthCallbackResponse, type ProviderRef, PybClient, type PybSSEEvent, PybSSEEventSchema, type QuerySessionExecutor, type RequestCompletedEvent, RequestCompletedEventSchema, type RequestStartedEvent, RequestStartedEventSchema, type ResolvePermissionDecisionInput, type RuntimeBackendErrorPhase, type RuntimeCompatibleLegacyEvent, type RuntimeEvent, type RuntimeEventDomain, RuntimeEventDomainSchema, type RuntimeEventErrorType, RuntimeEventErrorTypeSchema, RuntimeEventSchema, type RuntimePermissionPolicy, type RuntimeSession, type RuntimeSessionConfig, type RuntimeSessionEvent, RuntimeSessionEventSchema, type RuntimeSessionInput, RuntimeSessionInputSchema, type RuntimeSessionStatus, RuntimeSessionStatusSchema, S4_PROTOCOL_ERROR_TOP_CODES, S5_A0_EQUIVALENCE_SAMPLE_SET, SDK_VERSION, SESSION_BACKEND_CONFIG_CONTRACT_VERSION, SESSION_BACKEND_ENV_KEY, SESSION_BACKEND_OBSERVABILITY_SPEC, SSEClient, type SSEDedupEvent, SSEDedupEventSchema, type SSEEvent, type SSEReplayEvent, SSEReplayEventSchema, type SSEReplayGapEvent, SSEReplayGapEventSchema, type ServerConnectedEvent, ServerConnectedEventSchema, type ServerHeartbeatEvent, ServerHeartbeatEventSchema, type ServerStatusEvent, ServerStatusEventSchema, type SessionBackend, type SessionBackendRouteSource, type SessionBackendRouterConfig, SessionBackendRouterConfigSchema, type SessionBackendSession, type SessionBackendUserConfig, type SessionCreatedEvent, SessionCreatedEventSchema, type SessionDeletedEvent, SessionDeletedEventSchema, type SessionEventPublisher, type SessionInfo, type SessionUpdatedEvent, SessionUpdatedEventSchema, type SetDefaultModelRequest, type SetDefaultModelResponse, type ToolCompletedEvent, ToolCompletedEventSchema, type ToolErrorEvent, ToolErrorEventSchema, type ToolInfo, type ToolPermissionContext, type ToolProgressEvent, ToolProgressEventSchema, type ToolResolver, type ToolStartedEvent, ToolStartedEventSchema, type V2Message, V2MessageSchema, V2RequestStatusSchema, type V2Session, V2SessionSchema, type V2SessionStatus, V2SessionStatusSchema, type V2ToolUseContext, V2ToolUseContextSchema, buildDefaultDualTrackThresholds, buildV2ToolUseContextFromPromptRequest, canTransitionV2SessionStatus, createDefaultToolPermissionContextForSdk, createProtocolSessionBackend, createRuntimePermissionContextForSession, createRuntimeSession, createRuntimeSessionBackend, createSSEClient, createSessionBackendRouter, emitBackendConfigWarning, evaluateDualTrackMetrics, evaluateModelPlatformDebtCloseout, evaluateProviderFacadeAccess, evaluateProviderFacadeRollout, evaluateV1DeprecationReadiness, getOpenworkMigrationMap, getOpenworkMigrationMapV2, getProviderFacadeDeprecationChecklist, getProviderFacadeReleaseState, getRuntimeEventMappingRules, isToolAutoExecutableInContext, mapProtocolErrorCodeToRuntimeErrorType, mapRuntimeBackendErrorToRuntimeEvent, mapRuntimeMessageToV2, mapRuntimeSessionStatusToV2, mapV1MessageToV2, mapV1SessionStatusToV2, projectLegacyEventToRuntimeEvent, projectRuntimeEventToLegacyEvent, resolveDefaultBackend, resolveDefaultBackendFromEnv, resolvePermissionDecision, resolvePermissionModeForSdk, resolveRouterBackendKind, runOpenworkCompatibilitySample, setProviderFacadeReleaseState, shouldTriggerFallback, validateV2Message, validateV2Session, validateV2ToolUseContext };

package/dist/index.d.ts

@@ -2259,6 +2259,89 @@ interface SessionInfo {
         agent: string;
     };
 }
+interface ProviderRef {
+    providerID: string;
+    displayName: string;
+    connected: boolean;
+}
+interface ModelRef {
+    providerID: string;
+    modelID: string;
+    displayName: string;
+    capabilities: string[];
+}
+interface ProviderAuthMethod {
+    providerID: string;
+    type: 'oauth' | 'api';
+    label: string;
+    scopes: string[];
+}
+interface ProviderListResponse {
+    all: ProviderRef[];
+    default: ModelRef | null;
+    connected: string[];
+}
+interface ProviderOAuthAuthorizeRequest {
+    redirectUri?: string;
+    scope?: string;
+}
+interface ProviderOAuthAuthorizeResponse {
+    providerID: string;
+    authorizationUrl: string;
+    state: string;
+    codeChallengeMethod: 'S256';
+}
+interface ProviderOAuthCallbackRequest {
+    code: string;
+    state: string;
+}
+interface ProviderOAuthCallbackResponse {
+    providerID: string;
+    connected: boolean;
+    method: 'oauth';
+}
+interface AuthSetRequest {
+    apiKey: string;
+}
+interface AuthSetResponse {
+    providerID: string;
+    connected: boolean;
+    method: 'api';
+}
+interface AuthRemoveResponse {
+    providerID: string;
+    removed: boolean;
+}
+interface SetDefaultModelRequest {
+    providerID: string;
+    modelID: string;
+    scope?: 'global' | 'workspace';
+}
+interface SetDefaultModelResponse {
+    scope: 'global';
+    requestedScope: 'global' | 'workspace';
+    applied: boolean;
+    fallbackReason: string | null;
+    current: ModelRef;
+}
+interface ModelPoolSourceRecord {
+    pluginSpec: string;
+    pluginID: string;
+    sourceID: string;
+    sourceType: 'marketplace' | 'github' | 'npm' | 'local';
+}
+interface ModelPoolStatusItem {
+    modelPoolID: string;
+    state: 'registered' | 'active' | 'inactive';
+    pluginCount: number;
+    sourceRecords: ModelPoolSourceRecord[];
+    metadata: Record<string, string>;
+}
+interface ModelPoolStatusResponse {
+    total: number;
+    active: number;
+    pools: ModelPoolStatusItem[];
+}
 interface CreateSessionRequest {
     resumeFrom?: string;
     config?: {
@@ -2399,6 +2482,25 @@ declare class PybClient {
         get: () => Promise<unknown>;
         update: (config: Record<string, unknown>) => Promise<unknown>;
     };
+    readonly provider: {
+        list: () => Promise<ProviderListResponse>;
+        authMethods: () => Promise<ProviderAuthMethod[]>;
+        oauth: {
+            authorize: (providerID: string, request?: ProviderOAuthAuthorizeRequest) => Promise<ProviderOAuthAuthorizeResponse>;
+            callback: (providerID: string, request: ProviderOAuthCallbackRequest) => Promise<ProviderOAuthCallbackResponse>;
+        };
+    };
+    readonly model: {
+        getDefault: () => Promise<ModelRef | null>;
+        setDefault: (request: SetDefaultModelRequest) => Promise<SetDefaultModelResponse>;
+    };
+    readonly auth: {
+        set: (providerID: string, request: AuthSetRequest) => Promise<AuthSetResponse>;
+        remove: (providerID: string) => Promise<AuthRemoveResponse>;
+    };
+    readonly modelPool: {
+        status: () => Promise<ModelPoolStatusResponse>;
+    };
     constructor(config?: PybClientConfig);
     getHealth(): Promise<HealthResponse>;
     private createSessionRequest;
@@ -2418,6 +2520,15 @@ declare class PybClient {
     private executeToolRequest;
     private getConfigRequest;
     private updateConfigRequest;
+    private getProvidersRequest;
+    private getProviderAuthMethodsRequest;
+    private authorizeProviderOAuthRequest;
+    private callbackProviderOAuthRequest;
+    private getDefaultModelRequest;
+    private setDefaultModelRequest;
+    private setProviderAuthRequest;
+    private removeProviderAuthRequest;
+    private getModelPoolStatusRequest;
     private listMCPServersRequest;
     private connectMCPServerRequest;
     private disconnectMCPServerRequest;
@@ -3253,6 +3364,143 @@ declare function resolveDefaultBackendFromEnv(input?: {
     routeSource: SessionBackendRouteSource;
 };
 
+type OpenworkFieldMapping = {
+    openworkField: string;
+    pybField: string;
+};
+type OpenworkEndpointMapping = {
+    openworkEndpoint: string;
+    pybEndpoint: string;
+};
+type OpenworkErrorMapping = {
+    openworkErrorCode: string;
+    pybErrorCode: string;
+};
+type OpenworkMigrationMap = {
+    fieldMappings: OpenworkFieldMapping[];
+    endpointMappings: OpenworkEndpointMapping[];
+    errorMappings: OpenworkErrorMapping[];
+};
+type OpenworkMigrationMapV2 = OpenworkMigrationMap & {
+    version: 'v2';
+};
+type OpenworkCompatibilitySampleInput = {
+    providerID: string;
+    modelID: string;
+    apiKey: string;
+    scope?: 'global' | 'workspace';
+};
+type OpenworkProviderPickerSample = {
+    providers: Array<{
+        id: string;
+        label: string;
+        connected: boolean;
+        isDefault: boolean;
+    }>;
+};
+type OpenworkAuthModalSample = {
+    providerID: string;
+    method: 'api';
+    connected: boolean;
+};
+type OpenworkModelSetSample = {
+    scope: 'global';
+    fallbackReason: string | null;
+    current: ModelRef;
+};
+type OpenworkGoNoGoResult = {
+    decision: 'go' | 'no-go';
+    reasons: string[];
+    rollbackPlan: string[];
+};
+type OpenworkCompatibilitySampleResult = {
+    providerPicker: OpenworkProviderPickerSample;
+    authModal: OpenworkAuthModalSample;
+    modelSet: OpenworkModelSetSample;
+    modelPoolStatus: ModelPoolStatusResponse;
+    compatibilityScore: number;
+    goNoGo: OpenworkGoNoGoResult;
+};
+type ProviderFacadeEnvironment = 'internal' | 'beta' | 'production';
+type ProviderFacadeFeatureFlag = {
+    enabled: boolean;
+    environment: ProviderFacadeEnvironment;
+    workspaceAllowlist: string[];
+};
+type CompatibilityWindowPolicy = {
+    minorVersions: number;
+    deprecatedEndpoints: string[];
+};
+type ProviderFacadeReleaseState = {
+    featureFlag: ProviderFacadeFeatureFlag;
+    compatibilityWindow: CompatibilityWindowPolicy;
+};
+type ProviderFacadeRolloutInput = {
+    p0IncidentCount: number;
+    rollbackSwitchLatencyMs: number;
+    fallbackReasonDistribution: Record<string, number>;
+    authFailureRate: number;
+    compatibilityMinorVersions: number;
+};
+type ProviderFacadeRolloutResult = {
+    decision: 'go' | 'no-go';
+    reasons: string[];
+};
+type ProviderFacadeAccessInput = {
+    workspaceID: string;
+};
+type ProviderFacadeAccessResult = {
+    allowed: boolean;
+    reason?: 'feature_disabled' | 'workspace_not_allowlisted';
+};
+type ProviderFacadeDeprecationChecklist = {
+    compatibilityMinorVersions: number;
+    deprecatedEndpoints: string[];
+    readyForRetirement: boolean;
+};
+type ModelPlatformDebtSeverity = 'D0' | 'D1' | 'D2';
+type ModelPlatformDebtStatus = 'open' | 'closed';
+type ModelPlatformDebtItem = {
+    id: string;
+    title: string;
+    severity: ModelPlatformDebtSeverity;
+    owner: string;
+    batch: string;
+    status: ModelPlatformDebtStatus;
+};
+type ModelPlatformAuditEvidence = {
+    testsPassed: boolean;
+    lintPassed: boolean;
+    typecheckPassed: boolean;
+    rollbackDrillPassed: boolean;
+};
+type ModelPlatformDebtCloseoutInput = {
+    debts: ModelPlatformDebtItem[];
+    auditEvidence: ModelPlatformAuditEvidence;
+};
+type ModelPlatformDebtCloseoutSummary = {
+    openD0: number;
+    openD1: number;
+    openD2: number;
+    invalidBatchOwnershipCount: number;
+    evidenceCompleteness: number;
+};
+type ModelPlatformDebtCloseoutResult = {
+    decision: 'go' | 'no-go';
+    reasonCodes: string[];
+    summary: ModelPlatformDebtCloseoutSummary;
+    riskStatement: string;
+};
+declare function getProviderFacadeReleaseState(): ProviderFacadeReleaseState;
+declare function setProviderFacadeReleaseState(input: Partial<ProviderFacadeReleaseState>): ProviderFacadeReleaseState;
+declare function evaluateProviderFacadeRollout(input: ProviderFacadeRolloutInput): ProviderFacadeRolloutResult;
+declare function evaluateProviderFacadeAccess(input: ProviderFacadeAccessInput): ProviderFacadeAccessResult;
+declare function getProviderFacadeDeprecationChecklist(): ProviderFacadeDeprecationChecklist;
+declare function evaluateModelPlatformDebtCloseout(input: ModelPlatformDebtCloseoutInput): ModelPlatformDebtCloseoutResult;
+declare function getOpenworkMigrationMap(): OpenworkMigrationMap;
+declare function getOpenworkMigrationMapV2(): OpenworkMigrationMapV2;
+declare function runOpenworkCompatibilitySample(client: PybClient, input: OpenworkCompatibilitySampleInput): Promise<OpenworkCompatibilitySampleResult>;
+
 /**
  * @pyb/sdk - PYB-CLI Server SDK
  *
@@ -3261,4 +3509,4 @@ declare function resolveDefaultBackendFromEnv(input?: {
 
 declare const SDK_VERSION = "0.1.0";
 
-export { type APIError, type Attachment, type BackendKind, BackendKindSchema, type CanUseToolCallback, type CanUseToolDecision, type ContentBlock, ContentBlockSchema, type CreateSessionRequest, type CreateSessionResponse, DEFAULT_SESSION_BACKEND_ROUTER_CONFIG, type DualTrackMetrics, DualTrackMetricsSchema, type DualTrackRawStats, DualTrackRawStatsSchema, type DualTrackThresholds, DualTrackThresholdsSchema, type ErrorEvent, ErrorEventSchema, type ErrorStreamEvent, ErrorStreamEventSchema, FALLBACK_TRIGGER_MATRIX, type FallbackTriggerReason, FallbackTriggerReasonSchema, type HealthResponse, type Message, type MessageCompletedEvent, MessageCompletedEventSchema, type MessageCreatedEvent, MessageCreatedEventSchema, MessageSchema, type MessageUpdatedEvent, MessageUpdatedEventSchema, PROTOCOL_ERROR_TO_RUNTIME_ERROR_TYPE, type PermissionEvaluator, type PermissionMode, type PermissionRequestedEvent, PermissionRequestedEventSchema, type PermissionRespondedEvent, PermissionRespondedEventSchema, type PermissionResponseRequest, type PermissionTimeoutEvent, PermissionTimeoutEventSchema, type PromptRequest, type PromptResponse, type ProtocolErrorCode, ProtocolErrorCodeSchema, type ProtocolErrorMapping, ProtocolErrorMappingSchema, type ProtocolSessionStreamBinding, ProtocolSessionStreamBindingManager, PybClient, type PybSSEEvent, PybSSEEventSchema, type QuerySessionExecutor, type RequestCompletedEvent, RequestCompletedEventSchema, type RequestStartedEvent, RequestStartedEventSchema, type ResolvePermissionDecisionInput, type RuntimeBackendErrorPhase, type RuntimeCompatibleLegacyEvent, type RuntimeEvent, type RuntimeEventDomain, RuntimeEventDomainSchema, type RuntimeEventErrorType, RuntimeEventErrorTypeSchema, RuntimeEventSchema, type RuntimePermissionPolicy, type RuntimeSession, type RuntimeSessionConfig, type RuntimeSessionEvent, RuntimeSessionEventSchema, type RuntimeSessionInput, RuntimeSessionInputSchema, type RuntimeSessionStatus, RuntimeSessionStatusSchema, S4_PROTOCOL_ERROR_TOP_CODES, S5_A0_EQUIVALENCE_SAMPLE_SET, SDK_VERSION, SESSION_BACKEND_CONFIG_CONTRACT_VERSION, SESSION_BACKEND_ENV_KEY, SESSION_BACKEND_OBSERVABILITY_SPEC, SSEClient, type SSEDedupEvent, SSEDedupEventSchema, type SSEEvent, type SSEReplayEvent, SSEReplayEventSchema, type SSEReplayGapEvent, SSEReplayGapEventSchema, type ServerConnectedEvent, ServerConnectedEventSchema, type ServerHeartbeatEvent, ServerHeartbeatEventSchema, type ServerStatusEvent, ServerStatusEventSchema, type SessionBackend, type SessionBackendRouteSource, type SessionBackendRouterConfig, SessionBackendRouterConfigSchema, type SessionBackendSession, type SessionBackendUserConfig, type SessionCreatedEvent, SessionCreatedEventSchema, type SessionDeletedEvent, SessionDeletedEventSchema, type SessionEventPublisher, type SessionInfo, type SessionUpdatedEvent, SessionUpdatedEventSchema, type ToolCompletedEvent, ToolCompletedEventSchema, type ToolErrorEvent, ToolErrorEventSchema, type ToolInfo, type ToolPermissionContext, type ToolProgressEvent, ToolProgressEventSchema, type ToolResolver, type ToolStartedEvent, ToolStartedEventSchema, type V2Message, V2MessageSchema, V2RequestStatusSchema, type V2Session, V2SessionSchema, type V2SessionStatus, V2SessionStatusSchema, type V2ToolUseContext, V2ToolUseContextSchema, buildDefaultDualTrackThresholds, buildV2ToolUseContextFromPromptRequest, canTransitionV2SessionStatus, createDefaultToolPermissionContextForSdk, createProtocolSessionBackend, createRuntimePermissionContextForSession, createRuntimeSession, createRuntimeSessionBackend, createSSEClient, createSessionBackendRouter, emitBackendConfigWarning, evaluateDualTrackMetrics, evaluateV1DeprecationReadiness, getRuntimeEventMappingRules, isToolAutoExecutableInContext, mapProtocolErrorCodeToRuntimeErrorType, mapRuntimeBackendErrorToRuntimeEvent, mapRuntimeMessageToV2, mapRuntimeSessionStatusToV2, mapV1MessageToV2, mapV1SessionStatusToV2, projectLegacyEventToRuntimeEvent, projectRuntimeEventToLegacyEvent, resolveDefaultBackend, resolveDefaultBackendFromEnv, resolvePermissionDecision, resolvePermissionModeForSdk, resolveRouterBackendKind, shouldTriggerFallback, validateV2Message, validateV2Session, validateV2ToolUseContext };
+export { type APIError, type Attachment, type AuthRemoveResponse, type AuthSetRequest, type AuthSetResponse, type BackendKind, BackendKindSchema, type CanUseToolCallback, type CanUseToolDecision, type CompatibilityWindowPolicy, type ContentBlock, ContentBlockSchema, type CreateSessionRequest, type CreateSessionResponse, DEFAULT_SESSION_BACKEND_ROUTER_CONFIG, type DualTrackMetrics, DualTrackMetricsSchema, type DualTrackRawStats, DualTrackRawStatsSchema, type DualTrackThresholds, DualTrackThresholdsSchema, type ErrorEvent, ErrorEventSchema, type ErrorStreamEvent, ErrorStreamEventSchema, FALLBACK_TRIGGER_MATRIX, type FallbackTriggerReason, FallbackTriggerReasonSchema, type HealthResponse, type Message, type MessageCompletedEvent, MessageCompletedEventSchema, type MessageCreatedEvent, MessageCreatedEventSchema, MessageSchema, type MessageUpdatedEvent, MessageUpdatedEventSchema, type ModelPlatformAuditEvidence, type ModelPlatformDebtCloseoutInput, type ModelPlatformDebtCloseoutResult, type ModelPlatformDebtCloseoutSummary, type ModelPlatformDebtItem, type ModelPlatformDebtSeverity, type ModelPlatformDebtStatus, type ModelPoolSourceRecord, type ModelPoolStatusItem, type ModelPoolStatusResponse, type ModelRef, type OpenworkAuthModalSample, type OpenworkCompatibilitySampleInput, type OpenworkCompatibilitySampleResult, type OpenworkEndpointMapping, type OpenworkErrorMapping, type OpenworkFieldMapping, type OpenworkGoNoGoResult, type OpenworkMigrationMap, type OpenworkMigrationMapV2, type OpenworkModelSetSample, type OpenworkProviderPickerSample, PROTOCOL_ERROR_TO_RUNTIME_ERROR_TYPE, type PermissionEvaluator, type PermissionMode, type PermissionRequestedEvent, PermissionRequestedEventSchema, type PermissionRespondedEvent, PermissionRespondedEventSchema, type PermissionResponseRequest, type PermissionTimeoutEvent, PermissionTimeoutEventSchema, type PromptRequest, type PromptResponse, type ProtocolErrorCode, ProtocolErrorCodeSchema, type ProtocolErrorMapping, ProtocolErrorMappingSchema, type ProtocolSessionStreamBinding, ProtocolSessionStreamBindingManager, type ProviderAuthMethod, type ProviderFacadeAccessInput, type ProviderFacadeAccessResult, type ProviderFacadeDeprecationChecklist, type ProviderFacadeEnvironment, type ProviderFacadeFeatureFlag, type ProviderFacadeReleaseState, type ProviderFacadeRolloutInput, type ProviderFacadeRolloutResult, type ProviderListResponse, type ProviderOAuthAuthorizeRequest, type ProviderOAuthAuthorizeResponse, type ProviderOAuthCallbackRequest, type ProviderOAuthCallbackResponse, type ProviderRef, PybClient, type PybSSEEvent, PybSSEEventSchema, type QuerySessionExecutor, type RequestCompletedEvent, RequestCompletedEventSchema, type RequestStartedEvent, RequestStartedEventSchema, type ResolvePermissionDecisionInput, type RuntimeBackendErrorPhase, type RuntimeCompatibleLegacyEvent, type RuntimeEvent, type RuntimeEventDomain, RuntimeEventDomainSchema, type RuntimeEventErrorType, RuntimeEventErrorTypeSchema, RuntimeEventSchema, type RuntimePermissionPolicy, type RuntimeSession, type RuntimeSessionConfig, type RuntimeSessionEvent, RuntimeSessionEventSchema, type RuntimeSessionInput, RuntimeSessionInputSchema, type RuntimeSessionStatus, RuntimeSessionStatusSchema, S4_PROTOCOL_ERROR_TOP_CODES, S5_A0_EQUIVALENCE_SAMPLE_SET, SDK_VERSION, SESSION_BACKEND_CONFIG_CONTRACT_VERSION, SESSION_BACKEND_ENV_KEY, SESSION_BACKEND_OBSERVABILITY_SPEC, SSEClient, type SSEDedupEvent, SSEDedupEventSchema, type SSEEvent, type SSEReplayEvent, SSEReplayEventSchema, type SSEReplayGapEvent, SSEReplayGapEventSchema, type ServerConnectedEvent, ServerConnectedEventSchema, type ServerHeartbeatEvent, ServerHeartbeatEventSchema, type ServerStatusEvent, ServerStatusEventSchema, type SessionBackend, type SessionBackendRouteSource, type SessionBackendRouterConfig, SessionBackendRouterConfigSchema, type SessionBackendSession, type SessionBackendUserConfig, type SessionCreatedEvent, SessionCreatedEventSchema, type SessionDeletedEvent, SessionDeletedEventSchema, type SessionEventPublisher, type SessionInfo, type SessionUpdatedEvent, SessionUpdatedEventSchema, type SetDefaultModelRequest, type SetDefaultModelResponse, type ToolCompletedEvent, ToolCompletedEventSchema, type ToolErrorEvent, ToolErrorEventSchema, type ToolInfo, type ToolPermissionContext, type ToolProgressEvent, ToolProgressEventSchema, type ToolResolver, type ToolStartedEvent, ToolStartedEventSchema, type V2Message, V2MessageSchema, V2RequestStatusSchema, type V2Session, V2SessionSchema, type V2SessionStatus, V2SessionStatusSchema, type V2ToolUseContext, V2ToolUseContextSchema, buildDefaultDualTrackThresholds, buildV2ToolUseContextFromPromptRequest, canTransitionV2SessionStatus, createDefaultToolPermissionContextForSdk, createProtocolSessionBackend, createRuntimePermissionContextForSession, createRuntimeSession, createRuntimeSessionBackend, createSSEClient, createSessionBackendRouter, emitBackendConfigWarning, evaluateDualTrackMetrics, evaluateModelPlatformDebtCloseout, evaluateProviderFacadeAccess, evaluateProviderFacadeRollout, evaluateV1DeprecationReadiness, getOpenworkMigrationMap, getOpenworkMigrationMapV2, getProviderFacadeDeprecationChecklist, getProviderFacadeReleaseState, getRuntimeEventMappingRules, isToolAutoExecutableInContext, mapProtocolErrorCodeToRuntimeErrorType, mapRuntimeBackendErrorToRuntimeEvent, mapRuntimeMessageToV2, mapRuntimeSessionStatusToV2, mapV1MessageToV2, mapV1SessionStatusToV2, projectLegacyEventToRuntimeEvent, projectRuntimeEventToLegacyEvent, resolveDefaultBackend, resolveDefaultBackendFromEnv, resolvePermissionDecision, resolvePermissionModeForSdk, resolveRouterBackendKind, runOpenworkCompatibilitySample, setProviderFacadeReleaseState, shouldTriggerFallback, validateV2Message, validateV2Session, validateV2ToolUseContext };