@yaklabs-ai/plugin-protocol 0.34.0 → 0.36.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 +414 -174
  4. package/dist/index.js +235 -47
  5. package/package.json +1 -1
package/dist/index.d.ts CHANGED
@@ -77,9 +77,9 @@ export declare type AppDataMaterializerContribution = z.infer<typeof AppDataMate
77
77
  export declare const AppDataSourceContribution: z.ZodObject<{
78
78
  localId: z.ZodString;
79
79
  scope: z.ZodEnum<{
80
- session: "session";
81
80
  runtime: "runtime";
82
81
  account: "account";
82
+ session: "session";
83
83
  }>;
84
84
  snapshot: z.ZodObject<{
85
85
  version: z.ZodNumber;
@@ -117,6 +117,25 @@ export declare const AppDataSourceContribution: z.ZodObject<{
117
117
 
118
118
  export declare type AppDataSourceContribution = z.infer<typeof AppDataSourceContribution>;
119
119
 
120
+ /** What the window needs to read one of a plugin's data sources, from its accepted contract. */
121
+ export declare function appDataSourceDeclaration(source: NonNullable<ResolvedPluginContractV1["kayAppDataSources"]>[number]): {
122
+ store?: {
123
+ shape: "rows";
124
+ rowsField: string;
125
+ key: string[];
126
+ } | {
127
+ shape: "value";
128
+ };
129
+ read?: {
130
+ requestVersion: number;
131
+ resultVersion: number;
132
+ };
133
+ sourceId: string;
134
+ scope: "runtime" | "account" | "session";
135
+ snapshotVersion: number;
136
+ changeVersion: number;
137
+ };
138
+
120
139
  /** Exact request and result schemas for a session source's optional read operation. */
121
140
  export declare const AppDataSourceRead: z.ZodObject<{
122
141
  request: z.ZodObject<{
@@ -183,8 +202,8 @@ export declare type ApprovalKind = (typeof APPROVAL_KINDS)[number];
183
202
 
184
203
  export declare const approvalKindSchema: z.ZodEnum<{
185
204
  message: "message";
186
- change: "change";
187
205
  action: "action";
206
+ change: "change";
188
207
  access: "access";
189
208
  }>;
190
209
 
@@ -313,30 +332,30 @@ export declare const AppUriModuleContribution: z.ZodObject<{
313
332
  description: z.ZodString;
314
333
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
315
334
  search: "search";
316
- delete: "delete";
317
335
  list: "list";
318
336
  read: "read";
319
337
  write: "write";
320
338
  help: "help";
321
339
  edit: "edit";
340
+ delete: "delete";
322
341
  }>>>;
323
342
  operationDocs: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
324
343
  search: "search";
325
- delete: "delete";
326
344
  list: "list";
327
345
  read: "read";
328
346
  write: "write";
329
347
  help: "help";
330
348
  edit: "edit";
349
+ delete: "delete";
331
350
  }> & z.core.$partial, z.ZodString>>;
332
351
  operationDefaults: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
333
352
  search: "search";
334
- delete: "delete";
335
353
  list: "list";
336
354
  read: "read";
337
355
  write: "write";
338
356
  help: "help";
339
357
  edit: "edit";
358
+ delete: "delete";
340
359
  }> & z.core.$partial, z.ZodEnum<{
341
360
  never: "never";
342
361
  allow: "allow";
@@ -815,10 +834,10 @@ export declare const ArtifactProvenanceEnvelopeV1: z.ZodPipe<z.ZodUnknown, z.Zod
815
834
  }, z.core.$strict>;
816
835
  artifacts: z.ZodArray<z.ZodObject<{
817
836
  kind: z.ZodEnum<{
837
+ delete: "delete";
818
838
  import: "import";
819
839
  create: "create";
820
840
  update: "update";
821
- delete: "delete";
822
841
  copy: "copy";
823
842
  harvest: "harvest";
824
843
  restore: "restore";
@@ -1107,10 +1126,10 @@ export declare type ArtifactProvenanceGap = z.infer<typeof ArtifactProvenanceGap
1107
1126
 
1108
1127
  export declare const ArtifactProvenanceMutation: z.ZodObject<{
1109
1128
  kind: z.ZodEnum<{
1129
+ delete: "delete";
1110
1130
  import: "import";
1111
1131
  create: "create";
1112
1132
  update: "update";
1113
- delete: "delete";
1114
1133
  copy: "copy";
1115
1134
  harvest: "harvest";
1116
1135
  restore: "restore";
@@ -1664,11 +1683,13 @@ declare namespace authoringContributionSchemas {
1664
1683
  ReferencePresentationUriPattern,
1665
1684
  ReferencePresentationUrlClaim,
1666
1685
  ReferencePresentationTooltip,
1686
+ ReferencePresentationAddress,
1667
1687
  ReferencePresentationContribution,
1668
1688
  RichViewContribution,
1669
1689
  KayUiAppHostCapability,
1670
1690
  UiAppCapabilities,
1671
1691
  UiRailEntryContribution,
1692
+ UiPageContribution,
1672
1693
  UiAppContribution,
1673
1694
  ThemeContribution,
1674
1695
  CommandHandler,
@@ -1877,30 +1898,30 @@ declare const canonicalContributionSchemas: {
1877
1898
  description: z.ZodString;
1878
1899
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
1879
1900
  search: "search";
1880
- delete: "delete";
1881
1901
  list: "list";
1882
1902
  read: "read";
1883
1903
  write: "write";
1884
1904
  help: "help";
1885
1905
  edit: "edit";
1906
+ delete: "delete";
1886
1907
  }>>>;
1887
1908
  operationDocs: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
1888
1909
  search: "search";
1889
- delete: "delete";
1890
1910
  list: "list";
1891
1911
  read: "read";
1892
1912
  write: "write";
1893
1913
  help: "help";
1894
1914
  edit: "edit";
1915
+ delete: "delete";
1895
1916
  }> & z.core.$partial, z.ZodString>>;
1896
1917
  operationDefaults: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
1897
1918
  search: "search";
1898
- delete: "delete";
1899
1919
  list: "list";
1900
1920
  read: "read";
1901
1921
  write: "write";
1902
1922
  help: "help";
1903
1923
  edit: "edit";
1924
+ delete: "delete";
1904
1925
  }> & z.core.$partial, z.ZodEnum<{
1905
1926
  never: "never";
1906
1927
  allow: "allow";
@@ -1959,12 +1980,12 @@ declare const canonicalContributionSchemas: {
1959
1980
  action: z.ZodString;
1960
1981
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
1961
1982
  search: "search";
1962
- delete: "delete";
1963
1983
  list: "list";
1964
1984
  read: "read";
1965
1985
  write: "write";
1966
1986
  help: "help";
1967
1987
  edit: "edit";
1988
+ delete: "delete";
1968
1989
  }>>>;
1969
1990
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
1970
1991
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -1972,12 +1993,12 @@ declare const canonicalContributionSchemas: {
1972
1993
  public: z.ZodLiteral<true>;
1973
1994
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
1974
1995
  search: "search";
1975
- delete: "delete";
1976
1996
  list: "list";
1977
1997
  read: "read";
1978
1998
  write: "write";
1979
1999
  help: "help";
1980
2000
  edit: "edit";
2001
+ delete: "delete";
1981
2002
  }>>>;
1982
2003
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
1983
2004
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -2084,30 +2105,30 @@ declare const canonicalContributionSchemas: {
2084
2105
  description: z.ZodString;
2085
2106
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
2086
2107
  search: "search";
2087
- delete: "delete";
2088
2108
  list: "list";
2089
2109
  read: "read";
2090
2110
  write: "write";
2091
2111
  help: "help";
2092
2112
  edit: "edit";
2113
+ delete: "delete";
2093
2114
  }>>>;
2094
2115
  operationDocs: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
2095
2116
  search: "search";
2096
- delete: "delete";
2097
2117
  list: "list";
2098
2118
  read: "read";
2099
2119
  write: "write";
2100
2120
  help: "help";
2101
2121
  edit: "edit";
2122
+ delete: "delete";
2102
2123
  }> & z.core.$partial, z.ZodString>>;
2103
2124
  operationDefaults: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
2104
2125
  search: "search";
2105
- delete: "delete";
2106
2126
  list: "list";
2107
2127
  read: "read";
2108
2128
  write: "write";
2109
2129
  help: "help";
2110
2130
  edit: "edit";
2131
+ delete: "delete";
2111
2132
  }> & z.core.$partial, z.ZodEnum<{
2112
2133
  never: "never";
2113
2134
  allow: "allow";
@@ -2166,12 +2187,12 @@ declare const canonicalContributionSchemas: {
2166
2187
  action: z.ZodString;
2167
2188
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
2168
2189
  search: "search";
2169
- delete: "delete";
2170
2190
  list: "list";
2171
2191
  read: "read";
2172
2192
  write: "write";
2173
2193
  help: "help";
2174
2194
  edit: "edit";
2195
+ delete: "delete";
2175
2196
  }>>>;
2176
2197
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
2177
2198
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -2179,12 +2200,12 @@ declare const canonicalContributionSchemas: {
2179
2200
  public: z.ZodLiteral<true>;
2180
2201
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
2181
2202
  search: "search";
2182
- delete: "delete";
2183
2203
  list: "list";
2184
2204
  read: "read";
2185
2205
  write: "write";
2186
2206
  help: "help";
2187
2207
  edit: "edit";
2208
+ delete: "delete";
2188
2209
  }>>>;
2189
2210
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
2190
2211
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -2252,30 +2273,30 @@ declare const canonicalContributionSchemas: {
2252
2273
  description: z.ZodString;
2253
2274
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
2254
2275
  search: "search";
2255
- delete: "delete";
2256
2276
  list: "list";
2257
2277
  read: "read";
2258
2278
  write: "write";
2259
2279
  help: "help";
2260
2280
  edit: "edit";
2281
+ delete: "delete";
2261
2282
  }>>>;
2262
2283
  operationDocs: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
2263
2284
  search: "search";
2264
- delete: "delete";
2265
2285
  list: "list";
2266
2286
  read: "read";
2267
2287
  write: "write";
2268
2288
  help: "help";
2269
2289
  edit: "edit";
2290
+ delete: "delete";
2270
2291
  }> & z.core.$partial, z.ZodString>>;
2271
2292
  operationDefaults: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
2272
2293
  search: "search";
2273
- delete: "delete";
2274
2294
  list: "list";
2275
2295
  read: "read";
2276
2296
  write: "write";
2277
2297
  help: "help";
2278
2298
  edit: "edit";
2299
+ delete: "delete";
2279
2300
  }> & z.core.$partial, z.ZodEnum<{
2280
2301
  never: "never";
2281
2302
  allow: "allow";
@@ -2343,9 +2364,9 @@ declare const canonicalContributionSchemas: {
2343
2364
  AppDataSourceContribution: z.ZodObject<{
2344
2365
  localId: z.ZodString;
2345
2366
  scope: z.ZodEnum<{
2346
- session: "session";
2347
2367
  runtime: "runtime";
2348
2368
  account: "account";
2369
+ session: "session";
2349
2370
  }>;
2350
2371
  snapshot: z.ZodObject<{
2351
2372
  version: z.ZodNumber;
@@ -2646,9 +2667,34 @@ declare const canonicalContributionSchemas: {
2646
2667
  search: z.ZodOptional<z.ZodString>;
2647
2668
  }, z.core.$strict>;
2648
2669
  }, z.core.$strict>;
2670
+ ReferencePresentationAddress: z.ZodObject<{
2671
+ pattern: z.ZodObject<{
2672
+ protocol: z.ZodString;
2673
+ hostname: z.ZodString;
2674
+ pathname: z.ZodOptional<z.ZodString>;
2675
+ search: z.ZodOptional<z.ZodString>;
2676
+ }, z.core.$strict>;
2677
+ objectId: z.ZodOptional<z.ZodString>;
2678
+ open: z.ZodOptional<z.ZodObject<{
2679
+ kind: z.ZodLiteral<"none">;
2680
+ }, z.core.$strict>>;
2681
+ }, z.core.$strict>;
2649
2682
  ReferencePresentationContribution: z.ZodObject<{
2650
2683
  localId: z.ZodString;
2651
- uriModule: z.ZodString;
2684
+ uriModule: z.ZodOptional<z.ZodString>;
2685
+ scheme: z.ZodOptional<z.ZodString>;
2686
+ addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
2687
+ pattern: z.ZodObject<{
2688
+ protocol: z.ZodString;
2689
+ hostname: z.ZodString;
2690
+ pathname: z.ZodOptional<z.ZodString>;
2691
+ search: z.ZodOptional<z.ZodString>;
2692
+ }, z.core.$strict>;
2693
+ objectId: z.ZodOptional<z.ZodString>;
2694
+ open: z.ZodOptional<z.ZodObject<{
2695
+ kind: z.ZodLiteral<"none">;
2696
+ }, z.core.$strict>>;
2697
+ }, z.core.$strict>>>;
2652
2698
  resourceKind: z.ZodString;
2653
2699
  open: z.ZodDiscriminatedUnion<[z.ZodObject<{
2654
2700
  kind: z.ZodLiteral<"working-document">;
@@ -2691,17 +2737,18 @@ declare const canonicalContributionSchemas: {
2691
2737
  route: z.ZodOptional<z.ZodString>;
2692
2738
  }, z.core.$strict>;
2693
2739
  KayUiAppHostCapability: z.ZodEnum<{
2740
+ "navigation.open-session": "navigation.open-session";
2694
2741
  "sessions.create": "sessions.create";
2695
- "memory.read": "memory.read";
2696
- "skills.read": "skills.read";
2697
- "automations.run": "automations.run";
2698
2742
  "artifacts.read": "artifacts.read";
2699
- "navigation.open-session": "navigation.open-session";
2700
2743
  "artifacts.preview": "artifacts.preview";
2744
+ "markdown.document-view": "markdown.document-view";
2701
2745
  "cost.read": "cost.read";
2702
2746
  "billing.read": "billing.read";
2747
+ "skills.read": "skills.read";
2748
+ "memory.read": "memory.read";
2703
2749
  "self-improvement.read": "self-improvement.read";
2704
2750
  "automations.read": "automations.read";
2751
+ "automations.run": "automations.run";
2705
2752
  "shared-artifacts.read": "shared-artifacts.read";
2706
2753
  "workspace.place-pane": "workspace.place-pane";
2707
2754
  "workspace.pane-header": "workspace.pane-header";
@@ -2710,17 +2757,18 @@ declare const canonicalContributionSchemas: {
2710
2757
  UiAppCapabilities: z.ZodObject<{
2711
2758
  endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
2712
2759
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
2760
+ "navigation.open-session": "navigation.open-session";
2713
2761
  "sessions.create": "sessions.create";
2714
- "memory.read": "memory.read";
2715
- "skills.read": "skills.read";
2716
- "automations.run": "automations.run";
2717
2762
  "artifacts.read": "artifacts.read";
2718
- "navigation.open-session": "navigation.open-session";
2719
2763
  "artifacts.preview": "artifacts.preview";
2764
+ "markdown.document-view": "markdown.document-view";
2720
2765
  "cost.read": "cost.read";
2721
2766
  "billing.read": "billing.read";
2767
+ "skills.read": "skills.read";
2768
+ "memory.read": "memory.read";
2722
2769
  "self-improvement.read": "self-improvement.read";
2723
2770
  "automations.read": "automations.read";
2771
+ "automations.run": "automations.run";
2724
2772
  "shared-artifacts.read": "shared-artifacts.read";
2725
2773
  "workspace.place-pane": "workspace.place-pane";
2726
2774
  "workspace.pane-header": "workspace.pane-header";
@@ -2739,10 +2787,25 @@ declare const canonicalContributionSchemas: {
2739
2787
  primary: "primary";
2740
2788
  plugins: "plugins";
2741
2789
  }>>;
2790
+ badge: z.ZodOptional<z.ZodObject<{
2791
+ source: z.ZodString;
2792
+ where: z.ZodOptional<z.ZodString>;
2793
+ label: z.ZodObject<{
2794
+ one: z.ZodOptional<z.ZodString>;
2795
+ other: z.ZodString;
2796
+ }, z.core.$strict>;
2797
+ }, z.core.$strict>>;
2742
2798
  panel: z.ZodOptional<z.ZodObject<{
2743
2799
  body: z.ZodString;
2744
2800
  }, z.core.$strict>>;
2745
2801
  }, z.core.$strict>;
2802
+ UiPageContribution: z.ZodObject<{
2803
+ id: z.ZodString;
2804
+ title: z.ZodOptional<z.ZodString>;
2805
+ icon: z.ZodOptional<z.ZodString>;
2806
+ companion: z.ZodOptional<z.ZodBoolean>;
2807
+ openedEvent: z.ZodOptional<z.ZodString>;
2808
+ }, z.core.$strict>;
2746
2809
  UiAppContribution: z.ZodObject<{
2747
2810
  localId: z.ZodString;
2748
2811
  displayName: z.ZodString;
@@ -2762,17 +2825,18 @@ declare const canonicalContributionSchemas: {
2762
2825
  capabilities: z.ZodOptional<z.ZodObject<{
2763
2826
  endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
2764
2827
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
2828
+ "navigation.open-session": "navigation.open-session";
2765
2829
  "sessions.create": "sessions.create";
2766
- "memory.read": "memory.read";
2767
- "skills.read": "skills.read";
2768
- "automations.run": "automations.run";
2769
2830
  "artifacts.read": "artifacts.read";
2770
- "navigation.open-session": "navigation.open-session";
2771
2831
  "artifacts.preview": "artifacts.preview";
2832
+ "markdown.document-view": "markdown.document-view";
2772
2833
  "cost.read": "cost.read";
2773
2834
  "billing.read": "billing.read";
2835
+ "skills.read": "skills.read";
2836
+ "memory.read": "memory.read";
2774
2837
  "self-improvement.read": "self-improvement.read";
2775
2838
  "automations.read": "automations.read";
2839
+ "automations.run": "automations.run";
2776
2840
  "shared-artifacts.read": "shared-artifacts.read";
2777
2841
  "workspace.place-pane": "workspace.place-pane";
2778
2842
  "workspace.pane-header": "workspace.pane-header";
@@ -2798,17 +2862,18 @@ declare const canonicalContributionSchemas: {
2798
2862
  capabilities: z.ZodOptional<z.ZodObject<{
2799
2863
  endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
2800
2864
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
2865
+ "navigation.open-session": "navigation.open-session";
2801
2866
  "sessions.create": "sessions.create";
2802
- "memory.read": "memory.read";
2803
- "skills.read": "skills.read";
2804
- "automations.run": "automations.run";
2805
2867
  "artifacts.read": "artifacts.read";
2806
- "navigation.open-session": "navigation.open-session";
2807
2868
  "artifacts.preview": "artifacts.preview";
2869
+ "markdown.document-view": "markdown.document-view";
2808
2870
  "cost.read": "cost.read";
2809
2871
  "billing.read": "billing.read";
2872
+ "skills.read": "skills.read";
2873
+ "memory.read": "memory.read";
2810
2874
  "self-improvement.read": "self-improvement.read";
2811
2875
  "automations.read": "automations.read";
2876
+ "automations.run": "automations.run";
2812
2877
  "shared-artifacts.read": "shared-artifacts.read";
2813
2878
  "workspace.place-pane": "workspace.place-pane";
2814
2879
  "workspace.pane-header": "workspace.pane-header";
@@ -2855,14 +2920,14 @@ declare const canonicalContributionSchemas: {
2855
2920
  }, z.core.$strict>], "kind">;
2856
2921
  }, z.core.$strict>;
2857
2922
  PluginContributionKind: z.ZodEnum<{
2923
+ endpoint: "endpoint";
2858
2924
  tool: "tool";
2859
2925
  resource: "resource";
2860
- endpoint: "endpoint";
2861
2926
  storage: "storage";
2862
- command: "command";
2863
2927
  uriModule: "uriModule";
2864
2928
  authService: "authService";
2865
2929
  app: "app";
2930
+ command: "command";
2866
2931
  configSection: "configSection";
2867
2932
  skill: "skill";
2868
2933
  converter: "converter";
@@ -3000,36 +3065,8 @@ export declare const CommandHandler: z.ZodDiscriminatedUnion<[z.ZodObject<{
3000
3065
 
3001
3066
  export declare type CommandHandler = z.infer<typeof CommandHandler>;
3002
3067
 
3003
- export declare type CommandWhere = {
3004
- readonly kind: "literal";
3005
- readonly value: boolean;
3006
- } | {
3007
- readonly kind: "key";
3008
- readonly key: CommandWhereKey;
3009
- } | {
3010
- readonly kind: "equals";
3011
- readonly key: CommandWhereKey;
3012
- readonly value: boolean | string;
3013
- readonly negated: boolean;
3014
- } | {
3015
- readonly kind: "not";
3016
- readonly operand: CommandWhere;
3017
- } | {
3018
- readonly kind: "and" | "or";
3019
- readonly left: CommandWhere;
3020
- readonly right: CommandWhere;
3021
- };
3022
-
3023
3068
  export declare type CommandWhereKey = keyof typeof WHERE_KEY_TYPES;
3024
3069
 
3025
- export declare type CommandWhereParseResult = {
3026
- readonly ok: true;
3027
- readonly where: CommandWhere;
3028
- } | {
3029
- readonly ok: false;
3030
- readonly message: string;
3031
- };
3032
-
3033
3070
  /** The values a `where` reads. A key left out isn't known yet, for example while it loads. */
3034
3071
  export declare type CommandWhereValues = {
3035
3072
  readonly [K in CommandWhereKey]?: (typeof WHERE_KEY_TYPES)[K] extends "boolean" ? boolean : string;
@@ -3145,9 +3182,9 @@ export declare const CorpusResourceInvocationQuery: z.ZodObject<{
3145
3182
  }, z.core.$strict>>;
3146
3183
  limit: z.ZodOptional<z.ZodNumber>;
3147
3184
  rootCreatedByKind: z.ZodOptional<z.ZodEnum<{
3185
+ agent: "agent";
3148
3186
  plugin: "plugin";
3149
3187
  human: "human";
3150
- agent: "agent";
3151
3188
  trigger: "trigger";
3152
3189
  daemon: "daemon";
3153
3190
  }>>;
@@ -3194,6 +3231,17 @@ export declare interface DeclaredKayPluginCompatibility {
3194
3231
  readonly sdk?: string | undefined;
3195
3232
  }
3196
3233
 
3234
+ /**
3235
+ * Every plugin's reference presentations. The daemon delivers this one kind from the resolved
3236
+ * contract rather than the manifest, so its rows carry `schemes`.
3237
+ */
3238
+ export declare function declaredReferencePresentations<TPlugin extends {
3239
+ readonly contributes: Readonly<Record<string, unknown>>;
3240
+ }>(plugins: readonly TPlugin[]): readonly {
3241
+ readonly plugin: TPlugin;
3242
+ readonly declaration: ResolvedReferencePresentation;
3243
+ }[];
3244
+
3197
3245
  export declare const DeclaredSkillSourceEnvelope: z.ZodDiscriminatedUnion<[z.ZodObject<{
3198
3246
  channel: z.ZodLiteral<"git-clone">;
3199
3247
  locator: z.ZodString;
@@ -3282,12 +3330,15 @@ export declare const EntityResolverContribution: z.ZodObject<{
3282
3330
 
3283
3331
  export declare type EntityResolverContribution = z.infer<typeof EntityResolverContribution>;
3284
3332
 
3333
+ /** Whether a command's `where` holds. A button stays hidden while a value it needs loads. */
3334
+ export declare function evaluateCommandWhere(where: Where, values: CommandWhereValues): boolean;
3335
+
3285
3336
  /**
3286
- * Whether a `where` holds. When the answer depends on a value not known yet the result is false,
3287
- * so a button stays hidden while a value loads rather than flashing on: `true || app.channel == 'x'`
3288
- * holds whatever the channel is, and `!(app.channel == 'x')` waits for it.
3337
+ * Whether a `where` holds. `read` answers `undefined` for a value not known yet, and when the answer
3338
+ * depends on one the result is false: `true || app.channel == 'x'` holds whatever the channel is,
3339
+ * and `!(app.channel == 'x')` waits for it. `null` means the value is known to be absent.
3289
3340
  */
3290
- export declare function evaluateCommandWhere(where: CommandWhere, values: CommandWhereValues): boolean;
3341
+ export declare function evaluateWhere(where: Where, read: (key: string) => unknown): boolean;
3291
3342
 
3292
3343
  export declare const EventGrantRequest: z.ZodObject<{
3293
3344
  event: z.ZodString;
@@ -4080,8 +4131,18 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
4080
4131
  * 0.34.0 lets a rail entry declare a sidebar (#15901). `panel.body` on a `railEntries` entry names
4081
4132
  * what fills it, either a `contextOnly` app in the plugin or a body the host ships. Additive: a rail
4082
4133
  * entry with no `panel` still opens its page alone. A plugin that declares a panel declares ^0.34.0.
4134
+ *
4135
+ * 0.35.0 lets a rail entry declare a count badge as data (#15900). `badge` on a `railEntries` entry
4136
+ * names one of the plugin's `rows` data sources, an optional `where` and a plural `label`.
4137
+ * `app.skills` gains `listPendingSuggestions` and `subscribeSuggestions` under `skills.read`. A plugin
4138
+ * that declares a badge declares ^0.35.0.
4139
+ *
4140
+ * 0.36.0 lets a plugin declare its pages and which page an address opens (#15897, #15898). `pages`
4141
+ * under `kay.ui` `contributes` names each page's title, icon file, companion status and opened
4142
+ * event. A reference presentation that opens a page gains `scheme` and `addresses`, and may leave
4143
+ * out `uriModule` when another layer serves the address. A plugin using these declares ^0.36.0.
4083
4144
  */
4084
- export declare const KAY_PLUGIN_SDK_VERSION: "0.34.0";
4145
+ export declare const KAY_PLUGIN_SDK_VERSION: "0.36.0";
4085
4146
 
4086
4147
  export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
4087
4148
 
@@ -4169,30 +4230,30 @@ export declare const KayAgentTargetManifest: z.ZodObject<{
4169
4230
  description: z.ZodString;
4170
4231
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
4171
4232
  search: "search";
4172
- delete: "delete";
4173
4233
  list: "list";
4174
4234
  read: "read";
4175
4235
  write: "write";
4176
4236
  help: "help";
4177
4237
  edit: "edit";
4238
+ delete: "delete";
4178
4239
  }>>>;
4179
4240
  operationDocs: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
4180
4241
  search: "search";
4181
- delete: "delete";
4182
4242
  list: "list";
4183
4243
  read: "read";
4184
4244
  write: "write";
4185
4245
  help: "help";
4186
4246
  edit: "edit";
4247
+ delete: "delete";
4187
4248
  }> & z.core.$partial, z.ZodString>>;
4188
4249
  operationDefaults: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
4189
4250
  search: "search";
4190
- delete: "delete";
4191
4251
  list: "list";
4192
4252
  read: "read";
4193
4253
  write: "write";
4194
4254
  help: "help";
4195
4255
  edit: "edit";
4256
+ delete: "delete";
4196
4257
  }> & z.core.$partial, z.ZodEnum<{
4197
4258
  never: "never";
4198
4259
  allow: "allow";
@@ -4251,12 +4312,12 @@ export declare const KayAgentTargetManifest: z.ZodObject<{
4251
4312
  action: z.ZodString;
4252
4313
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
4253
4314
  search: "search";
4254
- delete: "delete";
4255
4315
  list: "list";
4256
4316
  read: "read";
4257
4317
  write: "write";
4258
4318
  help: "help";
4259
4319
  edit: "edit";
4320
+ delete: "delete";
4260
4321
  }>>>;
4261
4322
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
4262
4323
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -4264,12 +4325,12 @@ export declare const KayAgentTargetManifest: z.ZodObject<{
4264
4325
  public: z.ZodLiteral<true>;
4265
4326
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
4266
4327
  search: "search";
4267
- delete: "delete";
4268
4328
  list: "list";
4269
4329
  read: "read";
4270
4330
  write: "write";
4271
4331
  help: "help";
4272
4332
  edit: "edit";
4333
+ delete: "delete";
4273
4334
  }>>>;
4274
4335
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
4275
4336
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -4460,30 +4521,30 @@ export declare const KayAppTargetManifest: z.ZodObject<{
4460
4521
  description: z.ZodString;
4461
4522
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
4462
4523
  search: "search";
4463
- delete: "delete";
4464
4524
  list: "list";
4465
4525
  read: "read";
4466
4526
  write: "write";
4467
4527
  help: "help";
4468
4528
  edit: "edit";
4529
+ delete: "delete";
4469
4530
  }>>>;
4470
4531
  operationDocs: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
4471
4532
  search: "search";
4472
- delete: "delete";
4473
4533
  list: "list";
4474
4534
  read: "read";
4475
4535
  write: "write";
4476
4536
  help: "help";
4477
4537
  edit: "edit";
4538
+ delete: "delete";
4478
4539
  }> & z.core.$partial, z.ZodString>>;
4479
4540
  operationDefaults: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
4480
4541
  search: "search";
4481
- delete: "delete";
4482
4542
  list: "list";
4483
4543
  read: "read";
4484
4544
  write: "write";
4485
4545
  help: "help";
4486
4546
  edit: "edit";
4547
+ delete: "delete";
4487
4548
  }> & z.core.$partial, z.ZodEnum<{
4488
4549
  never: "never";
4489
4550
  allow: "allow";
@@ -4551,9 +4612,9 @@ export declare const KayAppTargetManifest: z.ZodObject<{
4551
4612
  dataSources: z.ZodOptional<z.ZodArray<z.ZodObject<{
4552
4613
  localId: z.ZodString;
4553
4614
  scope: z.ZodEnum<{
4554
- session: "session";
4555
4615
  runtime: "runtime";
4556
4616
  account: "account";
4617
+ session: "session";
4557
4618
  }>;
4558
4619
  snapshot: z.ZodObject<{
4559
4620
  version: z.ZodNumber;
@@ -4943,30 +5004,30 @@ export declare const KayPluginManifestV1: z.ZodObject<{
4943
5004
  description: z.ZodString;
4944
5005
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
4945
5006
  search: "search";
4946
- delete: "delete";
4947
5007
  list: "list";
4948
5008
  read: "read";
4949
5009
  write: "write";
4950
5010
  help: "help";
4951
5011
  edit: "edit";
5012
+ delete: "delete";
4952
5013
  }>>>;
4953
5014
  operationDocs: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
4954
5015
  search: "search";
4955
- delete: "delete";
4956
5016
  list: "list";
4957
5017
  read: "read";
4958
5018
  write: "write";
4959
5019
  help: "help";
4960
5020
  edit: "edit";
5021
+ delete: "delete";
4961
5022
  }> & z.core.$partial, z.ZodString>>;
4962
5023
  operationDefaults: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
4963
5024
  search: "search";
4964
- delete: "delete";
4965
5025
  list: "list";
4966
5026
  read: "read";
4967
5027
  write: "write";
4968
5028
  help: "help";
4969
5029
  edit: "edit";
5030
+ delete: "delete";
4970
5031
  }> & z.core.$partial, z.ZodEnum<{
4971
5032
  never: "never";
4972
5033
  allow: "allow";
@@ -5025,12 +5086,12 @@ export declare const KayPluginManifestV1: z.ZodObject<{
5025
5086
  action: z.ZodString;
5026
5087
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
5027
5088
  search: "search";
5028
- delete: "delete";
5029
5089
  list: "list";
5030
5090
  read: "read";
5031
5091
  write: "write";
5032
5092
  help: "help";
5033
5093
  edit: "edit";
5094
+ delete: "delete";
5034
5095
  }>>>;
5035
5096
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
5036
5097
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -5038,12 +5099,12 @@ export declare const KayPluginManifestV1: z.ZodObject<{
5038
5099
  public: z.ZodLiteral<true>;
5039
5100
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
5040
5101
  search: "search";
5041
- delete: "delete";
5042
5102
  list: "list";
5043
5103
  read: "read";
5044
5104
  write: "write";
5045
5105
  help: "help";
5046
5106
  edit: "edit";
5107
+ delete: "delete";
5047
5108
  }>>>;
5048
5109
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
5049
5110
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -5231,30 +5292,30 @@ export declare const KayPluginManifestV1: z.ZodObject<{
5231
5292
  description: z.ZodString;
5232
5293
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
5233
5294
  search: "search";
5234
- delete: "delete";
5235
5295
  list: "list";
5236
5296
  read: "read";
5237
5297
  write: "write";
5238
5298
  help: "help";
5239
5299
  edit: "edit";
5300
+ delete: "delete";
5240
5301
  }>>>;
5241
5302
  operationDocs: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
5242
5303
  search: "search";
5243
- delete: "delete";
5244
5304
  list: "list";
5245
5305
  read: "read";
5246
5306
  write: "write";
5247
5307
  help: "help";
5248
5308
  edit: "edit";
5309
+ delete: "delete";
5249
5310
  }> & z.core.$partial, z.ZodString>>;
5250
5311
  operationDefaults: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
5251
5312
  search: "search";
5252
- delete: "delete";
5253
5313
  list: "list";
5254
5314
  read: "read";
5255
5315
  write: "write";
5256
5316
  help: "help";
5257
5317
  edit: "edit";
5318
+ delete: "delete";
5258
5319
  }> & z.core.$partial, z.ZodEnum<{
5259
5320
  never: "never";
5260
5321
  allow: "allow";
@@ -5322,9 +5383,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
5322
5383
  dataSources: z.ZodOptional<z.ZodArray<z.ZodObject<{
5323
5384
  localId: z.ZodString;
5324
5385
  scope: z.ZodEnum<{
5325
- session: "session";
5326
5386
  runtime: "runtime";
5327
5387
  account: "account";
5388
+ session: "session";
5328
5389
  }>;
5329
5390
  snapshot: z.ZodObject<{
5330
5391
  version: z.ZodNumber;
@@ -5569,7 +5630,20 @@ export declare const KayPluginManifestV1: z.ZodObject<{
5569
5630
  }, z.core.$strict>>>;
5570
5631
  referencePresentations: z.ZodOptional<z.ZodArray<z.ZodObject<{
5571
5632
  localId: z.ZodString;
5572
- uriModule: z.ZodString;
5633
+ uriModule: z.ZodOptional<z.ZodString>;
5634
+ scheme: z.ZodOptional<z.ZodString>;
5635
+ addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
5636
+ pattern: z.ZodObject<{
5637
+ protocol: z.ZodString;
5638
+ hostname: z.ZodString;
5639
+ pathname: z.ZodOptional<z.ZodString>;
5640
+ search: z.ZodOptional<z.ZodString>;
5641
+ }, z.core.$strict>;
5642
+ objectId: z.ZodOptional<z.ZodString>;
5643
+ open: z.ZodOptional<z.ZodObject<{
5644
+ kind: z.ZodLiteral<"none">;
5645
+ }, z.core.$strict>>;
5646
+ }, z.core.$strict>>>;
5573
5647
  resourceKind: z.ZodString;
5574
5648
  open: z.ZodDiscriminatedUnion<[z.ZodObject<{
5575
5649
  kind: z.ZodLiteral<"working-document">;
@@ -5630,17 +5704,18 @@ export declare const KayPluginManifestV1: z.ZodObject<{
5630
5704
  capabilities: z.ZodOptional<z.ZodObject<{
5631
5705
  endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
5632
5706
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
5707
+ "navigation.open-session": "navigation.open-session";
5633
5708
  "sessions.create": "sessions.create";
5634
- "memory.read": "memory.read";
5635
- "skills.read": "skills.read";
5636
- "automations.run": "automations.run";
5637
5709
  "artifacts.read": "artifacts.read";
5638
- "navigation.open-session": "navigation.open-session";
5639
5710
  "artifacts.preview": "artifacts.preview";
5711
+ "markdown.document-view": "markdown.document-view";
5640
5712
  "cost.read": "cost.read";
5641
5713
  "billing.read": "billing.read";
5714
+ "skills.read": "skills.read";
5715
+ "memory.read": "memory.read";
5642
5716
  "self-improvement.read": "self-improvement.read";
5643
5717
  "automations.read": "automations.read";
5718
+ "automations.run": "automations.run";
5644
5719
  "shared-artifacts.read": "shared-artifacts.read";
5645
5720
  "workspace.place-pane": "workspace.place-pane";
5646
5721
  "workspace.pane-header": "workspace.pane-header";
@@ -5666,17 +5741,18 @@ export declare const KayPluginManifestV1: z.ZodObject<{
5666
5741
  capabilities: z.ZodOptional<z.ZodObject<{
5667
5742
  endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
5668
5743
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
5744
+ "navigation.open-session": "navigation.open-session";
5669
5745
  "sessions.create": "sessions.create";
5670
- "memory.read": "memory.read";
5671
- "skills.read": "skills.read";
5672
- "automations.run": "automations.run";
5673
5746
  "artifacts.read": "artifacts.read";
5674
- "navigation.open-session": "navigation.open-session";
5675
5747
  "artifacts.preview": "artifacts.preview";
5748
+ "markdown.document-view": "markdown.document-view";
5676
5749
  "cost.read": "cost.read";
5677
5750
  "billing.read": "billing.read";
5751
+ "skills.read": "skills.read";
5752
+ "memory.read": "memory.read";
5678
5753
  "self-improvement.read": "self-improvement.read";
5679
5754
  "automations.read": "automations.read";
5755
+ "automations.run": "automations.run";
5680
5756
  "shared-artifacts.read": "shared-artifacts.read";
5681
5757
  "workspace.place-pane": "workspace.place-pane";
5682
5758
  "workspace.pane-header": "workspace.pane-header";
@@ -5696,10 +5772,25 @@ export declare const KayPluginManifestV1: z.ZodObject<{
5696
5772
  primary: "primary";
5697
5773
  plugins: "plugins";
5698
5774
  }>>;
5775
+ badge: z.ZodOptional<z.ZodObject<{
5776
+ source: z.ZodString;
5777
+ where: z.ZodOptional<z.ZodString>;
5778
+ label: z.ZodObject<{
5779
+ one: z.ZodOptional<z.ZodString>;
5780
+ other: z.ZodString;
5781
+ }, z.core.$strict>;
5782
+ }, z.core.$strict>>;
5699
5783
  panel: z.ZodOptional<z.ZodObject<{
5700
5784
  body: z.ZodString;
5701
5785
  }, z.core.$strict>>;
5702
5786
  }, z.core.$strict>>>;
5787
+ pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
5788
+ id: z.ZodString;
5789
+ title: z.ZodOptional<z.ZodString>;
5790
+ icon: z.ZodOptional<z.ZodString>;
5791
+ companion: z.ZodOptional<z.ZodBoolean>;
5792
+ openedEvent: z.ZodOptional<z.ZodString>;
5793
+ }, z.core.$strict>>>;
5703
5794
  themes: z.ZodOptional<z.ZodArray<z.ZodObject<{
5704
5795
  localId: z.ZodString;
5705
5796
  displayName: z.ZodString;
@@ -5725,9 +5816,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
5725
5816
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
5726
5817
  defaults: z.ZodOptional<z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
5727
5818
  scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
5728
- agent: "agent";
5729
5819
  global: "global";
5730
5820
  project: "project";
5821
+ agent: "agent";
5731
5822
  }>>>;
5732
5823
  }, z.core.$strict>>>;
5733
5824
  storage: z.ZodOptional<z.ZodObject<{
@@ -6516,17 +6607,18 @@ export declare interface KayPluginTreeReader {
6516
6607
  }
6517
6608
 
6518
6609
  export declare const KayUiAppHostCapability: z.ZodEnum<{
6610
+ "navigation.open-session": "navigation.open-session";
6519
6611
  "sessions.create": "sessions.create";
6520
- "memory.read": "memory.read";
6521
- "skills.read": "skills.read";
6522
- "automations.run": "automations.run";
6523
6612
  "artifacts.read": "artifacts.read";
6524
- "navigation.open-session": "navigation.open-session";
6525
6613
  "artifacts.preview": "artifacts.preview";
6614
+ "markdown.document-view": "markdown.document-view";
6526
6615
  "cost.read": "cost.read";
6527
6616
  "billing.read": "billing.read";
6617
+ "skills.read": "skills.read";
6618
+ "memory.read": "memory.read";
6528
6619
  "self-improvement.read": "self-improvement.read";
6529
6620
  "automations.read": "automations.read";
6621
+ "automations.run": "automations.run";
6530
6622
  "shared-artifacts.read": "shared-artifacts.read";
6531
6623
  "workspace.place-pane": "workspace.place-pane";
6532
6624
  "workspace.pane-header": "workspace.pane-header";
@@ -6666,7 +6758,20 @@ export declare const KayUiTargetManifest: z.ZodObject<{
6666
6758
  }, z.core.$strict>>>;
6667
6759
  referencePresentations: z.ZodOptional<z.ZodArray<z.ZodObject<{
6668
6760
  localId: z.ZodString;
6669
- uriModule: z.ZodString;
6761
+ uriModule: z.ZodOptional<z.ZodString>;
6762
+ scheme: z.ZodOptional<z.ZodString>;
6763
+ addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
6764
+ pattern: z.ZodObject<{
6765
+ protocol: z.ZodString;
6766
+ hostname: z.ZodString;
6767
+ pathname: z.ZodOptional<z.ZodString>;
6768
+ search: z.ZodOptional<z.ZodString>;
6769
+ }, z.core.$strict>;
6770
+ objectId: z.ZodOptional<z.ZodString>;
6771
+ open: z.ZodOptional<z.ZodObject<{
6772
+ kind: z.ZodLiteral<"none">;
6773
+ }, z.core.$strict>>;
6774
+ }, z.core.$strict>>>;
6670
6775
  resourceKind: z.ZodString;
6671
6776
  open: z.ZodDiscriminatedUnion<[z.ZodObject<{
6672
6777
  kind: z.ZodLiteral<"working-document">;
@@ -6727,17 +6832,18 @@ export declare const KayUiTargetManifest: z.ZodObject<{
6727
6832
  capabilities: z.ZodOptional<z.ZodObject<{
6728
6833
  endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
6729
6834
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
6835
+ "navigation.open-session": "navigation.open-session";
6730
6836
  "sessions.create": "sessions.create";
6731
- "memory.read": "memory.read";
6732
- "skills.read": "skills.read";
6733
- "automations.run": "automations.run";
6734
6837
  "artifacts.read": "artifacts.read";
6735
- "navigation.open-session": "navigation.open-session";
6736
6838
  "artifacts.preview": "artifacts.preview";
6839
+ "markdown.document-view": "markdown.document-view";
6737
6840
  "cost.read": "cost.read";
6738
6841
  "billing.read": "billing.read";
6842
+ "skills.read": "skills.read";
6843
+ "memory.read": "memory.read";
6739
6844
  "self-improvement.read": "self-improvement.read";
6740
6845
  "automations.read": "automations.read";
6846
+ "automations.run": "automations.run";
6741
6847
  "shared-artifacts.read": "shared-artifacts.read";
6742
6848
  "workspace.place-pane": "workspace.place-pane";
6743
6849
  "workspace.pane-header": "workspace.pane-header";
@@ -6763,17 +6869,18 @@ export declare const KayUiTargetManifest: z.ZodObject<{
6763
6869
  capabilities: z.ZodOptional<z.ZodObject<{
6764
6870
  endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
6765
6871
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
6872
+ "navigation.open-session": "navigation.open-session";
6766
6873
  "sessions.create": "sessions.create";
6767
- "memory.read": "memory.read";
6768
- "skills.read": "skills.read";
6769
- "automations.run": "automations.run";
6770
6874
  "artifacts.read": "artifacts.read";
6771
- "navigation.open-session": "navigation.open-session";
6772
6875
  "artifacts.preview": "artifacts.preview";
6876
+ "markdown.document-view": "markdown.document-view";
6773
6877
  "cost.read": "cost.read";
6774
6878
  "billing.read": "billing.read";
6879
+ "skills.read": "skills.read";
6880
+ "memory.read": "memory.read";
6775
6881
  "self-improvement.read": "self-improvement.read";
6776
6882
  "automations.read": "automations.read";
6883
+ "automations.run": "automations.run";
6777
6884
  "shared-artifacts.read": "shared-artifacts.read";
6778
6885
  "workspace.place-pane": "workspace.place-pane";
6779
6886
  "workspace.pane-header": "workspace.pane-header";
@@ -6793,10 +6900,25 @@ export declare const KayUiTargetManifest: z.ZodObject<{
6793
6900
  primary: "primary";
6794
6901
  plugins: "plugins";
6795
6902
  }>>;
6903
+ badge: z.ZodOptional<z.ZodObject<{
6904
+ source: z.ZodString;
6905
+ where: z.ZodOptional<z.ZodString>;
6906
+ label: z.ZodObject<{
6907
+ one: z.ZodOptional<z.ZodString>;
6908
+ other: z.ZodString;
6909
+ }, z.core.$strict>;
6910
+ }, z.core.$strict>>;
6796
6911
  panel: z.ZodOptional<z.ZodObject<{
6797
6912
  body: z.ZodString;
6798
6913
  }, z.core.$strict>>;
6799
6914
  }, z.core.$strict>>>;
6915
+ pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
6916
+ id: z.ZodString;
6917
+ title: z.ZodOptional<z.ZodString>;
6918
+ icon: z.ZodOptional<z.ZodString>;
6919
+ companion: z.ZodOptional<z.ZodBoolean>;
6920
+ openedEvent: z.ZodOptional<z.ZodString>;
6921
+ }, z.core.$strict>>>;
6800
6922
  themes: z.ZodOptional<z.ZodArray<z.ZodObject<{
6801
6923
  localId: z.ZodString;
6802
6924
  displayName: z.ZodString;
@@ -6966,10 +7088,10 @@ export declare function parseArtifactProvenanceCaptureContext(input: unknown): A
6966
7088
  export declare function parseArtifactProvenanceEnvelope(input: unknown): ArtifactProvenanceEnvelopeV1;
6967
7089
 
6968
7090
  /**
6969
- * Parses a declared command's `where`: `||`, `&&`, `!`, parentheses, `==`, `!=`, strings, `true`,
6970
- * `false` and dotted keys, for example `account.signedIn || app.channel != 'production'`.
7091
+ * Parses a declared command's `where`, for example
7092
+ * `account.signedIn || app.channel != 'production'`. Only the keys above parse.
6971
7093
  */
6972
- export declare function parseCommandWhere(source: string): CommandWhereParseResult;
7094
+ export declare function parseCommandWhere(source: string): WhereParseResult;
6973
7095
 
6974
7096
  /** A `MAJOR.MINOR.PATCH` version broken into its comparable parts. */
6975
7097
  export declare interface ParsedSemver {
@@ -6994,6 +7116,13 @@ export declare function parseResolvedPluginContractV1(value: unknown): ResolvedP
6994
7116
  /** Parses a version against {@link SEMVER_PATTERN}, or returns `undefined` if it isn't valid semver. */
6995
7117
  export declare function parseSemver(value: string): ParsedSemver | undefined;
6996
7118
 
7119
+ /**
7120
+ * Parses a `where` expression: `||`, `&&`, `!`, parentheses, `==`, `!=`, strings, `true`, `false`
7121
+ * and dotted keys, for example `markedForRetirement || proposedRewrite.stale == false`. A bare key
7122
+ * means "is set". With `keyTypes`, only those keys parse, and each is checked against its type.
7123
+ */
7124
+ export declare function parseWhere(source: string, keyTypes?: WhereKeyTypes): WhereParseResult;
7125
+
6997
7126
  /** Every capability slug {@link PluginCapabilityClaimV1} can express, for exhaustive table checks. */
6998
7127
  export declare const PLUGIN_CAPABILITY_SLUGS: readonly ["sessions.run", "network.connect", "web-session.request", "web-session.download", "process.spawn", "sessions.read", "signals.read", "memory.read", "memory.write", "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", "session-events.subscribe", "agents.run", "dynamic-context.register", "app-data.register", "knowledge-source.register", "artifacts.read", "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"];
6999
7128
 
@@ -9172,18 +9301,18 @@ export declare const PluginConfigManifest: z.ZodArray<z.ZodObject<{
9172
9301
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
9173
9302
  defaults: z.ZodOptional<z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
9174
9303
  scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
9175
- agent: "agent";
9176
9304
  global: "global";
9177
9305
  project: "project";
9306
+ agent: "agent";
9178
9307
  }>>>;
9179
9308
  }, z.core.$strict>>;
9180
9309
 
9181
9310
  export declare type PluginConfigManifest = z.infer<typeof PluginConfigManifest>;
9182
9311
 
9183
9312
  export declare const PluginConfigScope: z.ZodEnum<{
9184
- agent: "agent";
9185
9313
  global: "global";
9186
9314
  project: "project";
9315
+ agent: "agent";
9187
9316
  }>;
9188
9317
 
9189
9318
  export declare type PluginConfigScope = z.infer<typeof PluginConfigScope>;
@@ -9193,23 +9322,23 @@ export declare const PluginConfigSectionManifest: z.ZodObject<{
9193
9322
  schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
9194
9323
  defaults: z.ZodOptional<z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
9195
9324
  scopes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
9196
- agent: "agent";
9197
9325
  global: "global";
9198
9326
  project: "project";
9327
+ agent: "agent";
9199
9328
  }>>>;
9200
9329
  }, z.core.$strict>;
9201
9330
 
9202
9331
  export declare type PluginConfigSectionManifest = z.infer<typeof PluginConfigSectionManifest>;
9203
9332
 
9204
9333
  export declare const PluginContributionKind: z.ZodEnum<{
9334
+ endpoint: "endpoint";
9205
9335
  tool: "tool";
9206
9336
  resource: "resource";
9207
- endpoint: "endpoint";
9208
9337
  storage: "storage";
9209
- command: "command";
9210
9338
  uriModule: "uriModule";
9211
9339
  authService: "authService";
9212
9340
  app: "app";
9341
+ command: "command";
9213
9342
  configSection: "configSection";
9214
9343
  skill: "skill";
9215
9344
  converter: "converter";
@@ -10183,9 +10312,37 @@ export declare const ReferenceOpenBehavior: z.ZodDiscriminatedUnion<[z.ZodObject
10183
10312
 
10184
10313
  export declare type ReferenceOpenBehavior = z.infer<typeof ReferenceOpenBehavior>;
10185
10314
 
10315
+ export declare const ReferencePresentationAddress: z.ZodObject<{
10316
+ pattern: z.ZodObject<{
10317
+ protocol: z.ZodString;
10318
+ hostname: z.ZodString;
10319
+ pathname: z.ZodOptional<z.ZodString>;
10320
+ search: z.ZodOptional<z.ZodString>;
10321
+ }, z.core.$strict>;
10322
+ objectId: z.ZodOptional<z.ZodString>;
10323
+ open: z.ZodOptional<z.ZodObject<{
10324
+ kind: z.ZodLiteral<"none">;
10325
+ }, z.core.$strict>>;
10326
+ }, z.core.$strict>;
10327
+
10328
+ export declare type ReferencePresentationAddress = z.infer<typeof ReferencePresentationAddress>;
10329
+
10186
10330
  export declare const ReferencePresentationContribution: z.ZodObject<{
10187
10331
  localId: z.ZodString;
10188
- uriModule: z.ZodString;
10332
+ uriModule: z.ZodOptional<z.ZodString>;
10333
+ scheme: z.ZodOptional<z.ZodString>;
10334
+ addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
10335
+ pattern: z.ZodObject<{
10336
+ protocol: z.ZodString;
10337
+ hostname: z.ZodString;
10338
+ pathname: z.ZodOptional<z.ZodString>;
10339
+ search: z.ZodOptional<z.ZodString>;
10340
+ }, z.core.$strict>;
10341
+ objectId: z.ZodOptional<z.ZodString>;
10342
+ open: z.ZodOptional<z.ZodObject<{
10343
+ kind: z.ZodLiteral<"none">;
10344
+ }, z.core.$strict>>;
10345
+ }, z.core.$strict>>>;
10189
10346
  resourceKind: z.ZodString;
10190
10347
  open: z.ZodDiscriminatedUnion<[z.ZodObject<{
10191
10348
  kind: z.ZodLiteral<"working-document">;
@@ -10506,30 +10663,30 @@ export declare const ResolvedKayAgentUriModule: z.ZodObject<{
10506
10663
  description: z.ZodString;
10507
10664
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
10508
10665
  search: "search";
10509
- delete: "delete";
10510
10666
  list: "list";
10511
10667
  read: "read";
10512
10668
  write: "write";
10513
10669
  help: "help";
10514
10670
  edit: "edit";
10671
+ delete: "delete";
10515
10672
  }>>>;
10516
10673
  operationDocs: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
10517
10674
  search: "search";
10518
- delete: "delete";
10519
10675
  list: "list";
10520
10676
  read: "read";
10521
10677
  write: "write";
10522
10678
  help: "help";
10523
10679
  edit: "edit";
10680
+ delete: "delete";
10524
10681
  }> & z.core.$partial, z.ZodString>>;
10525
10682
  operationDefaults: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
10526
10683
  search: "search";
10527
- delete: "delete";
10528
10684
  list: "list";
10529
10685
  read: "read";
10530
10686
  write: "write";
10531
10687
  help: "help";
10532
10688
  edit: "edit";
10689
+ delete: "delete";
10533
10690
  }> & z.core.$partial, z.ZodEnum<{
10534
10691
  never: "never";
10535
10692
  allow: "allow";
@@ -10588,12 +10745,12 @@ export declare const ResolvedKayAgentUriModule: z.ZodObject<{
10588
10745
  action: z.ZodString;
10589
10746
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
10590
10747
  search: "search";
10591
- delete: "delete";
10592
10748
  list: "list";
10593
10749
  read: "read";
10594
10750
  write: "write";
10595
10751
  help: "help";
10596
10752
  edit: "edit";
10753
+ delete: "delete";
10597
10754
  }>>>;
10598
10755
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
10599
10756
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -10601,12 +10758,12 @@ export declare const ResolvedKayAgentUriModule: z.ZodObject<{
10601
10758
  public: z.ZodLiteral<true>;
10602
10759
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
10603
10760
  search: "search";
10604
- delete: "delete";
10605
10761
  list: "list";
10606
10762
  read: "read";
10607
10763
  write: "write";
10608
10764
  help: "help";
10609
10765
  edit: "edit";
10766
+ delete: "delete";
10610
10767
  }>>>;
10611
10768
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
10612
10769
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -10727,9 +10884,9 @@ export declare const ResolvedKayAppDataSource: z.ZodObject<{
10727
10884
  localId: z.ZodString;
10728
10885
  globalId: z.ZodString;
10729
10886
  scope: z.ZodEnum<{
10730
- session: "session";
10731
10887
  runtime: "runtime";
10732
10888
  account: "account";
10889
+ session: "session";
10733
10890
  }>;
10734
10891
  snapshot: z.ZodObject<{
10735
10892
  version: z.ZodNumber;
@@ -10848,17 +11005,18 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
10848
11005
  globalId: z.ZodString;
10849
11006
  }, z.core.$strict>>>;
10850
11007
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
11008
+ "navigation.open-session": "navigation.open-session";
10851
11009
  "sessions.create": "sessions.create";
10852
- "memory.read": "memory.read";
10853
- "skills.read": "skills.read";
10854
- "automations.run": "automations.run";
10855
11010
  "artifacts.read": "artifacts.read";
10856
- "navigation.open-session": "navigation.open-session";
10857
11011
  "artifacts.preview": "artifacts.preview";
11012
+ "markdown.document-view": "markdown.document-view";
10858
11013
  "cost.read": "cost.read";
10859
11014
  "billing.read": "billing.read";
11015
+ "skills.read": "skills.read";
11016
+ "memory.read": "memory.read";
10860
11017
  "self-improvement.read": "self-improvement.read";
10861
11018
  "automations.read": "automations.read";
11019
+ "automations.run": "automations.run";
10862
11020
  "shared-artifacts.read": "shared-artifacts.read";
10863
11021
  "workspace.place-pane": "workspace.place-pane";
10864
11022
  "workspace.pane-header": "workspace.pane-header";
@@ -11194,14 +11352,14 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
11194
11352
  "kay.ui": "kay.ui";
11195
11353
  }>;
11196
11354
  kind: z.ZodEnum<{
11355
+ endpoint: "endpoint";
11197
11356
  tool: "tool";
11198
11357
  resource: "resource";
11199
- endpoint: "endpoint";
11200
11358
  storage: "storage";
11201
- command: "command";
11202
11359
  uriModule: "uriModule";
11203
11360
  authService: "authService";
11204
11361
  app: "app";
11362
+ command: "command";
11205
11363
  configSection: "configSection";
11206
11364
  skill: "skill";
11207
11365
  converter: "converter";
@@ -11722,30 +11880,30 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
11722
11880
  description: z.ZodString;
11723
11881
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
11724
11882
  search: "search";
11725
- delete: "delete";
11726
11883
  list: "list";
11727
11884
  read: "read";
11728
11885
  write: "write";
11729
11886
  help: "help";
11730
11887
  edit: "edit";
11888
+ delete: "delete";
11731
11889
  }>>>;
11732
11890
  operationDocs: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
11733
11891
  search: "search";
11734
- delete: "delete";
11735
11892
  list: "list";
11736
11893
  read: "read";
11737
11894
  write: "write";
11738
11895
  help: "help";
11739
11896
  edit: "edit";
11897
+ delete: "delete";
11740
11898
  }> & z.core.$partial, z.ZodString>>;
11741
11899
  operationDefaults: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
11742
11900
  search: "search";
11743
- delete: "delete";
11744
11901
  list: "list";
11745
11902
  read: "read";
11746
11903
  write: "write";
11747
11904
  help: "help";
11748
11905
  edit: "edit";
11906
+ delete: "delete";
11749
11907
  }> & z.core.$partial, z.ZodEnum<{
11750
11908
  never: "never";
11751
11909
  allow: "allow";
@@ -11804,12 +11962,12 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
11804
11962
  action: z.ZodString;
11805
11963
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
11806
11964
  search: "search";
11807
- delete: "delete";
11808
11965
  list: "list";
11809
11966
  read: "read";
11810
11967
  write: "write";
11811
11968
  help: "help";
11812
11969
  edit: "edit";
11970
+ delete: "delete";
11813
11971
  }>>>;
11814
11972
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
11815
11973
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -11817,12 +11975,12 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
11817
11975
  public: z.ZodLiteral<true>;
11818
11976
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
11819
11977
  search: "search";
11820
- delete: "delete";
11821
11978
  list: "list";
11822
11979
  read: "read";
11823
11980
  write: "write";
11824
11981
  help: "help";
11825
11982
  edit: "edit";
11983
+ delete: "delete";
11826
11984
  }>>>;
11827
11985
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
11828
11986
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -12004,9 +12162,9 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
12004
12162
  localId: z.ZodString;
12005
12163
  globalId: z.ZodString;
12006
12164
  scope: z.ZodEnum<{
12007
- session: "session";
12008
12165
  runtime: "runtime";
12009
12166
  account: "account";
12167
+ session: "session";
12010
12168
  }>;
12011
12169
  snapshot: z.ZodObject<{
12012
12170
  version: z.ZodNumber;
@@ -12080,7 +12238,20 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
12080
12238
  referencePresentations: z.ZodOptional<z.ZodArray<z.ZodObject<{
12081
12239
  localId: z.ZodString;
12082
12240
  globalId: z.ZodString;
12083
- uriModule: z.ZodString;
12241
+ uriModule: z.ZodOptional<z.ZodString>;
12242
+ schemes: z.ZodOptional<z.ZodArray<z.ZodString>>;
12243
+ addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
12244
+ pattern: z.ZodObject<{
12245
+ protocol: z.ZodString;
12246
+ hostname: z.ZodString;
12247
+ pathname: z.ZodOptional<z.ZodString>;
12248
+ search: z.ZodOptional<z.ZodString>;
12249
+ }, z.core.$strict>;
12250
+ objectId: z.ZodOptional<z.ZodString>;
12251
+ open: z.ZodOptional<z.ZodObject<{
12252
+ kind: z.ZodLiteral<"none">;
12253
+ }, z.core.$strict>>;
12254
+ }, z.core.$strict>>>;
12084
12255
  resourceKind: z.ZodString;
12085
12256
  open: z.ZodDiscriminatedUnion<[z.ZodObject<{
12086
12257
  kind: z.ZodLiteral<"working-document">;
@@ -12140,17 +12311,18 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
12140
12311
  globalId: z.ZodString;
12141
12312
  }, z.core.$strict>>>;
12142
12313
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
12314
+ "navigation.open-session": "navigation.open-session";
12143
12315
  "sessions.create": "sessions.create";
12144
- "memory.read": "memory.read";
12145
- "skills.read": "skills.read";
12146
- "automations.run": "automations.run";
12147
12316
  "artifacts.read": "artifacts.read";
12148
- "navigation.open-session": "navigation.open-session";
12149
12317
  "artifacts.preview": "artifacts.preview";
12318
+ "markdown.document-view": "markdown.document-view";
12150
12319
  "cost.read": "cost.read";
12151
12320
  "billing.read": "billing.read";
12321
+ "skills.read": "skills.read";
12322
+ "memory.read": "memory.read";
12152
12323
  "self-improvement.read": "self-improvement.read";
12153
12324
  "automations.read": "automations.read";
12325
+ "automations.run": "automations.run";
12154
12326
  "shared-artifacts.read": "shared-artifacts.read";
12155
12327
  "workspace.place-pane": "workspace.place-pane";
12156
12328
  "workspace.pane-header": "workspace.pane-header";
@@ -12169,14 +12341,14 @@ export declare const ResolvedPluginContributionId: z.ZodObject<{
12169
12341
  "kay.ui": "kay.ui";
12170
12342
  }>;
12171
12343
  kind: z.ZodEnum<{
12344
+ endpoint: "endpoint";
12172
12345
  tool: "tool";
12173
12346
  resource: "resource";
12174
- endpoint: "endpoint";
12175
12347
  storage: "storage";
12176
- command: "command";
12177
12348
  uriModule: "uriModule";
12178
12349
  authService: "authService";
12179
12350
  app: "app";
12351
+ command: "command";
12180
12352
  configSection: "configSection";
12181
12353
  skill: "skill";
12182
12354
  converter: "converter";
@@ -12546,7 +12718,20 @@ export declare type ResolvedPluginWebSession = z.infer<typeof ResolvedPluginWebS
12546
12718
  export declare const ResolvedReferencePresentation: z.ZodObject<{
12547
12719
  localId: z.ZodString;
12548
12720
  globalId: z.ZodString;
12549
- uriModule: z.ZodString;
12721
+ uriModule: z.ZodOptional<z.ZodString>;
12722
+ schemes: z.ZodOptional<z.ZodArray<z.ZodString>>;
12723
+ addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
12724
+ pattern: z.ZodObject<{
12725
+ protocol: z.ZodString;
12726
+ hostname: z.ZodString;
12727
+ pathname: z.ZodOptional<z.ZodString>;
12728
+ search: z.ZodOptional<z.ZodString>;
12729
+ }, z.core.$strict>;
12730
+ objectId: z.ZodOptional<z.ZodString>;
12731
+ open: z.ZodOptional<z.ZodObject<{
12732
+ kind: z.ZodLiteral<"none">;
12733
+ }, z.core.$strict>>;
12734
+ }, z.core.$strict>>>;
12550
12735
  resourceKind: z.ZodString;
12551
12736
  open: z.ZodDiscriminatedUnion<[z.ZodObject<{
12552
12737
  kind: z.ZodLiteral<"working-document">;
@@ -12802,6 +12987,9 @@ export declare const RichViewContribution: z.ZodObject<{
12802
12987
 
12803
12988
  export declare type RichViewContribution = z.infer<typeof RichViewContribution>;
12804
12989
 
12990
+ /** Whether a `where` holds for one row. A field the row doesn't have is absent, not unknown. */
12991
+ export declare function rowMatchesWhere(where: Where, row: Readonly<Record<string, unknown>>): boolean;
12992
+
12805
12993
  /**
12806
12994
  * Resolves a manifest without throwing for known contract resolution failures.
12807
12995
  *
@@ -13724,17 +13912,18 @@ export declare interface TurnPacketMessage {
13724
13912
  export declare const UiAppCapabilities: z.ZodObject<{
13725
13913
  endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
13726
13914
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
13915
+ "navigation.open-session": "navigation.open-session";
13727
13916
  "sessions.create": "sessions.create";
13728
- "memory.read": "memory.read";
13729
- "skills.read": "skills.read";
13730
- "automations.run": "automations.run";
13731
13917
  "artifacts.read": "artifacts.read";
13732
- "navigation.open-session": "navigation.open-session";
13733
13918
  "artifacts.preview": "artifacts.preview";
13919
+ "markdown.document-view": "markdown.document-view";
13734
13920
  "cost.read": "cost.read";
13735
13921
  "billing.read": "billing.read";
13922
+ "skills.read": "skills.read";
13923
+ "memory.read": "memory.read";
13736
13924
  "self-improvement.read": "self-improvement.read";
13737
13925
  "automations.read": "automations.read";
13926
+ "automations.run": "automations.run";
13738
13927
  "shared-artifacts.read": "shared-artifacts.read";
13739
13928
  "workspace.place-pane": "workspace.place-pane";
13740
13929
  "workspace.pane-header": "workspace.pane-header";
@@ -13763,17 +13952,18 @@ export declare const UiAppContribution: z.ZodObject<{
13763
13952
  capabilities: z.ZodOptional<z.ZodObject<{
13764
13953
  endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
13765
13954
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
13955
+ "navigation.open-session": "navigation.open-session";
13766
13956
  "sessions.create": "sessions.create";
13767
- "memory.read": "memory.read";
13768
- "skills.read": "skills.read";
13769
- "automations.run": "automations.run";
13770
13957
  "artifacts.read": "artifacts.read";
13771
- "navigation.open-session": "navigation.open-session";
13772
13958
  "artifacts.preview": "artifacts.preview";
13959
+ "markdown.document-view": "markdown.document-view";
13773
13960
  "cost.read": "cost.read";
13774
13961
  "billing.read": "billing.read";
13962
+ "skills.read": "skills.read";
13963
+ "memory.read": "memory.read";
13775
13964
  "self-improvement.read": "self-improvement.read";
13776
13965
  "automations.read": "automations.read";
13966
+ "automations.run": "automations.run";
13777
13967
  "shared-artifacts.read": "shared-artifacts.read";
13778
13968
  "workspace.place-pane": "workspace.place-pane";
13779
13969
  "workspace.pane-header": "workspace.pane-header";
@@ -13799,17 +13989,18 @@ export declare const UiAppContribution: z.ZodObject<{
13799
13989
  capabilities: z.ZodOptional<z.ZodObject<{
13800
13990
  endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
13801
13991
  host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
13992
+ "navigation.open-session": "navigation.open-session";
13802
13993
  "sessions.create": "sessions.create";
13803
- "memory.read": "memory.read";
13804
- "skills.read": "skills.read";
13805
- "automations.run": "automations.run";
13806
13994
  "artifacts.read": "artifacts.read";
13807
- "navigation.open-session": "navigation.open-session";
13808
13995
  "artifacts.preview": "artifacts.preview";
13996
+ "markdown.document-view": "markdown.document-view";
13809
13997
  "cost.read": "cost.read";
13810
13998
  "billing.read": "billing.read";
13999
+ "skills.read": "skills.read";
14000
+ "memory.read": "memory.read";
13811
14001
  "self-improvement.read": "self-improvement.read";
13812
14002
  "automations.read": "automations.read";
14003
+ "automations.run": "automations.run";
13813
14004
  "shared-artifacts.read": "shared-artifacts.read";
13814
14005
  "workspace.place-pane": "workspace.place-pane";
13815
14006
  "workspace.pane-header": "workspace.pane-header";
@@ -13844,6 +14035,16 @@ export declare const UiEventSubscriptionContribution: z.ZodObject<{
13844
14035
 
13845
14036
  export declare type UiEventSubscriptionContribution = z.infer<typeof UiEventSubscriptionContribution>;
13846
14037
 
14038
+ export declare const UiPageContribution: z.ZodObject<{
14039
+ id: z.ZodString;
14040
+ title: z.ZodOptional<z.ZodString>;
14041
+ icon: z.ZodOptional<z.ZodString>;
14042
+ companion: z.ZodOptional<z.ZodBoolean>;
14043
+ openedEvent: z.ZodOptional<z.ZodString>;
14044
+ }, z.core.$strict>;
14045
+
14046
+ export declare type UiPageContribution = z.infer<typeof UiPageContribution>;
14047
+
13847
14048
  export declare const UiRailEntryContribution: z.ZodObject<{
13848
14049
  id: z.ZodString;
13849
14050
  title: z.ZodString;
@@ -13856,6 +14057,14 @@ export declare const UiRailEntryContribution: z.ZodObject<{
13856
14057
  primary: "primary";
13857
14058
  plugins: "plugins";
13858
14059
  }>>;
14060
+ badge: z.ZodOptional<z.ZodObject<{
14061
+ source: z.ZodString;
14062
+ where: z.ZodOptional<z.ZodString>;
14063
+ label: z.ZodObject<{
14064
+ one: z.ZodOptional<z.ZodString>;
14065
+ other: z.ZodString;
14066
+ }, z.core.$strict>;
14067
+ }, z.core.$strict>>;
13859
14068
  panel: z.ZodOptional<z.ZodObject<{
13860
14069
  body: z.ZodString;
13861
14070
  }, z.core.$strict>>;
@@ -13909,30 +14118,30 @@ export declare const UriModuleContribution: z.ZodObject<{
13909
14118
  description: z.ZodString;
13910
14119
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
13911
14120
  search: "search";
13912
- delete: "delete";
13913
14121
  list: "list";
13914
14122
  read: "read";
13915
14123
  write: "write";
13916
14124
  help: "help";
13917
14125
  edit: "edit";
14126
+ delete: "delete";
13918
14127
  }>>>;
13919
14128
  operationDocs: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
13920
14129
  search: "search";
13921
- delete: "delete";
13922
14130
  list: "list";
13923
14131
  read: "read";
13924
14132
  write: "write";
13925
14133
  help: "help";
13926
14134
  edit: "edit";
14135
+ delete: "delete";
13927
14136
  }> & z.core.$partial, z.ZodString>>;
13928
14137
  operationDefaults: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
13929
14138
  search: "search";
13930
- delete: "delete";
13931
14139
  list: "list";
13932
14140
  read: "read";
13933
14141
  write: "write";
13934
14142
  help: "help";
13935
14143
  edit: "edit";
14144
+ delete: "delete";
13936
14145
  }> & z.core.$partial, z.ZodEnum<{
13937
14146
  never: "never";
13938
14147
  allow: "allow";
@@ -13991,12 +14200,12 @@ export declare const UriModuleContribution: z.ZodObject<{
13991
14200
  action: z.ZodString;
13992
14201
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
13993
14202
  search: "search";
13994
- delete: "delete";
13995
14203
  list: "list";
13996
14204
  read: "read";
13997
14205
  write: "write";
13998
14206
  help: "help";
13999
14207
  edit: "edit";
14208
+ delete: "delete";
14000
14209
  }>>>;
14001
14210
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
14002
14211
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -14004,12 +14213,12 @@ export declare const UriModuleContribution: z.ZodObject<{
14004
14213
  public: z.ZodLiteral<true>;
14005
14214
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
14006
14215
  search: "search";
14007
- delete: "delete";
14008
14216
  list: "list";
14009
14217
  read: "read";
14010
14218
  write: "write";
14011
14219
  help: "help";
14012
14220
  edit: "edit";
14221
+ delete: "delete";
14013
14222
  }>>>;
14014
14223
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
14015
14224
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -14076,30 +14285,30 @@ declare const UriModuleFacts: z.ZodObject<{
14076
14285
  description: z.ZodString;
14077
14286
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
14078
14287
  search: "search";
14079
- delete: "delete";
14080
14288
  list: "list";
14081
14289
  read: "read";
14082
14290
  write: "write";
14083
14291
  help: "help";
14084
14292
  edit: "edit";
14293
+ delete: "delete";
14085
14294
  }>>>;
14086
14295
  operationDocs: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
14087
14296
  search: "search";
14088
- delete: "delete";
14089
14297
  list: "list";
14090
14298
  read: "read";
14091
14299
  write: "write";
14092
14300
  help: "help";
14093
14301
  edit: "edit";
14302
+ delete: "delete";
14094
14303
  }> & z.core.$partial, z.ZodString>>;
14095
14304
  operationDefaults: z.ZodExactOptional<z.ZodRecord<z.ZodEnum<{
14096
14305
  search: "search";
14097
- delete: "delete";
14098
14306
  list: "list";
14099
14307
  read: "read";
14100
14308
  write: "write";
14101
14309
  help: "help";
14102
14310
  edit: "edit";
14311
+ delete: "delete";
14103
14312
  }> & z.core.$partial, z.ZodEnum<{
14104
14313
  never: "never";
14105
14314
  allow: "allow";
@@ -14158,12 +14367,12 @@ declare const UriModuleFacts: z.ZodObject<{
14158
14367
  action: z.ZodString;
14159
14368
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
14160
14369
  search: "search";
14161
- delete: "delete";
14162
14370
  list: "list";
14163
14371
  read: "read";
14164
14372
  write: "write";
14165
14373
  help: "help";
14166
14374
  edit: "edit";
14375
+ delete: "delete";
14167
14376
  }>>>;
14168
14377
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
14169
14378
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -14171,12 +14380,12 @@ declare const UriModuleFacts: z.ZodObject<{
14171
14380
  public: z.ZodLiteral<true>;
14172
14381
  operations: z.ZodExactOptional<z.ZodArray<z.ZodEnum<{
14173
14382
  search: "search";
14174
- delete: "delete";
14175
14383
  list: "list";
14176
14384
  read: "read";
14177
14385
  write: "write";
14178
14386
  help: "help";
14179
14387
  edit: "edit";
14388
+ delete: "delete";
14180
14389
  }>>>;
14181
14390
  routes: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
14182
14391
  query: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -14260,12 +14469,43 @@ export declare type WebSessionGrantRequest = z.infer<typeof WebSessionGrantReque
14260
14469
  */
14261
14470
  export declare function webSessionPathWithinPrefix(pathname: string, pathPrefix: string): boolean;
14262
14471
 
14263
- /** What a `where` expression can read, and the type of each. */
14472
+ export declare type Where = {
14473
+ readonly kind: "literal";
14474
+ readonly value: boolean;
14475
+ } | {
14476
+ readonly kind: "key";
14477
+ readonly key: string;
14478
+ } | {
14479
+ readonly kind: "equals";
14480
+ readonly key: string;
14481
+ readonly value: boolean | string;
14482
+ readonly negated: boolean;
14483
+ } | {
14484
+ readonly kind: "not";
14485
+ readonly operand: Where;
14486
+ } | {
14487
+ readonly kind: "and" | "or";
14488
+ readonly left: Where;
14489
+ readonly right: Where;
14490
+ };
14491
+
14492
+ /** What a command's `where` can read, and the type of each. */
14264
14493
  declare const WHERE_KEY_TYPES: {
14265
14494
  readonly "account.signedIn": "boolean";
14266
14495
  readonly "app.channel": "string";
14267
14496
  };
14268
14497
 
14498
+ /** What a caller's keys are, when it has a fixed set. A bare string key must be compared. */
14499
+ export declare type WhereKeyTypes = Readonly<Record<string, "boolean" | "string">>;
14500
+
14501
+ export declare type WhereParseResult = {
14502
+ readonly ok: true;
14503
+ readonly where: Where;
14504
+ } | {
14505
+ readonly ok: false;
14506
+ readonly message: string;
14507
+ };
14508
+
14269
14509
  /** Construct the exact claim row for one Whiteboard scope and operation. */
14270
14510
  export declare function whiteboardCapabilityClaim(operation: WhiteboardCapabilityOperation, scope: WhiteboardCapabilityScope, target?: "kay.agent"): WhiteboardCapabilityClaimV1;
14271
14511
 
@@ -14294,9 +14534,9 @@ export declare const WhiteboardCapabilityClaimV1: z.ZodObject<{
14294
14534
  export declare type WhiteboardCapabilityClaimV1 = z.infer<typeof WhiteboardCapabilityClaimV1>;
14295
14535
 
14296
14536
  export declare const WhiteboardCapabilityOperation: z.ZodEnum<{
14537
+ read: "read";
14297
14538
  create: "create";
14298
14539
  update: "update";
14299
- read: "read";
14300
14540
  discover: "discover";
14301
14541
  remove: "remove";
14302
14542
  }>;