johankit-runtime 0.0.2 → 0.4.2

package/README.md

@@ -1,29 +1,52 @@
 # Johankit Runtime
 
-A modular runtime built around **events**, **capabilities**, and **contracts**.  
-It allows systems to grow by composition instead of coupling, using self-contained packages that are discovered and wired automatically.
+Johankit Runtime is a modular, event-driven execution runtime built around **packages**, **events**, **routes**, **tools**, and **conditions**.
 
-This project is not a framework in the traditional sense.  
-It is an **execution model**.
+It is not a framework in the traditional sense. It is an **execution model** designed to let systems grow by composition instead of coupling.
 
 ---
 
-## Why This Exists
+## Why Johankit
 
-Most systems grow by accumulating integrations:
-- interfaces
-- protocols
-- adapters
-- glue code
+Most back-end systems evolve by accumulating:
 
-Johankit Runtime approaches this differently:
+* integrations
+* adapters
+* glue code
+* shared abstractions
 
-> Everything is a **package**.  
-> Everything meaningful is an **event**, a **route**, or a **callable action**.
+Johankit approaches this differently:
 
-No central registry.  
-No hard dependencies between packages.  
-No shared business logic.
+* Everything is a **package**
+* Everything meaningful is an **event**, **route**, or **tool**
+* There is no central registry
+* There are no hard dependencies between packages
+
+Packages declare behavior explicitly and are discovered automatically at runtime.
+
+---
+
+## Installation
+
+```
+npm install johankit-runtime
+```
+
+---
+
+## Basic Usage
+
+```ts
+import { bootstrap, dispatchEvent } from 'johankit-runtime'
+
+await bootstrap({
+  workspace: './packages',
+  http: { enabled: true },
+  mcp: { enabled: true }
+})
+
+await dispatchEvent('user_created', { id: 1 })
+```
 
 ---
 
@@ -31,15 +54,16 @@ No shared business logic.
 
 ### Packages
 
-A package is an isolated unit of behavior living inside a workspace directory.
+A package is an isolated unit of behavior located inside the workspace directory.
 
 A package may declare:
-- routes
-- event hooks
-- callable tools
-- predicates
-- middleware
-- startup logic
+
+* event hooks
+* HTTP routes
+* tools (callable actions)
+* predicates
+* middleware
+* startup logic
 
 Anything not explicitly declared is ignored.
 
@@ -48,10 +72,11 @@ Anything not explicitly declared is ignored.
 ### Discovery
 
 At startup, the runtime:
-1. Scans the workspace
-2. Loads packages
-3. Inspects exported functions
-4. Registers only what is explicitly annotated
+
+1. Resolves the workspace path
+2. Scans all package folders
+3. Loads JavaScript files
+4. Registers only annotated functions
 
 There is no manual wiring.
 
@@ -59,29 +84,26 @@ There is no manual wiring.
 
 ### Declarative Annotations
 
-Behavior is declared using structured comments.
+Behavior is declared using JSDoc-style annotations.
 
-**Important rule: annotations must be inside the function body.**
+**Important rule:**
+Annotations **must be inside the function body**.
 
-This is intentional.
+Example:
 
 ```js
 function example() {
   /**
-   * @register_hook something
+   * @register_hook user_created
    */
 }
-````
-
-Annotations outside the function will not be detected.
+```
 
-This makes annotations part of the behavior, not part of the language.
+Annotations outside the function are intentionally ignored.
 
 ---
 
-## Execution Primitives
-
-### Events (Hooks)
+## Events (Hooks)
 
 Events represent something that happened.
 
@@ -94,19 +116,20 @@ function enrich(payload) {
 }
 ```
 
-* Events are broadcast to all packages
+Characteristics:
+
 * Hooks run sequentially
 * Returned values replace the payload
 * `null` or `undefined` are ignored
 * Failures do not stop execution
 
-Events are **data pipelines**, not notifications.
+Events act as **data pipelines**, not notifications.
 
 ---
 
-### Routes
+## Routes
 
-Routes expose request handlers automatically.
+Routes expose HTTP handlers automatically.
 
 ```js
 function status() {
@@ -118,11 +141,15 @@ function status() {
 }
 ```
 
-Routes are namespaced by package name and require no manual registration.
+Routes are automatically namespaced by package name:
+
+```
+/your-package/status
+```
 
 ---
 
-### Tools
+## Tools
 
 Tools are structured, callable actions.
 
@@ -139,16 +166,16 @@ function calculate() {
 
 Tools:
 
-* expose their input schema
+* expose input schemas
 * can be listed dynamically
 * can be invoked programmatically
-* can be exposed through control interfaces
+* can be exposed via MCP or HTTP
 
 They are ideal for automation and orchestration.
 
 ---
 
-### Predicates
+## Predicates
 
 Predicates are named boolean checks.
 
@@ -161,11 +188,11 @@ function isAdmin() {
 }
 ```
 
-They do nothing by themselves, but enable conditional execution elsewhere.
+They enable conditional behavior elsewhere in the system.
 
 ---
 
-### Middleware
+## Middleware
 
 Middleware can be conditionally enabled using predicates.
 
@@ -178,7 +205,7 @@ function guard() {
 }
 ```
 
-Only predicates that evaluate to `true` activate the middleware.
+Only predicates that evaluate to true activate the middleware.
 
 ---
 
@@ -186,39 +213,19 @@ Only predicates that evaluate to `true` activate the middleware.
 
 Many declarations support optional conditions:
 
-```text
-@only web
-@never mobile
-@when authenticated
-```
-
-Conditions are **metadata**, not enforcement rules.
-They allow higher-level orchestration without hardcoding logic.
-
----
-
-## Event Dispatching
-
-Events are dispatched explicitly:
-
-```js
-dispatchEvent('user_created', payload)
-```
+* `@only web`
+* `@never mobile`
+* `@when authenticated`
 
-The runtime:
-
-* loads all packages
-* finds matching hooks
-* executes them safely
-* returns the final payload
+Conditions are metadata, not enforcement rules.
 
-This enables cross-package collaboration without coupling.
+They enable higher-level orchestration without hardcoding logic.
 
 ---
 
-## Tool Control Interface (MCP-style)
+## MCP (Tool Control Interface)
 
-The runtime can expose tools through a standardized control surface.
+Johankit can expose tools through an MCP-style control interface.
 
 Capabilities:
 
@@ -237,64 +244,35 @@ This makes the runtime suitable for:
 
 ## Bootstrapping
 
-The runtime is started by providing a workspace and optional interfaces.
-
-```js
+```ts
 bootstrap({
   workspace: './packages',
-  http: { enabled: true },
+  http: { enabled: true, port: 5040 },
   mcp: { enabled: true }
 })
 ```
 
 The bootstrap process:
 
-* resolves the workspace
 * loads all packages
-* initializes declared interfaces
-* returns references to running components
+* initializes routes
+* enables MCP interfaces
+* starts HTTP servers if configured
 
 ---
 
 ## Design Principles
 
 * Explicit behavior over magic
-* Convention over configuration
+* Composition over inheritance
 * Isolation between packages
 * Protocol-agnostic core
 * Graceful failure handling
-* Composition over inheritance
-
----
-
-## What Fits Naturally
-
-Because the runtime is protocol-agnostic, it adapts well to:
-
-* real-time channels
-* background processing
-* schedulers
-* message streams
-* file watchers
-* control interfaces
-* agents and decision systems
-
-All of these are just **event translators**.
-
----
-
-## What This Is Not
-
-* Not a monolithic framework
-* Not a dependency injection container
-* Not a plugin marketplace
-* Not a DSL
-
-It is a **runtime contract**.
 
 ---
 
 ## Project Status
 
-Early-stage, evolving by usage.
-APIs are intentionally minimal and may evolve as patterns emerge.
+Early-stage and evolving through real usage.
+
+APIs are intentionally minimal and may evolve as patterns emerge.

package/dist/src/app.d.ts

@@ -0,0 +1,7 @@
+import { Application } from 'express';
+type JohankitApp = Application & {
+    setup: () => Promise<void>;
+};
+declare const _default: JohankitApp;
+export default _default;
+//# sourceMappingURL=app.d.ts.map

package/dist/src/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG9C,KAAK,WAAW,GAAG,WAAW,GAAG;IAC/B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B,CAAA;wBAYqB,WAAW;AAAjC,wBAAiC"}

package/dist/src/app.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = __importDefault(require("express"));
+const register_1 = require("./core/register");
+const app = (0, express_1.default)();
+app.setup = async () => {
+    try {
+        await (0, register_1.registerPackages)(app);
+    }
+    catch (error) {
+        console.log(`Error registering packages: ${error.message}`, 'error');
+    }
+};
+exports.default = app;
+//# sourceMappingURL=app.js.map

package/dist/src/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":";;;;;AAAA,sDAA8C;AAC9C,8CAAkD;AAMlD,MAAM,GAAG,GAAG,IAAA,iBAAO,GAAiB,CAEnC;AAAC,GAAmB,CAAC,KAAK,GAAG,KAAK,IAAI,EAAE;IACvC,IAAI,CAAC;QACH,MAAM,IAAA,2BAAgB,EAAC,GAAG,CAAC,CAAA;IAC7B,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,+BAA+B,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAA;IACtE,CAAC;AACH,CAAC,CAAA;AAED,kBAAe,GAAkB,CAAA"}

package/dist/src/core/cache.d.ts

@@ -0,0 +1,6 @@
+export function get(key: any): any;
+export function set(key: any, value: any): void;
+export function has(key: any): boolean;
+export function invalidate(folderPath: any, parserName: any): void;
+export function clear(): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/src/core/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/core/cache.js"],"names":[],"mappings":"AAEA,mCAEC;AAED,gDAEC;AAED,uCAEC;AAED,mEAEC;AAED,8BAEC"}

package/dist/src/core/cache.js

@@ -0,0 +1,18 @@
+const cache = new Map();
+function get(key) {
+    return cache.get(key);
+}
+function set(key, value) {
+    cache.set(key, value);
+}
+function has(key) {
+    return cache.has(key);
+}
+function invalidate(folderPath, parserName) {
+    cache.delete(folderPath + parserName);
+}
+function clear() {
+    cache.clear();
+}
+module.exports = { get, set, has, invalidate, clear };
+//# sourceMappingURL=cache.js.map

package/dist/src/core/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/core/cache.js"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;AAExB,SAAS,GAAG,CAAC,GAAG;IACd,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,GAAG,CAAC,GAAG,EAAE,KAAK;IACrB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,GAAG,CAAC,GAAG;IACd,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,UAAU,CAAC,UAAU,EAAE,UAAU;IACxC,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,KAAK;IACZ,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC"}

package/dist/src/core/conditions/resolver.d.ts

@@ -0,0 +1,2 @@
+export function resolveConditions(condition?: {}, context?: {}): Promise<boolean>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/src/core/conditions/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../../src/core/conditions/resolver.js"],"names":[],"mappings":"AAAA,kFAWC"}

package/dist/src/core/conditions/resolver.js

@@ -0,0 +1,20 @@
+async function resolveConditions(condition = {}, context = {}) {
+    if (condition.only) {
+        for (const c of condition.only)
+            if (!context[c])
+                return false;
+    }
+    if (condition.never) {
+        for (const c of condition.never)
+            if (context[c])
+                return false;
+    }
+    if (condition.when) {
+        for (const c of condition.when)
+            if (!context[c])
+                return false;
+    }
+    return true;
+}
+module.exports = { resolveConditions };
+//# sourceMappingURL=resolver.js.map

package/dist/src/core/conditions/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../../src/core/conditions/resolver.js"],"names":[],"mappings":"AAAA,KAAK,UAAU,iBAAiB,CAAC,SAAS,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE;IAC3D,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,IAAI;YAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;IAChE,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,KAAK;YAAE,IAAI,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;IAChE,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,IAAI;YAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;IAChE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,OAAO,GAAG,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/src/core/config-loader.d.ts

@@ -0,0 +1,2 @@
+export function loadPackageConfig(pkg: any): Promise<any>;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/src/core/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../../src/core/config-loader.js"],"names":[],"mappings":"AAIA,0DAUC"}

package/dist/src/core/config-loader.js

@@ -0,0 +1,18 @@
+const fs = require('fs');
+const path = require('path');
+const yaml = require('js-yaml');
+async function loadPackageConfig(pkg) {
+    const ymlPath = path.join(__dirname, '..', 'packages', pkg.folder, 'agent.yml');
+    if (!fs.existsSync(ymlPath))
+        return pkg;
+    try {
+        const fileContents = fs.readFileSync(ymlPath, 'utf8');
+        pkg.config = yaml.load(fileContents);
+    }
+    catch (err) {
+        console.log(`Error reading YAML for ${pkg.folder}: ${err.message}`);
+    }
+    return pkg;
+}
+module.exports = { loadPackageConfig };
+//# sourceMappingURL=config-loader.js.map

package/dist/src/core/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../../src/core/config-loader.js"],"names":[],"mappings":"AAAA,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACzB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,KAAK,UAAU,iBAAiB,CAAC,GAAG;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAChF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtD,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,OAAO,GAAG,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/src/core/context.d.ts

@@ -0,0 +1,2 @@
+export function createRuntimeContext(initial?: {}): {};
+//# sourceMappingURL=context.d.ts.map

package/dist/src/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/core/context.js"],"names":[],"mappings":"AAAA,uDAEC"}

package/dist/src/core/context.js

@@ -0,0 +1,5 @@
+function createRuntimeContext(initial = {}) {
+    return { ...initial };
+}
+module.exports = { createRuntimeContext };
+//# sourceMappingURL=context.js.map

package/dist/src/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/core/context.js"],"names":[],"mappings":"AAAA,SAAS,oBAAoB,CAAC,OAAO,GAAG,EAAE;IACxC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,OAAO,GAAG,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/src/core/discovery.d.ts

@@ -0,0 +1,4 @@
+export function discoverPackages(): Promise<{
+    folder: any;
+}[]>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/src/core/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/core/discovery.js"],"names":[],"mappings":"AAEA;;KAEC"}

package/dist/src/core/discovery.js

@@ -0,0 +1,6 @@
+const { getPackages } = require('./package');
+async function discoverPackages() {
+    return await getPackages();
+}
+module.exports = { discoverPackages };
+//# sourceMappingURL=discovery.js.map

package/dist/src/core/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/core/discovery.js"],"names":[],"mappings":"AAAA,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAE7C,KAAK,UAAU,gBAAgB;IAC7B,OAAO,MAAM,WAAW,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,OAAO,GAAG,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/src/core/event/dispatch.d.ts

@@ -0,0 +1,2 @@
+export function dispatchEvent(eventName: any, payload: any, context?: {}): Promise<any>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/src/core/event/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../../src/core/event/dispatch.js"],"names":[],"mappings":"AAMA,wFAwBC"}

package/dist/src/core/event/dispatch.js

@@ -0,0 +1,30 @@
+const { registerHooks } = require('../register/decorators');
+const { getPackages } = require('../package');
+const { resolveConditions } = require('../conditions/resolver');
+const { createRuntimeContext } = require('../context');
+const { resolveMiddlewares, runMiddlewares } = require('../middleware/run');
+async function dispatchEvent(eventName, payload, context = createRuntimeContext()) {
+    const packages = await getPackages();
+    let finalResult = payload;
+    for (const pkg of packages) {
+        const hooks = await registerHooks(pkg.folder);
+        const relevant = hooks.filter(h => h.event === eventName);
+        if (relevant.length === 0)
+            continue;
+        const pkgContext = { ...context, pkg };
+        const middlewares = await resolveMiddlewares(pkg.folder, pkgContext);
+        for (const hook of relevant) {
+            const allowed = await resolveConditions(hook.condition || {}, pkgContext);
+            if (!allowed)
+                continue;
+            await runMiddlewares(middlewares, pkgContext, async () => {
+                const result = await hook.call(finalResult, pkgContext);
+                if (result !== undefined && result !== null)
+                    finalResult = result;
+            });
+        }
+    }
+    return finalResult;
+}
+module.exports = { dispatchEvent };
+//# sourceMappingURL=dispatch.js.map

package/dist/src/core/event/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../../../src/core/event/dispatch.js"],"names":[],"mappings":"AAAA,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAC5D,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAC9C,MAAM,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAChE,MAAM,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AACvD,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAE5E,KAAK,UAAU,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,oBAAoB,EAAE;IAC/E,MAAM,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAC;IACrC,IAAI,WAAW,GAAG,OAAO,CAAC;IAE1B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;QAC1D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEpC,MAAM,UAAU,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAErE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;YAC1E,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,MAAM,cAAc,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,IAAI,EAAE;gBACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;gBACxD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;oBAAE,WAAW,GAAG,MAAM,CAAC;YACpE,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,OAAO,GAAG,EAAE,aAAa,EAAE,CAAC"}

package/dist/src/core/mcp/http-server.d.ts

@@ -0,0 +1,11 @@
+export function createMcpHttpServer(options?: {}): Promise<{
+    app: import("express-serve-static-core").Express;
+    server: import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>;
+    mcp: {
+        protocol: string;
+        version: string;
+        listTools(context?: {}): any;
+        callTool(name: any, args: any, context?: {}): Promise<any>;
+    };
+}>;
+//# sourceMappingURL=http-server.d.ts.map

package/dist/src/core/mcp/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../../../../src/core/mcp/http-server.js"],"names":[],"mappings":"AAKA;;;;;;;;;GAkDC"}

package/dist/src/core/mcp/http-server.js

@@ -0,0 +1,48 @@
+const express = require('express');
+const bodyParser = require('body-parser');
+const { bootstrapMcp } = require('./tools-mcp');
+const { createRuntimeContext } = require('../context');
+async function createMcpHttpServer(options = {}) {
+    const app = express();
+    const port = options.port || 3333;
+    const workspace = options.workspace || process.env.PACKAGES_PATH;
+    if (!workspace) {
+        throw new Error('PACKAGES_PATH or workspace option is required');
+    }
+    const mcp = await bootstrapMcp(workspace);
+    app.use(bodyParser.json());
+    app.use((req, res, next) => {
+        req.runtimeContext = createRuntimeContext({ req, res });
+        next();
+    });
+    app.get('/mcp', (req, res) => {
+        res.json({ protocol: mcp.protocol, version: mcp.version });
+    });
+    app.get('/mcp/tools', async (req, res) => {
+        try {
+            res.json(mcp.listTools(req.runtimeContext));
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    app.post('/mcp/call', async (req, res) => {
+        const { name, args } = req.body || {};
+        if (!name) {
+            return res.status(400).json({ error: 'Tool name is required' });
+        }
+        try {
+            const result = await mcp.callTool(name, args || {}, req.runtimeContext);
+            res.json({ result });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    const server = app.listen(port, () => {
+        console.log(`MCP HTTP server running on port ${port}`);
+    });
+    return { app, server, mcp };
+}
+module.exports = { createMcpHttpServer };
+//# sourceMappingURL=http-server.js.map

package/dist/src/core/mcp/http-server.js.map

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

package/dist/src/core/mcp/tools-mcp.d.ts

@@ -0,0 +1,14 @@
+export function loadMcpTools(agentFolder: any): Promise<any>;
+export function createMcpServer(tools: any): {
+    protocol: string;
+    version: string;
+    listTools(context?: {}): any;
+    callTool(name: any, args: any, context?: {}): Promise<any>;
+};
+export function bootstrapMcp(agentFolder: any): Promise<{
+    protocol: string;
+    version: string;
+    listTools(context?: {}): any;
+    callTool(name: any, args: any, context?: {}): Promise<any>;
+}>;
+//# sourceMappingURL=tools-mcp.d.ts.map

package/dist/src/core/mcp/tools-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-mcp.d.ts","sourceRoot":"","sources":["../../../../src/core/mcp/tools-mcp.js"],"names":[],"mappings":"AAkCA,6DAGC;AAED;;;;;EAeC;AAED;;;;;GAGC"}