@yaklabs-ai/plugin-sdk 0.13.5 → 0.13.7

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 {
 };
@@ -142,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);
@@ -1577,6 +1771,7 @@ export {
   bytesToBase64,
   capability,
   collectKayAgentAdvertisement,
+  compileUriClaim,
   contentDigest,
   contentResult,
   createFallbackOnlyWithJev,

package/dist/kay-app.d.ts

@@ -61,7 +61,7 @@ declare function AddReadonlyDeferred<Type extends TSchema>(type: Type, options?:
 declare type AgentMessage = Message | CustomAgentMessages[keyof CustomAgentMessages];
 
 /** Final or partial result produced by a tool. */
-export declare interface AgentToolResult<T = JsonValue | undefined> {
+export declare interface AgentToolResult<T = JsonValue_2 | undefined> {
     /** Text or image content returned to the model. */
     content: (TextContent | ImageContent)[];
     /** Arbitrary structured details for logs or UI rendering. */
@@ -70,7 +70,7 @@ export declare interface AgentToolResult<T = JsonValue | undefined> {
      * Machine-readable result matching the tool's `outputSchema`, for programmatic callers. Not sent
      * to the model; `content` remains the model-facing result.
      */
-    structuredContent?: JsonValue;
+    structuredContent?: JsonValue_2;
     /** Usage from the final tool execution itself, if available. Not used for main LLM context accounting. */
     usage?: Usage;
     /**
@@ -421,7 +421,7 @@ declare interface BranchSummaryEntry extends EntryBase {
     type: "branch_summary";
     fromId: string | null;
     summary: string;
-    details?: JsonValue;
+    details?: JsonValue_2;
     usage?: Usage;
     fromHook: boolean;
 }
@@ -511,7 +511,7 @@ declare interface CompactionEntry extends EntryBase {
     summary: string;
     retainedTail: AgentMessage[];
     tokensBefore: number;
-    details?: JsonValue;
+    details?: JsonValue_2;
     usage?: Usage;
     fromHook: boolean;
 }
@@ -756,7 +756,7 @@ declare interface CustomAgentMessages {
 declare interface CustomEntry extends EntryBase {
     type: "custom";
     customType: string;
-    data?: JsonValue;
+    data?: JsonValue_2;
 }
 
 declare interface CustomMessage<T = unknown> {
@@ -831,7 +831,7 @@ declare interface DeferredHandle {
     expiresAt?: number;
     pollAfterMs?: number;
     /** Provider conversion data required to reconstruct the final assistant message. */
-    data?: JsonValue_3;
+    data?: JsonValue_4;
 }
 
 /** Creates a Dependent type */
@@ -1420,7 +1420,7 @@ declare function IsEnum(value: unknown): value is TEnum;
 /** Returns true if the given value is a EnumValue */
 declare function IsEnumValue(value: unknown): value is TEnumValue;
 
-declare type IsExactlyJsonValue<T> = [T] extends [JsonValue_3] ? ([JsonValue_3] extends [T] ? true : false) : false;
+declare type IsExactlyJsonValue<T> = [T] extends [JsonValue_4] ? ([JsonValue_4] extends [T] ? true : false) : false;
 
 declare function IsExtendsFalse(value: unknown): value is TExtendsFalse;
 
@@ -1719,39 +1719,39 @@ export declare type JevState = object;
 export declare type JevTransport = "direct" | "hosted";
 
 declare type JsonObject = {
-    [key: string]: JsonValue_3;
+    [key: string]: JsonValue_4;
 };
 
 declare type JsonPrimitive = string | number | boolean | null;
 
 /** The JSON representation of a typed in-memory value. Optional object properties remain optional. */
-declare type JsonRepresentation<T> = IsAny_2<T> extends true ? JsonValue_3 : unknown extends T ? JsonValue_3 : [T] extends [JsonValue_3] ? T : T extends readonly unknown[] ? {
+declare type JsonRepresentation<T> = IsAny_2<T> extends true ? JsonValue_4 : unknown extends T ? JsonValue_4 : [T] extends [JsonValue_4] ? T : T extends readonly unknown[] ? {
     [TKey in keyof T]: JsonRepresentation<Exclude<T[TKey], undefined>>;
 } : T extends object ? {
     [TKey in keyof T]: JsonRepresentation<Exclude<T[TKey], undefined>>;
 } : never;
 
-declare type JsonSchema = Record<string, unknown>;
+export declare const JsonSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
 
-declare const JsonSchema_2: z.ZodRecord<z.ZodString, z.ZodType<JsonValue_4, unknown, z.core.$ZodTypeInternals<JsonValue_4, unknown>>>;
+export declare type JsonSchema = z.infer<typeof JsonSchema>;
 
-declare type JsonSchema_2 = z.infer<typeof JsonSchema_2>;
+declare type JsonSchema_2 = Record<string, unknown>;
 
-declare type JsonValue = null | boolean | number | string | JsonValue[] | {
+export declare type JsonValue = string | number | boolean | null | JsonValue[] | {
     [key: string]: JsonValue;
 };
 
-declare type JsonValue_2 = JsonPrimitive | {
-    readonly [key: string]: JsonValue_2;
-} | readonly JsonValue_2[];
-
-declare type JsonValue_3 = null | boolean | number | string | readonly JsonValue_3[] | JsonObject;
+export declare const JsonValue: z.ZodType<JsonValue>;
 
-declare type JsonValue_4 = string | number | boolean | null | JsonValue_4[] | {
-    [key: string]: JsonValue_4;
+declare type JsonValue_2 = null | boolean | number | string | JsonValue_2[] | {
+    [key: string]: JsonValue_2;
 };
 
-declare const JsonValue_4: z.ZodType<JsonValue_4>;
+declare type JsonValue_3 = JsonPrimitive | {
+    readonly [key: string]: JsonValue_3;
+} | readonly JsonValue_3[];
+
+declare type JsonValue_4 = null | boolean | number | string | readonly JsonValue_4[] | JsonObject;
 
 /**
  * Every condition kind an automation can be created with, as runtime data.
@@ -1773,6 +1773,9 @@ export declare const KAY_APP_AUTOMATION_CONDITION_KINDS: readonly ["time", "uri-
 /** Maximum UTF-8 JSON size of one plugin app-data live change. */
 export declare const KAY_APP_DATA_CHANGE_MAX_BYTES: number;
 
+/** Maximum UTF-8 JSON size of one plugin app-data snapshot. */
+export declare const KAY_APP_DATA_SNAPSHOT_MAX_BYTES: number;
+
 declare interface KayAgentWhiteboardCreateInput {
     readonly name: string;
     readonly title: string;
@@ -2135,7 +2138,7 @@ export declare interface KayAppAgentDefinitionConfig {
 /** A plugin-authored definition's structured-output contract (the wire's final-output shape). */
 export declare interface KayAppAgentDefinitionFinalOutput {
     /** JSON Schema for the structured value a matching turn submits. */
-    readonly schema: JsonSchema_2;
+    readonly schema: JsonSchema;
     readonly required?: boolean | "per-run";
     readonly sessionTitle?: boolean;
     readonly whenToSubmit?: string;
@@ -2435,7 +2438,7 @@ export declare type KayAppAutomationEffect = {
     /** As STORED: always a reference, never inline source. */
     readonly kind: "script";
     readonly ref: KayAppAutomationScriptRef;
-    readonly initialState?: JsonValue_4;
+    readonly initialState?: JsonValue;
 } | {
     readonly kind: "deliver-turn";
     readonly target: {
@@ -2467,7 +2470,7 @@ export declare type KayAppAutomationEffectInput = {
      * and stores a reference to that file. Pass this OR `ref`, never both.
      */
     readonly source?: string;
-    readonly initialState?: JsonValue_4;
+    readonly initialState?: JsonValue;
 };
 
 /**
@@ -2639,11 +2642,15 @@ export declare type KayAppAutomationRunOutcome = {
         /** `sha256:<hex>` over the bytes the run resolved and pinned. */
         readonly sourceDigest?: string | undefined;
     } | undefined;
+    /** How many tries the run's effect took, when more than one. */
+    readonly tries?: number | undefined;
 } | {
     readonly status: "failed";
     readonly summary?: KayAppRunSummary | undefined;
     readonly reason: "executor_failed" | "permission_denied" | "surface_unavailable" | "target_gone";
     readonly message?: string | undefined;
+    /** How many tries the run's effect took, when more than one. */
+    readonly tries?: number | undefined;
 } | {
     readonly status: "skipped";
     readonly reason: "already_running" | "binding_inactive" | "circuit_breaker" | "concurrency_capped" | "guard_not_satisfied" | "missed_window" | "timer_cancelled";
@@ -2922,7 +2929,7 @@ export declare interface KayAppConfigSnapshot {
      * The folded value of the named own section; `undefined` when the user has configured
      * nothing for it (defaults are the plugin's own concern — the fold carries only what a file set).
      */
-    readonly value: JsonValue_2 | undefined;
+    readonly value: JsonValue_3 | undefined;
     /**
      * Winner provenance for the section, when the fold recorded it (it always does for a present
      * value). Absent for an absent value. A deep section carries per-field origins so a plugin can
@@ -2937,7 +2944,7 @@ export declare interface KayAppConfigSnapshot {
  * section deep-merges (send field-only patches; a nested `null` deletes that field), anything
  * else replaces wholesale.
  */
-export declare type KayAppConfigWritePatch = Readonly<Record<string, JsonValue_2 | undefined>>;
+export declare type KayAppConfigWritePatch = Readonly<Record<string, JsonValue_3 | undefined>>;
 
 /** What a config write reports back — never the settings document itself. */
 export declare interface KayAppConfigWriteResult {
@@ -2980,7 +2987,7 @@ export declare interface KayAppCorpus {
      * longer than the page is stepped over and counted in `oversizedRecords`.
      */
     readEntryBatch?(sessionId: string, options?: {
-        readonly cursor?: JsonValue_4;
+        readonly cursor?: JsonValue;
         readonly throughEntryId?: string;
         /** Host-only cancellation for the bounded physical read. */
         readonly signal?: AbortSignal;
@@ -2996,9 +3003,9 @@ export declare interface KayAppCorpus {
 export declare interface KayAppCorpusEntryBatch {
     readonly entries: readonly TranscriptEntry[];
     /** Opaque JSON cursor after the physical page; only the host may interpret it or open its path. */
-    readonly cursor: JsonValue_4;
+    readonly cursor: JsonValue;
     /** Opaque cursor at the physical page start, for a partial logical chunk. */
-    readonly pageStartCursor?: JsonValue_4;
+    readonly pageStartCursor?: JsonValue;
     readonly mode: "replace" | "append";
     /**
      * `record-too-large`: a record longer than the page that the host could not step over, because
@@ -4302,7 +4309,7 @@ declare interface KayAppSessionRunBase {
     /** The run's final output text (the headless session's reply channel). */
     readonly output: string;
     /** Present when a structured completion was requested and the run completed. */
-    readonly result?: JsonValue_4;
+    readonly result?: JsonValue;
     readonly errorMessage?: string | undefined;
     /** Attested live host-tool roster when the caller requested one explicitly. */
     readonly activeToolNames?: readonly KayAppSessionRunHostToolName[] | undefined;
@@ -4320,7 +4327,7 @@ export declare type KayAppSessionRunCompletion = {
 } | {
     readonly kind: "structured";
     /** JSON Schema for the required value returned through `result`. */
-    readonly schema: JsonSchema_2;
+    readonly schema: JsonSchema;
 };
 
 /** Provider-neutral recorded classification; an unclassified failure omits the field. */
@@ -5202,11 +5209,9 @@ export declare interface KayAppTimeSnapshot {
     /**
      * The time zone the user is in, as an IANA id in the spelling ICU resolves (`America/New_York`).
      * One zone can have two ids, and ICU picks one: `Asia/Kolkata` comes back as `Asia/Calcutta`. So
-     * never compare zone ids with `===`. A first-party plugin compares with `sameZone` from
-     * `@bonsai/time`. A plugin that imports only this SDK and node builtins resolves each id with
-     * `new Intl.DateTimeFormat("en-US", { timeZone: id }).resolvedOptions().timeZone` and compares the
-     * results. Pass `zone` as the `timeZone` of `Intl.DateTimeFormat` or `toLocaleString` to format a
-     * time for the user.
+     * never compare zone ids with `===`: compare with `sameZone` from `@bonsai/plugin-sdk/time`. Pass
+     * `zone` as the `timeZone` of `Intl.DateTimeFormat` or `toLocaleString` to format a time for the
+     * user.
      *
      * When `zoneSource` is `utc-fallback` the zone is unknown, and this value is `UTC` only because a
      * value is required.
@@ -7055,7 +7060,7 @@ declare function PickDeferred<Type extends TSchema, Indexer extends TSchema>(typ
  * every rule it accepts, the same way it stamps the definition's identity. A plugin cannot ask for
  * durability, so it cannot be told "no" about it either.
  */
-declare const PluginAgentDefinitionPermissionRule: z.ZodObject<{
+export declare const PluginAgentDefinitionPermissionRule: z.ZodObject<{
     effect: z.ZodEnum<{
         allow: "allow";
         deny: "deny";
@@ -7073,7 +7078,7 @@ declare const PluginAgentDefinitionPermissionRule: z.ZodObject<{
     }>>;
 }, z.core.$strict>;
 
-declare type PluginAgentDefinitionPermissionRule = z.infer<typeof PluginAgentDefinitionPermissionRule>;
+export declare type PluginAgentDefinitionPermissionRule = z.infer<typeof PluginAgentDefinitionPermissionRule>;
 
 declare const Properties: (input: string) => [unknown, string] | [];
 
@@ -7132,7 +7137,7 @@ declare interface ProxiedToolCall {
     readonly input: Record<string, unknown>;
 }
 
-declare interface RawResource {
+export declare interface RawResource {
     readonly uri: string;
     readonly content: string | Uint8Array;
     readonly mimeType: string;
@@ -7392,8 +7397,8 @@ declare function ReturnTypeDeferred<Type extends TSchema>(type: Type, options?:
  * owns:
  *   - {@link RunFailureReason}.
  * does_not_own:
- *   - Classifying a failure into a reason (`@herd/herd-agent`'s
- *     `core/recovery/run-failure-reason.ts`).
+ *   - Classifying a failure into a reason (`./run-failure-classifier.ts`), or the engine's
+ *     run-error mapping and recovery policy (`@herd/herd-agent`).
  * ---
  */
 /** Provider-neutral factual category for a failed model run. */
@@ -7801,7 +7806,7 @@ declare type SamplingParams = Record<string, unknown>;
 
 declare type SamplingParamsByThinkingLevel = Partial<Record<ModelThinkingLevel, SamplingParams>>;
 
-declare type SchemaInput = z.ZodType | JsonSchema;
+declare type SchemaInput = z.ZodType | JsonSchema_2;
 
 /** One all-of arm in an ordered scope requirement. */
 declare interface ScopeAlternative {
@@ -10898,7 +10903,7 @@ declare interface ToolReference {
     name: string;
 }
 
-declare type ToolResultMessage<TDetails = JsonValue_3> = IsJsonCompatible<TDetails> extends true ? {
+declare type ToolResultMessage<TDetails = JsonValue_4> = IsJsonCompatible<TDetails> extends true ? {
     role: "toolResult";
     toolCallId: string;
     toolName: string;
@@ -12291,7 +12296,7 @@ declare interface UriExternalCliRunResult {
     readonly stderrTruncated?: boolean;
 }
 
-declare interface UriHelp {
+export declare interface UriHelp {
     readonly uri: string;
     readonly title: string;
     readonly summary: string;
@@ -12334,12 +12339,12 @@ declare interface UriListMetadata {
     readonly incompleteSearch?: boolean;
 }
 
-declare interface UriListParams {
+export declare interface UriListParams {
     readonly cursor?: string;
     readonly limit?: number;
 }
 
-declare interface UriListResult {
+export declare interface UriListResult {
     readonly uri: string;
     readonly items: readonly UriListItem[];
     readonly nextCursor?: string;
@@ -12588,7 +12593,7 @@ declare interface UriMutationReceipt {
 declare interface UriMutationResult {
     readonly uri: string;
     readonly summary?: string;
-    readonly resource?: RawResource | JsonValue_2;
+    readonly resource?: RawResource | JsonValue_3;
     readonly validation?: readonly UriValidationMessage[];
     readonly metadata?: Record<string, unknown>;
     /** Typed state/recovery evidence; successful callers may trust it without a proof read. */
@@ -12760,7 +12765,7 @@ declare interface UriParameter {
     readonly in: "uri" | "query" | "selector";
     readonly required: boolean;
     readonly description?: string;
-    readonly schema: JsonSchema;
+    readonly schema: JsonSchema_2;
     readonly examples?: readonly unknown[];
 }
 
@@ -12790,14 +12795,14 @@ declare interface UriPatternInit {
     readonly search?: string;
 }
 
-declare type UriPayload = string | JsonValue_2;
+export declare type UriPayload = string | JsonValue_3;
 
 export declare interface UriPayloadContract {
     readonly name: string;
     readonly mediaType?: string;
     readonly description?: string;
     /** Omitted when the node accepts or returns an unstructured payload. */
-    readonly schema?: JsonSchema;
+    readonly schema?: JsonSchema_2;
     /** Cross-value invariants the module enforces but plain JSON Schema cannot express. */
     readonly semanticConstraints?: readonly string[];
     readonly examples?: readonly unknown[];
@@ -13070,13 +13075,13 @@ declare interface UriSearchItem {
     readonly operations?: readonly UriOperation[];
 }
 
-declare interface UriSearchParams {
+export declare interface UriSearchParams {
     readonly query: string;
     readonly limit?: number;
     readonly cursor?: string;
 }
 
-declare interface UriSearchResult {
+export declare interface UriSearchResult {
     readonly uri: string;
     readonly query: string;
     readonly items: readonly UriSearchItem[];
@@ -13446,7 +13451,7 @@ declare const WhiteboardEntryInspection: z.ZodObject<{
     }>;
     mutable: z.ZodBoolean;
     diagnostics: z.ZodArray<z.ZodString>;
-    value: z.ZodOptional<z.ZodType<JsonValue_4, unknown, z.core.$ZodTypeInternals<JsonValue_4, unknown>>>;
+    value: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
     text: z.ZodString;
     truncated: z.ZodBoolean;
 }, z.core.$strict>;
@@ -13463,7 +13468,7 @@ export declare const WhiteboardEntrySnapshot: z.ZodObject<{
         authorSessionId: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
     revision: z.ZodString;
-    value: z.ZodType<JsonValue_4, unknown, z.core.$ZodTypeInternals<JsonValue_4, unknown>>;
+    value: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
 }, z.core.$strict>;
 
 export declare type WhiteboardEntrySnapshot = Readonly<Omit<z.infer<typeof WhiteboardEntrySnapshot>, "entry"> & {
@@ -13499,7 +13504,7 @@ export declare const WhiteboardTypeInfo: z.ZodObject<{
 export declare type WhiteboardTypeInfo = Readonly<z.infer<typeof WhiteboardTypeInfo>>;
 
 /** The logical plugin-defined JSON payload stored inside a host-owned entry envelope. */
-export declare const WhiteboardValue: z.ZodType<JsonValue_4, unknown, z.core.$ZodTypeInternals<JsonValue_4, unknown>>;
+export declare const WhiteboardValue: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
 
 export declare type WhiteboardValue = z.infer<typeof WhiteboardValue>;