@yaklabs-ai/plugin-protocol 0.53.0 → 0.54.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +1 -1
  2. package/THIRD-PARTY-INVENTORY.json +1 -1
  3. package/dist/index.d.ts +413 -6
  4. package/dist/index.js +507 -378
  5. package/package.json +1 -1
package/dist/index.d.ts CHANGED
@@ -2542,6 +2542,7 @@ declare const canonicalContributionSchemas: {
2542
2542
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
2543
2543
  }, z.core.$strict>>;
2544
2544
  localId: z.ZodString;
2545
+ adapterId: z.ZodOptional<z.ZodString>;
2545
2546
  schemes: z.ZodArray<z.ZodString>;
2546
2547
  displayName: z.ZodOptional<z.ZodString>;
2547
2548
  }, z.core.$strict>;
@@ -3223,6 +3224,13 @@ declare const canonicalContributionSchemas: {
3223
3224
  }, z.core.$strict>;
3224
3225
  KayUiAppHostCapability: z.ZodEnum<{
3225
3226
  "navigation.open-session": "navigation.open-session";
3227
+ "navigation.open-external": "navigation.open-external";
3228
+ "configuration.read": "configuration.read";
3229
+ "auth-services.read": "auth-services.read";
3230
+ "connect-flows.read": "connect-flows.read";
3231
+ "connect-flows.dismiss": "connect-flows.dismiss";
3232
+ "support.report": "support.report";
3233
+ "navigation.open-page": "navigation.open-page";
3226
3234
  "sessions.create": "sessions.create";
3227
3235
  "models.complete": "models.complete";
3228
3236
  "artifacts.read": "artifacts.read";
@@ -3230,6 +3238,10 @@ declare const canonicalContributionSchemas: {
3230
3238
  "markdown.document-view": "markdown.document-view";
3231
3239
  "references.open": "references.open";
3232
3240
  "billing.read": "billing.read";
3241
+ "account.read": "account.read";
3242
+ "plugins.read": "plugins.read";
3243
+ "plugins.settings": "plugins.settings";
3244
+ "permissions.manage": "permissions.manage";
3233
3245
  "automations.read": "automations.read";
3234
3246
  "automations.run": "automations.run";
3235
3247
  "shared-artifacts.read": "shared-artifacts.read";
@@ -3249,6 +3261,13 @@ declare const canonicalContributionSchemas: {
3249
3261
  }, z.core.$strict>]>>>;
3250
3262
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
3251
3263
  "navigation.open-session": "navigation.open-session";
3264
+ "navigation.open-external": "navigation.open-external";
3265
+ "configuration.read": "configuration.read";
3266
+ "auth-services.read": "auth-services.read";
3267
+ "connect-flows.read": "connect-flows.read";
3268
+ "connect-flows.dismiss": "connect-flows.dismiss";
3269
+ "support.report": "support.report";
3270
+ "navigation.open-page": "navigation.open-page";
3252
3271
  "sessions.create": "sessions.create";
3253
3272
  "models.complete": "models.complete";
3254
3273
  "artifacts.read": "artifacts.read";
@@ -3256,6 +3275,10 @@ declare const canonicalContributionSchemas: {
3256
3275
  "markdown.document-view": "markdown.document-view";
3257
3276
  "references.open": "references.open";
3258
3277
  "billing.read": "billing.read";
3278
+ "account.read": "account.read";
3279
+ "plugins.read": "plugins.read";
3280
+ "plugins.settings": "plugins.settings";
3281
+ "permissions.manage": "permissions.manage";
3259
3282
  "automations.read": "automations.read";
3260
3283
  "automations.run": "automations.run";
3261
3284
  "shared-artifacts.read": "shared-artifacts.read";
@@ -3313,6 +3336,9 @@ declare const canonicalContributionSchemas: {
3313
3336
  session: "session";
3314
3337
  family: "family";
3315
3338
  }>>;
3339
+ settings: z.ZodOptional<z.ZodObject<{
3340
+ order: z.ZodOptional<z.ZodNumber>;
3341
+ }, z.core.$strict>>;
3316
3342
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
3317
3343
  openedEvent: z.ZodOptional<z.ZodString>;
3318
3344
  }, z.core.$strict>;
@@ -3339,6 +3365,13 @@ declare const canonicalContributionSchemas: {
3339
3365
  }, z.core.$strict>]>>>;
3340
3366
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
3341
3367
  "navigation.open-session": "navigation.open-session";
3368
+ "navigation.open-external": "navigation.open-external";
3369
+ "configuration.read": "configuration.read";
3370
+ "auth-services.read": "auth-services.read";
3371
+ "connect-flows.read": "connect-flows.read";
3372
+ "connect-flows.dismiss": "connect-flows.dismiss";
3373
+ "support.report": "support.report";
3374
+ "navigation.open-page": "navigation.open-page";
3342
3375
  "sessions.create": "sessions.create";
3343
3376
  "models.complete": "models.complete";
3344
3377
  "artifacts.read": "artifacts.read";
@@ -3346,6 +3379,10 @@ declare const canonicalContributionSchemas: {
3346
3379
  "markdown.document-view": "markdown.document-view";
3347
3380
  "references.open": "references.open";
3348
3381
  "billing.read": "billing.read";
3382
+ "account.read": "account.read";
3383
+ "plugins.read": "plugins.read";
3384
+ "plugins.settings": "plugins.settings";
3385
+ "permissions.manage": "permissions.manage";
3349
3386
  "automations.read": "automations.read";
3350
3387
  "automations.run": "automations.run";
3351
3388
  "shared-artifacts.read": "shared-artifacts.read";
@@ -3382,6 +3419,13 @@ declare const canonicalContributionSchemas: {
3382
3419
  }, z.core.$strict>]>>>;
3383
3420
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
3384
3421
  "navigation.open-session": "navigation.open-session";
3422
+ "navigation.open-external": "navigation.open-external";
3423
+ "configuration.read": "configuration.read";
3424
+ "auth-services.read": "auth-services.read";
3425
+ "connect-flows.read": "connect-flows.read";
3426
+ "connect-flows.dismiss": "connect-flows.dismiss";
3427
+ "support.report": "support.report";
3428
+ "navigation.open-page": "navigation.open-page";
3385
3429
  "sessions.create": "sessions.create";
3386
3430
  "models.complete": "models.complete";
3387
3431
  "artifacts.read": "artifacts.read";
@@ -3389,6 +3433,10 @@ declare const canonicalContributionSchemas: {
3389
3433
  "markdown.document-view": "markdown.document-view";
3390
3434
  "references.open": "references.open";
3391
3435
  "billing.read": "billing.read";
3436
+ "account.read": "account.read";
3437
+ "plugins.read": "plugins.read";
3438
+ "plugins.settings": "plugins.settings";
3439
+ "permissions.manage": "permissions.manage";
3392
3440
  "automations.read": "automations.read";
3393
3441
  "automations.run": "automations.run";
3394
3442
  "shared-artifacts.read": "shared-artifacts.read";
@@ -4841,8 +4889,12 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
4841
4889
  * 0.53.0 adds declared working-content layouts, family-root authority, draft projection discovery
4842
4890
  * and session-bound page references. Older customized Whiteboard copies must accept the plugin
4843
4891
  * update before using these interfaces.
4892
+ *
4893
+ * 0.54.0 adds named UI host grants for shared configuration/auth/account reads, retained connection
4894
+ * progress/dismissal and support. Built-in-only page capability scopes are removed; executable
4895
+ * pages declare capabilities on apps[].
4844
4896
  */
4845
- export declare const KAY_PLUGIN_SDK_VERSION: "0.53.0";
4897
+ export declare const KAY_PLUGIN_SDK_VERSION: "0.54.0";
4846
4898
 
4847
4899
  export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
4848
4900
 
@@ -5116,6 +5168,7 @@ export declare const KayAgentTargetManifest: z.ZodObject<{
5116
5168
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
5117
5169
  }, z.core.$strict>>;
5118
5170
  localId: z.ZodString;
5171
+ adapterId: z.ZodOptional<z.ZodString>;
5119
5172
  schemes: z.ZodArray<z.ZodString>;
5120
5173
  displayName: z.ZodOptional<z.ZodString>;
5121
5174
  }, z.core.$strict>>>;
@@ -6049,6 +6102,7 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6049
6102
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
6050
6103
  }, z.core.$strict>>;
6051
6104
  localId: z.ZodString;
6105
+ adapterId: z.ZodOptional<z.ZodString>;
6052
6106
  schemes: z.ZodArray<z.ZodString>;
6053
6107
  displayName: z.ZodOptional<z.ZodString>;
6054
6108
  }, z.core.$strict>>>;
@@ -6779,6 +6833,13 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6779
6833
  }, z.core.$strict>]>>>;
6780
6834
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
6781
6835
  "navigation.open-session": "navigation.open-session";
6836
+ "navigation.open-external": "navigation.open-external";
6837
+ "configuration.read": "configuration.read";
6838
+ "auth-services.read": "auth-services.read";
6839
+ "connect-flows.read": "connect-flows.read";
6840
+ "connect-flows.dismiss": "connect-flows.dismiss";
6841
+ "support.report": "support.report";
6842
+ "navigation.open-page": "navigation.open-page";
6782
6843
  "sessions.create": "sessions.create";
6783
6844
  "models.complete": "models.complete";
6784
6845
  "artifacts.read": "artifacts.read";
@@ -6786,6 +6847,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6786
6847
  "markdown.document-view": "markdown.document-view";
6787
6848
  "references.open": "references.open";
6788
6849
  "billing.read": "billing.read";
6850
+ "account.read": "account.read";
6851
+ "plugins.read": "plugins.read";
6852
+ "plugins.settings": "plugins.settings";
6853
+ "permissions.manage": "permissions.manage";
6789
6854
  "automations.read": "automations.read";
6790
6855
  "automations.run": "automations.run";
6791
6856
  "shared-artifacts.read": "shared-artifacts.read";
@@ -6822,6 +6887,13 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6822
6887
  }, z.core.$strict>]>>>;
6823
6888
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
6824
6889
  "navigation.open-session": "navigation.open-session";
6890
+ "navigation.open-external": "navigation.open-external";
6891
+ "configuration.read": "configuration.read";
6892
+ "auth-services.read": "auth-services.read";
6893
+ "connect-flows.read": "connect-flows.read";
6894
+ "connect-flows.dismiss": "connect-flows.dismiss";
6895
+ "support.report": "support.report";
6896
+ "navigation.open-page": "navigation.open-page";
6825
6897
  "sessions.create": "sessions.create";
6826
6898
  "models.complete": "models.complete";
6827
6899
  "artifacts.read": "artifacts.read";
@@ -6829,6 +6901,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6829
6901
  "markdown.document-view": "markdown.document-view";
6830
6902
  "references.open": "references.open";
6831
6903
  "billing.read": "billing.read";
6904
+ "account.read": "account.read";
6905
+ "plugins.read": "plugins.read";
6906
+ "plugins.settings": "plugins.settings";
6907
+ "permissions.manage": "permissions.manage";
6832
6908
  "automations.read": "automations.read";
6833
6909
  "automations.run": "automations.run";
6834
6910
  "shared-artifacts.read": "shared-artifacts.read";
@@ -6887,6 +6963,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6887
6963
  session: "session";
6888
6964
  family: "family";
6889
6965
  }>>;
6966
+ settings: z.ZodOptional<z.ZodObject<{
6967
+ order: z.ZodOptional<z.ZodNumber>;
6968
+ }, z.core.$strict>>;
6890
6969
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
6891
6970
  openedEvent: z.ZodOptional<z.ZodString>;
6892
6971
  }, z.core.$strict>>>;
@@ -6915,8 +6994,8 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6915
6994
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
6916
6995
  defaults: z.ZodOptional<z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
6917
6996
  scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
6918
- global: "global";
6919
6997
  project: "project";
6998
+ global: "global";
6920
6999
  agent: "agent";
6921
7000
  }>>>;
6922
7001
  }, z.core.$strict>>>;
@@ -6945,6 +7024,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6945
7024
  endpoint: z.ZodString;
6946
7025
  usage: z.ZodString;
6947
7026
  }, z.core.$strict>>>;
7027
+ projectDirectories: z.ZodOptional<z.ZodObject<{
7028
+ endpoint: z.ZodString;
7029
+ scheme: z.ZodString;
7030
+ }, z.core.$strict>>;
6948
7031
  auth: z.ZodOptional<z.ZodObject<{
6949
7032
  services: z.ZodOptional<z.ZodArray<z.ZodObject<{
6950
7033
  localId: z.ZodString;
@@ -6988,7 +7071,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6988
7071
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
6989
7072
  authorizationUrl: z.ZodURL;
6990
7073
  tokenUrl: z.ZodURL;
7074
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
6991
7075
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7076
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6992
7077
  displayName: z.ZodOptional<z.ZodString>;
6993
7078
  agentHint: z.ZodOptional<z.ZodString>;
6994
7079
  summary: z.ZodOptional<z.ZodString>;
@@ -7015,7 +7100,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
7015
7100
  account: z.ZodUnion<readonly [z.ZodLiteral<"lookup">, z.ZodLiteral<"sign-in">]>;
7016
7101
  authorizationUrl: z.ZodURL;
7017
7102
  tokenUrl: z.ZodURL;
7103
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
7018
7104
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7105
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7019
7106
  displayName: z.ZodOptional<z.ZodString>;
7020
7107
  agentHint: z.ZodOptional<z.ZodString>;
7021
7108
  summary: z.ZodOptional<z.ZodString>;
@@ -7824,6 +7911,13 @@ export declare interface KayPluginTreeReader {
7824
7911
 
7825
7912
  export declare const KayUiAppHostCapability: z.ZodEnum<{
7826
7913
  "navigation.open-session": "navigation.open-session";
7914
+ "navigation.open-external": "navigation.open-external";
7915
+ "configuration.read": "configuration.read";
7916
+ "auth-services.read": "auth-services.read";
7917
+ "connect-flows.read": "connect-flows.read";
7918
+ "connect-flows.dismiss": "connect-flows.dismiss";
7919
+ "support.report": "support.report";
7920
+ "navigation.open-page": "navigation.open-page";
7827
7921
  "sessions.create": "sessions.create";
7828
7922
  "models.complete": "models.complete";
7829
7923
  "artifacts.read": "artifacts.read";
@@ -7831,6 +7925,10 @@ export declare const KayUiAppHostCapability: z.ZodEnum<{
7831
7925
  "markdown.document-view": "markdown.document-view";
7832
7926
  "references.open": "references.open";
7833
7927
  "billing.read": "billing.read";
7928
+ "account.read": "account.read";
7929
+ "plugins.read": "plugins.read";
7930
+ "plugins.settings": "plugins.settings";
7931
+ "permissions.manage": "permissions.manage";
7834
7932
  "automations.read": "automations.read";
7835
7933
  "automations.run": "automations.run";
7836
7934
  "shared-artifacts.read": "shared-artifacts.read";
@@ -8104,6 +8202,13 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8104
8202
  }, z.core.$strict>]>>>;
8105
8203
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
8106
8204
  "navigation.open-session": "navigation.open-session";
8205
+ "navigation.open-external": "navigation.open-external";
8206
+ "configuration.read": "configuration.read";
8207
+ "auth-services.read": "auth-services.read";
8208
+ "connect-flows.read": "connect-flows.read";
8209
+ "connect-flows.dismiss": "connect-flows.dismiss";
8210
+ "support.report": "support.report";
8211
+ "navigation.open-page": "navigation.open-page";
8107
8212
  "sessions.create": "sessions.create";
8108
8213
  "models.complete": "models.complete";
8109
8214
  "artifacts.read": "artifacts.read";
@@ -8111,6 +8216,10 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8111
8216
  "markdown.document-view": "markdown.document-view";
8112
8217
  "references.open": "references.open";
8113
8218
  "billing.read": "billing.read";
8219
+ "account.read": "account.read";
8220
+ "plugins.read": "plugins.read";
8221
+ "plugins.settings": "plugins.settings";
8222
+ "permissions.manage": "permissions.manage";
8114
8223
  "automations.read": "automations.read";
8115
8224
  "automations.run": "automations.run";
8116
8225
  "shared-artifacts.read": "shared-artifacts.read";
@@ -8147,6 +8256,13 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8147
8256
  }, z.core.$strict>]>>>;
8148
8257
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
8149
8258
  "navigation.open-session": "navigation.open-session";
8259
+ "navigation.open-external": "navigation.open-external";
8260
+ "configuration.read": "configuration.read";
8261
+ "auth-services.read": "auth-services.read";
8262
+ "connect-flows.read": "connect-flows.read";
8263
+ "connect-flows.dismiss": "connect-flows.dismiss";
8264
+ "support.report": "support.report";
8265
+ "navigation.open-page": "navigation.open-page";
8150
8266
  "sessions.create": "sessions.create";
8151
8267
  "models.complete": "models.complete";
8152
8268
  "artifacts.read": "artifacts.read";
@@ -8154,6 +8270,10 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8154
8270
  "markdown.document-view": "markdown.document-view";
8155
8271
  "references.open": "references.open";
8156
8272
  "billing.read": "billing.read";
8273
+ "account.read": "account.read";
8274
+ "plugins.read": "plugins.read";
8275
+ "plugins.settings": "plugins.settings";
8276
+ "permissions.manage": "permissions.manage";
8157
8277
  "automations.read": "automations.read";
8158
8278
  "automations.run": "automations.run";
8159
8279
  "shared-artifacts.read": "shared-artifacts.read";
@@ -8212,6 +8332,9 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8212
8332
  session: "session";
8213
8333
  family: "family";
8214
8334
  }>>;
8335
+ settings: z.ZodOptional<z.ZodObject<{
8336
+ order: z.ZodOptional<z.ZodNumber>;
8337
+ }, z.core.$strict>>;
8215
8338
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
8216
8339
  openedEvent: z.ZodOptional<z.ZodString>;
8217
8340
  }, z.core.$strict>>>;
@@ -8274,6 +8397,9 @@ export declare const McpServerAuthMode: z.ZodEnum<{
8274
8397
 
8275
8398
  export declare type McpServerAuthMode = z.infer<typeof McpServerAuthMode>;
8276
8399
 
8400
+ /** The connection state published for one configured MCP server. */
8401
+ export declare type McpServerConnectionState = "disconnected" | "connecting" | "connected" | "needs-auth" | "failed";
8402
+
8277
8403
  export declare const McpServerContribution: z.ZodObject<{
8278
8404
  url: z.ZodString;
8279
8405
  auth: z.ZodOptional<z.ZodEnum<{
@@ -8298,6 +8424,87 @@ export declare const McpServerContributions: z.ZodRecord<z.ZodString, z.ZodObjec
8298
8424
 
8299
8425
  export declare type McpServerContributions = z.infer<typeof McpServerContributions>;
8300
8426
 
8427
+ /** A server mark already resolved into a data URI by its publisher. */
8428
+ export declare interface McpServerIcon {
8429
+ /** A `data:` URI. Consumers may render it directly in an `<img src>`. */
8430
+ readonly src: string;
8431
+ /**
8432
+ * Where the mark came from, because the two are not equally trustworthy.
8433
+ *
8434
+ * `declared` is the server's own `serverInfo.icons` (MCP spec 2025-11-25, SEP-973): evidence.
8435
+ * `favicon` is derived from an HTTP server's origin: still evidence, one step removed.
8436
+ * A name match against Bonsai's brand table is neither, and deliberately does not appear here -
8437
+ * that guess lives in the renderer's existing `BrandIcon` fallback, below both of these.
8438
+ */
8439
+ readonly source: "declared" | "favicon";
8440
+ /** The theme the server nominated this variant for, when it declared more than one. */
8441
+ readonly theme?: "light" | "dark";
8442
+ }
8443
+
8444
+ /** One keyed change to the MCP inventory. */
8445
+ export declare type McpServerInventoryChange = {
8446
+ readonly kind: "upsert";
8447
+ readonly server: McpServerRecord;
8448
+ } | {
8449
+ readonly kind: "remove";
8450
+ readonly name: string;
8451
+ };
8452
+
8453
+ /** One configured MCP server in the app-facing inventory. */
8454
+ export declare interface McpServerRecord {
8455
+ /** The config key, and the id the `mcp.<name>` auth service keys on. */
8456
+ readonly name: string;
8457
+ /**
8458
+ * The auth service that connects this server, when it has one: `mcp.<name>` for a plugins.mcp
8459
+ * server, the shipping plugin's own service for a vendored one. The Plugins page joins a
8460
+ * connection row to its server on THIS id - never by deriving a name from the service id,
8461
+ * which only ever fit the user-config namespace and left every vendored server toolless.
8462
+ */
8463
+ readonly authServiceId?: string;
8464
+ /** The server's own `serverInfo.title`, when it sent one. Display prefers it over `name`. */
8465
+ readonly title?: string;
8466
+ readonly transport: "stdio" | "http";
8467
+ /** What the server launches or connects to: joined command for stdio, url for http. */
8468
+ readonly target: string;
8469
+ /** The config-level switch (`enabled: false` in `plugins.mcp`), not the connection. */
8470
+ readonly enabled: boolean;
8471
+ readonly state: McpServerConnectionState;
8472
+ /** Live when connected, else from the persisted metadata cache. Zero is ordinary. */
8473
+ readonly toolCount: number;
8474
+ /**
8475
+ * What this server offers, for a surface that lists it. Live when connected, else from the
8476
+ * persisted metadata cache, so a server names its tools before it has connected this session
8477
+ * and after a restart.
8478
+ *
8479
+ * NAMES AND DESCRIPTIONS ONLY. The JSON-Schema input declarations stay out: they are by far the
8480
+ * biggest part of a tool list, nothing on this surface renders them, and this snapshot is
8481
+ * re-encoded whenever any server changes state. A surface that genuinely needs a schema is
8482
+ * asking a different question and should ask the agent bridge, which owns tool detail.
8483
+ *
8484
+ * Bounded by the publisher's tool-list limit - {@link toolCount} remains the true count, so a
8485
+ * server past the bound still reports honestly even though the list is clipped.
8486
+ */
8487
+ readonly tools?: readonly McpServerToolSummary[];
8488
+ readonly icon?: McpServerIcon;
8489
+ /**
8490
+ * Why a `failed` server failed, in one human-legible line, when the host knows. A broken row can
8491
+ * then say what went wrong instead of only offering Retry.
8492
+ */
8493
+ readonly failure?: string;
8494
+ }
8495
+
8496
+ /** A complete MCP inventory snapshot. */
8497
+ export declare interface McpServersSnapshot {
8498
+ readonly servers: readonly McpServerRecord[];
8499
+ }
8500
+
8501
+ /** A tool name and optional description for inventory presentation. */
8502
+ export declare interface McpServerToolSummary {
8503
+ readonly name: string;
8504
+ /** The server's own one-line description, trimmed to the publisher's summary limit. */
8505
+ readonly description?: string;
8506
+ }
8507
+
8301
8508
  export declare const McpServerUrl: z.ZodString;
8302
8509
 
8303
8510
  export declare type McpServerUrl = z.infer<typeof McpServerUrl>;
@@ -8430,7 +8637,7 @@ export declare function parseSemver(value: string): ParsedSemver | undefined;
8430
8637
  export declare function parseWhere(source: string, keyTypes?: WhereKeyTypes): WhereParseResult;
8431
8638
 
8432
8639
  /** Every capability slug {@link PluginCapabilityClaimV1} can express, for exhaustive table checks. */
8433
- export declare const PLUGIN_CAPABILITY_SLUGS: readonly ["sessions.run", "network.connect", "web-session.request", "web-session.download", "process.spawn", "sessions.read", "signals.read", "uri.call", "endpoints.invoke", "skills.read", "skills.write", "skills.share", "plugins.set-enabled", "sessions.annotate", "sessions.compact", "soul.write", "tools.describe", "workspace.command", "sessions.create", "sessions.update", "models.complete", "systemOne.use", "automations.write", "automations.run", "workflows.define", "workflows.signals", "session-events.subscribe", "agents.run", "dynamic-context.register", "app-data.register", "app-data.read", "knowledge-source.register", "artifacts.read", "session-artifacts.read", "session-artifacts.create", "account.assert", "account.update", "agents.permissions", "tool-interception.register", "interaction.surface", "config.declare-section", "auth.own-service", "auth.shared-identity", "cli.bind", "mcp.host-server", "prompt.resident", "skills.declared-source", "family-folder.root", "whiteboard.discover", "whiteboard.read", "whiteboard.create", "whiteboard.update", "whiteboard.remove", "model-selection.register", "system-prompt.register"];
8640
+ export declare const PLUGIN_CAPABILITY_SLUGS: readonly ["sessions.run", "network.connect", "web-session.request", "web-session.download", "process.spawn", "sessions.read", "signals.read", "uri.call", "endpoints.invoke", "skills.read", "skills.write", "skills.share", "plugins.set-enabled", "sessions.assign-project", "artifacts.resolve-file", "process.run", "sessions.annotate", "sessions.compact", "soul.write", "tools.describe", "workspace.command", "sessions.create", "sessions.update", "models.complete", "systemOne.use", "automations.write", "automations.run", "workflows.define", "workflows.signals", "session-events.subscribe", "agents.run", "dynamic-context.register", "app-data.register", "app-data.read", "knowledge-source.register", "artifacts.read", "session-artifacts.read", "session-artifacts.create", "account.assert", "account.update", "agents.permissions", "tool-interception.register", "interaction.surface", "config.declare-section", "auth.own-service", "auth.shared-identity", "cli.bind", "mcp.host-server", "prompt.resident", "skills.declared-source", "family-folder.root", "whiteboard.discover", "whiteboard.read", "whiteboard.create", "whiteboard.update", "whiteboard.remove", "model-selection.register", "system-prompt.register"];
8434
8641
 
8435
8642
  /** Diagnostic messages carry plugin-controlled text (parse errors, module errors); bound it so a
8436
8643
  * hostile or accidental multi-megabyte error can never blow up a log line or a render surface. */
@@ -8533,7 +8740,9 @@ export declare const PluginAuthManifest: z.ZodObject<{
8533
8740
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8534
8741
  authorizationUrl: z.ZodURL;
8535
8742
  tokenUrl: z.ZodURL;
8743
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8536
8744
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8745
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8537
8746
  displayName: z.ZodOptional<z.ZodString>;
8538
8747
  agentHint: z.ZodOptional<z.ZodString>;
8539
8748
  summary: z.ZodOptional<z.ZodString>;
@@ -8560,7 +8769,9 @@ export declare const PluginAuthManifest: z.ZodObject<{
8560
8769
  account: z.ZodUnion<readonly [z.ZodLiteral<"lookup">, z.ZodLiteral<"sign-in">]>;
8561
8770
  authorizationUrl: z.ZodURL;
8562
8771
  tokenUrl: z.ZodURL;
8772
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8563
8773
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8774
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8564
8775
  displayName: z.ZodOptional<z.ZodString>;
8565
8776
  agentHint: z.ZodOptional<z.ZodString>;
8566
8777
  summary: z.ZodOptional<z.ZodString>;
@@ -8713,7 +8924,9 @@ export declare const PluginAuthScheme: z.ZodDiscriminatedUnion<[z.ZodDiscriminat
8713
8924
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8714
8925
  authorizationUrl: z.ZodURL;
8715
8926
  tokenUrl: z.ZodURL;
8927
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8716
8928
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8929
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8717
8930
  displayName: z.ZodOptional<z.ZodString>;
8718
8931
  agentHint: z.ZodOptional<z.ZodString>;
8719
8932
  summary: z.ZodOptional<z.ZodString>;
@@ -8740,7 +8953,9 @@ export declare const PluginAuthScheme: z.ZodDiscriminatedUnion<[z.ZodDiscriminat
8740
8953
  account: z.ZodUnion<readonly [z.ZodLiteral<"lookup">, z.ZodLiteral<"sign-in">]>;
8741
8954
  authorizationUrl: z.ZodURL;
8742
8955
  tokenUrl: z.ZodURL;
8956
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8743
8957
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8958
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8744
8959
  displayName: z.ZodOptional<z.ZodString>;
8745
8960
  agentHint: z.ZodOptional<z.ZodString>;
8746
8961
  summary: z.ZodOptional<z.ZodString>;
@@ -8873,7 +9088,9 @@ export declare const PluginAuthService: z.ZodObject<{
8873
9088
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8874
9089
  authorizationUrl: z.ZodURL;
8875
9090
  tokenUrl: z.ZodURL;
9091
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8876
9092
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
9093
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8877
9094
  displayName: z.ZodOptional<z.ZodString>;
8878
9095
  agentHint: z.ZodOptional<z.ZodString>;
8879
9096
  summary: z.ZodOptional<z.ZodString>;
@@ -8900,7 +9117,9 @@ export declare const PluginAuthService: z.ZodObject<{
8900
9117
  account: z.ZodUnion<readonly [z.ZodLiteral<"lookup">, z.ZodLiteral<"sign-in">]>;
8901
9118
  authorizationUrl: z.ZodURL;
8902
9119
  tokenUrl: z.ZodURL;
9120
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8903
9121
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
9122
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8904
9123
  displayName: z.ZodOptional<z.ZodString>;
8905
9124
  agentHint: z.ZodOptional<z.ZodString>;
8906
9125
  summary: z.ZodOptional<z.ZodString>;
@@ -9117,6 +9336,18 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
9117
9336
  target: "kay.app";
9118
9337
  slug: "plugins.set-enabled";
9119
9338
  envelope: Record<string, never>;
9339
+ } | {
9340
+ target: "kay.app";
9341
+ slug: "sessions.assign-project";
9342
+ envelope: Record<string, never>;
9343
+ } | {
9344
+ target: "kay.app";
9345
+ slug: "artifacts.resolve-file";
9346
+ envelope: Record<string, never>;
9347
+ } | {
9348
+ target: "kay.app";
9349
+ slug: "process.run";
9350
+ envelope: Record<string, never>;
9120
9351
  } | {
9121
9352
  target: "kay.app";
9122
9353
  slug: "sessions.annotate";
@@ -9395,6 +9626,18 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
9395
9626
  target: "kay.app";
9396
9627
  slug: "plugins.set-enabled";
9397
9628
  envelope: Record<string, never>;
9629
+ } | {
9630
+ target: "kay.app";
9631
+ slug: "sessions.assign-project";
9632
+ envelope: Record<string, never>;
9633
+ } | {
9634
+ target: "kay.app";
9635
+ slug: "artifacts.resolve-file";
9636
+ envelope: Record<string, never>;
9637
+ } | {
9638
+ target: "kay.app";
9639
+ slug: "process.run";
9640
+ envelope: Record<string, never>;
9398
9641
  } | {
9399
9642
  target: "kay.app";
9400
9643
  slug: "sessions.annotate";
@@ -9683,6 +9926,18 @@ export declare const PluginCapabilityClaimV1: z.ZodDiscriminatedUnion<[z.ZodObje
9683
9926
  target: z.ZodLiteral<"kay.app">;
9684
9927
  slug: z.ZodLiteral<"plugins.set-enabled">;
9685
9928
  envelope: z.ZodObject<{}, z.core.$strict>;
9929
+ }, z.core.$strict>, z.ZodObject<{
9930
+ target: z.ZodLiteral<"kay.app">;
9931
+ slug: z.ZodLiteral<"sessions.assign-project">;
9932
+ envelope: z.ZodObject<{}, z.core.$strict>;
9933
+ }, z.core.$strict>, z.ZodObject<{
9934
+ target: z.ZodLiteral<"kay.app">;
9935
+ slug: z.ZodLiteral<"artifacts.resolve-file">;
9936
+ envelope: z.ZodObject<{}, z.core.$strict>;
9937
+ }, z.core.$strict>, z.ZodObject<{
9938
+ target: z.ZodLiteral<"kay.app">;
9939
+ slug: z.ZodLiteral<"process.run">;
9940
+ envelope: z.ZodObject<{}, z.core.$strict>;
9686
9941
  }, z.core.$strict>, z.ZodObject<{
9687
9942
  target: z.ZodLiteral<"kay.app">;
9688
9943
  slug: z.ZodLiteral<"sessions.annotate">;
@@ -10017,6 +10272,18 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
10017
10272
  target: z.ZodLiteral<"kay.app">;
10018
10273
  slug: z.ZodLiteral<"plugins.set-enabled">;
10019
10274
  envelope: z.ZodObject<{}, z.core.$strict>;
10275
+ }, z.core.$strict>, z.ZodObject<{
10276
+ target: z.ZodLiteral<"kay.app">;
10277
+ slug: z.ZodLiteral<"sessions.assign-project">;
10278
+ envelope: z.ZodObject<{}, z.core.$strict>;
10279
+ }, z.core.$strict>, z.ZodObject<{
10280
+ target: z.ZodLiteral<"kay.app">;
10281
+ slug: z.ZodLiteral<"artifacts.resolve-file">;
10282
+ envelope: z.ZodObject<{}, z.core.$strict>;
10283
+ }, z.core.$strict>, z.ZodObject<{
10284
+ target: z.ZodLiteral<"kay.app">;
10285
+ slug: z.ZodLiteral<"process.run">;
10286
+ envelope: z.ZodObject<{}, z.core.$strict>;
10020
10287
  }, z.core.$strict>, z.ZodObject<{
10021
10288
  target: z.ZodLiteral<"kay.app">;
10022
10289
  slug: z.ZodLiteral<"sessions.annotate">;
@@ -10350,6 +10617,18 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
10350
10617
  target: z.ZodLiteral<"kay.app">;
10351
10618
  slug: z.ZodLiteral<"plugins.set-enabled">;
10352
10619
  envelope: z.ZodObject<{}, z.core.$strict>;
10620
+ }, z.core.$strict>, z.ZodObject<{
10621
+ target: z.ZodLiteral<"kay.app">;
10622
+ slug: z.ZodLiteral<"sessions.assign-project">;
10623
+ envelope: z.ZodObject<{}, z.core.$strict>;
10624
+ }, z.core.$strict>, z.ZodObject<{
10625
+ target: z.ZodLiteral<"kay.app">;
10626
+ slug: z.ZodLiteral<"artifacts.resolve-file">;
10627
+ envelope: z.ZodObject<{}, z.core.$strict>;
10628
+ }, z.core.$strict>, z.ZodObject<{
10629
+ target: z.ZodLiteral<"kay.app">;
10630
+ slug: z.ZodLiteral<"process.run">;
10631
+ envelope: z.ZodObject<{}, z.core.$strict>;
10353
10632
  }, z.core.$strict>, z.ZodObject<{
10354
10633
  target: z.ZodLiteral<"kay.app">;
10355
10634
  slug: z.ZodLiteral<"sessions.annotate">;
@@ -10717,6 +10996,18 @@ export declare const PluginCapabilityRefusalV1: z.ZodObject<{
10717
10996
  target: z.ZodLiteral<"kay.app">;
10718
10997
  slug: z.ZodLiteral<"plugins.set-enabled">;
10719
10998
  envelope: z.ZodObject<{}, z.core.$strict>;
10999
+ }, z.core.$strict>, z.ZodObject<{
11000
+ target: z.ZodLiteral<"kay.app">;
11001
+ slug: z.ZodLiteral<"sessions.assign-project">;
11002
+ envelope: z.ZodObject<{}, z.core.$strict>;
11003
+ }, z.core.$strict>, z.ZodObject<{
11004
+ target: z.ZodLiteral<"kay.app">;
11005
+ slug: z.ZodLiteral<"artifacts.resolve-file">;
11006
+ envelope: z.ZodObject<{}, z.core.$strict>;
11007
+ }, z.core.$strict>, z.ZodObject<{
11008
+ target: z.ZodLiteral<"kay.app">;
11009
+ slug: z.ZodLiteral<"process.run">;
11010
+ envelope: z.ZodObject<{}, z.core.$strict>;
10720
11011
  }, z.core.$strict>, z.ZodObject<{
10721
11012
  target: z.ZodLiteral<"kay.app">;
10722
11013
  slug: z.ZodLiteral<"sessions.annotate">;
@@ -11034,8 +11325,8 @@ export declare const PluginConfigManifest: z.ZodArray<z.ZodObject<{
11034
11325
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
11035
11326
  defaults: z.ZodOptional<z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
11036
11327
  scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
11037
- global: "global";
11038
11328
  project: "project";
11329
+ global: "global";
11039
11330
  agent: "agent";
11040
11331
  }>>>;
11041
11332
  }, z.core.$strict>>;
@@ -11043,8 +11334,8 @@ export declare const PluginConfigManifest: z.ZodArray<z.ZodObject<{
11043
11334
  export declare type PluginConfigManifest = z.infer<typeof PluginConfigManifest>;
11044
11335
 
11045
11336
  export declare const PluginConfigScope: z.ZodEnum<{
11046
- global: "global";
11047
11337
  project: "project";
11338
+ global: "global";
11048
11339
  agent: "agent";
11049
11340
  }>;
11050
11341
 
@@ -11055,8 +11346,8 @@ export declare const PluginConfigSectionManifest: z.ZodObject<{
11055
11346
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
11056
11347
  defaults: z.ZodOptional<z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
11057
11348
  scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
11058
- global: "global";
11059
11349
  project: "project";
11350
+ global: "global";
11060
11351
  agent: "agent";
11061
11352
  }>>>;
11062
11353
  }, z.core.$strict>;
@@ -12034,6 +12325,18 @@ export declare interface PluginProductEventSend {
12034
12325
  readonly subjectUri?: string;
12035
12326
  }
12036
12327
 
12328
+ /**
12329
+ * A manifest's `projectDirectories` declaration: this plugin owns projects addressed at `scheme`,
12330
+ * and its app endpoint `endpoint` answers which folder a project is in. The host reads a
12331
+ * selected project's folder, default working directory and ancestors through that endpoint.
12332
+ */
12333
+ export declare const PluginProjectDirectories: z.ZodObject<{
12334
+ endpoint: z.ZodString;
12335
+ scheme: z.ZodString;
12336
+ }, z.core.$strict>;
12337
+
12338
+ export declare type PluginProjectDirectories = z.infer<typeof PluginProjectDirectories>;
12339
+
12037
12340
  export declare const PluginProvisioningProbe: z.ZodObject<{
12038
12341
  url: z.ZodURL;
12039
12342
  method: z.ZodOptional<z.ZodEnum<{
@@ -12278,6 +12581,33 @@ declare type PrereleaseIdentifier = string | number;
12278
12581
  */
12279
12582
  export declare const PRIVATE_PLUGIN_CAPABILITY_SLUGS: readonly PluginCapabilitySlug[];
12280
12583
 
12584
+ export declare const ProjectDirectory: z.ZodObject<{
12585
+ id: z.ZodString;
12586
+ path: z.ZodString;
12587
+ defaultCwd: z.ZodString;
12588
+ ancestorIds: z.ZodArray<z.ZodString>;
12589
+ }, z.core.$strict>;
12590
+
12591
+ export declare type ProjectDirectory = z.infer<typeof ProjectDirectory>;
12592
+
12593
+ export declare const ProjectDirectoryRequest: z.ZodObject<{
12594
+ id: z.ZodString;
12595
+ }, z.core.$strict>;
12596
+
12597
+ export declare type ProjectDirectoryRequest = z.infer<typeof ProjectDirectoryRequest>;
12598
+
12599
+ /** `project` is null when no project has the requested id. */
12600
+ export declare const ProjectDirectoryResponse: z.ZodObject<{
12601
+ project: z.ZodNullable<z.ZodObject<{
12602
+ id: z.ZodString;
12603
+ path: z.ZodString;
12604
+ defaultCwd: z.ZodString;
12605
+ ancestorIds: z.ZodArray<z.ZodString>;
12606
+ }, z.core.$strict>>;
12607
+ }, z.core.$strict>;
12608
+
12609
+ export declare type ProjectDirectoryResponse = z.infer<typeof ProjectDirectoryResponse>;
12610
+
12281
12611
  /**
12282
12612
  * What a manifest's JSON declares about compatibility, read the way a directory's verdict reads it:
12283
12613
  * apart from the strict schema, because a manifest written for another SDK may not pass that schema.
@@ -12985,6 +13315,7 @@ export declare const ResolvedKayAgentUriModule: z.ZodObject<{
12985
13315
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
12986
13316
  }, z.core.$strict>>;
12987
13317
  localId: z.ZodString;
13318
+ adapterId: z.ZodOptional<z.ZodString>;
12988
13319
  globalId: z.ZodString;
12989
13320
  schemes: z.ZodArray<z.ZodString>;
12990
13321
  displayName: z.ZodOptional<z.ZodString>;
@@ -13253,6 +13584,13 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
13253
13584
  }, z.core.$strict>]>>>;
13254
13585
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
13255
13586
  "navigation.open-session": "navigation.open-session";
13587
+ "navigation.open-external": "navigation.open-external";
13588
+ "configuration.read": "configuration.read";
13589
+ "auth-services.read": "auth-services.read";
13590
+ "connect-flows.read": "connect-flows.read";
13591
+ "connect-flows.dismiss": "connect-flows.dismiss";
13592
+ "support.report": "support.report";
13593
+ "navigation.open-page": "navigation.open-page";
13256
13594
  "sessions.create": "sessions.create";
13257
13595
  "models.complete": "models.complete";
13258
13596
  "artifacts.read": "artifacts.read";
@@ -13260,6 +13598,10 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
13260
13598
  "markdown.document-view": "markdown.document-view";
13261
13599
  "references.open": "references.open";
13262
13600
  "billing.read": "billing.read";
13601
+ "account.read": "account.read";
13602
+ "plugins.read": "plugins.read";
13603
+ "plugins.settings": "plugins.settings";
13604
+ "permissions.manage": "permissions.manage";
13263
13605
  "automations.read": "automations.read";
13264
13606
  "automations.run": "automations.run";
13265
13607
  "shared-artifacts.read": "shared-artifacts.read";
@@ -13324,9 +13666,11 @@ export declare const ResolvedPluginAuthScheme: z.ZodDiscriminatedUnion<[z.ZodDis
13324
13666
  globalId: z.ZodString;
13325
13667
  kind: z.ZodLiteral<"oauth2">;
13326
13668
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13669
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13327
13670
  authorizationUrl: z.ZodURL;
13328
13671
  tokenUrl: z.ZodURL;
13329
13672
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13673
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13330
13674
  displayName: z.ZodOptional<z.ZodString>;
13331
13675
  agentHint: z.ZodOptional<z.ZodString>;
13332
13676
  summary: z.ZodOptional<z.ZodString>;
@@ -13355,9 +13699,11 @@ export declare const ResolvedPluginAuthScheme: z.ZodDiscriminatedUnion<[z.ZodDis
13355
13699
  globalId: z.ZodString;
13356
13700
  kind: z.ZodLiteral<"oauth2">;
13357
13701
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13702
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13358
13703
  authorizationUrl: z.ZodURL;
13359
13704
  tokenUrl: z.ZodURL;
13360
13705
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13706
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13361
13707
  displayName: z.ZodOptional<z.ZodString>;
13362
13708
  agentHint: z.ZodOptional<z.ZodString>;
13363
13709
  summary: z.ZodOptional<z.ZodString>;
@@ -13493,9 +13839,11 @@ export declare const ResolvedPluginAuthService: z.ZodObject<{
13493
13839
  globalId: z.ZodString;
13494
13840
  kind: z.ZodLiteral<"oauth2">;
13495
13841
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13842
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13496
13843
  authorizationUrl: z.ZodURL;
13497
13844
  tokenUrl: z.ZodURL;
13498
13845
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13846
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13499
13847
  displayName: z.ZodOptional<z.ZodString>;
13500
13848
  agentHint: z.ZodOptional<z.ZodString>;
13501
13849
  summary: z.ZodOptional<z.ZodString>;
@@ -13524,9 +13872,11 @@ export declare const ResolvedPluginAuthService: z.ZodObject<{
13524
13872
  globalId: z.ZodString;
13525
13873
  kind: z.ZodLiteral<"oauth2">;
13526
13874
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13875
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13527
13876
  authorizationUrl: z.ZodURL;
13528
13877
  tokenUrl: z.ZodURL;
13529
13878
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13879
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13530
13880
  displayName: z.ZodOptional<z.ZodString>;
13531
13881
  agentHint: z.ZodOptional<z.ZodString>;
13532
13882
  summary: z.ZodOptional<z.ZodString>;
@@ -13726,6 +14076,10 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
13726
14076
  usage: z.ZodString;
13727
14077
  endpointId: z.ZodString;
13728
14078
  }, z.core.$strict>>>;
14079
+ projectDirectories: z.ZodOptional<z.ZodObject<{
14080
+ scheme: z.ZodString;
14081
+ endpointId: z.ZodString;
14082
+ }, z.core.$strict>>;
13729
14083
  authServices: z.ZodArray<z.ZodObject<{
13730
14084
  localId: z.ZodString;
13731
14085
  globalId: z.ZodString;
@@ -13768,9 +14122,11 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
13768
14122
  globalId: z.ZodString;
13769
14123
  kind: z.ZodLiteral<"oauth2">;
13770
14124
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
14125
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13771
14126
  authorizationUrl: z.ZodURL;
13772
14127
  tokenUrl: z.ZodURL;
13773
14128
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
14129
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13774
14130
  displayName: z.ZodOptional<z.ZodString>;
13775
14131
  agentHint: z.ZodOptional<z.ZodString>;
13776
14132
  summary: z.ZodOptional<z.ZodString>;
@@ -13799,9 +14155,11 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
13799
14155
  globalId: z.ZodString;
13800
14156
  kind: z.ZodLiteral<"oauth2">;
13801
14157
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
14158
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13802
14159
  authorizationUrl: z.ZodURL;
13803
14160
  tokenUrl: z.ZodURL;
13804
14161
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
14162
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13805
14163
  displayName: z.ZodOptional<z.ZodString>;
13806
14164
  agentHint: z.ZodOptional<z.ZodString>;
13807
14165
  summary: z.ZodOptional<z.ZodString>;
@@ -14435,6 +14793,7 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14435
14793
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
14436
14794
  }, z.core.$strict>>;
14437
14795
  localId: z.ZodString;
14796
+ adapterId: z.ZodOptional<z.ZodString>;
14438
14797
  globalId: z.ZodString;
14439
14798
  schemes: z.ZodArray<z.ZodString>;
14440
14799
  displayName: z.ZodOptional<z.ZodString>;
@@ -14907,6 +15266,13 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14907
15266
  }, z.core.$strict>]>>>;
14908
15267
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
14909
15268
  "navigation.open-session": "navigation.open-session";
15269
+ "navigation.open-external": "navigation.open-external";
15270
+ "configuration.read": "configuration.read";
15271
+ "auth-services.read": "auth-services.read";
15272
+ "connect-flows.read": "connect-flows.read";
15273
+ "connect-flows.dismiss": "connect-flows.dismiss";
15274
+ "support.report": "support.report";
15275
+ "navigation.open-page": "navigation.open-page";
14910
15276
  "sessions.create": "sessions.create";
14911
15277
  "models.complete": "models.complete";
14912
15278
  "artifacts.read": "artifacts.read";
@@ -14914,6 +15280,10 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14914
15280
  "markdown.document-view": "markdown.document-view";
14915
15281
  "references.open": "references.open";
14916
15282
  "billing.read": "billing.read";
15283
+ "account.read": "account.read";
15284
+ "plugins.read": "plugins.read";
15285
+ "plugins.settings": "plugins.settings";
15286
+ "permissions.manage": "permissions.manage";
14917
15287
  "automations.read": "automations.read";
14918
15288
  "automations.run": "automations.run";
14919
15289
  "shared-artifacts.read": "shared-artifacts.read";
@@ -16790,6 +17160,13 @@ export declare const UiAppCapabilities: z.ZodObject<{
16790
17160
  }, z.core.$strict>]>>>;
16791
17161
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
16792
17162
  "navigation.open-session": "navigation.open-session";
17163
+ "navigation.open-external": "navigation.open-external";
17164
+ "configuration.read": "configuration.read";
17165
+ "auth-services.read": "auth-services.read";
17166
+ "connect-flows.read": "connect-flows.read";
17167
+ "connect-flows.dismiss": "connect-flows.dismiss";
17168
+ "support.report": "support.report";
17169
+ "navigation.open-page": "navigation.open-page";
16793
17170
  "sessions.create": "sessions.create";
16794
17171
  "models.complete": "models.complete";
16795
17172
  "artifacts.read": "artifacts.read";
@@ -16797,6 +17174,10 @@ export declare const UiAppCapabilities: z.ZodObject<{
16797
17174
  "markdown.document-view": "markdown.document-view";
16798
17175
  "references.open": "references.open";
16799
17176
  "billing.read": "billing.read";
17177
+ "account.read": "account.read";
17178
+ "plugins.read": "plugins.read";
17179
+ "plugins.settings": "plugins.settings";
17180
+ "permissions.manage": "permissions.manage";
16800
17181
  "automations.read": "automations.read";
16801
17182
  "automations.run": "automations.run";
16802
17183
  "shared-artifacts.read": "shared-artifacts.read";
@@ -16843,6 +17224,13 @@ export declare const UiAppContribution: z.ZodObject<{
16843
17224
  }, z.core.$strict>]>>>;
16844
17225
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
16845
17226
  "navigation.open-session": "navigation.open-session";
17227
+ "navigation.open-external": "navigation.open-external";
17228
+ "configuration.read": "configuration.read";
17229
+ "auth-services.read": "auth-services.read";
17230
+ "connect-flows.read": "connect-flows.read";
17231
+ "connect-flows.dismiss": "connect-flows.dismiss";
17232
+ "support.report": "support.report";
17233
+ "navigation.open-page": "navigation.open-page";
16846
17234
  "sessions.create": "sessions.create";
16847
17235
  "models.complete": "models.complete";
16848
17236
  "artifacts.read": "artifacts.read";
@@ -16850,6 +17238,10 @@ export declare const UiAppContribution: z.ZodObject<{
16850
17238
  "markdown.document-view": "markdown.document-view";
16851
17239
  "references.open": "references.open";
16852
17240
  "billing.read": "billing.read";
17241
+ "account.read": "account.read";
17242
+ "plugins.read": "plugins.read";
17243
+ "plugins.settings": "plugins.settings";
17244
+ "permissions.manage": "permissions.manage";
16853
17245
  "automations.read": "automations.read";
16854
17246
  "automations.run": "automations.run";
16855
17247
  "shared-artifacts.read": "shared-artifacts.read";
@@ -16886,6 +17278,13 @@ export declare const UiAppContribution: z.ZodObject<{
16886
17278
  }, z.core.$strict>]>>>;
16887
17279
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
16888
17280
  "navigation.open-session": "navigation.open-session";
17281
+ "navigation.open-external": "navigation.open-external";
17282
+ "configuration.read": "configuration.read";
17283
+ "auth-services.read": "auth-services.read";
17284
+ "connect-flows.read": "connect-flows.read";
17285
+ "connect-flows.dismiss": "connect-flows.dismiss";
17286
+ "support.report": "support.report";
17287
+ "navigation.open-page": "navigation.open-page";
16889
17288
  "sessions.create": "sessions.create";
16890
17289
  "models.complete": "models.complete";
16891
17290
  "artifacts.read": "artifacts.read";
@@ -16893,6 +17292,10 @@ export declare const UiAppContribution: z.ZodObject<{
16893
17292
  "markdown.document-view": "markdown.document-view";
16894
17293
  "references.open": "references.open";
16895
17294
  "billing.read": "billing.read";
17295
+ "account.read": "account.read";
17296
+ "plugins.read": "plugins.read";
17297
+ "plugins.settings": "plugins.settings";
17298
+ "permissions.manage": "permissions.manage";
16896
17299
  "automations.read": "automations.read";
16897
17300
  "automations.run": "automations.run";
16898
17301
  "shared-artifacts.read": "shared-artifacts.read";
@@ -16973,6 +17376,9 @@ export declare const UiPageContribution: z.ZodObject<{
16973
17376
  session: "session";
16974
17377
  family: "family";
16975
17378
  }>>;
17379
+ settings: z.ZodOptional<z.ZodObject<{
17380
+ order: z.ZodOptional<z.ZodNumber>;
17381
+ }, z.core.$strict>>;
16976
17382
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
16977
17383
  openedEvent: z.ZodOptional<z.ZodString>;
16978
17384
  }, z.core.$strict>;
@@ -17222,6 +17628,7 @@ export declare const UriModuleContribution: z.ZodObject<{
17222
17628
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
17223
17629
  }, z.core.$strict>>;
17224
17630
  localId: z.ZodString;
17631
+ adapterId: z.ZodOptional<z.ZodString>;
17225
17632
  schemes: z.ZodArray<z.ZodString>;
17226
17633
  displayName: z.ZodOptional<z.ZodString>;
17227
17634
  }, z.core.$strict>;