@mokronos/wfkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sebastian Hirt
+
+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 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,57 @@
+# @mokronos/wfkit
+
+@mokronos/wfkit is the Bun-first SDK for authoring and running durable workflows in plain TypeScript. Workflows have typed inputs, outputs, and errors; the engine (built on `@effect/workflow`) persists every step result, timer, and signal wait in SQLite, so executions replay deterministically and survive process restarts.
+
+```sh
+bun add @mokronos/wfkit
+```
+
+```ts
+import { defineStep, defineWorkflow, run, t } from "@mokronos/wfkit"
+
+const printMessage = defineStep({
+  name: "PrintMessage",
+  input: t.struct({ message: t.string }),
+  output: t.void,
+  execute: async (input) => {
+    console.log(input.message)
+  }
+})
+
+export const HelloWorkflow = defineWorkflow({
+  name: "HelloWorkflow",
+  version: 1,
+  input: t.struct({ message: t.string }),
+  output: t.void,
+  run: function* (input, ctx) {
+    yield* ctx.run(printMessage, {
+      message: input.message.trim()
+    })
+  }
+})
+
+run(HelloWorkflow, { message: "hello from @mokronos/wfkit" })
+```
+
+Subpath exports: `@mokronos/wfkit/schemas` (shared Effect schemas) and `@mokronos/wfkit/testing` (test helpers).
+
+## CLI
+
+```sh
+bun add -g @mokronos/wfkit
+```
+
+This installs the `wf` binary:
+
+```sh
+wf create <workflow-id> [--name <workflow-name>] [--source <typescript>] [--file <path>] [--version <version>] [--force]
+wf list
+wf runs
+wf history <execution-id>
+wf run <workflow-id> [json-input]
+wf signal <run-id> <signal-name> [json-payload] [--actor <actor>]
+```
+
+CLI state lives in `.wf/wf.sqlite`; durable engine state lives in `.wf/engine.sqlite`.
+
+Bun is the supported runtime. Source and documentation live at https://github.com/mokronos/wf.

package/dist/authoring.d.ts

@@ -0,0 +1,7 @@
+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";
+//# sourceMappingURL=authoring.d.ts.map

package/dist/authoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.d.ts","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,8BAA8B,EAC9B,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,MAAM,EACP,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,eAAe,EACf,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,aAAa,EACb,IAAI,EACJ,eAAe,EACf,WAAW,EACX,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACd,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,aAAa,CAAA"}

package/dist/authoring.js

@@ -0,0 +1,8 @@
+// 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.js";
+export { defineError } from "./errors.js";
+export { deliverSignal, SignalDeliveryError } from "./signal.js";
+export { t } from "./schema.js";
+//# sourceMappingURL=authoring.js.map

package/dist/authoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.js","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,6EAA6E;AAC7E,2DAA2D;AAC3D,OAAO,EACL,8BAA8B,EAC9B,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,MAAM,EACP,MAAM,WAAW,CAAA;AAiBlB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,aAAa,CAAA"}

package/dist/cli/integrations.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=integrations.d.ts.map

package/dist/cli/integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../src/cli/integrations.ts"],"names":[],"mappings":""}

package/dist/cli/integrations.js

@@ -0,0 +1,40 @@
+#!/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.js";
+class IntegrationDiscoveryError extends Error {
+    _tag = "IntegrationDiscoveryError";
+    originalError;
+    constructor(error) {
+        super(error instanceof Error ? error.message : "Integration discovery failed");
+        this.name = "IntegrationDiscoveryError";
+        this.originalError = error;
+    }
+}
+const kind = Flag.choice("kind", ["mcp", "openapi", "graphql", "cli"]).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) => kinds.join(", ");
+const formatResult = (result) => `${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]));
+Command.run(app, { version: "0.0.0" }).pipe(Effect.provide(BunServices.layer), BunRuntime.runMain);
+//# sourceMappingURL=integrations.js.map

package/dist/cli/integrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.js","sourceRoot":"","sources":["../../src/cli/integrations.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAGtC,MAAM,yBAA0B,SAAQ,KAAK;IAClC,IAAI,GAAG,2BAA2B,CAAA;IAClC,aAAa,CAAS;IAE/B,YAAY,KAAc;QACxB,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAA;QAC9E,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;QACvC,IAAI,CAAC,aAAa,GAAG,KAAK,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAU,CAAC,CAAC,IAAI,CAClF,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,eAAe,CAAC,+CAA+C,CAAC,CACtE,CAAA;AAED,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CACtC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,EACpB,IAAI,CAAC,eAAe,CAAC,qCAAqC,CAAC,CAC5D,CAAA;AAED,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CACpD,QAAQ,CAAC,eAAe,CAAC,0DAA0D,CAAC,CACrF,CAAA;AAED,MAAM,WAAW,GAAG,CAAC,KAAqC,EAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEvF,MAAM,YAAY,GAAG,CAAC,MAA+B,EAAU,EAAE,CAC/D,GAAG,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,GAAG,EAAE,CAAA;AAExF,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAClC,UAAU,EACV,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAC3B,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAC9B,MAAM,CAAC,UAAU,CAAC;IAChB,GAAG,EAAE,GAAG,EAAE;QACR,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;QAChD,OAAO,QAAQ,CAAC,UAAU,EAAE;YAC1B,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAC7D,KAAK;SACN,CAAC,CAAA;IACJ,CAAC;IACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,yBAAyB,CAAC,KAAK,CAAC;CACvD,CAAC,CAAC,IAAI,CACL,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAC7B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAA;QAC5C,OAAM;IACR,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC,CAAC,CACH,CACF,CACJ,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,6DAA6D,CAAC,CAAC,CAAA;AAE9F,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,CAC/C,OAAO,CAAC,eAAe,CAAC,2DAA2D,CAAC,EACpF,OAAO,CAAC,eAAe,CAAC,CAAC,eAAe,CAAU,CAAC,CACpD,CAAA;AAED,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CACzC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,EACjC,UAAU,CAAC,OAAO,CACnB,CAAA"}

package/dist/cli/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":""}