@effect-uai/core 0.18.0 → 0.19.0-dev-20261109183959

package/dist/tool/ToolOutput.test.mjs

@@ -0,0 +1,153 @@
+import { imageBytes } from "../domain/Image.mjs";
+import { Image, image } from "./Content.mjs";
+import { RunError, UnknownTool, ValueParts, encoded, failure, make, success, value } from "./ToolOutput.mjs";
+import { m as describe } from "../dist-DzeSyeYF.mjs";
+import { n as globalExpect } from "../index.C4tKZ0yW-LuFnBtmu.mjs";
+import { t as it } from "../dist-B5K-y4Be.mjs";
+import { Effect, Schema, SchemaTransformation } from "effect";
+//#region src/tool/ToolOutput.test.ts
+const call = { call_id: "c1" };
+const png = image(imageBytes(new Uint8Array([
+	1,
+	2,
+	3
+]), "image/png"));
+describe("ToolOutput.success", () => {
+	it.effect("splits only top-level media: text, JSON and arrays without media stay one part", () => Effect.gen(function* () {
+		const outputs = yield* Effect.forEach([
+			"hello",
+			{ hits: [1, 2] },
+			[1, 2],
+			png
+		], (value) => make(call, value));
+		globalExpect(outputs.map((o) => o.output.map((p) => p.type))).toEqual([
+			["input_text"],
+			["input_json"],
+			["input_json"],
+			["input_image"]
+		]);
+	}));
+	it.effect("takes JSON from the schema's encoded side and media from the value", () => Effect.gen(function* () {
+		const Shot = Schema.Tuple([Schema.Struct({
+			title: Schema.String,
+			at: Schema.DateFromString
+		}), Image]);
+		const value = [{
+			title: "Home",
+			at: /* @__PURE__ */ new Date("2026-01-01T00:00:00.000Z")
+		}, png];
+		const out = yield* success(call, Shot, value);
+		globalExpect(out.output).toEqual([{
+			type: "input_json",
+			value: {
+				title: "Home",
+				at: "2026-01-01T00:00:00.000Z"
+			}
+		}, {
+			type: "input_image",
+			source: png.source
+		}]);
+		globalExpect(out.isError).toBeUndefined();
+		const back = yield* encoded(out.output).pipe(Effect.flatMap(Schema.decodeUnknownEffect(Shot)));
+		globalExpect(back).toEqual(value);
+	}));
+	it.effect("keeps the JSON whole when the schema encodes a mixed array to another shape", () => Effect.gen(function* () {
+		const Reshaped = Schema.Struct({
+			title: Schema.String,
+			shot: Schema.toEncoded(Image)
+		}).pipe(Schema.decodeTo(Schema.Tuple([Schema.String, Image]), SchemaTransformation.transform({
+			decode: ({ title, shot }) => [title, shot],
+			encode: ([title, shot]) => ({
+				title,
+				shot
+			})
+		})));
+		const out = yield* success(call, Reshaped, ["Home", png]);
+		globalExpect(out.output).toHaveLength(1);
+		globalExpect(out.output[0]).toMatchObject({
+			type: "input_json",
+			value: {
+				title: "Home",
+				shot: { _tag: "Image" }
+			}
+		});
+	}));
+});
+describe("ToolOutput.failure", () => {
+	it.effect("encodes the error as JSON and flags the output", () => Effect.gen(function* () {
+		const out = yield* failure(call, RunError, new UnknownTool({ message: "no tool named nope" }));
+		globalExpect(out).toEqual({
+			type: "function_call_output",
+			call_id: "c1",
+			output: [{
+				type: "input_json",
+				value: {
+					_tag: "UnknownTool",
+					message: "no tool named nope"
+				}
+			}],
+			isError: true
+		});
+	}));
+});
+describe("ToolOutput.value", () => {
+	it.effect("reads parts back as the value that made them, media as classes", () => Effect.gen(function* () {
+		const value$1 = [
+			{ title: "Home" },
+			png,
+			"caption"
+		];
+		const out = yield* make(call, value$1);
+		globalExpect(out.output.map((p) => p.type)).toEqual([
+			"input_json",
+			"input_image",
+			"input_text"
+		]);
+		const back = value(out.output);
+		globalExpect(back).toEqual(value$1);
+		globalExpect(Array.isArray(back) && back[1]).toBeInstanceOf(Image);
+	}));
+});
+describe("ToolOutput.ValueParts", () => {
+	const encode = Schema.encodeEffect(ValueParts);
+	const decode = Schema.decodeUnknownEffect(ValueParts);
+	it.effect("JSON shaped like an image stays JSON through the wire", () => Effect.gen(function* () {
+		const lookalike = {
+			_tag: "Image",
+			source: {
+				_tag: "url",
+				url: "https://x/cat.png"
+			}
+		};
+		const wire = yield* encode(lookalike);
+		globalExpect(wire).toEqual([{
+			type: "input_json",
+			value: lookalike
+		}]);
+		const back = yield* decode(JSON.parse(JSON.stringify(wire)));
+		globalExpect(back).toEqual(lookalike);
+		globalExpect(back).not.toBeInstanceOf(Image);
+	}));
+	it.effect("media round-trips as a class, bytes as base64 on the wire", () => Effect.gen(function* () {
+		const value = [
+			{ title: "Home" },
+			png,
+			"caption"
+		];
+		const wire = yield* encode(value);
+		globalExpect(wire[1]).toEqual({
+			type: "input_image",
+			source: {
+				_tag: "bytes",
+				bytes: "AQID",
+				mimeType: "image/png"
+			}
+		});
+		const back = yield* decode(JSON.parse(JSON.stringify(wire)));
+		globalExpect(back).toEqual(value);
+	}));
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=ToolOutput.test.mjs.map

package/dist/tool/ToolOutput.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolOutput.test.mjs","names":["Content.image","ToolOutput.make","Content.Image","ToolOutput.success","ToolOutput.encoded","ToolOutput.failure","ToolOutput.RunError","ToolOutput.UnknownTool","value","ToolOutput.value","ToolOutput.ValueParts"],"sources":["../../src/tool/ToolOutput.test.ts"],"sourcesContent":["import { describe, expect, it } from \"@effect/vitest\"\nimport { Effect, Schema, SchemaTransformation } from \"effect\"\nimport { imageBytes } from \"../domain/Image.js\"\nimport * as Content from \"./Content.js\"\nimport * as ToolOutput from \"./ToolOutput.js\"\n\nconst call = { call_id: \"c1\" }\nconst png = Content.image(imageBytes(new Uint8Array([1, 2, 3]), \"image/png\"))\n\ndescribe(\"ToolOutput.success\", () => {\n  it.effect(\"splits only top-level media: text, JSON and arrays without media stay one part\", () =>\n    Effect.gen(function* () {\n      const outputs = yield* Effect.forEach([\"hello\", { hits: [1, 2] }, [1, 2], png], (value) =>\n        ToolOutput.make(call, value),\n      )\n      expect(outputs.map((o) => o.output.map((p) => p.type))).toEqual([\n        [\"input_text\"],\n        [\"input_json\"],\n        [\"input_json\"],\n        [\"input_image\"],\n      ])\n    }),\n  )\n\n  it.effect(\"takes JSON from the schema's encoded side and media from the value\", () =>\n    Effect.gen(function* () {\n      const Shot = Schema.Tuple([\n        Schema.Struct({ title: Schema.String, at: Schema.DateFromString }),\n        Content.Image,\n      ])\n      const value = [{ title: \"Home\", at: new Date(\"2026-01-01T00:00:00.000Z\") }, png] as const\n\n      const out = yield* ToolOutput.success(call, Shot, value)\n      expect(out.output).toEqual([\n        { type: \"input_json\", value: { title: \"Home\", at: \"2026-01-01T00:00:00.000Z\" } },\n        { type: \"input_image\", source: png.source },\n      ])\n      expect(out.isError).toBeUndefined()\n\n      const back = yield* ToolOutput.encoded(out.output).pipe(\n        Effect.flatMap(Schema.decodeUnknownEffect(Shot)),\n      )\n      expect(back).toEqual(value)\n    }),\n  )\n\n  it.effect(\"keeps the JSON whole when the schema encodes a mixed array to another shape\", () =>\n    Effect.gen(function* () {\n      const Encoded = Schema.Struct({\n        title: Schema.String,\n        shot: Schema.toEncoded(Content.Image),\n      })\n      const Reshaped = Encoded.pipe(\n        Schema.decodeTo(\n          Schema.Tuple([Schema.String, Content.Image]),\n          SchemaTransformation.transform({\n            decode: ({ title, shot }) => [title, shot] as const,\n            encode: ([title, shot]) => ({ title, shot }),\n          }),\n        ),\n      )\n      const out = yield* ToolOutput.success(call, Reshaped, [\"Home\", png] as const)\n      expect(out.output).toHaveLength(1)\n      expect(out.output[0]).toMatchObject({\n        type: \"input_json\",\n        value: { title: \"Home\", shot: { _tag: \"Image\" } },\n      })\n    }),\n  )\n})\n\ndescribe(\"ToolOutput.failure\", () => {\n  it.effect(\"encodes the error as JSON and flags the output\", () =>\n    Effect.gen(function* () {\n      const out = yield* ToolOutput.failure(\n        call,\n        ToolOutput.RunError,\n        new ToolOutput.UnknownTool({ message: \"no tool named nope\" }),\n      )\n      expect(out).toEqual({\n        type: \"function_call_output\",\n        call_id: \"c1\",\n        output: [\n          { type: \"input_json\", value: { _tag: \"UnknownTool\", message: \"no tool named nope\" } },\n        ],\n        isError: true,\n      })\n    }),\n  )\n})\n\ndescribe(\"ToolOutput.value\", () => {\n  it.effect(\"reads parts back as the value that made them, media as classes\", () =>\n    Effect.gen(function* () {\n      const value = [{ title: \"Home\" }, png, \"caption\"]\n      const out = yield* ToolOutput.make(call, value)\n      expect(out.output.map((p) => p.type)).toEqual([\"input_json\", \"input_image\", \"input_text\"])\n      const back = ToolOutput.value(out.output)\n      expect(back).toEqual(value)\n      expect(Array.isArray(back) && back[1]).toBeInstanceOf(Content.Image)\n    }),\n  )\n})\n\ndescribe(\"ToolOutput.ValueParts\", () => {\n  const encode = Schema.encodeEffect(ToolOutput.ValueParts)\n  const decode = Schema.decodeUnknownEffect(ToolOutput.ValueParts)\n\n  it.effect(\"JSON shaped like an image stays JSON through the wire\", () =>\n    Effect.gen(function* () {\n      const lookalike = { _tag: \"Image\", source: { _tag: \"url\", url: \"https://x/cat.png\" } }\n      const wire = yield* encode(lookalike)\n      expect(wire).toEqual([{ type: \"input_json\", value: lookalike }])\n      const back = yield* decode(JSON.parse(JSON.stringify(wire)))\n      expect(back).toEqual(lookalike)\n      expect(back).not.toBeInstanceOf(Content.Image)\n    }),\n  )\n\n  it.effect(\"media round-trips as a class, bytes as base64 on the wire\", () =>\n    Effect.gen(function* () {\n      const value = [{ title: \"Home\" }, png, \"caption\"]\n      const wire = yield* encode(value)\n      expect(wire[1]).toEqual({\n        type: \"input_image\",\n        source: { _tag: \"bytes\", bytes: \"AQID\", mimeType: \"image/png\" },\n      })\n      const back = yield* decode(JSON.parse(JSON.stringify(wire)))\n      expect(back).toEqual(value)\n    }),\n  )\n})\n"],"mappings":"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"}

package/dist/tool/Toolkit.d.mts

@@ -1,2 +1,2 @@
-import { S as wrap, _ as fromArray, a as ToolMap, b as namespace, c as ToolkitR, d as appendToolResults, f as collectResults, g as descriptors, h as describeFailures, i as NoDuplicateNames, m as continueWithResults, n as ExecuteOptions, o as Toolkit, p as compose, r as Middleware, s as ToolkitE, t as DuplicateToolName, u as UniqueTools, v as make, x as run, y as makeNamespaced } from "../Toolkit-tlL0F2YR.mjs";
-export { DuplicateToolName, ExecuteOptions, Middleware, NoDuplicateNames, ToolMap, Toolkit, ToolkitE, ToolkitR, UniqueTools, appendToolResults, collectResults, compose, continueWithResults, describeFailures, descriptors, fromArray, make, makeNamespaced, namespace, run, wrap };
+import { A as namespace, C as decode, D as isOutcome, E as fromArray, F as withFailures, I as wrap, M as output, N as run, O as make, P as split, S as continueWith, T as descriptors, _ as UniqueTools, a as Handler, b as complete, c as Outcome, d as Toolkit, f as ToolkitE, g as UndeclaredFailure, i as ExecuteOptions, j as next, k as makeNamespaced, l as Split, m as ToolkitR, n as DuplicateToolName, o as Middleware, p as ToolkitFailure, r as Event, s as NoDuplicateNames, t as DeclaredCall, u as ToolMap, v as appendResults, w as describeFailures, x as compose, y as close } from "../Toolkit-D2VGeD5R.mjs";
+export { DeclaredCall, DuplicateToolName, Event, ExecuteOptions, Handler, Middleware, NoDuplicateNames, Outcome, Split, ToolMap, Toolkit, ToolkitE, ToolkitFailure, ToolkitR, UndeclaredFailure, UniqueTools, appendResults, close, complete, compose, continueWith, decode, describeFailures, descriptors, fromArray, isOutcome, make, makeNamespaced, namespace, next, output, run, split, withFailures, wrap };