@plures/praxis 0.2.1 → 1.0.0

package/dist/src/integrations/unum.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Unum Integration
+ *
+ * Integration with plures/unum - A modern Svelte binding library for PluresDB
+ * with full Svelte 5 compatibility. Provides identity and channels support.
+ *
+ * Features:
+ * - Svelte 4 & 5 Compatible: Works with both store-based and runes-based reactivity
+ * - Type-Safe: Full TypeScript support with proper types
+ * - Action-Based: Modern Svelte actions for DOM binding
+ * - Store-Based: Writable store implementation for reactive data
+ * - Collection Support: Easy handling of PluresDB collections
+ *
+ * @see https://github.com/plures/unum
+ */
+import type { LogicEngine } from "../core/engine.js";
+import type { PraxisEvent, PraxisFact } from "../core/protocol.js";
+import type { PraxisDB } from "../core/pluresdb/adapter.js";
+/**
+ * Unum store interface for reactive PluresDB data
+ */
+export interface UnumStore<T> {
+    subscribe(run: (value: T) => void): () => void;
+    set(value: T): void;
+    update(updater: (value: T) => T): void;
+}
+/**
+ * Unum channel for real-time communication
+ */
+export interface UnumChannel {
+    /** Channel identifier */
+    id: string;
+    /** Channel name */
+    name: string;
+    /** Subscribe to channel messages */
+    subscribe(handler: (message: UnumMessage) => void): () => void;
+    /** Publish a message to the channel */
+    publish(message: Omit<UnumMessage, 'timestamp' | 'channelId'>): Promise<void>;
+    /** Get channel members */
+    getMembers(): Promise<UnumIdentity[]>;
+    /** Leave the channel */
+    leave(): Promise<void>;
+}
+/**
+ * Message sent through a Unum channel
+ */
+export interface UnumMessage {
+    /** Message ID */
+    id: string;
+    /** Channel ID */
+    channelId: string;
+    /** Sender identity */
+    sender: UnumIdentity;
+    /** Message content */
+    content: unknown;
+    /** Message type */
+    type: 'text' | 'event' | 'fact' | 'system';
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Unum identity representing a user or system
+ */
+export interface UnumIdentity {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    name?: string;
+    /** Public key for encryption */
+    publicKey?: string;
+    /** Identity metadata */
+    metadata?: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt: number;
+    /** Last seen timestamp */
+    lastSeen?: number;
+}
+/**
+ * Unum adapter configuration
+ */
+export interface UnumAdapterConfig {
+    /** PluresDB instance to use */
+    db: PraxisDB;
+    /** Current user identity */
+    identity?: UnumIdentity;
+    /** Whether to enable real-time sync */
+    realtime?: boolean;
+    /** Sync interval in milliseconds */
+    syncInterval?: number;
+}
+/**
+ * Unum adapter for Praxis engine integration
+ *
+ * Provides identity management and channel-based communication
+ * for distributed Praxis applications.
+ */
+export interface UnumAdapter {
+    /** Current identity */
+    identity: UnumIdentity | null;
+    /** Create or update identity */
+    setIdentity(identity: Omit<UnumIdentity, 'id' | 'createdAt'>): Promise<UnumIdentity>;
+    /** Get identity by ID */
+    getIdentity(id: string): Promise<UnumIdentity | null>;
+    /** Create a new channel */
+    createChannel(name: string, members?: string[]): Promise<UnumChannel>;
+    /** Join an existing channel */
+    joinChannel(channelId: string): Promise<UnumChannel>;
+    /** List available channels */
+    listChannels(): Promise<UnumChannel[]>;
+    /** Broadcast a Praxis event to a channel */
+    broadcastEvent(channelId: string, event: PraxisEvent): Promise<void>;
+    /** Broadcast a Praxis fact to a channel */
+    broadcastFact(channelId: string, fact: PraxisFact): Promise<void>;
+    /** Subscribe to events from a channel */
+    subscribeToEvents(channelId: string, handler: (event: PraxisEvent) => void): () => void;
+    /** Subscribe to facts from a channel */
+    subscribeToFacts(channelId: string, handler: (fact: PraxisFact) => void): () => void;
+    /** Disconnect and cleanup */
+    disconnect(): Promise<void>;
+}
+/**
+ * Create a Unum adapter for Praxis engine integration
+ *
+ * @example
+ * ```typescript
+ * import { createUnumAdapter } from '@plures/praxis/integrations/unum';
+ * import { createInMemoryDB } from '@plures/praxis/integrations/pluresdb';
+ *
+ * const db = createInMemoryDB();
+ * const unum = await createUnumAdapter({
+ *   db,
+ *   identity: {
+ *     name: 'Alice',
+ *   },
+ *   realtime: true,
+ * });
+ *
+ * // Create a channel
+ * const channel = await unum.createChannel('my-channel');
+ *
+ * // Broadcast events to the channel
+ * await unum.broadcastEvent(channel.id, myEvent);
+ * ```
+ */
+export declare function createUnumAdapter(config: UnumAdapterConfig): Promise<UnumAdapter>;
+/**
+ * Attach Unum adapter to a Praxis engine
+ *
+ * Enables automatic event/fact broadcasting to connected channels.
+ * This is a placeholder for future integration where the engine
+ * would emit events that get broadcast to channels.
+ *
+ * @param _engine - The Praxis logic engine
+ * @param _adapter - The Unum adapter
+ * @param _channelId - The channel to broadcast to
+ * @returns Cleanup function
+ */
+export declare function attachUnumToEngine<TContext>(_engine: LogicEngine<TContext>, _adapter: UnumAdapter, _channelId: string): () => void;
+//# sourceMappingURL=unum.d.ts.map

package/dist/src/integrations/unum.d.ts.map

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

package/dist/src/integrations/unum.js

@@ -0,0 +1,240 @@
+/**
+ * Unum Integration
+ *
+ * Integration with plures/unum - A modern Svelte binding library for PluresDB
+ * with full Svelte 5 compatibility. Provides identity and channels support.
+ *
+ * Features:
+ * - Svelte 4 & 5 Compatible: Works with both store-based and runes-based reactivity
+ * - Type-Safe: Full TypeScript support with proper types
+ * - Action-Based: Modern Svelte actions for DOM binding
+ * - Store-Based: Writable store implementation for reactive data
+ * - Collection Support: Easy handling of PluresDB collections
+ *
+ * @see https://github.com/plures/unum
+ */
+/**
+ * Create a Unum adapter for Praxis engine integration
+ *
+ * @example
+ * ```typescript
+ * import { createUnumAdapter } from '@plures/praxis/integrations/unum';
+ * import { createInMemoryDB } from '@plures/praxis/integrations/pluresdb';
+ *
+ * const db = createInMemoryDB();
+ * const unum = await createUnumAdapter({
+ *   db,
+ *   identity: {
+ *     name: 'Alice',
+ *   },
+ *   realtime: true,
+ * });
+ *
+ * // Create a channel
+ * const channel = await unum.createChannel('my-channel');
+ *
+ * // Broadcast events to the channel
+ * await unum.broadcastEvent(channel.id, myEvent);
+ * ```
+ */
+export async function createUnumAdapter(config) {
+    const { db, realtime = true } = config;
+    // syncInterval could be used for periodic sync in a more complete implementation
+    let currentIdentity = null;
+    const channels = new Map();
+    const subscriptions = new Set();
+    // Set initial identity if provided
+    if (config.identity) {
+        currentIdentity = {
+            ...config.identity,
+            id: config.identity.id || generateId(),
+            createdAt: Date.now(),
+        };
+        await db.set(`unum/identities/${currentIdentity.id}`, currentIdentity);
+    }
+    async function setIdentity(identity) {
+        currentIdentity = {
+            ...identity,
+            id: generateId(),
+            createdAt: Date.now(),
+        };
+        await db.set(`unum/identities/${currentIdentity.id}`, currentIdentity);
+        return currentIdentity;
+    }
+    async function getIdentity(id) {
+        return await db.get(`unum/identities/${id}`);
+    }
+    async function createChannel(name, members) {
+        const channelId = generateId();
+        const channelData = {
+            id: channelId,
+            name,
+            members: members || [],
+            createdAt: Date.now(),
+            createdBy: currentIdentity?.id,
+        };
+        await db.set(`unum/channels/${channelId}`, channelData);
+        const channel = createChannelInstance(channelId, name);
+        channels.set(channelId, channel);
+        return channel;
+    }
+    async function joinChannel(channelId) {
+        const existing = channels.get(channelId);
+        if (existing)
+            return existing;
+        const channelData = await db.get(`unum/channels/${channelId}`);
+        if (!channelData) {
+            throw new Error(`Channel ${channelId} not found`);
+        }
+        const channel = createChannelInstance(channelData.id, channelData.name);
+        channels.set(channelId, channel);
+        return channel;
+    }
+    async function listChannels() {
+        return Array.from(channels.values());
+    }
+    function createChannelInstance(id, name) {
+        const handlers = new Set();
+        return {
+            id,
+            name,
+            subscribe(handler) {
+                handlers.add(handler);
+                // Set up database subscription if realtime is enabled
+                if (realtime) {
+                    const unsub = db.watch(`unum/channels/${id}/messages`, (data) => {
+                        if (data) {
+                            handler(data);
+                        }
+                    });
+                    subscriptions.add(unsub);
+                }
+                return () => {
+                    handlers.delete(handler);
+                };
+            },
+            async publish(message) {
+                const fullMessage = {
+                    ...message,
+                    id: message.id || generateId(),
+                    channelId: id,
+                    timestamp: Date.now(),
+                };
+                await db.set(`unum/channels/${id}/messages/${fullMessage.id}`, fullMessage);
+                // Notify local handlers
+                handlers.forEach(h => h(fullMessage));
+            },
+            async getMembers() {
+                const channelData = await db.get(`unum/channels/${id}`);
+                if (!channelData?.members)
+                    return [];
+                const members = [];
+                for (const memberId of channelData.members) {
+                    const identity = await getIdentity(memberId);
+                    if (identity)
+                        members.push(identity);
+                }
+                return members;
+            },
+            async leave() {
+                channels.delete(id);
+            },
+        };
+    }
+    async function broadcastEvent(channelId, event) {
+        const channel = channels.get(channelId);
+        if (!channel) {
+            throw new Error(`Not joined to channel ${channelId}`);
+        }
+        await channel.publish({
+            id: generateId(),
+            sender: currentIdentity || { id: 'anonymous', createdAt: Date.now() },
+            content: event,
+            type: 'event',
+        });
+    }
+    async function broadcastFact(channelId, fact) {
+        const channel = channels.get(channelId);
+        if (!channel) {
+            throw new Error(`Not joined to channel ${channelId}`);
+        }
+        await channel.publish({
+            id: generateId(),
+            sender: currentIdentity || { id: 'anonymous', createdAt: Date.now() },
+            content: fact,
+            type: 'fact',
+        });
+    }
+    function subscribeToEvents(channelId, handler) {
+        const channel = channels.get(channelId);
+        if (!channel) {
+            throw new Error(`Not joined to channel ${channelId}`);
+        }
+        return channel.subscribe((message) => {
+            if (message.type === 'event') {
+                handler(message.content);
+            }
+        });
+    }
+    function subscribeToFacts(channelId, handler) {
+        const channel = channels.get(channelId);
+        if (!channel) {
+            throw new Error(`Not joined to channel ${channelId}`);
+        }
+        return channel.subscribe((message) => {
+            if (message.type === 'fact') {
+                handler(message.content);
+            }
+        });
+    }
+    async function disconnect() {
+        // Cleanup all subscriptions
+        subscriptions.forEach(unsub => unsub());
+        subscriptions.clear();
+        // Leave all channels
+        for (const channel of channels.values()) {
+            await channel.leave();
+        }
+        channels.clear();
+        currentIdentity = null;
+    }
+    return {
+        get identity() { return currentIdentity; },
+        setIdentity,
+        getIdentity,
+        createChannel,
+        joinChannel,
+        listChannels,
+        broadcastEvent,
+        broadcastFact,
+        subscribeToEvents,
+        subscribeToFacts,
+        disconnect,
+    };
+}
+/**
+ * Generate a unique ID
+ */
+function generateId() {
+    return `${Date.now().toString(36)}-${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * Attach Unum adapter to a Praxis engine
+ *
+ * Enables automatic event/fact broadcasting to connected channels.
+ * This is a placeholder for future integration where the engine
+ * would emit events that get broadcast to channels.
+ *
+ * @param _engine - The Praxis logic engine
+ * @param _adapter - The Unum adapter
+ * @param _channelId - The channel to broadcast to
+ * @returns Cleanup function
+ */
+export function attachUnumToEngine(_engine, _adapter, _channelId) {
+    // In a future implementation, this would:
+    // 1. Hook into engine state changes
+    // 2. Broadcast new events/facts to the channel
+    // For now, return a no-op cleanup function
+    return () => { };
+}
+//# sourceMappingURL=unum.js.map

package/dist/src/integrations/unum.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEtE;;GAEG;AACH,qBAAa,QAAQ,CACnB,CAAC,SAAS,WAAW,GAAG,WAAW,EACnC,CAAC,SAAS,WAAW,GAAG,WAAW;IAEnC,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,WAAW,CAAyC;IAE5D;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAOpC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI;IAMxC;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS;IAI3C;;OAEG;IACH,WAAW,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAI3B;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;IAMjD;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IAOnD;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI;IAMvD;;OAEG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIzC;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS;IAIpD;;OAEG;IACH,iBAAiB,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE;IAIpC;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE;IA0B3C;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,CAAC,GAAG,mBAAmB,EAAE;IA0BjD;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC1C;CAcF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,CAAC,SAAS,WAAW,GAAG,WAAW,EACnC,CAAC,SAAS,WAAW,GAAG,WAAW,KAChC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAElB"}

package/dist/src/registry.js.map

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

package/dist/{runtime → src/runtime}/terminal-adapter.d.ts

@@ -5,6 +5,7 @@
  * Integrates with pluresDB for state synchronization.
  */
 import type { TerminalNodeProps } from '../core/schema/types.js';
+import type { PraxisDB } from '../core/pluresdb/adapter.js';
 /**
  * Terminal command execution result
  */
@@ -43,18 +44,38 @@ export interface TerminalAdapterOptions {
     inputPath?: string;
     /** PluresDB path for output binding */
     outputPath?: string;
+    /** Current working directory */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** PluresDB instance for state persistence */
+    db?: PraxisDB;
+    /** Command executor function (for custom execution environments) */
+    executor?: CommandExecutor;
 }
+/**
+ * Command executor function type
+ */
+export type CommandExecutor = (command: string, options: {
+    cwd?: string;
+    env?: Record<string, string>;
+}) => Promise<{
+    output: string;
+    exitCode: number;
+    error?: string;
+}>;
 /**
  * Terminal Runtime Adapter
  *
  * Manages terminal node execution and state.
- *
- * Note: PluresDB input/output path bindings will be implemented
- * when pluresDB integration is complete.
+ * Supports command execution with history tracking and PluresDB integration.
  */
 export declare class TerminalAdapter {
     private state;
+    private inputPath?;
     private outputPath?;
+    private db?;
+    private executor;
     constructor(options: TerminalAdapterOptions);
     /**
      * Execute a terminal command
@@ -71,6 +92,14 @@ export declare class TerminalAdapter {
      * Update terminal props
      */
     updateProps(props: Partial<TerminalNodeProps>): void;
+    /**
+     * Set working directory
+     */
+    setCwd(cwd: string): void;
+    /**
+     * Set environment variables
+     */
+    setEnv(env: Record<string, string>): void;
     /**
      * Clear command history
      */
@@ -80,12 +109,20 @@ export declare class TerminalAdapter {
      */
     getHistory(): ReadonlyArray<string>;
     /**
-     * Sync state to pluresDB (placeholder)
+     * Sync state to PluresDB
      *
-     * @param _path - PluresDB path (unused until integration is complete)
-     * @param _data - Data to sync (unused until integration is complete)
+     * @param path - PluresDB path for storing results
+     * @param data - Data to sync
      */
     private syncToPluresDB;
+    /**
+     * Load state from PluresDB
+     */
+    loadFromPluresDB(): Promise<void>;
+    /**
+     * Subscribe to input changes from PluresDB
+     */
+    watchInput(callback: (command: string) => void): (() => void) | null;
 }
 /**
  * Create a terminal adapter instance
@@ -99,7 +136,21 @@ export declare function createTerminalAdapter(options: TerminalAdapterOptions):
  *
  * @param nodeId - Terminal node identifier
  * @param command - Command to execute
+ * @param options - Additional options
  * @returns Execution result
  */
-export declare function runTerminalCommand(nodeId: string, command: string): Promise<TerminalExecutionResult>;
+export declare function runTerminalCommand(nodeId: string, command: string, options?: {
+    cwd?: string;
+    env?: Record<string, string>;
+    db?: PraxisDB;
+}): Promise<TerminalExecutionResult>;
+/**
+ * Create a mock executor for testing
+ * Returns a function that returns predefined outputs
+ */
+export declare function createMockExecutor(responses: Record<string, {
+    output: string;
+    exitCode: number;
+    error?: string;
+}>): CommandExecutor;
 //# sourceMappingURL=terminal-adapter.d.ts.map

package/dist/src/runtime/terminal-adapter.d.ts.map

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