ekairos 1.6.0

package/README.md

@@ -0,0 +1,112 @@
+# Ekairos
+
+**AI Stories and Workflows Runtime** - Build durable, intelligent workflows with AI.
+
+## Installation
+
+```bash
+# Core package (story + domain)
+pnpm add ekairos
+
+# Dataset tools (separate package)
+pnpm add @ekairos/dataset
+```
+
+## Quick Start
+
+```typescript
+import { story, engine, storyRunner } from 'ekairos';
+
+// 1. Define your story
+const myStory = {
+  key: 'my-story',
+  narrative: 'You are a helpful assistant that...',
+  actions: [
+    {
+      name: 'doSomething',
+      description: 'Does something useful',
+      implementationKey: 'my.action',
+      execute: async ({ arg, contextId }) => {
+        // Your non-serializable code here
+        return { success: true, result: 'done' };
+      }
+    }
+  ],
+  options: {
+    reasoningEffort: 'medium',
+    maxLoops: 10
+  }
+};
+
+// 2. Register the story
+export const storyEngineInstance = engine.register(myStory);
+export const descriptor = storyEngineInstance.story('my-story');
+
+// 3. Create a workflow (in app/workflows/my-story.ts)
+import { storyRunner } from 'ekairos';
+import { descriptor } from './stories';
+
+export async function myWorkflow(args?: { context?: any }) {
+  "use workflow";  // Required for Next.js Workflow DevKit
+  return storyRunner(descriptor, args);
+}
+
+// 4. Start the workflow
+import { start } from 'workflow/api';
+import { myWorkflow } from './workflows/my-story';
+
+await start(myWorkflow);
+```
+
+## Next.js Integration
+
+```typescript
+// next.config.ts
+import { withWorkflow } from 'workflow/next';
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  transpilePackages: ['ekairos'],
+};
+
+export default withWorkflow(nextConfig);
+```
+
+## What's Included
+
+This package (`ekairos`) is a convenience wrapper that re-exports:
+- **@ekairos/story** - AI agents, story engine, workflows, steps
+- **@ekairos/domain** - Domain modeling utilities for InstantDB
+
+**Not included:** Dataset tools are a separate package (`@ekairos/dataset`)
+
+## Package Ecosystem
+
+```bash
+# Core runtime (recommended for most use cases)
+pnpm add ekairos
+
+# Dataset tools - SEPARATE package
+pnpm add @ekairos/dataset
+
+# Advanced: Use scoped packages directly if needed
+pnpm add @ekairos/story   # Story engine only
+pnpm add @ekairos/domain  # Domain utilities only
+```
+
+## Features
+
+- 🤖 **AI Agents** - Durable agents with tool execution
+- 🎭 **Story Engine** - Modular stories with non-serializable actions
+- 🔄 **Workflow Integration** - Compatible with Vercel Workflow DevKit
+- 💾 **Persistent State** - Built on InstantDB
+- 🛠️ **Extensible** - Easy to add custom tools and actions
+
+## Documentation
+
+See the [monorepo README](../../README.md) for full documentation.
+
+## License
+
+MIT
+

package/dist/domain.d.ts

@@ -0,0 +1,2 @@
+export * from '@ekairos/domain';
+//# sourceMappingURL=domain.d.ts.map

package/dist/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/domain.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("@ekairos/domain"), exports);
+//# sourceMappingURL=domain.js.map

package/dist/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from '@ekairos/story';
+export * from '@ekairos/domain';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Re-export todo de story (el paquete principal)
+__exportStar(require("@ekairos/story"), exports);
+// Re-export domain utilities
+__exportStar(require("@ekairos/domain"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAAiD;AACjD,iDAA+B;AAE/B,6BAA6B;AAC7B,kDAAgC"}

package/dist/story.d.ts

@@ -0,0 +1,2 @@
+export * from '@ekairos/story';
+//# sourceMappingURL=story.d.ts.map

package/dist/story.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story.d.ts","sourceRoot":"","sources":["../src/story.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/story.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("@ekairos/story"), exports);
+//# sourceMappingURL=story.js.map

package/dist/story.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story.js","sourceRoot":"","sources":["../src/story.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "ekairos",
+  "version": "1.6.0",
+  "description": "Ekairos - AI Stories and Workflows Runtime",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pulz-ar/pulzar-lib-core.git",
+    "directory": "packages/ekairos"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./story": {
+      "types": "./dist/story.d.ts",
+      "require": "./dist/story.js",
+      "default": "./dist/story.js"
+    },
+    "./domain": {
+      "types": "./dist/domain.d.ts",
+      "require": "./dist/domain.js",
+      "default": "./dist/domain.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "clean": "node -e \"require('fs').rmSync('dist', {recursive:true, force:true})\"",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@ekairos/story": "^1.6.0",
+    "@ekairos/domain": "^1.6.0"
+  },
+  "devDependencies": {
+    "@ekairos/tsconfig": "workspace:*",
+    "@types/node": "^24.5.0",
+    "typescript": "^5.9.2"
+  }
+}
+