@raybase/core 0.0.1 → 0.3.3

package/dist/json-schema.d.ts

@@ -0,0 +1,91 @@
+import { z } from "zod";
+export type JsonSchemaObject = {
+    type?: string;
+    properties?: Record<string, JsonSchemaObject>;
+    required?: string[];
+    additionalProperties?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+    enum?: unknown[];
+    items?: JsonSchemaObject;
+    minItems?: number;
+    maxItems?: number;
+    [key: string]: unknown;
+};
+export type RaybaseSchemaLike<T = unknown> = z.ZodType<T> | JsonSchemaObject;
+export type JsonSchemaForOptions = {
+    /**
+     * How repeated Zod schema instances are represented within this schema root.
+     * References are local to the returned schema; the original Zod schema stays
+     * authoritative for validation.
+     */
+    reused?: "inline" | "ref";
+};
+export declare function isZodSchema<T>(schema: RaybaseSchemaLike<T>): schema is z.ZodType<T>;
+export declare function jsonSchemaFor(schema: RaybaseSchemaLike, options?: JsonSchemaForOptions): JsonSchemaObject;
+export declare function parseWithSchema<T>(schema: RaybaseSchemaLike<T>, value: unknown, path: string): T;
+export declare function validateJsonSchema(schema: JsonSchemaObject, value: unknown, path: string): unknown;
+/**
+ * The strict-subset form of a schema, for publishing to a model.
+ *
+ * Providers in the OpenAI family validate every tool's `parameters` against a
+ * narrow subset and fail the entire request when one tool falls outside it —
+ * so an app whose schemas are ordinary, valid JSON Schema gets no reply at all,
+ * and nothing says which tool was at fault. This makes the published form
+ * conform without touching what the action validates with.
+ *
+ * Objects are closed. Property *requiredness* is left exactly as it was: an
+ * optional property could only be made strict by declaring a null union, and a
+ * schema derived from `.optional()` without `.nullable()` would then invite a
+ * `null` its own validator rejects. Where that matters, an action declares its
+ * tool schema itself.
+ *
+ * A reused or recursive subschema arrives as a root-relative `$ref` into
+ * `$defs`, and the reference is what gets published — that is the point of it.
+ * But every judgment about a child's *shape* — whether it permits null, whether
+ * it constrains anything — resolves the reference first, because a nullable
+ * shape lifted into `$defs` is otherwise read as one that refuses null and the
+ * property stays optional in a schema that must have none. `root` is the
+ * document those references point into; it defaults to the schema itself, which
+ * is right for every call that starts at a root.
+ */
+export declare function strictJsonSchema(schema: JsonSchemaObject, root?: JsonSchemaObject): JsonSchemaObject;
+/**
+ * The strict form of a *tool's* `parameters`, which has one rule beyond the
+ * rest: the root must be a single object. A discriminated union — the natural
+ * way to write an action that takes several shapes — publishes `anyOf` at the
+ * root, which is ordinary valid JSON Schema and refused outright, taking every
+ * other tool in the request down with it.
+ *
+ * So a union root is merged into one object: every branch's properties, each
+ * nullable because it belongs to only some branches, and the discriminator's
+ * enums unioned so the model still sees which values pair with which shape.
+ * This widens only what is *published*. The action still validates with its own
+ * union, so a call mixing two branches is refused by `parseWithSchema` with a
+ * real message rather than by the provider with none.
+ */
+export declare function strictToolParameters(schema: JsonSchemaObject): JsonSchemaObject;
+/**
+ * The wire form of a tool's parameters or a structured response schema: the
+ * advertised strict subset, plus the two rewrites that need
+ * `restoreStrictModelValue` on the way back.
+ *
+ * Applying it twice changes nothing — a padded property already permits null,
+ * and an encoded record is a string rather than a record — so a schema that has
+ * already been through `strictToolParameters` may pass through here safely.
+ */
+export declare function strictModelSchema(schema: JsonSchemaObject): JsonSchemaObject;
+/**
+ * The inverse of `strictModelSchema`, run against the schema as it was *before*
+ * the wire form: null padding is stripped where the original left the property
+ * optional, JSON-encoded records are parsed back into objects, and a union is
+ * followed into the branch the value actually took so the same is done inside
+ * it.
+ *
+ * A value that was never padded passes through unchanged, so running this over
+ * arguments from a provider that needed none is safe.
+ */
+export declare function restoreStrictModelValue(value: unknown, schema: JsonSchemaObject | undefined): unknown;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../src/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC;AAE7E,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;CAC3B,CAAC;AAEF,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAEnF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,GAAE,oBAAyB,GAAG,gBAAgB,CAG7G;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAGhG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAiDlG;AAoBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,GAAE,gBAAyB,GAAG,gBAAgB,CA0F5G;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAO/E;AAqcD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAE5E;AAqCD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAErG"}