@yaklabs-ai/plugin-protocol 0.53.0 → 0.54.1

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 +448 -26
  4. package/dist/index.js +536 -393
  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";
@@ -3282,7 +3305,10 @@ declare const canonicalContributionSchemas: {
3282
3305
  plugins: "plugins";
3283
3306
  }>>;
3284
3307
  badge: z.ZodOptional<z.ZodObject<{
3285
- source: z.ZodString;
3308
+ source: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
3309
+ pluginId: z.ZodString;
3310
+ localId: z.ZodString;
3311
+ }, z.core.$strict>]>;
3286
3312
  where: z.ZodOptional<z.ZodString>;
3287
3313
  label: z.ZodObject<{
3288
3314
  one: z.ZodOptional<z.ZodString>;
@@ -3292,11 +3318,9 @@ declare const canonicalContributionSchemas: {
3292
3318
  panel: z.ZodOptional<z.ZodObject<{
3293
3319
  body: z.ZodString;
3294
3320
  }, z.core.$strict>>;
3295
- featureFlagVariant: z.ZodOptional<z.ZodObject<{
3321
+ visibleWhen: z.ZodOptional<z.ZodObject<{
3296
3322
  flag: z.ZodString;
3297
- title: z.ZodOptional<z.ZodString>;
3298
- icon: z.ZodOptional<z.ZodString>;
3299
- panel: z.ZodOptional<z.ZodLiteral<false>>;
3323
+ enabled: z.ZodBoolean;
3300
3324
  }, z.core.$strict>>;
3301
3325
  }, z.core.$strict>;
3302
3326
  UiToastPreviewContribution: z.ZodObject<{
@@ -3313,6 +3337,9 @@ declare const canonicalContributionSchemas: {
3313
3337
  session: "session";
3314
3338
  family: "family";
3315
3339
  }>>;
3340
+ settings: z.ZodOptional<z.ZodObject<{
3341
+ order: z.ZodOptional<z.ZodNumber>;
3342
+ }, z.core.$strict>>;
3316
3343
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
3317
3344
  openedEvent: z.ZodOptional<z.ZodString>;
3318
3345
  }, z.core.$strict>;
@@ -3339,6 +3366,13 @@ declare const canonicalContributionSchemas: {
3339
3366
  }, z.core.$strict>]>>>;
3340
3367
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
3341
3368
  "navigation.open-session": "navigation.open-session";
3369
+ "navigation.open-external": "navigation.open-external";
3370
+ "configuration.read": "configuration.read";
3371
+ "auth-services.read": "auth-services.read";
3372
+ "connect-flows.read": "connect-flows.read";
3373
+ "connect-flows.dismiss": "connect-flows.dismiss";
3374
+ "support.report": "support.report";
3375
+ "navigation.open-page": "navigation.open-page";
3342
3376
  "sessions.create": "sessions.create";
3343
3377
  "models.complete": "models.complete";
3344
3378
  "artifacts.read": "artifacts.read";
@@ -3346,6 +3380,10 @@ declare const canonicalContributionSchemas: {
3346
3380
  "markdown.document-view": "markdown.document-view";
3347
3381
  "references.open": "references.open";
3348
3382
  "billing.read": "billing.read";
3383
+ "account.read": "account.read";
3384
+ "plugins.read": "plugins.read";
3385
+ "plugins.settings": "plugins.settings";
3386
+ "permissions.manage": "permissions.manage";
3349
3387
  "automations.read": "automations.read";
3350
3388
  "automations.run": "automations.run";
3351
3389
  "shared-artifacts.read": "shared-artifacts.read";
@@ -3382,6 +3420,13 @@ declare const canonicalContributionSchemas: {
3382
3420
  }, z.core.$strict>]>>>;
3383
3421
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
3384
3422
  "navigation.open-session": "navigation.open-session";
3423
+ "navigation.open-external": "navigation.open-external";
3424
+ "configuration.read": "configuration.read";
3425
+ "auth-services.read": "auth-services.read";
3426
+ "connect-flows.read": "connect-flows.read";
3427
+ "connect-flows.dismiss": "connect-flows.dismiss";
3428
+ "support.report": "support.report";
3429
+ "navigation.open-page": "navigation.open-page";
3385
3430
  "sessions.create": "sessions.create";
3386
3431
  "models.complete": "models.complete";
3387
3432
  "artifacts.read": "artifacts.read";
@@ -3389,6 +3434,10 @@ declare const canonicalContributionSchemas: {
3389
3434
  "markdown.document-view": "markdown.document-view";
3390
3435
  "references.open": "references.open";
3391
3436
  "billing.read": "billing.read";
3437
+ "account.read": "account.read";
3438
+ "plugins.read": "plugins.read";
3439
+ "plugins.settings": "plugins.settings";
3440
+ "permissions.manage": "permissions.manage";
3392
3441
  "automations.read": "automations.read";
3393
3442
  "automations.run": "automations.run";
3394
3443
  "shared-artifacts.read": "shared-artifacts.read";
@@ -4841,8 +4890,15 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
4841
4890
  * 0.53.0 adds declared working-content layouts, family-root authority, draft projection discovery
4842
4891
  * and session-bound page references. Older customized Whiteboard copies must accept the plugin
4843
4892
  * update before using these interfaces.
4893
+ *
4894
+ * 0.54.0 adds named UI host grants for shared configuration/auth/account reads, retained connection
4895
+ * progress/dismissal and support. Built-in-only page capability scopes are removed; executable
4896
+ * pages declare capabilities on apps[].
4897
+ *
4898
+ * 0.54.1 adds manifest-declared plugin workers on both backend targets and exposes the canonical
4899
+ * transcript placement and answer-stretch rules through the SDK.
4844
4900
  */
4845
- export declare const KAY_PLUGIN_SDK_VERSION: "0.53.0";
4901
+ export declare const KAY_PLUGIN_SDK_VERSION: "0.54.1";
4846
4902
 
4847
4903
  export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
4848
4904
 
@@ -5116,6 +5172,7 @@ export declare const KayAgentTargetManifest: z.ZodObject<{
5116
5172
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
5117
5173
  }, z.core.$strict>>;
5118
5174
  localId: z.ZodString;
5175
+ adapterId: z.ZodOptional<z.ZodString>;
5119
5176
  schemes: z.ZodArray<z.ZodString>;
5120
5177
  displayName: z.ZodOptional<z.ZodString>;
5121
5178
  }, z.core.$strict>>>;
@@ -5791,6 +5848,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
5791
5848
  icon: z.ZodOptional<z.ZodString>;
5792
5849
  iconDark: z.ZodOptional<z.ZodString>;
5793
5850
  namespace: z.ZodOptional<z.ZodString>;
5851
+ workers: z.ZodOptional<z.ZodArray<z.ZodObject<{
5852
+ localId: z.ZodString;
5853
+ module: z.ZodString;
5854
+ }, z.core.$strict>>>;
5794
5855
  targets: z.ZodOptional<z.ZodObject<{
5795
5856
  kay: z.ZodOptional<z.ZodObject<{
5796
5857
  agent: z.ZodOptional<z.ZodObject<{
@@ -6049,6 +6110,7 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6049
6110
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
6050
6111
  }, z.core.$strict>>;
6051
6112
  localId: z.ZodString;
6113
+ adapterId: z.ZodOptional<z.ZodString>;
6052
6114
  schemes: z.ZodArray<z.ZodString>;
6053
6115
  displayName: z.ZodOptional<z.ZodString>;
6054
6116
  }, z.core.$strict>>>;
@@ -6779,6 +6841,13 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6779
6841
  }, z.core.$strict>]>>>;
6780
6842
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
6781
6843
  "navigation.open-session": "navigation.open-session";
6844
+ "navigation.open-external": "navigation.open-external";
6845
+ "configuration.read": "configuration.read";
6846
+ "auth-services.read": "auth-services.read";
6847
+ "connect-flows.read": "connect-flows.read";
6848
+ "connect-flows.dismiss": "connect-flows.dismiss";
6849
+ "support.report": "support.report";
6850
+ "navigation.open-page": "navigation.open-page";
6782
6851
  "sessions.create": "sessions.create";
6783
6852
  "models.complete": "models.complete";
6784
6853
  "artifacts.read": "artifacts.read";
@@ -6786,6 +6855,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6786
6855
  "markdown.document-view": "markdown.document-view";
6787
6856
  "references.open": "references.open";
6788
6857
  "billing.read": "billing.read";
6858
+ "account.read": "account.read";
6859
+ "plugins.read": "plugins.read";
6860
+ "plugins.settings": "plugins.settings";
6861
+ "permissions.manage": "permissions.manage";
6789
6862
  "automations.read": "automations.read";
6790
6863
  "automations.run": "automations.run";
6791
6864
  "shared-artifacts.read": "shared-artifacts.read";
@@ -6822,6 +6895,13 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6822
6895
  }, z.core.$strict>]>>>;
6823
6896
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
6824
6897
  "navigation.open-session": "navigation.open-session";
6898
+ "navigation.open-external": "navigation.open-external";
6899
+ "configuration.read": "configuration.read";
6900
+ "auth-services.read": "auth-services.read";
6901
+ "connect-flows.read": "connect-flows.read";
6902
+ "connect-flows.dismiss": "connect-flows.dismiss";
6903
+ "support.report": "support.report";
6904
+ "navigation.open-page": "navigation.open-page";
6825
6905
  "sessions.create": "sessions.create";
6826
6906
  "models.complete": "models.complete";
6827
6907
  "artifacts.read": "artifacts.read";
@@ -6829,6 +6909,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6829
6909
  "markdown.document-view": "markdown.document-view";
6830
6910
  "references.open": "references.open";
6831
6911
  "billing.read": "billing.read";
6912
+ "account.read": "account.read";
6913
+ "plugins.read": "plugins.read";
6914
+ "plugins.settings": "plugins.settings";
6915
+ "permissions.manage": "permissions.manage";
6832
6916
  "automations.read": "automations.read";
6833
6917
  "automations.run": "automations.run";
6834
6918
  "shared-artifacts.read": "shared-artifacts.read";
@@ -6856,7 +6940,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6856
6940
  plugins: "plugins";
6857
6941
  }>>;
6858
6942
  badge: z.ZodOptional<z.ZodObject<{
6859
- source: z.ZodString;
6943
+ source: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
6944
+ pluginId: z.ZodString;
6945
+ localId: z.ZodString;
6946
+ }, z.core.$strict>]>;
6860
6947
  where: z.ZodOptional<z.ZodString>;
6861
6948
  label: z.ZodObject<{
6862
6949
  one: z.ZodOptional<z.ZodString>;
@@ -6866,11 +6953,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6866
6953
  panel: z.ZodOptional<z.ZodObject<{
6867
6954
  body: z.ZodString;
6868
6955
  }, z.core.$strict>>;
6869
- featureFlagVariant: z.ZodOptional<z.ZodObject<{
6956
+ visibleWhen: z.ZodOptional<z.ZodObject<{
6870
6957
  flag: z.ZodString;
6871
- title: z.ZodOptional<z.ZodString>;
6872
- icon: z.ZodOptional<z.ZodString>;
6873
- panel: z.ZodOptional<z.ZodLiteral<false>>;
6958
+ enabled: z.ZodBoolean;
6874
6959
  }, z.core.$strict>>;
6875
6960
  }, z.core.$strict>>>;
6876
6961
  toastPreviews: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -6887,6 +6972,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6887
6972
  session: "session";
6888
6973
  family: "family";
6889
6974
  }>>;
6975
+ settings: z.ZodOptional<z.ZodObject<{
6976
+ order: z.ZodOptional<z.ZodNumber>;
6977
+ }, z.core.$strict>>;
6890
6978
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
6891
6979
  openedEvent: z.ZodOptional<z.ZodString>;
6892
6980
  }, z.core.$strict>>>;
@@ -6915,8 +7003,8 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6915
7003
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
6916
7004
  defaults: z.ZodOptional<z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
6917
7005
  scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
6918
- global: "global";
6919
7006
  project: "project";
7007
+ global: "global";
6920
7008
  agent: "agent";
6921
7009
  }>>>;
6922
7010
  }, z.core.$strict>>>;
@@ -6945,6 +7033,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6945
7033
  endpoint: z.ZodString;
6946
7034
  usage: z.ZodString;
6947
7035
  }, z.core.$strict>>>;
7036
+ projectDirectories: z.ZodOptional<z.ZodObject<{
7037
+ endpoint: z.ZodString;
7038
+ scheme: z.ZodString;
7039
+ }, z.core.$strict>>;
6948
7040
  auth: z.ZodOptional<z.ZodObject<{
6949
7041
  services: z.ZodOptional<z.ZodArray<z.ZodObject<{
6950
7042
  localId: z.ZodString;
@@ -6988,7 +7080,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6988
7080
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
6989
7081
  authorizationUrl: z.ZodURL;
6990
7082
  tokenUrl: z.ZodURL;
7083
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
6991
7084
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7085
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6992
7086
  displayName: z.ZodOptional<z.ZodString>;
6993
7087
  agentHint: z.ZodOptional<z.ZodString>;
6994
7088
  summary: z.ZodOptional<z.ZodString>;
@@ -7015,7 +7109,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
7015
7109
  account: z.ZodUnion<readonly [z.ZodLiteral<"lookup">, z.ZodLiteral<"sign-in">]>;
7016
7110
  authorizationUrl: z.ZodURL;
7017
7111
  tokenUrl: z.ZodURL;
7112
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
7018
7113
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7114
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7019
7115
  displayName: z.ZodOptional<z.ZodString>;
7020
7116
  agentHint: z.ZodOptional<z.ZodString>;
7021
7117
  summary: z.ZodOptional<z.ZodString>;
@@ -7824,6 +7920,13 @@ export declare interface KayPluginTreeReader {
7824
7920
 
7825
7921
  export declare const KayUiAppHostCapability: z.ZodEnum<{
7826
7922
  "navigation.open-session": "navigation.open-session";
7923
+ "navigation.open-external": "navigation.open-external";
7924
+ "configuration.read": "configuration.read";
7925
+ "auth-services.read": "auth-services.read";
7926
+ "connect-flows.read": "connect-flows.read";
7927
+ "connect-flows.dismiss": "connect-flows.dismiss";
7928
+ "support.report": "support.report";
7929
+ "navigation.open-page": "navigation.open-page";
7827
7930
  "sessions.create": "sessions.create";
7828
7931
  "models.complete": "models.complete";
7829
7932
  "artifacts.read": "artifacts.read";
@@ -7831,6 +7934,10 @@ export declare const KayUiAppHostCapability: z.ZodEnum<{
7831
7934
  "markdown.document-view": "markdown.document-view";
7832
7935
  "references.open": "references.open";
7833
7936
  "billing.read": "billing.read";
7937
+ "account.read": "account.read";
7938
+ "plugins.read": "plugins.read";
7939
+ "plugins.settings": "plugins.settings";
7940
+ "permissions.manage": "permissions.manage";
7834
7941
  "automations.read": "automations.read";
7835
7942
  "automations.run": "automations.run";
7836
7943
  "shared-artifacts.read": "shared-artifacts.read";
@@ -8104,6 +8211,13 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8104
8211
  }, z.core.$strict>]>>>;
8105
8212
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
8106
8213
  "navigation.open-session": "navigation.open-session";
8214
+ "navigation.open-external": "navigation.open-external";
8215
+ "configuration.read": "configuration.read";
8216
+ "auth-services.read": "auth-services.read";
8217
+ "connect-flows.read": "connect-flows.read";
8218
+ "connect-flows.dismiss": "connect-flows.dismiss";
8219
+ "support.report": "support.report";
8220
+ "navigation.open-page": "navigation.open-page";
8107
8221
  "sessions.create": "sessions.create";
8108
8222
  "models.complete": "models.complete";
8109
8223
  "artifacts.read": "artifacts.read";
@@ -8111,6 +8225,10 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8111
8225
  "markdown.document-view": "markdown.document-view";
8112
8226
  "references.open": "references.open";
8113
8227
  "billing.read": "billing.read";
8228
+ "account.read": "account.read";
8229
+ "plugins.read": "plugins.read";
8230
+ "plugins.settings": "plugins.settings";
8231
+ "permissions.manage": "permissions.manage";
8114
8232
  "automations.read": "automations.read";
8115
8233
  "automations.run": "automations.run";
8116
8234
  "shared-artifacts.read": "shared-artifacts.read";
@@ -8147,6 +8265,13 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8147
8265
  }, z.core.$strict>]>>>;
8148
8266
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
8149
8267
  "navigation.open-session": "navigation.open-session";
8268
+ "navigation.open-external": "navigation.open-external";
8269
+ "configuration.read": "configuration.read";
8270
+ "auth-services.read": "auth-services.read";
8271
+ "connect-flows.read": "connect-flows.read";
8272
+ "connect-flows.dismiss": "connect-flows.dismiss";
8273
+ "support.report": "support.report";
8274
+ "navigation.open-page": "navigation.open-page";
8150
8275
  "sessions.create": "sessions.create";
8151
8276
  "models.complete": "models.complete";
8152
8277
  "artifacts.read": "artifacts.read";
@@ -8154,6 +8279,10 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8154
8279
  "markdown.document-view": "markdown.document-view";
8155
8280
  "references.open": "references.open";
8156
8281
  "billing.read": "billing.read";
8282
+ "account.read": "account.read";
8283
+ "plugins.read": "plugins.read";
8284
+ "plugins.settings": "plugins.settings";
8285
+ "permissions.manage": "permissions.manage";
8157
8286
  "automations.read": "automations.read";
8158
8287
  "automations.run": "automations.run";
8159
8288
  "shared-artifacts.read": "shared-artifacts.read";
@@ -8181,7 +8310,10 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8181
8310
  plugins: "plugins";
8182
8311
  }>>;
8183
8312
  badge: z.ZodOptional<z.ZodObject<{
8184
- source: z.ZodString;
8313
+ source: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
8314
+ pluginId: z.ZodString;
8315
+ localId: z.ZodString;
8316
+ }, z.core.$strict>]>;
8185
8317
  where: z.ZodOptional<z.ZodString>;
8186
8318
  label: z.ZodObject<{
8187
8319
  one: z.ZodOptional<z.ZodString>;
@@ -8191,11 +8323,9 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8191
8323
  panel: z.ZodOptional<z.ZodObject<{
8192
8324
  body: z.ZodString;
8193
8325
  }, z.core.$strict>>;
8194
- featureFlagVariant: z.ZodOptional<z.ZodObject<{
8326
+ visibleWhen: z.ZodOptional<z.ZodObject<{
8195
8327
  flag: z.ZodString;
8196
- title: z.ZodOptional<z.ZodString>;
8197
- icon: z.ZodOptional<z.ZodString>;
8198
- panel: z.ZodOptional<z.ZodLiteral<false>>;
8328
+ enabled: z.ZodBoolean;
8199
8329
  }, z.core.$strict>>;
8200
8330
  }, z.core.$strict>>>;
8201
8331
  toastPreviews: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -8212,6 +8342,9 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8212
8342
  session: "session";
8213
8343
  family: "family";
8214
8344
  }>>;
8345
+ settings: z.ZodOptional<z.ZodObject<{
8346
+ order: z.ZodOptional<z.ZodNumber>;
8347
+ }, z.core.$strict>>;
8215
8348
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
8216
8349
  openedEvent: z.ZodOptional<z.ZodString>;
8217
8350
  }, z.core.$strict>>>;
@@ -8274,6 +8407,9 @@ export declare const McpServerAuthMode: z.ZodEnum<{
8274
8407
 
8275
8408
  export declare type McpServerAuthMode = z.infer<typeof McpServerAuthMode>;
8276
8409
 
8410
+ /** The connection state published for one configured MCP server. */
8411
+ export declare type McpServerConnectionState = "disconnected" | "connecting" | "connected" | "needs-auth" | "failed";
8412
+
8277
8413
  export declare const McpServerContribution: z.ZodObject<{
8278
8414
  url: z.ZodString;
8279
8415
  auth: z.ZodOptional<z.ZodEnum<{
@@ -8298,6 +8434,87 @@ export declare const McpServerContributions: z.ZodRecord<z.ZodString, z.ZodObjec
8298
8434
 
8299
8435
  export declare type McpServerContributions = z.infer<typeof McpServerContributions>;
8300
8436
 
8437
+ /** A server mark already resolved into a data URI by its publisher. */
8438
+ export declare interface McpServerIcon {
8439
+ /** A `data:` URI. Consumers may render it directly in an `<img src>`. */
8440
+ readonly src: string;
8441
+ /**
8442
+ * Where the mark came from, because the two are not equally trustworthy.
8443
+ *
8444
+ * `declared` is the server's own `serverInfo.icons` (MCP spec 2025-11-25, SEP-973): evidence.
8445
+ * `favicon` is derived from an HTTP server's origin: still evidence, one step removed.
8446
+ * A name match against Bonsai's brand table is neither, and deliberately does not appear here -
8447
+ * that guess lives in the renderer's existing `BrandIcon` fallback, below both of these.
8448
+ */
8449
+ readonly source: "declared" | "favicon";
8450
+ /** The theme the server nominated this variant for, when it declared more than one. */
8451
+ readonly theme?: "light" | "dark";
8452
+ }
8453
+
8454
+ /** One keyed change to the MCP inventory. */
8455
+ export declare type McpServerInventoryChange = {
8456
+ readonly kind: "upsert";
8457
+ readonly server: McpServerRecord;
8458
+ } | {
8459
+ readonly kind: "remove";
8460
+ readonly name: string;
8461
+ };
8462
+
8463
+ /** One configured MCP server in the app-facing inventory. */
8464
+ export declare interface McpServerRecord {
8465
+ /** The config key, and the id the `mcp.<name>` auth service keys on. */
8466
+ readonly name: string;
8467
+ /**
8468
+ * The auth service that connects this server, when it has one: `mcp.<name>` for a plugins.mcp
8469
+ * server, the shipping plugin's own service for a vendored one. The Plugins page joins a
8470
+ * connection row to its server on THIS id - never by deriving a name from the service id,
8471
+ * which only ever fit the user-config namespace and left every vendored server toolless.
8472
+ */
8473
+ readonly authServiceId?: string;
8474
+ /** The server's own `serverInfo.title`, when it sent one. Display prefers it over `name`. */
8475
+ readonly title?: string;
8476
+ readonly transport: "stdio" | "http";
8477
+ /** What the server launches or connects to: joined command for stdio, url for http. */
8478
+ readonly target: string;
8479
+ /** The config-level switch (`enabled: false` in `plugins.mcp`), not the connection. */
8480
+ readonly enabled: boolean;
8481
+ readonly state: McpServerConnectionState;
8482
+ /** Live when connected, else from the persisted metadata cache. Zero is ordinary. */
8483
+ readonly toolCount: number;
8484
+ /**
8485
+ * What this server offers, for a surface that lists it. Live when connected, else from the
8486
+ * persisted metadata cache, so a server names its tools before it has connected this session
8487
+ * and after a restart.
8488
+ *
8489
+ * NAMES AND DESCRIPTIONS ONLY. The JSON-Schema input declarations stay out: they are by far the
8490
+ * biggest part of a tool list, nothing on this surface renders them, and this snapshot is
8491
+ * re-encoded whenever any server changes state. A surface that genuinely needs a schema is
8492
+ * asking a different question and should ask the agent bridge, which owns tool detail.
8493
+ *
8494
+ * Bounded by the publisher's tool-list limit - {@link toolCount} remains the true count, so a
8495
+ * server past the bound still reports honestly even though the list is clipped.
8496
+ */
8497
+ readonly tools?: readonly McpServerToolSummary[];
8498
+ readonly icon?: McpServerIcon;
8499
+ /**
8500
+ * Why a `failed` server failed, in one human-legible line, when the host knows. A broken row can
8501
+ * then say what went wrong instead of only offering Retry.
8502
+ */
8503
+ readonly failure?: string;
8504
+ }
8505
+
8506
+ /** A complete MCP inventory snapshot. */
8507
+ export declare interface McpServersSnapshot {
8508
+ readonly servers: readonly McpServerRecord[];
8509
+ }
8510
+
8511
+ /** A tool name and optional description for inventory presentation. */
8512
+ export declare interface McpServerToolSummary {
8513
+ readonly name: string;
8514
+ /** The server's own one-line description, trimmed to the publisher's summary limit. */
8515
+ readonly description?: string;
8516
+ }
8517
+
8301
8518
  export declare const McpServerUrl: z.ZodString;
8302
8519
 
8303
8520
  export declare type McpServerUrl = z.infer<typeof McpServerUrl>;
@@ -8430,7 +8647,7 @@ export declare function parseSemver(value: string): ParsedSemver | undefined;
8430
8647
  export declare function parseWhere(source: string, keyTypes?: WhereKeyTypes): WhereParseResult;
8431
8648
 
8432
8649
  /** 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"];
8650
+ 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
8651
 
8435
8652
  /** Diagnostic messages carry plugin-controlled text (parse errors, module errors); bound it so a
8436
8653
  * hostile or accidental multi-megabyte error can never blow up a log line or a render surface. */
@@ -8533,7 +8750,9 @@ export declare const PluginAuthManifest: z.ZodObject<{
8533
8750
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8534
8751
  authorizationUrl: z.ZodURL;
8535
8752
  tokenUrl: z.ZodURL;
8753
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8536
8754
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8755
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8537
8756
  displayName: z.ZodOptional<z.ZodString>;
8538
8757
  agentHint: z.ZodOptional<z.ZodString>;
8539
8758
  summary: z.ZodOptional<z.ZodString>;
@@ -8560,7 +8779,9 @@ export declare const PluginAuthManifest: z.ZodObject<{
8560
8779
  account: z.ZodUnion<readonly [z.ZodLiteral<"lookup">, z.ZodLiteral<"sign-in">]>;
8561
8780
  authorizationUrl: z.ZodURL;
8562
8781
  tokenUrl: z.ZodURL;
8782
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8563
8783
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8784
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8564
8785
  displayName: z.ZodOptional<z.ZodString>;
8565
8786
  agentHint: z.ZodOptional<z.ZodString>;
8566
8787
  summary: z.ZodOptional<z.ZodString>;
@@ -8713,7 +8934,9 @@ export declare const PluginAuthScheme: z.ZodDiscriminatedUnion<[z.ZodDiscriminat
8713
8934
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8714
8935
  authorizationUrl: z.ZodURL;
8715
8936
  tokenUrl: z.ZodURL;
8937
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8716
8938
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8939
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8717
8940
  displayName: z.ZodOptional<z.ZodString>;
8718
8941
  agentHint: z.ZodOptional<z.ZodString>;
8719
8942
  summary: z.ZodOptional<z.ZodString>;
@@ -8740,7 +8963,9 @@ export declare const PluginAuthScheme: z.ZodDiscriminatedUnion<[z.ZodDiscriminat
8740
8963
  account: z.ZodUnion<readonly [z.ZodLiteral<"lookup">, z.ZodLiteral<"sign-in">]>;
8741
8964
  authorizationUrl: z.ZodURL;
8742
8965
  tokenUrl: z.ZodURL;
8966
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8743
8967
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8968
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8744
8969
  displayName: z.ZodOptional<z.ZodString>;
8745
8970
  agentHint: z.ZodOptional<z.ZodString>;
8746
8971
  summary: z.ZodOptional<z.ZodString>;
@@ -8873,7 +9098,9 @@ export declare const PluginAuthService: z.ZodObject<{
8873
9098
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8874
9099
  authorizationUrl: z.ZodURL;
8875
9100
  tokenUrl: z.ZodURL;
9101
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8876
9102
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
9103
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8877
9104
  displayName: z.ZodOptional<z.ZodString>;
8878
9105
  agentHint: z.ZodOptional<z.ZodString>;
8879
9106
  summary: z.ZodOptional<z.ZodString>;
@@ -8900,7 +9127,9 @@ export declare const PluginAuthService: z.ZodObject<{
8900
9127
  account: z.ZodUnion<readonly [z.ZodLiteral<"lookup">, z.ZodLiteral<"sign-in">]>;
8901
9128
  authorizationUrl: z.ZodURL;
8902
9129
  tokenUrl: z.ZodURL;
9130
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8903
9131
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
9132
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8904
9133
  displayName: z.ZodOptional<z.ZodString>;
8905
9134
  agentHint: z.ZodOptional<z.ZodString>;
8906
9135
  summary: z.ZodOptional<z.ZodString>;
@@ -9117,6 +9346,18 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
9117
9346
  target: "kay.app";
9118
9347
  slug: "plugins.set-enabled";
9119
9348
  envelope: Record<string, never>;
9349
+ } | {
9350
+ target: "kay.app";
9351
+ slug: "sessions.assign-project";
9352
+ envelope: Record<string, never>;
9353
+ } | {
9354
+ target: "kay.app";
9355
+ slug: "artifacts.resolve-file";
9356
+ envelope: Record<string, never>;
9357
+ } | {
9358
+ target: "kay.app";
9359
+ slug: "process.run";
9360
+ envelope: Record<string, never>;
9120
9361
  } | {
9121
9362
  target: "kay.app";
9122
9363
  slug: "sessions.annotate";
@@ -9395,6 +9636,18 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
9395
9636
  target: "kay.app";
9396
9637
  slug: "plugins.set-enabled";
9397
9638
  envelope: Record<string, never>;
9639
+ } | {
9640
+ target: "kay.app";
9641
+ slug: "sessions.assign-project";
9642
+ envelope: Record<string, never>;
9643
+ } | {
9644
+ target: "kay.app";
9645
+ slug: "artifacts.resolve-file";
9646
+ envelope: Record<string, never>;
9647
+ } | {
9648
+ target: "kay.app";
9649
+ slug: "process.run";
9650
+ envelope: Record<string, never>;
9398
9651
  } | {
9399
9652
  target: "kay.app";
9400
9653
  slug: "sessions.annotate";
@@ -9683,6 +9936,18 @@ export declare const PluginCapabilityClaimV1: z.ZodDiscriminatedUnion<[z.ZodObje
9683
9936
  target: z.ZodLiteral<"kay.app">;
9684
9937
  slug: z.ZodLiteral<"plugins.set-enabled">;
9685
9938
  envelope: z.ZodObject<{}, z.core.$strict>;
9939
+ }, z.core.$strict>, z.ZodObject<{
9940
+ target: z.ZodLiteral<"kay.app">;
9941
+ slug: z.ZodLiteral<"sessions.assign-project">;
9942
+ envelope: z.ZodObject<{}, z.core.$strict>;
9943
+ }, z.core.$strict>, z.ZodObject<{
9944
+ target: z.ZodLiteral<"kay.app">;
9945
+ slug: z.ZodLiteral<"artifacts.resolve-file">;
9946
+ envelope: z.ZodObject<{}, z.core.$strict>;
9947
+ }, z.core.$strict>, z.ZodObject<{
9948
+ target: z.ZodLiteral<"kay.app">;
9949
+ slug: z.ZodLiteral<"process.run">;
9950
+ envelope: z.ZodObject<{}, z.core.$strict>;
9686
9951
  }, z.core.$strict>, z.ZodObject<{
9687
9952
  target: z.ZodLiteral<"kay.app">;
9688
9953
  slug: z.ZodLiteral<"sessions.annotate">;
@@ -10017,6 +10282,18 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
10017
10282
  target: z.ZodLiteral<"kay.app">;
10018
10283
  slug: z.ZodLiteral<"plugins.set-enabled">;
10019
10284
  envelope: z.ZodObject<{}, z.core.$strict>;
10285
+ }, z.core.$strict>, z.ZodObject<{
10286
+ target: z.ZodLiteral<"kay.app">;
10287
+ slug: z.ZodLiteral<"sessions.assign-project">;
10288
+ envelope: z.ZodObject<{}, z.core.$strict>;
10289
+ }, z.core.$strict>, z.ZodObject<{
10290
+ target: z.ZodLiteral<"kay.app">;
10291
+ slug: z.ZodLiteral<"artifacts.resolve-file">;
10292
+ envelope: z.ZodObject<{}, z.core.$strict>;
10293
+ }, z.core.$strict>, z.ZodObject<{
10294
+ target: z.ZodLiteral<"kay.app">;
10295
+ slug: z.ZodLiteral<"process.run">;
10296
+ envelope: z.ZodObject<{}, z.core.$strict>;
10020
10297
  }, z.core.$strict>, z.ZodObject<{
10021
10298
  target: z.ZodLiteral<"kay.app">;
10022
10299
  slug: z.ZodLiteral<"sessions.annotate">;
@@ -10350,6 +10627,18 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
10350
10627
  target: z.ZodLiteral<"kay.app">;
10351
10628
  slug: z.ZodLiteral<"plugins.set-enabled">;
10352
10629
  envelope: z.ZodObject<{}, z.core.$strict>;
10630
+ }, z.core.$strict>, z.ZodObject<{
10631
+ target: z.ZodLiteral<"kay.app">;
10632
+ slug: z.ZodLiteral<"sessions.assign-project">;
10633
+ envelope: z.ZodObject<{}, z.core.$strict>;
10634
+ }, z.core.$strict>, z.ZodObject<{
10635
+ target: z.ZodLiteral<"kay.app">;
10636
+ slug: z.ZodLiteral<"artifacts.resolve-file">;
10637
+ envelope: z.ZodObject<{}, z.core.$strict>;
10638
+ }, z.core.$strict>, z.ZodObject<{
10639
+ target: z.ZodLiteral<"kay.app">;
10640
+ slug: z.ZodLiteral<"process.run">;
10641
+ envelope: z.ZodObject<{}, z.core.$strict>;
10353
10642
  }, z.core.$strict>, z.ZodObject<{
10354
10643
  target: z.ZodLiteral<"kay.app">;
10355
10644
  slug: z.ZodLiteral<"sessions.annotate">;
@@ -10717,6 +11006,18 @@ export declare const PluginCapabilityRefusalV1: z.ZodObject<{
10717
11006
  target: z.ZodLiteral<"kay.app">;
10718
11007
  slug: z.ZodLiteral<"plugins.set-enabled">;
10719
11008
  envelope: z.ZodObject<{}, z.core.$strict>;
11009
+ }, z.core.$strict>, z.ZodObject<{
11010
+ target: z.ZodLiteral<"kay.app">;
11011
+ slug: z.ZodLiteral<"sessions.assign-project">;
11012
+ envelope: z.ZodObject<{}, z.core.$strict>;
11013
+ }, z.core.$strict>, z.ZodObject<{
11014
+ target: z.ZodLiteral<"kay.app">;
11015
+ slug: z.ZodLiteral<"artifacts.resolve-file">;
11016
+ envelope: z.ZodObject<{}, z.core.$strict>;
11017
+ }, z.core.$strict>, z.ZodObject<{
11018
+ target: z.ZodLiteral<"kay.app">;
11019
+ slug: z.ZodLiteral<"process.run">;
11020
+ envelope: z.ZodObject<{}, z.core.$strict>;
10720
11021
  }, z.core.$strict>, z.ZodObject<{
10721
11022
  target: z.ZodLiteral<"kay.app">;
10722
11023
  slug: z.ZodLiteral<"sessions.annotate">;
@@ -11034,8 +11335,8 @@ export declare const PluginConfigManifest: z.ZodArray<z.ZodObject<{
11034
11335
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
11035
11336
  defaults: z.ZodOptional<z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
11036
11337
  scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
11037
- global: "global";
11038
11338
  project: "project";
11339
+ global: "global";
11039
11340
  agent: "agent";
11040
11341
  }>>>;
11041
11342
  }, z.core.$strict>>;
@@ -11043,8 +11344,8 @@ export declare const PluginConfigManifest: z.ZodArray<z.ZodObject<{
11043
11344
  export declare type PluginConfigManifest = z.infer<typeof PluginConfigManifest>;
11044
11345
 
11045
11346
  export declare const PluginConfigScope: z.ZodEnum<{
11046
- global: "global";
11047
11347
  project: "project";
11348
+ global: "global";
11048
11349
  agent: "agent";
11049
11350
  }>;
11050
11351
 
@@ -11055,8 +11356,8 @@ export declare const PluginConfigSectionManifest: z.ZodObject<{
11055
11356
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
11056
11357
  defaults: z.ZodOptional<z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
11057
11358
  scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
11058
- global: "global";
11059
11359
  project: "project";
11360
+ global: "global";
11060
11361
  agent: "agent";
11061
11362
  }>>>;
11062
11363
  }, z.core.$strict>;
@@ -12034,6 +12335,18 @@ export declare interface PluginProductEventSend {
12034
12335
  readonly subjectUri?: string;
12035
12336
  }
12036
12337
 
12338
+ /**
12339
+ * A manifest's `projectDirectories` declaration: this plugin owns projects addressed at `scheme`,
12340
+ * and its app endpoint `endpoint` answers which folder a project is in. The host reads a
12341
+ * selected project's folder, default working directory and ancestors through that endpoint.
12342
+ */
12343
+ export declare const PluginProjectDirectories: z.ZodObject<{
12344
+ endpoint: z.ZodString;
12345
+ scheme: z.ZodString;
12346
+ }, z.core.$strict>;
12347
+
12348
+ export declare type PluginProjectDirectories = z.infer<typeof PluginProjectDirectories>;
12349
+
12037
12350
  export declare const PluginProvisioningProbe: z.ZodObject<{
12038
12351
  url: z.ZodURL;
12039
12352
  method: z.ZodOptional<z.ZodEnum<{
@@ -12278,6 +12591,33 @@ declare type PrereleaseIdentifier = string | number;
12278
12591
  */
12279
12592
  export declare const PRIVATE_PLUGIN_CAPABILITY_SLUGS: readonly PluginCapabilitySlug[];
12280
12593
 
12594
+ export declare const ProjectDirectory: z.ZodObject<{
12595
+ id: z.ZodString;
12596
+ path: z.ZodString;
12597
+ defaultCwd: z.ZodString;
12598
+ ancestorIds: z.ZodArray<z.ZodString>;
12599
+ }, z.core.$strict>;
12600
+
12601
+ export declare type ProjectDirectory = z.infer<typeof ProjectDirectory>;
12602
+
12603
+ export declare const ProjectDirectoryRequest: z.ZodObject<{
12604
+ id: z.ZodString;
12605
+ }, z.core.$strict>;
12606
+
12607
+ export declare type ProjectDirectoryRequest = z.infer<typeof ProjectDirectoryRequest>;
12608
+
12609
+ /** `project` is null when no project has the requested id. */
12610
+ export declare const ProjectDirectoryResponse: z.ZodObject<{
12611
+ project: z.ZodNullable<z.ZodObject<{
12612
+ id: z.ZodString;
12613
+ path: z.ZodString;
12614
+ defaultCwd: z.ZodString;
12615
+ ancestorIds: z.ZodArray<z.ZodString>;
12616
+ }, z.core.$strict>>;
12617
+ }, z.core.$strict>;
12618
+
12619
+ export declare type ProjectDirectoryResponse = z.infer<typeof ProjectDirectoryResponse>;
12620
+
12281
12621
  /**
12282
12622
  * What a manifest's JSON declares about compatibility, read the way a directory's verdict reads it:
12283
12623
  * apart from the strict schema, because a manifest written for another SDK may not pass that schema.
@@ -12985,6 +13325,7 @@ export declare const ResolvedKayAgentUriModule: z.ZodObject<{
12985
13325
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
12986
13326
  }, z.core.$strict>>;
12987
13327
  localId: z.ZodString;
13328
+ adapterId: z.ZodOptional<z.ZodString>;
12988
13329
  globalId: z.ZodString;
12989
13330
  schemes: z.ZodArray<z.ZodString>;
12990
13331
  displayName: z.ZodOptional<z.ZodString>;
@@ -13253,6 +13594,13 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
13253
13594
  }, z.core.$strict>]>>>;
13254
13595
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
13255
13596
  "navigation.open-session": "navigation.open-session";
13597
+ "navigation.open-external": "navigation.open-external";
13598
+ "configuration.read": "configuration.read";
13599
+ "auth-services.read": "auth-services.read";
13600
+ "connect-flows.read": "connect-flows.read";
13601
+ "connect-flows.dismiss": "connect-flows.dismiss";
13602
+ "support.report": "support.report";
13603
+ "navigation.open-page": "navigation.open-page";
13256
13604
  "sessions.create": "sessions.create";
13257
13605
  "models.complete": "models.complete";
13258
13606
  "artifacts.read": "artifacts.read";
@@ -13260,6 +13608,10 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
13260
13608
  "markdown.document-view": "markdown.document-view";
13261
13609
  "references.open": "references.open";
13262
13610
  "billing.read": "billing.read";
13611
+ "account.read": "account.read";
13612
+ "plugins.read": "plugins.read";
13613
+ "plugins.settings": "plugins.settings";
13614
+ "permissions.manage": "permissions.manage";
13263
13615
  "automations.read": "automations.read";
13264
13616
  "automations.run": "automations.run";
13265
13617
  "shared-artifacts.read": "shared-artifacts.read";
@@ -13324,9 +13676,11 @@ export declare const ResolvedPluginAuthScheme: z.ZodDiscriminatedUnion<[z.ZodDis
13324
13676
  globalId: z.ZodString;
13325
13677
  kind: z.ZodLiteral<"oauth2">;
13326
13678
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13679
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13327
13680
  authorizationUrl: z.ZodURL;
13328
13681
  tokenUrl: z.ZodURL;
13329
13682
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13683
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13330
13684
  displayName: z.ZodOptional<z.ZodString>;
13331
13685
  agentHint: z.ZodOptional<z.ZodString>;
13332
13686
  summary: z.ZodOptional<z.ZodString>;
@@ -13355,9 +13709,11 @@ export declare const ResolvedPluginAuthScheme: z.ZodDiscriminatedUnion<[z.ZodDis
13355
13709
  globalId: z.ZodString;
13356
13710
  kind: z.ZodLiteral<"oauth2">;
13357
13711
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13712
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13358
13713
  authorizationUrl: z.ZodURL;
13359
13714
  tokenUrl: z.ZodURL;
13360
13715
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13716
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13361
13717
  displayName: z.ZodOptional<z.ZodString>;
13362
13718
  agentHint: z.ZodOptional<z.ZodString>;
13363
13719
  summary: z.ZodOptional<z.ZodString>;
@@ -13493,9 +13849,11 @@ export declare const ResolvedPluginAuthService: z.ZodObject<{
13493
13849
  globalId: z.ZodString;
13494
13850
  kind: z.ZodLiteral<"oauth2">;
13495
13851
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13852
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13496
13853
  authorizationUrl: z.ZodURL;
13497
13854
  tokenUrl: z.ZodURL;
13498
13855
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13856
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13499
13857
  displayName: z.ZodOptional<z.ZodString>;
13500
13858
  agentHint: z.ZodOptional<z.ZodString>;
13501
13859
  summary: z.ZodOptional<z.ZodString>;
@@ -13524,9 +13882,11 @@ export declare const ResolvedPluginAuthService: z.ZodObject<{
13524
13882
  globalId: z.ZodString;
13525
13883
  kind: z.ZodLiteral<"oauth2">;
13526
13884
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13885
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13527
13886
  authorizationUrl: z.ZodURL;
13528
13887
  tokenUrl: z.ZodURL;
13529
13888
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13889
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13530
13890
  displayName: z.ZodOptional<z.ZodString>;
13531
13891
  agentHint: z.ZodOptional<z.ZodString>;
13532
13892
  summary: z.ZodOptional<z.ZodString>;
@@ -13713,6 +14073,10 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
13713
14073
  consumesAuthServices: z.ZodArray<z.ZodString>;
13714
14074
  explicitDependencies: z.ZodArray<z.ZodString>;
13715
14075
  dataDirSharedWith: z.ZodOptional<z.ZodString>;
14076
+ workers: z.ZodOptional<z.ZodArray<z.ZodObject<{
14077
+ localId: z.ZodString;
14078
+ module: z.ZodString;
14079
+ }, z.core.$strict>>>;
13716
14080
  workloadPurposes: z.ZodOptional<z.ZodArray<z.ZodObject<{
13717
14081
  purpose: z.ZodString;
13718
14082
  workloadClass: z.ZodEnum<{
@@ -13726,6 +14090,10 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
13726
14090
  usage: z.ZodString;
13727
14091
  endpointId: z.ZodString;
13728
14092
  }, z.core.$strict>>>;
14093
+ projectDirectories: z.ZodOptional<z.ZodObject<{
14094
+ scheme: z.ZodString;
14095
+ endpointId: z.ZodString;
14096
+ }, z.core.$strict>>;
13729
14097
  authServices: z.ZodArray<z.ZodObject<{
13730
14098
  localId: z.ZodString;
13731
14099
  globalId: z.ZodString;
@@ -13768,9 +14136,11 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
13768
14136
  globalId: z.ZodString;
13769
14137
  kind: z.ZodLiteral<"oauth2">;
13770
14138
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
14139
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13771
14140
  authorizationUrl: z.ZodURL;
13772
14141
  tokenUrl: z.ZodURL;
13773
14142
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
14143
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13774
14144
  displayName: z.ZodOptional<z.ZodString>;
13775
14145
  agentHint: z.ZodOptional<z.ZodString>;
13776
14146
  summary: z.ZodOptional<z.ZodString>;
@@ -13799,9 +14169,11 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
13799
14169
  globalId: z.ZodString;
13800
14170
  kind: z.ZodLiteral<"oauth2">;
13801
14171
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
14172
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13802
14173
  authorizationUrl: z.ZodURL;
13803
14174
  tokenUrl: z.ZodURL;
13804
14175
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
14176
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13805
14177
  displayName: z.ZodOptional<z.ZodString>;
13806
14178
  agentHint: z.ZodOptional<z.ZodString>;
13807
14179
  summary: z.ZodOptional<z.ZodString>;
@@ -14435,6 +14807,7 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14435
14807
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
14436
14808
  }, z.core.$strict>>;
14437
14809
  localId: z.ZodString;
14810
+ adapterId: z.ZodOptional<z.ZodString>;
14438
14811
  globalId: z.ZodString;
14439
14812
  schemes: z.ZodArray<z.ZodString>;
14440
14813
  displayName: z.ZodOptional<z.ZodString>;
@@ -14907,6 +15280,13 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14907
15280
  }, z.core.$strict>]>>>;
14908
15281
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
14909
15282
  "navigation.open-session": "navigation.open-session";
15283
+ "navigation.open-external": "navigation.open-external";
15284
+ "configuration.read": "configuration.read";
15285
+ "auth-services.read": "auth-services.read";
15286
+ "connect-flows.read": "connect-flows.read";
15287
+ "connect-flows.dismiss": "connect-flows.dismiss";
15288
+ "support.report": "support.report";
15289
+ "navigation.open-page": "navigation.open-page";
14910
15290
  "sessions.create": "sessions.create";
14911
15291
  "models.complete": "models.complete";
14912
15292
  "artifacts.read": "artifacts.read";
@@ -14914,6 +15294,10 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14914
15294
  "markdown.document-view": "markdown.document-view";
14915
15295
  "references.open": "references.open";
14916
15296
  "billing.read": "billing.read";
15297
+ "account.read": "account.read";
15298
+ "plugins.read": "plugins.read";
15299
+ "plugins.settings": "plugins.settings";
15300
+ "permissions.manage": "permissions.manage";
14917
15301
  "automations.read": "automations.read";
14918
15302
  "automations.run": "automations.run";
14919
15303
  "shared-artifacts.read": "shared-artifacts.read";
@@ -16790,6 +17174,13 @@ export declare const UiAppCapabilities: z.ZodObject<{
16790
17174
  }, z.core.$strict>]>>>;
16791
17175
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
16792
17176
  "navigation.open-session": "navigation.open-session";
17177
+ "navigation.open-external": "navigation.open-external";
17178
+ "configuration.read": "configuration.read";
17179
+ "auth-services.read": "auth-services.read";
17180
+ "connect-flows.read": "connect-flows.read";
17181
+ "connect-flows.dismiss": "connect-flows.dismiss";
17182
+ "support.report": "support.report";
17183
+ "navigation.open-page": "navigation.open-page";
16793
17184
  "sessions.create": "sessions.create";
16794
17185
  "models.complete": "models.complete";
16795
17186
  "artifacts.read": "artifacts.read";
@@ -16797,6 +17188,10 @@ export declare const UiAppCapabilities: z.ZodObject<{
16797
17188
  "markdown.document-view": "markdown.document-view";
16798
17189
  "references.open": "references.open";
16799
17190
  "billing.read": "billing.read";
17191
+ "account.read": "account.read";
17192
+ "plugins.read": "plugins.read";
17193
+ "plugins.settings": "plugins.settings";
17194
+ "permissions.manage": "permissions.manage";
16800
17195
  "automations.read": "automations.read";
16801
17196
  "automations.run": "automations.run";
16802
17197
  "shared-artifacts.read": "shared-artifacts.read";
@@ -16843,6 +17238,13 @@ export declare const UiAppContribution: z.ZodObject<{
16843
17238
  }, z.core.$strict>]>>>;
16844
17239
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
16845
17240
  "navigation.open-session": "navigation.open-session";
17241
+ "navigation.open-external": "navigation.open-external";
17242
+ "configuration.read": "configuration.read";
17243
+ "auth-services.read": "auth-services.read";
17244
+ "connect-flows.read": "connect-flows.read";
17245
+ "connect-flows.dismiss": "connect-flows.dismiss";
17246
+ "support.report": "support.report";
17247
+ "navigation.open-page": "navigation.open-page";
16846
17248
  "sessions.create": "sessions.create";
16847
17249
  "models.complete": "models.complete";
16848
17250
  "artifacts.read": "artifacts.read";
@@ -16850,6 +17252,10 @@ export declare const UiAppContribution: z.ZodObject<{
16850
17252
  "markdown.document-view": "markdown.document-view";
16851
17253
  "references.open": "references.open";
16852
17254
  "billing.read": "billing.read";
17255
+ "account.read": "account.read";
17256
+ "plugins.read": "plugins.read";
17257
+ "plugins.settings": "plugins.settings";
17258
+ "permissions.manage": "permissions.manage";
16853
17259
  "automations.read": "automations.read";
16854
17260
  "automations.run": "automations.run";
16855
17261
  "shared-artifacts.read": "shared-artifacts.read";
@@ -16886,6 +17292,13 @@ export declare const UiAppContribution: z.ZodObject<{
16886
17292
  }, z.core.$strict>]>>>;
16887
17293
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
16888
17294
  "navigation.open-session": "navigation.open-session";
17295
+ "navigation.open-external": "navigation.open-external";
17296
+ "configuration.read": "configuration.read";
17297
+ "auth-services.read": "auth-services.read";
17298
+ "connect-flows.read": "connect-flows.read";
17299
+ "connect-flows.dismiss": "connect-flows.dismiss";
17300
+ "support.report": "support.report";
17301
+ "navigation.open-page": "navigation.open-page";
16889
17302
  "sessions.create": "sessions.create";
16890
17303
  "models.complete": "models.complete";
16891
17304
  "artifacts.read": "artifacts.read";
@@ -16893,6 +17306,10 @@ export declare const UiAppContribution: z.ZodObject<{
16893
17306
  "markdown.document-view": "markdown.document-view";
16894
17307
  "references.open": "references.open";
16895
17308
  "billing.read": "billing.read";
17309
+ "account.read": "account.read";
17310
+ "plugins.read": "plugins.read";
17311
+ "plugins.settings": "plugins.settings";
17312
+ "permissions.manage": "permissions.manage";
16896
17313
  "automations.read": "automations.read";
16897
17314
  "automations.run": "automations.run";
16898
17315
  "shared-artifacts.read": "shared-artifacts.read";
@@ -16973,6 +17390,9 @@ export declare const UiPageContribution: z.ZodObject<{
16973
17390
  session: "session";
16974
17391
  family: "family";
16975
17392
  }>>;
17393
+ settings: z.ZodOptional<z.ZodObject<{
17394
+ order: z.ZodOptional<z.ZodNumber>;
17395
+ }, z.core.$strict>>;
16976
17396
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
16977
17397
  openedEvent: z.ZodOptional<z.ZodString>;
16978
17398
  }, z.core.$strict>;
@@ -16992,7 +17412,10 @@ export declare const UiRailEntryContribution: z.ZodObject<{
16992
17412
  plugins: "plugins";
16993
17413
  }>>;
16994
17414
  badge: z.ZodOptional<z.ZodObject<{
16995
- source: z.ZodString;
17415
+ source: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
17416
+ pluginId: z.ZodString;
17417
+ localId: z.ZodString;
17418
+ }, z.core.$strict>]>;
16996
17419
  where: z.ZodOptional<z.ZodString>;
16997
17420
  label: z.ZodObject<{
16998
17421
  one: z.ZodOptional<z.ZodString>;
@@ -17002,11 +17425,9 @@ export declare const UiRailEntryContribution: z.ZodObject<{
17002
17425
  panel: z.ZodOptional<z.ZodObject<{
17003
17426
  body: z.ZodString;
17004
17427
  }, z.core.$strict>>;
17005
- featureFlagVariant: z.ZodOptional<z.ZodObject<{
17428
+ visibleWhen: z.ZodOptional<z.ZodObject<{
17006
17429
  flag: z.ZodString;
17007
- title: z.ZodOptional<z.ZodString>;
17008
- icon: z.ZodOptional<z.ZodString>;
17009
- panel: z.ZodOptional<z.ZodLiteral<false>>;
17430
+ enabled: z.ZodBoolean;
17010
17431
  }, z.core.$strict>>;
17011
17432
  }, z.core.$strict>;
17012
17433
 
@@ -17222,6 +17643,7 @@ export declare const UriModuleContribution: z.ZodObject<{
17222
17643
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
17223
17644
  }, z.core.$strict>>;
17224
17645
  localId: z.ZodString;
17646
+ adapterId: z.ZodOptional<z.ZodString>;
17225
17647
  schemes: z.ZodArray<z.ZodString>;
17226
17648
  displayName: z.ZodOptional<z.ZodString>;
17227
17649
  }, z.core.$strict>;