@grida/fx 0.3.0 → 0.5.0

package/README.md

@@ -3,7 +3,8 @@
 Grida FX for JavaScript and TypeScript: an SDK to write workflow files and to plan, price and
 run them, and the standalone `grida-fx` command. Grida FX is a workflow engine for generative asset
 pipelines: write a workflow file, and FX plans it, prices it before anything is spent, caches
-every paid call by its request, and records the run. It works with your own provider keys.
+every paid call by its request, and records the run. It works with one Grida Gateway key
+(`GG_API_KEY`), or your own provider keys.
 
 To run FX from a terminal, install the Grida CLI: `npm install -g grida`, then `grida fx --help`.
 It pins this package. Install `@grida/fx` itself for the SDK, or for `grida-fx` on its own (in a

package/dist/documents.d.ts

@@ -159,8 +159,11 @@ export interface RunFinished extends RunEvent {
 }
 /** One instance in {@link Projection}. */
 export interface ProjectedInstance {
-    state: "running" | "succeeded" | "failed" | "skipped";
+    /** `waiting`: started, its paid call waiting for its route's slot (older records never have it). */
+    state: "running" | "waiting" | "succeeded" | "failed" | "skipped";
     path: string;
+    /** Waiting: the route it waits for. */
+    waiting_for?: string | null;
     /** Succeeded: whether its result came from the cache. */
     cache?: "hit" | "miss" | null;
     /** Succeeded: the facts its body reported. */
@@ -188,9 +191,11 @@ export interface Projection {
 export interface InspectedStep {
     id: string;
     path: string;
-    state: "succeeded" | "failed" | "skipped" | "running" | "pending";
+    state: "succeeded" | "failed" | "skipped" | "running" | "waiting" | "pending";
     error?: string;
     cache?: "hit" | "miss";
+    /** Waiting: the route whose slot it waits for. */
+    waiting_for?: string;
     /** Its files, where the run placed them: paths relative to the run folder. */
     files: {
         path: string;

package/dist/engine.js

@@ -31,6 +31,7 @@ export async function call(args, options = {}) {
     // A value inherited from a launcher (a node body run under `grida fx`) would change the prefix.
     env.GRIDA_FX_INVOKER = "grida-fx";
     if (args[0] === "run") {
+        // Also tells the engine the inputs file is temporary: the run records no `repeat`.
         env.GRIDA_FX_CANCEL_SOURCE = "sdk";
     }
     const engine = findEngine(machineLookup(env, cwd));

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  * the engine package for the machine); this package drives it: plan, price and run workflows,
  * read their runs, and write workflow documents.
  */
-export declare const version = "0.3.0";
+export declare const version = "0.5.0";
 export { engineVersion, expand, identity, type InspectOptions, inspect, Plan, PlanRefused, plan, price, project, RunFile, RunResult, type RunValue, run, } from "./api.js";
 export { BINARY_VARIABLE, type BinaryOptions, binary, type Environment } from "./binary.js";
 export { cancel, type CancelOptions, inspectControl, RunControlError, type RunControlResult } from "./control.js";

package/dist/index.js

@@ -3,7 +3,7 @@
  * the engine package for the machine); this package drives it: plan, price and run workflows,
  * read their runs, and write workflow documents.
  */
-export const version = "0.3.0";
+export const version = "0.5.0";
 export { engineVersion, expand, identity, inspect, Plan, PlanRefused, plan, price, project, RunFile, RunResult, run, } from "./api.js";
 export { BINARY_VARIABLE, binary } from "./binary.js";
 export { cancel, inspectControl, RunControlError } from "./control.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grida/fx",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Grida FX for JavaScript: the grida-fx command, and an SDK to build workflows and drive the engine.",
   "keywords": [
     "grida",
@@ -46,10 +46,10 @@
   ],
   "sideEffects": false,
   "optionalDependencies": {
-    "@grida/fx-darwin-arm64": "0.3.0",
-    "@grida/fx-darwin-x64": "0.3.0",
-    "@grida/fx-linux-arm64-gnu": "0.3.0",
-    "@grida/fx-linux-x64-gnu": "0.3.0"
+    "@grida/fx-darwin-arm64": "0.5.0",
+    "@grida/fx-darwin-x64": "0.5.0",
+    "@grida/fx-linux-arm64-gnu": "0.5.0",
+    "@grida/fx-linux-x64-gnu": "0.5.0"
   },
   "publishConfig": {
     "access": "public",