structured-outputs 0.1.0-beta.2 → 0.1.0-beta.21

package/esm/types/constantUnion.js

@@ -0,0 +1,25 @@
+import { partition } from "../deps/jsr.io/@std/collections/1.0.9/mod.js";
+import { Ty } from "./Ty.js";
+export function constantUnion(...members) {
+    const [strings, numbers] = partition(members, (v) => typeof v === "string");
+    return Ty((description) => {
+        return {
+            anyOf: [
+                ...strings.length
+                    ? [{
+                            type: "string",
+                            enum: strings,
+                        }]
+                    : [],
+                ...numbers.length
+                    ? [{
+                            type: "number",
+                            enum: numbers,
+                        }]
+                    : [],
+            ],
+            description,
+        };
+    });
+}
+//# sourceMappingURL=constantUnion.js.map

package/esm/types/constantUnion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constantUnion.js","sourceRoot":"","sources":["../../src/types/constantUnion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8CAA8C,CAAA;AACxE,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,MAAM,UAAU,aAAa,CAC3B,GAAG,OAAU;IAEb,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAA;IAC3E,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE;QACxB,OAAO;YACL,KAAK,EAAE;gBACL,GAAG,OAAO,CAAC,MAAM;oBACf,CAAC,CAAC,CAAC;4BACD,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,OAAO;yBACd,CAAC;oBACF,CAAC,CAAC,EAAE;gBACN,GAAG,OAAO,CAAC,MAAM;oBACf,CAAC,CAAC,CAAC;4BACD,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,OAAO;yBACd,CAAC;oBACF,CAAC,CAAC,EAAE;aACP;YACD,WAAW;SACZ,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/esm/types/leaves.d.ts

@@ -0,0 +1,6 @@
+import { Ty } from "./Ty.js";
+export declare const none: Ty<null, never>;
+export declare const boolean: Ty<boolean, never>;
+export declare const number: Ty<number, never>;
+export declare const string: Ty<string, never>;
+//# sourceMappingURL=leaves.d.ts.map

package/esm/types/leaves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaves.d.ts","sourceRoot":"","sources":["../../src/types/leaves.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,CAG9B,CAAA;AAEH,eAAO,MAAM,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,CAGpC,CAAA;AAEH,eAAO,MAAM,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,CAGlC,CAAA;AAEH,eAAO,MAAM,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,CAGlC,CAAA"}

package/esm/types/leaves.js

@@ -0,0 +1,18 @@
+import { Ty } from "./Ty.js";
+export const none = Ty((description) => ({
+    type: "null",
+    description,
+}));
+export const boolean = Ty((description) => ({
+    type: "boolean",
+    description,
+}));
+export const number = Ty((description) => ({
+    type: "number",
+    description,
+}));
+export const string = Ty((description) => ({
+    type: "string",
+    description,
+}));
+//# sourceMappingURL=leaves.js.map

package/esm/types/leaves.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaves.js","sourceRoot":"","sources":["../../src/types/leaves.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,MAAM,CAAC,MAAM,IAAI,GAAoB,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,EAAE,MAAM;IACZ,WAAW;CACZ,CAAC,CAAC,CAAA;AAEH,MAAM,CAAC,MAAM,OAAO,GAAuB,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC9D,IAAI,EAAE,SAAS;IACf,WAAW;CACZ,CAAC,CAAC,CAAA;AAEH,MAAM,CAAC,MAAM,MAAM,GAAsB,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC5D,IAAI,EAAE,QAAQ;IACd,WAAW;CACZ,CAAC,CAAC,CAAA;AAEH,MAAM,CAAC,MAAM,MAAM,GAAsB,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC5D,IAAI,EAAE,QAAQ;IACd,WAAW;CACZ,CAAC,CAAC,CAAA"}

package/esm/types/mod.d.ts

@@ -0,0 +1,11 @@
+export * from "./array.js";
+export * from "./leaves.js";
+export * from "./constant.js";
+export * from "./constantUnion.js";
+export * from "./std/mod.js";
+export * from "./object.js";
+export * from "./Ref.js";
+export * from "./taggedUnion.js";
+export * from "./Ty.js";
+export * from "./RootTy.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/types/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/types/mod.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}

package/esm/types/mod.js

@@ -0,0 +1,11 @@
+export * from "./array.js";
+export * from "./leaves.js";
+export * from "./constant.js";
+export * from "./constantUnion.js";
+export * from "./std/mod.js";
+export * from "./object.js";
+export * from "./Ref.js";
+export * from "./taggedUnion.js";
+export * from "./Ty.js";
+export * from "./RootTy.js";
+//# sourceMappingURL=mod.js.map

package/esm/types/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../src/types/mod.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}

package/esm/types/object.d.ts

@@ -0,0 +1,6 @@
+import { RootTy } from "./RootTy.js";
+import type { Ty } from "./Ty.js";
+export declare function object<F extends Record<string, Ty>>(fields: F): RootTy<{
+    [K in keyof F]: F[K][Ty.T];
+}, F[keyof F][Ty.P]>;
+//# sourceMappingURL=object.d.ts.map

package/esm/types/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/types/object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAEjC,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CACrE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAAE,EAC9B,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACjB,CAQA"}

package/esm/{object.js → types/object.js}

@@ -1,9 +1,9 @@
-import { make } from "./_base.js";
-export function object(description, fields) {
-    return make((ctx) => ({
+import { RootTy } from "./RootTy.js";
+export function object(fields) {
+    return RootTy((description, ref) => ({
         type: "object",
         description,
-        properties: Object.fromEntries(Object.entries(fields).map(([k, v]) => [k, ctx.ref(v)])),
+        properties: Object.fromEntries(Object.entries(fields).map(([k, v]) => [k, ref(v)])),
         additionalProperties: false,
         required: Object.keys(fields),
     }));

package/esm/types/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../src/types/object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,MAAM,UAAU,MAAM,CAA+B,MAAS;IAI5D,OAAO,MAAM,CAAC,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,EAAE,QAAQ;QACd,WAAW;QACX,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnF,oBAAoB,EAAE,KAAK;QAC3B,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;KAC9B,CAAC,CAAC,CAAA;AACL,CAAC"}

package/esm/types/std/Option.d.ts

@@ -0,0 +1,7 @@
+import { taggedUnion } from "../taggedUnion.js";
+import type { Ty } from "../Ty.js";
+export declare function option<S extends Ty>(Some: S): ReturnType<typeof taggedUnion<{
+    Some: S;
+    None: Ty<null, never>;
+}>>;
+//# sourceMappingURL=Option.d.ts.map

package/esm/types/std/Option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Option.d.ts","sourceRoot":"","sources":["../../../src/types/std/Option.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAA;AAElC,wBAAgB,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CACvD,OAAO,WAAW,CAAC;IACjB,IAAI,EAAE,CAAC,CAAA;IACP,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;CACtB,CAAC,CACH,CAKA"}

package/esm/types/std/Option.js

@@ -0,0 +1,9 @@
+import { none } from "../leaves.js";
+import { taggedUnion } from "../taggedUnion.js";
+export function option(Some) {
+    return taggedUnion({
+        Some,
+        None: none,
+    }) `An option of specified \`some\` type.`;
+}
+//# sourceMappingURL=Option.js.map

package/esm/types/std/Option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Option.js","sourceRoot":"","sources":["../../../src/types/std/Option.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG/C,MAAM,UAAU,MAAM,CAAe,IAAO;IAM1C,OAAO,WAAW,CAAC;QACjB,IAAI;QACJ,IAAI,EAAE,IAAI;KACX,CAAC,CAAA,uCAAuC,CAAA;AAC3C,CAAC"}

package/esm/types/std/Wrapper.d.ts

@@ -0,0 +1,7 @@
+import type { Ty } from "../mod.js";
+import { object } from "../object.js";
+export type Wrapper<X extends Ty = Ty> = ReturnType<typeof Wrapper<X>>;
+export declare function Wrapper<X extends Ty>(value: X): ReturnType<typeof object<{
+    value: X;
+}>>;
+//# sourceMappingURL=Wrapper.d.ts.map

package/esm/types/std/Wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wrapper.d.ts","sourceRoot":"","sources":["../../../src/types/std/Wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAEtE,wBAAgB,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC,CAEvF"}

package/esm/types/std/Wrapper.js

@@ -0,0 +1,5 @@
+import { object } from "../object.js";
+export function Wrapper(value) {
+    return object({ value });
+}
+//# sourceMappingURL=Wrapper.js.map

package/esm/types/std/Wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wrapper.js","sourceRoot":"","sources":["../../../src/types/std/Wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAIrC,MAAM,UAAU,OAAO,CAAe,KAAQ;IAC5C,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAC1B,CAAC"}

package/esm/types/std/mod.d.ts

@@ -0,0 +1,3 @@
+export * from "./Option.js";
+export * from "./Wrapper.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/types/std/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/types/std/mod.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/esm/types/std/mod.js

@@ -0,0 +1,3 @@
+export * from "./Option.js";
+export * from "./Wrapper.js";
+//# sourceMappingURL=mod.js.map

package/esm/types/std/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/types/std/mod.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/esm/types/taggedUnion.d.ts

@@ -0,0 +1,8 @@
+import { Ty } from "./Ty.js";
+export declare function taggedUnion<M extends Record<string, Ty>>(members: M): Ty<{
+    [K in keyof M]: {
+        type: K;
+        value: M[K][Ty.T];
+    };
+}[keyof M], M[keyof M][Ty.P]>;
+//# sourceMappingURL=taggedUnion.d.ts.map

package/esm/types/taggedUnion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taggedUnion.d.ts","sourceRoot":"","sources":["../../src/types/taggedUnion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,CACvE;KACG,CAAC,IAAI,MAAM,CAAC,GAAG;QACd,IAAI,EAAE,CAAC,CAAA;QACP,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;KAClB;CACF,CAAC,MAAM,CAAC,CAAC,EACV,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACjB,CAiBA"}

package/esm/types/taggedUnion.js

@@ -0,0 +1,20 @@
+import { Ty } from "./Ty.js";
+export function taggedUnion(members) {
+    return Ty((description, ref) => ({
+        description,
+        discriminator: "type",
+        anyOf: Object.entries(members).map(([k, v]) => ({
+            type: "object",
+            properties: {
+                type: {
+                    type: "string",
+                    const: k,
+                },
+                value: ref(v),
+            },
+            required: ["type", "value"],
+            additionalProperties: false,
+        })),
+    }));
+}
+//# sourceMappingURL=taggedUnion.js.map

package/esm/types/taggedUnion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taggedUnion.js","sourceRoot":"","sources":["../../src/types/taggedUnion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,MAAM,UAAU,WAAW,CAA+B,OAAU;IASlE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/B,WAAW;QACX,aAAa,EAAE,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9C,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,CAAC;iBACT;gBACD,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;aACd;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;YAC3B,oBAAoB,EAAE,KAAK;SAC5B,CAAC,CAAC;KACJ,CAAC,CAAC,CAAA;AACL,CAAC"}

package/esm/util/phantoms.d.ts

@@ -0,0 +1,2 @@
+export declare function phantoms<T>(): T;
+//# sourceMappingURL=phantoms.d.ts.map

package/esm/util/phantoms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phantoms.d.ts","sourceRoot":"","sources":["../../src/util/phantoms.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,CAAC,KAAK,CAAC,CAE/B"}

package/esm/util/phantoms.js

@@ -0,0 +1,4 @@
+export function phantoms() {
+    return {};
+}
+//# sourceMappingURL=phantoms.js.map

package/esm/util/phantoms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phantoms.js","sourceRoot":"","sources":["../../src/util/phantoms.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ;IACtB,OAAO,EAAO,CAAA;AAChB,CAAC"}

package/esm/util/recombineTaggedTemplateArgs.d.ts

@@ -0,0 +1,2 @@
+export declare function recombineTaggedTemplateArgs(strings: TemplateStringsArray, values: Array<number | string>): string;
+//# sourceMappingURL=recombineTaggedTemplateArgs.d.ts.map

package/esm/util/recombineTaggedTemplateArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recombineTaggedTemplateArgs.d.ts","sourceRoot":"","sources":["../../src/util/recombineTaggedTemplateArgs.ts"],"names":[],"mappings":"AAAA,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAC7B,MAAM,CAER"}

package/esm/util/recombineTaggedTemplateArgs.js

@@ -0,0 +1,4 @@
+export function recombineTaggedTemplateArgs(strings, values) {
+    return strings.reduce((acc, cur, i) => `${acc}${cur}${values[i] ?? ""}`, "");
+}
+//# sourceMappingURL=recombineTaggedTemplateArgs.js.map

package/esm/util/recombineTaggedTemplateArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recombineTaggedTemplateArgs.js","sourceRoot":"","sources":["../../src/util/recombineTaggedTemplateArgs.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,2BAA2B,CACzC,OAA6B,EAC7B,MAA8B;IAE9B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;AAC9E,CAAC"}

package/package.json

@@ -1,20 +1,18 @@
 {
   "name": "structured-outputs",
-  "version": "0.1.0-beta.2",
-  "description": "Lightweight virtual types for OpenAI structured outputs.",
+  "version": "0.1.0-beta.21",
+  "description": "Compose OpenAI structured output schemas.",
   "repository": "github:harrysolovay/structured-outputs.git",
   "license": "Apache-2.0",
+  "main": "./esm/mod.js",
   "module": "./esm/mod.js",
   "exports": {
     ".": {
       "import": "./esm/mod.js"
     }
   },
-  "dependencies": {
-    "tslib": "^2.6.2"
-  },
-  "devDependencies": {
-    "@types/node": "^20.9.0"
-  },
-  "_generatedBy": "dnt@dev"
+  "_generatedBy": "dnt@dev",
+  "peerDependencies": {
+    "openai": "^4.68.1"
+  }
 }

package/src/ResponseFormat.ts

@@ -1,31 +1,89 @@
-import type { Ty } from "./_base.js"
-import type { ValidRootKey } from "./common.js"
-import { schema } from "./schema.js"
+import type { RootTy } from "./types/mod.js"
+import { recombineTaggedTemplateArgs } from "./util/recombineTaggedTemplateArgs.js"
+import type { ChatCompletion, ChatCompletionChoice, JsonSchema } from "./oai.js"
 
-export type ResponseFormat = {
+export interface ResponseFormat<T> {
+  (template: TemplateStringsArray, ...quasis: Array<string>): ResponseFormat<T>
   type: "json_schema"
   /** The desired return type in JSON Schema. */
-  json_schema: {
-    name: string
-    description: string
-    schema: Record<string, unknown>
-    strict: true
-  }
+  json_schema: JsonSchema
+  /** Parse the content of the first choice into a typed object. */
+  parseFirstChoice(completion: ChatCompletion): T
+  /** Parse all choice contents into an array of typed object. */
+  parseChoices(completion: ChatCompletion): Array<T>
+}
+
+export function ResponseFormat<T>(name: string, ty: RootTy<T, never>): ResponseFormat<T> {
+  return ResponseFormat_(name, ty)
 }
 
-export function ResponseFormat<M extends Record<string, Ty>>(
+function ResponseFormat_<T>(
   name: string,
-  description: string,
-  models: M,
-  rootKey: ValidRootKey<M>,
-): ResponseFormat {
-  return {
-    type: "json_schema",
-    json_schema: {
-      name,
-      description,
-      schema: schema(models, rootKey),
-      strict: true,
+  ty: RootTy<T, never>,
+  description?: string,
+): ResponseFormat<T> {
+  return Object.assign(
+    (template: TemplateStringsArray, ...quasis: Array<string>) =>
+      ResponseFormat_(
+        name,
+        ty,
+        description ? `${description} ${recombineTaggedTemplateArgs(template, quasis)}` : undefined,
+      ),
+    {
+      type: "json_schema" as const,
+      json_schema: {
+        name,
+        description,
+        schema: ty.schema(),
+        strict: true,
+      },
+      parseFirstChoice: (completion: ChatCompletion): T => {
+        return JSON.parse(ResponseFormat.unwrapFirstChoice(completion))
+      },
+      parseChoices: (completion: ChatCompletion): Array<T> => {
+        return ResponseFormat.unwrapChoices(completion).map((content) => JSON.parse(content))
+      },
+      toJSON() {
+        const { type, json_schema } = this
+        return { type, json_schema }
+      },
     },
+  )
+}
+
+export namespace ResponseFormat {
+  export function unwrapFirstChoice(completion: ChatCompletion): string {
+    const { choices: [firstChoice] } = completion
+    if (!firstChoice) {
+      throw new ResponseFormatUnwrapError("No choices contained within the completion response.")
+    }
+    return unwrapChoice(firstChoice)
   }
+
+  export function unwrapChoices(completions: ChatCompletion): string[] {
+    return completions.choices.map(unwrapChoice)
+  }
+
+  function unwrapChoice(choice: ChatCompletionChoice) {
+    const { finish_reason, message } = choice
+    if (finish_reason !== "stop") {
+      throw new ResponseFormatUnwrapError(
+        `Completion responded with "${finish_reason}" as finish reason; ${message}`,
+      )
+    }
+    const { content, refusal } = message
+    if (refusal) {
+      throw new ResponseFormatUnwrapError(
+        `Openai refused to fulfill completion request; ${refusal}`,
+      )
+    }
+    if (!content) {
+      throw new ResponseFormatUnwrapError("First response choice contained no content.")
+    }
+    return content
+  }
+}
+
+export class ResponseFormatUnwrapError extends Error {
+  override readonly name = "UnwrapResponseError"
 }

package/src/Tool.ts

@@ -0,0 +1,38 @@
+import type { RootTy, Schema } from "./types/mod.js"
+import { recombineTaggedTemplateArgs } from "./util/recombineTaggedTemplateArgs.js"
+
+export function Tool<T>(name: string, ty: RootTy<T, never>): Tool<T> {
+  return Tool_(name, ty)
+}
+
+function Tool_<T>(name: string, ty: RootTy<T, never>, description?: string): Tool<T> {
+  return Object.assign(
+    (template: TemplateStringsArray, ...quasis: Array<string>) =>
+      Tool_(
+        name,
+        ty,
+        description ? `${description} ${recombineTaggedTemplateArgs(template, quasis)}` : undefined,
+      ),
+    {
+      type: "function" as const,
+      name,
+      description,
+      parameters: ty.schema(),
+      toJson() {
+        const { type, name, description, parameters } = this
+        return { type, name, description, parameters }
+      },
+    },
+  )
+}
+
+export interface Tool<T = any> {
+  (template: TemplateStringsArray, ...quasis: Array<string>): Tool<T>
+  type: "function"
+  /** The name with which OpenAI recognizes the tool. */
+  name: string
+  /** A description to inform the LLM of when/how to use the tool. */
+  description?: string
+  /** The tool implementation's argument type in JSON Schema. */
+  parameters?: Schema
+}

package/src/_dnt.polyfills.ts

@@ -0,0 +1,27 @@
+// https://github.com/tc39/proposal-accessible-object-hasownproperty/blob/main/polyfill.js
+if (!Object.hasOwn) {
+  Object.defineProperty(Object, "hasOwn", {
+    value: function (object: any, property: any) {
+      if (object == null) {
+        throw new TypeError("Cannot convert undefined or null to object");
+      }
+      return Object.prototype.hasOwnProperty.call(Object(object), property);
+    },
+    configurable: true,
+    enumerable: false,
+    writable: true,
+  });
+}
+
+declare global {
+  interface Object {
+    /**
+     * Determines whether an object has a property with the specified name.
+     * @param o An object.
+     * @param v A property name.
+     */
+    hasOwn(o: object, v: PropertyKey): boolean;
+  }
+}
+
+export {};

package/src/deps/jsr.io/@std/collections/1.0.9/_utils.ts

@@ -0,0 +1,26 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+/**
+ * Filters the given array, removing all elements that do not match the given predicate
+ * **in place. This means `array` will be modified!**.
+ */
+export function filterInPlace<T>(
+  array: Array<T>,
+  predicate: (el: T) => boolean,
+): Array<T> {
+  let outputIndex = 0;
+
+  for (const cur of array) {
+    if (!predicate(cur)) {
+      continue;
+    }
+
+    array[outputIndex] = cur;
+    outputIndex += 1;
+  }
+
+  array.splice(outputIndex);
+
+  return array;
+}

package/src/deps/jsr.io/@std/collections/1.0.9/aggregate_groups.ts

@@ -0,0 +1,62 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+import { mapEntries } from "./map_entries.js";
+
+/**
+ * Applies the given aggregator to each group in the given grouping, returning the
+ * results together with the respective group keys
+ *
+ * @typeParam T Type of the values in the input record.
+ * @typeParam A Type of the accumulator value, which will match the returned
+ * record's values.
+ *
+ * @param record The grouping to aggregate.
+ * @param aggregator The function to apply to each group.
+ *
+ * @returns A record with the same keys as the input record, but with the values
+ * being the result of applying the aggregator to each group.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { aggregateGroups } from "@std/collections/aggregate-groups";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const foodProperties = {
+ *   Curry: ["spicy", "vegan"],
+ *   Omelette: ["creamy", "vegetarian"],
+ * };
+ *
+ * const descriptions = aggregateGroups(
+ *   foodProperties,
+ *   (current, key, first, acc) => {
+ *     return first
+ *       ? `${key} is ${current}`
+ *       : `${acc} and ${current}`;
+ *   },
+ * );
+ *
+ * assertEquals(descriptions, {
+ *   Curry: "Curry is spicy and vegan",
+ *   Omelette: "Omelette is creamy and vegetarian",
+ * });
+ * ```
+ */
+export function aggregateGroups<T, A>(
+  record: Readonly<Record<string, ReadonlyArray<T>>>,
+  aggregator: (current: T, key: string, first: boolean, accumulator?: A) => A,
+): Record<string, A> {
+  return mapEntries(
+    record,
+    ([key, values]) => [
+      key,
+      // Need the type assertions here because the reduce type does not support
+      // the type transition we need
+      values.reduce(
+        (accumulator, current, currentIndex) =>
+          aggregator(current, key, currentIndex === 0, accumulator),
+        undefined as A | undefined,
+      ) as A,
+    ],
+  );
+}

package/src/deps/jsr.io/@std/collections/1.0.9/associate_by.ts

@@ -0,0 +1,50 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+/**
+ * Creates a record by associating each element of the input array with a key
+ * generated by the selector function.
+ *
+ * If the selector produces the same key for multiple elements, the latest one
+ * will be used (overriding the ones before it).
+ *
+ * @typeParam T Type of the elements in the input array.
+ *
+ * @param array The array to transform.
+ * @param selector The function to extract the key from each element.
+ *
+ * @returns A record with the keys produced by the selector and the elements as
+ * values.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { associateBy } from "@std/collections/associate-by";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const users = [
+ *   { id: "a2e", userName: "Anna" },
+ *   { id: "5f8", userName: "Arnold" },
+ *   { id: "d2c", userName: "Kim" },
+ * ];
+ *
+ * const usersById = associateBy(users, (user) => user.id);
+ *
+ * assertEquals(usersById, {
+ *   "a2e": { id: "a2e", userName: "Anna" },
+ *   "5f8": { id: "5f8", userName: "Arnold" },
+ *   "d2c": { id: "d2c", userName: "Kim" },
+ * });
+ * ```
+ */
+export function associateBy<T>(
+  array: Iterable<T>,
+  selector: (el: T) => string,
+): Record<string, T> {
+  const result: Record<string, T> = {};
+
+  for (const element of array) {
+    result[selector(element)] = element;
+  }
+
+  return result;
+}