Skip to content

Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥

Accept optional versions on Alexandria calls (#4703)

Developers Digest9348044e44ce
diff --git a/apps/api/src/services/alexandria/contracts.test.ts b/apps/api/src/services/alexandria/contracts.test.ts
new file mode 100644
index 000000000..cd1c53ea9
--- /dev/null
+++ b/apps/api/src/services/alexandria/contracts.test.ts
@@ -0,0 +1,27 @@
+import { callSchema } from "./contracts";
+
+const call = { provider: "example", capability: "search", options: {} };
+it("keeps version optional and accepts exact releases", () => {
+ expect(callSchema.parse(call)).toEqual(call);
+ expect(callSchema.parse({ ...call, version: "1.2.3" }).version).toBe("1.2.3");
+});
+it.each([
+ "",
+ "latest",
+ "^1.0.0",
+ 123,
+ null,
+ "01.2.3",
+ "1.2.3-alpha..1",
+ "1.2.3-01",
+ "1.2.3+build..7",
+])("rejects invalid version %s", version => {
+ expect(callSchema.safeParse({ ...call, version }).success).toBe(false);
+});
+
+it.each(["0.0.0", "1.2.3-rc.1+build.7", "1.2.3+001", "1.2.3-0", "1.2.3-01a"])(
+ "accepts exact SemVer %s",
+ version => {
+ expect(callSchema.parse({ ...call, version }).version).toBe(version);
+ },
+);
diff --git a/apps/api/src/services/alexandria/contracts.ts b/apps/api/src/services/alexandria/contracts.ts
index 33757a5ee..58a6fcf3d 100644
--- a/apps/api/src/services/alexandria/contracts.ts
+++ b/apps/api/src/services/alexandria/contracts.ts
@@ -3,6 +3,14 @@ import { z } from "zod";
export const callSchema = z.strictObject({
provider: z.string().min(1).max(200),
capability: z.string().min(1).max(200),
+ version: z
+ .string()
+ .min(1)
+ .max(128)
+ .regex(
+ /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/,
+ )
+ .optional(),
options: z.record(z.string(), z.unknown()).default({}),
});
export const callsSchema = z.array(callSchema).min(1).max(10);
diff --git a/apps/api/src/services/alexandria/retrieve.test.ts b/apps/api/src/services/alexandria/retrieve.test.ts
index 7e4858773..e25c69b5a 100644
--- a/apps/api/src/services/alexandria/retrieve.test.ts
+++ b/apps/api/src/services/alexandria/retrieve.test.ts
@@ -372,3 +372,15 @@ it.each([123, null, false, {}, []])(
expect(executions()[0][0].resultAuthorization).toBeUndefined();
},
);
+
+it("forwards an optional version to quote and execution", async () => {
+ const pinned = { ...call, version: "1.2.3" };
+ await run({ calls: [pinned] });
+ const forwarded = mocks.request.mock.calls.filter(
+ ([r]) => r.path.endsWith("/quote") || r.path === "/v1/retrieve",
+ );
+ expect(forwarded).toHaveLength(2);
+ for (const [request] of forwarded) {
+ expect(request.body.requests).toEqual([pinned]);
+ }
+});