@pumped-fn/agent-sdk-test 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License Copyright (c) 2025 Duke
+
+Permission is hereby granted, free of
+charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice
+(including the next paragraph) shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,16 @@
+# @pumped-fn/agent-sdk-test
+
+In-memory test helpers for `@pumped-fn/agent-sdk`.
+
+Use `kit()` to install the agent workflow extensions with a `MemoryWorkflowLog`. The helper keeps the normal pumped-fn seam: tests still exercise public APIs through `createScope({ presets, tags, extensions })`.
+
+```ts
+import { createScope } from "@pumped-fn/lite"
+import { kit } from "@pumped-fn/agent-sdk-test"
+
+const { extensions, log } = kit()
+const scope = createScope({ extensions })
+const ctx = scope.createContext()
+```
+
+`localRemoteRunner` executes remote-tagged steps in process for tests. `MemoryWorkflowLog` implements the same `RunLog` contract used by `inspect()`.

package/dist/index.cjs

@@ -0,0 +1,58 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _pumped_fn_agent_sdk = require("@pumped-fn/agent-sdk");
+let _pumped_fn_lite_extension_suspense = require("@pumped-fn/lite-extension-suspense");
+//#region src/index.ts
+var MemorySuspenseLog = class {
+	store = /* @__PURE__ */ new Map();
+	async get(key) {
+		return this.store.get((0, _pumped_fn_lite_extension_suspense.formatSuspenseStepKey)(key));
+	}
+	async putPending(entry) {
+		this.store.set((0, _pumped_fn_lite_extension_suspense.formatSuspenseStepKey)(entry.key), entry);
+	}
+	async putCompleted(entry) {
+		this.store.set((0, _pumped_fn_lite_extension_suspense.formatSuspenseStepKey)(entry.key), entry);
+	}
+	async resolve(key, value) {
+		const current = this.store.get((0, _pumped_fn_lite_extension_suspense.formatSuspenseStepKey)(key));
+		if (!current || current.status !== "pending") throw new Error(`Pending step "${(0, _pumped_fn_lite_extension_suspense.formatSuspenseStepKey)(key)}" not found`);
+		this.store.set((0, _pumped_fn_lite_extension_suspense.formatSuspenseStepKey)(key), {
+			status: "resolved",
+			key,
+			targetName: current.targetName,
+			value
+		});
+	}
+	entries(query = {}) {
+		return [...this.store.values()].filter((entry) => (query.taskId === void 0 || entry.key.taskId === query.taskId) && (query.runId === void 0 || entry.key.runId === query.runId));
+	}
+};
+var MemoryWorkflowLog = class extends MemorySuspenseLog {};
+const localRemoteRunner = { run: (_event, next) => next() };
+function suspense(options = {}) {
+	const log = options.log ?? new MemorySuspenseLog();
+	return {
+		log,
+		extension: (0, _pumped_fn_lite_extension_suspense.extension)({
+			...options,
+			log
+		})
+	};
+}
+function kit(options = {}) {
+	const log = options.log ?? new MemoryWorkflowLog();
+	return {
+		log,
+		extensions: [(0, _pumped_fn_agent_sdk.workflowExtension)({
+			log,
+			defaultTaskId: options.defaultTaskId,
+			defaultRunId: options.defaultRunId
+		}), (0, _pumped_fn_agent_sdk.extension)({ remoteRunner: options.remoteRunner ?? localRemoteRunner })]
+	};
+}
+//#endregion
+exports.MemorySuspenseLog = MemorySuspenseLog;
+exports.MemoryWorkflowLog = MemoryWorkflowLog;
+exports.kit = kit;
+exports.localRemoteRunner = localRemoteRunner;
+exports.suspense = suspense;

package/dist/index.d.cts

@@ -0,0 +1,34 @@
+import { ExtensionOptions, RemoteRunner, RunLog, RunQuery, WorkflowEventLog, WorkflowExtensionOptions } from "@pumped-fn/agent-sdk";
+import { SuspenseEventLog, SuspenseExtensionOptions, SuspenseStepEntry, SuspenseStepKey } from "@pumped-fn/lite-extension-suspense";
+import { Lite } from "@pumped-fn/lite";
+
+//#region src/index.d.ts
+declare class MemorySuspenseLog implements SuspenseEventLog {
+  private readonly store;
+  get(key: SuspenseStepKey): Promise<SuspenseStepEntry | undefined>;
+  putPending(entry: Extract<SuspenseStepEntry, {
+    status: "pending";
+  }>): Promise<void>;
+  putCompleted(entry: Extract<SuspenseStepEntry, {
+    status: "completed";
+  }>): Promise<void>;
+  resolve(key: SuspenseStepKey, value: unknown): Promise<void>;
+  entries(query?: Partial<RunQuery>): SuspenseStepEntry[];
+}
+declare class MemoryWorkflowLog extends MemorySuspenseLog implements WorkflowEventLog, RunLog {}
+declare const localRemoteRunner: RemoteRunner;
+declare function suspense(options?: Omit<SuspenseExtensionOptions, "log"> & {
+  log?: SuspenseEventLog;
+}): {
+  extension: Lite.Extension;
+  log: SuspenseEventLog;
+};
+declare function kit(options?: ExtensionOptions & Omit<WorkflowExtensionOptions, "log"> & {
+  log?: RunLog;
+}): {
+  extensions: Lite.Extension[];
+  log: RunLog;
+};
+//#endregion
+export { MemorySuspenseLog, MemoryWorkflowLog, kit, localRemoteRunner, suspense };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;cAoBa,iBAAA,YAA6B,gBAAA;EAAA,iBACvB,KAAA;EAEX,GAAA,CAAI,GAAA,EAAK,eAAA,GAAkB,OAAA,CAAQ,iBAAA;EAInC,UAAA,CAAW,KAAA,EAAO,OAAA,CAAQ,iBAAA;IAAqB,MAAA;EAAA,KAAuB,OAAA;EAItE,YAAA,CAAa,KAAA,EAAO,OAAA,CAAQ,iBAAA;IAAqB,MAAA;EAAA,KAAyB,OAAA;EAI1E,OAAA,CAAQ,GAAA,EAAK,eAAA,EAAiB,KAAA,YAAiB,OAAA;EAWrD,OAAA,CAAQ,KAAA,GAAO,OAAA,CAAQ,QAAA,IAAiB,iBAAA;AAAA;AAAA,cAQ7B,iBAAA,SAA0B,iBAAA,YAA6B,gBAAA,EAAkB,MAAA;AAAA,cAEzE,iBAAA,EAAmB,YAE/B;AAAA,iBAEe,QAAA,CACd,OAAA,GAAS,IAAA,CAAK,wBAAA;EAAqC,GAAA,GAAM,gBAAA;AAAA;EACtD,SAAA,EAAW,IAAA,CAAK,SAAA;EAAW,GAAA,EAAK,gBAAA;AAAA;AAAA,iBAWrB,GAAA,CACd,OAAA,GAAS,gBAAA,GAAmB,IAAA,CAAK,wBAAA;EAAqC,GAAA,GAAM,MAAA;AAAA;EACzE,UAAA,EAAY,IAAA,CAAK,SAAA;EAAa,GAAA,EAAK,MAAA;AAAA"}

package/dist/index.d.mts

@@ -0,0 +1,34 @@
+import { ExtensionOptions, RemoteRunner, RunLog, RunQuery, WorkflowEventLog, WorkflowExtensionOptions } from "@pumped-fn/agent-sdk";
+import { SuspenseEventLog, SuspenseExtensionOptions, SuspenseStepEntry, SuspenseStepKey } from "@pumped-fn/lite-extension-suspense";
+import { Lite } from "@pumped-fn/lite";
+
+//#region src/index.d.ts
+declare class MemorySuspenseLog implements SuspenseEventLog {
+  private readonly store;
+  get(key: SuspenseStepKey): Promise<SuspenseStepEntry | undefined>;
+  putPending(entry: Extract<SuspenseStepEntry, {
+    status: "pending";
+  }>): Promise<void>;
+  putCompleted(entry: Extract<SuspenseStepEntry, {
+    status: "completed";
+  }>): Promise<void>;
+  resolve(key: SuspenseStepKey, value: unknown): Promise<void>;
+  entries(query?: Partial<RunQuery>): SuspenseStepEntry[];
+}
+declare class MemoryWorkflowLog extends MemorySuspenseLog implements WorkflowEventLog, RunLog {}
+declare const localRemoteRunner: RemoteRunner;
+declare function suspense(options?: Omit<SuspenseExtensionOptions, "log"> & {
+  log?: SuspenseEventLog;
+}): {
+  extension: Lite.Extension;
+  log: SuspenseEventLog;
+};
+declare function kit(options?: ExtensionOptions & Omit<WorkflowExtensionOptions, "log"> & {
+  log?: RunLog;
+}): {
+  extensions: Lite.Extension[];
+  log: RunLog;
+};
+//#endregion
+export { MemorySuspenseLog, MemoryWorkflowLog, kit, localRemoteRunner, suspense };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;cAoBa,iBAAA,YAA6B,gBAAA;EAAA,iBACvB,KAAA;EAEX,GAAA,CAAI,GAAA,EAAK,eAAA,GAAkB,OAAA,CAAQ,iBAAA;EAInC,UAAA,CAAW,KAAA,EAAO,OAAA,CAAQ,iBAAA;IAAqB,MAAA;EAAA,KAAuB,OAAA;EAItE,YAAA,CAAa,KAAA,EAAO,OAAA,CAAQ,iBAAA;IAAqB,MAAA;EAAA,KAAyB,OAAA;EAI1E,OAAA,CAAQ,GAAA,EAAK,eAAA,EAAiB,KAAA,YAAiB,OAAA;EAWrD,OAAA,CAAQ,KAAA,GAAO,OAAA,CAAQ,QAAA,IAAiB,iBAAA;AAAA;AAAA,cAQ7B,iBAAA,SAA0B,iBAAA,YAA6B,gBAAA,EAAkB,MAAA;AAAA,cAEzE,iBAAA,EAAmB,YAE/B;AAAA,iBAEe,QAAA,CACd,OAAA,GAAS,IAAA,CAAK,wBAAA;EAAqC,GAAA,GAAM,gBAAA;AAAA;EACtD,SAAA,EAAW,IAAA,CAAK,SAAA;EAAW,GAAA,EAAK,gBAAA;AAAA;AAAA,iBAWrB,GAAA,CACd,OAAA,GAAS,gBAAA,GAAmB,IAAA,CAAK,wBAAA;EAAqC,GAAA,GAAM,MAAA;AAAA;EACzE,UAAA,EAAY,IAAA,CAAK,SAAA;EAAa,GAAA,EAAK,MAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,55 @@
+import { extension, workflowExtension } from "@pumped-fn/agent-sdk";
+import { extension as extension$1, formatSuspenseStepKey } from "@pumped-fn/lite-extension-suspense";
+//#region src/index.ts
+var MemorySuspenseLog = class {
+	store = /* @__PURE__ */ new Map();
+	async get(key) {
+		return this.store.get(formatSuspenseStepKey(key));
+	}
+	async putPending(entry) {
+		this.store.set(formatSuspenseStepKey(entry.key), entry);
+	}
+	async putCompleted(entry) {
+		this.store.set(formatSuspenseStepKey(entry.key), entry);
+	}
+	async resolve(key, value) {
+		const current = this.store.get(formatSuspenseStepKey(key));
+		if (!current || current.status !== "pending") throw new Error(`Pending step "${formatSuspenseStepKey(key)}" not found`);
+		this.store.set(formatSuspenseStepKey(key), {
+			status: "resolved",
+			key,
+			targetName: current.targetName,
+			value
+		});
+	}
+	entries(query = {}) {
+		return [...this.store.values()].filter((entry) => (query.taskId === void 0 || entry.key.taskId === query.taskId) && (query.runId === void 0 || entry.key.runId === query.runId));
+	}
+};
+var MemoryWorkflowLog = class extends MemorySuspenseLog {};
+const localRemoteRunner = { run: (_event, next) => next() };
+function suspense(options = {}) {
+	const log = options.log ?? new MemorySuspenseLog();
+	return {
+		log,
+		extension: extension$1({
+			...options,
+			log
+		})
+	};
+}
+function kit(options = {}) {
+	const log = options.log ?? new MemoryWorkflowLog();
+	return {
+		log,
+		extensions: [workflowExtension({
+			log,
+			defaultTaskId: options.defaultTaskId,
+			defaultRunId: options.defaultRunId
+		}), extension({ remoteRunner: options.remoteRunner ?? localRemoteRunner })]
+	};
+}
+//#endregion
+export { MemorySuspenseLog, MemoryWorkflowLog, kit, localRemoteRunner, suspense };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["suspenseExtension","agentExtension"],"sources":["../src/index.ts"],"sourcesContent":["import {\n  extension as agentExtension,\n  workflowExtension,\n  type ExtensionOptions,\n  type RemoteRunner,\n  type RunLog,\n  type RunQuery,\n  type WorkflowEventLog,\n  type WorkflowExtensionOptions,\n} from \"@pumped-fn/agent-sdk\"\nimport {\n  extension as suspenseExtension,\n  formatSuspenseStepKey,\n  type SuspenseEventLog,\n  type SuspenseExtensionOptions,\n  type SuspenseStepEntry,\n  type SuspenseStepKey,\n} from \"@pumped-fn/lite-extension-suspense\"\nimport type { Lite } from \"@pumped-fn/lite\"\n\nexport class MemorySuspenseLog implements SuspenseEventLog {\n  private readonly store = new Map<string, SuspenseStepEntry>()\n\n  async get(key: SuspenseStepKey): Promise<SuspenseStepEntry | undefined> {\n    return this.store.get(formatSuspenseStepKey(key))\n  }\n\n  async putPending(entry: Extract<SuspenseStepEntry, { status: \"pending\" }>): Promise<void> {\n    this.store.set(formatSuspenseStepKey(entry.key), entry)\n  }\n\n  async putCompleted(entry: Extract<SuspenseStepEntry, { status: \"completed\" }>): Promise<void> {\n    this.store.set(formatSuspenseStepKey(entry.key), entry)\n  }\n\n  async resolve(key: SuspenseStepKey, value: unknown): Promise<void> {\n    const current = this.store.get(formatSuspenseStepKey(key))\n    if (!current || current.status !== \"pending\") throw new Error(`Pending step \"${formatSuspenseStepKey(key)}\" not found`)\n    this.store.set(formatSuspenseStepKey(key), {\n      status: \"resolved\",\n      key,\n      targetName: current.targetName,\n      value,\n    })\n  }\n\n  entries(query: Partial<RunQuery> = {}): SuspenseStepEntry[] {\n    return [...this.store.values()].filter((entry) =>\n      (query.taskId === undefined || entry.key.taskId === query.taskId) &&\n      (query.runId === undefined || entry.key.runId === query.runId)\n    )\n  }\n}\n\nexport class MemoryWorkflowLog extends MemorySuspenseLog implements WorkflowEventLog, RunLog {}\n\nexport const localRemoteRunner: RemoteRunner = {\n  run: (_event, next) => next(),\n}\n\nexport function suspense(\n  options: Omit<SuspenseExtensionOptions, \"log\"> & { log?: SuspenseEventLog } = {}\n): { extension: Lite.Extension; log: SuspenseEventLog } {\n  const log = options.log ?? new MemorySuspenseLog()\n  return {\n    log,\n    extension: suspenseExtension({\n      ...options,\n      log,\n    }),\n  }\n}\n\nexport function kit(\n  options: ExtensionOptions & Omit<WorkflowExtensionOptions, \"log\"> & { log?: RunLog } = {}\n): { extensions: Lite.Extension[]; log: RunLog } {\n  const log = options.log ?? new MemoryWorkflowLog()\n  return {\n    log,\n    extensions: [\n      workflowExtension({\n        log,\n        defaultTaskId: options.defaultTaskId,\n        defaultRunId: options.defaultRunId,\n      }),\n      agentExtension({\n        remoteRunner: options.remoteRunner ?? localRemoteRunner,\n      }),\n    ],\n  }\n}\n"],"mappings":";;;AAoBA,IAAa,oBAAb,MAA2D;CACzD,wBAAyB,IAAI,IAA+B;CAE5D,MAAM,IAAI,KAA8D;EACtE,OAAO,KAAK,MAAM,IAAI,sBAAsB,GAAG,CAAC;CAClD;CAEA,MAAM,WAAW,OAAyE;EACxF,KAAK,MAAM,IAAI,sBAAsB,MAAM,GAAG,GAAG,KAAK;CACxD;CAEA,MAAM,aAAa,OAA2E;EAC5F,KAAK,MAAM,IAAI,sBAAsB,MAAM,GAAG,GAAG,KAAK;CACxD;CAEA,MAAM,QAAQ,KAAsB,OAA+B;EACjE,MAAM,UAAU,KAAK,MAAM,IAAI,sBAAsB,GAAG,CAAC;EACzD,IAAI,CAAC,WAAW,QAAQ,WAAW,WAAW,MAAM,IAAI,MAAM,iBAAiB,sBAAsB,GAAG,EAAE,YAAY;EACtH,KAAK,MAAM,IAAI,sBAAsB,GAAG,GAAG;GACzC,QAAQ;GACR;GACA,YAAY,QAAQ;GACpB;EACF,CAAC;CACH;CAEA,QAAQ,QAA2B,CAAC,GAAwB;EAC1D,OAAO,CAAC,GAAG,KAAK,MAAM,OAAO,CAAC,EAAE,QAAQ,WACrC,MAAM,WAAW,KAAA,KAAa,MAAM,IAAI,WAAW,MAAM,YACzD,MAAM,UAAU,KAAA,KAAa,MAAM,IAAI,UAAU,MAAM,MAC1D;CACF;AACF;AAEA,IAAa,oBAAb,cAAuC,kBAAsD,CAAC;AAE9F,MAAa,oBAAkC,EAC7C,MAAM,QAAQ,SAAS,KAAK,EAC9B;AAEA,SAAgB,SACd,UAA8E,CAAC,GACzB;CACtD,MAAM,MAAM,QAAQ,OAAO,IAAI,kBAAkB;CACjD,OAAO;EACL;EACA,WAAWA,YAAkB;GAC3B,GAAG;GACH;EACF,CAAC;CACH;AACF;AAEA,SAAgB,IACd,UAAuF,CAAC,GACzC;CAC/C,MAAM,MAAM,QAAQ,OAAO,IAAI,kBAAkB;CACjD,OAAO;EACL;EACA,YAAY,CACV,kBAAkB;GAChB;GACA,eAAe,QAAQ;GACvB,cAAc,QAAQ;EACxB,CAAC,GACDC,UAAe,EACb,cAAc,QAAQ,gBAAgB,kBACxC,CAAC,CACH;CACF;AACF"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@pumped-fn/agent-sdk-test",
+  "version": "1.0.0",
+  "private": false,
+  "description": "In-memory test helpers for @pumped-fn/agent-sdk",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown --config-loader tsx",
+    "typecheck": "tsgo --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "@pumped-fn/agent-sdk": "^1.0.0",
+    "@pumped-fn/lite": "^3.1.0"
+  },
+  "dependencies": {
+    "@pumped-fn/lite-extension-suspense": "workspace:^"
+  },
+  "devDependencies": {
+    "@pumped-fn/agent-sdk": "workspace:*",
+    "@pumped-fn/lite": "workspace:*",
+    "@types/node": "catalog:",
+    "@typescript/native-preview": "catalog:",
+    "tsdown": "catalog:",
+    "typescript": "catalog:",
+    "vite": "catalog:",
+    "vitest": "catalog:"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "directory": "packages/agent-sdk-test",
+    "url": "git+https://github.com/pumped-fn/pumped-fn.git"
+  }
+}