@plures/praxis 0.2.0

package/src/cloud/types.ts

@@ -0,0 +1,198 @@
+/**
+ * Cloud Relay Types
+ * 
+ * Type definitions for Praxis Cloud Relay service.
+ */
+
+import type { PraxisFact, PraxisEvent } from "../core/protocol.js";
+
+/**
+ * Cloud relay configuration
+ */
+export interface CloudRelayConfig {
+  /**
+   * Azure Function App endpoint URL
+   */
+  endpoint: string;
+
+  /**
+   * GitHub OAuth token for authentication
+   */
+  authToken?: string;
+
+  /**
+   * Application identifier
+   */
+  appId: string;
+
+  /**
+   * Enable automatic sync
+   */
+  autoSync?: boolean;
+
+  /**
+   * Sync interval in milliseconds (default: 5000)
+   */
+  syncInterval?: number;
+
+  /**
+   * Enable encryption for blob storage
+   */
+  encryption?: boolean;
+}
+
+/**
+ * Relay connection status
+ */
+export interface RelayStatus {
+  connected: boolean;
+  lastSync?: number;
+  endpoint: string;
+  appId: string;
+}
+
+/**
+ * CRDT sync message
+ */
+export interface CRDTSyncMessage {
+  /**
+   * Message type
+   */
+  type: "sync" | "delta" | "snapshot";
+
+  /**
+   * Application identifier
+   */
+  appId: string;
+
+  /**
+   * Vector clock for causality tracking
+   */
+  clock: Record<string, number>;
+
+  /**
+   * Facts to sync
+   */
+  facts?: PraxisFact[];
+
+  /**
+   * Events to forward
+   */
+  events?: PraxisEvent[];
+
+  /**
+   * Timestamp
+   */
+  timestamp: number;
+}
+
+/**
+ * Usage metrics
+ */
+export interface UsageMetrics {
+  /**
+   * Application identifier
+   */
+  appId: string;
+
+  /**
+   * Number of sync operations
+   */
+  syncCount: number;
+
+  /**
+   * Number of events forwarded
+   */
+  eventCount: number;
+
+  /**
+   * Number of facts synced
+   */
+  factCount: number;
+
+  /**
+   * Storage used in bytes
+   */
+  storageBytes: number;
+
+  /**
+   * Period start timestamp
+   */
+  periodStart: number;
+
+  /**
+   * Period end timestamp
+   */
+  periodEnd: number;
+}
+
+/**
+ * Health check response
+ */
+export interface HealthCheckResponse {
+  status: "healthy" | "degraded" | "unhealthy";
+  timestamp: number;
+  version: string;
+  services: {
+    relay: boolean;
+    eventGrid: boolean;
+    storage: boolean;
+    auth: boolean;
+  };
+}
+
+/**
+ * Cloud relay client interface
+ */
+export interface CloudRelayClient {
+  /**
+   * Connect to the relay
+   */
+  connect(): Promise<void>;
+
+  /**
+   * Disconnect from the relay
+   */
+  disconnect(): Promise<void>;
+
+  /**
+   * Sync facts and events
+   */
+  sync(message: CRDTSyncMessage): Promise<void>;
+
+  /**
+   * Get usage metrics
+   */
+  getUsage(): Promise<UsageMetrics>;
+
+  /**
+   * Get health status
+   */
+  getHealth(): Promise<HealthCheckResponse>;
+
+  /**
+   * Get connection status
+   */
+  getStatus(): RelayStatus;
+}
+
+/**
+ * GitHub OAuth user info
+ */
+export interface GitHubUser {
+  id: number;
+  login: string;
+  email?: string;
+  name?: string;
+  avatarUrl?: string;
+}
+
+/**
+ * Authentication result
+ */
+export interface AuthResult {
+  success: boolean;
+  token?: string;
+  user?: GitHubUser;
+  expiresAt?: number;
+}

package/src/components/README.md

@@ -0,0 +1,125 @@
+# Praxis Svelte Components
+
+This directory contains Svelte components for Praxis/RuneBook applications.
+
+## Components
+
+### TerminalNode
+
+A terminal interface component with command execution, history, and canvas integration.
+
+**Features:**
+- Command execution with output display
+- Command history tracking
+- Draggable positioning on canvas
+- Resizable dimensions
+- Context menu with operations
+- Text and widget input modes
+- Dark theme with VS Code styling
+
+**Usage:**
+
+```svelte
+<script>
+  import TerminalNode from '@plures/praxis/components/TerminalNode.svelte';
+  import { createTerminalAdapter } from '@plures/praxis';
+
+  const adapter = createTerminalAdapter({
+    nodeId: 'my-terminal',
+    props: {
+      inputMode: 'text',
+      history: [],
+      lastOutput: null,
+    },
+  });
+</script>
+
+<TerminalNode
+  {adapter}
+  x={100}
+  y={100}
+  width={600}
+  height={400}
+  draggable={true}
+  resizable={true}
+/>
+```
+
+**Props:**
+
+- `adapter: TerminalAdapter` - Terminal adapter instance (required)
+- `x?: number` - X position on canvas (default: 0)
+- `y?: number` - Y position on canvas (default: 0)
+- `width?: number` - Component width in pixels (default: 600)
+- `height?: number` - Component height in pixels (default: 400)
+- `draggable?: boolean` - Enable drag to move (default: true)
+- `resizable?: boolean` - Enable resize handle (default: true)
+- `showContextMenu?: boolean` - Show context menu (default: false)
+
+**Canvas Integration:**
+
+The component is designed for canvas-based applications where multiple terminal nodes can be positioned and managed visually:
+
+```svelte
+<script>
+  import TerminalNode from '@plures/praxis/components/TerminalNode.svelte';
+  import { createTerminalAdapter } from '@plures/praxis';
+
+  const terminals = [
+    {
+      adapter: createTerminalAdapter({ nodeId: 'terminal-1' }),
+      x: 50,
+      y: 50,
+    },
+    {
+      adapter: createTerminalAdapter({ nodeId: 'terminal-2' }),
+      x: 700,
+      y: 50,
+    },
+  ];
+</script>
+
+<div class="canvas">
+  {#each terminals as terminal}
+    <TerminalNode
+      adapter={terminal.adapter}
+      x={terminal.x}
+      y={terminal.y}
+    />
+  {/each}
+</div>
+
+<style>
+  .canvas {
+    position: relative;
+    width: 100%;
+    height: 100vh;
+    background: #1a1a1a;
+  }
+</style>
+```
+
+## Development
+
+### Building
+
+Components are exported as source files and should be processed by your Svelte application's build system.
+
+### Testing
+
+Component behavior can be tested using Svelte Testing Library or similar tools in your application.
+
+## Requirements
+
+- Svelte 5.0+ (peer dependency)
+- Modern browser with ES modules support
+
+## Future Components
+
+Planned components for upcoming RuneBook tasks:
+
+- `InputNode` - User input widgets (text, confirm, select)
+- `DisplayNode` - Data visualization (text, markdown, JSON)
+- `AgentNode` - AI agent integration with MCP
+- `SudolangNode` - Sudolang transformation component
+- `CustomNode` - Dynamic custom component loader