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

package/dist/tool/ToolResult.mjs

@@ -1,85 +0,0 @@
-import { n as __exportAll } from "../rolldown-runtime-EAsCxrDo.mjs";
-import { toolCallOutput } from "../domain/Items.mjs";
-import { Data } from "effect";
-//#region src/tool/ToolResult.ts
-/**
-* Post-execution and synthetic tool results.
-*
-*   - Executed tools emit ToolResult.Ok.
-*   - Approval/cancellation policy emits synthetic ToolResult.Failure.
-*
-* Wire conversion stays at the recipe boundary via `toToolCallOutput`
-* so recipes can inspect, redact, or audit values before serialization.
-*
-* `output` and `reason` are `string`, not `unknown`: the wire wants strings,
-* and `unknown` would invite non-serializable values (Date, Map, BigInt,
-* fn). Recipes that want structured detail JSON.stringify themselves.
-*/
-var ToolResult_exports = /* @__PURE__ */ __exportAll({
-	ToolResult: () => ToolResult,
-	cancelled: () => cancelled,
-	denied: () => denied,
-	executionError: () => executionError,
-	failed: () => failed,
-	isFailure: () => isFailure,
-	isOk: () => isOk,
-	nonLocalTool: () => nonLocalTool,
-	serializeValue: () => serializeValue,
-	toToolCallOutput: () => toToolCallOutput,
-	validationError: () => validationError
-});
-/**
-* Namespace of constructors, type guards, and matchers for `ToolResult`,
-* provided by `Data.taggedEnum`. Use `ToolResult.$is("Ok")` for type
-* narrowing and `ToolResult.$match({ Ok, Failure })` for exhaustive
-* pattern matching. Synthetic-result helpers (`denied`, `cancelled`,
-* `executionError`, `failed`) below are kinder constructors than the
-* raw `ToolResult.Failure(...)`.
-*/
-const ToolResult = Data.taggedEnum();
-const isOk = ToolResult.$is("Ok");
-const isFailure = ToolResult.$is("Failure");
-const failed = (call, kind, reason) => ToolResult.Failure({
-	call_id: call.call_id,
-	tool: call.name,
-	kind,
-	...reason !== void 0 ? { reason } : {}
-});
-/** Explicit user/policy rejection. */
-const denied = (call, reason) => failed(call, "denied", reason);
-/** Implicit non-answer (follow-up, inactivity, abort). */
-const cancelled = (call, reason) => failed(call, "cancelled", reason);
-/** Tool's own execution failed (JSON parse error, runtime crash). */
-const executionError = (call, reason) => failed(call, "execution_error", reason);
-/**
-* The model called a tool that is visible to it but has no local executor — a
-* provider-hosted, signal, or interaction tool routed through `Toolkit.run`.
-* Distinct from `unknown_tool` (no such tool at all): the loop is expected to
-* intercept these kinds before execution, so this kind flags a missing handler.
-*/
-const nonLocalTool = (call, reason) => failed(call, "non_local_tool", reason ?? `Tool "${call.name}" is visible to the model but has no local executor`);
-/**
-* The model's `arguments` failed the tool's input schema. Distinct kind from
-* `execution_error` so recipes can tell a contract violation apart from a
-* runtime crash.
-*/
-const validationError = (call, reason) => failed(call, "input_validation_error", reason ?? "Tool input failed schema validation");
-/**
-* Serialize a success value for the wire. A `string` passes through raw
-* (models read plain text best; JSON.stringify would quote and escape it);
-* `undefined` becomes `"null"`; anything else is JSON.
-*/
-const serializeValue = (value) => typeof value === "string" ? value : JSON.stringify(value ?? null);
-/** The one failure shape the model sees: `{"error":{"kind","message"}}`. */
-const failureBody = (kind, message) => JSON.stringify({ error: message !== void 0 ? {
-	kind,
-	message
-} : { kind } });
-const toToolCallOutput = (r) => ToolResult.$match(r, {
-	Ok: (v) => toolCallOutput(v.call_id, serializeValue(v.value)),
-	Failure: (f) => toolCallOutput(f.call_id, failureBody(f.kind, f.reason))
-});
-//#endregion
-export { ToolResult, cancelled, denied, executionError, failed, isFailure, isOk, nonLocalTool, serializeValue, ToolResult_exports as t, toToolCallOutput, validationError };
-
-//# sourceMappingURL=ToolResult.mjs.map

package/dist/tool/ToolResult.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolResult.mjs","names":[],"sources":["../../src/tool/ToolResult.ts"],"sourcesContent":["/**\n * Post-execution and synthetic tool results.\n *\n *   - Executed tools emit ToolResult.Ok.\n *   - Approval/cancellation policy emits synthetic ToolResult.Failure.\n *\n * Wire conversion stays at the recipe boundary via `toToolCallOutput`\n * so recipes can inspect, redact, or audit values before serialization.\n *\n * `output` and `reason` are `string`, not `unknown`: the wire wants strings,\n * and `unknown` would invite non-serializable values (Date, Map, BigInt,\n * fn). Recipes that want structured detail JSON.stringify themselves.\n */\nimport { Data } from \"effect\"\nimport type { ToolCall, ToolCallOutput } from \"../domain/Items.js\"\nimport { toolCallOutput } from \"../domain/Items.js\"\n\n// ---------------------------------------------------------------------------\n// ToolResult\n// ---------------------------------------------------------------------------\n\nexport type ToolResult = Data.TaggedEnum<{\n  Ok: {\n    readonly call_id: string\n    readonly tool: string\n    readonly value: unknown\n  }\n  Failure: {\n    readonly call_id: string\n    readonly tool: string\n    readonly kind: string\n    readonly reason?: string\n  }\n}>\n\n/**\n * Namespace of constructors, type guards, and matchers for `ToolResult`,\n * provided by `Data.taggedEnum`. Use `ToolResult.$is(\"Ok\")` for type\n * narrowing and `ToolResult.$match({ Ok, Failure })` for exhaustive\n * pattern matching. Synthetic-result helpers (`denied`, `cancelled`,\n * `executionError`, `failed`) below are kinder constructors than the\n * raw `ToolResult.Failure(...)`.\n */\nexport const ToolResult = Data.taggedEnum<ToolResult>()\n\nexport const isOk = ToolResult.$is(\"Ok\")\nexport const isFailure = ToolResult.$is(\"Failure\")\n\n// Synthesizers. `denied` and `cancelled` are operationally distinct;\n// anything else is just a recipe-chosen `kind` via `failed`.\n// ---------------------------------------------------------------------------\n\nexport const failed = (call: ToolCall, kind: string, reason?: string): ToolResult =>\n  ToolResult.Failure({\n    call_id: call.call_id,\n    tool: call.name,\n    kind,\n    ...(reason !== undefined ? { reason } : {}),\n  })\n\n/** Explicit user/policy rejection. */\nexport const denied = (call: ToolCall, reason?: string): ToolResult =>\n  failed(call, \"denied\", reason)\n\n/** Implicit non-answer (follow-up, inactivity, abort). */\nexport const cancelled = (call: ToolCall, reason?: string): ToolResult =>\n  failed(call, \"cancelled\", reason)\n\n/** Tool's own execution failed (JSON parse error, runtime crash). */\nexport const executionError = (call: ToolCall, reason: string): ToolResult =>\n  failed(call, \"execution_error\", reason)\n\n/**\n * The model called a tool that is visible to it but has no local executor — a\n * provider-hosted, signal, or interaction tool routed through `Toolkit.run`.\n * Distinct from `unknown_tool` (no such tool at all): the loop is expected to\n * intercept these kinds before execution, so this kind flags a missing handler.\n */\nexport const nonLocalTool = (call: ToolCall, reason?: string): ToolResult =>\n  failed(\n    call,\n    \"non_local_tool\",\n    reason ?? `Tool \"${call.name}\" is visible to the model but has no local executor`,\n  )\n\n/**\n * The model's `arguments` failed the tool's input schema. Distinct kind from\n * `execution_error` so recipes can tell a contract violation apart from a\n * runtime crash.\n */\nexport const validationError = (call: ToolCall, reason?: string): ToolResult =>\n  failed(call, \"input_validation_error\", reason ?? \"Tool input failed schema validation\")\n\n// ---------------------------------------------------------------------------\n// Wire conversion - the one place structured → string happens.\n// ---------------------------------------------------------------------------\n\n/**\n * Serialize a success value for the wire. A `string` passes through raw\n * (models read plain text best; JSON.stringify would quote and escape it);\n * `undefined` becomes `\"null\"`; anything else is JSON.\n */\nexport const serializeValue = (value: unknown): string =>\n  typeof value === \"string\" ? value : JSON.stringify(value ?? null)\n\n/** The one failure shape the model sees: `{\"error\":{\"kind\",\"message\"}}`. */\nconst failureBody = (kind: string, message?: string): string =>\n  JSON.stringify({ error: message !== undefined ? { kind, message } : { kind } })\n\nexport const toToolCallOutput = (r: ToolResult): ToolCallOutput =>\n  ToolResult.$match(r, {\n    Ok: (v) => toolCallOutput(v.call_id, serializeValue(v.value)),\n    Failure: (f) => toolCallOutput(f.call_id, failureBody(f.kind, f.reason)),\n  })\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,aAAa,KAAK,WAAuB;AAEtD,MAAa,OAAO,WAAW,IAAI,IAAI;AACvC,MAAa,YAAY,WAAW,IAAI,SAAS;AAMjD,MAAa,UAAU,MAAgB,MAAc,WACnD,WAAW,QAAQ;CACjB,SAAS,KAAK;CACd,MAAM,KAAK;CACX;CACA,GAAI,WAAW,KAAA,IAAY,EAAE,OAAO,IAAI,CAAC;AAC3C,CAAC;;AAGH,MAAa,UAAU,MAAgB,WACrC,OAAO,MAAM,UAAU,MAAM;;AAG/B,MAAa,aAAa,MAAgB,WACxC,OAAO,MAAM,aAAa,MAAM;;AAGlC,MAAa,kBAAkB,MAAgB,WAC7C,OAAO,MAAM,mBAAmB,MAAM;;;;;;;AAQxC,MAAa,gBAAgB,MAAgB,WAC3C,OACE,MACA,kBACA,UAAU,SAAS,KAAK,KAAK,oDAC/B;;;;;;AAOF,MAAa,mBAAmB,MAAgB,WAC9C,OAAO,MAAM,0BAA0B,UAAU,qCAAqC;;;;;;AAWxF,MAAa,kBAAkB,UAC7B,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,SAAS,IAAI;;AAGlE,MAAM,eAAe,MAAc,YACjC,KAAK,UAAU,EAAE,OAAO,YAAY,KAAA,IAAY;CAAE;CAAM;AAAQ,IAAI,EAAE,KAAK,EAAE,CAAC;AAEhF,MAAa,oBAAoB,MAC/B,WAAW,OAAO,GAAG;CACnB,KAAK,MAAM,eAAe,EAAE,SAAS,eAAe,EAAE,KAAK,CAAC;CAC5D,UAAU,MAAM,eAAe,EAAE,SAAS,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC;AACzE,CAAC"}