effect 4.0.7 → 4.1.1

package/dist/ai/Decision.d.ts

@@ -1,16 +1,6 @@
-/**
- * Defines decisions that a `DecisionModel` answers over a single input.
- * Pair an input schema with named classification, rating, or probability
- * decisions using `make`, then answer them with `DecisionModel.decide`, or
- * with `DecisionModel.decideSettled` to keep valid answers when others fail.
- *
- * @see {@link make} for building a definition from an input schema and decisions
- *
- * @stability unstable
- * @since 4.0.0
- */
 import type * as Result from "../Result.ts";
-import type * as Schema from "../Schema.ts";
+import * as Schema from "../Schema.ts";
+import type * as DecisionModel from "./DecisionModel.ts";
 /**
  * Brand type for decision definitions.
  *
@@ -98,6 +88,119 @@ export interface Probability {
         readonly true: Description;
     } | undefined;
 }
+/**
+ * Decision that finds one target in an image field of the input.
+ * `image` is the field's path in the encoded input, such as `"photo"` or
+ * `"frames[2].frame"`. The answer is a bounding box around the target.
+ *
+ * @see {@link locate} for the constructor
+ * @see {@link LocateAnswer} for the answer produced by this decision
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.1.0
+ */
+export interface Locate<Field extends string = string> {
+    readonly _tag: "Locate";
+    readonly image: Field;
+    readonly instructions: string;
+}
+/**
+ * Key that marks an encoded {@link Image}.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.1.0
+ */
+export declare const ImageKey = "~effect/ai/Decision/Image";
+/**
+ * JSON encoding of an {@link Image}: base64 data or a URL with its media type,
+ * under {@link ImageKey}.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.1.0
+ */
+export interface ImageEncoded {
+    readonly [ImageKey]: {
+        readonly mediaType: string;
+        readonly base64: string;
+    } | {
+        readonly mediaType: string;
+        readonly url: string;
+    };
+}
+/**
+ * Type-level representation of the {@link Image} schema.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.1.0
+ */
+export interface Image extends Schema.decodeTo<Schema.declare<DecisionModel.Image>, Schema.Struct<{
+    readonly [ImageKey]: Schema.Union<readonly [
+        Schema.Struct<{
+            readonly mediaType: Schema.String;
+            readonly base64: Schema.String;
+        }>,
+        Schema.Struct<{
+            readonly mediaType: Schema.String;
+            readonly url: Schema.URLFromString;
+        }>
+    ]>;
+}>> {
+    readonly "Rebuild": Image;
+}
+/**
+ * Schema for an image input field. Its type is `DecisionModel.Image`: a
+ * media type with base64 data, bytes, or a URL. Decisions refer to the image
+ * by the field's path, like any other field.
+ *
+ * **Details**
+ *
+ * The field encodes to an {@link ImageEncoded} object. `DecisionModel.decide`
+ * replaces each one in the encoded input with a reference string and sends the
+ * images to the provider separately; an image used in several fields is sent
+ * once. The encoded shape also appears in JSON Schema generated from the input.
+ *
+ * **Example** (Declaring an image field)
+ *
+ * ```ts
+ * import { Schema } from "effect"
+ * import { Decision } from "effect/ai"
+ *
+ * const Listing = Schema.Struct({
+ *   title: Schema.String,
+ *   photo: Decision.Image
+ * })
+ * ```
+ *
+ * @stability unstable
+ * @category schemas
+ * @since 4.1.0
+ */
+export declare const Image: Image;
+type PrevDepth = [never, 0, 1, 2, 3, 4];
+type ImagePathSuffixes<A, Depth extends number> = [Depth] extends [never] ? never : A extends ImageEncoded ? "" : A extends ReadonlyArray<unknown> ? number extends A["length"] ? `[${number}]${ImagePathSuffixes<A[number], PrevDepth[Depth]>}` : {
+    [K in keyof A & `${number}`]: `[${K}]${ImagePathSuffixes<A[K], PrevDepth[Depth]>}`;
+}[keyof A & `${number}`] : A extends object ? {
+    [K in keyof A & string]-?: K extends `${string}.${string}` | `${string}[${string}` ? never : {} extends Pick<A, K> ? never : `.${K}${ImagePathSuffixes<A[K], PrevDepth[Depth]>}`;
+}[keyof A & string] : never;
+/**
+ * Paths to the required {@link Image} fields of an encoded input type, as
+ * accepted by {@link locate}. Object keys are joined with `.`, and array
+ * elements use `[index]`: exact indices for tuples, any number for arrays.
+ *
+ * **Details**
+ *
+ * Paths reach four levels deep. Optional fields and keys containing `.` or
+ * `[` are excluded.
+ *
+ * @stability unstable
+ * @category utility types
+ * @since 4.1.0
+ */
+export type ImagePaths<A> = ImagePathSuffixes<A, 4> extends infer Path extends string ? Path extends "" ? never : Path extends `.${infer Rest}` ? Rest : Path : never;
 /**
  * Union of every decision kind.
  *
@@ -105,7 +208,7 @@ export interface Probability {
  * @category models
  * @since 4.0.0
  */
-export type Any = Classify<string> | Rate<string> | Probability;
+export type Any = Classify<string> | Rate<string> | Probability | Locate;
 /**
  * Answer to a {@link Classify} decision.
  * `label` is chosen by the provider and need not have the highest probability.
@@ -152,6 +255,36 @@ export interface RateAnswer<Level extends string> {
 export interface ProbabilityAnswer {
     readonly probability: number;
 }
+/**
+ * Smallest rectangle that contains a located target. Each edge is a fraction
+ * of the image's size measured from the top-left corner: `left` and `right`
+ * of its width, `top` and `bottom` of its height. Edges are in `[0, 1]`, with
+ * `left <= right` and `top <= bottom`.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.1.0
+ */
+export interface BoundingBox {
+    readonly left: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+}
+/**
+ * Answer to a {@link Locate} decision.
+ * There is no "not found" answer: a target absent from the image still gets a
+ * box. Pair the decision with a {@link Probability} that the target is present.
+ * `confidence` is an optional, provider-defined measure in `[0, 1]`.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.1.0
+ */
+export interface LocateAnswer {
+    readonly box: BoundingBox;
+    readonly confidence?: number | undefined;
+}
 /**
  * Answer type for a single decision.
  *
@@ -159,7 +292,7 @@ export interface ProbabilityAnswer {
  * @category utility types
  * @since 4.0.0
  */
-export type Answer<D extends Any> = D extends Classify<infer Label> ? ClassifyAnswer<Label> : D extends Rate<infer Level> ? RateAnswer<Level> : D extends Probability ? ProbabilityAnswer : never;
+export type Answer<D extends Any> = D extends Classify<infer Label> ? ClassifyAnswer<Label> : D extends Rate<infer Level> ? RateAnswer<Level> : D extends Probability ? ProbabilityAnswer : D extends Locate ? LocateAnswer : never;
 /**
  * Answers keyed by decision name.
  *
@@ -356,6 +489,53 @@ export declare const probability: (options: {
         readonly true: Description;
     } | undefined;
 }) => Probability;
+/**
+ * Creates a decision that finds one target in an image field of the input.
+ * `image` is the field's path in the encoded input: keys joined with `.` and
+ * array indices in brackets, such as `"frames[2].frame"`. The model must be
+ * created with `supportsLocate: true`.
+ *
+ * **Details**
+ *
+ * Paths use encoded key names, so a key renamed with `Schema.encodeKeys` is
+ * targeted by its encoded name. `make` accepts only paths to required
+ * {@link Image} fields, and `DecisionModel.decide` fails with
+ * `AiError.InvalidUserInputError` when the path holds no image, such as an
+ * index past the end of an array.
+ *
+ * The answer is always one box, even when the target is absent. Pair the
+ * decision with a {@link probability} decision that the target is present.
+ *
+ * **Gotchas**
+ *
+ * - For a generic input schema, the compiler error for an invalid path names
+ *   the whole decision type rather than the path.
+ *
+ * **Example** (Finding a mug in a photo)
+ *
+ * ```ts
+ * import { Schema } from "effect"
+ * import { Decision } from "effect/ai"
+ *
+ * const FindMug = Decision.make({
+ *   input: Schema.Struct({ photo: Decision.Image }),
+ *   decisions: {
+ *     present: Decision.probability({ instructions: "`photo` shows a coffee mug" }),
+ *     mug: Decision.locate({ image: "photo", instructions: "the coffee mug" })
+ *   }
+ * })
+ * ```
+ *
+ * @see {@link LocateAnswer} for the answer
+ *
+ * @stability unstable
+ * @category constructors
+ * @since 4.1.0
+ */
+export declare const locate: <const Field extends string>(options: {
+    readonly image: Field;
+    readonly instructions: string;
+}) => Locate<Field>;
 /**
  * Creates a decision definition from an input schema and named decisions.
  * `DecisionModel.decide` encodes the input with `Schema.toCodecJson` before
@@ -394,8 +574,9 @@ export declare const probability: (options: {
  * @category constructors
  * @since 4.0.0
  */
-export declare const make: <Input extends Schema.Constraint, Decisions extends Record<string, Any>>(options: {
+export declare const make: <Input extends Schema.Constraint, Decisions extends Record<string, Classify<string> | Rate<string> | Probability | Locate<ImagePaths<Input["Encoded"]>>>>(options: {
     readonly input: Input;
     readonly decisions: Decisions;
 }) => Definition<Input, Decisions>;
+export {};
 //# sourceMappingURL=Decision.d.ts.map

package/dist/ai/Decision.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Decision.d.ts","sourceRoot":"","sources":["../../src/ai/Decision.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Decision.d.ts","sourceRoot":"","sources":["../../src/ai/Decision.ts"],"names":[],"mappings":"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"}

package/dist/ai/Decision.js

@@ -1,3 +1,18 @@
+/**
+ * Defines decisions that a `DecisionModel` answers over a single input.
+ * Pair an input schema with named classification, rating, probability, or
+ * locate decisions using `make`, then answer them with `DecisionModel.decide`,
+ * or with `DecisionModel.decideSettled` to keep valid answers when others fail.
+ *
+ * @see {@link make} for building a definition from an input schema and decisions
+ *
+ * @stability unstable
+ * @since 4.0.0
+ */
+import * as Base64 from "../encoding/Base64.js";
+import * as Predicate from "../Predicate.js";
+import * as Schema from "../Schema.js";
+import * as SchemaTransformation from "../SchemaTransformation.js";
 /**
  * Brand for decision definitions.
  *
@@ -6,6 +21,73 @@
  * @since 4.0.0
  */
 export const TypeId = "~effect/ai/Decision";
+/**
+ * Key that marks an encoded {@link Image}.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.1.0
+ */
+export const ImageKey = "~effect/ai/Decision/Image";
+const isImage = u => Predicate.isObject(u) && Predicate.isString(u.mediaType) && (Predicate.isString(u.data) || u.data instanceof globalThis.Uint8Array || u.data instanceof globalThis.URL);
+/**
+ * Schema for an image input field. Its type is `DecisionModel.Image`: a
+ * media type with base64 data, bytes, or a URL. Decisions refer to the image
+ * by the field's path, like any other field.
+ *
+ * **Details**
+ *
+ * The field encodes to an {@link ImageEncoded} object. `DecisionModel.decide`
+ * replaces each one in the encoded input with a reference string and sends the
+ * images to the provider separately; an image used in several fields is sent
+ * once. The encoded shape also appears in JSON Schema generated from the input.
+ *
+ * **Example** (Declaring an image field)
+ *
+ * ```ts
+ * import { Schema } from "effect"
+ * import { Decision } from "effect/ai"
+ *
+ * const Listing = Schema.Struct({
+ *   title: Schema.String,
+ *   photo: Decision.Image
+ * })
+ * ```
+ *
+ * @stability unstable
+ * @category schemas
+ * @since 4.1.0
+ */
+export const Image = /*#__PURE__*/Schema.Struct({
+  [ImageKey]: Schema.Union([Schema.Struct({
+    mediaType: Schema.String,
+    base64: Schema.String
+  }), Schema.Struct({
+    mediaType: Schema.String,
+    url: Schema.URLFromString
+  })])
+}).pipe(/*#__PURE__*/Schema.decodeTo(/*#__PURE__*/Schema.declare(isImage, {
+  expected: "DecisionModel.Image"
+}), /*#__PURE__*/SchemaTransformation.transform({
+  decode: ({
+    [ImageKey]: image
+  }) => ({
+    mediaType: image.mediaType,
+    data: "base64" in image ? image.base64 : image.url
+  }),
+  encode: ({
+    mediaType,
+    data
+  }) => ({
+    [ImageKey]: data instanceof globalThis.URL ? {
+      mediaType,
+      url: data
+    } : {
+      mediaType,
+      base64: typeof data === "string" ? data : Base64.encode(data)
+    }
+  })
+})));
 /**
  * Creates a classification decision from labelled criteria.
  * Descriptions can be `null` when the label needs no explanation.
@@ -149,6 +231,54 @@ export const probability = options => ({
   instructions: options.instructions,
   criteria: options.criteria
 });
+/**
+ * Creates a decision that finds one target in an image field of the input.
+ * `image` is the field's path in the encoded input: keys joined with `.` and
+ * array indices in brackets, such as `"frames[2].frame"`. The model must be
+ * created with `supportsLocate: true`.
+ *
+ * **Details**
+ *
+ * Paths use encoded key names, so a key renamed with `Schema.encodeKeys` is
+ * targeted by its encoded name. `make` accepts only paths to required
+ * {@link Image} fields, and `DecisionModel.decide` fails with
+ * `AiError.InvalidUserInputError` when the path holds no image, such as an
+ * index past the end of an array.
+ *
+ * The answer is always one box, even when the target is absent. Pair the
+ * decision with a {@link probability} decision that the target is present.
+ *
+ * **Gotchas**
+ *
+ * - For a generic input schema, the compiler error for an invalid path names
+ *   the whole decision type rather than the path.
+ *
+ * **Example** (Finding a mug in a photo)
+ *
+ * ```ts
+ * import { Schema } from "effect"
+ * import { Decision } from "effect/ai"
+ *
+ * const FindMug = Decision.make({
+ *   input: Schema.Struct({ photo: Decision.Image }),
+ *   decisions: {
+ *     present: Decision.probability({ instructions: "`photo` shows a coffee mug" }),
+ *     mug: Decision.locate({ image: "photo", instructions: "the coffee mug" })
+ *   }
+ * })
+ * ```
+ *
+ * @see {@link LocateAnswer} for the answer
+ *
+ * @stability unstable
+ * @category constructors
+ * @since 4.1.0
+ */
+export const locate = options => ({
+  _tag: "Locate",
+  image: options.image,
+  instructions: options.instructions
+});
 /**
  * Creates a decision definition from an input schema and named decisions.
  * `DecisionModel.decide` encodes the input with `Schema.toCodecJson` before

package/dist/ai/Decision.js.map

@@ -1 +1 @@
-{"version":3,"file":"Decision.js","names":[],"sources":["../../src/ai/Decision.ts"],"sourcesContent":[null],"mappings":"AAuBA;;;;;;;AAOA,OAAO,MAAM,MAAM,GAAW,qBAAqB;AAkNnD;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,OAAO,MAAM,QAAQ,GAA0B,OAG9C,IAAqB;EACpB,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;IAC5C,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC;EACjF;EACA,OAAO;IACL,IAAI,EAAE,UAAU;IAChB,YAAY,EAAE,OAAO,CAAC,YAAY;IAClC,QAAQ,EAAE,OAAO,CAAC;GACnB;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,OAAO,MAAM,IAAI,GAAgC,OAGhD,IAAiB;EAChB,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;IAC/B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC;EAC7E;EACA,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAE,KAAK,IAC1C,OAAO,KAAK,KAAK,QAAQ,GAAG;IAAE,KAAK,EAAE,KAAK;IAAE,WAAW,EAAE;EAAK,CAAE,GAAG,KAAK,CACzE;EACD,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAE,KAAK,IAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,MAAM,EAAE;IAC1E,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC;EACzE;EACA,OAAO;IACL,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,OAAO,CAAC,YAAY;IAClC;GACD;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,OAAO,MAAM,WAAW,GAAI,OAM3B,KAAmB;EAClB,IAAI,EAAE,aAAa;EACnB,YAAY,EAAE,OAAO,CAAC,YAAY;EAClC,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,OAAO,MAAM,IAAI,GAA4E,OAG5F,IAAkC;EACjC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE;IAC/C,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC;EAC/D;EACA,OAAO;IACL,CAAC,MAAM,GAAG,MAAM;IAChB,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,SAAS,EAAE,OAAO,CAAC;GACpB;AACH,CAAC","ignoreList":[]}
+{"version":3,"file":"Decision.js","names":[],"sources":["../../src/ai/Decision.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/ai/DecisionModel.d.ts

@@ -11,7 +11,7 @@ import * as Context from "../Context.ts";
 import * as Effect from "../Effect.ts";
 import * as Schema from "../Schema.ts";
 import * as AiError from "./AiError.ts";
-import type * as Decision from "./Decision.ts";
+import * as Decision from "./Decision.ts";
 import type * as Response from "./Response.ts";
 /**
  * Service key for answering decisions about an input. Create implementations
@@ -62,13 +62,9 @@ export declare class DecisionUsage extends DecisionUsage_base {
  */
 export interface DecideOptions<Input extends Schema.Constraint> {
     readonly input: Input["Type"];
-    /**
-     * Images to include with the input.
-     */
-    readonly images?: ReadonlyArray<Image> | undefined;
 }
 /**
- * An image sent to the provider with the encoded input.
+ * An image in the input, declared with a `Decision.Image` field.
  * `data` is a base64 string, a byte array, or a URL.
  *
  * @stability unstable
@@ -79,6 +75,23 @@ export interface Image {
     readonly mediaType: string;
     readonly data: string | Uint8Array | URL;
 }
+/**
+ * An image extracted from the encoded input. `state` holds `reference` where
+ * the image was, and `path` is where it was first found. `data` is a base64
+ * string or a URL.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.1.0
+ */
+export interface ProviderImage {
+    readonly reference: string;
+    readonly path: ReadonlyArray<string | number>;
+    readonly image: {
+        readonly mediaType: string;
+        readonly data: string | URL;
+    };
+}
 /**
  * Provider-specific response metadata keyed by provider name. Provider
  * packages augment this interface.
@@ -142,16 +155,18 @@ export interface DecideSettledResponse<Decisions extends Record<string, Decision
  * Provider input options for a decision request.
  * `state` is encoded with `Schema.toCodecJson`, not stringified.
  * All `decisions` must be answered in one call.
- * `images` is omitted when no images are supplied.
+ * `images` holds the `Decision.Image` values found in the input and is omitted
+ * when there are none.
+ * `Decisions` is the union of decision kinds the provider receives.
  *
  * @stability unstable
  * @category options
  * @since 4.0.0
  */
-export interface ProviderOptions {
+export interface ProviderOptions<Decisions extends Decision.Any = Decision.Any> {
     readonly state: Schema.Json;
-    readonly decisions: Record<string, Decision.Any>;
-    readonly images?: ReadonlyArray<Image> | undefined;
+    readonly decisions: Record<string, Decisions>;
+    readonly images?: ReadonlyArray<ProviderImage> | undefined;
 }
 /**
  * Provider classify answer. Omit `probabilities` when no distribution is available.
@@ -201,6 +216,18 @@ export interface ProviderProbabilityAnswer {
 export interface ProviderRefusalAnswer {
     readonly _tag: "Refusal";
 }
+/**
+ * Provider answer for a locate decision.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.1.0
+ */
+export interface ProviderLocateAnswer {
+    readonly _tag: "Locate";
+    readonly box: Decision.BoundingBox;
+    readonly confidence?: number | undefined;
+}
 /**
  * Provider answer for any decision kind.
  *
@@ -208,7 +235,7 @@ export interface ProviderRefusalAnswer {
  * @category models
  * @since 4.0.0
  */
-export type ProviderAnswer = ProviderClassifyAnswer | ProviderRateAnswer | ProviderProbabilityAnswer | ProviderRefusalAnswer;
+export type ProviderAnswer = ProviderClassifyAnswer | ProviderRateAnswer | ProviderProbabilityAnswer | ProviderRefusalAnswer | ProviderLocateAnswer;
 /**
  * Provider response for a decision request.
  * `answers` is keyed like the requested decisions. Each answer is validated
@@ -246,16 +273,24 @@ export interface DecisionModel {
  * Creates a `DecisionModel` that encodes inputs as JSON and validates provider answers.
  * Answers must cover every decision and use its labels. Distributions must
  * sum to 1 within `1e-6`, optional confidence must be in `[0, 1]`, and ratings must be
- * in `[0, criteria.length - 1]`. With `decide`, refused decisions fail with
+ * in `[0, criteria.length - 1]`, and boxes must have edges in `[0, 1]` that do
+ * not cross. With `decide`, refused decisions fail with
  * `AiError.ContentPolicyError` and other unanswered decisions fail with
  * `AiError.InvalidOutputError`; `decideSettled` reports them per decision
  * instead. Encoding failures use `AiError.InvalidUserInputError`.
  *
  * **Details**
  *
- * Set `supportsImages: true` to accept images. Otherwise, nonempty image input
+ * After encoding, each `Decision.Image` in the input is replaced with a
+ * reference string, and the provider receives the images in `images`. Set
+ * `supportsImages: true` to accept images. Otherwise, an input with images
  * fails with `AiError.InvalidUserInputError`.
  *
+ * Set `supportsLocate: true` to accept locate decisions; only then does
+ * `decide` receive them. Otherwise, a definition with a locate decision fails
+ * with `AiError.InvalidUserInputError`, as does a locate decision whose path
+ * holds no image.
+ *
  * Providers that round each probability to `probabilityPrecision` decimal
  * places may return distributions whose sum drifts from 1 by up to half a unit
  * of the last place per label. Setting `probabilityPrecision` accepts that
@@ -270,9 +305,15 @@ export interface DecisionModel {
  * @since 4.0.0
  */
 export declare const make: (params: {
+    readonly decide: (options: ProviderOptions<Exclude<Decision.Any, Decision.Locate>>) => Effect.Effect<ProviderResponse, AiError.AiError>;
+    readonly probabilityPrecision?: number | undefined;
+    readonly supportsImages?: boolean | undefined;
+    readonly supportsLocate?: false | undefined;
+} | {
     readonly decide: (options: ProviderOptions) => Effect.Effect<ProviderResponse, AiError.AiError>;
     readonly probabilityPrecision?: number | undefined;
     readonly supportsImages?: boolean | undefined;
+    readonly supportsLocate: true;
 }) => Effect.Effect<DecisionModel>;
 /**
  * Answers a decision definition using the current `DecisionModel` service.

package/dist/ai/DecisionModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DecisionModel.d.ts","sourceRoot":"","sources":["../../src/ai/DecisionModel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DecisionModel.d.ts","sourceRoot":"","sources":["../../src/ai/DecisionModel.ts"],"names":[],"mappings":"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"}