@redtuma/core 0.1.0

package/dist/workflows/index.js

@@ -0,0 +1,199 @@
+import { RuntimeContext } from "../types.js";
+import { noopLogger } from "../logger.js";
+
+//#region src/workflows/index.ts
+function createStep(config) {
+	return { ...config };
+}
+var SuspendSignal = class {
+	constructor(stepId, payload) {
+		this.stepId = stepId;
+		this.payload = payload;
+	}
+};
+var Workflow = class {
+	id;
+	nodes = [];
+	committed = false;
+	logger = noopLogger;
+	constructor(config) {
+		this.config = config;
+		this.id = config.id;
+	}
+	then(step) {
+		this.nodes.push({
+			kind: "step",
+			step
+		});
+		return this;
+	}
+	parallel(steps) {
+		this.nodes.push({
+			kind: "parallel",
+			steps
+		});
+		return this;
+	}
+	branch(branches) {
+		this.nodes.push({
+			kind: "branch",
+			branches
+		});
+		return this;
+	}
+	dountil(step, condition) {
+		this.nodes.push({
+			kind: "dountil",
+			step,
+			condition
+		});
+		return this;
+	}
+	foreach(step) {
+		this.nodes.push({
+			kind: "foreach",
+			step
+		});
+		return this;
+	}
+	map(fn) {
+		this.nodes.push({
+			kind: "map",
+			fn
+		});
+		return this;
+	}
+	commit() {
+		this.committed = true;
+		return this;
+	}
+	createRun() {
+		if (!this.committed) throw new Error(`Workflow "${this.id}" must be committed with .commit() before running.`);
+		return new Run(this.id, this.nodes);
+	}
+};
+var Run = class {
+	snapshot = null;
+	constructor(workflowId, nodes) {
+		this.workflowId = workflowId;
+		this.nodes = nodes;
+	}
+	async start(args) {
+		const runtimeContext = args.runtimeContext ?? new RuntimeContext();
+		return this.execute(0, args.inputData, {}, runtimeContext, void 0);
+	}
+	async resume(args) {
+		if (!this.snapshot) throw new Error("Cannot resume: workflow is not suspended.");
+		if (this.snapshot.suspendedStepId !== args.step) throw new Error(`Cannot resume step "${args.step}": suspended step is "${this.snapshot.suspendedStepId}".`);
+		const { nodeIndex, input, results } = this.snapshot;
+		const runtimeContext = args.runtimeContext ?? new RuntimeContext();
+		this.snapshot = null;
+		return this.execute(nodeIndex, input, results, runtimeContext, args.resumeData);
+	}
+	async execute(startIndex, initialInput, results, runtimeContext, resumeData) {
+		let input = initialInput;
+		const getStepResult = (id) => results[id];
+		for (let i = startIndex; i < this.nodes.length; i++) {
+			const node = this.nodes[i];
+			const isResumeTarget = resumeData !== void 0 && i === startIndex;
+			const ctxBase = {
+				runtimeContext,
+				getStepResult
+			};
+			try {
+				switch (node.kind) {
+					case "step":
+						input = await this.runStep(node.step, input, ctxBase, isResumeTarget ? resumeData : void 0);
+						results[node.step.id] = input;
+						break;
+					case "parallel": {
+						const out = await Promise.all(node.steps.map((s) => this.runStep(s, input, ctxBase, void 0)));
+						const merged = {};
+						node.steps.forEach((s, idx) => {
+							results[s.id] = out[idx];
+							merged[s.id] = out[idx];
+						});
+						input = merged;
+						break;
+					}
+					case "branch":
+						for (const [cond, step] of node.branches) if (await cond({
+							inputData: input,
+							runtimeContext
+						})) {
+							input = await this.runStep(step, input, ctxBase, isResumeTarget ? resumeData : void 0);
+							results[step.id] = input;
+							break;
+						}
+						break;
+					case "dountil":
+						do {
+							input = await this.runStep(node.step, input, ctxBase, void 0);
+							results[node.step.id] = input;
+						} while (!await node.condition({
+							inputData: input,
+							runtimeContext
+						}));
+						break;
+					case "foreach": {
+						const items = Array.isArray(input) ? input : [input];
+						const out = [];
+						for (const item of items) out.push(await this.runStep(node.step, item, ctxBase, void 0));
+						input = out;
+						results[node.step.id] = out;
+						break;
+					}
+					case "map":
+						input = node.fn(input);
+						break;
+				}
+				resumeData = void 0;
+			} catch (err) {
+				if (err instanceof SuspendSignal) {
+					this.snapshot = {
+						nodeIndex: i,
+						input,
+						results,
+						suspendedStepId: err.stepId
+					};
+					return {
+						status: "suspended",
+						suspended: {
+							stepId: err.stepId,
+							payload: err.payload
+						},
+						steps: results
+					};
+				}
+				return {
+					status: "failed",
+					error: err,
+					steps: results
+				};
+			}
+		}
+		return {
+			status: "success",
+			result: input,
+			steps: results
+		};
+	}
+	async runStep(step, inputData, base, resumeData) {
+		const suspend = (payload) => {
+			throw new SuspendSignal(step.id, payload);
+		};
+		return step.execute({
+			inputData,
+			resumeData,
+			suspend,
+			...base
+		});
+	}
+};
+function createWorkflow(config) {
+	return new Workflow(config);
+}
+
+//#endregion
+export { Run, Workflow, createStep, createWorkflow };
+//# sourceMappingURL=index.js.map

package/dist/workflows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["stepId: string","payload: unknown","config: { id: string; inputSchema?: z.ZodTypeAny; outputSchema?: z.ZodTypeAny }","workflowId: string","nodes: Node[]","merged: Record<string, unknown>","out: unknown[]"],"sources":["../../src/workflows/index.ts"],"sourcesContent":["import type { z } from 'zod'\nimport { RuntimeContext, type Logger } from '../types'\nimport { noopLogger } from '../logger'\n\nexport interface StepExecuteContext<TInput = unknown, TResume = unknown> {\n  inputData: TInput\n  runtimeContext: RuntimeContext\n  /** Result of a previously completed step by id. */\n  getStepResult: (stepId: string) => unknown\n  /** Data passed to `run.resume()` when resuming a suspended step. */\n  resumeData?: TResume\n  /** Suspend the workflow for human-in-the-loop; throws to halt execution. */\n  suspend: (payload?: unknown) => never\n}\n\nexport interface Step<\n  TInputSchema extends z.ZodTypeAny = z.ZodTypeAny,\n  TOutputSchema extends z.ZodTypeAny = z.ZodTypeAny,\n> {\n  id: string\n  inputSchema?: TInputSchema\n  outputSchema?: TOutputSchema\n  resumeSchema?: z.ZodTypeAny\n  suspendSchema?: z.ZodTypeAny\n  execute: (ctx: StepExecuteContext) => Promise<unknown> | unknown\n}\n\nexport function createStep<\n  TInputSchema extends z.ZodTypeAny = z.ZodTypeAny,\n  TOutputSchema extends z.ZodTypeAny = z.ZodTypeAny,\n>(config: {\n  id: string\n  inputSchema?: TInputSchema\n  outputSchema?: TOutputSchema\n  resumeSchema?: z.ZodTypeAny\n  suspendSchema?: z.ZodTypeAny\n  execute: (ctx: StepExecuteContext) => Promise<unknown> | unknown\n}): Step<TInputSchema, TOutputSchema> {\n  return { ...config }\n}\n\nclass SuspendSignal {\n  constructor(\n    public readonly stepId: string,\n    public readonly payload: unknown,\n  ) {}\n}\n\ntype Condition = (args: { inputData: unknown; runtimeContext: RuntimeContext }) => boolean | Promise<boolean>\n\ntype Node =\n  | { kind: 'step'; step: Step }\n  | { kind: 'parallel'; steps: Step[] }\n  | { kind: 'branch'; branches: [Condition, Step][] }\n  | { kind: 'dountil'; step: Step; condition: Condition }\n  | { kind: 'foreach'; step: Step }\n  | { kind: 'map'; fn: (input: unknown) => unknown }\n\nexport type RunStatus = 'success' | 'suspended' | 'failed'\n\nexport interface RunResult {\n  status: RunStatus\n  result?: unknown\n  error?: Error\n  suspended?: { stepId: string; payload: unknown }\n  steps: Record<string, unknown>\n}\n\ninterface Snapshot {\n  nodeIndex: number\n  input: unknown\n  results: Record<string, unknown>\n  suspendedStepId: string\n}\n\nexport class Workflow {\n  readonly id: string\n  private nodes: Node[] = []\n  private committed = false\n  logger: Logger = noopLogger\n\n  constructor(public config: { id: string; inputSchema?: z.ZodTypeAny; outputSchema?: z.ZodTypeAny }) {\n    this.id = config.id\n  }\n\n  then(step: Step): this {\n    this.nodes.push({ kind: 'step', step })\n    return this\n  }\n  parallel(steps: Step[]): this {\n    this.nodes.push({ kind: 'parallel', steps })\n    return this\n  }\n  branch(branches: [Condition, Step][]): this {\n    this.nodes.push({ kind: 'branch', branches })\n    return this\n  }\n  dountil(step: Step, condition: Condition): this {\n    this.nodes.push({ kind: 'dountil', step, condition })\n    return this\n  }\n  foreach(step: Step): this {\n    this.nodes.push({ kind: 'foreach', step })\n    return this\n  }\n  map(fn: (input: unknown) => unknown): this {\n    this.nodes.push({ kind: 'map', fn })\n    return this\n  }\n  commit(): this {\n    this.committed = true\n    return this\n  }\n\n  createRun(): Run {\n    if (!this.committed) {\n      throw new Error(`Workflow \"${this.id}\" must be committed with .commit() before running.`)\n    }\n    return new Run(this.id, this.nodes)\n  }\n}\n\nexport class Run {\n  private snapshot: Snapshot | null = null\n\n  constructor(\n    public readonly workflowId: string,\n    private readonly nodes: Node[],\n  ) {}\n\n  async start(args: { inputData: unknown; runtimeContext?: RuntimeContext }): Promise<RunResult> {\n    const runtimeContext = args.runtimeContext ?? new RuntimeContext()\n    return this.execute(0, args.inputData, {}, runtimeContext, undefined)\n  }\n\n  async resume(args: {\n    step: string\n    resumeData?: unknown\n    runtimeContext?: RuntimeContext\n  }): Promise<RunResult> {\n    if (!this.snapshot) throw new Error('Cannot resume: workflow is not suspended.')\n    if (this.snapshot.suspendedStepId !== args.step) {\n      throw new Error(\n        `Cannot resume step \"${args.step}\": suspended step is \"${this.snapshot.suspendedStepId}\".`,\n      )\n    }\n    const { nodeIndex, input, results } = this.snapshot\n    const runtimeContext = args.runtimeContext ?? new RuntimeContext()\n    this.snapshot = null\n    return this.execute(nodeIndex, input, results, runtimeContext, args.resumeData)\n  }\n\n  private async execute(\n    startIndex: number,\n    initialInput: unknown,\n    results: Record<string, unknown>,\n    runtimeContext: RuntimeContext,\n    resumeData: unknown,\n  ): Promise<RunResult> {\n    let input = initialInput\n    const getStepResult = (id: string) => results[id]\n\n    for (let i = startIndex; i < this.nodes.length; i++) {\n      const node = this.nodes[i]!\n      const isResumeTarget = resumeData !== undefined && i === startIndex\n      const ctxBase = { runtimeContext, getStepResult }\n\n      try {\n        switch (node.kind) {\n          case 'step': {\n            input = await this.runStep(node.step, input, ctxBase, isResumeTarget ? resumeData : undefined)\n            results[node.step.id] = input\n            break\n          }\n          case 'parallel': {\n            const out = await Promise.all(\n              node.steps.map((s) => this.runStep(s, input, ctxBase, undefined)),\n            )\n            const merged: Record<string, unknown> = {}\n            node.steps.forEach((s, idx) => {\n              results[s.id] = out[idx]\n              merged[s.id] = out[idx]\n            })\n            input = merged\n            break\n          }\n          case 'branch': {\n            for (const [cond, step] of node.branches) {\n              if (await cond({ inputData: input, runtimeContext })) {\n                input = await this.runStep(step, input, ctxBase, isResumeTarget ? resumeData : undefined)\n                results[step.id] = input\n                break\n              }\n            }\n            break\n          }\n          case 'dountil': {\n            do {\n              input = await this.runStep(node.step, input, ctxBase, undefined)\n              results[node.step.id] = input\n            } while (!(await node.condition({ inputData: input, runtimeContext })))\n            break\n          }\n          case 'foreach': {\n            const items = Array.isArray(input) ? input : [input]\n            const out: unknown[] = []\n            for (const item of items) {\n              out.push(await this.runStep(node.step, item, ctxBase, undefined))\n            }\n            input = out\n            results[node.step.id] = out\n            break\n          }\n          case 'map': {\n            input = node.fn(input)\n            break\n          }\n        }\n        resumeData = undefined\n      } catch (err) {\n        if (err instanceof SuspendSignal) {\n          this.snapshot = {\n            nodeIndex: i,\n            input,\n            results,\n            suspendedStepId: err.stepId,\n          }\n          return { status: 'suspended', suspended: { stepId: err.stepId, payload: err.payload }, steps: results }\n        }\n        return { status: 'failed', error: err as Error, steps: results }\n      }\n    }\n\n    return { status: 'success', result: input, steps: results }\n  }\n\n  private async runStep(\n    step: Step,\n    inputData: unknown,\n    base: { runtimeContext: RuntimeContext; getStepResult: (id: string) => unknown },\n    resumeData: unknown,\n  ): Promise<unknown> {\n    const suspend = (payload?: unknown): never => {\n      throw new SuspendSignal(step.id, payload)\n    }\n    return step.execute({ inputData, resumeData, suspend, ...base })\n  }\n}\n\nexport function createWorkflow(config: {\n  id: string\n  inputSchema?: z.ZodTypeAny\n  outputSchema?: z.ZodTypeAny\n}): Workflow {\n  return new Workflow(config)\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@redtuma/core",
+  "version": "0.1.0",
+  "description": "Redtuma core: the Redtuma registry, Agent, tools, model routing and workflow engine.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./agent": {
+      "types": "./dist/agent/index.d.ts",
+      "import": "./dist/agent/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js"
+    },
+    "./workflows": {
+      "types": "./dist/workflows/index.d.ts",
+      "import": "./dist/workflows/index.js"
+    },
+    "./llm": {
+      "types": "./dist/llm/index.d.ts",
+      "import": "./dist/llm/index.js"
+    },
+    "./store": {
+      "types": "./dist/store/index.d.ts",
+      "import": "./dist/store/index.js"
+    }
+  },
+  "dependencies": {
+    "ai": "^4.3.0",
+    "zod": "^3.24.0"
+  },
+  "peerDependencies": {
+    "@ai-sdk/anthropic": "^1.2.0",
+    "@ai-sdk/openai": "^1.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^1.2.0",
+    "@ai-sdk/openai": "^1.3.0",
+    "@ai-sdk/provider": "^1.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/redtuma-ai/redtuma.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://redtuma.ai",
+  "bugs": "https://github.com/redtuma-ai/redtuma/issues",
+  "keywords": [
+    "ai",
+    "agents",
+    "llm",
+    "typescript",
+    "redtuma",
+    "vercel-ai-sdk"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}