create-ekka-desktop-app 0.2.2

package/template/src/ekka/ops/workflowRuns.ts

@@ -0,0 +1,116 @@
+/**
+ * Workflow Runs Operations
+ *
+ * Create and poll workflow runs via Rust proxy.
+ * All HTTP is handled by Rust - no fetch() in TS.
+ */
+
+import { OPS } from '../constants';
+import { _internal, makeRequest } from '../internal';
+import { getAccessToken } from '../auth/storage';
+
+// =============================================================================
+// TYPES
+// =============================================================================
+
+export interface WorkflowRunCreateRequest {
+  type: string;
+  confidentiality: 'public' | 'confidential';
+  context: {
+    prompt_ref: {
+      provider: string;
+      prompt_slug: string;
+      prompt_version: string;
+    };
+    variables: Record<string, string>;
+  };
+}
+
+export interface WorkflowRunCreateResponse {
+  id: string;
+  status: string;
+}
+
+/** Debug bundle info (only present for REPORT_INVALID in dev mode) */
+export interface DebugBundleInfo {
+  /** Vault URI (e.g., "vault://tmp/telemetry/llm_debug/{tenant}/{run_id}/") */
+  debug_bundle_ref: string;
+  /** SHA256 hash of raw output */
+  raw_output_sha256: string;
+  /** Length of raw output in bytes */
+  raw_output_len: number;
+  /** Files in the bundle */
+  files: string[];
+}
+
+export interface WorkflowRunResult {
+  output_text?: string;
+  /** Debug bundle info (only present for REPORT_INVALID failures in dev mode) */
+  debug_bundle?: DebugBundleInfo;
+  [key: string]: unknown;
+}
+
+export interface WorkflowRun {
+  id: string;
+  type?: string;
+  workflow_definition_id?: string;
+  status: 'pending' | 'dispatched' | 'running' | 'completed' | 'failed' | 'cancelled';
+  progress: number;
+  result?: WorkflowRunResult;
+  error?: string;
+  created_at: string;
+  started_at?: string;
+  completed_at?: string;
+}
+
+// =============================================================================
+// OPERATIONS
+// =============================================================================
+
+/**
+ * Create a new workflow run.
+ *
+ * @param request - Workflow run creation request
+ * @returns Created workflow run with ID
+ */
+export async function createWorkflowRun(
+  request: WorkflowRunCreateRequest
+): Promise<WorkflowRunCreateResponse> {
+  const jwt = getAccessToken();
+
+  const req = makeRequest(OPS.WORKFLOW_RUNS_CREATE, {
+    request,
+    jwt,
+  });
+
+  const response = await _internal.request(req);
+
+  if (!response.ok) {
+    throw new Error(response.error?.message || 'Failed to create workflow run');
+  }
+
+  return response.result as WorkflowRunCreateResponse;
+}
+
+/**
+ * Get workflow run status and output.
+ *
+ * @param id - Workflow run ID
+ * @returns Workflow run details
+ */
+export async function getWorkflowRun(id: string): Promise<WorkflowRun> {
+  const jwt = getAccessToken();
+
+  const req = makeRequest(OPS.WORKFLOW_RUNS_GET, {
+    id,
+    jwt,
+  });
+
+  const response = await _internal.request(req);
+
+  if (!response.ok) {
+    throw new Error(response.error?.message || 'Failed to get workflow run');
+  }
+
+  return response.result as WorkflowRun;
+}

package/template/src/ekka/types.ts

@@ -0,0 +1,82 @@
+/**
+ * EKKA Type Definitions
+ *
+ * Core types for the EKKA client library.
+ * Only includes types for IMPLEMENTED features.
+ */
+
+import { CONTRACT_VERSION } from './constants';
+
+// =============================================================================
+// CONTRACT TYPES
+// =============================================================================
+
+/**
+ * Request format for all engine operations.
+ */
+export interface EngineRequest {
+  op: string;
+  v: number;
+  payload: unknown;
+  correlationId: string;
+}
+
+/**
+ * Error detail in response.
+ */
+export interface EngineErrorDetail {
+  code: string;
+  message: string;
+  details?: unknown;
+  status?: number;
+}
+
+/**
+ * Response format for all engine operations.
+ */
+export interface EngineResponse {
+  ok: boolean;
+  result?: unknown;
+  error?: EngineErrorDetail;
+}
+
+// =============================================================================
+// CONTRACT HELPERS
+// =============================================================================
+
+/**
+ * Generate a correlation ID (UUID v4).
+ */
+export function mkCorrelationId(): string {
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+    const r = (Math.random() * 16) | 0;
+    const v = c === 'x' ? r : (r & 0x3) | 0x8;
+    return v.toString(16);
+  });
+}
+
+/**
+ * Create an engine request.
+ */
+export function makeRequest(op: string, payload: unknown = {}): EngineRequest {
+  return {
+    op,
+    v: CONTRACT_VERSION,
+    payload,
+    correlationId: mkCorrelationId(),
+  };
+}
+
+/**
+ * Create a successful response.
+ */
+export function ok<T = unknown>(result: T): EngineResponse {
+  return { ok: true, result };
+}
+
+/**
+ * Create an error response.
+ */
+export function err(code: string, message: string): EngineResponse {
+  return { ok: false, error: { code, message } };
+}

package/template/src/ekka/utils/idempotency.ts

@@ -0,0 +1,14 @@
+/**
+ * Idempotency Key Utilities
+ * Generate unique keys for idempotent operations.
+ */
+
+/**
+ * Generate a unique idempotency key.
+ * Format: timestamp-random (e.g., "1706284800000-a1b2c3d4e5f6")
+ */
+export function generateIdempotencyKey(): string {
+  const timestamp = Date.now();
+  const random = Math.random().toString(36).substring(2, 14);
+  return `${timestamp}-${random}`;
+}

package/template/src/ekka/utils/index.ts

@@ -0,0 +1,7 @@
+/**
+ * EKKA Utilities
+ * Re-exports all utility functions.
+ */
+
+export * from './time';
+export * from './idempotency';

package/template/src/ekka/utils/time.ts

@@ -0,0 +1,77 @@
+/**
+ * Time Formatting Utilities
+ * Human-readable time formatting for the EKKA client.
+ */
+
+/**
+ * Format a date as relative time (e.g., "2 minutes ago", "in 5 hours").
+ */
+export function formatRelativeTime(date: Date): string {
+  const now = new Date();
+  const diffMs = date.getTime() - now.getTime();
+  const absDiffMs = Math.abs(diffMs);
+  const isPast = diffMs < 0;
+
+  const seconds = Math.floor(absDiffMs / 1000);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  const days = Math.floor(hours / 24);
+
+  let value: number;
+  let unit: string;
+
+  if (seconds < 60) {
+    value = seconds;
+    unit = 'second';
+  } else if (minutes < 60) {
+    value = minutes;
+    unit = 'minute';
+  } else if (hours < 24) {
+    value = hours;
+    unit = 'hour';
+  } else {
+    value = days;
+    unit = 'day';
+  }
+
+  const plural = value !== 1 ? 's' : '';
+  if (isPast) {
+    return value === 0 ? 'just now' : `${value} ${unit}${plural} ago`;
+  }
+  return `in ${value} ${unit}${plural}`;
+}
+
+/**
+ * Format a date as local time string (e.g., "3:45:30 PM").
+ */
+export function formatLocalTime(date: Date): string {
+  return date.toLocaleTimeString(undefined, {
+    hour: 'numeric',
+    minute: '2-digit',
+    second: '2-digit',
+    hour12: true,
+  });
+}
+
+/**
+ * Format expiry information from an ISO date string.
+ * Returns null if the input is invalid.
+ */
+export function formatExpiryInfo(
+  expiresAtIso: string
+): { text: string; isExpired: boolean } | null {
+  try {
+    const expiresAt = new Date(expiresAtIso);
+    if (isNaN(expiresAt.getTime())) {
+      return null;
+    }
+
+    const now = new Date();
+    const isExpired = expiresAt.getTime() < now.getTime();
+    const text = formatRelativeTime(expiresAt);
+
+    return { text, isExpired };
+  } catch {
+    return null;
+  }
+}

package/template/src/main.tsx

@@ -0,0 +1,12 @@
+import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+
+// Toggle between DemoApp and App here:
+// import { App } from './app/App';
+import { DemoApp as App } from './demo/DemoApp';
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>
+);

package/template/src/vite-env.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_EKKA_API_URL: string;
+  readonly VITE_EKKA_ENGINE_URL: string;
+  readonly VITE_DEV_EMAIL: string;
+  readonly VITE_DEV_PASSWORD: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

package/template/src-tauri/Cargo.toml

@@ -0,0 +1,41 @@
+[package]
+name = "ekka-desktop-app"
+version = "0.2.0"
+description = "EKKA Desktop Application"
+authors = ["EKKA"]
+edition = "2021"
+
+# Prevent inheriting parent workspace
+[workspace]
+
+[build-dependencies]
+tauri-build = { version = "2", features = [] }
+
+[dependencies]
+tauri = { version = "2", features = [] }
+tauri-plugin-dialog = "2"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+chrono = { version = "0.4", features = ["serde"] }
+ekka-sdk-core = { path = "../../ekka-execution-node-sdk-rust/crates/framework/ekka-sdk-core" }
+ekka-runner-core = { path = "../../ekka-execution-node-sdk-rust/crates/framework/ekka-runner-core" }
+ekka-runner-local = { path = "../../ekka-execution-node-sdk-rust/crates/apps/ekka-runner-local" }
+reqwest = { version = "0.11", features = ["blocking", "json"] }
+uuid = { version = "1.0", features = ["v4"] }
+tokio = { version = "1", features = ["sync"] }
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+ed25519-dalek = { version = "2.1", features = ["rand_core"] }
+rand = "0.8"
+base64 = "0.22"
+zeroize = { version = "1.7", features = ["derive"] }
+dotenvy = "0.15"
+hex = "0.4"
+anyhow = "1.0"
+
+[dev-dependencies]
+tempfile = "3"
+
+[features]
+default = ["custom-protocol"]
+custom-protocol = ["tauri/custom-protocol"]

package/template/src-tauri/build.rs

@@ -0,0 +1,3 @@
+fn main() {
+    tauri_build::build()
+}

package/template/src-tauri/capabilities/default.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "../gen/schemas/desktop-schema.json",
+  "identifier": "default",
+  "description": "Default capabilities for EKKA Desktop",
+  "windows": ["main"],
+  "permissions": [
+    "core:default",
+    "dialog:default",
+    "dialog:allow-open"
+  ]
+}

package/template/src-tauri/src/bootstrap.rs

@@ -0,0 +1,37 @@
+//! Home directory bootstrap
+//!
+//! Handles initialization and resolution of the EKKA home directory.
+
+use ekka_sdk_core::ekka_home_bootstrap::{BootstrapConfig, EpochSource, HomeBootstrap, HomeStrategy};
+use std::path::PathBuf;
+
+/// Standard bootstrap configuration for EKKA Desktop
+pub fn bootstrap_config() -> BootstrapConfig {
+    BootstrapConfig {
+        app_name: "ekka-desktop".to_string(),
+        default_folder_name: ".ekka-desktop".to_string(),
+        home_strategy: HomeStrategy::DataHome {
+            env_var: "EKKA_DATA_HOME".to_string(),
+        },
+        marker_filename: ".ekka-marker.json".to_string(),
+        keychain_service: "ai.ekka.desktop".to_string(),
+        subdirs: vec!["vault".to_string(), "db".to_string(), "tmp".to_string()],
+        epoch_source: EpochSource::EnvVar("EKKA_SECURITY_EPOCH".to_string()),
+        storage_layout_version: "v1".to_string(),
+    }
+}
+
+/// Resolve the home path without initializing
+pub fn resolve_home_path() -> Result<PathBuf, String> {
+    let config = bootstrap_config();
+    let bootstrap = HomeBootstrap::new(config).map_err(|e| e.to_string())?;
+    Ok(bootstrap.home_path().to_path_buf())
+}
+
+/// Initialize home directory and return the bootstrap instance
+pub fn initialize_home() -> Result<HomeBootstrap, String> {
+    let config = bootstrap_config();
+    let bootstrap = HomeBootstrap::new(config).map_err(|e| e.to_string())?;
+    bootstrap.initialize().map_err(|e| e.to_string())?;
+    Ok(bootstrap)
+}