@superdurable/dex-agents 0.0.0-stage → 0.1.0

package/dist/src/testing/step-history.js

@@ -0,0 +1,59 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/** History event type of a completed `waitFor` method. */
+export const waitForCompletedEvent = "StepWaitForCompleted";
+/** History event type of a completed `execute` method. */
+export const executeCompletedEvent = "StepExecuteCompleted";
+/**
+ * Returns every completed Step method of a Flow's current run, in history order.
+ *
+ * It runs `dexcli flow history --all --output json`, as the Python core's `read_step_history` does. Use
+ * it to assert the Step shape of a turn, such as `RunModel`, `CallTool`, `ResumeTurn`, `RunModel`.
+ * Steps that are still waiting or running are not included.
+ *
+ * @example
+ * ```ts
+ * const executed = (await readStepHistory(engine.serverAddress, sessionId))
+ *   .filter((entry) => entry.eventType === executeCompletedEvent)
+ *   .map((entry) => entry.stepType);
+ * ```
+ * @param serverAddress - Dex Server address.
+ * @param flowId - Flow ID to read.
+ * @param options - `dexcli` path.
+ * @returns One entry per completed `waitFor` or `execute` method.
+ * @throws {Error} When `dexcli` fails or prints unexpected JSON.
+ */
+export async function readStepHistory(serverAddress, flowId, options = {}) {
+    const dexcliPath = options.dexcliPath ?? process.env.DEXCLI ?? "dexcli";
+    const { stdout } = await execFileAsync(dexcliPath, ["flow", "history", flowId, "--server", serverAddress, "--all", "--output", "json"], { maxBuffer: 64 * 1024 * 1024 });
+    const history = JSON.parse(stdout);
+    if (!Array.isArray(history.events)) {
+        throw new Error(`dexcli flow history printed no events for ${flowId}`);
+    }
+    const entries = [];
+    for (const event of history.events) {
+        if (event.type !== waitForCompletedEvent && event.type !== executeCompletedEvent) {
+            continue;
+        }
+        const stepContext = event.payload?.context;
+        if (stepContext === undefined) {
+            throw new Error(`history event ${event.type} of ${flowId} has no Step context`);
+        }
+        entries.push({
+            eventType: event.type,
+            stepType: String(stepContext.stepType),
+            stepExecutionId: String(stepContext.stepExecutionId),
+            finalAttempt: Number(stepContext.finalAttempt),
+        });
+    }
+    return entries;
+}
+//# sourceMappingURL=step-history.js.map

package/dist/src/testing/step-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-history.js","sourceRoot":"","sources":["../../../src/testing/step-history.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;AAC5D,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;AAoB5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,aAAqB,EACrB,MAAc,EACd,UAAkC,EAAE;IAEpC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,QAAQ,CAAC;IACxE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,UAAU,EACV,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,EACnF,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAChC,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAyB,CAAC;IAC3D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,6CAA6C,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAsD,EAAE,CAAC;QACnF,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YACjF,SAAS;QACX,CAAC;QACD,MAAM,WAAW,GAAI,KAAK,CAAC,OAA6D,EAAE,OAAO,CAAC;QAClG,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,CAAC,IAAI,OAAO,MAAM,sBAAsB,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,KAAK,CAAC,IAAI;YACrB,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC;YACtC,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC;YACpD,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@superdurable/dex-agents",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Durable agent sessions for Dex, shared by the Dex TypeScript agent framework adapters",
+  "license": "LicenseRef-Sustainable-Use-1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/superdurable/dex.git",
+    "directory": "agents/typescript/core"
+  },
+  "homepage": "https://github.com/superdurable/dex/tree/main/agents/typescript/core#readme",
+  "bugs": {
+    "url": "https://github.com/superdurable/dex/issues"
+  },
+  "type": "module",
+  "types": "./dist/src/index.d.ts",
+  "engines": {
+    "node": "^22.0.0 || ^24.0.0"
+  },
+  "files": [
+    "dist/src",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./testing": {
+      "types": "./dist/src/testing/index.d.ts",
+      "import": "./dist/src/testing/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test:integration": "npm run build && node --test --test-concurrency=1 --test-timeout=240000 'dist/test/integ/*.integration.test.js'"
+  },
+  "peerDependencies": {
+    "@superdurable/dex": "1.30.0"
+  },
+  "devDependencies": {
+    "@superdurable/dex": "1.30.0",
+    "@types/node": "22.20.5",
+    "typescript": "5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}