@aventurevc/api-schemas 0.8.100 → 0.8.101

package/dist/harness/run-create.d.ts

@@ -1,12 +1,12 @@
 import { z } from "zod/v4";
 declare const HarnessRunCreateSchemaDefinition: z.ZodObject<{
     finding: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<{
-        gateId: string;
+        gateId?: string | null | undefined;
         quote: string;
         sourceUrl: string;
         statement: string;
     }, unknown, z.core.$ZodTypeInternals<{
-        gateId: string;
+        gateId?: string | null | undefined;
         quote: string;
         sourceUrl: string;
         statement: string;

package/dist/http/route.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The one method-plus-path matching rule for aVenture API operations. The MCP server resolves an
+ * `aventure_*` call that names a method and path with it, and `operation/route` answers the same
+ * question for callers that only hold that method and path.
+ *
+ * @shared primitive:multi route matching for MCP and its consumers; not generated from OpenAPI
+ * @contractShape http.route
+ * @contractRole canonical
+ * @ownerModule http/route.ts
+ */
+/** The path a request names, without its query string or fragment. */
+export declare function pathWithoutQuery(path: string): string;
+/**
+ * A concrete request path matches a template when both have the same segment count and each
+ * template segment is either the same literal or one `{name}` parameter. A path that still carries
+ * a raw or percent-encoded `{name}` segment matches nothing, because it never filled the parameter.
+ */
+export declare function routeTemplateMatches(template: string, path: string): boolean;
+//# sourceMappingURL=route.d.ts.map

package/dist/http/route.js

@@ -0,0 +1,52 @@
+// Generated alternate api-schemas support copy from TypeScript source api-schemas/http/route.ts
+/**
+ * The one method-plus-path matching rule for aVenture API operations. The MCP server resolves an
+ * `aventure_*` call that names a method and path with it, and `operation/route` answers the same
+ * question for callers that only hold that method and path.
+ *
+ * @shared primitive:multi route matching for MCP and its consumers; not generated from OpenAPI
+ * @contractShape http.route
+ * @contractRole canonical
+ * @ownerModule http/route.ts
+ */
+/** The path a request names, without its query string or fragment. */
+export function pathWithoutQuery(path) {
+    return new URL(path, "https://placeholder.invalid").pathname;
+}
+/**
+ * A concrete request path matches a template when both have the same segment count and each
+ * template segment is either the same literal or one `{name}` parameter. A path that still carries
+ * a raw or percent-encoded `{name}` segment matches nothing, because it never filled the parameter.
+ */
+export function routeTemplateMatches(template, path) {
+    const templateParts = template.split("/").filter(Boolean);
+    const pathParts = path.split("/").filter(Boolean);
+    if (templateParts.length !== pathParts.length)
+        return false;
+    if (pathParts.some(isUnresolvedTemplateSegment))
+        return false;
+    return templateParts.every((templatePart, index) => isOpenApiTemplateSegment(templatePart) || templatePart === pathParts[index]);
+}
+function isOpenApiTemplateSegment(pathSegment) {
+    const innerSegment = pathSegment.slice(1, -1);
+    return (pathSegment.startsWith("{") &&
+        pathSegment.endsWith("}") &&
+        innerSegment.length > 0 &&
+        !innerSegment.includes("/") &&
+        !innerSegment.includes("{") &&
+        !innerSegment.includes("}"));
+}
+function isUnresolvedTemplateSegment(pathSegment) {
+    if (isOpenApiTemplateSegment(pathSegment))
+        return true;
+    const lowerSegment = pathSegment.toLowerCase();
+    const innerSegment = pathSegment.slice(3, -3);
+    return (lowerSegment.startsWith("%7b") &&
+        lowerSegment.endsWith("%7d") &&
+        innerSegment.length > 0 &&
+        !innerSegment.includes("/") &&
+        !innerSegment.includes("%") &&
+        !innerSegment.includes("{") &&
+        !innerSegment.includes("}"));
+}
+//# sourceMappingURL=route.js.map

package/dist/research/finding.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 declare const ResearchFindingSchemaDefinition: z.ZodObject<{
-    gateId: z.ZodString;
+    gateId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     quote: z.ZodString;
     sourceUrl: z.ZodString;
     statement: z.ZodString;

package/dist/research/finding.js

@@ -1,9 +1,9 @@
 // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
 import { z } from "zod/v4";
 const ResearchFindingSchemaDefinition = z.object({
-    /** Completion gate id the fact fills, from the completion contract. */
-    gateId: z.string(),
-    /** The exact text on sourceUrl that supports the fact, copied verbatim. */
+    /** Completion gate the fact fills, when known; omit it and the run picks the field the fact belongs to. */
+    gateId: z.string().nullish(),
+    /** The exact text on sourceUrl that states the fact, copied verbatim; a fragment short enough to appear on any page is refused. */
     quote: z.string(),
     /** Absolute http or https URL of the page that supports the fact; aVenture pages are refused. */
     sourceUrl: z.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aventurevc/api-schemas",
-  "version": "0.8.100",
+  "version": "0.8.101",
   "private": false,
   "description": "Zod v4 schemas and TypeScript types for the aVenture API.",
   "license": "Apache-2.0",