@yaklabs-ai/plugin-sdk 0.10.0 → 0.12.2

package/dist/kay-agent.js

@@ -115,6 +115,26 @@ function filesystemStampDigest(revision) {
   return parts.length === 6 ? parts[5] : void 0;
 }
 
+// packages/herd-uri/dist/produced-resources.js
+var SCHEME_URI = /^[a-z][a-z0-9+.-]*:\/\/./;
+var WINDOWS_ABSOLUTE_PATH = /^[A-Za-z]:[\\/]./;
+function isProducedResourceUri(value) {
+  if (typeof value !== "string" || value.trim() !== value)
+    return false;
+  return SCHEME_URI.test(value) || value.startsWith("/") && value.length > 1 || WINDOWS_ABSOLUTE_PATH.test(value);
+}
+function isProducedResourceDeclaration(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  const keys = Object.keys(value);
+  if (keys.length !== 2 || !keys.includes("uri") || !keys.includes("action")) {
+    return false;
+  }
+  const record = value;
+  return isProducedResourceUri(record.uri) && (record.action === "created" || record.action === "updated");
+}
+
 // packages/herd-uri/dist/template-route.js
 var PLACEHOLDER_RE = /<([^<>]+)>/g;
 var REST_SUFFIX = "...";
@@ -580,6 +600,19 @@ function capability(spec) {
 }
 
 // packages/plugin-sdk/dist/jev.js
+var JevCallError = class extends Error {
+  transport;
+  kind;
+  /** The final attempt's HTTP status, when a response arrived. */
+  status;
+  constructor(init) {
+    super(`Jev call failed on the ${init.transport} route: ${init.kind}${init.status === void 0 ? "" : ` (HTTP ${init.status})`}.`);
+    this.name = "JevCallError";
+    this.transport = init.transport;
+    this.kind = init.kind;
+    this.status = init.status;
+  }
+};
 function createFallbackOnlyWithJev() {
   return async (_use, fallback, options = {}) => {
     if (typeof fallback !== "function") {
@@ -887,6 +920,59 @@ function toToolParameters(schema) {
   return rest;
 }
 
+// packages/herd-agent/dist/core/is-object.js
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// packages/herd-agent/dist/core/tools/produced-resources.js
+var DECLARATIONS = Symbol.for("herd.producedResources.declarations");
+function declareProducedResources(result, declarations) {
+  const details = declarableDetails(result.details);
+  const claims = [...claimsOn(details), ...claimsFrom(declarations)];
+  const next = { ...details };
+  if (claims.length > 0)
+    next[DECLARATIONS] = Object.freeze(claims);
+  return {
+    ...result,
+    details: next
+  };
+}
+function declarableDetails(details) {
+  if (details === void 0)
+    return {};
+  if (!isObject(details)) {
+    throw new TypeError(`declareProducedResources needs a tool result whose details is an object or undefined, not ${Array.isArray(details) ? "an array" : typeof details}.`);
+  }
+  return details;
+}
+function channelOf(details) {
+  return Object.hasOwn(details, DECLARATIONS) ? details[DECLARATIONS] : void 0;
+}
+function claimsOn(details) {
+  const channel = channelOf(details);
+  return channel === void 0 ? [] : claimsFrom(channel);
+}
+function claimsFrom(claimed) {
+  try {
+    return Array.isArray(claimed) ? Array.from(claimed, snapshotClaim) : [snapshotClaim(claimed)];
+  } catch (error) {
+    return [`<unreadable claim: ${typeof error}>`];
+  }
+}
+function snapshotClaim(value) {
+  if (!isObject(value))
+    return jsonValue(value);
+  const copy = Object.fromEntries(Object.entries(value).map(([key, field]) => [key, jsonValue(field)]));
+  return isProducedResourceDeclaration(copy) ? Object.freeze({ uri: copy.uri, action: copy.action }) : Object.freeze(copy);
+}
+function jsonValue(value) {
+  if (value === null || typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  return `<${Array.isArray(value) ? "array" : typeof value}>`;
+}
+
 // packages/plugin-primitives/dist/results.js
 function textResult(text, details) {
   const content = [{ type: "text", text }];
@@ -1041,6 +1127,26 @@ function numLike(record, key) {
   return void 0;
 }
 
+// packages/plugin-sdk/dist/kay-agent/interaction.js
+var INTERACTION_CREDENTIAL_GUARD = "kay.credential-guard/v1";
+function unavailableInteractionSurface(message) {
+  const refused = async () => ({ ok: false, reason: "unavailable", message });
+  return {
+    isAvailable: async () => false,
+    targets: refused,
+    observe: refused,
+    act: refused,
+    screenshot: refused,
+    open: refused
+  };
+}
+function unavailableInteractionSurfaces(message) {
+  return {
+    browserPane: unavailableInteractionSurface(message),
+    desktop: unavailableInteractionSurface(message)
+  };
+}
+
 // packages/plugin-sdk/dist/kay-agent/base64.js
 var BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 function bytesToBase64(bytes) {
@@ -1257,6 +1363,17 @@ function defineTool(definition) {
 function defineAuthedTool(definition, schema, binding, body) {
   return withResolvedAuth({ ...definition, parameters: toolParameters(schema) }, binding, (toolCallId, rawParams, signal, onUpdate, ctx, resolvedAuth) => body(toolCallId, schema.parse(rawParams), signal, onUpdate, ctx, resolvedAuth));
 }
+var DELEGATED_REFRESH_REJECTED = Symbol.for("kay.plugin-sdk.delegated-refresh-rejected");
+var DelegatedRefreshRejectedError = class extends Error {
+  [DELEGATED_REFRESH_REJECTED] = true;
+  constructor(message, options) {
+    super(message, options);
+    this.name = "DelegatedRefreshRejectedError";
+  }
+};
+function isDelegatedRefreshRejected(error) {
+  return typeof error === "object" && error !== null && error[DELEGATED_REFRESH_REJECTED] === true;
+}
 var KayAgentFilesystemError = class extends Error {
   code;
   constructor(code, message) {
@@ -1265,6 +1382,7 @@ var KayAgentFilesystemError = class extends Error {
     this.code = code;
   }
 };
+var KAY_FAMILY_WHITEBOARD_FILESYSTEM_ROOT = "family-whiteboard";
 var KayAgentCapabilityError = class extends Error {
   refusal;
   constructor(refusal, message) {
@@ -1284,6 +1402,10 @@ var KayAgentWebSessionError = class extends Error {
   }
 };
 export {
+  DelegatedRefreshRejectedError,
+  INTERACTION_CREDENTIAL_GUARD,
+  JevCallError,
+  KAY_FAMILY_WHITEBOARD_FILESYSTEM_ROOT,
   KayAgentCapabilityError,
   KayAgentFilesystemError,
   KayAgentWebSessionError,
@@ -1309,6 +1431,7 @@ export {
   contentResult,
   createFallbackOnlyWithJev,
   createJsonApiClient,
+  declareProducedResources,
   defineAuthedTool,
   defineKayAgentAdvertisement,
   defineTool,
@@ -1316,6 +1439,7 @@ export {
   formatIsoDate,
   formatNumber,
   getBytes,
+  isDelegatedRefreshRejected,
   jsonResource,
   lintUriHelpContracts,
   lintUriTemplate,
@@ -1333,6 +1457,8 @@ export {
   textResult,
   toJsonSchema,
   toolParameters,
+  unavailableInteractionSurface,
+  unavailableInteractionSurfaces,
   uriParam,
   uriTextEditPayloadSchema,
   withResolvedAuth,