@feltdb/core 0.2.0

package/README.md

@@ -0,0 +1,184 @@
+# @feltdb/core
+
+The main FeltDB API. This package provides a simple, state-first interface for working with FeltDB.
+
+## Installation
+
+```bash
+npm install @feltdb/core
+```
+
+## Quick Start
+
+```typescript
+import { createFeltDB } from '@feltdb/core';
+
+const db = createFeltDB({
+  namespace: 'my-app',
+  server: {
+    url: 'https://db.example.com',
+    token: process.env.FELTDB_API_KEY!,
+  },
+});
+
+const todos = db.collection('todos');
+
+// Insert
+await todos.insert({
+  id: '1',
+  title: 'Learn FeltDB',
+  completed: false,
+});
+
+// Query
+const items = await todos.find({ completed: false });
+
+// Update
+await todos.update('1', { completed: true });
+
+// Subscribe to changes
+todos.subscribe((change) => {
+  console.log('Collection changed:', change);
+});
+```
+
+For a durable offline browser database using the same API:
+
+```typescript
+const db = createFeltDB({ namespace: 'my-app', browser: true });
+const todos = db.collection<Todo>('todos');
+```
+
+Browser mutations resolve after their IndexedDB transaction commits. The
+durable change journal replays after reload and coordinates live collections
+across tabs through `BroadcastChannel` when available.
+
+## API
+
+### createFeltDB(options)
+
+Initialize a new FeltDB instance.
+
+**Options:**
+- `namespace` (string) - Application namespace for data isolation
+- `server` - Durable authenticated FeltDB server (`url` and `token`)
+- `memory: true` - Explicit ephemeral development/test runtime; never use for customer data
+- `browser: true` - Durable IndexedDB runtime with restart-safe change replay
+
+**Returns:** Database instance
+
+### db.collection(name)
+
+Get or create a collection.
+
+**Parameters:**
+- `name` (string) - Collection name
+
+**Returns:** Collection instance
+
+### collection.insert(item)
+
+Insert a new item into the collection.
+
+**Parameters:**
+- `item` (object) - Item to insert
+
+**Returns:** Promise<string> - Item ID
+
+### collection.find(query)
+
+Query items from the collection.
+
+**Parameters:**
+- `query` (object) - Query filter
+
+**Returns:** Promise<Array> - Matching items
+
+### collection.update(id, updates)
+
+Update an item in the collection.
+
+**Parameters:**
+- `id` (string) - Item ID
+- `updates` (object) - Fields to update
+
+**Returns:** Promise<void>
+
+### collection.delete(id)
+
+Remove an item from the collection.
+
+**Parameters:**
+- `id` (string) - Item ID
+
+**Returns:** Promise<void>
+
+### collection.subscribe(callback)
+
+Subscribe to collection changes.
+
+**Parameters:**
+- `callback` (function) - Called when collection changes
+
+**Returns:** Function - Unsubscribe function
+
+### Network acquisition and state-first execution
+
+```typescript
+const task = await db.acquire<Task>('tasks', 'task-42');
+const matches = await db.search<Task>('tasks', 'shipping blocker');
+const artifact = await db.storeContent(new TextEncoder().encode('release artifact'));
+const verifiedBytes = await db.acquireContent(artifact.hash);
+
+await db.defineCapability('open-tasks', [
+  { op: 'search', collection: 'tasks', query: '' },
+  { op: 'filter_eq', field: 'done', value: false },
+  { op: 'limit', count: 100 },
+]);
+
+await db.defineWorkflow('release', ['verify', 'publish']);
+const run = await db.startWorkflow('release', { version: '1.0.0' });
+const claimed = await db.claimWorkflowStep(run.value.id, 'verify', 'worker-1');
+await db.completeWorkflowStep(
+  run.value.id, 'verify', claimed.value.steps[0].claim_id, { ok: true },
+);
+
+await db.defineStateAgent('triage', ['search']);
+const agentRun = await db.startStateAgent('triage', 'resolve customer blocker');
+```
+
+Acquisition synchronizes canonical causal operations from configured peers.
+Workflow and agent lifecycle records are canonical collections, so durability,
+live events, replication, authorization, and audit apply automatically.
+Execution claims use durable majority leases when peers are configured; stale
+or minority-partition workers cannot publish completion.
+
+### Embedded replica convergence and capability failover
+
+```typescript
+const command = createFeltDB({ namespace: 'command', browser: true });
+const field = createFeltDB({ namespace: 'field', browser: true });
+
+// Both replicas continue accepting durable state while disconnected.
+await command.collection('resources').insert(resource, 'water-team');
+await field.collection('incidents').insert(incident, 'clinic');
+
+// Transport-independent, bidirectional operation exchange. Replays deduplicate.
+await command.synchronizeWith(field);
+
+field.registerCapabilityWorker('AssessIncident', assessIncident);
+const routed = await command.executeCapabilityWithFailover(
+  'AssessIncident', { incident }, [field],
+);
+```
+
+`exportOperations()` and `applyOperations()` are also available when the
+application supplies its own transport. Merges use stable operation identity
+and deterministic last-writer ordering, notify live collections, and retain
+the imported operations in the local audit journal. Capability routing records
+every provider attempt in `_flow_capability_routes`; each successful worker
+execution is materialized in `_flow_executions`.
+
+## License
+
+MIT

package/dist/agent-decision.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Agent Decision
+ *
+ * A first-class decision made by an agent with full provenance.
+ * Decisions are audit/provenance explanations, not hidden chain-of-thought.
+ */
+/**
+ * An action the agent could take
+ */
+export interface AgentAction {
+    /** Unique action ID */
+    actionId: string;
+    /** Reference to the capability to invoke */
+    capabilityRef: string;
+    /** Input parameters for the capability */
+    inputs?: Record<string, any>;
+    /** Expected outcomes */
+    expectedOutcome?: string;
+    /** Confidence level (0-100) */
+    confidence?: number;
+    /** Why this action was selected */
+    reasoning?: string;
+}
+/**
+ * A decision made by an agent
+ */
+export interface AgentDecision {
+    /** Unique decision ID */
+    decisionId: string;
+    /** Reference to the observing agent */
+    agentRef: {
+        name: string;
+        version: number;
+    };
+    /** Execution ID that made this decision */
+    executionId: string;
+    /** Observation that prompted this decision */
+    observationId: string;
+    /** The agent's intent */
+    intent: string;
+    /** The action the agent decided to take */
+    selectedAction: AgentAction;
+    /** Alternative actions considered */
+    alternatives?: AgentAction[];
+    /** Structured reasoning for the decision */
+    reason: {
+        /** Why this action was selected */
+        primary: string;
+        /** Constraints that were considered */
+        constraints?: string[];
+        /** State that influenced the decision */
+        stateFactors?: string[];
+        /** Capabilities that were available */
+        availableCapabilities?: string[];
+        /** Policy considerations */
+        policyFactors?: string[];
+    };
+    /** Confidence in this decision (0-100) */
+    confidence: number;
+    /** Whether this decision required human approval */
+    requiresApproval?: boolean;
+    /** Approval status if required */
+    approvalStatus?: 'pending' | 'approved' | 'rejected' | 'cancelled';
+    /** Approval timestamp if applicable */
+    approvedAt?: number;
+    /** Approver identity if applicable */
+    approvedBy?: string;
+    /** Timestamp when decision was made */
+    decidedAt: number;
+    /** Metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Generate a unique decision ID
+ */
+export declare function generateDecisionId(): string;
+/**
+ * Generate a unique action ID
+ */
+export declare function generateActionId(): string;
+//# sourceMappingURL=agent-decision.d.ts.map

package/dist/agent-decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-decision.d.ts","sourceRoot":"","sources":["../src/agent-decision.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IAEjB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IAEtB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE7B,wBAAwB;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IAEnB,uCAAuC;IACvC,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IAEpB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IAEtB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IAEf,2CAA2C;IAC3C,cAAc,EAAE,WAAW,CAAC;IAE5B,qCAAqC;IACrC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAE7B,4CAA4C;IAC5C,MAAM,EAAE;QACN,mCAAmC;QACnC,OAAO,EAAE,MAAM,CAAC;QAEhB,uCAAuC;QACvC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QAEvB,yCAAyC;QACzC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QAExB,uCAAuC;QACvC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;QAEjC,4BAA4B;QAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IAEF,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IAEnB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,kCAAkC;IAClC,cAAc,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAEnE,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAElB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/agent-decision.js

@@ -0,0 +1,18 @@
+/**
+ * Agent Decision
+ *
+ * A first-class decision made by an agent with full provenance.
+ * Decisions are audit/provenance explanations, not hidden chain-of-thought.
+ */
+/**
+ * Generate a unique decision ID
+ */
+export function generateDecisionId() {
+    return `dec-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}
+/**
+ * Generate a unique action ID
+ */
+export function generateActionId() {
+    return `act-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}

package/dist/agent-memory.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Agent Memory
+ *
+ * Agent memory is just FeltDB state. Memory is stored as collections
+ * under flow://agent/{name}/memory/*
+ */
+/**
+ * Agent memory configuration
+ */
+export interface AgentMemoryConfig {
+    /** Agent name */
+    agentName: string;
+    /** Maximum memory size in KB */
+    maxSizeKb?: number;
+    /** Memory retention period in milliseconds */
+    retentionMs?: number;
+    /** Memory scope */
+    scope: 'local' | 'distributed' | 'shared';
+    /** Whether to enable memory persistence */
+    persistent: boolean;
+}
+/**
+ * Memory entry stored in an agent's memory collection
+ */
+export interface AgentMemoryEntry {
+    /** Unique entry ID */
+    entryId: string;
+    /** Entry key for lookup */
+    key: string;
+    /** Entry value */
+    value: any;
+    /** Entry type */
+    type: 'fact' | 'observation' | 'decision' | 'outcome' | 'goal' | 'plan';
+    /** When this entry was created */
+    createdAt: number;
+    /** When this entry expires (optional) */
+    expiresAt?: number;
+    /** Whether this entry is still valid */
+    valid: boolean;
+    /** Metadata about the entry */
+    metadata?: Record<string, any>;
+}
+/**
+ * Agent memory query result
+ */
+export interface AgentMemoryResult {
+    /** Retrieved memory entries */
+    entries: AgentMemoryEntry[];
+    /** Total count of matching entries */
+    total: number;
+    /** Query execution time in milliseconds */
+    durationMs: number;
+}
+/**
+ * Memory collection reference for an agent
+ */
+export declare function getAgentMemoryPath(agentName: string, memoryType?: string): string;
+/**
+ * Generate a unique memory entry ID
+ */
+export declare function generateMemoryEntryId(): string;
+/**
+ * Agent memory store interface
+ */
+export interface AgentMemoryStore {
+    /**
+     * Store a memory entry
+     */
+    store(agentName: string, entry: AgentMemoryEntry): Promise<void>;
+    /**
+     * Retrieve a memory entry by key
+     */
+    retrieve(agentName: string, key: string): Promise<AgentMemoryEntry | null>;
+    /**
+     * Retrieve all memory entries of a type
+     */
+    retrieveByType(agentName: string, type: AgentMemoryEntry['type']): Promise<AgentMemoryEntry[]>;
+    /**
+     * Query memory entries
+     */
+    query(agentName: string, filter: Record<string, any>): Promise<AgentMemoryResult>;
+    /**
+     * Delete a memory entry
+     */
+    delete(agentName: string, key: string): Promise<void>;
+    /**
+     * Clear all memory for an agent
+     */
+    clear(agentName: string): Promise<void>;
+}
+//# sourceMappingURL=agent-memory.d.ts.map

package/dist/agent-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-memory.d.ts","sourceRoot":"","sources":["../src/agent-memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mBAAmB;IACnB,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;IAE1C,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IAEZ,kBAAkB;IAClB,KAAK,EAAE,GAAG,CAAC;IAEX,iBAAiB;IACjB,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAExE,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IAEf,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAE5B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IAEd,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,MAAW,GAAG,MAAM,CAKrF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAE3E;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAE/F;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAElF;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

package/dist/agent-memory.js

@@ -0,0 +1,21 @@
+/**
+ * Agent Memory
+ *
+ * Agent memory is just FeltDB state. Memory is stored as collections
+ * under flow://agent/{name}/memory/*
+ */
+/**
+ * Memory collection reference for an agent
+ */
+export function getAgentMemoryPath(agentName, memoryType = '') {
+    if (memoryType) {
+        return `flow://agent/${agentName}/memory/${memoryType}`;
+    }
+    return `flow://agent/${agentName}/memory`;
+}
+/**
+ * Generate a unique memory entry ID
+ */
+export function generateMemoryEntryId() {
+    return `mem-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}

package/dist/agent-observation.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Agent Observation
+ *
+ * A first-class observation of state changes that can trigger agent reactions.
+ * Agents observe references to data, not arbitrary blobs.
+ */
+/**
+ * An observation made by or about an agent
+ */
+export interface AgentObservation {
+    /** Unique observation ID */
+    observationId: string;
+    /** Reference to the observing agent */
+    agentRef: {
+        name: string;
+        version: number;
+    };
+    /** Execution that produced this observation */
+    executionId: string;
+    /** State version at time of observation */
+    stateVersion: number;
+    /** Input references that were observed */
+    sourceRefs: string[];
+    /** Observations about the state */
+    observations: {
+        /** Reference to observed data */
+        ref: string;
+        /** What changed */
+        change: 'created' | 'updated' | 'deleted';
+        /** Previous value (if available) */
+        previous?: any;
+        /** Current value */
+        current?: any;
+        /** Timestamp of the change */
+        changedAt: number;
+    }[];
+    /** Timestamp when observation was recorded */
+    recordedAt: number;
+    /** Metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Reactive observation trigger
+ *
+ * Specifies conditions that should wake an agent
+ */
+export interface ObservationTrigger {
+    /** Which state patterns to watch */
+    patterns: string[];
+    /** Trigger on these change types */
+    changeTypes: ('created' | 'updated' | 'deleted')[];
+    /** Optional debounce time in milliseconds */
+    debounceMs?: number;
+    /** Optional timeout - max wait time in milliseconds */
+    timeoutMs?: number;
+}
+/**
+ * Generate a unique observation ID
+ */
+export declare function generateObservationId(): string;
+//# sourceMappingURL=agent-observation.d.ts.map

package/dist/agent-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-observation.d.ts","sourceRoot":"","sources":["../src/agent-observation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;IAEtB,uCAAuC;IACvC,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IAEpB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IAErB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,mCAAmC;IACnC,YAAY,EAAE;QACZ,iCAAiC;QACjC,GAAG,EAAE,MAAM,CAAC;QAEZ,mBAAmB;QACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;QAE1C,oCAAoC;QACpC,QAAQ,CAAC,EAAE,GAAG,CAAC;QAEf,oBAAoB;QACpB,OAAO,CAAC,EAAE,GAAG,CAAC;QAEd,8BAA8B;QAC9B,SAAS,EAAE,MAAM,CAAC;KACnB,EAAE,CAAC;IAEJ,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IAEnB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,oCAAoC;IACpC,WAAW,EAAE,CAAC,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC;IAEnD,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/agent-observation.js

@@ -0,0 +1,12 @@
+/**
+ * Agent Observation
+ *
+ * A first-class observation of state changes that can trigger agent reactions.
+ * Agents observe references to data, not arbitrary blobs.
+ */
+/**
+ * Generate a unique observation ID
+ */
+export function generateObservationId() {
+    return `obs-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}

package/dist/agent-registry.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Agent Registry
+ *
+ * Similar to PeerRegistry and CapabilityLocationRegistry.
+ * Maps AgentRef to Agent definition, available providers, and compatible state.
+ */
+import type { AgentDefinition, AgentRef } from './agent.js';
+/**
+ * Information about an agent provider
+ */
+export interface AgentProvider {
+    /** Peer ID that provides this agent */
+    peerId: string;
+    /** Whether this peer is currently available */
+    available: boolean;
+    /** State version this peer has */
+    stateVersion: number;
+    /** Timestamp of last heartbeat */
+    lastHeartbeat: number;
+    /** Capabilities this provider supports */
+    capabilities: string[];
+}
+/**
+ * Agent registration entry in the registry
+ */
+export interface AgentRegistryEntry {
+    /** The agent reference */
+    agentRef: AgentRef;
+    /** Agent definition */
+    definition: AgentDefinition;
+    /** Available providers for this agent */
+    providers: AgentProvider[];
+    /** Compatible state versions */
+    compatibleStateVersions: number[];
+    /** When this entry was registered */
+    registeredAt: number;
+    /** Last update timestamp */
+    updatedAt: number;
+    /** Is this agent currently active */
+    active: boolean;
+}
+/**
+ * Registry for agent definitions and discovery
+ */
+export declare class AgentRegistry {
+    private agents;
+    /**
+     * Register an agent definition
+     */
+    register(agentRef: AgentRef, definition: AgentDefinition): void;
+    /**
+     * Unregister an agent
+     */
+    unregister(agentRef: AgentRef): void;
+    /**
+     * Get an agent registration entry
+     */
+    get(agentRef: AgentRef): AgentRegistryEntry | undefined;
+    /**
+     * Get agent by name (returns latest version)
+     */
+    getByName(name: string): AgentRegistryEntry | undefined;
+    /**
+     * Get all registered agents
+     */
+    getAll(): AgentRegistryEntry[];
+    /**
+     * Add a provider for an agent
+     */
+    addProvider(agentRef: AgentRef, provider: AgentProvider): void;
+    /**
+     * Remove a provider
+     */
+    removeProvider(agentRef: AgentRef, peerId: string): void;
+    /**
+     * Get available providers for an agent
+     */
+    getAvailableProviders(agentRef: AgentRef): AgentProvider[];
+    /**
+     * Find agents by capability
+     */
+    findByCapability(capability: string): AgentRegistryEntry[];
+    /**
+     * Update agent availability
+     */
+    updateAvailability(agentRef: AgentRef, peerId: string, available: boolean): void;
+    /**
+     * Clear all registrations
+     */
+    clear(): void;
+}
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../src/agent-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;IAEnB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IAErB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;IAEtB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IAEnB,uBAAuB;IACvB,UAAU,EAAE,eAAe,CAAC;IAE5B,yCAAyC;IACzC,SAAS,EAAE,aAAa,EAAE,CAAC;IAE3B,gCAAgC;IAChC,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAElC,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IAErB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA8C;IAE5D;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI;IAgB/D;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAKpC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS;IAKvD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAcvD;;OAEG;IACH,MAAM,IAAI,kBAAkB,EAAE;IAI9B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAgB9D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAYxD;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,EAAE;IAS1D;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAY1D;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAehF;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}