@yaklabs-ai/plugin-protocol 0.52.1 → 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 +553 -13
  4. package/dist/index.js +957 -704
  5. package/package.json +1 -1
package/dist/index.d.ts CHANGED
@@ -199,6 +199,9 @@ export declare const AppDataSourceContribution: z.ZodObject<{
199
199
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
200
200
  }, z.core.$strict>;
201
201
  }, z.core.$strict>>;
202
+ messageDraft: z.ZodOptional<z.ZodObject<{
203
+ schemes: z.ZodArray<z.ZodString>;
204
+ }, z.core.$strict>>;
202
205
  store: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
203
206
  shape: z.ZodLiteral<"rows">;
204
207
  rowsField: z.ZodString;
@@ -820,13 +823,13 @@ export declare const ArtifactProvenanceCaptureContextSchema: z.ZodObject<{
820
823
  gaps: z.ZodArray<z.ZodObject<{
821
824
  code: z.ZodEnum<{
822
825
  unknown: "unknown";
826
+ truncated: "truncated";
823
827
  "capture-failed": "capture-failed";
824
828
  "legacy-derived": "legacy-derived";
825
829
  "ambiguous-predecessor": "ambiguous-predecessor";
826
830
  "unverified-index": "unverified-index";
827
831
  "missing-ancestor": "missing-ancestor";
828
832
  cycle: "cycle";
829
- truncated: "truncated";
830
833
  "metadata-write-failed": "metadata-write-failed";
831
834
  "invalid-record": "invalid-record";
832
835
  }>;
@@ -1209,13 +1212,13 @@ export declare const ArtifactProvenanceEnvelopeV1: z.ZodPipe<z.ZodUnknown, z.Zod
1209
1212
  gaps: z.ZodArray<z.ZodObject<{
1210
1213
  code: z.ZodEnum<{
1211
1214
  unknown: "unknown";
1215
+ truncated: "truncated";
1212
1216
  "capture-failed": "capture-failed";
1213
1217
  "legacy-derived": "legacy-derived";
1214
1218
  "ambiguous-predecessor": "ambiguous-predecessor";
1215
1219
  "unverified-index": "unverified-index";
1216
1220
  "missing-ancestor": "missing-ancestor";
1217
1221
  cycle: "cycle";
1218
- truncated: "truncated";
1219
1222
  "metadata-write-failed": "metadata-write-failed";
1220
1223
  "invalid-record": "invalid-record";
1221
1224
  }>;
@@ -1229,13 +1232,13 @@ export declare type ArtifactProvenanceEnvelopeV1 = z.infer<typeof ArtifactProven
1229
1232
  export declare const ArtifactProvenanceGap: z.ZodObject<{
1230
1233
  code: z.ZodEnum<{
1231
1234
  unknown: "unknown";
1235
+ truncated: "truncated";
1232
1236
  "capture-failed": "capture-failed";
1233
1237
  "legacy-derived": "legacy-derived";
1234
1238
  "ambiguous-predecessor": "ambiguous-predecessor";
1235
1239
  "unverified-index": "unverified-index";
1236
1240
  "missing-ancestor": "missing-ancestor";
1237
1241
  cycle: "cycle";
1238
- truncated: "truncated";
1239
1242
  "metadata-write-failed": "metadata-write-failed";
1240
1243
  "invalid-record": "invalid-record";
1241
1244
  }>;
@@ -2539,6 +2542,7 @@ declare const canonicalContributionSchemas: {
2539
2542
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
2540
2543
  }, z.core.$strict>>;
2541
2544
  localId: z.ZodString;
2545
+ adapterId: z.ZodOptional<z.ZodString>;
2542
2546
  schemes: z.ZodArray<z.ZodString>;
2543
2547
  displayName: z.ZodOptional<z.ZodString>;
2544
2548
  }, z.core.$strict>;
@@ -2728,6 +2732,9 @@ declare const canonicalContributionSchemas: {
2728
2732
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
2729
2733
  }, z.core.$strict>;
2730
2734
  }, z.core.$strict>>;
2735
+ messageDraft: z.ZodOptional<z.ZodObject<{
2736
+ schemes: z.ZodArray<z.ZodString>;
2737
+ }, z.core.$strict>>;
2731
2738
  store: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
2732
2739
  shape: z.ZodLiteral<"rows">;
2733
2740
  rowsField: z.ZodString;
@@ -2757,6 +2764,11 @@ declare const canonicalContributionSchemas: {
2757
2764
  bodyField: z.ZodString;
2758
2765
  }, z.core.$strict>], "kind">;
2759
2766
  valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
2767
+ directory: z.ZodOptional<z.ZodArray<z.ZodString>>;
2768
+ reference: z.ZodOptional<z.ZodObject<{
2769
+ uriTemplate: z.ZodString;
2770
+ }, z.core.$strict>>;
2771
+ handover: z.ZodOptional<z.ZodLiteral<true>>;
2760
2772
  }, z.core.$strict>;
2761
2773
  AppDataMaterializerContribution: z.ZodObject<{
2762
2774
  source: z.ZodString;
@@ -3023,6 +3035,8 @@ declare const canonicalContributionSchemas: {
3023
3035
  search: z.ZodOptional<z.ZodString>;
3024
3036
  }, z.core.$strict>;
3025
3037
  objectId: z.ZodOptional<z.ZodString>;
3038
+ resourceKind: z.ZodOptional<z.ZodString>;
3039
+ label: z.ZodOptional<z.ZodString>;
3026
3040
  open: z.ZodOptional<z.ZodObject<{
3027
3041
  kind: z.ZodLiteral<"none">;
3028
3042
  }, z.core.$strict>>;
@@ -3101,6 +3115,8 @@ declare const canonicalContributionSchemas: {
3101
3115
  search: z.ZodOptional<z.ZodString>;
3102
3116
  }, z.core.$strict>;
3103
3117
  objectId: z.ZodOptional<z.ZodString>;
3118
+ resourceKind: z.ZodOptional<z.ZodString>;
3119
+ label: z.ZodOptional<z.ZodString>;
3104
3120
  open: z.ZodOptional<z.ZodObject<{
3105
3121
  kind: z.ZodLiteral<"none">;
3106
3122
  }, z.core.$strict>>;
@@ -3208,6 +3224,13 @@ declare const canonicalContributionSchemas: {
3208
3224
  }, z.core.$strict>;
3209
3225
  KayUiAppHostCapability: z.ZodEnum<{
3210
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";
3211
3234
  "sessions.create": "sessions.create";
3212
3235
  "models.complete": "models.complete";
3213
3236
  "artifacts.read": "artifacts.read";
@@ -3215,6 +3238,10 @@ declare const canonicalContributionSchemas: {
3215
3238
  "markdown.document-view": "markdown.document-view";
3216
3239
  "references.open": "references.open";
3217
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";
3218
3245
  "automations.read": "automations.read";
3219
3246
  "automations.run": "automations.run";
3220
3247
  "shared-artifacts.read": "shared-artifacts.read";
@@ -3234,6 +3261,13 @@ declare const canonicalContributionSchemas: {
3234
3261
  }, z.core.$strict>]>>>;
3235
3262
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
3236
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";
3237
3271
  "sessions.create": "sessions.create";
3238
3272
  "models.complete": "models.complete";
3239
3273
  "artifacts.read": "artifacts.read";
@@ -3241,6 +3275,10 @@ declare const canonicalContributionSchemas: {
3241
3275
  "markdown.document-view": "markdown.document-view";
3242
3276
  "references.open": "references.open";
3243
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";
3244
3282
  "automations.read": "automations.read";
3245
3283
  "automations.run": "automations.run";
3246
3284
  "shared-artifacts.read": "shared-artifacts.read";
@@ -3294,6 +3332,14 @@ declare const canonicalContributionSchemas: {
3294
3332
  title: z.ZodOptional<z.ZodString>;
3295
3333
  icon: z.ZodOptional<z.ZodString>;
3296
3334
  companion: z.ZodOptional<z.ZodBoolean>;
3335
+ sessionBinding: z.ZodOptional<z.ZodEnum<{
3336
+ session: "session";
3337
+ family: "family";
3338
+ }>>;
3339
+ settings: z.ZodOptional<z.ZodObject<{
3340
+ order: z.ZodOptional<z.ZodNumber>;
3341
+ }, z.core.$strict>>;
3342
+ aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
3297
3343
  openedEvent: z.ZodOptional<z.ZodString>;
3298
3344
  }, z.core.$strict>;
3299
3345
  UiAppContribution: z.ZodObject<{
@@ -3319,6 +3365,13 @@ declare const canonicalContributionSchemas: {
3319
3365
  }, z.core.$strict>]>>>;
3320
3366
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
3321
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";
3322
3375
  "sessions.create": "sessions.create";
3323
3376
  "models.complete": "models.complete";
3324
3377
  "artifacts.read": "artifacts.read";
@@ -3326,6 +3379,10 @@ declare const canonicalContributionSchemas: {
3326
3379
  "markdown.document-view": "markdown.document-view";
3327
3380
  "references.open": "references.open";
3328
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";
3329
3386
  "automations.read": "automations.read";
3330
3387
  "automations.run": "automations.run";
3331
3388
  "shared-artifacts.read": "shared-artifacts.read";
@@ -3362,6 +3419,13 @@ declare const canonicalContributionSchemas: {
3362
3419
  }, z.core.$strict>]>>>;
3363
3420
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
3364
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";
3365
3429
  "sessions.create": "sessions.create";
3366
3430
  "models.complete": "models.complete";
3367
3431
  "artifacts.read": "artifacts.read";
@@ -3369,6 +3433,10 @@ declare const canonicalContributionSchemas: {
3369
3433
  "markdown.document-view": "markdown.document-view";
3370
3434
  "references.open": "references.open";
3371
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";
3372
3440
  "automations.read": "automations.read";
3373
3441
  "automations.run": "automations.run";
3374
3442
  "shared-artifacts.read": "shared-artifacts.read";
@@ -4817,8 +4885,16 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
4817
4885
  * 0.52.0 adds plugin-owned operational facts through existing manifests and registrations.
4818
4886
  *
4819
4887
  * 0.52.1 adds owner-qualified page feed and endpoint references and their kay.ui claims.
4888
+ *
4889
+ * 0.53.0 adds declared working-content layouts, family-root authority, draft projection discovery
4890
+ * and session-bound page references. Older customized Whiteboard copies must accept the plugin
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[].
4820
4896
  */
4821
- export declare const KAY_PLUGIN_SDK_VERSION: "0.52.1";
4897
+ export declare const KAY_PLUGIN_SDK_VERSION: "0.54.0";
4822
4898
 
4823
4899
  export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
4824
4900
 
@@ -5092,6 +5168,7 @@ export declare const KayAgentTargetManifest: z.ZodObject<{
5092
5168
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
5093
5169
  }, z.core.$strict>>;
5094
5170
  localId: z.ZodString;
5171
+ adapterId: z.ZodOptional<z.ZodString>;
5095
5172
  schemes: z.ZodArray<z.ZodString>;
5096
5173
  displayName: z.ZodOptional<z.ZodString>;
5097
5174
  }, z.core.$strict>>>;
@@ -5182,6 +5259,10 @@ export declare const KayAgentTargetManifest: z.ZodObject<{
5182
5259
  primer: z.ZodOptional<z.ZodString>;
5183
5260
  onboarding: z.ZodOptional<z.ZodString>;
5184
5261
  prompt: z.ZodOptional<z.ZodString>;
5262
+ promptOrder: z.ZodOptional<z.ZodNumber>;
5263
+ familyFolder: z.ZodOptional<z.ZodObject<{
5264
+ scope: z.ZodLiteral<"root">;
5265
+ }, z.core.$strict>>;
5185
5266
  skillSources: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
5186
5267
  channel: z.ZodLiteral<"installer">;
5187
5268
  localId: z.ZodString;
@@ -5459,6 +5540,9 @@ export declare const KayAppTargetManifest: z.ZodObject<{
5459
5540
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
5460
5541
  }, z.core.$strict>;
5461
5542
  }, z.core.$strict>>;
5543
+ messageDraft: z.ZodOptional<z.ZodObject<{
5544
+ schemes: z.ZodArray<z.ZodString>;
5545
+ }, z.core.$strict>>;
5462
5546
  store: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
5463
5547
  shape: z.ZodLiteral<"rows">;
5464
5548
  rowsField: z.ZodString;
@@ -5480,6 +5564,11 @@ export declare const KayAppTargetManifest: z.ZodObject<{
5480
5564
  bodyField: z.ZodString;
5481
5565
  }, z.core.$strict>], "kind">;
5482
5566
  valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
5567
+ directory: z.ZodOptional<z.ZodArray<z.ZodString>>;
5568
+ reference: z.ZodOptional<z.ZodObject<{
5569
+ uriTemplate: z.ZodString;
5570
+ }, z.core.$strict>>;
5571
+ handover: z.ZodOptional<z.ZodLiteral<true>>;
5483
5572
  }, z.core.$strict>>>;
5484
5573
  approvalTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
5485
5574
  localId: z.ZodString;
@@ -6013,6 +6102,7 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6013
6102
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
6014
6103
  }, z.core.$strict>>;
6015
6104
  localId: z.ZodString;
6105
+ adapterId: z.ZodOptional<z.ZodString>;
6016
6106
  schemes: z.ZodArray<z.ZodString>;
6017
6107
  displayName: z.ZodOptional<z.ZodString>;
6018
6108
  }, z.core.$strict>>>;
@@ -6103,6 +6193,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6103
6193
  primer: z.ZodOptional<z.ZodString>;
6104
6194
  onboarding: z.ZodOptional<z.ZodString>;
6105
6195
  prompt: z.ZodOptional<z.ZodString>;
6196
+ promptOrder: z.ZodOptional<z.ZodNumber>;
6197
+ familyFolder: z.ZodOptional<z.ZodObject<{
6198
+ scope: z.ZodLiteral<"root">;
6199
+ }, z.core.$strict>>;
6106
6200
  skillSources: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
6107
6201
  channel: z.ZodLiteral<"installer">;
6108
6202
  localId: z.ZodString;
@@ -6377,6 +6471,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6377
6471
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
6378
6472
  }, z.core.$strict>;
6379
6473
  }, z.core.$strict>>;
6474
+ messageDraft: z.ZodOptional<z.ZodObject<{
6475
+ schemes: z.ZodArray<z.ZodString>;
6476
+ }, z.core.$strict>>;
6380
6477
  store: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
6381
6478
  shape: z.ZodLiteral<"rows">;
6382
6479
  rowsField: z.ZodString;
@@ -6398,6 +6495,11 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6398
6495
  bodyField: z.ZodString;
6399
6496
  }, z.core.$strict>], "kind">;
6400
6497
  valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
6498
+ directory: z.ZodOptional<z.ZodArray<z.ZodString>>;
6499
+ reference: z.ZodOptional<z.ZodObject<{
6500
+ uriTemplate: z.ZodString;
6501
+ }, z.core.$strict>>;
6502
+ handover: z.ZodOptional<z.ZodLiteral<true>>;
6401
6503
  }, z.core.$strict>>>;
6402
6504
  approvalTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
6403
6505
  localId: z.ZodString;
@@ -6601,6 +6703,8 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6601
6703
  search: z.ZodOptional<z.ZodString>;
6602
6704
  }, z.core.$strict>;
6603
6705
  objectId: z.ZodOptional<z.ZodString>;
6706
+ resourceKind: z.ZodOptional<z.ZodString>;
6707
+ label: z.ZodOptional<z.ZodString>;
6604
6708
  open: z.ZodOptional<z.ZodObject<{
6605
6709
  kind: z.ZodLiteral<"none">;
6606
6710
  }, z.core.$strict>>;
@@ -6729,6 +6833,13 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6729
6833
  }, z.core.$strict>]>>>;
6730
6834
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
6731
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";
6732
6843
  "sessions.create": "sessions.create";
6733
6844
  "models.complete": "models.complete";
6734
6845
  "artifacts.read": "artifacts.read";
@@ -6736,6 +6847,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6736
6847
  "markdown.document-view": "markdown.document-view";
6737
6848
  "references.open": "references.open";
6738
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";
6739
6854
  "automations.read": "automations.read";
6740
6855
  "automations.run": "automations.run";
6741
6856
  "shared-artifacts.read": "shared-artifacts.read";
@@ -6772,6 +6887,13 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6772
6887
  }, z.core.$strict>]>>>;
6773
6888
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
6774
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";
6775
6897
  "sessions.create": "sessions.create";
6776
6898
  "models.complete": "models.complete";
6777
6899
  "artifacts.read": "artifacts.read";
@@ -6779,6 +6901,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6779
6901
  "markdown.document-view": "markdown.document-view";
6780
6902
  "references.open": "references.open";
6781
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";
6782
6908
  "automations.read": "automations.read";
6783
6909
  "automations.run": "automations.run";
6784
6910
  "shared-artifacts.read": "shared-artifacts.read";
@@ -6833,6 +6959,14 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6833
6959
  title: z.ZodOptional<z.ZodString>;
6834
6960
  icon: z.ZodOptional<z.ZodString>;
6835
6961
  companion: z.ZodOptional<z.ZodBoolean>;
6962
+ sessionBinding: z.ZodOptional<z.ZodEnum<{
6963
+ session: "session";
6964
+ family: "family";
6965
+ }>>;
6966
+ settings: z.ZodOptional<z.ZodObject<{
6967
+ order: z.ZodOptional<z.ZodNumber>;
6968
+ }, z.core.$strict>>;
6969
+ aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
6836
6970
  openedEvent: z.ZodOptional<z.ZodString>;
6837
6971
  }, z.core.$strict>>>;
6838
6972
  themes: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -6860,8 +6994,8 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6860
6994
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
6861
6995
  defaults: z.ZodOptional<z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
6862
6996
  scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
6863
- global: "global";
6864
6997
  project: "project";
6998
+ global: "global";
6865
6999
  agent: "agent";
6866
7000
  }>>>;
6867
7001
  }, z.core.$strict>>>;
@@ -6890,6 +7024,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6890
7024
  endpoint: z.ZodString;
6891
7025
  usage: z.ZodString;
6892
7026
  }, z.core.$strict>>>;
7027
+ projectDirectories: z.ZodOptional<z.ZodObject<{
7028
+ endpoint: z.ZodString;
7029
+ scheme: z.ZodString;
7030
+ }, z.core.$strict>>;
6893
7031
  auth: z.ZodOptional<z.ZodObject<{
6894
7032
  services: z.ZodOptional<z.ZodArray<z.ZodObject<{
6895
7033
  localId: z.ZodString;
@@ -6933,7 +7071,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6933
7071
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
6934
7072
  authorizationUrl: z.ZodURL;
6935
7073
  tokenUrl: z.ZodURL;
7074
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
6936
7075
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7076
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6937
7077
  displayName: z.ZodOptional<z.ZodString>;
6938
7078
  agentHint: z.ZodOptional<z.ZodString>;
6939
7079
  summary: z.ZodOptional<z.ZodString>;
@@ -6960,7 +7100,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
6960
7100
  account: z.ZodUnion<readonly [z.ZodLiteral<"lookup">, z.ZodLiteral<"sign-in">]>;
6961
7101
  authorizationUrl: z.ZodURL;
6962
7102
  tokenUrl: z.ZodURL;
7103
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
6963
7104
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
7105
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6964
7106
  displayName: z.ZodOptional<z.ZodString>;
6965
7107
  agentHint: z.ZodOptional<z.ZodString>;
6966
7108
  summary: z.ZodOptional<z.ZodString>;
@@ -7769,6 +7911,13 @@ export declare interface KayPluginTreeReader {
7769
7911
 
7770
7912
  export declare const KayUiAppHostCapability: z.ZodEnum<{
7771
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";
7772
7921
  "sessions.create": "sessions.create";
7773
7922
  "models.complete": "models.complete";
7774
7923
  "artifacts.read": "artifacts.read";
@@ -7776,6 +7925,10 @@ export declare const KayUiAppHostCapability: z.ZodEnum<{
7776
7925
  "markdown.document-view": "markdown.document-view";
7777
7926
  "references.open": "references.open";
7778
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";
7779
7932
  "automations.read": "automations.read";
7780
7933
  "automations.run": "automations.run";
7781
7934
  "shared-artifacts.read": "shared-artifacts.read";
@@ -7919,6 +8072,8 @@ export declare const KayUiTargetManifest: z.ZodObject<{
7919
8072
  search: z.ZodOptional<z.ZodString>;
7920
8073
  }, z.core.$strict>;
7921
8074
  objectId: z.ZodOptional<z.ZodString>;
8075
+ resourceKind: z.ZodOptional<z.ZodString>;
8076
+ label: z.ZodOptional<z.ZodString>;
7922
8077
  open: z.ZodOptional<z.ZodObject<{
7923
8078
  kind: z.ZodLiteral<"none">;
7924
8079
  }, z.core.$strict>>;
@@ -8047,6 +8202,13 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8047
8202
  }, z.core.$strict>]>>>;
8048
8203
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
8049
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";
8050
8212
  "sessions.create": "sessions.create";
8051
8213
  "models.complete": "models.complete";
8052
8214
  "artifacts.read": "artifacts.read";
@@ -8054,6 +8216,10 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8054
8216
  "markdown.document-view": "markdown.document-view";
8055
8217
  "references.open": "references.open";
8056
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";
8057
8223
  "automations.read": "automations.read";
8058
8224
  "automations.run": "automations.run";
8059
8225
  "shared-artifacts.read": "shared-artifacts.read";
@@ -8090,6 +8256,13 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8090
8256
  }, z.core.$strict>]>>>;
8091
8257
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
8092
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";
8093
8266
  "sessions.create": "sessions.create";
8094
8267
  "models.complete": "models.complete";
8095
8268
  "artifacts.read": "artifacts.read";
@@ -8097,6 +8270,10 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8097
8270
  "markdown.document-view": "markdown.document-view";
8098
8271
  "references.open": "references.open";
8099
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";
8100
8277
  "automations.read": "automations.read";
8101
8278
  "automations.run": "automations.run";
8102
8279
  "shared-artifacts.read": "shared-artifacts.read";
@@ -8151,6 +8328,14 @@ export declare const KayUiTargetManifest: z.ZodObject<{
8151
8328
  title: z.ZodOptional<z.ZodString>;
8152
8329
  icon: z.ZodOptional<z.ZodString>;
8153
8330
  companion: z.ZodOptional<z.ZodBoolean>;
8331
+ sessionBinding: z.ZodOptional<z.ZodEnum<{
8332
+ session: "session";
8333
+ family: "family";
8334
+ }>>;
8335
+ settings: z.ZodOptional<z.ZodObject<{
8336
+ order: z.ZodOptional<z.ZodNumber>;
8337
+ }, z.core.$strict>>;
8338
+ aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
8154
8339
  openedEvent: z.ZodOptional<z.ZodString>;
8155
8340
  }, z.core.$strict>>>;
8156
8341
  themes: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -8212,6 +8397,9 @@ export declare const McpServerAuthMode: z.ZodEnum<{
8212
8397
 
8213
8398
  export declare type McpServerAuthMode = z.infer<typeof McpServerAuthMode>;
8214
8399
 
8400
+ /** The connection state published for one configured MCP server. */
8401
+ export declare type McpServerConnectionState = "disconnected" | "connecting" | "connected" | "needs-auth" | "failed";
8402
+
8215
8403
  export declare const McpServerContribution: z.ZodObject<{
8216
8404
  url: z.ZodString;
8217
8405
  auth: z.ZodOptional<z.ZodEnum<{
@@ -8236,6 +8424,87 @@ export declare const McpServerContributions: z.ZodRecord<z.ZodString, z.ZodObjec
8236
8424
 
8237
8425
  export declare type McpServerContributions = z.infer<typeof McpServerContributions>;
8238
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
+
8239
8508
  export declare const McpServerUrl: z.ZodString;
8240
8509
 
8241
8510
  export declare type McpServerUrl = z.infer<typeof McpServerUrl>;
@@ -8368,7 +8637,7 @@ export declare function parseSemver(value: string): ParsedSemver | undefined;
8368
8637
  export declare function parseWhere(source: string, keyTypes?: WhereKeyTypes): WhereParseResult;
8369
8638
 
8370
8639
  /** Every capability slug {@link PluginCapabilityClaimV1} can express, for exhaustive table checks. */
8371
- 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", "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"];
8372
8641
 
8373
8642
  /** Diagnostic messages carry plugin-controlled text (parse errors, module errors); bound it so a
8374
8643
  * hostile or accidental multi-megabyte error can never blow up a log line or a render surface. */
@@ -8471,7 +8740,9 @@ export declare const PluginAuthManifest: z.ZodObject<{
8471
8740
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8472
8741
  authorizationUrl: z.ZodURL;
8473
8742
  tokenUrl: z.ZodURL;
8743
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8474
8744
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8745
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8475
8746
  displayName: z.ZodOptional<z.ZodString>;
8476
8747
  agentHint: z.ZodOptional<z.ZodString>;
8477
8748
  summary: z.ZodOptional<z.ZodString>;
@@ -8498,7 +8769,9 @@ export declare const PluginAuthManifest: z.ZodObject<{
8498
8769
  account: z.ZodUnion<readonly [z.ZodLiteral<"lookup">, z.ZodLiteral<"sign-in">]>;
8499
8770
  authorizationUrl: z.ZodURL;
8500
8771
  tokenUrl: z.ZodURL;
8772
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8501
8773
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8774
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8502
8775
  displayName: z.ZodOptional<z.ZodString>;
8503
8776
  agentHint: z.ZodOptional<z.ZodString>;
8504
8777
  summary: z.ZodOptional<z.ZodString>;
@@ -8651,7 +8924,9 @@ export declare const PluginAuthScheme: z.ZodDiscriminatedUnion<[z.ZodDiscriminat
8651
8924
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8652
8925
  authorizationUrl: z.ZodURL;
8653
8926
  tokenUrl: z.ZodURL;
8927
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8654
8928
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8929
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8655
8930
  displayName: z.ZodOptional<z.ZodString>;
8656
8931
  agentHint: z.ZodOptional<z.ZodString>;
8657
8932
  summary: z.ZodOptional<z.ZodString>;
@@ -8678,7 +8953,9 @@ export declare const PluginAuthScheme: z.ZodDiscriminatedUnion<[z.ZodDiscriminat
8678
8953
  account: z.ZodUnion<readonly [z.ZodLiteral<"lookup">, z.ZodLiteral<"sign-in">]>;
8679
8954
  authorizationUrl: z.ZodURL;
8680
8955
  tokenUrl: z.ZodURL;
8956
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8681
8957
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8958
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8682
8959
  displayName: z.ZodOptional<z.ZodString>;
8683
8960
  agentHint: z.ZodOptional<z.ZodString>;
8684
8961
  summary: z.ZodOptional<z.ZodString>;
@@ -8811,7 +9088,9 @@ export declare const PluginAuthService: z.ZodObject<{
8811
9088
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8812
9089
  authorizationUrl: z.ZodURL;
8813
9090
  tokenUrl: z.ZodURL;
9091
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8814
9092
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
9093
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8815
9094
  displayName: z.ZodOptional<z.ZodString>;
8816
9095
  agentHint: z.ZodOptional<z.ZodString>;
8817
9096
  summary: z.ZodOptional<z.ZodString>;
@@ -8838,7 +9117,9 @@ export declare const PluginAuthService: z.ZodObject<{
8838
9117
  account: z.ZodUnion<readonly [z.ZodLiteral<"lookup">, z.ZodLiteral<"sign-in">]>;
8839
9118
  authorizationUrl: z.ZodURL;
8840
9119
  tokenUrl: z.ZodURL;
9120
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
8841
9121
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
9122
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
8842
9123
  displayName: z.ZodOptional<z.ZodString>;
8843
9124
  agentHint: z.ZodOptional<z.ZodString>;
8844
9125
  summary: z.ZodOptional<z.ZodString>;
@@ -9055,6 +9336,18 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
9055
9336
  target: "kay.app";
9056
9337
  slug: "plugins.set-enabled";
9057
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>;
9058
9351
  } | {
9059
9352
  target: "kay.app";
9060
9353
  slug: "sessions.annotate";
@@ -9254,6 +9547,10 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
9254
9547
  command: string;
9255
9548
  args: string[];
9256
9549
  };
9550
+ } | {
9551
+ target: "kay.agent";
9552
+ slug: "family-folder.root";
9553
+ envelope: Record<string, never>;
9257
9554
  }, {
9258
9555
  target: "kay.agent" | "kay.app";
9259
9556
  slug: "whiteboard.discover" | "whiteboard.read" | "whiteboard.create" | "whiteboard.update" | "whiteboard.remove";
@@ -9329,6 +9626,18 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
9329
9626
  target: "kay.app";
9330
9627
  slug: "plugins.set-enabled";
9331
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>;
9332
9641
  } | {
9333
9642
  target: "kay.app";
9334
9643
  slug: "sessions.annotate";
@@ -9528,6 +9837,10 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
9528
9837
  command: string;
9529
9838
  args: string[];
9530
9839
  };
9840
+ } | {
9841
+ target: "kay.agent";
9842
+ slug: "family-folder.root";
9843
+ envelope: Record<string, never>;
9531
9844
  }>;
9532
9845
 
9533
9846
  export declare const PluginCapabilityClaimV1: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -9613,6 +9926,18 @@ export declare const PluginCapabilityClaimV1: z.ZodDiscriminatedUnion<[z.ZodObje
9613
9926
  target: z.ZodLiteral<"kay.app">;
9614
9927
  slug: z.ZodLiteral<"plugins.set-enabled">;
9615
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>;
9616
9941
  }, z.core.$strict>, z.ZodObject<{
9617
9942
  target: z.ZodLiteral<"kay.app">;
9618
9943
  slug: z.ZodLiteral<"sessions.annotate">;
@@ -9836,6 +10161,10 @@ export declare const PluginCapabilityClaimV1: z.ZodDiscriminatedUnion<[z.ZodObje
9836
10161
  command: z.ZodString;
9837
10162
  args: z.ZodArray<z.ZodString>;
9838
10163
  }, z.core.$strict>], "channel">;
10164
+ }, z.core.$strict>, z.ZodObject<{
10165
+ target: z.ZodLiteral<"kay.agent">;
10166
+ slug: z.ZodLiteral<"family-folder.root">;
10167
+ envelope: z.ZodObject<{}, z.core.$strict>;
9839
10168
  }, z.core.$strict>, z.ZodObject<{
9840
10169
  target: z.ZodEnum<{
9841
10170
  "kay.agent": "kay.agent";
@@ -9943,6 +10272,18 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
9943
10272
  target: z.ZodLiteral<"kay.app">;
9944
10273
  slug: z.ZodLiteral<"plugins.set-enabled">;
9945
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>;
9946
10287
  }, z.core.$strict>, z.ZodObject<{
9947
10288
  target: z.ZodLiteral<"kay.app">;
9948
10289
  slug: z.ZodLiteral<"sessions.annotate">;
@@ -10166,6 +10507,10 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
10166
10507
  command: z.ZodString;
10167
10508
  args: z.ZodArray<z.ZodString>;
10168
10509
  }, z.core.$strict>], "channel">;
10510
+ }, z.core.$strict>, z.ZodObject<{
10511
+ target: z.ZodLiteral<"kay.agent">;
10512
+ slug: z.ZodLiteral<"family-folder.root">;
10513
+ envelope: z.ZodObject<{}, z.core.$strict>;
10169
10514
  }, z.core.$strict>, z.ZodObject<{
10170
10515
  target: z.ZodEnum<{
10171
10516
  "kay.agent": "kay.agent";
@@ -10272,6 +10617,18 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
10272
10617
  target: z.ZodLiteral<"kay.app">;
10273
10618
  slug: z.ZodLiteral<"plugins.set-enabled">;
10274
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>;
10275
10632
  }, z.core.$strict>, z.ZodObject<{
10276
10633
  target: z.ZodLiteral<"kay.app">;
10277
10634
  slug: z.ZodLiteral<"sessions.annotate">;
@@ -10495,6 +10852,10 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
10495
10852
  command: z.ZodString;
10496
10853
  args: z.ZodArray<z.ZodString>;
10497
10854
  }, z.core.$strict>], "channel">;
10855
+ }, z.core.$strict>, z.ZodObject<{
10856
+ target: z.ZodLiteral<"kay.agent">;
10857
+ slug: z.ZodLiteral<"family-folder.root">;
10858
+ envelope: z.ZodObject<{}, z.core.$strict>;
10498
10859
  }, z.core.$strict>, z.ZodObject<{
10499
10860
  target: z.ZodEnum<{
10500
10861
  "kay.agent": "kay.agent";
@@ -10635,6 +10996,18 @@ export declare const PluginCapabilityRefusalV1: z.ZodObject<{
10635
10996
  target: z.ZodLiteral<"kay.app">;
10636
10997
  slug: z.ZodLiteral<"plugins.set-enabled">;
10637
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>;
10638
11011
  }, z.core.$strict>, z.ZodObject<{
10639
11012
  target: z.ZodLiteral<"kay.app">;
10640
11013
  slug: z.ZodLiteral<"sessions.annotate">;
@@ -10858,6 +11231,10 @@ export declare const PluginCapabilityRefusalV1: z.ZodObject<{
10858
11231
  command: z.ZodString;
10859
11232
  args: z.ZodArray<z.ZodString>;
10860
11233
  }, z.core.$strict>], "channel">;
11234
+ }, z.core.$strict>, z.ZodObject<{
11235
+ target: z.ZodLiteral<"kay.agent">;
11236
+ slug: z.ZodLiteral<"family-folder.root">;
11237
+ envelope: z.ZodObject<{}, z.core.$strict>;
10861
11238
  }, z.core.$strict>, z.ZodObject<{
10862
11239
  target: z.ZodEnum<{
10863
11240
  "kay.agent": "kay.agent";
@@ -10948,8 +11325,8 @@ export declare const PluginConfigManifest: z.ZodArray<z.ZodObject<{
10948
11325
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
10949
11326
  defaults: z.ZodOptional<z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
10950
11327
  scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
10951
- global: "global";
10952
11328
  project: "project";
11329
+ global: "global";
10953
11330
  agent: "agent";
10954
11331
  }>>>;
10955
11332
  }, z.core.$strict>>;
@@ -10957,8 +11334,8 @@ export declare const PluginConfigManifest: z.ZodArray<z.ZodObject<{
10957
11334
  export declare type PluginConfigManifest = z.infer<typeof PluginConfigManifest>;
10958
11335
 
10959
11336
  export declare const PluginConfigScope: z.ZodEnum<{
10960
- global: "global";
10961
11337
  project: "project";
11338
+ global: "global";
10962
11339
  agent: "agent";
10963
11340
  }>;
10964
11341
 
@@ -10969,8 +11346,8 @@ export declare const PluginConfigSectionManifest: z.ZodObject<{
10969
11346
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
10970
11347
  defaults: z.ZodOptional<z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
10971
11348
  scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
10972
- global: "global";
10973
11349
  project: "project";
11350
+ global: "global";
10974
11351
  agent: "agent";
10975
11352
  }>>>;
10976
11353
  }, z.core.$strict>;
@@ -11948,6 +12325,18 @@ export declare interface PluginProductEventSend {
11948
12325
  readonly subjectUri?: string;
11949
12326
  }
11950
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
+
11951
12340
  export declare const PluginProvisioningProbe: z.ZodObject<{
11952
12341
  url: z.ZodURL;
11953
12342
  method: z.ZodOptional<z.ZodEnum<{
@@ -12192,6 +12581,33 @@ declare type PrereleaseIdentifier = string | number;
12192
12581
  */
12193
12582
  export declare const PRIVATE_PLUGIN_CAPABILITY_SLUGS: readonly PluginCapabilitySlug[];
12194
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
+
12195
12611
  /**
12196
12612
  * What a manifest's JSON declares about compatibility, read the way a directory's verdict reads it:
12197
12613
  * apart from the strict schema, because a manifest written for another SDK may not pass that schema.
@@ -12245,6 +12661,8 @@ export declare const ReferencePresentationAddress: z.ZodObject<{
12245
12661
  search: z.ZodOptional<z.ZodString>;
12246
12662
  }, z.core.$strict>;
12247
12663
  objectId: z.ZodOptional<z.ZodString>;
12664
+ resourceKind: z.ZodOptional<z.ZodString>;
12665
+ label: z.ZodOptional<z.ZodString>;
12248
12666
  open: z.ZodOptional<z.ZodObject<{
12249
12667
  kind: z.ZodLiteral<"none">;
12250
12668
  }, z.core.$strict>>;
@@ -12264,6 +12682,8 @@ export declare const ReferencePresentationContribution: z.ZodObject<{
12264
12682
  search: z.ZodOptional<z.ZodString>;
12265
12683
  }, z.core.$strict>;
12266
12684
  objectId: z.ZodOptional<z.ZodString>;
12685
+ resourceKind: z.ZodOptional<z.ZodString>;
12686
+ label: z.ZodOptional<z.ZodString>;
12267
12687
  open: z.ZodOptional<z.ZodObject<{
12268
12688
  kind: z.ZodLiteral<"none">;
12269
12689
  }, z.core.$strict>>;
@@ -12895,6 +13315,7 @@ export declare const ResolvedKayAgentUriModule: z.ZodObject<{
12895
13315
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
12896
13316
  }, z.core.$strict>>;
12897
13317
  localId: z.ZodString;
13318
+ adapterId: z.ZodOptional<z.ZodString>;
12898
13319
  globalId: z.ZodString;
12899
13320
  schemes: z.ZodArray<z.ZodString>;
12900
13321
  displayName: z.ZodOptional<z.ZodString>;
@@ -13019,6 +13440,9 @@ export declare const ResolvedKayAppDataSource: z.ZodObject<{
13019
13440
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
13020
13441
  }, z.core.$strict>;
13021
13442
  }, z.core.$strict>>;
13443
+ messageDraft: z.ZodOptional<z.ZodObject<{
13444
+ schemes: z.ZodArray<z.ZodString>;
13445
+ }, z.core.$strict>>;
13022
13446
  store: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
13023
13447
  shape: z.ZodLiteral<"rows">;
13024
13448
  rowsField: z.ZodString;
@@ -13097,7 +13521,6 @@ export declare type ResolvedKayAppTool = z.infer<typeof ResolvedKayAppTool>;
13097
13521
 
13098
13522
  export declare const ResolvedKayAppWhiteboardType: z.ZodObject<{
13099
13523
  localId: z.ZodString;
13100
- globalId: z.ZodString;
13101
13524
  displayName: z.ZodString;
13102
13525
  schemaVersion: z.ZodNumber;
13103
13526
  storage: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -13109,6 +13532,12 @@ export declare const ResolvedKayAppWhiteboardType: z.ZodObject<{
13109
13532
  bodyField: z.ZodString;
13110
13533
  }, z.core.$strict>], "kind">;
13111
13534
  valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
13535
+ directory: z.ZodOptional<z.ZodArray<z.ZodString>>;
13536
+ reference: z.ZodOptional<z.ZodObject<{
13537
+ uriTemplate: z.ZodString;
13538
+ }, z.core.$strict>>;
13539
+ handover: z.ZodOptional<z.ZodLiteral<true>>;
13540
+ globalId: z.ZodString;
13112
13541
  }, z.core.$strict>;
13113
13542
 
13114
13543
  export declare type ResolvedKayAppWhiteboardType = z.infer<typeof ResolvedKayAppWhiteboardType>;
@@ -13155,6 +13584,13 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
13155
13584
  }, z.core.$strict>]>>>;
13156
13585
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
13157
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";
13158
13594
  "sessions.create": "sessions.create";
13159
13595
  "models.complete": "models.complete";
13160
13596
  "artifacts.read": "artifacts.read";
@@ -13162,6 +13598,10 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
13162
13598
  "markdown.document-view": "markdown.document-view";
13163
13599
  "references.open": "references.open";
13164
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";
13165
13605
  "automations.read": "automations.read";
13166
13606
  "automations.run": "automations.run";
13167
13607
  "shared-artifacts.read": "shared-artifacts.read";
@@ -13226,9 +13666,11 @@ export declare const ResolvedPluginAuthScheme: z.ZodDiscriminatedUnion<[z.ZodDis
13226
13666
  globalId: z.ZodString;
13227
13667
  kind: z.ZodLiteral<"oauth2">;
13228
13668
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13669
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13229
13670
  authorizationUrl: z.ZodURL;
13230
13671
  tokenUrl: z.ZodURL;
13231
13672
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13673
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13232
13674
  displayName: z.ZodOptional<z.ZodString>;
13233
13675
  agentHint: z.ZodOptional<z.ZodString>;
13234
13676
  summary: z.ZodOptional<z.ZodString>;
@@ -13257,9 +13699,11 @@ export declare const ResolvedPluginAuthScheme: z.ZodDiscriminatedUnion<[z.ZodDis
13257
13699
  globalId: z.ZodString;
13258
13700
  kind: z.ZodLiteral<"oauth2">;
13259
13701
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13702
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13260
13703
  authorizationUrl: z.ZodURL;
13261
13704
  tokenUrl: z.ZodURL;
13262
13705
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13706
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13263
13707
  displayName: z.ZodOptional<z.ZodString>;
13264
13708
  agentHint: z.ZodOptional<z.ZodString>;
13265
13709
  summary: z.ZodOptional<z.ZodString>;
@@ -13395,9 +13839,11 @@ export declare const ResolvedPluginAuthService: z.ZodObject<{
13395
13839
  globalId: z.ZodString;
13396
13840
  kind: z.ZodLiteral<"oauth2">;
13397
13841
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13842
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13398
13843
  authorizationUrl: z.ZodURL;
13399
13844
  tokenUrl: z.ZodURL;
13400
13845
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13846
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13401
13847
  displayName: z.ZodOptional<z.ZodString>;
13402
13848
  agentHint: z.ZodOptional<z.ZodString>;
13403
13849
  summary: z.ZodOptional<z.ZodString>;
@@ -13426,9 +13872,11 @@ export declare const ResolvedPluginAuthService: z.ZodObject<{
13426
13872
  globalId: z.ZodString;
13427
13873
  kind: z.ZodLiteral<"oauth2">;
13428
13874
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13875
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13429
13876
  authorizationUrl: z.ZodURL;
13430
13877
  tokenUrl: z.ZodURL;
13431
13878
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13879
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13432
13880
  displayName: z.ZodOptional<z.ZodString>;
13433
13881
  agentHint: z.ZodOptional<z.ZodString>;
13434
13882
  summary: z.ZodOptional<z.ZodString>;
@@ -13628,6 +14076,10 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
13628
14076
  usage: z.ZodString;
13629
14077
  endpointId: z.ZodString;
13630
14078
  }, z.core.$strict>>>;
14079
+ projectDirectories: z.ZodOptional<z.ZodObject<{
14080
+ scheme: z.ZodString;
14081
+ endpointId: z.ZodString;
14082
+ }, z.core.$strict>>;
13631
14083
  authServices: z.ZodArray<z.ZodObject<{
13632
14084
  localId: z.ZodString;
13633
14085
  globalId: z.ZodString;
@@ -13670,9 +14122,11 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
13670
14122
  globalId: z.ZodString;
13671
14123
  kind: z.ZodLiteral<"oauth2">;
13672
14124
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
14125
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13673
14126
  authorizationUrl: z.ZodURL;
13674
14127
  tokenUrl: z.ZodURL;
13675
14128
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
14129
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13676
14130
  displayName: z.ZodOptional<z.ZodString>;
13677
14131
  agentHint: z.ZodOptional<z.ZodString>;
13678
14132
  summary: z.ZodOptional<z.ZodString>;
@@ -13701,9 +14155,11 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
13701
14155
  globalId: z.ZodString;
13702
14156
  kind: z.ZodLiteral<"oauth2">;
13703
14157
  scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
14158
+ connectScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
13704
14159
  authorizationUrl: z.ZodURL;
13705
14160
  tokenUrl: z.ZodURL;
13706
14161
  extraAuthorizeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
14162
+ extraAuthorizeParamsWhenAccountHeld: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
13707
14163
  displayName: z.ZodOptional<z.ZodString>;
13708
14164
  agentHint: z.ZodOptional<z.ZodString>;
13709
14165
  summary: z.ZodOptional<z.ZodString>;
@@ -14145,6 +14601,9 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14145
14601
  }, z.core.$strict>>;
14146
14602
  }, z.core.$strict>;
14147
14603
  }, z.core.$strict>>;
14604
+ kayAgentFamilyFolder: z.ZodOptional<z.ZodObject<{
14605
+ scope: z.ZodLiteral<"root">;
14606
+ }, z.core.$strict>>;
14148
14607
  kayAgentUriModules: z.ZodOptional<z.ZodArray<z.ZodObject<{
14149
14608
  revisionBacked: z.ZodOptional<z.ZodLiteral<true>>;
14150
14609
  mailCalibrationSource: z.ZodOptional<z.ZodLiteral<true>>;
@@ -14334,6 +14793,7 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14334
14793
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
14335
14794
  }, z.core.$strict>>;
14336
14795
  localId: z.ZodString;
14796
+ adapterId: z.ZodOptional<z.ZodString>;
14337
14797
  globalId: z.ZodString;
14338
14798
  schemes: z.ZodArray<z.ZodString>;
14339
14799
  displayName: z.ZodOptional<z.ZodString>;
@@ -14608,6 +15068,9 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14608
15068
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
14609
15069
  }, z.core.$strict>;
14610
15070
  }, z.core.$strict>>;
15071
+ messageDraft: z.ZodOptional<z.ZodObject<{
15072
+ schemes: z.ZodArray<z.ZodString>;
15073
+ }, z.core.$strict>>;
14611
15074
  store: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
14612
15075
  shape: z.ZodLiteral<"rows">;
14613
15076
  rowsField: z.ZodString;
@@ -14618,7 +15081,6 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14618
15081
  }, z.core.$strict>>>;
14619
15082
  kayAppWhiteboardTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
14620
15083
  localId: z.ZodString;
14621
- globalId: z.ZodString;
14622
15084
  displayName: z.ZodString;
14623
15085
  schemaVersion: z.ZodNumber;
14624
15086
  storage: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -14630,6 +15092,12 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14630
15092
  bodyField: z.ZodString;
14631
15093
  }, z.core.$strict>], "kind">;
14632
15094
  valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
15095
+ directory: z.ZodOptional<z.ZodArray<z.ZodString>>;
15096
+ reference: z.ZodOptional<z.ZodObject<{
15097
+ uriTemplate: z.ZodString;
15098
+ }, z.core.$strict>>;
15099
+ handover: z.ZodOptional<z.ZodLiteral<true>>;
15100
+ globalId: z.ZodString;
14633
15101
  }, z.core.$strict>>>;
14634
15102
  kayAppMcpServers: z.ZodOptional<z.ZodArray<z.ZodObject<{
14635
15103
  name: z.ZodString;
@@ -14686,6 +15154,8 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14686
15154
  search: z.ZodOptional<z.ZodString>;
14687
15155
  }, z.core.$strict>;
14688
15156
  objectId: z.ZodOptional<z.ZodString>;
15157
+ resourceKind: z.ZodOptional<z.ZodString>;
15158
+ label: z.ZodOptional<z.ZodString>;
14689
15159
  open: z.ZodOptional<z.ZodObject<{
14690
15160
  kind: z.ZodLiteral<"none">;
14691
15161
  }, z.core.$strict>>;
@@ -14796,6 +15266,13 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14796
15266
  }, z.core.$strict>]>>>;
14797
15267
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
14798
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";
14799
15276
  "sessions.create": "sessions.create";
14800
15277
  "models.complete": "models.complete";
14801
15278
  "artifacts.read": "artifacts.read";
@@ -14803,6 +15280,10 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
14803
15280
  "markdown.document-view": "markdown.document-view";
14804
15281
  "references.open": "references.open";
14805
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";
14806
15287
  "automations.read": "automations.read";
14807
15288
  "automations.run": "automations.run";
14808
15289
  "shared-artifacts.read": "shared-artifacts.read";
@@ -15277,6 +15758,8 @@ export declare const ResolvedReferencePresentation: z.ZodObject<{
15277
15758
  search: z.ZodOptional<z.ZodString>;
15278
15759
  }, z.core.$strict>;
15279
15760
  objectId: z.ZodOptional<z.ZodString>;
15761
+ resourceKind: z.ZodOptional<z.ZodString>;
15762
+ label: z.ZodOptional<z.ZodString>;
15280
15763
  open: z.ZodOptional<z.ZodObject<{
15281
15764
  kind: z.ZodLiteral<"none">;
15282
15765
  }, z.core.$strict>>;
@@ -16677,6 +17160,13 @@ export declare const UiAppCapabilities: z.ZodObject<{
16677
17160
  }, z.core.$strict>]>>>;
16678
17161
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
16679
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";
16680
17170
  "sessions.create": "sessions.create";
16681
17171
  "models.complete": "models.complete";
16682
17172
  "artifacts.read": "artifacts.read";
@@ -16684,6 +17174,10 @@ export declare const UiAppCapabilities: z.ZodObject<{
16684
17174
  "markdown.document-view": "markdown.document-view";
16685
17175
  "references.open": "references.open";
16686
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";
16687
17181
  "automations.read": "automations.read";
16688
17182
  "automations.run": "automations.run";
16689
17183
  "shared-artifacts.read": "shared-artifacts.read";
@@ -16730,6 +17224,13 @@ export declare const UiAppContribution: z.ZodObject<{
16730
17224
  }, z.core.$strict>]>>>;
16731
17225
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
16732
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";
16733
17234
  "sessions.create": "sessions.create";
16734
17235
  "models.complete": "models.complete";
16735
17236
  "artifacts.read": "artifacts.read";
@@ -16737,6 +17238,10 @@ export declare const UiAppContribution: z.ZodObject<{
16737
17238
  "markdown.document-view": "markdown.document-view";
16738
17239
  "references.open": "references.open";
16739
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";
16740
17245
  "automations.read": "automations.read";
16741
17246
  "automations.run": "automations.run";
16742
17247
  "shared-artifacts.read": "shared-artifacts.read";
@@ -16773,6 +17278,13 @@ export declare const UiAppContribution: z.ZodObject<{
16773
17278
  }, z.core.$strict>]>>>;
16774
17279
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
16775
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";
16776
17288
  "sessions.create": "sessions.create";
16777
17289
  "models.complete": "models.complete";
16778
17290
  "artifacts.read": "artifacts.read";
@@ -16780,6 +17292,10 @@ export declare const UiAppContribution: z.ZodObject<{
16780
17292
  "markdown.document-view": "markdown.document-view";
16781
17293
  "references.open": "references.open";
16782
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";
16783
17299
  "automations.read": "automations.read";
16784
17300
  "automations.run": "automations.run";
16785
17301
  "shared-artifacts.read": "shared-artifacts.read";
@@ -16856,6 +17372,14 @@ export declare const UiPageContribution: z.ZodObject<{
16856
17372
  title: z.ZodOptional<z.ZodString>;
16857
17373
  icon: z.ZodOptional<z.ZodString>;
16858
17374
  companion: z.ZodOptional<z.ZodBoolean>;
17375
+ sessionBinding: z.ZodOptional<z.ZodEnum<{
17376
+ session: "session";
17377
+ family: "family";
17378
+ }>>;
17379
+ settings: z.ZodOptional<z.ZodObject<{
17380
+ order: z.ZodOptional<z.ZodNumber>;
17381
+ }, z.core.$strict>>;
17382
+ aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
16859
17383
  openedEvent: z.ZodOptional<z.ZodString>;
16860
17384
  }, z.core.$strict>;
16861
17385
 
@@ -17104,6 +17628,7 @@ export declare const UriModuleContribution: z.ZodObject<{
17104
17628
  skills: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
17105
17629
  }, z.core.$strict>>;
17106
17630
  localId: z.ZodString;
17631
+ adapterId: z.ZodOptional<z.ZodString>;
17107
17632
  schemes: z.ZodArray<z.ZodString>;
17108
17633
  displayName: z.ZodOptional<z.ZodString>;
17109
17634
  }, z.core.$strict>;
@@ -17510,8 +18035,8 @@ export declare const WhiteboardEntryInfo: z.ZodObject<{
17510
18035
  authorSessionId: z.ZodNullable<z.ZodString>;
17511
18036
  }, z.core.$strict>>;
17512
18037
  state: z.ZodEnum<{
17513
- unavailable: "unavailable";
17514
18038
  available: "available";
18039
+ unavailable: "unavailable";
17515
18040
  "unsupported-version": "unsupported-version";
17516
18041
  invalid: "invalid";
17517
18042
  }>;
@@ -17532,8 +18057,8 @@ export declare const WhiteboardEntryInspection: z.ZodObject<{
17532
18057
  authorSessionId: z.ZodNullable<z.ZodString>;
17533
18058
  }, z.core.$strict>>;
17534
18059
  state: z.ZodEnum<{
17535
- unavailable: "unavailable";
17536
18060
  available: "available";
18061
+ unavailable: "unavailable";
17537
18062
  "unsupported-version": "unsupported-version";
17538
18063
  invalid: "invalid";
17539
18064
  }>;
@@ -17546,6 +18071,13 @@ export declare const WhiteboardEntryInspection: z.ZodObject<{
17546
18071
 
17547
18072
  export declare type WhiteboardEntryInspection = Readonly<z.infer<typeof WhiteboardEntryInspection>>;
17548
18073
 
18074
+ /** A plugin-owned URI with the entry name encoded into its final path segment. */
18075
+ export declare const WhiteboardEntryReference: z.ZodObject<{
18076
+ uriTemplate: z.ZodString;
18077
+ }, z.core.$strict>;
18078
+
18079
+ export declare type WhiteboardEntryReference = z.infer<typeof WhiteboardEntryReference>;
18080
+
17549
18081
  export declare const WhiteboardEntrySnapshot: z.ZodObject<{
17550
18082
  name: z.ZodString;
17551
18083
  entry: z.ZodObject<{
@@ -17592,6 +18124,11 @@ export declare const WhiteboardTypeContribution: z.ZodObject<{
17592
18124
  bodyField: z.ZodString;
17593
18125
  }, z.core.$strict>], "kind">;
17594
18126
  valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
18127
+ directory: z.ZodOptional<z.ZodArray<z.ZodString>>;
18128
+ reference: z.ZodOptional<z.ZodObject<{
18129
+ uriTemplate: z.ZodString;
18130
+ }, z.core.$strict>>;
18131
+ handover: z.ZodOptional<z.ZodLiteral<true>>;
17595
18132
  }, z.core.$strict>;
17596
18133
 
17597
18134
  export declare type WhiteboardTypeContribution = z.infer<typeof WhiteboardTypeContribution>;
@@ -17601,6 +18138,9 @@ export declare const WhiteboardTypeInfo: z.ZodObject<{
17601
18138
  displayName: z.ZodString;
17602
18139
  schemaVersion: z.ZodNumber;
17603
18140
  available: z.ZodBoolean;
18141
+ reference: z.ZodOptional<z.ZodObject<{
18142
+ uriTemplate: z.ZodString;
18143
+ }, z.core.$strict>>;
17604
18144
  }, z.core.$strict>;
17605
18145
 
17606
18146
  export declare type WhiteboardTypeInfo = Readonly<z.infer<typeof WhiteboardTypeInfo>>;