@arke-institute/klados-testing 0.1.2 → 0.3.0

package/dist/entities.d.ts

@@ -24,6 +24,8 @@ export declare function getEntity(id: string): Promise<Entity>;
 /**
  * Delete an entity
  *
+ * Fetches the entity tip first for CAS protection, then deletes.
+ *
  * @param id - Entity ID to delete
  */
 export declare function deleteEntity(id: string): Promise<void>;

package/dist/entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../src/entities.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAWhF;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3D;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,UAAU,CAAC,CAMrB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAK7B"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../src/entities.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAWhF;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3D;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,UAAU,CAAC,CAMrB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAK7B"}

package/dist/entities.js

@@ -35,10 +35,17 @@ export async function getEntity(id) {
 /**
  * Delete an entity
  *
+ * Fetches the entity tip first for CAS protection, then deletes.
+ *
  * @param id - Entity ID to delete
  */
 export async function deleteEntity(id) {
-    await apiRequest('DELETE', `/entities/${id}`);
+    // Get current tip for CAS
+    const tip = await apiRequest('GET', `/entities/${id}/tip`);
+    // Delete with expect_tip
+    await apiRequest('DELETE', `/entities/${id}`, {
+        expect_tip: tip.cid,
+    });
 }
 /**
  * Create a new collection

package/dist/entities.js.map

@@ -1 +1 @@
-{"version":3,"file":"entities.js","sourceRoot":"","sources":["../src/entities.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,IAAI,GAA4B;QACpC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;IAEF,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IACzC,CAAC;IAED,OAAO,UAAU,CAAS,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAU;IACxC,OAAO,UAAU,CAAS,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAU;IAC3C,MAAM,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAgC;IAEhC,OAAO,UAAU,CAAa,MAAM,EAAE,cAAc,EAAE;QACpD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,aAAa,EAAE,OAAO,CAAC,YAAY;KACpC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAAoB;IAEpB,OAAO,UAAU,CACf,KAAK,EACL,gBAAgB,YAAY,WAAW,CACxC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../src/entities.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,IAAI,GAA4B;QACpC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;IAEF,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IACzC,CAAC;IAED,OAAO,UAAU,CAAS,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAU;IACxC,OAAO,UAAU,CAAS,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAU;IAC3C,0BAA0B;IAC1B,MAAM,GAAG,GAAG,MAAM,UAAU,CAAkB,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAE5E,yBAAyB;IACzB,MAAM,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE;QAC5C,UAAU,EAAE,GAAG,CAAC,GAAG;KACpB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAgC;IAEhC,OAAO,UAAU,CAAa,MAAM,EAAE,cAAc,EAAE;QACpD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,aAAa,EAAE,OAAO,CAAC,YAAY;KACpC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAAoB;IAEpB,OAAO,UAAU,CACf,KAAK,EACL,gBAAgB,YAAY,WAAW,CACxC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -53,8 +53,10 @@
  */
 export { configureTestClient, getConfig, resetTestClient, apiRequest, sleep, log } from './client.js';
 export { createEntity, getEntity, deleteEntity, createCollection, getCollectionEntities } from './entities.js';
-export { getKladosLog, getFirstLogFromCollection, waitForKladosLog, getLogMessages, getLogEntry } from './logs.js';
+export { getKladosLog, getFirstLogFromCollection, waitForKladosLog, getLogMessages, getLogEntry, getLogChildren, buildWorkflowTree, waitForWorkflowTree, } from './logs.js';
 export { invokeKlados } from './invoke.js';
+export { invokeRhiza, createRhiza, getWorkflowLogs, waitForWorkflowCompletion, assertWorkflowCompleted, assertWorkflowPath, } from './workflows.js';
 export { assertLogCompleted, assertLogFailed, assertLogHasMessages, assertLogMessageCount, assertLogHasHandoff, } from './assertions.js';
-export type { TestConfig, Entity, Collection, CollectionEntities, InvokeResult, LogMessage, KladosLogEntry, CreateEntityOptions, CreateCollectionOptions, InvokeKladosOptions, WaitForLogOptions, LogMessageCriteria, } from './types.js';
+export type { TestConfig, Entity, Collection, CollectionEntities, InvokeResult, LogMessage, KladosLogEntry, CreateEntityOptions, CreateCollectionOptions, InvokeKladosOptions, WaitForLogOptions, LogMessageCriteria, LogTreeNode, WorkflowLogTree, WaitForWorkflowTreeOptions, } from './types.js';
+export type { InvokeRhizaOptions, InvokeRhizaResult, WorkflowCompletionResult, CreateRhizaOptions, FlowStep, ThenSpec, } from './workflows.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAGH,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAGtG,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAG/G,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGnH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,UAAU,EACV,MAAM,EACN,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAGH,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAGtG,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAG/G,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,WAAW,EAEX,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,UAAU,EACV,MAAM,EACN,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAElB,WAAW,EACX,eAAe,EACf,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,QAAQ,EACR,QAAQ,GACT,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -56,9 +56,13 @@ export { configureTestClient, getConfig, resetTestClient, apiRequest, sleep, log
 // Entity operations
 export { createEntity, getEntity, deleteEntity, createCollection, getCollectionEntities } from './entities.js';
 // Log utilities
-export { getKladosLog, getFirstLogFromCollection, waitForKladosLog, getLogMessages, getLogEntry } from './logs.js';
+export { getKladosLog, getFirstLogFromCollection, waitForKladosLog, getLogMessages, getLogEntry, 
+// Tree-based traversal
+getLogChildren, buildWorkflowTree, waitForWorkflowTree, } from './logs.js';
 // Klados invocation
 export { invokeKlados } from './invoke.js';
+// Workflow utilities
+export { invokeRhiza, createRhiza, getWorkflowLogs, waitForWorkflowCompletion, assertWorkflowCompleted, assertWorkflowPath, } from './workflows.js';
 // Assertions
 export { assertLogCompleted, assertLogFailed, assertLogHasMessages, assertLogMessageCount, assertLogHasHandoff, } from './assertions.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,gBAAgB;AAChB,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEtG,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE/G,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnH,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,aAAa;AACb,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,gBAAgB;AAChB,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEtG,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE/G,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,WAAW;AACX,uBAAuB;AACvB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,qBAAqB;AACrB,OAAO,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,aAAa;AACb,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/invoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../src/invoke.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAwBvB"}
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../src/invoke.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC,CA2BvB"}

package/dist/invoke.js

@@ -26,9 +26,11 @@ import { apiRequest } from './client.js';
 export async function invokeKlados(options) {
     const body = {
         target_collection: options.targetCollection,
-        job_collection: options.jobCollection,
         confirm: options.confirm ?? true,
     };
+    if (options.jobCollection) {
+        body.job_collection = options.jobCollection;
+    }
     if (options.targetEntity) {
         body.target_entity = options.targetEntity;
     }

package/dist/invoke.js.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../src/invoke.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA4B;IAE5B,MAAM,IAAI,GAA4B;QACpC,iBAAiB,EAAE,OAAO,CAAC,gBAAgB;QAC3C,cAAc,EAAE,OAAO,CAAC,aAAa;QACrC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;KACjC,CAAC;IAEF,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAChD,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,OAAO,UAAU,CACf,MAAM,EACN,WAAW,OAAO,CAAC,QAAQ,SAAS,EACpC,IAAI,CACL,CAAC;AACJ,CAAC"}
+{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../src/invoke.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA4B;IAE5B,MAAM,IAAI,GAA4B;QACpC,iBAAiB,EAAE,OAAO,CAAC,gBAAgB;QAC3C,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;KACjC,CAAC;IAEF,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAC9C,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAChD,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,OAAO,UAAU,CACf,MAAM,EACN,WAAW,OAAO,CAAC,QAAQ,SAAS,EACpC,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/logs.d.ts

@@ -1,7 +1,9 @@
 /**
  * Klados log utilities for testing
+ *
+ * Includes tree-based traversal for multi-step workflows and scatter/gather operations.
  */
-import type { KladosLogEntry, WaitForLogOptions } from './types.js';
+import type { KladosLogEntry, WaitForLogOptions, WorkflowLogTree, WaitForWorkflowTreeOptions } from './types.js';
 /**
  * Get a klados log entry by ID
  *
@@ -85,4 +87,77 @@ export declare function getLogEntry(log: KladosLogEntry): {
         retryable: boolean;
     };
 };
+/**
+ * Get children of a log by querying for outgoing sent_to relationships
+ *
+ * In the Rhiza log tree:
+ * - Parents have `sent_to` outgoing relationships pointing to children
+ * - Children have `received_from` outgoing relationships pointing to parents
+ * - We use `sent_to` for traversal since it's an outgoing relationship (no indexing lag)
+ *
+ * @param logEntityId - Log entity ID to find children of
+ * @returns Array of child log entity IDs
+ */
+export declare function getLogChildren(logEntityId: string): Promise<string[]>;
+/**
+ * Build a snapshot of the workflow log tree
+ *
+ * This traverses the log tree starting from the first_log relationship
+ * on the job collection, following incoming received_from relationships
+ * to discover all logs in the workflow.
+ *
+ * @example
+ * ```typescript
+ * const tree = await buildWorkflowTree(jobCollectionId);
+ *
+ * if (tree.isComplete) {
+ *   console.log('Workflow finished with', tree.logs.size, 'logs');
+ *   if (tree.hasErrors) {
+ *     console.log('Errors:', tree.errors);
+ *   }
+ * }
+ * ```
+ *
+ * @param jobCollectionId - Job collection ID
+ * @returns Current state of the workflow log tree
+ */
+export declare function buildWorkflowTree(jobCollectionId: string): Promise<WorkflowLogTree>;
+/**
+ * Wait for a workflow to complete by polling the log tree
+ *
+ * This function properly handles:
+ * - Multi-step workflows (A → B → C)
+ * - Scatter operations (A → [B1, B2, B3])
+ * - Nested scatters
+ * - Gather operations
+ * - Mixed success/error branches
+ *
+ * Unlike `waitForKladosLog` which only checks the first log, this function
+ * traverses the entire log tree and waits for ALL branches to complete.
+ *
+ * @example
+ * ```typescript
+ * // Wait for a scatter workflow to complete
+ * const tree = await waitForWorkflowTree(jobCollectionId, {
+ *   timeout: 60000,
+ *   pollInterval: 2000,
+ * });
+ *
+ * if (tree.isComplete) {
+ *   console.log('All', tree.logs.size, 'logs completed');
+ *   if (tree.hasErrors) {
+ *     console.log('Some branches failed:', tree.errors);
+ *   } else {
+ *     console.log('Workflow succeeded!');
+ *   }
+ * } else {
+ *   console.log('Workflow timed out');
+ * }
+ * ```
+ *
+ * @param jobCollectionId - Job collection ID
+ * @param options - Wait options
+ * @returns Final state of the workflow log tree
+ */
+export declare function waitForWorkflowTree(jobCollectionId: string, options?: WaitForWorkflowTreeOptions): Promise<WorkflowLogTree>;
 //# sourceMappingURL=logs.d.ts.map

package/dist/logs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAU,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE5E;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAEzE;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA0BhC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,qCAEjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc;;;;;;;;qBAvB1B,CAAC;uBAGlB,CAAH;;iBAOU,CAAC;aAA2B,CAAC;;;;;;;;;;cAaD,CAAC;aAC1B,CAAC;;;;;;;EACd"}
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAEV,cAAc,EACd,iBAAiB,EAEjB,eAAe,EACf,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAEzE;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA0BhC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,qCAEjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc;;;;;;;;qBA7BQ,CAAC;uBAC9C,CAAH;;iBAEoC,CAAC;aAEtC,CAAA;;;;;;;;;;cAgBW,CAAC;aAClB,CAAC;;;;;;;EASA;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiB3E;AAiJD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,iBAAiB,CACrC,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,CAAC,CAoE1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,eAAe,CAAC,CAqC1B"}

package/dist/logs.js

@@ -1,5 +1,7 @@
 /**
  * Klados log utilities for testing
+ *
+ * Includes tree-based traversal for multi-step workflows and scatter/gather operations.
  */
 import { apiRequest, sleep } from './client.js';
 /**
@@ -89,4 +91,307 @@ export function getLogMessages(log) {
 export function getLogEntry(log) {
     return log.properties.log_data.entry;
 }
+// =============================================================================
+// Log Tree Traversal
+// =============================================================================
+/**
+ * Get children of a log by querying for outgoing sent_to relationships
+ *
+ * In the Rhiza log tree:
+ * - Parents have `sent_to` outgoing relationships pointing to children
+ * - Children have `received_from` outgoing relationships pointing to parents
+ * - We use `sent_to` for traversal since it's an outgoing relationship (no indexing lag)
+ *
+ * @param logEntityId - Log entity ID to find children of
+ * @returns Array of child log entity IDs
+ */
+export async function getLogChildren(logEntityId) {
+    try {
+        const entity = await apiRequest('GET', `/entities/${logEntityId}`);
+        // Look for outgoing sent_to relationships
+        // (this log has sent_to pointing to its children)
+        const childIds = entity.relationships
+            ?.filter((r) => r.predicate === 'sent_to' && r.direction === 'outgoing')
+            .map((r) => r.peer) ?? [];
+        return childIds;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Calculate expected children count from handoffs
+ *
+ * The testing package uses handoff types: 'invoke' | 'scatter' | 'complete' | 'error' | 'none'
+ * - 'invoke': Creates 1 child (pass operation)
+ * - 'scatter': Creates N children (tracked via job_id, not invocations array in testing types)
+ * - 'complete': No children (workflow done)
+ * - 'error': No children (error state)
+ * - 'none': No children (no handoff)
+ *
+ * @param log - Log entry to analyze
+ * @returns Number of expected children
+ */
+function getExpectedChildrenCount(log) {
+    const entry = log.properties.log_data.entry;
+    const handoffs = entry.handoffs ?? [];
+    if (handoffs.length === 0) {
+        return 0; // No handoffs = leaf node
+    }
+    let total = 0;
+    for (const handoff of handoffs) {
+        if (handoff.type === 'invoke') {
+            // Invoke/pass creates 1 child
+            total += 1;
+        }
+        else if (handoff.type === 'scatter') {
+            // Scatter creates N children
+            // In the testing types, we don't have invocations array,
+            // so we rely on discovering children via relationships
+            // For now, mark as expecting at least 1 child
+            total += 1; // Will discover actual count via relationships
+        }
+        // 'complete', 'error', 'none' = 0 children
+    }
+    return total;
+}
+/**
+ * Build a log tree node recursively
+ *
+ * @param logEntityId - Entity ID of the log
+ * @param logsMap - Map to collect all discovered logs
+ * @param visited - Set of visited log IDs to prevent cycles
+ */
+async function buildTreeNode(logEntityId, logsMap, visited) {
+    if (visited.has(logEntityId)) {
+        // Prevent infinite loops on malformed data
+        const existingLog = logsMap.get(logEntityId);
+        if (existingLog) {
+            return {
+                log: existingLog,
+                children: [],
+                isLeaf: true,
+                isTerminal: existingLog.properties.status === 'done' ||
+                    existingLog.properties.status === 'error',
+                expectedChildren: 0,
+            };
+        }
+        return null;
+    }
+    visited.add(logEntityId);
+    // Fetch the log entry
+    let log;
+    try {
+        log = await getKladosLog(logEntityId);
+        logsMap.set(logEntityId, log);
+    }
+    catch {
+        // Log doesn't exist yet or fetch failed
+        return null;
+    }
+    const isTerminal = log.properties.status === 'done' || log.properties.status === 'error';
+    const expectedChildren = getExpectedChildrenCount(log);
+    // Find children via incoming relationships
+    const childIds = await getLogChildren(logEntityId);
+    // Recursively build child nodes
+    const children = [];
+    for (const childId of childIds) {
+        const childNode = await buildTreeNode(childId, logsMap, visited);
+        if (childNode) {
+            children.push(childNode);
+        }
+    }
+    // A node is a leaf if it's terminal AND has no expected children
+    // OR if it has error status (errors stop the branch)
+    const isLeaf = log.properties.status === 'error' ||
+        (isTerminal && expectedChildren === 0);
+    return {
+        log,
+        children,
+        isLeaf,
+        isTerminal,
+        expectedChildren,
+    };
+}
+/**
+ * Collect all leaf nodes from a tree
+ */
+function collectLeaves(node) {
+    if (node.children.length === 0) {
+        return [node];
+    }
+    return node.children.flatMap(collectLeaves);
+}
+/**
+ * Check if all expected children have been discovered in the tree
+ *
+ * For scatter operations, we can't know the exact count from the testing types,
+ * so we check if we have at least the minimum expected and all discovered children
+ * are themselves complete.
+ */
+function checkAllChildrenDiscovered(node) {
+    // If node is running, children may not exist yet
+    if (!node.isTerminal) {
+        return true; // Can't verify yet, assume OK for now
+    }
+    // If we expect children but have none, not complete
+    if (node.expectedChildren > 0 && node.children.length === 0) {
+        return false;
+    }
+    // Recursively check all children
+    return node.children.every(checkAllChildrenDiscovered);
+}
+/**
+ * Build a snapshot of the workflow log tree
+ *
+ * This traverses the log tree starting from the first_log relationship
+ * on the job collection, following incoming received_from relationships
+ * to discover all logs in the workflow.
+ *
+ * @example
+ * ```typescript
+ * const tree = await buildWorkflowTree(jobCollectionId);
+ *
+ * if (tree.isComplete) {
+ *   console.log('Workflow finished with', tree.logs.size, 'logs');
+ *   if (tree.hasErrors) {
+ *     console.log('Errors:', tree.errors);
+ *   }
+ * }
+ * ```
+ *
+ * @param jobCollectionId - Job collection ID
+ * @returns Current state of the workflow log tree
+ */
+export async function buildWorkflowTree(jobCollectionId) {
+    const logsMap = new Map();
+    const visited = new Set();
+    // Find root via first_log relationship
+    const firstLogId = await getFirstLogFromCollection(jobCollectionId);
+    if (!firstLogId) {
+        return {
+            root: null,
+            logs: logsMap,
+            isComplete: false,
+            hasErrors: false,
+            leaves: [],
+            errors: [],
+            allChildrenDiscovered: false,
+        };
+    }
+    // Build tree starting from root
+    const root = await buildTreeNode(firstLogId, logsMap, visited);
+    if (!root) {
+        return {
+            root: null,
+            logs: logsMap,
+            isComplete: false,
+            hasErrors: false,
+            leaves: [],
+            errors: [],
+            allChildrenDiscovered: false,
+        };
+    }
+    // Collect leaves and analyze tree
+    const leaves = collectLeaves(root);
+    const allChildrenDiscovered = checkAllChildrenDiscovered(root);
+    // Workflow is complete when:
+    // 1. All leaves are terminal (done or error)
+    // 2. All expected children have been discovered
+    const allLeavesTerminal = leaves.every((leaf) => leaf.isTerminal);
+    const isComplete = allLeavesTerminal && allChildrenDiscovered;
+    // Collect errors
+    const errors = [];
+    for (const log of logsMap.values()) {
+        if (log.properties.status === 'error') {
+            const entry = log.properties.log_data.entry;
+            if (entry.error) {
+                errors.push({
+                    logId: log.id,
+                    kladosId: log.properties.klados_id,
+                    error: entry.error,
+                });
+            }
+        }
+    }
+    return {
+        root,
+        logs: logsMap,
+        isComplete,
+        hasErrors: errors.length > 0,
+        leaves,
+        errors,
+        allChildrenDiscovered,
+    };
+}
+/**
+ * Wait for a workflow to complete by polling the log tree
+ *
+ * This function properly handles:
+ * - Multi-step workflows (A → B → C)
+ * - Scatter operations (A → [B1, B2, B3])
+ * - Nested scatters
+ * - Gather operations
+ * - Mixed success/error branches
+ *
+ * Unlike `waitForKladosLog` which only checks the first log, this function
+ * traverses the entire log tree and waits for ALL branches to complete.
+ *
+ * @example
+ * ```typescript
+ * // Wait for a scatter workflow to complete
+ * const tree = await waitForWorkflowTree(jobCollectionId, {
+ *   timeout: 60000,
+ *   pollInterval: 2000,
+ * });
+ *
+ * if (tree.isComplete) {
+ *   console.log('All', tree.logs.size, 'logs completed');
+ *   if (tree.hasErrors) {
+ *     console.log('Some branches failed:', tree.errors);
+ *   } else {
+ *     console.log('Workflow succeeded!');
+ *   }
+ * } else {
+ *   console.log('Workflow timed out');
+ * }
+ * ```
+ *
+ * @param jobCollectionId - Job collection ID
+ * @param options - Wait options
+ * @returns Final state of the workflow log tree
+ */
+export async function waitForWorkflowTree(jobCollectionId, options) {
+    const timeout = options?.timeout ?? 30000;
+    const pollInterval = options?.pollInterval ?? 2000;
+    const startTime = Date.now();
+    let lastTree = {
+        root: null,
+        logs: new Map(),
+        isComplete: false,
+        hasErrors: false,
+        leaves: [],
+        errors: [],
+        allChildrenDiscovered: false,
+    };
+    while (Date.now() - startTime < timeout) {
+        try {
+            const tree = await buildWorkflowTree(jobCollectionId);
+            lastTree = tree;
+            // Call optional progress callback
+            if (options?.onPoll) {
+                options.onPoll(tree, Date.now() - startTime);
+            }
+            if (tree.isComplete) {
+                return tree;
+            }
+        }
+        catch {
+            // Ignore errors during polling, just retry
+        }
+        await sleep(pollInterval);
+    }
+    // Timeout - return last known state
+    return lastTree;
+}
 //# sourceMappingURL=logs.js.map

package/dist/logs.js.map

@@ -1 +1 @@
-{"version":3,"file":"logs.js","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGhD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa;IAC9C,OAAO,UAAU,CAAiB,KAAK,EAAE,aAAa,KAAK,EAAE,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,YAAoB;IAEpB,MAAM,UAAU,GAAG,MAAM,UAAU,CAAS,KAAK,EAAE,aAAa,YAAY,EAAE,CAAC,CAAC;IAEhF,kCAAkC;IAClC,MAAM,WAAW,GAAG,UAAU,CAAC,aAAa,EAAE,IAAI,CAChD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,WAAW,CACnC,CAAC;IAEF,OAAO,WAAW,EAAE,IAAI,IAAI,IAAI,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,eAAuB,EACvB,OAA2B;IAE3B,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC;IAC1C,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,oDAAoD;YACpD,MAAM,UAAU,GAAG,MAAM,yBAAyB,CAAC,eAAe,CAAC,CAAC;YAEpE,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;gBAC3C,0CAA0C;gBAC1C,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBAC1E,OAAO,GAAG,CAAC;gBACb,CAAC;gBACD,iDAAiD;YACnD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;QAED,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAmB;IAChD,OAAO,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAmB;IAC7C,OAAO,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;AACvC,CAAC"}
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -148,8 +148,8 @@ export interface InvokeKladosOptions {
     targetEntity?: string;
     /** Multiple entities to process (for cardinality: 'many') */
     targetEntities?: string[];
-    /** Job collection for logs */
-    jobCollection: string;
+    /** Job collection for logs (optional - API creates one if not provided) */
+    jobCollection?: string;
     /** Execute (true) or preview (false) */
     confirm?: boolean;
     /** Optional input data */
@@ -164,6 +164,59 @@ export interface WaitForLogOptions {
     /** Poll interval in milliseconds (default: 1000) */
     pollInterval?: number;
 }
+/**
+ * A node in the workflow log tree
+ */
+export interface LogTreeNode {
+    /** The log entry at this node */
+    log: KladosLogEntry;
+    /** Child nodes (logs that have this log in their from_logs) */
+    children: LogTreeNode[];
+    /** Whether this node is a leaf (no children expected) */
+    isLeaf: boolean;
+    /** Whether this log is terminal (done or error) */
+    isTerminal: boolean;
+    /** Number of expected children based on handoffs (may differ from actual) */
+    expectedChildren: number;
+}
+/**
+ * Result of building/traversing a workflow log tree
+ */
+export interface WorkflowLogTree {
+    /** Root log node (found via first_log relationship) */
+    root: LogTreeNode | null;
+    /** All discovered logs indexed by entity ID */
+    logs: Map<string, KladosLogEntry>;
+    /** Whether the entire workflow has completed (all branches terminal) */
+    isComplete: boolean;
+    /** Whether any branch has errors */
+    hasErrors: boolean;
+    /** All leaf nodes in the tree */
+    leaves: LogTreeNode[];
+    /** All errors in the tree */
+    errors: Array<{
+        logId: string;
+        kladosId: string;
+        error: {
+            code: string;
+            message: string;
+            retryable: boolean;
+        };
+    }>;
+    /** Whether all expected children have been discovered */
+    allChildrenDiscovered: boolean;
+}
+/**
+ * Options for waiting for workflow tree completion
+ */
+export interface WaitForWorkflowTreeOptions {
+    /** Maximum time to wait in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Poll interval in milliseconds (default: 2000) */
+    pollInterval?: number;
+    /** Callback for each poll iteration (for debugging/logging) */
+    onPoll?: (tree: WorkflowLogTree, elapsed: number) => void;
+}
 /**
  * Criteria for matching a log message
  */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAMD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;KACrC,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,sBAAsB,CAAC;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;QACrC,QAAQ,EAAE;YACR,QAAQ,EAAE,MAAM,CAAC;YACjB,aAAa,EAAE,MAAM,CAAC;YACtB,KAAK,EAAE;gBACL,EAAE,EAAE,MAAM,CAAC;gBACX,MAAM,EAAE,MAAM,CAAC;gBACf,SAAS,EAAE,MAAM,CAAC;gBAClB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;gBACrC,UAAU,EAAE,MAAM,CAAC;gBACnB,YAAY,CAAC,EAAE,MAAM,CAAC;gBACtB,QAAQ,EAAE;oBACR,aAAa,CAAC,EAAE,MAAM,CAAC;oBACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;oBAC3B,iBAAiB,EAAE,MAAM,CAAC;oBAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;oBACrB,KAAK,CAAC,EAAE;wBACN,OAAO,EAAE,MAAM,CAAC;wBAChB,QAAQ,EAAE,MAAM,CAAC;wBACjB,KAAK,EAAE,MAAM,CAAC;wBACd,KAAK,EAAE,MAAM,CAAC;qBACf,CAAC;iBACH,CAAC;gBACF,QAAQ,CAAC,EAAE,KAAK,CAAC;oBACf,MAAM,EAAE,MAAM,CAAC;oBACf,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;oBAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;oBAChB,KAAK,CAAC,EAAE,MAAM,CAAC;iBAChB,CAAC,CAAC;gBACH,KAAK,CAAC,EAAE;oBACN,IAAI,EAAE,MAAM,CAAC;oBACb,OAAO,EAAE,MAAM,CAAC;oBAChB,SAAS,EAAE,OAAO,CAAC;iBACpB,CAAC;aACH,CAAC;YACF,QAAQ,EAAE,UAAU,EAAE,CAAC;SACxB,CAAC;KACH,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,GAAG,EAAE,cAAc,CAAC;IACpB,+DAA+D;IAC/D,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAC;IAChB,mDAAmD;IACnD,UAAU,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,+CAA+C;IAC/C,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAClC,wEAAwE;IACxE,UAAU,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,6BAA6B;IAC7B,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC;KAC9D,CAAC,CAAC;IACH,yDAAyD;IACzD,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACjD,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/workflows.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Rhiza workflow utilities for testing
+ *
+ * These utilities help test complete workflow compositions by:
+ * - Invoking rhiza workflows
+ * - Polling for workflow completion across multiple steps
+ * - Retrieving all logs from a workflow execution
+ */
+import type { KladosLogEntry, WaitForLogOptions } from './types.js';
+/**
+ * Options for invoking a rhiza workflow
+ */
+export interface InvokeRhizaOptions {
+    /** Rhiza ID to invoke */
+    rhizaId: string;
+    /** Collection for permission scope (required) */
+    targetCollection: string;
+    /** Single entity to process (for entry klados with cardinality: 'one') */
+    targetEntity?: string;
+    /** Multiple entities to process (for entry klados with cardinality: 'many') */
+    targetEntities?: string[];
+    /** Job collection for logs (optional - API creates one if not provided) */
+    jobCollection?: string;
+    /** Execute (true) or preview (false) */
+    confirm?: boolean;
+    /** Optional input data passed to entry klados */
+    input?: Record<string, unknown>;
+}
+/**
+ * Result of invoking a rhiza workflow
+ */
+export interface InvokeRhizaResult {
+    status: 'started' | 'rejected' | 'pending_confirmation';
+    job_id?: string;
+    job_collection?: string;
+    rhiza_id?: string;
+    error?: string;
+    message?: string;
+}
+/**
+ * Result of waiting for workflow completion
+ */
+export interface WorkflowCompletionResult {
+    /** Overall workflow status */
+    status: 'done' | 'error' | 'timeout';
+    /** All klados log entries from the workflow */
+    logs: KladosLogEntry[];
+    /** Final output entity IDs (from last step) */
+    finalOutputs: string[];
+    /** Error message if status is 'error' */
+    error?: string;
+}
+/**
+ * Options for creating a rhiza entity
+ *
+ * Uses step-based flow format where:
+ * - entry is a step name (string)
+ * - flow keys are step names
+ * - each step has { klados: { pi: string }, then: ThenSpec }
+ * - ThenSpec targets are step names (strings)
+ */
+export interface CreateRhizaOptions {
+    /** Display label for the rhiza */
+    label: string;
+    /** Description of what this workflow does */
+    description?: string;
+    /** Version string */
+    version: string;
+    /** Entry step name (first step in workflow) */
+    entry: string;
+    /** Flow definition - maps step names to their klados and handoff specs */
+    flow: Record<string, FlowStep>;
+    /** Collection to store the rhiza entity */
+    collectionId: string;
+}
+/**
+ * A step in the workflow flow definition
+ */
+export interface FlowStep {
+    /** Which klados to invoke for this step */
+    klados: {
+        pi: string;
+        type?: string;
+    };
+    /** What happens after this step completes */
+    then: ThenSpec;
+}
+/**
+ * Handoff specification for a workflow step
+ * Targets are step names (strings), not klados IDs
+ */
+export type ThenSpec = {
+    done: true;
+} | {
+    pass: string;
+    route?: unknown[];
+} | {
+    scatter: string;
+    route?: unknown[];
+} | {
+    gather: string;
+    route?: unknown[];
+};
+/**
+ * Invoke a rhiza workflow
+ *
+ * @example
+ * ```typescript
+ * const result = await invokeRhiza({
+ *   rhizaId: 'rhiza_abc123',
+ *   targetEntity: entity.id,
+ *   targetCollection: collection.id,
+ *   jobCollection: jobCollection.id,
+ *   confirm: true,
+ * });
+ *
+ * if (result.status === 'started') {
+ *   console.log('Workflow started:', result.job_id);
+ * }
+ * ```
+ *
+ * @param options - Invocation options
+ * @returns The invocation result
+ */
+export declare function invokeRhiza(options: InvokeRhizaOptions): Promise<InvokeRhizaResult>;
+/**
+ * Create a rhiza workflow entity on the Arke network
+ *
+ * Uses step-based format where step names are the flow keys
+ * and the same klados can be used in multiple steps.
+ *
+ * @example
+ * ```typescript
+ * const rhiza = await createRhiza({
+ *   label: 'Stamp Chain',
+ *   version: '2.0',
+ *   entry: 'first_stamp',
+ *   flow: {
+ *     'first_stamp': { klados: { pi: 'klados_stamp' }, then: { pass: 'second_stamp' } },
+ *     'second_stamp': { klados: { pi: 'klados_stamp' }, then: { done: true } },
+ *   },
+ *   collectionId: collection.id,
+ * });
+ * ```
+ *
+ * @param options - Rhiza creation options
+ * @returns The created rhiza entity
+ */
+export declare function createRhiza(options: CreateRhizaOptions): Promise<{
+    id: string;
+}>;
+/**
+ * Get all klados log entities from a job collection
+ *
+ * Queries the collection for all klados_log type entities.
+ * All workflow logs are stored in the same job collection.
+ *
+ * @param jobCollectionId - Job collection ID
+ * @returns Array of klados log entries
+ */
+export declare function getWorkflowLogs(jobCollectionId: string): Promise<KladosLogEntry[]>;
+/**
+ * Wait for a rhiza workflow to complete
+ *
+ * Polls the job collection until all logs are in terminal state (done or error).
+ * For simple workflows, this waits for the expected number of steps.
+ * For scatter workflows, this waits for all scattered invocations plus gather.
+ *
+ * @example
+ * ```typescript
+ * const result = await waitForWorkflowCompletion(jobCollection.id, {
+ *   timeout: 60000,
+ *   pollInterval: 2000,
+ *   expectedSteps: 2,  // For a 2-step chain
+ * });
+ *
+ * if (result.status === 'done') {
+ *   console.log('Workflow completed with', result.logs.length, 'steps');
+ * }
+ * ```
+ *
+ * @param jobCollectionId - Job collection ID
+ * @param options - Wait options
+ * @returns Workflow completion result
+ */
+export declare function waitForWorkflowCompletion(jobCollectionId: string, options?: WaitForLogOptions & {
+    expectedSteps?: number;
+}): Promise<WorkflowCompletionResult>;
+/**
+ * Assert that a workflow completed successfully with the expected number of steps
+ *
+ * @param result - Workflow completion result
+ * @param expectedSteps - Expected number of klados steps
+ * @throws Error if workflow failed or wrong number of steps
+ */
+export declare function assertWorkflowCompleted(result: WorkflowCompletionResult, expectedSteps?: number): void;
+/**
+ * Assert that logs show the expected workflow path (klados execution order)
+ *
+ * @param logs - Array of klados log entries
+ * @param expectedPath - Expected klados IDs in execution order
+ */
+export declare function assertWorkflowPath(logs: KladosLogEntry[], expectedPath: string[]): void;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/workflows.d.ts.map

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

package/dist/workflows.js

@@ -0,0 +1,256 @@
+/**
+ * Rhiza workflow utilities for testing
+ *
+ * These utilities help test complete workflow compositions by:
+ * - Invoking rhiza workflows
+ * - Polling for workflow completion across multiple steps
+ * - Retrieving all logs from a workflow execution
+ */
+import { apiRequest, sleep } from './client.js';
+// =============================================================================
+// Rhiza Invocation
+// =============================================================================
+/**
+ * Invoke a rhiza workflow
+ *
+ * @example
+ * ```typescript
+ * const result = await invokeRhiza({
+ *   rhizaId: 'rhiza_abc123',
+ *   targetEntity: entity.id,
+ *   targetCollection: collection.id,
+ *   jobCollection: jobCollection.id,
+ *   confirm: true,
+ * });
+ *
+ * if (result.status === 'started') {
+ *   console.log('Workflow started:', result.job_id);
+ * }
+ * ```
+ *
+ * @param options - Invocation options
+ * @returns The invocation result
+ */
+export async function invokeRhiza(options) {
+    const body = {
+        target_collection: options.targetCollection,
+        confirm: options.confirm ?? true,
+    };
+    if (options.jobCollection) {
+        body.job_collection = options.jobCollection;
+    }
+    if (options.targetEntity) {
+        body.target_entity = options.targetEntity;
+    }
+    if (options.targetEntities) {
+        body.target_entities = options.targetEntities;
+    }
+    if (options.input) {
+        body.input = options.input;
+    }
+    return apiRequest('POST', `/rhizai/${options.rhizaId}/invoke`, body);
+}
+// =============================================================================
+// Rhiza Creation
+// =============================================================================
+/**
+ * Create a rhiza workflow entity on the Arke network
+ *
+ * Uses step-based format where step names are the flow keys
+ * and the same klados can be used in multiple steps.
+ *
+ * @example
+ * ```typescript
+ * const rhiza = await createRhiza({
+ *   label: 'Stamp Chain',
+ *   version: '2.0',
+ *   entry: 'first_stamp',
+ *   flow: {
+ *     'first_stamp': { klados: { pi: 'klados_stamp' }, then: { pass: 'second_stamp' } },
+ *     'second_stamp': { klados: { pi: 'klados_stamp' }, then: { done: true } },
+ *   },
+ *   collectionId: collection.id,
+ * });
+ * ```
+ *
+ * @param options - Rhiza creation options
+ * @returns The created rhiza entity
+ */
+export async function createRhiza(options) {
+    const properties = {
+        label: options.label,
+        version: options.version,
+        status: 'active',
+        // Entry is now a step name (string), not an EntityRef
+        entry: options.entry,
+        // Flow is passed through directly - already in the correct format
+        flow: options.flow,
+    };
+    if (options.description) {
+        properties.description = options.description;
+    }
+    const result = await apiRequest('POST', '/entities', {
+        type: 'rhiza',
+        properties,
+        collection_id: options.collectionId,
+    });
+    return result;
+}
+// =============================================================================
+// Workflow Logs
+// =============================================================================
+/**
+ * Get all klados log entities from a job collection
+ *
+ * Queries the collection for all klados_log type entities.
+ * All workflow logs are stored in the same job collection.
+ *
+ * @param jobCollectionId - Job collection ID
+ * @returns Array of klados log entries
+ */
+export async function getWorkflowLogs(jobCollectionId) {
+    // Query collection for all klados_log entities
+    const response = await apiRequest('GET', `/collections/${jobCollectionId}/entities?type=klados_log`);
+    if (!response.entities?.length) {
+        return [];
+    }
+    // Fetch full entity details for each log
+    const logs = [];
+    for (const entity of response.entities) {
+        try {
+            const log = await apiRequest('GET', `/entities/${entity.pi}`);
+            logs.push(log);
+        }
+        catch {
+            // Log may not exist yet or fetch failed, skip
+        }
+    }
+    return logs;
+}
+/**
+ * Wait for a rhiza workflow to complete
+ *
+ * Polls the job collection until all logs are in terminal state (done or error).
+ * For simple workflows, this waits for the expected number of steps.
+ * For scatter workflows, this waits for all scattered invocations plus gather.
+ *
+ * @example
+ * ```typescript
+ * const result = await waitForWorkflowCompletion(jobCollection.id, {
+ *   timeout: 60000,
+ *   pollInterval: 2000,
+ *   expectedSteps: 2,  // For a 2-step chain
+ * });
+ *
+ * if (result.status === 'done') {
+ *   console.log('Workflow completed with', result.logs.length, 'steps');
+ * }
+ * ```
+ *
+ * @param jobCollectionId - Job collection ID
+ * @param options - Wait options
+ * @returns Workflow completion result
+ */
+export async function waitForWorkflowCompletion(jobCollectionId, options) {
+    const timeout = options?.timeout ?? 30000;
+    const pollInterval = options?.pollInterval ?? 2000;
+    const expectedSteps = options?.expectedSteps;
+    const startTime = Date.now();
+    let lastLogs = [];
+    while (Date.now() - startTime < timeout) {
+        try {
+            const logs = await getWorkflowLogs(jobCollectionId);
+            lastLogs = logs;
+            // Check if we have any logs
+            if (logs.length === 0) {
+                await sleep(pollInterval);
+                continue;
+            }
+            // Check if all logs are in terminal state
+            const allTerminal = logs.every((log) => log.properties.status === 'done' || log.properties.status === 'error');
+            // Check if we have the expected number of steps (if specified)
+            const hasExpectedSteps = expectedSteps
+                ? logs.length >= expectedSteps
+                : true;
+            if (allTerminal && hasExpectedSteps) {
+                // Check if any log has error status
+                const hasError = logs.some((log) => log.properties.status === 'error');
+                // Get final outputs from the last step (by completion time)
+                const sortedLogs = [...logs].sort((a, b) => {
+                    const aTime = a.properties.log_data.entry.completed_at ?? '';
+                    const bTime = b.properties.log_data.entry.completed_at ?? '';
+                    return aTime.localeCompare(bTime);
+                });
+                const lastLog = sortedLogs[sortedLogs.length - 1];
+                const finalOutputs = lastLog?.properties.log_data.entry.handoffs
+                    ?.filter((h) => h.type === 'complete' || h.type === 'invoke')
+                    .flatMap(() => []) ?? [];
+                return {
+                    status: hasError ? 'error' : 'done',
+                    logs,
+                    finalOutputs,
+                    error: hasError
+                        ? logs.find((l) => l.properties.status === 'error')?.properties
+                            .log_data.entry.error?.message
+                        : undefined,
+                };
+            }
+        }
+        catch {
+            // Ignore errors during polling, just retry
+        }
+        await sleep(pollInterval);
+    }
+    // Timeout
+    return {
+        status: 'timeout',
+        logs: lastLogs,
+        finalOutputs: [],
+        error: `Workflow did not complete within ${timeout}ms`,
+    };
+}
+// =============================================================================
+// Assertions
+// =============================================================================
+/**
+ * Assert that a workflow completed successfully with the expected number of steps
+ *
+ * @param result - Workflow completion result
+ * @param expectedSteps - Expected number of klados steps
+ * @throws Error if workflow failed or wrong number of steps
+ */
+export function assertWorkflowCompleted(result, expectedSteps) {
+    if (result.status === 'timeout') {
+        throw new Error(`Workflow timed out. Got ${result.logs.length} logs, ` +
+            `statuses: ${result.logs.map((l) => l.properties.status).join(', ')}`);
+    }
+    if (result.status === 'error') {
+        throw new Error(`Workflow failed: ${result.error}`);
+    }
+    if (expectedSteps !== undefined && result.logs.length !== expectedSteps) {
+        throw new Error(`Expected ${expectedSteps} workflow steps, got ${result.logs.length}`);
+    }
+}
+/**
+ * Assert that logs show the expected workflow path (klados execution order)
+ *
+ * @param logs - Array of klados log entries
+ * @param expectedPath - Expected klados IDs in execution order
+ */
+export function assertWorkflowPath(logs, expectedPath) {
+    // Sort by start time
+    const sortedLogs = [...logs].sort((a, b) => {
+        const aTime = a.properties.log_data.entry.started_at;
+        const bTime = b.properties.log_data.entry.started_at;
+        return aTime.localeCompare(bTime);
+    });
+    const actualPath = sortedLogs.map((l) => l.properties.klados_id);
+    const match = actualPath.length === expectedPath.length &&
+        actualPath.every((id, i) => id === expectedPath[i]);
+    if (!match) {
+        throw new Error(`Workflow path mismatch.\n` +
+            `Expected: ${expectedPath.join(' → ')}\n` +
+            `Actual:   ${actualPath.join(' → ')}`);
+    }
+}
+//# sourceMappingURL=workflows.js.map

package/dist/workflows.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arke-institute/klados-testing",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "description": "Test utilities for klados workers on the Arke network",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,7 +21,7 @@
     "clean": "rm -rf dist"
   },
   "peerDependencies": {
-    "@arke-institute/sdk": "^2.9.0"
+    "@arke-institute/sdk": "^3.0.0"
   },
   "peerDependenciesMeta": {
     "@arke-institute/sdk": {
@@ -29,7 +29,7 @@
     }
   },
   "devDependencies": {
-    "@arke-institute/sdk": "^2.9.0",
+    "@arke-institute/sdk": "^3.0.0",
     "typescript": "^5.7.2"
   },
   "keywords": [