@yaklabs-ai/plugin-sdk 0.13.4 → 0.13.6

package/dist/kay-agent.js

@@ -1,3 +1,197 @@
+// packages/herd-uri/dist/claims.js
+var SCHEME_RE = /^([a-z][a-z0-9+.-]*):\/\//i;
+var CAPTURE_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+var REST_CAPTURE_RE = /^:([A-Za-z_][A-Za-z0-9_]*)\*$/;
+var CONSTRAINED_CAPTURE_RE = /^([A-Za-z_][A-Za-z0-9_]*)(?:\((.*)\))?$/;
+var MAX_CAPTURE_CONSTRAINT_LENGTH = 64;
+function compileUriClaim(claim) {
+  if (claim.kind === "scheme") {
+    const scheme = normalizeProtocol(claim.scheme);
+    return {
+      claim,
+      match(input) {
+        const actual = SCHEME_RE.exec(input.trim())?.[1]?.toLowerCase();
+        if (actual !== scheme)
+          return void 0;
+        return { claimKind: claim.kind };
+      }
+    };
+  }
+  const pattern = compileRoutePattern(claim.pattern);
+  return {
+    claim,
+    match(input) {
+      const parsed = parsePatternInput(input);
+      if (parsed === void 0)
+        return void 0;
+      const captures = matchRoute(pattern, parsed);
+      if (captures === void 0)
+        return void 0;
+      return {
+        claimKind: claim.kind,
+        ...Object.keys(captures).length > 0 ? { captures } : {},
+        ...claim.normalizeTo !== void 0 ? {
+          normalizedUri: withInputSearch(claim, pattern, parsed, interpolateNormalizeTo(claim.normalizeTo, captures, pattern.restCaptures ?? []))
+        } : {}
+      };
+    }
+  };
+}
+function normalizeProtocol(value) {
+  return value.replace(/:$/, "").toLowerCase();
+}
+function parsePatternInput(input) {
+  try {
+    const url = new URL(input.trim());
+    return {
+      protocol: normalizeProtocol(url.protocol),
+      hostname: url.hostname.toLowerCase(),
+      pathname: url.pathname,
+      search: url.search.startsWith("?") ? url.search.slice(1) : url.search
+    };
+  } catch {
+    return void 0;
+  }
+}
+function compileRoutePattern(pattern) {
+  const pathname = pattern.pathname !== void 0 ? compileParts(pattern.pathname, "/", { allowRest: true }) : void 0;
+  return {
+    ...pattern.protocol !== void 0 ? { protocol: normalizeProtocol(pattern.protocol) } : {},
+    ...pattern.hostname !== void 0 ? { hostname: compileParts(pattern.hostname.toLowerCase(), ".") } : {},
+    ...pathname !== void 0 ? { pathname } : {},
+    ...pathname !== void 0 ? {
+      restCaptures: pathname.filter((part) => part.rest === true).map((part) => part.capture)
+    } : {},
+    ...pattern.search !== void 0 ? { search: compileParts(pattern.search.replace(/^\?/, ""), "&") } : {}
+  };
+}
+function compileParts(value, separator, options = {}) {
+  if (value === "")
+    return [];
+  const parts = value.split(separator);
+  return parts.map((part, index) => {
+    const restMatch = REST_CAPTURE_RE.exec(part);
+    if (restMatch !== null) {
+      if (options.allowRest !== true || index !== parts.length - 1) {
+        throw new Error("URI claim rest captures must be final pathname segments.");
+      }
+      return { capture: restMatch[1], rest: true };
+    }
+    if (part.startsWith(":")) {
+      const rawCapture = part.slice(1);
+      const match = CONSTRAINED_CAPTURE_RE.exec(rawCapture);
+      if (match === null) {
+        throw new Error(`Invalid URI claim capture ':${rawCapture}'.`);
+      }
+      const capture = match[1];
+      if (!CAPTURE_RE.test(capture)) {
+        throw new Error(`Invalid URI claim capture ':${rawCapture}'.`);
+      }
+      const constraint = match[2];
+      if (constraint !== void 0)
+        assertSupportedConstraint(constraint);
+      return {
+        capture,
+        ...constraint !== void 0 ? { constraint: new RegExp(`^(?:${constraint})$`) } : {}
+      };
+    }
+    return { literal: part };
+  });
+}
+function assertSupportedConstraint(constraint) {
+  if (constraint.length > MAX_CAPTURE_CONSTRAINT_LENGTH || /[()|]/.test(constraint)) {
+    throw new Error("URI claim capture constraints must be short segment regexes without grouping or alternation.");
+  }
+}
+function matchRoute(pattern, input) {
+  if (pattern.protocol !== void 0 && pattern.protocol !== input.protocol) {
+    return void 0;
+  }
+  const captures = {};
+  if (pattern.hostname !== void 0 && !matchParts(pattern.hostname, input.hostname, ".", captures)) {
+    return void 0;
+  }
+  if (pattern.pathname !== void 0 && !matchParts(pattern.pathname, input.pathname, "/", captures)) {
+    return void 0;
+  }
+  if (pattern.search !== void 0 && !matchParts(pattern.search, input.search, "&", captures)) {
+    return void 0;
+  }
+  return captures;
+}
+function matchParts(pattern, value, separator, captures) {
+  const parts = value.split(separator);
+  let partIndex = 0;
+  for (let i = 0; i < pattern.length; i += 1) {
+    const expected = pattern[i];
+    if (expected.rest === true) {
+      const remaining = parts.slice(partIndex);
+      if (remaining.every((part) => part === ""))
+        return false;
+      captures[expected.capture] = remaining.join(separator);
+      return true;
+    }
+    if (partIndex >= parts.length)
+      return false;
+    const actual = parts[partIndex];
+    if (expected.capture !== void 0) {
+      const decoded = safeDecode(actual);
+      if (expected.constraint !== void 0 && !expected.constraint.test(decoded)) {
+        return false;
+      }
+      captures[expected.capture] = decoded;
+      partIndex += 1;
+      continue;
+    }
+    if (expected.literal !== actual)
+      return false;
+    partIndex += 1;
+  }
+  return partIndex === parts.length;
+}
+function safeDecode(value) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+function withInputSearch(claim, pattern, input, normalized) {
+  if (claim.kind !== "uriPattern" || claim.normalizeTo === void 0 || pattern.search !== void 0 || input.search.length === 0 || claim.normalizeTo.includes("?") || templateProtocol(claim.normalizeTo) !== input.protocol) {
+    return normalized;
+  }
+  return `${normalized}?${input.search}`;
+}
+function templateProtocol(template) {
+  return SCHEME_RE.exec(template)?.[1]?.toLowerCase();
+}
+function interpolateNormalizeTo(template, captures, restCaptures) {
+  return template.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (full, name, offset) => {
+    const value = captures[name];
+    if (value === void 0)
+      return full;
+    return encodeCaptureValue({
+      template,
+      offset,
+      value,
+      rest: restCaptures.includes(name)
+    });
+  });
+}
+function encodeCaptureValue({ template, offset, value, rest }) {
+  const normalized = isAuthorityCapture(template, offset) ? value.toLowerCase() : value;
+  if (!rest)
+    return encodeURIComponent(normalized);
+  return normalized.split("/").join("/");
+}
+function isAuthorityCapture(template, offset) {
+  const prefix = template.slice(0, offset);
+  const schemeIndex = prefix.lastIndexOf("://");
+  if (schemeIndex === -1)
+    return false;
+  return !/[/?#]/.test(prefix.slice(schemeIndex + 3));
+}
+
 // packages/herd-uri/dist/errors.js
 var UriError = class extends Error {
 };
@@ -32,6 +226,8 @@ var UriProviderError = class extends UriError {
   retryable;
   /** Provider-directed delay before retrying, in milliseconds. */
   retryAfterMs;
+  /** See {@link UriProviderErrorOptions.effect}. */
+  effect;
   constructor(options) {
     super(options.message);
     this.name = "UriProviderError";
@@ -50,6 +246,8 @@ var UriProviderError = class extends UriError {
       }
       this.retryAfterMs = options.retryAfterMs;
     }
+    if (options.effect !== void 0)
+      this.effect = options.effect;
   }
 };
 var UriNotFoundError = class extends UriError {
@@ -138,10 +336,10 @@ function isProducedResourceDeclaration(value) {
 // packages/herd-uri/dist/template-route.js
 var PLACEHOLDER_RE = /<([^<>]+)>/g;
 var REST_SUFFIX = "...";
-var SCHEME_RE = /^([a-zA-Z][a-zA-Z0-9+.-]*):(?:\/\/)?(.*)$/s;
+var SCHEME_RE2 = /^([a-zA-Z][a-zA-Z0-9+.-]*):(?:\/\/)?(.*)$/s;
 function parseRoute(address) {
   const trimmed = address.trim();
-  const match = SCHEME_RE.exec(trimmed);
+  const match = SCHEME_RE2.exec(trimmed);
   const scheme = match?.[1]?.toLowerCase() ?? "";
   const rest = match?.[2] ?? trimmed;
   const [rawPath = "", rawQuery] = splitQuery(rest);
@@ -784,7 +982,79 @@ function observationFromResource(resource) {
   return value;
 }
 
-// packages/herd-agent/dist/core/extensions/auth/scheme.js
+// packages/plugin-primitives/dist/results.js
+function textResult(text, details) {
+  const content = [{ type: "text", text }];
+  return { content, details };
+}
+function contentResult(content, details) {
+  return { content: [...content], details };
+}
+
+// packages/plugin-primitives/dist/transfer.js
+var MAX_BYTES2 = 50 * 1024 * 1024;
+async function readBodyWithByteCap(response, maxBytes) {
+  const reader = response.body?.getReader();
+  if (!reader)
+    return void 0;
+  const chunks = [];
+  let totalSize = 0;
+  let capped = false;
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done)
+      break;
+    if (value) {
+      chunks.push(value);
+      totalSize += value.length;
+      if (totalSize > maxBytes) {
+        capped = true;
+        await reader.cancel();
+        break;
+      }
+    }
+  }
+  const bodyBuffer = Buffer.concat(chunks);
+  const bytes = new Uint8Array(bodyBuffer.buffer, bodyBuffer.byteOffset, bodyBuffer.byteLength);
+  return { bytes, capped };
+}
+
+// packages/plugin-primitives/dist/tool-parameters.js
+import { z as z5 } from "zod";
+var URI_PAYLOAD_MARKER = "x-kay-uri-payload";
+var URI_PAYLOAD_WIRE_TYPES = [
+  "string",
+  "object",
+  "array",
+  "number",
+  "boolean",
+  "null"
+];
+var uriPayloadSchema = z5.union([
+  z5.string(),
+  z5.record(z5.string(), z5.unknown()),
+  z5.array(z5.unknown()),
+  z5.number(),
+  z5.boolean(),
+  z5.null()
+]).meta({ [URI_PAYLOAD_MARKER]: true });
+function toToolParameters(schema) {
+  const jsonSchema = z5.toJSONSchema(schema, {
+    io: "input",
+    override(ctx) {
+      const node = ctx.jsonSchema;
+      if (node[URI_PAYLOAD_MARKER] === true) {
+        delete node[URI_PAYLOAD_MARKER];
+        delete node["anyOf"];
+        node["type"] = [...URI_PAYLOAD_WIRE_TYPES];
+      }
+    }
+  });
+  const { $schema: _schema, $id: _id, ...rest } = jsonSchema;
+  return rest;
+}
+
+// packages/plugin-primitives/dist/auth-scheme.js
 var ACCOUNT_ID_PARAM = "accountId";
 function authContextOf(ctx) {
   return ctx.auth;
@@ -845,7 +1115,7 @@ function withResolvedAuth(definition, binding, body) {
   };
 }
 
-// packages/herd-agent/dist/core/web/search/types.js
+// packages/plugin-primitives/dist/search-provider.js
 var SearchProviderError = class extends Error {
   provider;
   status;
@@ -856,8 +1126,6 @@ var SearchProviderError = class extends Error {
     this.name = "SearchProviderError";
   }
 };
-
-// packages/herd-agent/dist/core/web/search/with-resolved-search-provider.js
 function withResolvedSearchProvider(definition, binding, body) {
   return {
     id: definition.id,
@@ -885,47 +1153,12 @@ function withResolvedSearchProvider(definition, binding, body) {
   };
 }
 
-// packages/herd-agent/dist/core/tools/tool-parameters.js
-import { z as z5 } from "zod";
-var URI_PAYLOAD_MARKER = "x-kay-uri-payload";
-var URI_PAYLOAD_WIRE_TYPES = [
-  "string",
-  "object",
-  "array",
-  "number",
-  "boolean",
-  "null"
-];
-var uriPayloadSchema = z5.union([
-  z5.string(),
-  z5.record(z5.string(), z5.unknown()),
-  z5.array(z5.unknown()),
-  z5.number(),
-  z5.boolean(),
-  z5.null()
-]).meta({ [URI_PAYLOAD_MARKER]: true });
-function toToolParameters(schema) {
-  const jsonSchema = z5.toJSONSchema(schema, {
-    io: "input",
-    override(ctx) {
-      const node = ctx.jsonSchema;
-      if (node[URI_PAYLOAD_MARKER] === true) {
-        delete node[URI_PAYLOAD_MARKER];
-        delete node["anyOf"];
-        node["type"] = [...URI_PAYLOAD_WIRE_TYPES];
-      }
-    }
-  });
-  const { $schema: _schema, $id: _id, ...rest } = jsonSchema;
-  return rest;
-}
-
-// packages/herd-agent/dist/core/is-object.js
+// packages/plugin-primitives/dist/is-object.js
 function isObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
-// packages/herd-agent/dist/core/tools/produced-resources.js
+// packages/plugin-primitives/dist/produced-resources.js
 var DECLARATIONS = Symbol.for("herd.producedResources.declarations");
 function declareProducedResources(result, declarations) {
   const details = declarableDetails(result.details);
@@ -973,43 +1206,6 @@ function jsonValue(value) {
   return `<${Array.isArray(value) ? "array" : typeof value}>`;
 }
 
-// packages/plugin-primitives/dist/results.js
-function textResult(text, details) {
-  const content = [{ type: "text", text }];
-  return { content, details };
-}
-function contentResult(content, details) {
-  return { content: [...content], details };
-}
-
-// packages/plugin-primitives/dist/transfer.js
-var MAX_BYTES2 = 50 * 1024 * 1024;
-async function readBodyWithByteCap(response, maxBytes) {
-  const reader = response.body?.getReader();
-  if (!reader)
-    return void 0;
-  const chunks = [];
-  let totalSize = 0;
-  let capped = false;
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done)
-      break;
-    if (value) {
-      chunks.push(value);
-      totalSize += value.length;
-      if (totalSize > maxBytes) {
-        capped = true;
-        await reader.cancel();
-        break;
-      }
-    }
-  }
-  const bodyBuffer = Buffer.concat(chunks);
-  const bytes = new Uint8Array(bodyBuffer.buffer, bodyBuffer.byteOffset, bodyBuffer.byteLength);
-  return { bytes, capped };
-}
-
 // packages/plugin-sdk/dist/kay-agent/index.js
 import { z as z7 } from "zod";
 
@@ -1575,6 +1771,7 @@ export {
   bytesToBase64,
   capability,
   collectKayAgentAdvertisement,
+  compileUriClaim,
   contentDigest,
   contentResult,
   createFallbackOnlyWithJev,