@kortyx/runtime 0.2.2 → 0.4.0

package/dist/node-registry.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerNode = registerNode;
+exports.getRegisteredNode = getRegisteredNode;
+exports.listRegisteredNodes = listRegisteredNodes;
+exports.clearRegisteredNodes = clearRegisteredNodes;
+exports.resolveNode = resolveNode;
+const registry = new Map();
+function registerNode(id, fn) {
+    registry.set(id, fn);
+}
+function getRegisteredNode(id) {
+    return registry.get(id) ?? null;
+}
+function listRegisteredNodes() {
+    return [...registry.keys()].sort();
+}
+function clearRegisteredNodes() {
+    registry.clear();
+}
+function resolveNode(id) {
+    const fn = registry.get(id);
+    if (!fn) {
+        throw new Error(`Node '${id}' is not registered. Call registerNode('${id}', fn) before running workflows that reference it.`);
+    }
+    return fn;
+}

package/dist/registry/file-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-registry.d.ts","sourceRoot":"","sources":["../../src/registry/file-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAeD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,gBAAgB,CAgGlB"}
+{"version":3,"file":"file-registry.d.ts","sourceRoot":"","sources":["../../src/registry/file-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AA0BD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,gBAAgB,CAgHlB"}

package/dist/registry/file-registry.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createFileWorkflowRegistry = createFileWorkflowRegistry;
+const core_1 = require("@kortyx/core");
 const promises_1 = require("fs/promises");
 const path_1 = require("path");
 const DEFAULT_EXTENSIONS = [
@@ -8,10 +9,18 @@ const DEFAULT_EXTENSIONS = [
     ".workflow.mts",
     ".workflow.js",
     ".workflow.mjs",
+    ".workflow.json",
+    ".workflow.yml",
+    ".workflow.yaml",
 ];
 function isWorkflowFile(name, extensions) {
     return extensions.some((ext) => name.endsWith(ext));
 }
+function isDeclarativeWorkflowFile(name) {
+    return (name.endsWith(".workflow.json") ||
+        name.endsWith(".workflow.yml") ||
+        name.endsWith(".workflow.yaml"));
+}
 function createFileWorkflowRegistry(options) {
     const workflowsDir = options.workflowsDir;
     const fallbackId = options.fallbackId ?? "general-chat";
@@ -30,18 +39,32 @@ function createFileWorkflowRegistry(options) {
         for (const file of workflowFiles) {
             try {
                 const modulePath = (0, path_1.join)(workflowsDir, file);
+                if (isDeclarativeWorkflowFile(file)) {
+                    const raw = await (0, promises_1.readFile)(modulePath, "utf8");
+                    const workflow = (0, core_1.loadWorkflow)(raw);
+                    workflow.metadata = {
+                        ...(workflow.metadata ?? {}),
+                        __filePath: modulePath,
+                    };
+                    workflows[workflow.id] = workflow;
+                    continue;
+                }
                 const module = await import(modulePath);
                 const workflowExport = Object.values(module).find((exp) => {
                     const obj = exp;
                     return (exp !== null &&
                         typeof exp === "object" &&
-                        typeof obj.name === "string" &&
+                        typeof obj.id === "string" &&
                         typeof obj.nodes === "object" &&
                         obj.nodes !== null &&
                         Array.isArray(obj.edges));
                 });
                 if (workflowExport) {
-                    workflows[workflowExport.name] = workflowExport;
+                    workflowExport.metadata = {
+                        ...(workflowExport.metadata ?? {}),
+                        __filePath: modulePath,
+                    };
+                    workflows[workflowExport.id] = workflowExport;
                 }
             }
             catch (error) {

package/dist/registry/in-memory-registry.d.ts

@@ -0,0 +1,6 @@
+import type { WorkflowDefinition } from "@kortyx/core";
+import type { WorkflowRegistry } from "./interface";
+export declare function createInMemoryWorkflowRegistry(workflows: WorkflowDefinition[], options?: {
+    fallbackId?: string;
+}): WorkflowRegistry;
+//# sourceMappingURL=in-memory-registry.d.ts.map

package/dist/registry/in-memory-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-registry.d.ts","sourceRoot":"","sources":["../../src/registry/in-memory-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,kBAAkB,EAAE,EAC/B,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,gBAAgB,CAwBlB"}

package/dist/registry/in-memory-registry.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInMemoryWorkflowRegistry = createInMemoryWorkflowRegistry;
+function createInMemoryWorkflowRegistry(workflows, options) {
+    const byId = new Map();
+    for (const wf of workflows)
+        byId.set(wf.id, wf);
+    const fallbackId = options?.fallbackId ?? "general-chat";
+    return {
+        async list() {
+            return Array.from(byId.values());
+        },
+        async get(id) {
+            return byId.get(id) ?? null;
+        },
+        async select(id, selectOptions) {
+            const fallback = selectOptions?.fallbackId ?? fallbackId;
+            const wf = byId.get(id) ?? (fallback ? byId.get(fallback) : undefined);
+            if (!wf) {
+                throw new Error(`Workflow "${id}" not found${fallback ? ` (fallback "${fallback}" missing too)` : ""}.`);
+            }
+            return wf;
+        },
+    };
+}

package/dist/registry/interface.d.ts

@@ -1,5 +1,5 @@
-import type { Edge, NodeMap, WorkflowDefinition } from "@kortyx/core";
-type AnyWorkflow = WorkflowDefinition<NodeMap, readonly Edge<string, string>[]>;
+import type { WorkflowDefinition } from "@kortyx/core";
+type AnyWorkflow = WorkflowDefinition;
 export interface WorkflowRegistry {
     list: () => Promise<AnyWorkflow[]>;
     get: (id: string) => Promise<AnyWorkflow | null>;

package/dist/registry/interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/registry/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEtE,KAAK,WAAW,GAAG,kBAAkB,CAAC,OAAO,EAAE,SAAS,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AAEhF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACnC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACjD,MAAM,EAAE,CACN,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,KAC9B,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/registry/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,KAAK,WAAW,GAAG,kBAAkB,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACnC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACjD,MAAM,EAAE,CACN,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,KAC9B,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B"}

package/dist/state/build-initial-state.d.ts

@@ -1,6 +1,6 @@
 import type { GraphState, MemoryEnvelope } from "@kortyx/core";
 export interface InitialStateArgs<Config = unknown> {
-    input: string;
+    input: unknown;
     memory: MemoryEnvelope;
     config: Config;
     defaultWorkflowId?: string;

package/dist/state/build-initial-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-initial-state.d.ts","sourceRoot":"","sources":["../../src/state/build-initial-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM/D,MAAM,WAAW,gBAAgB,CAAC,MAAM,GAAG,OAAO;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,EACnD,KAAK,EACL,MAAM,EACN,MAAM,EACN,iBAA+B,GAChC,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAWhD"}
+{"version":3,"file":"build-initial-state.d.ts","sourceRoot":"","sources":["../../src/state/build-initial-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM/D,MAAM,WAAW,gBAAgB,CAAC,MAAM,GAAG,OAAO;IAChD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,EACnD,KAAK,EACL,MAAM,EACN,MAAM,EACN,iBAAiB,GAClB,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAkBhD"}

package/dist/state/build-initial-state.js

@@ -1,14 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildInitialGraphState = buildInitialGraphState;
-async function buildInitialGraphState({ input, memory, config, defaultWorkflowId = "frontdesk", }) {
+async function buildInitialGraphState({ input, memory, config, defaultWorkflowId, }) {
+    const currentWorkflow = memory.currentWorkflow || defaultWorkflowId;
+    if (!currentWorkflow) {
+        throw new Error("No workflow selected. Provide defaultWorkflowId (or set memory.currentWorkflow) before starting the graph.");
+    }
     return {
         input,
         lastNode: "__start__",
         memory,
         config: config,
         conversationHistory: [],
-        currentWorkflow: memory.currentWorkflow || defaultWorkflowId,
+        currentWorkflow,
         awaitingHumanInput: false,
     };
 }

package/package.json

@@ -1,25 +1,54 @@
 {
   "name": "@kortyx/runtime",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "private": false,
+  "description": "Runtime/orchestration wiring for Kortyx.",
+  "keywords": [
+    "ai",
+    "agent",
+    "agents",
+    "orchestration",
+    "framework",
+    "runtime",
+    "kortyx"
+  ],
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/kortyx-io/kortyx/tree/main/packages/runtime#readme",
+  "bugs": {
+    "url": "https://github.com/kortyx-io/kortyx/issues"
+  },
+  "author": "Kortyx (https://github.com/kortyx-io)",
   "main": "./dist/index.js",
-  "types": "./src/index.ts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
+      "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     }
   },
+  "files": [
+    "dist/**",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc --watch",
+    "lint": "biome check src",
+    "test": "pnpm -s type-check",
+    "type-check": "tsc --noEmit"
+  },
   "dependencies": {
+    "@kortyx/stream": "workspace:*",
+    "@kortyx/core": "workspace:*",
+    "@kortyx/hooks": "workspace:*",
+    "@kortyx/memory": "workspace:*",
+    "@kortyx/providers": "workspace:*",
+    "@kortyx/utils": "workspace:*",
     "@langchain/core": "^1.0.1",
     "@langchain/langgraph": "^1.0.1",
-    "uuid": "^11.1.0",
-    "@kortyx/core": "0.2.2",
-    "@kortyx/hooks": "0.2.2",
-    "@kortyx/memory": "0.2.2",
-    "@kortyx/providers": "0.2.2",
-    "@kortyx/utils": "0.2.2",
-    "@kortyx/stream": "0.2.2"
+    "@langchain/langgraph-checkpoint": "^1.0.0",
+    "uuid": "^11.1.0"
   },
   "devDependencies": {
     "turbo": "^2.5.4",
@@ -30,12 +59,5 @@
     "type": "git",
     "url": "https://github.com/kortyx-io/kortyx",
     "directory": "packages/runtime"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "dev": "tsc --watch",
-    "lint": "echo 'Linting @kortyx/runtime...' && echo 'Lint passed!'",
-    "test": "echo 'Testing @kortyx/runtime...' && echo 'All tests passed!'",
-    "type-check": "tsc --noEmit"
   }
-}
+}

package/src/checkpointer.ts

@@ -1,13 +0,0 @@
-import { MemorySaver } from "@langchain/langgraph";
-
-const map = new Map<string, MemorySaver>();
-
-export function getCheckpointer(key: string): MemorySaver {
-  const k = key || "__default__";
-  let saver = map.get(k);
-  if (!saver) {
-    saver = new MemorySaver();
-    map.set(k, saver);
-  }
-  return saver;
-}

package/src/config/load-kortyx-config.ts

@@ -1,46 +0,0 @@
-import { stat } from "fs/promises";
-import { resolve } from "path";
-import { pathToFileURL } from "url";
-
-export interface KortyxConfig {
-  workflowsDir?: string;
-  fallbackWorkflowId?: string;
-  registry?: {
-    cache?: boolean;
-    extensions?: string[];
-  };
-}
-
-export interface LoadKortyxConfigOptions {
-  cwd?: string;
-  configPath?: string;
-}
-
-async function exists(filePath: string): Promise<boolean> {
-  try {
-    const info = await stat(filePath);
-    return info.isFile();
-  } catch {
-    return false;
-  }
-}
-
-export async function loadKortyxConfig(
-  options: LoadKortyxConfigOptions = {},
-): Promise<KortyxConfig | null> {
-  const cwd = options.cwd ?? process.cwd();
-  const configPath = options.configPath ?? "kortyx.config.mjs";
-  const resolvedPath = resolve(cwd, configPath);
-
-  if (!(await exists(resolvedPath))) return null;
-
-  try {
-    const mod = await import(pathToFileURL(resolvedPath).href);
-    const config = (mod?.default ?? mod?.kortyx ?? mod) as KortyxConfig | null;
-    if (!config || typeof config !== "object") return null;
-    return config;
-  } catch (error) {
-    const message = error instanceof Error ? error.message : "Unknown error";
-    throw new Error(`Failed to load ${configPath}: ${message}`);
-  }
-}