@yaklabs-ai/plugin-sdk 0.45.0 → 0.47.0

package/dist/kay-agent-testing.d.ts

@@ -2485,9 +2485,21 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * 0.44.0 adds `words.kinds` to a reference presentation (#15905): an ordered list of address patterns
  * and the kind each one names. Additive: a plugin that lists them declares ^0.44.0.
  *
- * 0.45.0 adds declared plugin cards and app.implementCard for their read/submit endpoints.
+ * 0.45.0 adds declared plugin cards and app.implementCard for their read/submit endpoints. It also
+ * lets a plugin declare what the window hardcoded about it (#15906). A reference presentation gains
+ * `accountLinks`, how a page opens under the account an address means, and a `local-app` open, for
+ * an item an app on this machine shows; a plugin the person installed can't declare that open. A
+ * `webSession` gains `signInFirst`. A URI module defines `lookupWebLink` and sets `looksUpWebLinks`
+ * to find a page when someone opens the address, and a preview field marks which `part` of a message
+ * it is. A claim's `brandIcon` is a file path and no longer inline markup, which only this repo's
+ * Microsoft plugin used. Otherwise additive: a plugin using any of these declares ^0.45.0.
+ *
+ * 0.46.0 adds `@bonsai/plugin-sdk/artifact-provenance`, so a plugin shipped as files can finalize
+ * and read the provenance the host captured. Additive: a plugin that imports it declares ^0.46.0.
+ *
+ * 0.47.0 adds card layouts and builders; successful card submits now require a summary.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.45.0";
+declare const KAY_PLUGIN_SDK_VERSION: "0.47.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -4751,6 +4763,7 @@ declare function refineWebSessionScopeConfined(webSession: {
     readonly probe: {
         readonly url: string;
     };
+    readonly signInFirst?: string | undefined;
 }, ctx: z.RefinementCtx): void;
 
 declare const RegistrableDomain: z.ZodString;
@@ -4861,9 +4874,8 @@ declare const ResolvedPluginContractV1: z.ZodObject<{
             storage: "storage";
             uriModule: "uriModule";
             authService: "authService";
-            app: "app";
             command: "command";
-            configSection: "configSection";
+            app: "app";
             skill: "skill";
             converter: "converter";
             artifactUriModule: "artifactUriModule";
@@ -4886,11 +4898,9 @@ declare const ResolvedPluginContractV1: z.ZodObject<{
             mcpServer: "mcpServer";
             uiCommand: "uiCommand";
             uiSlot: "uiSlot";
-            settingsPanel: "settingsPanel";
-            resultRenderer: "resultRenderer";
             referencePresentation: "referencePresentation";
-            view: "view";
             theme: "theme";
+            configSection: "configSection";
         }>;
         localId: z.ZodString;
         globalId: z.ZodString;
@@ -5059,6 +5069,7 @@ declare const ResolvedPluginContractV1: z.ZodObject<{
                 external: "external";
                 embedded: "embedded";
             }>;
+            signInFirst: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
     grants: z.ZodOptional<z.ZodObject<{
@@ -5518,6 +5529,7 @@ declare const ResolvedPluginContractV1: z.ZodObject<{
         authSchemeId: z.ZodOptional<z.ZodString>;
         knownResources: z.ZodOptional<z.ZodLiteral<true>>;
         describesOperations: z.ZodOptional<z.ZodLiteral<true>>;
+        looksUpWebLinks: z.ZodOptional<z.ZodLiteral<true>>;
     }, z.core.$strict>>>;
     kayAgentArtifactUriModules: z.ZodOptional<z.ZodArray<z.ZodObject<{
         localId: z.ZodString;
@@ -5741,9 +5753,6 @@ declare const ResolvedPluginContractV1: z.ZodObject<{
             bodyField: z.ZodString;
         }, z.core.$strict>], "kind">;
         valueSchema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
-        presentation: z.ZodOptional<z.ZodObject<{
-            app: z.ZodString;
-        }, z.core.$strict>>;
     }, z.core.$strict>>>;
     kayAppMcpServers: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -5769,6 +5778,29 @@ declare const ResolvedPluginContractV1: z.ZodObject<{
         uriModule: z.ZodOptional<z.ZodString>;
         schemes: z.ZodOptional<z.ZodArray<z.ZodString>>;
         displayName: z.ZodOptional<z.ZodString>;
+        authService: z.ZodOptional<z.ZodString>;
+        accountLinks: z.ZodOptional<z.ZodObject<{
+            label: z.ZodOptional<z.ZodEnum<{
+                email: "email";
+                name: "name";
+            }>>;
+            pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                hostname: z.ZodString;
+                pathname: z.ZodOptional<z.ZodString>;
+                unlessPathname: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                setPathname: z.ZodOptional<z.ZodString>;
+                addQuery: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strict>>>;
+            addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                pattern: z.ZodObject<{
+                    protocol: z.ZodString;
+                    hostname: z.ZodString;
+                    pathname: z.ZodOptional<z.ZodString>;
+                    search: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+                url: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
         addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
             pattern: z.ZodObject<{
                 protocol: z.ZodString;
@@ -5789,6 +5821,9 @@ declare const ResolvedPluginContractV1: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"page">;
             pageId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"local-app">;
+            schemes: z.ZodArray<z.ZodString>;
         }, z.core.$strict>], "kind">>;
         variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             resourceKind: z.ZodString;
@@ -8957,6 +8992,7 @@ declare const toolCallFailureCauseSchema: z.ZodObject<{
         errorName: z.ZodOptional<z.ZodString>;
         errorCode: z.ZodOptional<z.ZodString>;
         providerCode: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
         status: z.ZodOptional<z.ZodNumber>;
         editIndex: z.ZodOptional<z.ZodNumber>;
         occurrences: z.ZodOptional<z.ZodNumber>;
@@ -10670,6 +10706,11 @@ declare type UriClaim = UriSchemeClaim | UriPatternClaim | UrlPatternClaim;
  * - `base64`: unpadded base64 of the UTF-8 text (`{base64(:id :calendar)}`).
  * - `slackTimestamp`: a Slack archive message token as the API's timestamp
  *   (`p1783350000000100` becomes `1783350000.000100`).
+ * - `beforeColon`: the part of a `<team>:<user>` id before the colon. It fills nothing for an id
+ *   with no colon or nothing before it.
+ * - `beforeTilde`: the part of an id before its last `~`. It fills nothing with no `~`.
+ * - `encoded`: every reserved character escaped, `:` and `@` too, for a whole URL carried as a
+ *   query value (`continue={encoded(:url)}`).
  *
  * A transform that cannot read its input fills nothing. A claim whose `normalizeTo` fills nothing
  * does not match; a `sourceUrl` that fills nothing paints no link.
@@ -10928,6 +10969,13 @@ declare interface UriModule {
         readonly uri: string;
         readonly payload: unknown;
     }, ctx: UriResolveContext): Promise<UriOperationDescription | undefined>;
+    /**
+     * Find the web address of `uri` by asking the provider, for a resource whose address alone can't
+     * name its page. Called only when someone opens the address, under the account it means, and never
+     * to draw a reference. `undefined` means there's no page to open. A plugin module that defines
+     * this sets `looksUpWebLinks` in its manifest.
+     */
+    lookupWebLink?(uri: string, ctx: UriResolveContext): Promise<string | undefined>;
     readonly getCachePolicy?: UriCachePolicyResolver;
     /**
      * Code matching, for the host's own modules whose addresses no claim can describe (a bare file
@@ -11049,6 +11097,11 @@ declare interface UriOperationDescription {
             readonly editable?: true;
             /** Longest edited value, in UTF-16 code units. Meaningful only with `editable`. */
             readonly maxLength?: number;
+            /**
+             * Which part of a message this field is, when the call sends one. A preview with a `to` and
+             * a `text` is drawn as a message; without them it stays labelled rows.
+             */
+            readonly part?: "to" | "cc" | "bcc" | "subject" | "text";
         }[];
     };
     /** True only when every displayed fact comes from the input, independent of the executing account. */
@@ -11654,9 +11707,6 @@ declare const WhiteboardTypeInfo: z.ZodObject<{
     displayName: z.ZodString;
     schemaVersion: z.ZodNumber;
     available: z.ZodBoolean;
-    presentation: z.ZodOptional<z.ZodObject<{
-        app: z.ZodString;
-    }, z.core.$strict>>;
 }, z.core.$strict>;
 
 declare type WhiteboardTypeInfo = Readonly<z.infer<typeof WhiteboardTypeInfo>>;

package/dist/kay-agent.d.ts

@@ -2760,9 +2760,21 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * 0.44.0 adds `words.kinds` to a reference presentation (#15905): an ordered list of address patterns
  * and the kind each one names. Additive: a plugin that lists them declares ^0.44.0.
  *
- * 0.45.0 adds declared plugin cards and app.implementCard for their read/submit endpoints.
+ * 0.45.0 adds declared plugin cards and app.implementCard for their read/submit endpoints. It also
+ * lets a plugin declare what the window hardcoded about it (#15906). A reference presentation gains
+ * `accountLinks`, how a page opens under the account an address means, and a `local-app` open, for
+ * an item an app on this machine shows; a plugin the person installed can't declare that open. A
+ * `webSession` gains `signInFirst`. A URI module defines `lookupWebLink` and sets `looksUpWebLinks`
+ * to find a page when someone opens the address, and a preview field marks which `part` of a message
+ * it is. A claim's `brandIcon` is a file path and no longer inline markup, which only this repo's
+ * Microsoft plugin used. Otherwise additive: a plugin using any of these declares ^0.45.0.
+ *
+ * 0.46.0 adds `@bonsai/plugin-sdk/artifact-provenance`, so a plugin shipped as files can finalize
+ * and read the provenance the host captured. Additive: a plugin that imports it declares ^0.46.0.
+ *
+ * 0.47.0 adds card layouts and builders; successful card submits now require a summary.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.45.0";
+declare const KAY_PLUGIN_SDK_VERSION: "0.47.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -5800,6 +5812,7 @@ declare function refineWebSessionScopeConfined(webSession: {
     readonly probe: {
         readonly url: string;
     };
+    readonly signInFirst?: string | undefined;
 }, ctx: z.RefinementCtx): void;
 
 declare const RegistrableDomain: z.ZodString;
@@ -9038,6 +9051,7 @@ declare const toolCallFailureCauseSchema: z.ZodObject<{
         errorName: z.ZodOptional<z.ZodString>;
         errorCode: z.ZodOptional<z.ZodString>;
         providerCode: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
         status: z.ZodOptional<z.ZodNumber>;
         editIndex: z.ZodOptional<z.ZodNumber>;
         occurrences: z.ZodOptional<z.ZodNumber>;
@@ -10790,6 +10804,11 @@ export declare type UriClaim = UriSchemeClaim | UriPatternClaim | UrlPatternClai
  * - `base64`: unpadded base64 of the UTF-8 text (`{base64(:id :calendar)}`).
  * - `slackTimestamp`: a Slack archive message token as the API's timestamp
  *   (`p1783350000000100` becomes `1783350000.000100`).
+ * - `beforeColon`: the part of a `<team>:<user>` id before the colon. It fills nothing for an id
+ *   with no colon or nothing before it.
+ * - `beforeTilde`: the part of an id before its last `~`. It fills nothing with no `~`.
+ * - `encoded`: every reserved character escaped, `:` and `@` too, for a whole URL carried as a
+ *   query value (`continue={encoded(:url)}`).
  *
  * A transform that cannot read its input fills nothing. A claim whose `normalizeTo` fills nothing
  * does not match; a `sourceUrl` that fills nothing paints no link.
@@ -11096,6 +11115,13 @@ export declare interface UriModule {
         readonly uri: string;
         readonly payload: unknown;
     }, ctx: UriResolveContext): Promise<UriOperationDescription | undefined>;
+    /**
+     * Find the web address of `uri` by asking the provider, for a resource whose address alone can't
+     * name its page. Called only when someone opens the address, under the account it means, and never
+     * to draw a reference. `undefined` means there's no page to open. A plugin module that defines
+     * this sets `looksUpWebLinks` in its manifest.
+     */
+    lookupWebLink?(uri: string, ctx: UriResolveContext): Promise<string | undefined>;
     readonly getCachePolicy?: UriCachePolicyResolver;
     /**
      * Code matching, for the host's own modules whose addresses no claim can describe (a bare file
@@ -11234,6 +11260,11 @@ export declare interface UriOperationDescription {
             readonly editable?: true;
             /** Longest edited value, in UTF-16 code units. Meaningful only with `editable`. */
             readonly maxLength?: number;
+            /**
+             * Which part of a message this field is, when the call sends one. A preview with a `to` and
+             * a `text` is drawn as a message; without them it stays labelled rows.
+             */
+            readonly part?: "to" | "cc" | "bcc" | "subject" | "text";
         }[];
     };
     /** True only when every displayed fact comes from the input, independent of the executing account. */
@@ -12030,9 +12061,6 @@ export declare const WhiteboardTypeInfo: z.ZodObject<{
     displayName: z.ZodString;
     schemaVersion: z.ZodNumber;
     available: z.ZodBoolean;
-    presentation: z.ZodOptional<z.ZodObject<{
-        app: z.ZodString;
-    }, z.core.$strict>>;
 }, z.core.$strict>;
 
 export declare type WhiteboardTypeInfo = Readonly<z.infer<typeof WhiteboardTypeInfo>>;

package/dist/kay-agent.js

@@ -5,12 +5,15 @@ var REST_CAPTURE_RE = /^:([A-Za-z_][A-Za-z0-9_]*)\*$/;
 var CONSTRAINED_CAPTURE_RE = /^([A-Za-z_][A-Za-z0-9_]*)(?:\((.*)\))?(\.[A-Za-z0-9]+)?$/;
 var MAX_CAPTURE_CONSTRAINT_LENGTH = 64;
 function compileUriClaim(claim) {
+  return compileClaim(claim);
+}
+function compileClaim(claim) {
   if (claim.kind === "scheme") {
     const scheme = normalizeProtocol(claim.scheme);
     return {
       claim,
       match(input) {
-        const actual = SCHEME_RE.exec(input.trim())?.[1]?.toLowerCase();
+        const actual = typeof input === "string" ? SCHEME_RE.exec(input.trim())?.[1]?.toLowerCase() : input.scheme;
         if (actual !== scheme)
           return void 0;
         return { claimKind: claim.kind };
@@ -20,8 +23,7 @@ function compileUriClaim(claim) {
   const pattern = compileRoutePattern(claim.pattern);
   const normalizeTo = claim.normalizeTo === void 0 ? void 0 : compileTemplate(claim.normalizeTo);
   const sourceUrl = claim.kind === "uriPattern" && claim.sourceUrl !== void 0 ? compileTemplate(claim.sourceUrl) : void 0;
-  const matchAt = (target, selector) => {
-    const parsed = parsePatternInput(target);
+  const matchAt = (parsed, selector) => {
     if (parsed === void 0)
       return void 0;
     const captures = matchRoute(pattern, parsed);
@@ -47,14 +49,14 @@ function compileUriClaim(claim) {
     claim,
     match(input) {
       if (claim.kind === "uriPattern") {
-        const { selector, rest } = parseUriConnectionSelector(input);
+        const { selector, rest } = typeof input === "string" ? parseUriConnectionSelector(input) : input.connection;
         if (selector !== void 0) {
-          const match = matchAt(rest, selector);
+          const match = matchAt(typeof input === "string" ? parsePatternInput(rest) : input.selected, selector);
           if (match !== void 0)
             return match;
         }
       }
-      return matchAt(input, void 0);
+      return matchAt(typeof input === "string" ? parsePatternInput(input) : input.raw, void 0);
     }
   };
 }
@@ -252,7 +254,16 @@ var TRANSFORMS = {
   slackTimestamp: (value) => {
     const match = /^p(\d+)(\d{6})$/.exec(value);
     return match === null ? void 0 : `${match[1]}.${match[2]}`;
-  }
+  },
+  beforeColon: (value) => {
+    const end = value.indexOf(":");
+    return end > 0 ? value.slice(0, end) : void 0;
+  },
+  beforeTilde: (value) => {
+    const end = value.lastIndexOf("~");
+    return end > 0 ? value.slice(0, end) : void 0;
+  },
+  encoded: encodeURIComponent
 };
 function isTransform(name) {
   return Object.prototype.hasOwnProperty.call(TRANSFORMS, name);
@@ -323,7 +334,7 @@ function fillTemplate(parts, captures, restCaptures) {
     const transformed = TRANSFORMS[part.transform](raw);
     if (transformed === void 0)
       return void 0;
-    out += escapeForPosition(transformed, part.position);
+    out += part.transform === "encoded" ? transformed : escapeForPosition(transformed, part.position);
   }
   return out;
 }