trellis 2.1.7 → 3.0.2

package/dist/core/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * TrellisVCS Core — EAV Store, Kernel, Persistence, Middleware
+ *
+ * Inlined from trellis-core for single-package publish.
+ * Consumers: `import { EAVStore, Fact, TrellisKernel } from 'trellis/core'`
+ *
+ * @module trellis/core
+ */
+export { EAVStore, flatten, jsonEntityFacts } from './store/eav-store.js';
+export type { Atom, EntityRef, Fact, Link, CatalogEntry, QueryTraceEntry, QueryResult, } from './store/eav-store.js';
+export type { KernelOp, KernelOpKind, KernelBackend, } from './persist/backend.js';
+export type { KernelMiddleware, MiddlewareContext, OpMiddlewareNext, } from './kernel/middleware.js';
+export { SqliteKernelBackend } from './persist/sqlite-backend.js';
+export { QueryEngine, parseQuery, parseRule, parseSimple, DatalogRuntime, } from './query/index.js';
+export type { Query, Pattern, FactPattern, LinkPattern, Term, Variable, Literal, Filter, FilterOp, Aggregate, OrderBy, Bindings, DatalogRule, } from './query/index.js';
+export { OntologyRegistry, validateEntity, validateStore, createValidationMiddleware, } from './ontology/index.js';
+export { projectOntology, teamOntology, agentOntology, builtinOntologies, } from './ontology/index.js';
+export type { AttrType, AttributeDef, RelationDef, EntityDef, OntologySchema, ValidationError, ValidationResult, } from './ontology/index.js';
+export { AgentHarness } from './agents/index.js';
+export type { AgentDef, ToolDef, ToolHandler, ToolResult, AgentRun, DecisionTrace, RunStatus, AgentHarnessConfig, } from './agents/index.js';
+export { PluginRegistry, EventBus } from './plugins/index.js';
+export type { PluginDef, PluginContext, PluginManifest, EventCallback, EventHandler, WellKnownEvent, WorkspaceConfig, } from './plugins/index.js';
+export { TrellisKernel } from './kernel/trellis-kernel.js';
+export type { KernelConfig, MutateResult, EntityRecord, } from './kernel/trellis-kernel.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE1E,YAAY,EACV,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,YAAY,EACZ,eAAe,EACf,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGlE,OAAO,EACL,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,KAAK,EACL,OAAO,EACP,WAAW,EACX,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,MAAM,EACN,QAAQ,EACR,SAAS,EACT,OAAO,EACP,QAAQ,EACR,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,SAAS,EACT,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EACV,QAAQ,EACR,OAAO,EACP,WAAW,EACX,UAAU,EACV,QAAQ,EACR,aAAa,EACb,SAAS,EACT,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,4BAA4B,CAAC"}

package/dist/core/index.js

@@ -1,27 +1,33 @@
 // @bun
 import {
-  DatalogRuntime,
   OntologyRegistry,
   agentOntology,
   builtinOntologies,
   createValidationMiddleware,
-  parseQuery,
-  parseRule,
-  parseSimple,
   projectOntology,
   teamOntology,
   validateEntity,
   validateStore
-} from "../index-5m0g9r0y.js";
+} from "../index-w7ng765c.js";
+import {
+  DatalogRuntime,
+  parseQuery,
+  parseRule,
+  parseSimple
+} from "../index-n9f2qyh5.js";
 import {
-  EAVStore,
-  QueryEngine,
   SqliteKernelBackend,
-  TrellisKernel,
+  TrellisKernel
+} from "../index-0zk3fx2s.js";
+import {
+  EAVStore,
   flatten,
   init_eav_store,
   jsonEntityFacts
-} from "../index-hybgxe40.js";
+} from "../index-yhwjgfvj.js";
+import {
+  QueryEngine
+} from "../index-yp88he8n.js";
 import"../index-a76rekgs.js";
 
 // src/core/index.ts
@@ -41,6 +47,92 @@ class AgentHarness {
       ...config
     };
   }
+  async runAgentTask(agentId, input, opts) {
+    if (!this.config.llmProvider) {
+      throw new Error("AgentHarness: No llmProvider configured for autonomous tasks.");
+    }
+    const agent = this.getAgent(agentId);
+    if (!agent)
+      throw new Error(`Agent "${agentId}" not found.`);
+    const runId = await this.startRun(agentId, input);
+    const context = this.config.contextManager;
+    if (context && typeof context.createConversation === "function") {
+      const gcm = context;
+      if (opts?.conversationId) {
+        await gcm.resumeConversation(opts.conversationId);
+      } else {
+        const convId = await gcm.createConversation({
+          title: opts?.conversationTitle ?? input.slice(0, 80),
+          agentId,
+          model: agent.model
+        });
+        await this.kernel.addLink(runId, "hasConversation", convId);
+      }
+    }
+    if (context && agent.systemPrompt) {
+      context.addMessage({ role: "system", content: agent.systemPrompt });
+    }
+    if (context) {
+      context.addMessage({ role: "user", content: input });
+    }
+    let turnCount = 0;
+    const maxTurns = agent.maxTokens ?? 10;
+    try {
+      while (turnCount < maxTurns) {
+        turnCount++;
+        const messages = context ? context.getHistory() : [
+          ...agent.systemPrompt ? [{ role: "system", content: agent.systemPrompt }] : [],
+          { role: "user", content: input }
+        ];
+        const response = await this.config.llmProvider.complete(messages, {
+          model: agent.model,
+          temperature: agent.temperature,
+          tools: this._getAvailableTools(agent.tools)
+        });
+        const message = response.choices[0].message;
+        if (context)
+          context.addMessage(message);
+        if (message.tool_calls && message.tool_calls.length > 0) {
+          let planPending = false;
+          for (const call of message.tool_calls) {
+            const result = await this.invokeTool(runId, call.function.name, JSON.parse(call.function.arguments));
+            if (context) {
+              context.addMessage({
+                role: "tool",
+                tool_call_id: call.id,
+                name: call.function.name,
+                content: result.success ? JSON.stringify(result.output) : result.error ?? "Unknown error"
+              });
+            }
+            if (result.success && result.output && typeof result.output === "object" && result.output._planPending) {
+              planPending = true;
+            }
+          }
+          if (planPending) {
+            await this.kernel.updateEntity(runId, { status: "plan_pending" });
+            return runId;
+          }
+          continue;
+        }
+        await this.completeRun(runId, message.content ?? "", response.usage?.total_tokens);
+        return runId;
+      }
+      throw new Error(`Agent run exceeded maximum turns (${maxTurns}).`);
+    } catch (err) {
+      await this.failRun(runId, err.message);
+      throw err;
+    }
+  }
+  _getAvailableTools(toolIds) {
+    return this.listTools().filter((t) => toolIds.includes(t.id)).map((t) => ({
+      type: "function",
+      function: {
+        name: t.id,
+        description: t.description,
+        parameters: t.schema ? JSON.parse(t.schema) : { type: "object", properties: {} }
+      }
+    }));
+  }
   async createAgent(def) {
     const id = def.id ?? `agent:${def.name.toLowerCase().replace(/\s+/g, "-")}`;
     await this.kernel.createEntity(id, "Agent", {
@@ -132,7 +224,7 @@ class AgentHarness {
     if (output)
       updates.output = output;
     if (tokenCount !== undefined)
-      updates.tokenCount = tokenCount;
+      updates.totalTokens = tokenCount;
     await this.kernel.updateEntity(runId, updates);
   }
   async failRun(runId, error) {
@@ -161,7 +253,9 @@ class AgentHarness {
       status: get("status") ?? "running",
       input: get("input"),
       output: get("output"),
-      tokenCount: get("tokenCount"),
+      totalTokens: get("totalTokens"),
+      promptTokens: get("promptTokens"),
+      completionTokens: get("completionTokens"),
       decisions
     };
   }

package/dist/core/kernel/logic-middleware.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Logic Middleware
+ *
+ * Evaluates computed fields (formula, rollup, ai_generated) after queries.
+ * Runs post-query to enrich results with computed values.
+ */
+import type { KernelMiddleware } from './middleware.js';
+import type { SchemaDefinition } from '../ontology/types.js';
+export interface LogicMiddlewareConfig {
+    ontologies: Map<string, SchemaDefinition>;
+    /** Optional AI function for ai_generated fields */
+    generateAiField?: (prompt: string, context: Record<string, unknown>) => Promise<string>;
+}
+/**
+ * Creates a logic middleware that enriches query results with computed fields.
+ * This middleware hooks into queries, not mutations.
+ */
+export declare function createLogicMiddleware(config: LogicMiddlewareConfig): KernelMiddleware;
+//# sourceMappingURL=logic-middleware.d.ts.map

package/dist/core/kernel/logic-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logic-middleware.d.ts","sourceRoot":"","sources":["../../../src/core/kernel/logic-middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1C,mDAAmD;IACnD,eAAe,CAAC,EAAE,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,GAC5B,gBAAgB,CA0BlB"}

package/dist/core/kernel/middleware.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Kernel middleware types.
+ * Slim version inlined from trellis-core — only includes the types
+ * used by the VCS layer (op middleware). Query middleware types are
+ * omitted to avoid pulling in the full query engine dependency chain.
+ *
+ * @module trellis/core
+ */
+import type { KernelOp } from '../persist/backend.js';
+export type MiddlewareContext = {
+    agentId?: string;
+    [key: string]: unknown;
+};
+export type OpMiddlewareNext = (op: KernelOp, ctx: MiddlewareContext) => void | Promise<void>;
+export interface KernelMiddleware {
+    name: string;
+    /**
+     * Hook into kernel operations (mutations).
+     * Can throw to block the operation (e.g. for security).
+     */
+    handleOp?: (op: KernelOp, ctx: MiddlewareContext, next: OpMiddlewareNext) => void | Promise<void>;
+    /**
+     * Hook into kernel queries.
+     * Typed loosely here to avoid importing the full query engine.
+     */
+    handleQuery?: (query: unknown, ctx: MiddlewareContext, next: (...args: any[]) => any) => any;
+}
+//# sourceMappingURL=middleware.d.ts.map

package/dist/core/kernel/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/core/kernel/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAC7B,EAAE,EAAE,QAAQ,EACZ,GAAG,EAAE,iBAAiB,KACnB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,QAAQ,CAAC,EAAE,CACT,EAAE,EAAE,QAAQ,EACZ,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,gBAAgB,KACnB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,WAAW,CAAC,EAAE,CACZ,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,KAC1B,GAAG,CAAC;CACV"}

package/dist/core/kernel/schema-middleware.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Schema Validation Middleware
+ *
+ * Validates mutations against ontology schemas. Blocks operations that
+ * violate schema constraints (required fields, type mismatches, etc.).
+ */
+import type { KernelMiddleware } from './middleware.js';
+import type { SchemaDefinition } from '../ontology/types.js';
+export interface SchemaMiddlewareConfig {
+    ontologies: Map<string, SchemaDefinition>;
+    /** Whether to block on validation errors (default: true) */
+    strict?: boolean;
+}
+export declare function createSchemaMiddleware(config: SchemaMiddlewareConfig): KernelMiddleware;
+//# sourceMappingURL=schema-middleware.d.ts.map

package/dist/core/kernel/schema-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-middleware.d.ts","sourceRoot":"","sources":["../../../src/core/kernel/schema-middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1C,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,gBAAgB,CAmElB"}

package/dist/core/kernel/security-middleware.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Security Middleware
+ *
+ * Capability-based access control. Validates that the agent has permission
+ * to perform the requested operation on the target entity.
+ */
+import type { KernelMiddleware } from './middleware.js';
+export type Permission = 'read' | 'create' | 'update' | 'delete' | 'link' | 'unlink' | 'admin';
+export interface Capability {
+    /** What the capability applies to (entity ID, type, or '*' for all) */
+    resource: string;
+    /** Permissions granted */
+    permissions: Permission[];
+}
+export interface SecurityMiddlewareConfig {
+    /** Agent ID to capabilities map */
+    capabilities: Map<string, Capability[]>;
+    /** Default capabilities for agents not in the map */
+    defaultCapabilities?: Capability[];
+    /** If true, blocks operations without explicit grants. If false, allows by default. */
+    strict?: boolean;
+}
+export declare function createSecurityMiddleware(config: SecurityMiddlewareConfig): KernelMiddleware;
+//# sourceMappingURL=security-middleware.d.ts.map

package/dist/core/kernel/security-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security-middleware.d.ts","sourceRoot":"","sources":["../../../src/core/kernel/security-middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,mCAAmC;IACnC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACxC,qDAAqD;IACrD,mBAAmB,CAAC,EAAE,UAAU,EAAE,CAAC;IACnC,uFAAuF;IACvF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,gBAAgB,CAoElB"}

package/dist/core/kernel/sync-provider.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Sync Provider Interface
+ *
+ * Defines the contract for real-time sync and federation.
+ * Implementations handle applying remote operations and broadcasting local changes.
+ */
+import type { KernelOp } from '../persist/backend.js';
+/**
+ * Incoming remote operation from another peer.
+ */
+export interface RemoteOp {
+    op: KernelOp;
+    sourcePeerId: string;
+    timestamp: string;
+}
+/**
+ * Sync provider interface.
+ * Implement this to enable real-time sync between peers.
+ */
+export interface SyncProvider {
+    /**
+     * Initialize the sync provider.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the sync network.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Apply a remote operation from another peer.
+     * The kernel should apply this to its local store.
+     */
+    applyRemoteOperation(op: RemoteOp): Promise<void>;
+    /**
+     * Broadcast a local operation to other peers.
+     */
+    broadcast(op: KernelOp): Promise<void>;
+    /**
+     * Get the peer ID for this node.
+     */
+    getPeerId(): string;
+    /**
+     * Get list of connected peers.
+     */
+    getPeers(): string[];
+    /**
+     * Handle incoming operations (register callback).
+     */
+    onRemoteOp(callback: (op: RemoteOp) => void | Promise<void>): void;
+}
+/**
+ * Create a no-op sync provider for local-only mode.
+ */
+export declare function createLocalSyncProvider(): SyncProvider;
+//# sourceMappingURL=sync-provider.d.ts.map

package/dist/core/kernel/sync-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-provider.d.ts","sourceRoot":"","sources":["../../../src/core/kernel/sync-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,QAAQ,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,YAAY,CAWtD"}

package/dist/core/kernel/trellis-kernel.d.ts

@@ -0,0 +1,217 @@
+/**
+ * TrellisKernel — Generic Graph Kernel
+ *
+ * The composition root for the Trellis semantic kernel. Orchestrates the
+ * EAV store, persistence backend, middleware chain, and snapshot lifecycle.
+ *
+ * The VCS engine (`TrellisVcsEngine`) sits on top of this generic kernel.
+ * Non-VCS consumers can use TrellisKernel directly for pure graph CRUD.
+ *
+ * @module trellis/core
+ */
+import { EAVStore } from '../store/eav-store.js';
+import type { Fact, Link, Atom } from '../store/eav-store.js';
+import type { KernelOp, KernelOpKind, KernelBackend } from '../persist/backend.js';
+import type { KernelMiddleware, MiddlewareContext } from './middleware.js';
+import { QueryEngine } from '../query/engine.js';
+import type { Query } from '../query/types.js';
+import type { QueryResult } from '../query/engine.js';
+import type { SchemaDefinition, WorkspaceConfig } from '../ontology/types.js';
+export interface KernelConfig {
+    /** Persistence backend (SQLite or in-memory). */
+    backend: KernelBackend;
+    /** Agent ID for attributing operations. */
+    agentId: string;
+    /** Middleware chain applied to every mutation. */
+    middleware?: KernelMiddleware[];
+    /** Auto-snapshot after this many ops (0 = disabled). */
+    snapshotThreshold?: number;
+    /** Auto-replay ops from backend on boot (default: true). */
+    autoReplay?: boolean;
+}
+export interface MutateResult {
+    op: KernelOp;
+    factsDelta: {
+        added: number;
+        deleted: number;
+    };
+    linksDelta: {
+        added: number;
+        deleted: number;
+    };
+}
+export interface EntityRecord {
+    id: string;
+    type: string;
+    facts: Fact[];
+    links: Link[];
+}
+export declare class TrellisKernel {
+    private store;
+    private backend;
+    private middleware;
+    private agentId;
+    private snapshotThreshold;
+    private opsSinceSnapshot;
+    private _booted;
+    private ontologies;
+    private workspaceConfig;
+    private autoReplay;
+    constructor(config: KernelConfig);
+    /**
+     * Initialize the backend and replay persisted state.
+     * Loads latest snapshot if available, then replays ops after it.
+     */
+    boot(): {
+        opsReplayed: number;
+        fromSnapshot: boolean;
+    };
+    /**
+     * Close the backend connection.
+     */
+    close(): void;
+    isBooted(): boolean;
+    /**
+     * Apply a mutation to the graph. Creates an op, runs it through middleware,
+     * decomposes into EAV primitives, persists, and returns the result.
+     */
+    mutate(kind: KernelOpKind | string, payload: {
+        facts?: Fact[];
+        links?: Link[];
+        deleteFacts?: Fact[];
+        deleteLinks?: Link[];
+        meta?: Record<string, unknown>;
+    }, ctx?: Partial<MiddlewareContext>): Promise<MutateResult>;
+    /**
+     * Create a snapshot of the current store state.
+     */
+    checkpoint(): void;
+    /**
+     * Get the underlying EAV store for direct queries.
+     */
+    getStore(): EAVStore;
+    /**
+     * Get the persistence backend.
+     */
+    getBackend(): KernelBackend;
+    /**
+     * Get the agent ID.
+     */
+    getAgentId(): string;
+    /**
+     * Read all persisted ops.
+     */
+    readAllOps(): KernelOp[];
+    /**
+     * Get the last persisted op.
+     */
+    getLastOp(): KernelOp | undefined;
+    /**
+     * Create a QueryEngine bound to this kernel's store.
+     */
+    createQueryEngine(): QueryEngine;
+    /**
+     * Execute an EQL-S query, routing through middleware handleQuery hooks.
+     * If no middleware intercepts, the query runs directly against the store.
+     */
+    query(q: Query): Promise<QueryResult>;
+    /**
+     * Time-travel: reconstruct the store state at a specific op hash.
+     * Returns a new EAVStore with state replayed up to (and including) that op.
+     */
+    timeTravel(opHash: string): EAVStore;
+    /**
+     * Create a new entity with the given type and attributes.
+     * Returns the entity ID.
+     */
+    createEntity(entityId: string, type: string, attributes?: Record<string, Atom>, links?: Array<{
+        attribute: string;
+        targetEntityId: string;
+    }>): Promise<MutateResult>;
+    /**
+     * Get an entity by ID, returning all its facts and links.
+     */
+    getEntity(entityId: string): EntityRecord | null;
+    /**
+     * Update an entity's attributes. Deletes old values and adds new ones.
+     */
+    updateEntity(entityId: string, updates: Record<string, Atom>): Promise<MutateResult>;
+    /**
+     * Delete an entity and all its facts and links.
+     */
+    deleteEntity(entityId: string): Promise<MutateResult>;
+    /**
+     * List entities by type, with optional attribute filters.
+     */
+    listEntities(type?: string, filters?: Record<string, Atom>): EntityRecord[];
+    /**
+     * Add a link between two entities.
+     */
+    addLink(sourceId: string, attribute: string, targetId: string): Promise<MutateResult>;
+    /**
+     * Remove a link between two entities.
+     */
+    removeLink(sourceId: string, attribute: string, targetId: string): Promise<MutateResult>;
+    /**
+     * Add a fact to an entity.
+     */
+    addFact(entityId: string, attribute: string, value: Atom): Promise<MutateResult>;
+    /**
+     * Remove a fact from an entity.
+     */
+    removeFact(entityId: string, attribute: string, value: Atom): Promise<MutateResult>;
+    /**
+     * Get an ontology schema by ID.
+     */
+    getOntology(id: string): SchemaDefinition | undefined;
+    /**
+     * List all ontologies.
+     */
+    listOntologies(): SchemaDefinition[];
+    /**
+     * Create a new ontology schema.
+     */
+    createOntology(schema: SchemaDefinition): void;
+    /**
+     * Update an existing ontology schema.
+     */
+    updateOntology(id: string, updates: Partial<SchemaDefinition>): void;
+    /**
+     * Delete an ontology schema.
+     */
+    deleteOntology(id: string): void;
+    /**
+     * Boot the kernel with a workspace configuration.
+     * Loads ontologies, projections, and seed data.
+     */
+    bootWorkspace(config: WorkspaceConfig): void;
+    /**
+     * Export the current workspace configuration.
+     */
+    exportWorkspace(): WorkspaceConfig;
+    /**
+     * Create a node (alias for createEntity with schema validation).
+     */
+    createNode(id: string, data: Record<string, Atom>, type: string, _ctx?: Partial<MiddlewareContext>): Promise<MutateResult>;
+    /**
+     * Update a node (alias for updateEntity with schema validation).
+     */
+    updateNode(id: string, data: Record<string, Atom>, type: string, _ctx?: Partial<MiddlewareContext>): Promise<MutateResult>;
+    /**
+     * Delete a node (alias for deleteEntity).
+     */
+    deleteNode(id: string, _ctx?: Partial<MiddlewareContext>): Promise<MutateResult>;
+    /**
+     * Link two nodes (alias for addLink).
+     */
+    link(e1: string, a: string, e2: string, _ctx?: Partial<MiddlewareContext>): Promise<MutateResult>;
+    /**
+     * Unlink two nodes (alias for removeLink).
+     */
+    unlink(e1: string, a: string, e2: string, _ctx?: Partial<MiddlewareContext>): Promise<MutateResult>;
+    addMiddleware(mw: KernelMiddleware): void;
+    removeMiddleware(name: string): void;
+    private _runMiddleware;
+    private _replayOp;
+}
+//# sourceMappingURL=trellis-kernel.d.ts.map

package/dist/core/kernel/trellis-kernel.d.ts.map

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

package/dist/core/ontology/builtins.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Built-in Ontology Definitions
+ *
+ * Pre-defined ontologies for common domain models:
+ *   - Project: software project management entities
+ *   - Team: team/developer organizational entities
+ *   - Agent: AI agent entities for the agent harness
+ *
+ * @module trellis/core/ontology
+ */
+import type { OntologySchema } from './types.js';
+export declare const projectOntology: OntologySchema;
+export declare const teamOntology: OntologySchema;
+export declare const agentOntology: OntologySchema;
+export declare const builtinOntologies: OntologySchema[];
+//# sourceMappingURL=builtins.d.ts.map

package/dist/core/ontology/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../../src/core/ontology/builtins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,eAAO,MAAM,eAAe,EAAE,cAwF7B,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,cAqD1B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,cAqE3B,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAI7C,CAAC"}

package/dist/core/ontology/core-ontology.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Core Ontology — Built-in structural type hierarchy
+ *
+ * These types are immutable and ship with the Trellis kernel.
+ * They define the foundational type system that all system
+ * and user ontologies extend.
+ *
+ * tier: 'core' — kernel rejects mutations to these schemas.
+ */
+import type { SchemaDefinition } from './types.js';
+/**
+ * All core structural type schemas.
+ * Auto-loaded into the kernel at construction time.
+ */
+export declare const CORE_ONTOLOGY: SchemaDefinition[];
+/**
+ * Core ontology version.
+ */
+export declare const CORE_VERSION = "1.0.0";
+//# sourceMappingURL=core-ontology.d.ts.map

package/dist/core/ontology/core-ontology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-ontology.d.ts","sourceRoot":"","sources":["../../../src/core/ontology/core-ontology.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAA8B,MAAM,YAAY,CAAC;AAwU/E;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,gBAAgB,EAc3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,UAAU,CAAC"}

package/dist/core/ontology/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Ontology Module — Public API Surface
+ *
+ * @module trellis/core/ontology
+ */
+export type { PropertyType, OntologyTier, PropertyValueSpecification, RelationConfig, RollupConfig, AiGeneratedConfig, EntityClass, SchemaDefinition, ProjectionDefinition, RouteDefinition, WorkspaceConfig, AttrType, AttributeDef, RelationDef, EntityDef, OntologySchema, ValidationError, ValidationResult, } from './types.js';
+export type { Atom } from '../store/eav-store.js';
+export { CORE_ONTOLOGY, CORE_VERSION } from './core-ontology.js';
+export { OntologyRegistry } from './registry.js';
+export { projectOntology, teamOntology, agentOntology, builtinOntologies, } from './builtins.js';
+export { validateEntity, validateStore, createValidationMiddleware, } from './validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/ontology/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/ontology/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,0BAA0B,EAC1B,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,SAAS,EACT,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,aAAa,EACb,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC"}