@stacklink/sdk 0.2.0 → 0.3.7

package/dist/src/sdk/index.d.ts

@@ -1,19 +1,18 @@
-import { type StacklinkMetaToolName, type StacklinkMetaToolSurface } from '../domain/stacklink-meta-tools.js';
-import type { KnowledgeMetaToolName } from '../domain/knowledge-meta-tools.js';
-import { type PlatformMcpToolName } from '../domain/platform-mcp-tools.js';
+import type { Bot, BotPatch, BotRun, BotRunInput, PublishChannels, SavedBotApi, ContextApi, BotApiSigningKey, BotApiSigningKeyRequest } from '../domain/bot-contract.js';
+import type { ApprovalRecord, ApprovalDecision, ApprovalChange, ApprovalListResponse, ApprovalListQuery, CustomerApprovalGrantInput, CustomerApprovalGrantResponse } from '../domain/platform-approval-contract.js';
+export type { ApprovalRecord, ApprovalDecision, ApprovalChange, ApprovalListResponse, ApprovalAudience, ApprovalRequirement, CustomerApprovalGrantInput, CustomerApprovalGrantResponse } from '../domain/platform-approval-contract.js';
+export type { Bot, BotPatch, BotRun, BotRunInput, PublishChannels, SavedBotApi, ContextApi, BotApiSigningKey, BotApiSigningKeyRequest, BotTrigger, BotPreparation, BotRunDisplay, BotReadinessIssue } from '../domain/bot-contract.js';
+import { type StacklinkMetaToolName } from '../domain/stacklink-meta-tools.js';
 import type { ProviderBrandDescriptor } from '../domain/provider-branding.js';
-import type { MemoryMetaToolName } from '../domain/memory-meta-tools.js';
-import type { MemoryContextInput, MemoryConversationTurnInput, MemoryConnectedSourceInput, MemoryConnectedSourcePreviewInput, MemoryExportInput, MemoryGraphQueryInput, MemoryIngestInput, MemoryRichIngestInput, MemoryLegalHoldInput, MemoryPolicyPreviewInput, MemoryProjectPolicyInput, MemoryProjectPolicyUpdateInput, MemorySearchInput, MemorySourceBindingInput, MemorySourceBindingUpdateInput, MemorySubjectRef } from '../domain/memory-contract.js';
+import type { MemoryContextInput, MemoryConversationTurnInput, MemoryConnectedSourceInput, MemoryConnectedSourcePreviewInput, MemoryExportInput, MemoryGraphQueryInput, MemoryIngestInput, MemoryRichIngestInput, MemoryLegalHoldInput, MemoryPolicyPreviewInput, MemoryProjectPolicyInput, MemoryProjectPolicyUpdateInput, MemorySearchInput, MemorySourceBindingInput, MemorySourceBindingUpdateInput, MemorySourceRemovalInput, MemorySubjectRef } from '../domain/memory-contract.js';
 export type { ProviderBrandDescriptor };
-export type { MemoryContextInput, MemoryConversationTurnInput, MemoryConnectedSourceInput, MemoryConnectedSourcePreviewInput, MemoryExportInput, MemoryGraphQueryInput, MemoryIngestInput, MemoryRichIngestInput, MemoryLegalHoldInput, MemoryPolicyPreviewInput, MemoryProjectPolicyInput, MemoryProjectPolicyUpdateInput, MemorySearchInput, MemorySourceBindingInput, MemorySourceBindingUpdateInput, MemorySubjectRef, };
+export type { MemoryContextInput, MemoryConversationTurnInput, MemoryConnectedSourceInput, MemoryConnectedSourcePreviewInput, MemoryExportInput, MemoryGraphQueryInput, MemoryIngestInput, MemoryRichIngestInput, MemoryLegalHoldInput, MemoryPolicyPreviewInput, MemoryProjectPolicyInput, MemoryProjectPolicyUpdateInput, MemorySearchInput, MemorySourceBindingInput, MemorySourceBindingUpdateInput, MemorySourceRemovalInput, MemorySubjectRef, };
 export { StacklinkMemoryLifecycle, StacklinkMemoryLifecycleError, createStacklinkMemoryLifecycle, serializeCompletedConversationTurn, } from './memory-lifecycle.js';
-export type { StacklinkMemoryAvailabilityMode, StacklinkMemoryCaptureMode, StacklinkMemoryDiagnostic, StacklinkMemoryLifecycleOptions, StacklinkMemorySessionLike, StacklinkMemoryTurnContext, StacklinkMemoryTurnOptions, } from './memory-lifecycle.js';
-export declare const platformToolSurfaceNames: readonly ["PLATFORM_LIST_AUTH_CONFIGS", "PLATFORM_LIST_SESSIONS", "PLATFORM_UPDATE_WORKBENCH_PROVIDER_ACCESS", "PLATFORM_LIST_WORKSPACES", "PLATFORM_LIST_MEMBERS", "PLATFORM_LIST_WORKBENCH_BUDGETS", "PLATFORM_QUERY_LOGS", "PLATFORM_GET_EXECUTION_DETAILS", "PLATFORM_ENABLE_TOOLKIT", "PLATFORM_CREATE_TRIGGER", "PLATFORM_GET_WEBHOOK", "PLATFORM_UPDATE_WEBHOOK", "PLATFORM_ROTATE_WEBHOOK_SECRET", "PLATFORM_APPROVE_WEBHOOK_SECRET_ROTATION", "PLATFORM_SEND_WEBHOOK_TEST", "PLATFORM_PROPOSE_AUTH_CONFIG", "PLATFORM_APPROVE_AUTH_CONFIG", "PLATFORM_PROPOSE_API_KEY", "PLATFORM_APPROVE_API_KEY", "PLATFORM_REVOKE_API_KEY", "PLATFORM_PROPOSE_WORKSPACE_MUTATION", "PLATFORM_APPROVE_WORKSPACE_MUTATION", "PLATFORM_PROPOSE_WORKBENCH_BUDGET", "PLATFORM_APPROVE_WORKBENCH_BUDGET", "PLATFORM_APPROVE_EXECUTION", "PLATFORM_DENY_APPROVAL", "PLATFORM_CANCEL_APPROVAL"];
-export type PlatformToolSurfaceName = PlatformMcpToolName;
+export type { StacklinkMemoryAvailabilityMode, StacklinkMemoryCaptureController, StacklinkMemoryCaptureIssue, StacklinkMemoryCaptureMode, StacklinkMemoryDiagnostic, StacklinkMemoryLifecycleOptions, StacklinkMemorySessionLike, StacklinkMemoryTurnContext, StacklinkMemoryTurnOptions, } from './memory-lifecycle.js';
 export type StacklinkFetch = typeof fetch;
-export type StacklinkMcpToolName = StacklinkMetaToolName | PlatformMcpToolName | KnowledgeMetaToolName | MemoryMetaToolName;
+export type StacklinkMcpToolName = StacklinkMetaToolName;
 export type StacklinkToolSurfaceName = StacklinkMcpToolName | (string & {});
-export declare const stacklinkTypeScriptSdkVersion = "0.2.0";
+export declare const stacklinkTypeScriptSdkVersion = "0.3.7";
 export declare class StacklinkApiError extends Error {
     readonly statusCode: number;
     readonly code?: string | undefined;
@@ -26,6 +25,10 @@ export type JsonRecord = Record<string, unknown>;
 export type StacklinkExecutionKind = 'tool' | 'batch' | 'workbench_bash' | 'workbench_code' | 'workbench_proxy';
 export interface StacklinkRequestOptions {
     signal?: AbortSignal | undefined;
+    timeoutMs?: number | undefined;
+    idempotencyKey?: string | undefined;
+    requestId?: string | undefined;
+    traceparent?: string | undefined;
 }
 interface StacklinkRequestInit extends StacklinkRequestOptions {
     method?: string | undefined;
@@ -164,7 +167,7 @@ export type ProviderMcpTransport = 'streamable_http';
 export type ProviderMcpAuthType = 'oauth_dcr' | 'oauth_static_client' | 'bearer' | 'none';
 export type ProviderMcpImportPolicy = 'certified_allowlist' | 'discover_then_review';
 export type ProviderMcpIdentityKind = 'user' | 'workspace' | 'organization' | 'project';
-export type ProviderMcpResourceKind = 'user' | 'workspace' | 'organization' | 'project' | 'site' | 'space' | 'component' | 'repository' | 'channel' | 'label' | 'folder' | 'document' | 'spreadsheet' | 'database';
+export type ProviderMcpResourceKind = 'user' | 'user_group' | 'group' | 'workspace' | 'organization' | 'project' | 'site' | 'space' | 'component' | 'repository' | 'team' | 'channel' | 'chat' | 'message' | 'meeting' | 'scheduled_event' | 'invitee' | 'routing_form' | 'routing_form_submission' | 'meeting_recap' | 'platform' | 'transcript' | 'schedule' | 'shift' | 'label' | 'folder' | 'mail_folder' | 'calendar' | 'contact_folder' | 'file' | 'document' | 'spreadsheet' | 'database' | 'zoom_meeting' | 'zoom_webinar' | 'zoom_transcript' | 'zoom_meeting_summary' | 'invoice' | 'estimate' | 'credit_note' | 'customer_payment' | 'bill' | 'expense' | 'purchase_order' | 'vendor_payment' | 'task' | 'time_entry' | 'shopify_collection' | 'shopify_location' | 'shopify_order' | 'business_account' | 'ad_account' | 'campaign' | 'ad_creative' | 'product_catalog' | 'facebook_page' | 'instagram_account' | 'phone_number' | 'resource';
 export interface ProviderRuntime {
     kind: ProviderRuntimeKind;
     owner: ProviderRuntimeOwner;
@@ -276,6 +279,65 @@ export interface ProjectProvider {
     } | undefined;
     toolkit?: ProviderToolkit | undefined;
 }
+export type ProviderCatalogConnectionStatus = 'connected' | 'in_progress' | 'attention' | 'not_connected';
+export interface ProviderCatalogListItem {
+    providerKey: string;
+    displayName: string;
+    shortDescription: string;
+    logoUrl: string;
+    categoryKeys: string[];
+    authModes: string[];
+    catalogStatus: string;
+    projectStatus: 'enabled' | 'disabled' | 'planned';
+    connection: {
+        status: ProviderCatalogConnectionStatus;
+        connectedAccountCount: number;
+    };
+    availableToolCount: number;
+    availableTriggerCount: number;
+    catalogVersion: string;
+}
+export interface ProviderToolCatalogListItem {
+    toolKey: string;
+    displayName: string;
+    description: string;
+    capability: string;
+    mutationLevel: string;
+    connectionRequired: boolean;
+    contractVersion: string;
+    status: string;
+}
+export interface CursorPageMeta {
+    limit: number;
+    nextCursor: string | null;
+    hasMore: boolean;
+    totalItems: number;
+}
+export interface CatalogSnapshotMeta {
+    catalogVersion: string;
+    asOf: string;
+}
+export interface ProviderCatalogPage {
+    items: ProviderCatalogListItem[];
+    page: CursorPageMeta;
+    snapshot: CatalogSnapshotMeta;
+}
+export interface ProviderToolCatalogPage {
+    providerKey: string;
+    items: ProviderToolCatalogListItem[];
+    page: CursorPageMeta;
+    snapshot: CatalogSnapshotMeta;
+}
+export interface ListProviderCatalogInput {
+    limit?: number | undefined;
+    cursor?: string | undefined;
+    search?: string | undefined;
+    providerKeys?: string[] | undefined;
+    categoryKeys?: string[] | undefined;
+    projectStatus?: 'enabled' | 'disabled' | 'planned' | undefined;
+    connectionStatus?: ProviderCatalogConnectionStatus | undefined;
+    tenantId?: string | undefined;
+}
 export interface StacklinkProject {
     id: string;
     projectId?: string | undefined;
@@ -375,6 +437,7 @@ export interface ConnectedAccount {
     displayName: string | null;
     status: string;
     authMode: string;
+    oauthScopeProfile?: string | null | undefined;
     isDefault: boolean;
     region?: string | null | undefined;
     scopes: unknown;
@@ -489,6 +552,7 @@ export interface ConnectionRequestResponse {
     providerName?: string | undefined;
     authConfigId?: string | null | undefined;
     authMode?: string | null | undefined;
+    oauthScopeProfile?: string | null | undefined;
     status: string;
     phase?: ConnectionRequestPhase | undefined;
     nextAction?: ConnectionRequestNextAction | undefined;
@@ -508,6 +572,7 @@ export interface ConnectionAuthorizationResponse {
     providerKey: string;
     authConfigId?: string | undefined;
     authMode?: string | undefined;
+    oauthScopeProfile?: string | null | undefined;
     status: string;
     phase?: ConnectionRequestPhase | undefined;
     nextAction?: ConnectionRequestNextAction | undefined;
@@ -707,8 +772,7 @@ export interface UpdateStacklinkSessionInput {
     expectedConfigVersion?: number | undefined;
     status?: 'active' | 'closed' | 'failed' | undefined;
     toolRouter?: CreateStacklinkSessionInput['toolRouter'];
-    preset?: CreateStacklinkSessionInput['preset'];
-    preload?: CreateStacklinkSessionInput['preload'];
+    modelSurface?: CreateStacklinkSessionInput['modelSurface'];
     toolkits?: CreateStacklinkSessionInput['toolkits'];
     tools?: CreateStacklinkSessionInput['tools'];
     authConfigs?: CreateStacklinkSessionInput['authConfigs'];
@@ -717,7 +781,6 @@ export interface UpdateStacklinkSessionInput {
     multiAccount?: CreateStacklinkSessionInput['multiAccount'];
     workbench?: CreateStacklinkSessionInput['workbench'];
     knowledgePacks?: CreateStacklinkSessionInput['knowledgePacks'];
-    metaTools?: CreateStacklinkSessionInput['metaTools'];
     memory?: CreateStacklinkSessionInput['memory'];
     metadata?: Record<string, unknown> | undefined;
 }
@@ -853,7 +916,7 @@ export interface WorkbenchRuntimeDiagnostics {
     exitCode?: number | undefined;
     error?: unknown;
 }
-export type WorkbenchExecutionStatus = 'queued' | 'started' | 'running' | 'cancel_requested' | 'completed' | 'failed' | 'cancelled' | 'timed_out';
+export type WorkbenchExecutionStatus = 'waiting_for_approval' | 'queued' | 'started' | 'running' | 'cancel_requested' | 'completed' | 'failed' | 'cancelled' | 'timed_out';
 export interface WorkbenchExecutionLog {
     id: string;
     executionId?: string | undefined;
@@ -944,6 +1007,9 @@ export interface WorkbenchOutputPreview {
     preview: string;
 }
 export interface WorkbenchExecutionResponse {
+    approvalRequestId?: string | undefined;
+    executed?: boolean | undefined;
+    nextAction?: 'wait_for_approval' | undefined;
     workbenchSession: WorkbenchSession;
     executionKind: 'workbench_code' | 'workbench_bash';
     executionId: string;
@@ -1146,6 +1212,7 @@ export interface StacklinkSessionMetaToolDefinition {
     name: string;
     description: string;
     inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
 }
 export interface ProviderArtifact {
     id: string;
@@ -1216,6 +1283,8 @@ export interface StacklinkOptions {
     fetch?: StacklinkFetch;
     registrationKey?: string | undefined;
     cache?: StacklinkClientCacheOptions | undefined;
+    timeoutMs?: number | undefined;
+    maxAttempts?: number | undefined;
 }
 export interface StacklinkClientCacheOptions {
     enabled?: boolean | undefined;
@@ -1228,32 +1297,111 @@ export interface StacklinkClientCacheOptions {
 export interface StacklinkDiscoveryCacheControl {
     cache?: 'default' | 'bypass' | undefined;
 }
-export interface StacklinkPrepareToolsInput extends StacklinkDiscoveryCacheControl {
-    intents: string[];
-    includeSchemas?: boolean | undefined;
-    limitPerIntent?: number | undefined;
-    includePlanned?: boolean | undefined;
-    toolkitKey?: string | undefined;
-    capability?: string | undefined;
-    model?: string | undefined;
+export interface StacklinkAgentSearchQuery {
+    id: string;
+    task: string;
+    providerHint?: {
+        label: string;
+    } | undefined;
+    providerRef?: string | undefined;
+}
+export interface StacklinkAgentSearchResponse {
+    schemaVersion: 'stacklink.agent_tool_search.v2';
+    results: Array<{
+        queryId: string;
+        providerResolution: {
+            status: 'resolved' | 'ambiguous' | 'not_found';
+            requestedLabel?: string | undefined;
+            recommended?: {
+                providerRef: string;
+                providerKey: string;
+                displayName: string;
+            } | undefined;
+            alternatives: Array<{
+                providerRef: string;
+                providerKey: string;
+                displayName: string;
+            }>;
+        };
+        provider?: {
+            providerRef: string;
+            providerKey: string;
+            displayName: string;
+            globalStatus: 'available' | 'planned';
+            projectStatus: 'available_to_connect' | 'enabled' | 'blocked' | 'planned';
+            connectionStatus?: string | undefined;
+        } | undefined;
+        accounts?: Array<{
+            accountRef: string;
+            displayName: string;
+            isDefault: boolean;
+            selected: boolean;
+        }> | undefined;
+        tools: Array<{
+            toolRef: string;
+            providerKey: string;
+            displayName: string;
+            description: string;
+            capability: string;
+            risk: string;
+            connectionStatus: string;
+            contractRef?: string | undefined;
+        }>;
+        nextAction?: {
+            kind: 'authorize_connection';
+            connectionRef: string;
+        } | undefined;
+        blocker?: {
+            kind: 'provider_not_found' | 'provider_planned' | 'provider_blocked';
+            owner: 'stacklink' | 'project_admin';
+        } | undefined;
+    }>;
+    limits: {
+        maxQueries: number;
+        maxProviderCandidatesPerQuery: number;
+        maxCandidatesPerQuery: number;
+        maxUniqueTools: number;
+    };
 }
-export interface StacklinkPreparedTools {
-    tools: ProviderTool[];
-    schemas: ProviderTool[];
-    toolKeys: string[];
-    search: {
-        tools: ProviderTool[];
-        queries?: unknown[] | undefined;
-        meta?: unknown;
+export interface StacklinkAgentToolContractsResponse {
+    contract: 'stacklink.agent_tool_contracts.v2';
+    sessionId: string;
+    tools: StacklinkAgentToolContract[];
+    meta: {
+        returned: number;
+    };
+}
+export interface StacklinkAgentToolContract {
+    contractRef: string;
+    toolKey: string;
+    contractVersion: string;
+    provider: {
+        providerKey: string;
+        displayName: string;
+    };
+    displayName: string;
+    description: string;
+    capability: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+    risk: Record<string, unknown>;
+    execution: Record<string, unknown>;
+    outputPolicy: Record<string, unknown>;
+    accountSelection: {
+        required: boolean;
+        status: string;
+        accounts: Array<{
+            accountRef: string;
+            displayName: string;
+            isDefault: boolean;
+            selected: boolean;
+        }>;
     };
 }
 export interface StacklinkDiscoveryConfig {
-    preset: 'meta_tools' | 'direct_tools' | 'hybrid';
-    preload: {
-        tools?: string[] | undefined;
-        toolkits?: string[] | undefined;
-        includeMetaTools?: boolean | undefined;
-        includeWorkbench?: boolean | undefined;
+    mode: 'router' | 'specialist';
+    specialist: {
+        toolKeys: string[];
         includeConnectionManagement?: boolean | undefined;
     };
 }
@@ -1265,13 +1413,12 @@ export interface CreateStacklinkSessionInput {
     userEmail?: string | undefined;
     scopes?: string[] | undefined;
     toolRouter?: Record<string, unknown> | undefined;
-    preset?: 'meta_tools' | 'direct_tools' | 'hybrid' | undefined;
-    preload?: {
-        tools?: string[] | undefined;
-        toolkits?: string[] | undefined;
-        includeMetaTools?: boolean | undefined;
-        includeWorkbench?: boolean | undefined;
-        includeConnectionManagement?: boolean | undefined;
+    modelSurface?: {
+        mode: 'router' | 'specialist';
+        specialist?: {
+            toolKeys?: string[] | undefined;
+            includeConnectionManagement?: boolean | undefined;
+        } | undefined;
     } | undefined;
     toolkits?: string[] | {
         enable?: string[];
@@ -1306,12 +1453,6 @@ export interface CreateStacklinkSessionInput {
         contextTokenBudget?: number | undefined;
         policyKey?: string | undefined;
     } | undefined;
-    metaTools?: {
-        surface?: StacklinkMetaToolSurface;
-        includeInternal?: boolean;
-        enable?: string[];
-        disable?: string[];
-    } | undefined;
     metadata?: Record<string, unknown> | undefined;
 }
 export interface ListStacklinkSessionsInput {
@@ -1330,7 +1471,13 @@ export interface ListStacklinkSessionsResponse {
 export interface StacklinkTool {
     description: string;
     parameters: Record<string, unknown>;
-    execute: (input: Record<string, unknown>) => Promise<unknown>;
+    outputSchema: Record<string, unknown>;
+    execute: (input: Record<string, unknown>, execution?: StacklinkToolExecutionContext | undefined) => Promise<unknown>;
+}
+export interface StacklinkToolExecutionContext {
+    toolCallId?: string | undefined;
+    abortSignal?: AbortSignal | undefined;
+    onProgress?: StacklinkMcpStreamOptions['onProgress'];
 }
 export type StacklinkTools = Record<string, StacklinkTool>;
 export type KnowledgeRetrievalMode = 'canonical_lookup' | 'hybrid_search' | 'semantic_search' | 'text_search' | 'semantic_unavailable';
@@ -1801,6 +1948,33 @@ export interface GstNoticeRuleResponse extends GstRateLookupResponse {
 export interface GstAppealStageRuleResponse extends GstRateLookupResponse {
 }
 export declare function verifyWebhookSignature(input: StacklinkWebhookSignatureInput): Promise<boolean>;
+/** Sign the exact JSON bytes sent to a saved inbound Bot webhook. Reuse requestId when retrying. */
+export declare function signBotTriggerRequest(input: {
+    triggerId: string;
+    secret: string;
+    body: string;
+    requestId?: string;
+    now?: Date;
+}): Promise<Record<string, string>>;
+/** Verify the original request bytes before using identity. consumeRequestId must atomically reject replays. */
+export declare function verifyBotApiRequest(input: {
+    method: string;
+    url: string;
+    body: string;
+    headers: ConstructorParameters<typeof Headers>[0];
+    projectId: string;
+    keys: Record<string, string | {
+        secret: string;
+        validUntil: string | null;
+    }>;
+    consumeRequestId: (id: string, expiresAt: Date) => boolean | Promise<boolean>;
+    now?: Date;
+    toleranceSeconds?: number;
+}): Promise<{
+    tenantId: string;
+    userId: string | null;
+    requestId: string;
+} | null>;
 export declare class Stacklink {
     private readonly apiKey;
     private readonly registrationKey;
@@ -1808,6 +1982,11 @@ export declare class Stacklink {
     private readonly fetchImpl;
     private readonly cacheOptions;
     private readonly responseCache;
+    private readonly discoveryRequests;
+    private readonly timeoutMs;
+    private readonly maxAttempts;
+    readonly bots: StacklinkBotsClient;
+    readonly approvals: StacklinkApprovalsClient;
     readonly webhooks: StacklinkWebhooksClient;
     readonly triggers: StacklinkTriggersClient;
     readonly sessions: StacklinkSessionsClient;
@@ -1894,25 +2073,15 @@ export declare class Stacklink {
     deleteApiKey(apiKeyId: string): Promise<{
         apiKey: StacklinkApiKey;
     }>;
-    listProviders(): Promise<{
-        providers: ProviderToolkit[];
-    }>;
-    listProjectProviders(query?: {
-        tenantId?: string;
-    }): Promise<{
-        providers: ProjectProvider[];
-    }>;
+    listProviders(query?: Omit<ListProviderCatalogInput, 'tenantId' | 'projectStatus' | 'connectionStatus'>): Promise<ProviderCatalogPage>;
+    listProjectProviders(query?: ListProviderCatalogInput): Promise<ProviderCatalogPage>;
     listProviderTools(providerKey: string, input?: {
+        limit?: number | undefined;
+        cursor?: string | undefined;
+        search?: string | undefined;
+        capability?: string | undefined;
         includePlanned?: boolean | undefined;
-        responseMode?: 'compact' | 'full' | undefined;
-    }): Promise<{
-        providerKey: string;
-        tools: ProviderTool[];
-        meta?: {
-            responseMode?: "compact" | "full" | undefined;
-            provider?: ProviderToolkit | undefined;
-        } | undefined;
-    }>;
+    }): Promise<ProviderToolCatalogPage>;
     createProject(input: {
         clientName: string;
         projectName?: string | undefined;
@@ -1999,8 +2168,7 @@ export declare class Stacklink {
     }>;
     getRuntimeToolContracts(input: {
         sessionId: string;
-        toolkitKeys?: string[] | undefined;
-        toolKeys?: string[] | undefined;
+        toolKeys: string[];
         includePlanned?: boolean | undefined;
     }): Promise<{
         contract: string;
@@ -2244,12 +2412,26 @@ export declare class Stacklink {
         hasMore: boolean;
         nextCursor: string | null;
     }>;
+    streamBotEvents(botId: string, runId: string, options?: StacklinkRequestOptions & {
+        after?: string;
+        totalTimeoutMs?: number;
+    }): AsyncGenerator<Record<string, unknown> | {
+        sequence: string;
+        type: string;
+        payload: unknown;
+    }, void, unknown>;
+    streamExecutionEvents(input: {
+        sessionId: string;
+        executionKind: StacklinkExecutionKind;
+        executionId: string;
+        afterSequence?: string | number | bigint | undefined;
+        limit?: number | undefined;
+    }, options?: StacklinkRequestOptions): AsyncGenerator<any, void, unknown>;
     waitForExecution(input: {
         sessionId: string;
         executionKind: StacklinkExecutionKind;
         executionId: string;
         waitTimeoutMs?: number | undefined;
-        pollIntervalMs?: number | undefined;
     }, options?: StacklinkRequestOptions): Promise<Record<string, unknown>>;
     cancelExecution(input: {
         sessionId: string;
@@ -2281,9 +2463,9 @@ export declare class Stacklink {
     getConnectedAccount(accountId: string): Promise<{
         account: ConnectedAccount;
     }>;
-    listConnectedAccountTools(accountId: string, input?: {
+    listConnectedAccountTools(accountId: string, input: {
         includePlanned?: boolean | undefined;
-        toolKeys?: string[] | undefined;
+        toolKeys: string[];
     }): Promise<{
         contract: string;
         sessionId: string;
@@ -2536,15 +2718,11 @@ export declare class Stacklink {
     deleteWorkbenchBudget(budgetPolicyId: string): Promise<{
         budgetPolicy: WorkbenchBudgetPolicy;
     }>;
-    mcpRequest(input: Record<string, unknown> | Array<Record<string, unknown>>, options?: StacklinkRequestOptions): Promise<unknown>;
-    mcpSessionRequest(sessionId: string, input: Record<string, unknown> | Array<Record<string, unknown>>, options?: StacklinkRequestOptions): Promise<unknown>;
+    mcpSessionRequest(sessionId: string, input: Record<string, unknown> | Array<Record<string, unknown>>, options?: StacklinkRequestOptions): Promise<{} | null>;
     private mcpRequestAtPath;
-    mcpRequestStream(input: Record<string, unknown>, options?: StacklinkMcpStreamOptions): Promise<unknown>;
-    mcpSessionRequestStream(sessionId: string, input: Record<string, unknown>, options?: StacklinkMcpStreamOptions): Promise<unknown>;
+    mcpSessionRequestStream(sessionId: string, input: Record<string, unknown>, options?: StacklinkMcpStreamOptions): Promise<{} | null>;
     private mcpRequestStreamAtPath;
-    listMcpTools(): Promise<unknown>;
-    callMcpTool(name: StacklinkToolSurfaceName, args: Record<string, unknown>): Promise<unknown>;
-    callSessionMcpTool(sessionId: string, name: StacklinkToolSurfaceName, args: Record<string, unknown>): Promise<unknown>;
+    callSessionMcpTool(sessionId: string, name: StacklinkToolSurfaceName, args: Record<string, unknown>, options?: StacklinkMcpStreamOptions): Promise<{} | null>;
     listKnowledgePacks(): Promise<KnowledgePackListResponse>;
     getKnowledgeCapabilities(input?: {
         sessionId?: string | undefined;
@@ -2571,10 +2749,12 @@ export declare class Stacklink {
     private attachAbortSignalCancellation;
     request<T>(path: string, init?: StacklinkRequestInit): Promise<T>;
     requestRaw(path: string, init?: StacklinkRequestInit): Promise<Response>;
+    private performRequest;
     cachedDiscoveryRequest<T>(cacheKey: string, ttlMs: number, control: StacklinkDiscoveryCacheControl | undefined, producer: () => Promise<T>): Promise<T>;
     discoveryCacheTtl(kind: 'toolsList' | 'toolkits' | 'schemas' | 'search'): number;
     private trimResponseCache;
     private readMcpEventStream;
+    private readJsonEventStream;
     private requestHeaders;
 }
 export declare class StacklinkWebhooksClient {
@@ -2646,6 +2826,30 @@ export interface StacklinkMemoryAccessSelector {
     subjectType?: MemorySubjectRef['type'] | undefined;
     externalSubjectId?: string | undefined;
 }
+export interface StacklinkMemoryQualityReviewEntity {
+    entityType: string;
+    canonicalKey: string;
+    displayName?: string | null | undefined;
+    attributes?: JsonRecord | undefined;
+}
+export interface StacklinkMemoryQualityReviewInput {
+    disposition: 'keep' | 'correct' | 'convert_to_episode' | 'restrict';
+    content?: string | undefined;
+    title?: string | null | undefined;
+    memoryType: 'preference' | 'decision' | 'commitment' | 'goal' | 'constraint' | 'relationship' | 'durable_fact';
+    sensitivityClass: 'standard' | 'personal' | 'restricted';
+    restrictedDataClasses?: Array<'health' | 'biometric' | 'government_identity' | 'precise_location' | 'protected_trait' | 'minor' | 'detailed_personal_financial'> | undefined;
+    topicTags?: string[] | undefined;
+    language?: string | null | undefined;
+    validFrom?: string | null | undefined;
+    validTo?: string | null | undefined;
+    authorshipClass: 'connected_user' | 'other_human' | 'bot' | 'application' | 'system' | 'unknown';
+    salience: 'low' | 'medium' | 'high';
+    evidenceConfidence: 'low' | 'medium' | 'high';
+    actorEntity: StacklinkMemoryQualityReviewEntity;
+    subjectEntity: StacklinkMemoryQualityReviewEntity;
+    reason: string;
+}
 export declare class StacklinkMemoryClient {
     private readonly client;
     constructor(client: Stacklink);
@@ -2694,6 +2898,9 @@ export declare class StacklinkMemoryClient {
             metadata?: JsonRecord | undefined;
         };
     }): Promise<JsonRecord>;
+    reviewQuality(memoryId: string, input: StacklinkMemoryAccessSelector & {
+        review: StacklinkMemoryQualityReviewInput;
+    }): Promise<JsonRecord>;
     forget(memoryId: string, input: StacklinkMemoryAccessSelector & {
         reason?: string | undefined;
     }): Promise<JsonRecord>;
@@ -2756,7 +2963,7 @@ export declare class StacklinkMemoryClient {
     getSource(bindingId: string): Promise<JsonRecord>;
     setSourceStatus(bindingId: string, status: 'active' | 'paused'): Promise<JsonRecord>;
     updateSource(bindingId: string, input: MemorySourceBindingUpdateInput): Promise<JsonRecord>;
-    deleteSource(bindingId: string): Promise<JsonRecord>;
+    deleteSource(bindingId: string, input: MemorySourceRemovalInput): Promise<JsonRecord>;
     replaySourceItem(bindingId: string, itemId: string): Promise<JsonRecord>;
     listSourceDeliveries(input?: {
         tenantId?: string | undefined;
@@ -2772,6 +2979,45 @@ export declare class StacklinkMemoryClient {
     createLegalHold(input: MemoryLegalHoldInput): Promise<JsonRecord>;
     releaseLegalHold(holdId: string): Promise<JsonRecord>;
 }
+export interface StacklinkApprovalAccess {
+    sessionId: string;
+    asCustomer?: boolean;
+}
+export interface StacklinkApprovalEvent {
+    sequence: string;
+    approvalId: string;
+    type: 'approval.request.updated';
+    data: {
+        revision: number;
+        status: string;
+        requirements: unknown[];
+        denialReason: string | null;
+    };
+    occurredAt: string;
+}
+export declare class StacklinkApprovalsClient {
+    private readonly client;
+    constructor(client: Stacklink);
+    /** Server-only access. Identity comes from the authenticated application session. */
+    getCustomerGrant(sessionId: string): Promise<CustomerApprovalGrantResponse>;
+    saveCustomerGrant(sessionId: string, grant: CustomerApprovalGrantInput): Promise<CustomerApprovalGrantResponse>;
+    removeCustomerGrant(sessionId: string, revision: number): Promise<CustomerApprovalGrantResponse>;
+    list(input: StacklinkApprovalAccess & Partial<ApprovalListQuery>): Promise<ApprovalListResponse>;
+    get(id: string, access: StacklinkApprovalAccess): Promise<ApprovalRecord>;
+    /** Decide only after displaying the exact proposal and checking permissions. Never resubmit the original action. */
+    decide(id: string, access: StacklinkApprovalAccess, decision: ApprovalDecision): Promise<ApprovalRecord>;
+    change(id: string, access: StacklinkApprovalAccess, change: ApprovalChange): Promise<ApprovalRecord>;
+    events(access: StacklinkApprovalAccess, after?: string, options?: StacklinkRequestOptions): Promise<{
+        events: StacklinkApprovalEvent[];
+        nextCursor: string;
+    }>;
+    /** Durable cursor observation. Save each sequence and pass it as `after` when reconnecting. */
+    observe(access: StacklinkApprovalAccess, options?: {
+        after?: string;
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): AsyncGenerator<StacklinkApprovalEvent>;
+}
 export declare class StacklinkSessionsClient {
     private readonly client;
     constructor(client: Stacklink);
@@ -2797,14 +3043,11 @@ export declare class StacklinkSessionsClient {
         tools: StacklinkSessionMetaToolDefinition[];
         toolRouterSession?: StacklinkSessionData;
     }>;
-    toolkits(sessionId: string): Promise<{
-        toolkits: ProjectProvider[];
-    }>;
+    toolkits(sessionId: string, query?: Omit<ListProviderCatalogInput, 'tenantId'>): Promise<ProviderCatalogPage>;
     streamEvents(sessionId: string, input?: {
         after?: string;
         eventTypes?: string[];
         limit?: number;
-        pollIntervalMs?: number;
     }): Promise<Response>;
     listRouterFacts(sessionId: string, query?: {
         kind?: string;
@@ -2928,9 +3171,9 @@ export declare class StacklinkConnectedAccountsClient {
     get(accountId: string): Promise<{
         account: ConnectedAccount;
     }>;
-    listTools(accountId: string, input?: {
+    listTools(accountId: string, input: {
         includePlanned?: boolean | undefined;
-        toolKeys?: string[] | undefined;
+        toolKeys: string[];
     }): Promise<{
         contract: string;
         sessionId: string;
@@ -2992,22 +3235,15 @@ export declare class StacklinkAuthConfigsClient {
 export declare class StacklinkToolkitsClient {
     private readonly client;
     constructor(client: Stacklink);
-    list(): Promise<{
-        providers: ProviderToolkit[];
-    }>;
-    listProject(query?: {
-        tenantId?: string;
-    }): Promise<{
-        providers: ProjectProvider[];
-    }>;
-    listTools(providerKey: string): Promise<{
-        providerKey: string;
-        tools: ProviderTool[];
-        meta?: {
-            responseMode?: "compact" | "full" | undefined;
-            provider?: ProviderToolkit | undefined;
-        } | undefined;
-    }>;
+    list(query?: Omit<ListProviderCatalogInput, 'tenantId' | 'projectStatus' | 'connectionStatus'>): Promise<ProviderCatalogPage>;
+    listProject(query?: ListProviderCatalogInput): Promise<ProviderCatalogPage>;
+    listTools(providerKey: string, query?: {
+        limit?: number | undefined;
+        cursor?: string | undefined;
+        search?: string | undefined;
+        capability?: string | undefined;
+        includePlanned?: boolean | undefined;
+    }): Promise<ProviderToolCatalogPage>;
 }
 export declare class StacklinkProviderToolsClient {
     private readonly client;
@@ -3026,8 +3262,7 @@ export declare class StacklinkProviderToolsClient {
     }>;
     runtimeContracts(input: {
         sessionId: string;
-        toolkitKeys?: string[] | undefined;
-        toolKeys?: string[] | undefined;
+        toolKeys: string[];
         includePlanned?: boolean | undefined;
     }): Promise<{
         contract: string;
@@ -3073,7 +3308,6 @@ export declare class StacklinkSessionMemoryClient {
     history(memoryId: string): Promise<JsonRecord>;
     update(memoryId: string, patch: Parameters<StacklinkMemoryClient['update']>[1]['patch']): Promise<JsonRecord>;
     forget(memoryId: string, reason?: string): Promise<JsonRecord>;
-    restore(memoryId: string, reason?: string): Promise<JsonRecord>;
 }
 export declare class StacklinkWorkbenchRun {
     private readonly client;
@@ -3083,12 +3317,12 @@ export declare class StacklinkWorkbenchRun {
     readonly executionKind: 'workbench_code' | 'workbench_bash';
     constructor(client: Stacklink, platformSessionId: string, response: WorkbenchExecutionResponse);
     events(input?: {
-        pollIntervalMs?: number | undefined;
+        signal?: AbortSignal | undefined;
+        streamTimeoutMs?: number | undefined;
         limit?: number | undefined;
-    }): AsyncGenerator<unknown, void, unknown>;
+    }): AsyncGenerator<any, void, unknown>;
     wait(input?: {
         waitTimeoutMs?: number | undefined;
-        pollIntervalMs?: number | undefined;
     }): Promise<Record<string, unknown>>;
     cancel(reason?: string): Promise<Record<string, unknown>>;
 }
@@ -3231,9 +3465,9 @@ export declare class ToolRouterSession {
     get(): Promise<{
         session: StacklinkSessionData;
     }>;
-    mcpRequest(input: Record<string, unknown> | Array<Record<string, unknown>>, options?: StacklinkRequestOptions): Promise<unknown>;
-    mcpRequestStream(input: Record<string, unknown>, options?: StacklinkMcpStreamOptions): Promise<unknown>;
-    callMcpTool(name: StacklinkToolSurfaceName, args: Record<string, unknown>): Promise<unknown>;
+    mcpRequest(input: Record<string, unknown> | Array<Record<string, unknown>>, options?: StacklinkRequestOptions): Promise<{} | null>;
+    mcpRequestStream(input: Record<string, unknown>, options?: StacklinkMcpStreamOptions): Promise<{} | null>;
+    callMcpTool(name: StacklinkToolSurfaceName, args: Record<string, unknown>, options?: StacklinkMcpStreamOptions): Promise<{} | null>;
     mcpConnection(): StacklinkSessionMcpConnection;
     update(patch: UpdateStacklinkSessionInput): Promise<{
         session: StacklinkSessionData;
@@ -3287,11 +3521,9 @@ export declare class ToolRouterSession {
         usage: unknown[];
         cost: unknown[];
     }>;
-    toolkits(): Promise<ProjectProvider[]>;
-    authorize(providerKey: string, input?: {
-        callbackUrl?: string;
-        authConfigId?: string;
-        authMode?: string;
+    toolkits(query?: Omit<ListProviderCatalogInput, 'tenantId'>): Promise<ProviderCatalogPage>;
+    authorize(connectionRef: string, input?: {
+        oauthScopeProfile?: string;
         metadata?: Record<string, unknown>;
     }): Promise<StacklinkConnectionRequest>;
     waitForConnections(connectionRequestIds: string[], timeoutMs?: number, intervalMs?: number): Promise<{
@@ -3309,27 +3541,10 @@ export declare class ToolRouterSession {
     connectedAccountSecrets(accountId: string): Promise<unknown[]>;
     connectedAccountResources(accountId: string): Promise<ConnectedAccountResourcesResponse>;
     refreshConnectedAccountResources(accountId: string): Promise<ConnectedAccountResourcesResponse>;
-    searchTools(input?: Omit<Record<string, unknown>, 'sessionId'> & StacklinkDiscoveryCacheControl): Promise<{
-        tools: ProviderTool[];
-        queries?: unknown[];
-        meta?: unknown;
-    }>;
-    getToolSchemas(toolKeys: string[], input?: {
-        includePlanned?: boolean | undefined;
-    } & StacklinkDiscoveryCacheControl): Promise<{
-        tools: ProviderTool[];
-    }>;
-    prepareRuntimeTools(input?: {
-        toolkitKeys?: string[] | undefined;
-        toolKeys?: string[] | undefined;
-        includePlanned?: boolean | undefined;
-    }): Promise<{
-        contract: string;
-        sessionId: string;
-        tools: ProviderTool[];
-        meta?: unknown;
-    }>;
-    prepareTools(input: StacklinkPrepareToolsInput): Promise<StacklinkPreparedTools>;
+    search(input: {
+        queries: StacklinkAgentSearchQuery[];
+    } & StacklinkDiscoveryCacheControl): Promise<StacklinkAgentSearchResponse>;
+    getContracts(contractRefs: string[]): Promise<StacklinkAgentToolContractsResponse>;
     searchKnowledge(input?: Omit<KnowledgeSearchInput, 'sessionId'>): Promise<KnowledgeSearchResponse>;
     getKnowledgeCapabilities(input?: {
         packKey?: string | undefined;
@@ -3349,8 +3564,16 @@ export declare class ToolRouterSession {
     checkGstRcm(input: Omit<GstRcmCheckInput, 'sessionId'>): Promise<GstRcmCheckResponse>;
     getGstNoticeRule(input: Omit<GstNoticeRuleInput, 'sessionId'>): Promise<GstNoticeRuleResponse>;
     getGstAppealStageRule(input: Omit<GstAppealStageRuleInput, 'sessionId'>): Promise<GstAppealStageRuleResponse>;
-    executeTool(input: Omit<Record<string, unknown>, 'sessionId'>, options?: StacklinkRequestOptions): Promise<Record<string, unknown>>;
-    executeToolsBatch(input: Omit<Record<string, unknown>, 'sessionId'>, options?: StacklinkRequestOptions): Promise<Record<string, unknown>>;
+    execute(contractRef: string, input: Record<string, unknown>, execution?: {
+        accountRef?: string | undefined;
+        binding?: {
+            targetType: string;
+            targetId: string;
+        } | undefined;
+        idempotencyKey?: string | undefined;
+        clientExecutionId?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }, options?: StacklinkRequestOptions): Promise<Record<string, unknown>>;
     runWorkbench(input: Omit<Record<string, unknown>, 'sessionId'>, options?: StacklinkRequestOptions): Promise<Record<string, unknown>>;
     destroyWorkbenchSession(input: {
         workbenchSessionId: string;
@@ -3398,7 +3621,6 @@ export declare class ToolRouterSession {
         executionKind: StacklinkExecutionKind;
         executionId: string;
         waitTimeoutMs?: number | undefined;
-        pollIntervalMs?: number | undefined;
     }, options?: StacklinkRequestOptions): Promise<Record<string, unknown>>;
     cancelExecution(input: {
         executionKind: StacklinkExecutionKind;
@@ -3409,7 +3631,6 @@ export declare class ToolRouterSession {
         after?: string;
         eventTypes?: string[];
         limit?: number;
-        pollIntervalMs?: number;
     }): Promise<Response>;
     tools(): StacklinkTools;
 }
@@ -3440,4 +3661,115 @@ export declare class StacklinkConnectionRequest {
     };
     waitForConnection(timeoutMs?: number, intervalMs?: number): Promise<ConnectedAccount | undefined>;
 }
+/** Hosted bots share durable runs across the API, MCP and dashboard. */
+export declare class StacklinkBotsClient {
+    private readonly client;
+    constructor(client: Stacklink);
+    apis(): Promise<{
+        apis: SavedBotApi[];
+    }>;
+    updateApi(apiId: string, revision: number, api: ContextApi): Promise<SavedBotApi>;
+    deleteApi(apiId: string): Promise<{
+        deleted: boolean;
+    }>;
+    webhookSecret(botId: string): Promise<{
+        signingSecret: string;
+    }>;
+    triggerWebhook(botId: string, triggerId: string): Promise<{
+        url: string;
+        signingSecret: string;
+        signatureVersion: string;
+        maxAgeSeconds: number;
+    }>;
+    triggerAdmission(botId: string, triggerId: string, admissionId: string): Promise<{
+        admissionId: string;
+        status: string;
+        runId: string | null;
+        result: unknown;
+        error: unknown;
+    }>;
+    apiSigningKey(botId: string, apiId: string, request?: BotApiSigningKeyRequest): Promise<BotApiSigningKey>;
+    models(): Promise<{
+        models: import("../domain/bot-contract.js").ModelOption[];
+        defaultModel: string;
+    }>;
+    setCredential(botId: string, secret: string): Promise<{
+        id: string;
+    }>;
+    deliveries(botId: string, runId: string): Promise<{
+        deliveries: Array<{
+            id: string;
+            status: string;
+            attemptCount: number;
+            nextAttemptAt: string | null;
+            failureReason: string | null;
+        }>;
+    }>;
+    retryDelivery(botId: string, runId: string, deliveryId: string): Promise<{
+        queued: boolean;
+    }>;
+    setCustomerCredential(botId: string, input: {
+        apiId: string;
+        sessionId: string;
+        secret: string;
+    }): Promise<{
+        id: string;
+    }>;
+    delete(botId: string): Promise<{
+        deleted: boolean;
+    }>;
+    deleteCustomerData(botId: string, sessionId: string): Promise<{
+        deleted: boolean;
+        conversations: number;
+        knowledgeSources: number;
+        workspaces: number;
+        sharedMemory: "unchanged";
+        sharedApiCredentials: "unchanged";
+    }>;
+    setState(botId: string, input: {
+        state: 'on' | 'paused';
+        pauseFor?: '1h' | 'tomorrow' | 'manual';
+        reason?: string;
+    }): Promise<Bot>;
+    list(): Promise<{
+        bots: Array<{
+            id: string;
+            name: string;
+            status: string;
+        }>;
+    }>;
+    create(name: string): Promise<Bot>;
+    get(botId: string): Promise<Bot>;
+    update(botId: string, revision: number, patch: BotPatch): Promise<Bot>;
+    publish(botId: string, revision: number, channels: PublishChannels): Promise<{
+        botId: string;
+        publishedAt: string;
+    }>;
+    run(botId: string, input: BotRunInput & {
+        sessionId: string;
+    }): Promise<BotRun>;
+    getRun(botId: string, runId: string): Promise<BotRun>;
+    /** Observe the same durable run. Returns when finished or when a person must act. */
+    wait(botId: string, runId: string, options?: {
+        totalTimeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<BotRun>;
+    events(botId: string, runId: string, after?: string): Promise<{
+        events: Array<{
+            sequence: string;
+            type: string;
+            payload: unknown;
+        }>;
+        terminal: boolean;
+    }>;
+    stream(botId: string, runId: string, options?: StacklinkRequestOptions & {
+        after?: string;
+        totalTimeoutMs?: number;
+    }): AsyncGenerator<Record<string, unknown> | {
+        sequence: string;
+        type: string;
+        payload: unknown;
+    }, void, unknown>;
+    cancel(botId: string, runId: string): Promise<BotRun>;
+}
 //# sourceMappingURL=index.d.ts.map