@mokronos/wfkit 0.1.0

package/dist/testing/index.js

@@ -0,0 +1,244 @@
+import { createInMemoryDeterminismState } from "../core.js";
+import { Cancelled } from "../sdk/index.js";
+import { cancelSignalWaits, deliverSignal } from "../signal.js";
+import { ExecutionId } from "../schemas.js";
+const nowIso = () => new Date().toISOString();
+const executionId = () => crypto.randomUUID();
+const parseDurationMs = (duration) => {
+    if (typeof duration === "number") {
+        return duration;
+    }
+    const raw = String(duration).trim();
+    const match = /^(\d+(?:\.\d+)?)\s*([a-zA-Z]+)?$/.exec(raw);
+    if (match === null) {
+        return 0;
+    }
+    const value = Number(match[1]);
+    const unit = (match[2] ?? "millis").toLowerCase();
+    if (unit.startsWith("ms") || unit.startsWith("milli"))
+        return value;
+    if (unit.startsWith("sec"))
+        return value * 1_000;
+    if (unit.startsWith("min"))
+        return value * 60_000;
+    if (unit.startsWith("hour"))
+        return value * 60 * 60_000;
+    if (unit.startsWith("day"))
+        return value * 24 * 60 * 60_000;
+    return value;
+};
+const statusFromEvent = (event) => {
+    switch (event.type) {
+        case "sleep.started":
+        case "signal.waiting":
+            return "suspended";
+        case "sleep.completed":
+        case "signal.received":
+        case "signal.timeout":
+        case "step.started":
+        case "step.completed":
+            return "running";
+        default:
+            return undefined;
+    }
+};
+export const createTestRuntime = (options = {}) => {
+    const timeSkipping = options.timeSkipping ?? true;
+    const executions = new Map();
+    const idempotencyKeys = new Map();
+    const stepMocks = new Map();
+    const failOnce = new Set();
+    const recorders = [];
+    const timers = [];
+    const secrets = new Map();
+    let virtualNow = 0;
+    const secretResolver = {
+        resolve: (name) => {
+            const value = secrets.get(name);
+            if (value === undefined) {
+                throw new Error(`Unknown test secret: ${name} (register it with rt.setSecret)`);
+            }
+            return value;
+        }
+    };
+    const appendHistory = (record, event) => {
+        record.history.push({
+            sequence: record.history.length + 1,
+            createdAt: nowIso(),
+            event
+        });
+        const nextStatus = statusFromEvent(event);
+        if (nextStatus !== undefined && record.status !== "failed") {
+            record.status = nextStatus;
+        }
+        if (event.type === "compensation.started") {
+            for (const recorder of recorders) {
+                recorder.calls.push({ step: event.stepName, result: event.result });
+            }
+        }
+    };
+    const requireExecution = (id) => {
+        const execution = executions.get(id);
+        if (execution === undefined) {
+            throw new Error(`Unknown workflow execution: ${id}`);
+        }
+        return execution;
+    };
+    const makeDelay = (duration) => {
+        if (timeSkipping) {
+            return new Promise((resolve) => setTimeout(resolve, 0));
+        }
+        const due = virtualNow + parseDurationMs(duration);
+        return new Promise((resolve) => {
+            timers.push({ due, resolve });
+        });
+    };
+    const buildStepExecutors = () => {
+        const executors = new Map();
+        const steps = new Set([...stepMocks.keys(), ...failOnce]);
+        for (const step of steps) {
+            executors.set(step, async (input, context) => {
+                if (failOnce.has(step)) {
+                    failOnce.delete(step);
+                    throw new Error(`Injected failure for step ${step.name}`);
+                }
+                const mock = stepMocks.get(step);
+                return mock === undefined
+                    ? step.execute(input, context)
+                    : mock(input, context);
+            });
+        }
+        return executors;
+    };
+    const launch = (workflow, payload, record) => {
+        void workflow.executeInMemory(payload, {
+            executionId: record.executionId,
+            determinism: record.determinism,
+            stepExecutors: buildStepExecutors(),
+            sleep: ({ duration }) => makeDelay(duration),
+            signalTimeout: ({ duration }) => makeDelay(duration),
+            secrets: secretResolver,
+            onEvent: (event) => {
+                appendHistory(record, event);
+            }
+        }).then((value) => {
+            record.status = "completed";
+            record.finishedAt = nowIso();
+            record.result = { type: "completed", value };
+            record.resolveResult(record.result);
+        }, (error) => {
+            record.status = "failed";
+            record.finishedAt = nowIso();
+            record.result = { type: "failed", error };
+            record.resolveResult(record.result);
+        });
+    };
+    const createExecution = (workflow, payload, opts = {}) => {
+        let resolveResult;
+        const resultPromise = new Promise((resolve) => {
+            resolveResult = resolve;
+        });
+        const id = opts.id ?? executionId();
+        const record = {
+            executionId: id,
+            workflow,
+            payload,
+            determinism: opts.determinism ?? createInMemoryDeterminismState(),
+            status: "running",
+            startedAt: nowIso(),
+            history: [],
+            resultPromise,
+            resolveResult
+        };
+        executions.set(id, record);
+        appendHistory(record, {
+            type: "execution.started",
+            executionId: ExecutionId.make(id),
+            workflowName: workflow.name,
+            version: workflow.version,
+            payload,
+            ...(opts.actor === undefined ? {} : { actor: opts.actor })
+        });
+        launch(workflow, payload, record);
+        return record;
+    };
+    return {
+        mockStep(step, impl) {
+            stepMocks.set(step, impl);
+        },
+        failStepOnce(step) {
+            failOnce.add(step);
+        },
+        recordCompensations() {
+            const recorder = { calls: [] };
+            recorders.push(recorder);
+            return recorder;
+        },
+        async start(workflow, payload, opts = {}) {
+            const workflowKey = `${workflow.name}@v${workflow.version}`;
+            if (opts.idempotencyKey !== undefined) {
+                const existingId = idempotencyKeys.get(`${workflowKey}:${opts.idempotencyKey}`);
+                if (existingId !== undefined) {
+                    return { executionId: existingId, version: workflow.version };
+                }
+            }
+            const record = createExecution(workflow, payload, opts.actor === undefined ? {} : { actor: opts.actor });
+            if (opts.idempotencyKey !== undefined) {
+                idempotencyKeys.set(`${workflowKey}:${opts.idempotencyKey}`, record.executionId);
+            }
+            return { executionId: record.executionId, version: workflow.version };
+        },
+        async replay(id, workflow, payload) {
+            const previous = requireExecution(id);
+            const record = createExecution(workflow, payload, {
+                id,
+                determinism: previous.determinism
+            });
+            return { executionId: record.executionId, version: workflow.version };
+        },
+        sendSignal(executionId, name, payload) {
+            return deliverSignal(executionId, name, payload);
+        },
+        result(executionId) {
+            return requireExecution(executionId).resultPromise;
+        },
+        async status(executionId) {
+            return requireExecution(executionId).status;
+        },
+        async history(executionId) {
+            return requireExecution(executionId).history;
+        },
+        async cancel(executionId, opts = {}) {
+            const record = requireExecution(executionId);
+            const compensate = opts.compensate ?? true;
+            appendHistory(record, {
+                type: "execution.cancelled",
+                executionId: ExecutionId.make(executionId),
+                compensate,
+                ...(opts.actor === undefined ? {} : { actor: opts.actor })
+            });
+            if (compensate) {
+                record.status = "compensating";
+            }
+            cancelSignalWaits(executionId, new Cancelled({ compensate }));
+        },
+        setSecret(name, value) {
+            secrets.set(name, value);
+        },
+        async advanceTime(duration) {
+            virtualNow += parseDurationMs(duration);
+            timers.sort((left, right) => left.due - right.due);
+            for (let index = 0; index < timers.length;) {
+                const timer = timers[index];
+                if (timer.due > virtualNow) {
+                    index++;
+                    continue;
+                }
+                timers.splice(index, 1);
+                timer.resolve();
+            }
+            await Promise.resolve();
+        }
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

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

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@mokronos/wfkit",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "The workflow authoring surface — the stable API agents design against.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mokronos/wf.git",
+    "directory": "packages/wf"
+  },
+  "homepage": "https://github.com/mokronos/wf#readme",
+  "bugs": "https://github.com/mokronos/wf/issues",
+  "keywords": [
+    "workflow",
+    "durable-execution",
+    "effect",
+    "bun",
+    "agent"
+  ],
+  "engines": {
+    "bun": ">=1.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "src",
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "wf": "dist/cli/main.js",
+    "wf-integrations": "dist/cli/integrations.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "development": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas.d.ts",
+      "bun": "./src/schemas.ts",
+      "development": "./src/schemas.ts",
+      "default": "./dist/schemas.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "bun": "./src/testing/index.ts",
+      "development": "./src/testing/index.ts",
+      "default": "./dist/testing/index.js"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "@effect/platform-bun": "^4.0.0-beta.93",
+    "@effect/platform-node": "^4.0.0-beta.93",
+    "@effect/sql-sqlite-bun": "^4.0.0-beta.93",
+    "effect": "^4.0.0-beta.93"
+  }
+}

package/src/authoring.ts

@@ -0,0 +1,32 @@
+// Lightweight authoring entrypoint used by workflow source loaders.
+// Keep this free of runtime/sdk imports so workflow modules can be inspected
+// in non-Bun tooling such as the web dashboard dev server.
+export {
+  createInMemoryDeterminismState,
+  defineStep,
+  defineWorkflow,
+  envSecretResolver,
+  isSecretRef,
+  NonDeterminismError,
+  secret
+} from "./core.ts"
+export type {
+  DefinedWorkflow,
+  InMemoryDeterminismState,
+  OrchestrationCall,
+  OrchestrationKind,
+  SecretRef,
+  SecretResolver,
+  SignalOutcome,
+  Step,
+  StepConcurrency,
+  StepContext,
+  StepRetryPolicy,
+  TerminalFailure,
+  WorkflowContext,
+  WorkflowValue
+} from "./core.ts"
+export { defineError } from "./errors.ts"
+export type { WorkflowEvent, WorkflowEventSink } from "./events.ts"
+export { deliverSignal, SignalDeliveryError } from "./signal.ts"
+export { t } from "./schema.ts"

package/src/cli/integrations.ts

@@ -0,0 +1,75 @@
+#!/usr/bin/env bun
+import { BunRuntime, BunServices } from "@effect/platform-bun"
+import { Console, Effect, Option } from "effect"
+import { Argument, Command, Flag } from "effect/unstable/cli"
+import { discover } from "../index.ts"
+import type { IntegrationKind, IntegrationSearchResult } from "../index.ts"
+
+class IntegrationDiscoveryError extends Error {
+  readonly _tag = "IntegrationDiscoveryError"
+  readonly originalError: unknown
+
+  constructor(error: unknown) {
+    super(error instanceof Error ? error.message : "Integration discovery failed")
+    this.name = "IntegrationDiscoveryError"
+    this.originalError = error
+  }
+}
+
+const kind = Flag.choice("kind", ["mcp", "openapi", "graphql", "cli"] as const).pipe(
+  Flag.optional,
+  Flag.withDescription("Limit results to one integration surface kind")
+)
+
+const limit = Flag.integer("limit").pipe(
+  Flag.withDefault(20),
+  Flag.withDescription("Maximum number of results to return")
+)
+
+const searchTerm = Argument.string("search_term").pipe(
+  Argument.withDescription("Service, domain, or integration capability to search for")
+)
+
+const formatKinds = (kinds: ReadonlyArray<IntegrationKind>): string => kinds.join(", ")
+
+const formatResult = (result: IntegrationSearchResult): string =>
+  `${result.domain}\t${formatKinds(result.kinds)}\t${result.description}\t${result.url}`
+
+const discoverCommand = Command.make(
+  "discover",
+  { kind, limit, searchTerm },
+  ({ kind, limit, searchTerm }) =>
+    Effect.tryPromise({
+      try: () => {
+        const selectedKind = Option.getOrUndefined(kind)
+        return discover(searchTerm, {
+          ...(selectedKind === undefined ? {} : { kind: selectedKind }),
+          limit
+        })
+      },
+      catch: (error) => new IntegrationDiscoveryError(error)
+    }).pipe(
+      Effect.flatMap(({ results }) =>
+        Effect.gen(function* () {
+          if (results.length === 0) {
+            yield* Console.log("No integrations found.")
+            return
+          }
+
+          for (const result of results) {
+            yield* Console.log(formatResult(result))
+          }
+        })
+      )
+    )
+).pipe(Command.withDescription("Search integrations.sh for agent-ready integration surfaces"))
+
+const app = Command.make("integrations", {}).pipe(
+  Command.withDescription("Discover public integration surfaces from integrations.sh"),
+  Command.withSubcommands([discoverCommand] as const)
+)
+
+Command.run(app, { version: "0.0.0" }).pipe(
+  Effect.provide(BunServices.layer),
+  BunRuntime.runMain
+)