@stacklink/sdk 0.3.10 → 0.3.13

package/dist/src/domain/bot-contract.d.ts

@@ -4,10 +4,12 @@ import { type ApprovalAudience } from "./platform-approval-contract.js";
 /** What the list shows. Working and Needs attention are derived, never set by a person. */
 export type BotStatus = "working" | "on" | "attention" | "paused" | "draft";
 /** The only two states an owner can set. */
+export declare const botWorkingStatuses: Set<string>;
+export declare const botAttentionStatuses: Set<string>;
 export type BotRunState = "on" | "paused";
 export declare const botTerminalStatuses: Set<string>;
 export type PauseFor = "1h" | "tomorrow" | "manual";
-export type ModelEffort = "low" | "medium" | "high";
+export type ModelEffort = "low" | "medium" | "high" | "xhigh";
 export type AnswerFormat = "text" | "json";
 export type AnswerDelivery = "stream" | "once" | "webhook";
 export type SkillLoad = "auto" | "always";
@@ -352,7 +354,7 @@ export type TestCustomer = {
     customerId: string | null;
 };
 export type TestDataMode = "sample" | "live";
-export type TestStepKind = "api" | "app" | "skill" | "memory" | "web" | "knowledge" | "mcp" | "workbench";
+export type TestStepKind = "compaction" | "api" | "app" | "skill" | "memory" | "web" | "knowledge" | "mcp" | "workbench";
 export type TestStep = {
     id?: string;
     startedAt?: string;
@@ -365,6 +367,9 @@ export type TestStep = {
     app?: AppKey;
 };
 export type BotTest = {
+    waitingOperation?: BotWaitingOperation | null;
+    connection?: BotConnectionAction | null;
+    requirements?: BotRequirement[];
     id: string;
     platformSessionId?: string | null;
     revision?: number;
@@ -400,6 +405,8 @@ export type BotActivity = {
     beforeTest: number;
 };
 export type Bot = {
+    /** Named timezone for this Bot; absent means local time is unknown. */
+    timezone?: string | null | undefined;
     workbenchSuggestion?: {
         size: WorkbenchSize;
         reason: string;
@@ -424,6 +431,7 @@ export type Bot = {
     live: {
         runsNow: number;
         runsToday: number;
+        needsAttention?: number;
     } | null;
     model: {
         id: string;
@@ -459,7 +467,7 @@ export type BotReadinessIssue = {
     message: string;
 };
 /** Partial update. Nested objects replace the stored value for that key. */
-export type BotConfiguration = Pick<Bot, "name" | "model" | "instructions" | "skills" | "memory" | "workbench" | "context" | "variables" | "answer" | "runPlan" | "triggers">;
+export type BotConfiguration = Pick<Bot, "name" | "timezone" | "model" | "instructions" | "skills" | "memory" | "workbench" | "context" | "variables" | "answer" | "runPlan" | "triggers">;
 export type BotPatch = Partial<BotConfiguration>;
 export declare const botTriggerSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"app">;
@@ -685,7 +693,54 @@ export type BotRunInput = {
     revision?: number;
     dataMode?: TestDataMode;
     customerSessionId?: string;
+    /** Hosted connection completion destination on the project's configured return origin. */
+    connectionReturnUrl?: string;
 };
+export type BotCapabilityFact = {
+    id: string;
+    status: 'enabled' | 'disabled' | 'sample';
+    owner: 'project_owner' | 'customer';
+    account?: 'project' | 'customer';
+};
+/** Configuration facts are safe to disclose without granting tool execution. */
+export declare function botCapabilityFacts(config: BotConfiguration, sample?: boolean): BotCapabilityFact[];
+export type BotConnectionAction = {
+    kind: 'connection';
+    id: string;
+    providerKey: string;
+    providerName?: string;
+    providerIconUrl?: string;
+    owner: 'customer' | 'project_owner';
+    status: string;
+    expiresAt: string;
+    action: {
+        kind: 'open_url';
+        url: string;
+    } | null;
+    intent?: 'connect' | 'reconnect';
+    canResume?: boolean;
+};
+export type BotWaitingOperation = BotConnectionAction | {
+    kind: 'execution';
+    id: string;
+};
+export declare const botRequirementSchema: z.ZodObject<{
+    capabilityId: z.ZodString;
+    code: z.ZodEnum<["bot_not_configured", "bot_capability_disabled", "bot_sample_mode", "bot_owner_connection_required", "provider_not_found", "provider_planned", "provider_blocked"]>;
+    owner: z.ZodEnum<["project_owner", "stacklink"]>;
+    nextAction: z.ZodEnum<["configure_bot", "repair_connection", "use_live_data", "contact_administrator", "unavailable"]>;
+}, "strict", z.ZodTypeAny, {
+    code: "bot_not_configured" | "bot_capability_disabled" | "bot_sample_mode" | "bot_owner_connection_required" | "provider_not_found" | "provider_planned" | "provider_blocked";
+    capabilityId: string;
+    owner: "project_owner" | "stacklink";
+    nextAction: "unavailable" | "configure_bot" | "repair_connection" | "use_live_data" | "contact_administrator";
+}, {
+    code: "bot_not_configured" | "bot_capability_disabled" | "bot_sample_mode" | "bot_owner_connection_required" | "provider_not_found" | "provider_planned" | "provider_blocked";
+    capabilityId: string;
+    owner: "project_owner" | "stacklink";
+    nextAction: "unavailable" | "configure_bot" | "repair_connection" | "use_live_data" | "contact_administrator";
+}>;
+export type BotRequirement = z.infer<typeof botRequirementSchema>;
 export type BotRun = {
     channel: string;
     dataMode: TestDataMode;
@@ -706,7 +761,10 @@ export type BotRun = {
     createdAt: string;
     completedAt: string | null;
     platformSessionId: string | null;
-    waitingOperation: unknown;
+    waitingOperation: BotWaitingOperation | null;
+    connection?: BotConnectionAction | null;
+    capabilities?: BotCapabilityFact[];
+    requirements?: BotRequirement[];
     /** Server projection of the accepted snapshot and durable execution records. */
     display?: BotRunDisplay;
 };
@@ -1056,6 +1114,7 @@ export declare const botApiSchema: z.ZodObject<{
 }>;
 export declare const botConfigurationSchema: z.ZodObject<{
     name: z.ZodString;
+    timezone: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>>;
     triggers: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"app">;
         subscriptionId: z.ZodString;
@@ -1185,13 +1244,13 @@ export declare const botConfigurationSchema: z.ZodObject<{
     }>]>, "many">>;
     model: z.ZodObject<{
         id: z.ZodString;
-        effort: z.ZodEnum<["low", "medium", "high"]>;
+        effort: z.ZodEnum<["low", "medium", "high", "xhigh"]>;
     }, "strict", z.ZodTypeAny, {
         id: string;
-        effort: "low" | "medium" | "high";
+        effort: "low" | "medium" | "high" | "xhigh";
     }, {
         id: string;
-        effort: "low" | "medium" | "high";
+        effort: "low" | "medium" | "high" | "xhigh";
     }>;
     instructions: z.ZodObject<{
         text: z.ZodString;
@@ -1624,15 +1683,15 @@ export declare const botConfigurationSchema: z.ZodObject<{
                 rule: z.ZodEnum<["allow", "ask", "block"]>;
                 tools: z.ZodArray<z.ZodString, "many">;
             }, "strict", z.ZodTypeAny, {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }, {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }>, "many">;
         }, "strict", z.ZodTypeAny, {
             status: "connecting" | "connected";
@@ -1647,10 +1706,10 @@ export declare const botConfigurationSchema: z.ZodObject<{
                 outputSchema?: Record<string, unknown> | undefined;
             }[];
             groups: {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }[];
             credentialId?: string | undefined;
         }, {
@@ -1660,10 +1719,10 @@ export declare const botConfigurationSchema: z.ZodObject<{
             url: string;
             toolCount: number;
             groups: {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }[];
             credentialId?: string | undefined;
             definitions?: {
@@ -1728,15 +1787,15 @@ export declare const botConfigurationSchema: z.ZodObject<{
             detail: string;
             syncedLabel: string;
             error?: string | undefined;
+            pages?: {
+                done: number;
+                total: number;
+            } | undefined;
             url?: string | undefined;
             connectedSource?: {
                 accountId: string;
                 resourceId: string;
             } | undefined;
-            pages?: {
-                done: number;
-                total: number;
-            } | undefined;
             progress?: {
                 done: number;
                 total: number;
@@ -1751,16 +1810,16 @@ export declare const botConfigurationSchema: z.ZodObject<{
             detail: string;
             syncedLabel: string;
             error?: string | undefined;
+            pages?: {
+                done: number;
+                total: number;
+            } | undefined;
             url?: string | undefined;
             scope?: "customer" | "project" | undefined;
             connectedSource?: {
                 accountId: string;
                 resourceId: string;
             } | undefined;
-            pages?: {
-                done: number;
-                total: number;
-            } | undefined;
             progress?: {
                 done: number;
                 total: number;
@@ -1791,15 +1850,15 @@ export declare const botConfigurationSchema: z.ZodObject<{
             detail: string;
             syncedLabel: string;
             error?: string | undefined;
+            pages?: {
+                done: number;
+                total: number;
+            } | undefined;
             url?: string | undefined;
             connectedSource?: {
                 accountId: string;
                 resourceId: string;
             } | undefined;
-            pages?: {
-                done: number;
-                total: number;
-            } | undefined;
             progress?: {
                 done: number;
                 total: number;
@@ -1873,10 +1932,10 @@ export declare const botConfigurationSchema: z.ZodObject<{
                 outputSchema?: Record<string, unknown> | undefined;
             }[];
             groups: {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }[];
             credentialId?: string | undefined;
         }[];
@@ -1894,16 +1953,16 @@ export declare const botConfigurationSchema: z.ZodObject<{
             detail: string;
             syncedLabel: string;
             error?: string | undefined;
+            pages?: {
+                done: number;
+                total: number;
+            } | undefined;
             url?: string | undefined;
             scope?: "customer" | "project" | undefined;
             connectedSource?: {
                 accountId: string;
                 resourceId: string;
             } | undefined;
-            pages?: {
-                done: number;
-                total: number;
-            } | undefined;
             progress?: {
                 done: number;
                 total: number;
@@ -1968,10 +2027,10 @@ export declare const botConfigurationSchema: z.ZodObject<{
             url: string;
             toolCount: number;
             groups: {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }[];
             credentialId?: string | undefined;
             definitions?: {
@@ -2001,18 +2060,18 @@ export declare const botConfigurationSchema: z.ZodObject<{
         description: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         type: "Text" | "Number" | "Yes or no" | "One of…";
+        required: boolean;
         name: string;
         description: string;
-        required: boolean;
         defaultValue: string;
         usedIn: ("instructions" | "api" | "run_plan")[];
         chipNote: string;
         values?: string[] | undefined;
     }, {
         type: "Text" | "Number" | "Yes or no" | "One of…";
+        required: boolean;
         name: string;
         description: string;
-        required: boolean;
         defaultValue: string;
         usedIn: ("instructions" | "api" | "run_plan")[];
         chipNote: string;
@@ -2032,20 +2091,20 @@ export declare const botConfigurationSchema: z.ZodObject<{
             values: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             items: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strict", z.ZodTypeAny, {
-            type: "number" | "date" | "text" | "bool" | "enum" | "list" | "group";
+            type: "number" | "date" | "enum" | "text" | "bool" | "list" | "group";
             id: string;
+            required: boolean;
             name: string;
             description: string;
-            required: boolean;
             level: number;
             values?: string[] | undefined;
             items?: Record<string, unknown> | undefined;
         }, {
-            type: "number" | "date" | "text" | "bool" | "enum" | "list" | "group";
+            type: "number" | "date" | "enum" | "text" | "bool" | "list" | "group";
             id: string;
+            required: boolean;
             name: string;
             description: string;
-            required: boolean;
             level: number;
             values?: string[] | undefined;
             items?: Record<string, unknown> | undefined;
@@ -2053,11 +2112,11 @@ export declare const botConfigurationSchema: z.ZodObject<{
         schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strict", z.ZodTypeAny, {
         shape: {
-            type: "number" | "date" | "text" | "bool" | "enum" | "list" | "group";
+            type: "number" | "date" | "enum" | "text" | "bool" | "list" | "group";
             id: string;
+            required: boolean;
             name: string;
             description: string;
-            required: boolean;
             level: number;
             values?: string[] | undefined;
             items?: Record<string, unknown> | undefined;
@@ -2068,11 +2127,11 @@ export declare const botConfigurationSchema: z.ZodObject<{
         schema?: Record<string, unknown> | undefined;
     }, {
         shape: {
-            type: "number" | "date" | "text" | "bool" | "enum" | "list" | "group";
+            type: "number" | "date" | "enum" | "text" | "bool" | "list" | "group";
             id: string;
+            required: boolean;
             name: string;
             description: string;
-            required: boolean;
             level: number;
             values?: string[] | undefined;
             items?: Record<string, unknown> | undefined;
@@ -2107,24 +2166,24 @@ export declare const botConfigurationSchema: z.ZodObject<{
             kind: "workbench" | "mcp" | "app";
             id: string;
             name: string;
+            capabilityId: string;
             bindings: {
                 path: string[];
                 source: "message" | "variable" | "context";
                 target: string[];
             }[];
-            capabilityId: string;
             toolKey: string;
             input: Record<string, unknown>;
         }, {
             kind: "workbench" | "mcp" | "app";
             id: string;
             name: string;
+            capabilityId: string;
             bindings: {
                 path: string[];
                 source: "message" | "variable" | "context";
                 target: string[];
             }[];
-            capabilityId: string;
             toolKey: string;
             input: Record<string, unknown>;
         }>, "many">>;
@@ -2134,40 +2193,40 @@ export declare const botConfigurationSchema: z.ZodObject<{
         stopOnFail: z.ZodArray<z.ZodString, "many">;
         stepLimit: z.ZodEffects<z.ZodNullable<z.ZodNumber>, number, number | null>;
     }, "strict", z.ZodTypeAny, {
+        off: string[];
         before: string[];
         after: string[];
         preparations: {
             kind: "workbench" | "mcp" | "app";
             id: string;
             name: string;
+            capabilityId: string;
             bindings: {
                 path: string[];
                 source: "message" | "variable" | "context";
                 target: string[];
             }[];
-            capabilityId: string;
             toolKey: string;
             input: Record<string, unknown>;
         }[];
-        off: string[];
         stopOnFail: string[];
         stepLimit: number;
     }, {
+        off: string[];
         before: string[];
         after: string[];
-        off: string[];
         stopOnFail: string[];
         stepLimit: number | null;
         preparations?: {
             kind: "workbench" | "mcp" | "app";
             id: string;
             name: string;
+            capabilityId: string;
             bindings: {
                 path: string[];
                 source: "message" | "variable" | "context";
                 target: string[];
             }[];
-            capabilityId: string;
             toolKey: string;
             input: Record<string, unknown>;
         }[] | undefined;
@@ -2197,15 +2256,15 @@ export declare const botConfigurationSchema: z.ZodObject<{
             detail: string;
             syncedLabel: string;
             error?: string | undefined;
+            pages?: {
+                done: number;
+                total: number;
+            } | undefined;
             url?: string | undefined;
             connectedSource?: {
                 accountId: string;
                 resourceId: string;
             } | undefined;
-            pages?: {
-                done: number;
-                total: number;
-            } | undefined;
             progress?: {
                 done: number;
                 total: number;
@@ -2279,10 +2338,10 @@ export declare const botConfigurationSchema: z.ZodObject<{
                 outputSchema?: Record<string, unknown> | undefined;
             }[];
             groups: {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }[];
             credentialId?: string | undefined;
         }[];
@@ -2306,13 +2365,13 @@ export declare const botConfigurationSchema: z.ZodObject<{
     };
     model: {
         id: string;
-        effort: "low" | "medium" | "high";
+        effort: "low" | "medium" | "high" | "xhigh";
     };
     variables: {
         type: "Text" | "Number" | "Yes or no" | "One of…";
+        required: boolean;
         name: string;
         description: string;
-        required: boolean;
         defaultValue: string;
         usedIn: ("instructions" | "api" | "run_plan")[];
         chipNote: string;
@@ -2347,11 +2406,11 @@ export declare const botConfigurationSchema: z.ZodObject<{
     }[];
     answer: {
         shape: {
-            type: "number" | "date" | "text" | "bool" | "enum" | "list" | "group";
+            type: "number" | "date" | "enum" | "text" | "bool" | "list" | "group";
             id: string;
+            required: boolean;
             name: string;
             description: string;
-            required: boolean;
             level: number;
             values?: string[] | undefined;
             items?: Record<string, unknown> | undefined;
@@ -2362,22 +2421,22 @@ export declare const botConfigurationSchema: z.ZodObject<{
         schema?: Record<string, unknown> | undefined;
     };
     runPlan: {
+        off: string[];
         before: string[];
         after: string[];
         preparations: {
             kind: "workbench" | "mcp" | "app";
             id: string;
             name: string;
+            capabilityId: string;
             bindings: {
                 path: string[];
                 source: "message" | "variable" | "context";
                 target: string[];
             }[];
-            capabilityId: string;
             toolKey: string;
             input: Record<string, unknown>;
         }[];
-        off: string[];
         stopOnFail: string[];
         stepLimit: number;
     };
@@ -2424,6 +2483,7 @@ export declare const botConfigurationSchema: z.ZodObject<{
         timezone: string;
         customerId: string;
     })[];
+    timezone?: string | null | undefined;
 }, {
     name: string;
     workbench: {
@@ -2448,16 +2508,16 @@ export declare const botConfigurationSchema: z.ZodObject<{
             detail: string;
             syncedLabel: string;
             error?: string | undefined;
+            pages?: {
+                done: number;
+                total: number;
+            } | undefined;
             url?: string | undefined;
             scope?: "customer" | "project" | undefined;
             connectedSource?: {
                 accountId: string;
                 resourceId: string;
             } | undefined;
-            pages?: {
-                done: number;
-                total: number;
-            } | undefined;
             progress?: {
                 done: number;
                 total: number;
@@ -2522,10 +2582,10 @@ export declare const botConfigurationSchema: z.ZodObject<{
             url: string;
             toolCount: number;
             groups: {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }[];
             credentialId?: string | undefined;
             definitions?: {
@@ -2558,13 +2618,13 @@ export declare const botConfigurationSchema: z.ZodObject<{
     };
     model: {
         id: string;
-        effort: "low" | "medium" | "high";
+        effort: "low" | "medium" | "high" | "xhigh";
     };
     variables: {
         type: "Text" | "Number" | "Yes or no" | "One of…";
+        required: boolean;
         name: string;
         description: string;
-        required: boolean;
         defaultValue: string;
         usedIn: ("instructions" | "api" | "run_plan")[];
         chipNote: string;
@@ -2599,11 +2659,11 @@ export declare const botConfigurationSchema: z.ZodObject<{
     }[];
     answer: {
         shape: {
-            type: "number" | "date" | "text" | "bool" | "enum" | "list" | "group";
+            type: "number" | "date" | "enum" | "text" | "bool" | "list" | "group";
             id: string;
+            required: boolean;
             name: string;
             description: string;
-            required: boolean;
             level: number;
             values?: string[] | undefined;
             items?: Record<string, unknown> | undefined;
@@ -2614,25 +2674,26 @@ export declare const botConfigurationSchema: z.ZodObject<{
         schema?: Record<string, unknown> | undefined;
     };
     runPlan: {
+        off: string[];
         before: string[];
         after: string[];
-        off: string[];
         stopOnFail: string[];
         stepLimit: number | null;
         preparations?: {
             kind: "workbench" | "mcp" | "app";
             id: string;
             name: string;
+            capabilityId: string;
             bindings: {
                 path: string[];
                 source: "message" | "variable" | "context";
                 target: string[];
             }[];
-            capabilityId: string;
             toolKey: string;
             input: Record<string, unknown>;
         }[] | undefined;
     };
+    timezone?: string | null | undefined;
     triggers?: ({
         kind: "app";
         id: string;
@@ -2679,6 +2740,7 @@ export declare const botConfigurationSchema: z.ZodObject<{
 }>;
 export declare const botPatchSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodString, string, string>>>>;
     triggers: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
         kind: z.ZodLiteral<"app">;
         subscriptionId: z.ZodString;
@@ -2808,13 +2870,13 @@ export declare const botPatchSchema: z.ZodObject<{
     }>]>, "many">>>;
     model: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
-        effort: z.ZodEnum<["low", "medium", "high"]>;
+        effort: z.ZodEnum<["low", "medium", "high", "xhigh"]>;
     }, "strict", z.ZodTypeAny, {
         id: string;
-        effort: "low" | "medium" | "high";
+        effort: "low" | "medium" | "high" | "xhigh";
     }, {
         id: string;
-        effort: "low" | "medium" | "high";
+        effort: "low" | "medium" | "high" | "xhigh";
     }>>;
     instructions: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
@@ -3247,15 +3309,15 @@ export declare const botPatchSchema: z.ZodObject<{
                 rule: z.ZodEnum<["allow", "ask", "block"]>;
                 tools: z.ZodArray<z.ZodString, "many">;
             }, "strict", z.ZodTypeAny, {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }, {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }>, "many">;
         }, "strict", z.ZodTypeAny, {
             status: "connecting" | "connected";
@@ -3270,10 +3332,10 @@ export declare const botPatchSchema: z.ZodObject<{
                 outputSchema?: Record<string, unknown> | undefined;
             }[];
             groups: {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }[];
             credentialId?: string | undefined;
         }, {
@@ -3283,10 +3345,10 @@ export declare const botPatchSchema: z.ZodObject<{
             url: string;
             toolCount: number;
             groups: {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }[];
             credentialId?: string | undefined;
             definitions?: {
@@ -3351,15 +3413,15 @@ export declare const botPatchSchema: z.ZodObject<{
             detail: string;
             syncedLabel: string;
             error?: string | undefined;
+            pages?: {
+                done: number;
+                total: number;
+            } | undefined;
             url?: string | undefined;
             connectedSource?: {
                 accountId: string;
                 resourceId: string;
             } | undefined;
-            pages?: {
-                done: number;
-                total: number;
-            } | undefined;
             progress?: {
                 done: number;
                 total: number;
@@ -3374,16 +3436,16 @@ export declare const botPatchSchema: z.ZodObject<{
             detail: string;
             syncedLabel: string;
             error?: string | undefined;
+            pages?: {
+                done: number;
+                total: number;
+            } | undefined;
             url?: string | undefined;
             scope?: "customer" | "project" | undefined;
             connectedSource?: {
                 accountId: string;
                 resourceId: string;
             } | undefined;
-            pages?: {
-                done: number;
-                total: number;
-            } | undefined;
             progress?: {
                 done: number;
                 total: number;
@@ -3414,15 +3476,15 @@ export declare const botPatchSchema: z.ZodObject<{
             detail: string;
             syncedLabel: string;
             error?: string | undefined;
+            pages?: {
+                done: number;
+                total: number;
+            } | undefined;
             url?: string | undefined;
             connectedSource?: {
                 accountId: string;
                 resourceId: string;
             } | undefined;
-            pages?: {
-                done: number;
-                total: number;
-            } | undefined;
             progress?: {
                 done: number;
                 total: number;
@@ -3496,10 +3558,10 @@ export declare const botPatchSchema: z.ZodObject<{
                 outputSchema?: Record<string, unknown> | undefined;
             }[];
             groups: {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }[];
             credentialId?: string | undefined;
         }[];
@@ -3517,16 +3579,16 @@ export declare const botPatchSchema: z.ZodObject<{
             detail: string;
             syncedLabel: string;
             error?: string | undefined;
+            pages?: {
+                done: number;
+                total: number;
+            } | undefined;
             url?: string | undefined;
             scope?: "customer" | "project" | undefined;
             connectedSource?: {
                 accountId: string;
                 resourceId: string;
             } | undefined;
-            pages?: {
-                done: number;
-                total: number;
-            } | undefined;
             progress?: {
                 done: number;
                 total: number;
@@ -3591,10 +3653,10 @@ export declare const botPatchSchema: z.ZodObject<{
             url: string;
             toolCount: number;
             groups: {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }[];
             credentialId?: string | undefined;
             definitions?: {
@@ -3624,18 +3686,18 @@ export declare const botPatchSchema: z.ZodObject<{
         description: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         type: "Text" | "Number" | "Yes or no" | "One of…";
+        required: boolean;
         name: string;
         description: string;
-        required: boolean;
         defaultValue: string;
         usedIn: ("instructions" | "api" | "run_plan")[];
         chipNote: string;
         values?: string[] | undefined;
     }, {
         type: "Text" | "Number" | "Yes or no" | "One of…";
+        required: boolean;
         name: string;
         description: string;
-        required: boolean;
         defaultValue: string;
         usedIn: ("instructions" | "api" | "run_plan")[];
         chipNote: string;
@@ -3655,20 +3717,20 @@ export declare const botPatchSchema: z.ZodObject<{
             values: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             items: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strict", z.ZodTypeAny, {
-            type: "number" | "date" | "text" | "bool" | "enum" | "list" | "group";
+            type: "number" | "date" | "enum" | "text" | "bool" | "list" | "group";
             id: string;
+            required: boolean;
             name: string;
             description: string;
-            required: boolean;
             level: number;
             values?: string[] | undefined;
             items?: Record<string, unknown> | undefined;
         }, {
-            type: "number" | "date" | "text" | "bool" | "enum" | "list" | "group";
+            type: "number" | "date" | "enum" | "text" | "bool" | "list" | "group";
             id: string;
+            required: boolean;
             name: string;
             description: string;
-            required: boolean;
             level: number;
             values?: string[] | undefined;
             items?: Record<string, unknown> | undefined;
@@ -3676,11 +3738,11 @@ export declare const botPatchSchema: z.ZodObject<{
         schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strict", z.ZodTypeAny, {
         shape: {
-            type: "number" | "date" | "text" | "bool" | "enum" | "list" | "group";
+            type: "number" | "date" | "enum" | "text" | "bool" | "list" | "group";
             id: string;
+            required: boolean;
             name: string;
             description: string;
-            required: boolean;
             level: number;
             values?: string[] | undefined;
             items?: Record<string, unknown> | undefined;
@@ -3691,11 +3753,11 @@ export declare const botPatchSchema: z.ZodObject<{
         schema?: Record<string, unknown> | undefined;
     }, {
         shape: {
-            type: "number" | "date" | "text" | "bool" | "enum" | "list" | "group";
+            type: "number" | "date" | "enum" | "text" | "bool" | "list" | "group";
             id: string;
+            required: boolean;
             name: string;
             description: string;
-            required: boolean;
             level: number;
             values?: string[] | undefined;
             items?: Record<string, unknown> | undefined;
@@ -3730,24 +3792,24 @@ export declare const botPatchSchema: z.ZodObject<{
             kind: "workbench" | "mcp" | "app";
             id: string;
             name: string;
+            capabilityId: string;
             bindings: {
                 path: string[];
                 source: "message" | "variable" | "context";
                 target: string[];
             }[];
-            capabilityId: string;
             toolKey: string;
             input: Record<string, unknown>;
         }, {
             kind: "workbench" | "mcp" | "app";
             id: string;
             name: string;
+            capabilityId: string;
             bindings: {
                 path: string[];
                 source: "message" | "variable" | "context";
                 target: string[];
             }[];
-            capabilityId: string;
             toolKey: string;
             input: Record<string, unknown>;
         }>, "many">>;
@@ -3757,40 +3819,40 @@ export declare const botPatchSchema: z.ZodObject<{
         stopOnFail: z.ZodArray<z.ZodString, "many">;
         stepLimit: z.ZodEffects<z.ZodNullable<z.ZodNumber>, number, number | null>;
     }, "strict", z.ZodTypeAny, {
+        off: string[];
         before: string[];
         after: string[];
         preparations: {
             kind: "workbench" | "mcp" | "app";
             id: string;
             name: string;
+            capabilityId: string;
             bindings: {
                 path: string[];
                 source: "message" | "variable" | "context";
                 target: string[];
             }[];
-            capabilityId: string;
             toolKey: string;
             input: Record<string, unknown>;
         }[];
-        off: string[];
         stopOnFail: string[];
         stepLimit: number;
     }, {
+        off: string[];
         before: string[];
         after: string[];
-        off: string[];
         stopOnFail: string[];
         stepLimit: number | null;
         preparations?: {
             kind: "workbench" | "mcp" | "app";
             id: string;
             name: string;
+            capabilityId: string;
             bindings: {
                 path: string[];
                 source: "message" | "variable" | "context";
                 target: string[];
             }[];
-            capabilityId: string;
             toolKey: string;
             input: Record<string, unknown>;
         }[] | undefined;
@@ -3820,15 +3882,15 @@ export declare const botPatchSchema: z.ZodObject<{
             detail: string;
             syncedLabel: string;
             error?: string | undefined;
+            pages?: {
+                done: number;
+                total: number;
+            } | undefined;
             url?: string | undefined;
             connectedSource?: {
                 accountId: string;
                 resourceId: string;
             } | undefined;
-            pages?: {
-                done: number;
-                total: number;
-            } | undefined;
             progress?: {
                 done: number;
                 total: number;
@@ -3902,10 +3964,10 @@ export declare const botPatchSchema: z.ZodObject<{
                 outputSchema?: Record<string, unknown> | undefined;
             }[];
             groups: {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }[];
             credentialId?: string | undefined;
         }[];
@@ -3929,18 +3991,19 @@ export declare const botPatchSchema: z.ZodObject<{
     } | undefined;
     model?: {
         id: string;
-        effort: "low" | "medium" | "high";
+        effort: "low" | "medium" | "high" | "xhigh";
     } | undefined;
     variables?: {
         type: "Text" | "Number" | "Yes or no" | "One of…";
+        required: boolean;
         name: string;
         description: string;
-        required: boolean;
         defaultValue: string;
         usedIn: ("instructions" | "api" | "run_plan")[];
         chipNote: string;
         values?: string[] | undefined;
     }[] | undefined;
+    timezone?: string | null | undefined;
     skills?: {
         id: string;
         name: string;
@@ -3970,11 +4033,11 @@ export declare const botPatchSchema: z.ZodObject<{
     }[] | undefined;
     answer?: {
         shape: {
-            type: "number" | "date" | "text" | "bool" | "enum" | "list" | "group";
+            type: "number" | "date" | "enum" | "text" | "bool" | "list" | "group";
             id: string;
+            required: boolean;
             name: string;
             description: string;
-            required: boolean;
             level: number;
             values?: string[] | undefined;
             items?: Record<string, unknown> | undefined;
@@ -3985,22 +4048,22 @@ export declare const botPatchSchema: z.ZodObject<{
         schema?: Record<string, unknown> | undefined;
     } | undefined;
     runPlan?: {
+        off: string[];
         before: string[];
         after: string[];
         preparations: {
             kind: "workbench" | "mcp" | "app";
             id: string;
             name: string;
+            capabilityId: string;
             bindings: {
                 path: string[];
                 source: "message" | "variable" | "context";
                 target: string[];
             }[];
-            capabilityId: string;
             toolKey: string;
             input: Record<string, unknown>;
         }[];
-        off: string[];
         stopOnFail: string[];
         stepLimit: number;
     } | undefined;
@@ -4071,16 +4134,16 @@ export declare const botPatchSchema: z.ZodObject<{
             detail: string;
             syncedLabel: string;
             error?: string | undefined;
+            pages?: {
+                done: number;
+                total: number;
+            } | undefined;
             url?: string | undefined;
             scope?: "customer" | "project" | undefined;
             connectedSource?: {
                 accountId: string;
                 resourceId: string;
             } | undefined;
-            pages?: {
-                done: number;
-                total: number;
-            } | undefined;
             progress?: {
                 done: number;
                 total: number;
@@ -4145,10 +4208,10 @@ export declare const botPatchSchema: z.ZodObject<{
             url: string;
             toolCount: number;
             groups: {
+                tools: string[];
                 name: "Read" | "Change" | "Delete";
                 count: number;
                 rule: "allow" | "ask" | "block";
-                tools: string[];
             }[];
             credentialId?: string | undefined;
             definitions?: {
@@ -4181,18 +4244,19 @@ export declare const botPatchSchema: z.ZodObject<{
     } | undefined;
     model?: {
         id: string;
-        effort: "low" | "medium" | "high";
+        effort: "low" | "medium" | "high" | "xhigh";
     } | undefined;
     variables?: {
         type: "Text" | "Number" | "Yes or no" | "One of…";
+        required: boolean;
         name: string;
         description: string;
-        required: boolean;
         defaultValue: string;
         usedIn: ("instructions" | "api" | "run_plan")[];
         chipNote: string;
         values?: string[] | undefined;
     }[] | undefined;
+    timezone?: string | null | undefined;
     skills?: {
         id: string;
         name: string;
@@ -4222,11 +4286,11 @@ export declare const botPatchSchema: z.ZodObject<{
     }[] | undefined;
     answer?: {
         shape: {
-            type: "number" | "date" | "text" | "bool" | "enum" | "list" | "group";
+            type: "number" | "date" | "enum" | "text" | "bool" | "list" | "group";
             id: string;
+            required: boolean;
             name: string;
             description: string;
-            required: boolean;
             level: number;
             values?: string[] | undefined;
             items?: Record<string, unknown> | undefined;
@@ -4237,21 +4301,21 @@ export declare const botPatchSchema: z.ZodObject<{
         schema?: Record<string, unknown> | undefined;
     } | undefined;
     runPlan?: {
+        off: string[];
         before: string[];
         after: string[];
-        off: string[];
         stopOnFail: string[];
         stepLimit: number | null;
         preparations?: {
             kind: "workbench" | "mcp" | "app";
             id: string;
             name: string;
+            capabilityId: string;
             bindings: {
                 path: string[];
                 source: "message" | "variable" | "context";
                 target: string[];
             }[];
-            capabilityId: string;
             toolKey: string;
             input: Record<string, unknown>;
         }[] | undefined;
@@ -4308,6 +4372,7 @@ export declare const botRunInputSchema: z.ZodObject<{
     revision: z.ZodOptional<z.ZodNumber>;
     dataMode: z.ZodDefault<z.ZodEnum<["sample", "live"]>>;
     customerSessionId: z.ZodOptional<z.ZodString>;
+    connectionReturnUrl: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     message: string;
     variables: Record<string, unknown>;
@@ -4316,6 +4381,7 @@ export declare const botRunInputSchema: z.ZodObject<{
     runId?: string | undefined;
     conversationId?: string | undefined;
     customerSessionId?: string | undefined;
+    connectionReturnUrl?: string | undefined;
 }, {
     message: string;
     revision?: number | undefined;
@@ -4324,6 +4390,7 @@ export declare const botRunInputSchema: z.ZodObject<{
     conversationId?: string | undefined;
     dataMode?: "sample" | "live" | undefined;
     customerSessionId?: string | undefined;
+    connectionReturnUrl?: string | undefined;
 }>;
 export declare function defaultBotConfiguration(name: string): BotConfiguration;
 /** Infer only structural JSON types; values are never classified by their text. */