limen-ai 1.0.0

package/dist/orchestration/events/event_propagation.js

@@ -0,0 +1,160 @@
+/**
+ * Event Propagation -- Event routing through mission trees.
+ * S ref: S10 (Event), S20 (emit_event), FM-13 (unbounded autonomy),
+ *        I-03 (atomic audit)
+ *
+ * Phase: 3 (Orchestration)
+ * Implements: Event emission with namespace validation, propagation
+ *             direction (up/down/local), lifecycle event restriction,
+ *             rate limiting per agent (10/minute per S36).
+ *
+ * SD-09: Reserved namespaces (system.*, lifecycle.*) are rejected from agent emission.
+ * SD-16: Rate limiting is enforced per agent, not per mission.
+ */
+import { generateId } from '../interfaces/orchestration.js';
+/** S10: Reserved event namespace prefixes -- agents cannot emit these */
+const RESERVED_PREFIXES = ['system.', 'lifecycle.'];
+// CF-013: Event payload size limit (64KB)
+const MAX_EVENT_PAYLOAD_BYTES = 65_536;
+/**
+ * S10: Create the event propagation module.
+ * Factory function returns frozen object per C-07.
+ */
+export function createEventPropagator() {
+    /**
+     * SD-16: In-memory rate limit tracking (10/minute per agent per S36).
+     * CF-007: Fallback only — when deps.rateLimiter is available, the kernel's
+     * SQLite-backed rate limiter is used instead for persistence across restarts.
+     *
+     * FO-003: This Map is bounded by distinct agent count (finite per deployment).
+     * Entries auto-reset their window after 60s of inactivity (line 45).
+     * Not cleaned on shutdown because the EventPropagator is GC'd with its parent.
+     * If multi-tenant scale exceeds 10,000 agents, consider explicit cap or WeakRef.
+     */
+    const rateLimitMap = new Map();
+    /** FM-13: In-memory fallback rate limit check */
+    function isRateLimitedFallback(agentId, nowMs) {
+        const entry = rateLimitMap.get(agentId);
+        if (!entry || nowMs - entry.windowStart > 60_000) {
+            rateLimitMap.set(agentId, { count: 1, windowStart: nowMs });
+            return false;
+        }
+        entry.count++;
+        return entry.count > 10;
+    }
+    /** S20: Emit an event (agent-callable, with namespace and rate restrictions) */
+    function emit(deps, ctx, input) {
+        // SD-09: Reject reserved namespaces
+        const eventTypeLower = input.eventType.toLowerCase();
+        for (const prefix of RESERVED_PREFIXES) {
+            if (eventTypeLower.startsWith(prefix)) {
+                return { ok: false, error: { code: 'INVALID_TYPE', message: `Event type '${input.eventType}' uses reserved namespace '${prefix}'`, spec: 'S20' } };
+            }
+        }
+        // CF-013: Validate event payload size
+        const payloadStr = typeof input.payload === 'string' ? input.payload : JSON.stringify(input.payload);
+        const payloadBytes = Buffer.byteLength(payloadStr, 'utf8');
+        if (payloadBytes > MAX_EVENT_PAYLOAD_BYTES) {
+            return { ok: false, error: { code: 'INVALID_INPUT', message: `Event payload exceeds maximum size (${payloadBytes} bytes > ${MAX_EVENT_PAYLOAD_BYTES} bytes limit)`, spec: 'S20/CF-013' } };
+        }
+        // Verify mission exists
+        const mission = deps.conn.get('SELECT id, parent_id, state FROM core_missions WHERE id = ?', [input.missionId]);
+        if (!mission) {
+            return { ok: false, error: { code: 'MISSION_NOT_FOUND', message: `Mission ${input.missionId} not found`, spec: 'S20' } };
+        }
+        // FM-13 / CF-007: Rate limiting (10/minute per agent per S36)
+        const agentId = (ctx.agentId ?? ctx.userId ?? 'unknown');
+        // CF-007: Use kernel's SQLite-backed rate limiter if available (persistent across restarts).
+        // Falls back to in-memory Map when rateLimiter is not injected (backward compatibility).
+        if (deps.rateLimiter) {
+            const rlResult = deps.rateLimiter.checkAndConsume(deps.conn, ctx, 'emit_event');
+            if (!rlResult.ok) {
+                return { ok: false, error: rlResult.error };
+            }
+            if (!rlResult.value) {
+                return { ok: false, error: { code: 'RATE_LIMITED', message: `Agent ${agentId} exceeds event rate limit`, spec: 'S20, §36' } };
+            }
+        }
+        else if (isRateLimitedFallback(agentId, deps.time.nowMs())) {
+            return { ok: false, error: { code: 'RATE_LIMITED', message: `Agent ${agentId} exceeds 10 events/minute`, spec: 'S20' } };
+        }
+        const eventId = generateId();
+        const now = deps.time.nowMs();
+        const isoNow = deps.time.nowISO();
+        const scope = 'mission';
+        deps.conn.transaction(() => {
+            // Store event in log
+            deps.conn.run(`INSERT INTO core_events_log (id, tenant_id, type, scope, mission_id, payload_json, propagation, emitted_by, timestamp_ms, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+                eventId,
+                ctx.tenantId,
+                input.eventType,
+                scope,
+                input.missionId,
+                JSON.stringify(input.payload),
+                input.propagation,
+                agentId,
+                now,
+                isoNow,
+            ]);
+            // Propagation: store propagated copies for parent/children
+            if (input.propagation === 'up' && mission.parent_id !== null) {
+                const propagatedId = generateId();
+                deps.conn.run(`INSERT INTO core_events_log (id, tenant_id, type, scope, mission_id, payload_json, propagation, emitted_by, timestamp_ms, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, 'local', ?, ?, ?)`, [propagatedId, ctx.tenantId, input.eventType, scope, mission.parent_id, JSON.stringify(input.payload), agentId, now, isoNow]);
+            }
+            else if (input.propagation === 'down') {
+                const children = deps.conn.query('SELECT id FROM core_missions WHERE parent_id = ?', [input.missionId]);
+                for (const child of children) {
+                    const propagatedId = generateId();
+                    deps.conn.run(`INSERT INTO core_events_log (id, tenant_id, type, scope, mission_id, payload_json, propagation, emitted_by, timestamp_ms, created_at)
+             VALUES (?, ?, ?, ?, ?, ?, 'local', ?, ?, ?)`, [propagatedId, ctx.tenantId, input.eventType, scope, child.id, JSON.stringify(input.payload), agentId, now, isoNow]);
+                }
+            }
+            // 'local' -- no propagation needed beyond the insertion
+            // I-03: Audit entry
+            deps.audit.append(deps.conn, {
+                tenantId: ctx.tenantId,
+                actorType: ctx.userId ? 'user' : 'agent',
+                actorId: agentId,
+                operation: 'emit_event',
+                resourceType: 'event',
+                resourceId: eventId,
+                detail: { eventType: input.eventType, missionId: input.missionId, propagation: input.propagation },
+            });
+        });
+        return {
+            ok: true,
+            value: { eventId, delivered: true },
+        };
+    }
+    /** S10: Emit a lifecycle event (orchestrator-only, not agent-callable) */
+    function emitLifecycle(deps, type, missionId, payload) {
+        const eventId = generateId();
+        const now = deps.time.nowMs();
+        const isoNow = deps.time.nowISO();
+        // Debt 3: Derive tenant_id from mission for audit trail
+        const missionRow = deps.conn.get('SELECT tenant_id FROM core_missions WHERE id = ?', [missionId]);
+        const lifecycleTenantId = (missionRow?.tenant_id ?? null);
+        // CQ-05 fix: I-03 -- lifecycle event INSERT + audit in same transaction
+        deps.conn.transaction(() => {
+            deps.conn.run(`INSERT INTO core_events_log (id, tenant_id, type, scope, mission_id, payload_json, propagation, emitted_by, timestamp_ms, created_at)
+         VALUES (?, ?, ?, 'system', ?, ?, 'up', 'orchestrator', ?, ?)`, [eventId, lifecycleTenantId, type, missionId, JSON.stringify(payload), now, isoNow]);
+            deps.audit.append(deps.conn, {
+                tenantId: lifecycleTenantId,
+                actorType: 'system',
+                actorId: 'orchestrator',
+                operation: 'emit_lifecycle_event',
+                resourceType: 'event',
+                resourceId: eventId,
+                detail: { type, missionId },
+            });
+        });
+        return { ok: true, value: eventId };
+    }
+    return Object.freeze({
+        emit,
+        emitLifecycle,
+    });
+}
+//# sourceMappingURL=event_propagation.js.map

package/dist/orchestration/events/event_propagation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event_propagation.js","sourceRoot":"","sources":["../../../src/orchestration/events/event_propagation.ts"],"names":[],"mappings":"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"}

package/dist/orchestration/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Orchestration Layer Facade -- createOrchestration() factory.
+ * S ref: SD-10 (explicit DI), C-07 (Object.freeze), S2 (three-layer model)
+ *
+ * Phase: 3 (Orchestration)
+ * Implements: The public entry point for the orchestration layer.
+ *             Constructs OrchestrationDeps, instantiates all internal modules,
+ *             and exposes the 10 system calls plus internal subsystem accessors.
+ *
+ * SD-10: OrchestrationDeps { conn, substrate, audit } injected at construction.
+ * C-07: Returned object is Object.freeze'd.
+ */
+import type { DatabaseConnection, AuditTrail, RateLimiter, TimeProvider } from '../kernel/interfaces/index.js';
+import type { Substrate } from '../substrate/interfaces/substrate.js';
+import type { OrchestrationEngine } from './interfaces/orchestration.js';
+export type { OrchestrationEngine, OrchestrationDeps } from './interfaces/orchestration.js';
+export { getPhase3Migrations } from './migration/003_orchestration.js';
+/**
+ * SD-10: Create the orchestration engine facade.
+ * C-07: Returns Object.freeze'd engine.
+ *
+ * @param conn - DatabaseConnection from kernel
+ * @param substrate - Substrate from phase 2
+ * @param audit - AuditTrail from kernel
+ * @param rateLimiter - Optional kernel rate limiter for persistent, SQLite-backed rate limiting (CF-007)
+ */
+export declare function createOrchestration(conn: DatabaseConnection, substrate: Substrate, audit: AuditTrail, rateLimiter?: RateLimiter, time?: TimeProvider): OrchestrationEngine;
+//# sourceMappingURL=index.d.ts.map

package/dist/orchestration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAA+B,WAAW,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC5I,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,KAAK,EACS,mBAAmB,EAWvC,MAAM,+BAA+B,CAAC;AA6BvC,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,kBAAkB,EACxB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,UAAU,EACjB,WAAW,CAAC,EAAE,WAAW,EACzB,IAAI,CAAC,EAAE,YAAY,GAClB,mBAAmB,CAmHrB"}

package/dist/orchestration/index.js

@@ -0,0 +1,147 @@
+/**
+ * Orchestration Layer Facade -- createOrchestration() factory.
+ * S ref: SD-10 (explicit DI), C-07 (Object.freeze), S2 (three-layer model)
+ *
+ * Phase: 3 (Orchestration)
+ * Implements: The public entry point for the orchestration layer.
+ *             Constructs OrchestrationDeps, instantiates all internal modules,
+ *             and exposes the 10 system calls plus internal subsystem accessors.
+ *
+ * SD-10: OrchestrationDeps { conn, substrate, audit } injected at construction.
+ * C-07: Returned object is Object.freeze'd.
+ */
+// Core module factories
+import { createMissionStore } from './missions/mission_store.js';
+import { createTaskGraphEngine } from './tasks/task_graph.js';
+import { createArtifactStore } from './artifacts/artifact_store.js';
+import { createEventPropagator } from './events/event_propagation.js';
+import { createBudgetGovernor } from './budget/budget_governance.js';
+import { createCheckpointCoordinator } from './checkpoints/checkpoint_coordinator.js';
+import { createConversationManager } from './conversation/conversation_manager.js';
+import { createCompactionEngine } from './compaction/bounded_cognition.js';
+// System call implementations
+import { proposeMission } from './syscalls/propose_mission.js';
+import { proposeTaskGraph } from './syscalls/propose_task_graph.js';
+import { proposeTaskExecution } from './syscalls/propose_task_execution.js';
+import { createArtifact } from './syscalls/create_artifact.js';
+import { readArtifact } from './syscalls/read_artifact.js';
+import { emitEvent } from './syscalls/emit_event.js';
+import { requestCapability } from './syscalls/request_capability.js';
+import { requestBudget } from './syscalls/request_budget.js';
+import { submitResult } from './syscalls/submit_result.js';
+import { respondCheckpoint } from './syscalls/respond_checkpoint.js';
+// FM-10: Tenant-scoped connection facade
+import { createTenantScopedConnection } from '../kernel/tenant/tenant_scope.js';
+export { getPhase3Migrations } from './migration/003_orchestration.js';
+/**
+ * SD-10: Create the orchestration engine facade.
+ * C-07: Returns Object.freeze'd engine.
+ *
+ * @param conn - DatabaseConnection from kernel
+ * @param substrate - Substrate from phase 2
+ * @param audit - AuditTrail from kernel
+ * @param rateLimiter - Optional kernel rate limiter for persistent, SQLite-backed rate limiting (CF-007)
+ */
+export function createOrchestration(conn, substrate, audit, rateLimiter, time) {
+    // Hard Stop #7: Default to system time if not injected (backward compatibility).
+    // Production callers should always provide kernel.time.
+    const resolvedTime = time ?? { nowISO: () => new Date().toISOString(), nowMs: () => Date.now() };
+    // SD-10: Construct the dependency injection container
+    // CF-007: Include rateLimiter in deps for persistent rate limiting in event propagation.
+    // exactOptionalPropertyTypes: only include rateLimiter when defined.
+    const baseDeps = { conn, substrate, audit, time: resolvedTime };
+    const deps = Object.freeze(rateLimiter ? { ...baseDeps, rateLimiter } : baseDeps);
+    /**
+     * FM-10: Create per-request tenant-scoped deps from OperationContext.
+     * In row-level mode: auto-injects AND tenant_id = ? into all queries.
+     * In single/database mode: pass-through (no-op).
+     * S ref: FM-10 (tenant data leakage prevention), RDD-3 (transparent tenancy)
+     */
+    function scopeDeps(ctx) {
+        if (conn.tenancyMode !== 'row-level' || !ctx.tenantId)
+            return deps;
+        return Object.freeze({
+            ...deps,
+            conn: createTenantScopedConnection(conn, ctx.tenantId),
+        });
+    }
+    // Instantiate all internal modules (C-07: each returns frozen object)
+    const missionStore = createMissionStore();
+    const taskGraphEngine = createTaskGraphEngine();
+    const artifactStore = createArtifactStore();
+    const eventPropagator = createEventPropagator();
+    const budgetGovernor = createBudgetGovernor();
+    const checkpointCoordinator = createCheckpointCoordinator();
+    const conversationManager = createConversationManager();
+    const compactionEngine = createCompactionEngine();
+    // FM-19: Delegation detector uses mission store's chain
+    const delegationDetector = Object.freeze({
+        checkCycle(depsDi, parentMissionId, agentId) {
+            const chainResult = this.getChain(depsDi, parentMissionId);
+            if (!chainResult.ok)
+                return chainResult;
+            return { ok: true, value: chainResult.value.includes(agentId) };
+        },
+        getChain(depsDi, missionId) {
+            const mission = missionStore.get(depsDi, missionId);
+            if (!mission.ok)
+                return { ok: false, error: mission.error };
+            return { ok: true, value: [...mission.value.delegationChain] };
+        },
+    });
+    // Build the facade with all 10 system calls
+    const engine = {
+        // SC-1: propose_mission
+        proposeMission(ctx, input) {
+            return proposeMission(scopeDeps(ctx), ctx, input, missionStore, eventPropagator);
+        },
+        // SC-2: propose_task_graph
+        proposeTaskGraph(ctx, input) {
+            return proposeTaskGraph(scopeDeps(ctx), ctx, input, taskGraphEngine, eventPropagator);
+        },
+        // SC-3: propose_task_execution
+        proposeTaskExecution(ctx, input) {
+            return proposeTaskExecution(scopeDeps(ctx), ctx, input, taskGraphEngine, budgetGovernor, eventPropagator);
+        },
+        // SC-4: create_artifact
+        createArtifact(ctx, input) {
+            return createArtifact(scopeDeps(ctx), ctx, input, artifactStore, eventPropagator);
+        },
+        // SC-5: read_artifact
+        readArtifact(ctx, input) {
+            return readArtifact(scopeDeps(ctx), ctx, input, artifactStore, eventPropagator);
+        },
+        // SC-6: emit_event
+        emitEvent(ctx, input) {
+            return emitEvent(scopeDeps(ctx), ctx, input, eventPropagator);
+        },
+        // SC-7: request_capability
+        requestCapability(ctx, input) {
+            return requestCapability(scopeDeps(ctx), ctx, input, budgetGovernor);
+        },
+        // SC-8: request_budget
+        requestBudget(ctx, input) {
+            return requestBudget(scopeDeps(ctx), ctx, input, budgetGovernor, eventPropagator, missionStore);
+        },
+        // SC-9: submit_result
+        submitResult(ctx, input) {
+            return submitResult(scopeDeps(ctx), ctx, input, missionStore, eventPropagator, compactionEngine);
+        },
+        // SC-10: respond_checkpoint
+        respondCheckpoint(ctx, input) {
+            return respondCheckpoint(scopeDeps(ctx), ctx, input, checkpointCoordinator);
+        },
+        // Internal subsystem access
+        missions: missionStore,
+        taskGraph: taskGraphEngine,
+        artifacts: artifactStore,
+        budget: budgetGovernor,
+        checkpoints: checkpointCoordinator,
+        compaction: compactionEngine,
+        events: eventPropagator,
+        conversations: conversationManager,
+        delegation: delegationDetector,
+    };
+    return Object.freeze(engine);
+}
+//# sourceMappingURL=index.js.map

package/dist/orchestration/index.js.map

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