@intent-driven/runtime-local 0.3.0 → 0.4.0

package/README.md

@@ -59,11 +59,27 @@ Peer-зависимость: `@intent-driven/core@>=0.49.0` (через `@intent
 | `GET` | `/api/agent/:domain/schema` | Full ontology snapshot для MCP discovery. 503 если domain не совпадает. |
 | `GET` | `/api/state/current` | Folded world snapshot — `{domain, world: {products: [...], orders: [...]}}`. |
 | `GET` | `/api/agent/:domain/world` | Тот же world, что и `/api/state/current`. Этот endpoint вызывает `@intent-driven/mcp-server` для resource-чтения. 503 при mismatch domain. |
+| `POST` | `/api/agent/:domain/exec/:intentId` | Ingest intent через `engine.submit`. Generic builder для add/replace/remove. Возвращает `200 {status:'confirmed', effect}` или `409 {status:'rejected', error:'invariant_violation', reason, cascaded}`. `400` для read-intents, `404` для unknown intent, `503` для wrong domain. |
+
+### POST /api/agent/:domain/exec/:intentId
+
+Тело запроса: `{ params: { ... } }`.
+
+`buildEffect()` строит effect по generic-семантике (идентично host'овскому `genericBuildEffects`):
+
+- `alpha=add` → `context = {...params, id: params.id || uuid}`, `value = null`
+- `alpha=replace` target=`Entity.field` → `context = {id: params.id}`, `value = JSON.stringify(params[field])`
+- `alpha=replace` target=`Entity` → `context = {...params}`, `value = null`
+- `alpha=remove` → `context = {id: params.id || params['<entity>Id']}`, `value = null`
+- `alpha=read` → 400 (читай через GET `/api/state/current`)
+
+Лежит на `engine.submit`, поэтому invariants всех 6 kinds автоматически проверяются (role-capability / referential / transition / cardinality / aggregate / expression).
+
+> **A1.3 (следующий PR):** intents с `lifecycle.requiresApproval` сейчас confirm'ятся напрямую. После добавления `lifecycleAugmenter` они будут создавать `ApprovalRequest` вместо ingest'а оригинального effect'а.
 
 ## Roadmap (следующие PR)
 
-- v0.4: `POST /api/agent/:domain/exec/:intentId` — ingest через `engine.submit` с invariant validation, ApprovalRequest auto-injection через `lifecycleAugmenter`
-- v0.5: `GET /api/approvals/pending` + `POST /api/approvals/:id/approve|reject` + timer-driven expiry
+- v0.5: `GET /api/approvals/pending` + `POST /api/approvals/:id/approve|reject` + ApprovalRequest auto-injection (lifecycleAugmenter)
 - v0.6: `GET /api/state/at?t=ISO` + `/api/state/diff?from=&to=` — time-travel
 - v0.7: SSE-стрим `/api/approvals/stream` для `idf approvals --watch`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intent-driven/runtime-local",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Standalone Fold-runtime для local quickstart: stateful Φ + agent/exec + approvals + state — то, что делает host idf/server, но как npm-пакет",
   "type": "module",
   "exports": {

package/src/buildEffect.js

@@ -0,0 +1,82 @@
+import { randomUUID } from "node:crypto";
+
+/**
+ * Generic effect-builder для intents без custom builder'а — закрывает
+ * 80%+ кейсов после `idf full-bootstrap`. Идентичен host'овскому
+ * `genericBuildEffects` (server/schema/effectBuildersRegistry.cjs):
+ *
+ *   alpha=add     → ctx={...params, id: params.id || uuid}
+ *   alpha=replace target='Entity.field' → ctx={id}, value=params[field] || params.value
+ *   alpha=replace target='Entity'       → ctx={...params}, value=null
+ *   alpha=remove  → ctx={id: params.id || params['<entity>Id']}
+ *
+ * Возвращает unsubmitted effect (без status/created_at — engine.submit
+ * проставит их сам).
+ */
+export function buildEffect({ intentId, intent, params = {}, viewerId = null }) {
+  if (!intent) {
+    throw new Error(`buildEffect: intent '${intentId}' not provided`);
+  }
+
+  const alpha = intent.alpha;
+  if (alpha === "read") {
+    throw new Error(`buildEffect: read intent '${intentId}' is not executable`);
+  }
+
+  const target = intent.target;
+  if (!target) {
+    throw new Error(`buildEffect: intent '${intentId}' has no target`);
+  }
+
+  const id = randomUUID();
+  const baseEffect = {
+    id,
+    intent_id: intentId,
+    alpha,
+    target,
+    scope: intent.scope || "account",
+  };
+  if (viewerId) baseEffect.user_id = viewerId;
+
+  switch (alpha) {
+    case "add": {
+      return {
+        ...baseEffect,
+        context: { ...params, id: params.id || id },
+        value: null,
+      };
+    }
+    case "replace": {
+      const segments = target.split(".");
+      if (segments.length > 1) {
+        const field = segments[segments.length - 1];
+        const raw = params[field] !== undefined ? params[field] : params.value;
+        // Engine validator JSON-парсит string values (host-convention для
+        // SQLite JSONB columns). Любое native JS value JSON-encode'ится.
+        const value = raw === undefined || raw === null ? null : JSON.stringify(raw);
+        return {
+          ...baseEffect,
+          context: { id: params.id },
+          value,
+        };
+      }
+      return {
+        ...baseEffect,
+        context: { ...params },
+        value: null,
+      };
+    }
+    case "remove": {
+      const entityName = target.split(".")[0];
+      const idKey = `${entityName.charAt(0).toLowerCase()}${entityName.slice(1)}Id`;
+      const entityId = params.id || params[idKey];
+      return {
+        ...baseEffect,
+        context: { id: entityId },
+        value: null,
+      };
+    }
+    default:
+      throw new Error(`buildEffect: unsupported alpha '${alpha}'`);
+  }
+}

package/src/createRuntime.js

@@ -4,6 +4,7 @@ import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
 import { createEngine, createInMemoryPersistence } from "@intent-driven/engine";
+import { buildEffect } from "./buildEffect.js";
 
 /**
  * Engine validator JSON-парсит ef.value если оно string (host-convention для
@@ -106,6 +107,49 @@ export function createRuntime(opts = {}) {
     }
   });
 
+  app.post("/api/agent/:domain/exec/:intentId", async (req, res, next) => {
+    if (req.params.domain !== domain) {
+      return res.status(503).json({
+        error: "ontology_unavailable",
+        domain: req.params.domain,
+        message: `Ontology for '${req.params.domain}' is not registered. Runtime serves '${domain}'.`,
+      });
+    }
+    const intentId = req.params.intentId;
+    const intent = (ontology.intents || {})[intentId];
+    if (!intent) {
+      return res.status(404).json({
+        error: "intent_not_found",
+        intentId,
+        domain,
+      });
+    }
+    if (intent.alpha === "read") {
+      return res.status(400).json({
+        error: "read_intent_not_executable",
+        intentId,
+        message: `Read-intents must be executed via GET /api/state/current or /api/agent/${domain}/world.`,
+      });
+    }
+    try {
+      const params = (req.body && typeof req.body === "object" ? req.body.params : null) || {};
+      const effect = buildEffect({ intentId, intent, params });
+      const result = await engine.submit(effect);
+      if (result.status === "confirmed") {
+        return res.json({ status: "confirmed", effect });
+      }
+      return res.status(409).json({
+        status: "rejected",
+        error: "invariant_violation",
+        reason: result.reason,
+        cascaded: result.cascaded || [],
+        effect,
+      });
+    } catch (err) {
+      next(err);
+    }
+  });
+
   let server = null;
 
   async function loadSeed() {