@frontera-sdk/workflow 1.52.29 → 1.52.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontera-sdk/workflow",
-  "version": "1.52.29",
+  "version": "1.52.31",
   "description": "Typed headless client for starting, inspecting, waiting on and cancelling Frontera workflow runs from a script or backend.",
   "keywords": [
     "frontera",
@@ -38,8 +38,8 @@
     "typecheck": "bunx tsc --noEmit"
   },
   "dependencies": {
-    "@frontera-sdk/core": "1.52.29",
-    "@frontera-sdk/functions": "1.52.29"
+    "@frontera-sdk/core": "1.52.31",
+    "@frontera-sdk/functions": "1.52.31"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",

package/src/definition.ts

@@ -244,14 +244,24 @@ export interface LlmParams {
   temperature?: number
   maxTokens?: number
 }
+/** One option of a choice: its name and what it means. */
+export interface DecideChoiceOption {
+  option: string
+  meaning: string
+}
 /**
  * One question for the decisions model. `choice` picks one option from
- * `criteria` (option name to what it means), `score` places the state on an
- * ordered scale (`criteria` lists the levels, lowest first) and `noul` answers
- * yes or no as a probability (`criteria` may say what yes and no mean).
+ * `criteria`: a list of options, or a map of option name to what it means.
+ * Either way it is stored as the list, in the order written, which is the
+ * order the model reads them in. A list keeps option names that are numbers
+ * in the order written too; a map puts them first, in ascending order, so
+ * write those as the list. `score` places the
+ * state on an ordered scale (`criteria` lists the levels, lowest first) and
+ * `noul` answers yes or no as a probability (`criteria` may say what yes and
+ * no mean).
  */
 export type DecideQuestion =
-  | { type: 'choice'; instructions: string; criteria: Record<string, string> }
+  | { type: 'choice'; instructions: string; criteria: DecideChoiceOption[] | Record<string, string> }
   | { type: 'score'; instructions: string; criteria: string[] }
   | { type: 'noul'; instructions: string; criteria?: { true?: string; false?: string } }
 export interface DecideParams {
@@ -259,6 +269,12 @@ export interface DecideParams {
   model: string
   /** The facts the questions are about. */
   state: DataInput
+  /**
+   * Images the questions are about, as file references (`$input.photo`), at
+   * most 8, each 20 MB or less. JPEG, PNG, WebP, GIF or BMP up to 64 megapixels; larger images are
+   * scaled down to 1568 px a side.
+   */
+  files?: DataInput
   /** Question id to question; each id is a key of the result's `answers`. */
   questions: Record<string, DecideQuestion>
 }