@frontera-sdk/workflow 1.50.80 → 1.50.82

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontera-sdk/workflow",
-  "version": "1.50.80",
+  "version": "1.50.82",
   "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.50.80",
-    "@frontera-sdk/functions": "1.50.80"
+    "@frontera-sdk/core": "1.50.82",
+    "@frontera-sdk/functions": "1.50.82"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",

package/src/definition.ts

@@ -12,7 +12,7 @@
  * `params` discriminated by `kind` (and, inside `blueprint`, by `mode`), and
  * the shared settings every kind accepts.
  *
- * The node set is closed. All fourteen kinds are describable here, so a
+ * The node set is closed. All fifteen kinds are describable here, so a
  * definition written for a later phase is refused by the engine as "not yet
  * runnable", never as "unknown kind".
  *
@@ -28,6 +28,7 @@ export const NODE_KINDS = [
   'blueprint',
   'function',
   'llm',
+  'decide',
   'action',
   'agent',
   'plugin',
@@ -215,6 +216,24 @@ export interface LlmParams {
   temperature?: number
   maxTokens?: number
 }
+/**
+ * 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).
+ */
+export type DecideQuestion =
+  | { type: 'choice'; instructions: string; criteria: Record<string, string> }
+  | { type: 'score'; instructions: string; criteria: string[] }
+  | { type: 'noul'; instructions: string; criteria?: { true?: string; false?: string } }
+export interface DecideParams {
+  /** The decisions model. Defaults to `typesafe/jev-1.13`. */
+  model: string
+  /** The facts the questions are about. */
+  state: DataInput
+  /** Question id to question; each id is a key of the result's `answers`. */
+  questions: Record<string, DecideQuestion>
+}
 export interface ActionParams {
   input: DataInput
 }
@@ -271,6 +290,7 @@ export type WorkflowNode =
   | NodeOf<'blueprint', BlueprintQueryParams | BlueprintAggregateParams>
   | NodeOf<'function', FunctionParams>
   | NodeOf<'llm', LlmParams>
+  | NodeOf<'decide', DecideParams>
   | NodeOf<'action', ActionParams>
   | NodeOf<'agent', AgentParams>
   | NodeOf<'plugin', PluginParams>