orionfold-relay 0.24.0 → 0.25.0

package/dist/cli.js

@@ -1186,7 +1186,7 @@ var CURRENT_PLUGIN_API_VERSION, CAPABILITY_VALUES, ORIGIN_VALUES, PrimitivesBund
 var init_types = __esm({
   "src/lib/plugins/sdk/types.ts"() {
     "use strict";
-    CURRENT_PLUGIN_API_VERSION = "0.24";
+    CURRENT_PLUGIN_API_VERSION = "0.25";
     CAPABILITY_VALUES = ["fs", "net", "child_process", "env"];
     ORIGIN_VALUES = ["ainative-internal", "third-party"];
     PrimitivesBundleManifestSchema = z.object({
@@ -7135,7 +7135,13 @@ function getWorkspaceContext() {
     gitBranch = execFileSync2("git", ["branch", "--show-current"], {
       cwd,
       encoding: "utf-8",
-      timeout: 3e3
+      timeout: 3e3,
+      // Route git's stderr to a pipe (captured on the thrown error, then
+      // discarded) instead of inheriting the console. Without this, a
+      // non-git cwd leaks a raw `fatal: not a git repository` to a
+      // customer's first-run log before the catch swallows the exit code.
+      // Mirrors src/lib/instance/git-ops.ts run().
+      stdio: ["ignore", "pipe", "pipe"]
     }).trim() || null;
   } catch {
   }
@@ -12134,7 +12140,7 @@ async function listPendingApprovalPayloads(limit = 20) {
     const isBatchProposal = row.type === "context_proposal_batch";
     const parsedInput = parseNotificationToolInput(row.toolInput);
     let effectiveWorkflowId = row.workflowId;
-    if (!row.taskId && row.toolName === "WorkflowCheckpoint" && row.toolInput) {
+    if (!row.taskId && (row.toolName === "WorkflowCheckpoint" || row.toolName === "AskUserQuestion") && row.toolInput) {
       try {
         const parsed = typeof row.toolInput === "string" ? JSON.parse(row.toolInput) : row.toolInput;
         effectiveWorkflowId = parsed.workflowId ?? null;
@@ -12963,7 +12969,7 @@ var init_registry6 = __esm({
     init_registry5();
     init_installer();
     init_schedule_spec();
-    SUPPORTED_API_VERSIONS = /* @__PURE__ */ new Set([CURRENT_PLUGIN_API_VERSION, "0.23"]);
+    SUPPORTED_API_VERSIONS = /* @__PURE__ */ new Set([CURRENT_PLUGIN_API_VERSION, "0.24"]);
     pluginCache = null;
     lastLoadedPluginIds = /* @__PURE__ */ new Set();
     PluginTableSchema = z16.object({
@@ -21726,6 +21732,41 @@ var init_openai_direct = __esm({
   }
 });
 
+// src/lib/agents/runtime/ollama-model-resolver.ts
+async function listPulledOllamaModels(baseUrl) {
+  try {
+    const response = await fetch(`${baseUrl}/api/tags`, {
+      signal: AbortSignal.timeout(5e3)
+    });
+    if (!response.ok) return [];
+    const data = await response.json();
+    return (data.models ?? []).map((m) => m.name).filter((n) => typeof n === "string" && n.length > 0);
+  } catch {
+    return [];
+  }
+}
+async function resolveOllamaModel(baseUrl, requestedModel, defaultModel) {
+  const explicit = requestedModel?.trim() || defaultModel?.trim();
+  if (explicit) return explicit;
+  const pulled = await listPulledOllamaModels(baseUrl);
+  if (pulled.length > 0) return pulled[0];
+  throw new OllamaModelNotConfiguredError();
+}
+var OllamaModelNotConfiguredError;
+var init_ollama_model_resolver = __esm({
+  "src/lib/agents/runtime/ollama-model-resolver.ts"() {
+    "use strict";
+    OllamaModelNotConfiguredError = class extends Error {
+      constructor(message) {
+        super(
+          message ?? "No Ollama model is configured. Pull a model (e.g. `ollama pull llama3.2`) or set a default in Settings \u2192 Ollama."
+        );
+        this.name = "OllamaModelNotConfiguredError";
+      }
+    };
+  }
+});
+
 // src/lib/agents/runtime/ollama-adapter.ts
 import { eq as eq38 } from "drizzle-orm";
 async function getOllamaBaseUrl() {
@@ -21734,11 +21775,11 @@ async function getOllamaBaseUrl() {
   const url = await getSetting2(SETTINGS_KEYS2.OLLAMA_BASE_URL);
   return url || DEFAULT_OLLAMA_BASE_URL;
 }
-async function getOllamaModel() {
+async function getOllamaModel(baseUrl) {
   const { getSetting: getSetting2 } = await Promise.resolve().then(() => (init_helpers(), helpers_exports));
   const { SETTINGS_KEYS: SETTINGS_KEYS2 } = await Promise.resolve().then(() => (init_settings(), settings_exports));
-  const model = await getSetting2(SETTINGS_KEYS2.OLLAMA_DEFAULT_MODEL);
-  return model || DEFAULT_OLLAMA_MODEL;
+  const defaultModel = await getSetting2(SETTINGS_KEYS2.OLLAMA_DEFAULT_MODEL);
+  return resolveOllamaModel(baseUrl, null, defaultModel);
 }
 async function streamOllamaChat(baseUrl, model, messages, signal) {
   const response = await fetch(`${baseUrl}/api/chat`, {
@@ -21833,7 +21874,7 @@ async function executeOllamaTask(taskId) {
     await db.update(tasks).set({ status: "running", updatedAt: /* @__PURE__ */ new Date() }).where(eq38(tasks.id, taskId));
     const ctx = await buildTaskQueryContext(task, agentProfileId);
     const baseUrl = await getOllamaBaseUrl();
-    const modelId = await getOllamaModel();
+    const modelId = await getOllamaModel(baseUrl);
     const messages = [];
     if (ctx.systemInstructions) {
       messages.push({ role: "system", content: ctx.systemInstructions });
@@ -21924,7 +21965,7 @@ async function executeOllamaTask(taskId) {
 }
 async function runOllamaTaskAssist(input) {
   const baseUrl = await getOllamaBaseUrl();
-  const modelId = await getOllamaModel();
+  const modelId = await getOllamaModel(baseUrl);
   const profileIds = listProfiles().map((p) => p.id);
   const profileList = profileIds.length > 0 ? `Available agent profiles: ${profileIds.join(", ")}` : "No explicit profiles available.";
   const systemPrompt = `You are an AI task definition assistant. Analyze the given task and return ONLY a JSON object (no markdown) with:
@@ -21980,7 +22021,7 @@ async function testOllamaConnection() {
     };
   }
 }
-var DEFAULT_OLLAMA_BASE_URL, DEFAULT_OLLAMA_MODEL, ollamaRuntimeAdapter;
+var DEFAULT_OLLAMA_BASE_URL, ollamaRuntimeAdapter;
 var init_ollama_adapter = __esm({
   "src/lib/agents/runtime/ollama-adapter.ts"() {
     "use strict";
@@ -21989,10 +22030,10 @@ var init_ollama_adapter = __esm({
     init_execution_manager();
     init_claude_agent();
     init_catalog2();
+    init_ollama_model_resolver();
     init_registry2();
     init_ledger();
     DEFAULT_OLLAMA_BASE_URL = "http://localhost:11434";
-    DEFAULT_OLLAMA_MODEL = "llama3.2";
     ollamaRuntimeAdapter = {
       metadata: getRuntimeCatalogEntry("ollama"),
       async executeTask(taskId) {
@@ -24129,6 +24170,7 @@ ${step.prompt}`;
 }
 async function executeCheckpoint(workflowId, definition, state, parentTaskId, workflowRuntimeId) {
   let previousOutput = "";
+  let userAnswer = "";
   for (let i = 0; i < definition.steps.length; i++) {
     const step = definition.steps[i];
     state.currentStepIndex = i;
@@ -24142,8 +24184,27 @@ async function executeCheckpoint(workflowId, definition, state, parentTaskId, wo
         throw new Error(`Step "${step.name}" was denied approval`);
       }
     }
-    const contextPrompt = previousOutput ? `Previous step output:
-${previousOutput}
+    userAnswer = "";
+    if (step.requiresInput) {
+      state.stepStates[i].status = "waiting_approval";
+      state.status = "paused";
+      await updateWorkflowState(workflowId, state, "paused");
+      const question = step.inputPrompt ?? step.prompt;
+      userAnswer = await waitForInput(workflowId, step.name, question);
+      state.status = "running";
+      state.stepStates[i].status = "running";
+      await updateWorkflowState(workflowId, state, "active");
+    }
+    const contextParts = [];
+    if (previousOutput) {
+      contextParts.push(`Previous step output:
+${previousOutput}`);
+    }
+    if (userAnswer.trim()) {
+      contextParts.push(`User-provided input:
+${userAnswer}`);
+    }
+    const contextPrompt = contextParts.length > 0 ? `${contextParts.join("\n\n---\n\n")}
 
 ---
 
@@ -24165,6 +24226,14 @@ ${step.prompt}` : step.prompt;
       throw new Error(`Step "${step.name}" failed: ${result.error}`);
     }
     previousOutput = result.result ?? "";
+    const hasDependents = i < definition.steps.length - 1;
+    if (hasDependents && previousOutput.trim().length === 0) {
+      state.stepStates[i].status = "failed";
+      state.stepStates[i].error = "Step produced no usable output; halting dependent steps to avoid a false completion. The agent may have refused for missing context \u2014 check its output and re-run with the needed input.";
+      throw new Error(
+        `Step "${step.name}" produced no usable output \u2014 halting workflow to avoid cascading refusals`
+      );
+    }
   }
 }
 async function executeParallel(workflowId, definition, state, parentTaskId, workflowRuntimeId) {
@@ -24694,6 +24763,33 @@ ${previousOutput.slice(0, 500)}`,
   }).where(eq44(notifications.id, notificationId));
   return false;
 }
+async function waitForInput(workflowId, stepName, question, options) {
+  const notificationId = crypto.randomUUID();
+  await db.insert(notifications).values({
+    id: notificationId,
+    taskId: null,
+    type: "permission_required",
+    title: `Workflow needs input: ${stepName}`,
+    body: question.slice(0, 500),
+    toolName: "AskUserQuestion",
+    toolInput: JSON.stringify({ question, options, workflowId, stepName }),
+    createdAt: /* @__PURE__ */ new Date()
+  });
+  const pollInterval = 2e3;
+  for (; ; ) {
+    const [notification] = await db.select().from(notifications).where(eq44(notifications.id, notificationId));
+    if (notification?.response) {
+      try {
+        const parsed = JSON.parse(notification.response);
+        const answer = parsed?.updatedInput?.answer;
+        return typeof answer === "string" ? answer : "";
+      } catch {
+        return "";
+      }
+    }
+    await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
+  }
+}
 async function updateWorkflowState(workflowId, state, status) {
   const [workflow] = await db.select().from(workflows).where(eq44(workflows.id, workflowId));
   if (!workflow) throw new Error(`Workflow ${workflowId} not found \u2014 cannot update state`);
@@ -25803,8 +25899,8 @@ import { execFileSync as execFileSync3 } from "child_process";
 import yaml12 from "js-yaml";
 import semver from "semver";
 function relayCoreVersion() {
-  if (semver.valid("0.24.0")) {
-    return "0.24.0";
+  if (semver.valid("0.25.0")) {
+    return "0.25.0";
   }
   try {
     const root = getAppRoot(import.meta.dirname, 3);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orionfold-relay",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Orionfold Relay — a local-first, multi-agent orchestration runtime and builder scaffold for AI-native work.",
   "keywords": [
     "ai",

package/src/app/api/snapshots/[id]/restore/route.ts

@@ -2,6 +2,7 @@ import { NextRequest, NextResponse } from "next/server";
 import {
   restoreFromSnapshot,
   isSnapshotLocked,
+  SnapshotBusyError,
 } from "@/lib/snapshots/snapshot-manager";
 import { db } from "@/lib/db";
 import { tasks } from "@/lib/db/schema";
@@ -51,6 +52,11 @@ export async function POST(
         "Restore complete. Please restart the server to load the restored database.",
     });
   } catch (error) {
+    // Lock contention is a 409, not a server error — never conflate it with a
+    // genuine failure (issue #24).
+    if (error instanceof SnapshotBusyError) {
+      return NextResponse.json({ error: error.message }, { status: 409 });
+    }
     return NextResponse.json(
       {
         error:

package/src/app/api/snapshots/route.ts

@@ -4,6 +4,7 @@ import {
   listSnapshots,
   getSnapshotsSize,
   isSnapshotLocked,
+  SnapshotBusyError,
 } from "@/lib/snapshots/snapshot-manager";
 
 /** GET /api/snapshots — list all snapshots with disk usage */
@@ -46,6 +47,11 @@ export async function POST(req: NextRequest) {
 
     return NextResponse.json(snapshot, { status: 201 });
   } catch (error) {
+    // A lock grabbed between the isSnapshotLocked() check and createSnapshot is
+    // still contention, not a server error (issue #24).
+    if (error instanceof SnapshotBusyError) {
+      return NextResponse.json({ error: error.message }, { status: 409 });
+    }
     return NextResponse.json(
       { error: error instanceof Error ? error.message : "Failed to create snapshot" },
       { status: 500 }

package/src/components/apps/app-detail-actions.tsx

@@ -2,15 +2,9 @@
 
 import { useState, useTransition } from "react";
 import { useRouter } from "next/navigation";
-import { MoreHorizontal, Trash2 } from "lucide-react";
+import { Trash2 } from "lucide-react";
 import { toast } from "sonner";
 import { Button } from "@/components/ui/button";
-import {
-  DropdownMenu,
-  DropdownMenuContent,
-  DropdownMenuItem,
-  DropdownMenuTrigger,
-} from "@/components/ui/dropdown-menu";
 import { ConfirmDialog } from "@/components/shared/confirm-dialog";
 
 interface AppDetailActionsProps {
@@ -76,22 +70,15 @@ export function AppDetailActions({
 
   return (
     <>
-      <DropdownMenu>
-        <DropdownMenuTrigger asChild>
-          <Button variant="ghost" size="sm" aria-label="App actions">
-            <MoreHorizontal className="h-4 w-4" aria-hidden="true" />
-          </Button>
-        </DropdownMenuTrigger>
-        <DropdownMenuContent align="end">
-          <DropdownMenuItem
-            onClick={() => setConfirmOpen(true)}
-            className="text-destructive focus:text-destructive"
-          >
-            <Trash2 className="h-3.5 w-3.5 mr-2" aria-hidden="true" />
-            Delete app
-          </DropdownMenuItem>
-        </DropdownMenuContent>
-      </DropdownMenu>
+      <Button
+        variant="outline"
+        size="sm"
+        onClick={() => setConfirmOpen(true)}
+        className="text-destructive hover:text-destructive"
+      >
+        <Trash2 className="h-3.5 w-3.5 mr-1.5" aria-hidden="true" />
+        Delete app
+      </Button>
 
       <ConfirmDialog
         open={confirmOpen}

package/src/components/apps/kit-view/kit-view.tsx

@@ -25,7 +25,14 @@ export function KitView({ model }: KitViewProps) {
       {model.kpis && <KpisSlotView tiles={model.kpis} />}
       {model.hero && <HeroSlotView slot={model.hero} />}
       {model.secondary && model.secondary.length > 0 && (
-        <SecondarySlotView slots={model.secondary} />
+        <div className="space-y-3">
+          {model.secondaryLead && (
+            <p className="text-sm text-muted-foreground">
+              {model.secondaryLead}
+            </p>
+          )}
+          <SecondarySlotView slots={model.secondary} />
+        </div>
       )}
       {model.activity && <ActivitySlotView slot={model.activity} />}
       {model.footer && <FooterSlotView slot={model.footer} />}

package/src/components/apps/kit-view/slots/header.tsx

@@ -22,8 +22,8 @@ interface HeaderSlotProps {
 export function HeaderSlotView({ slot, manifestPane }: HeaderSlotProps) {
   const { title, description, status, actions, cadenceChip, runNowBlueprintId, runNowVariables, periodChip, triggerSourceChip } = slot;
   return (
-    <div className="flex flex-col gap-1 sm:flex-row sm:items-center sm:justify-between">
-      <div className="min-w-0">
+    <div className="flex flex-col gap-1 sm:flex-row sm:items-center sm:justify-between sm:gap-4">
+      <div className="min-w-0 flex-1">
         <h1 className="text-xl font-semibold tracking-tight line-clamp-2" title={title}>
           {title}
         </h1>
@@ -33,7 +33,7 @@ export function HeaderSlotView({ slot, manifestPane }: HeaderSlotProps) {
           </p>
         )}
       </div>
-      <div className="flex flex-wrap items-center gap-2 mt-2 sm:mt-0">
+      <div className="flex flex-wrap items-center gap-2 mt-2 sm:mt-0 sm:flex-nowrap sm:shrink-0">
         {status && <StatusChip status={status} size="md" />}
         {cadenceChip && (
           <ScheduleCadenceChip

package/src/components/apps/kit-view/slots/manifest-sheet.tsx

@@ -2,7 +2,7 @@
 
 import type { ReactNode } from "react";
 import { useState } from "react";
-import { ChevronDown, FileText } from "lucide-react";
+import { ChevronRight, FileText } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import {
   Sheet,
@@ -36,7 +36,7 @@ export function ManifestSheet({ appName, body }: ManifestSheetProps) {
       >
         <FileText className="h-3.5 w-3.5 mr-1.5" aria-hidden="true" />
         View manifest
-        <ChevronDown className="h-3.5 w-3.5 ml-1" aria-hidden="true" />
+        <ChevronRight className="h-3.5 w-3.5 ml-1" aria-hidden="true" />
       </Button>
       <Sheet open={open} onOpenChange={setOpen}>
         <SheetContent side="right" className="w-full sm:max-w-2xl overflow-hidden flex flex-col">

package/src/components/apps/last-run-card.tsx

@@ -13,10 +13,11 @@ import {
   SheetTitle,
   SheetTrigger,
 } from "@/components/ui/sheet";
-import { ChevronDown, AlertCircle } from "lucide-react";
+import { ChevronDown, AlertCircle, Sparkles, RefreshCw } from "lucide-react";
 import { ErrorBoundary } from "@/components/shared/error-boundary";
+import { RunNowButton } from "@/components/apps/run-now-button";
 import type { TaskStatus } from "@/lib/constants/task-status";
-import type { RuntimeTaskSummary } from "@/lib/apps/view-kits/types";
+import type { BlueprintCard, RuntimeTaskSummary } from "@/lib/apps/view-kits/types";
 
 interface LastRunSummary {
   id: string;
@@ -94,6 +95,94 @@ function CompactVariant({ blueprintLabel, lastRun, runCount30d }: CompactProps)
   );
 }
 
+interface RunnableBlueprintCardProps {
+  card: BlueprintCard;
+  lastRun: LastRunSummary | null;
+  runCount30d: number;
+}
+
+/**
+ * FEAT-5/6: the runnable blueprint card on the app home. Renders the
+ * blueprint's name + one-line description + last-run status + a Run action.
+ * The "Start here" card is highlighted. Row-insert blueprints label their
+ * automatic trigger instead of offering a manual Run that fights the contract.
+ */
+export function RunnableBlueprintCard({
+  card,
+  lastRun,
+  runCount30d,
+}: RunnableBlueprintCardProps) {
+  const isRowInsert = card.trigger?.kind === "row-insert";
+  return (
+    <Card
+      className={
+        card.isPrimary
+          ? "surface-card border-primary ring-1 ring-primary/30"
+          : "surface-card"
+      }
+    >
+      <CardHeader className="pb-2 space-y-1.5">
+        {card.isPrimary && (
+          <Badge className="w-fit gap-1">
+            <Sparkles className="h-3 w-3" />
+            Start here
+          </Badge>
+        )}
+        <CardTitle className="text-sm font-medium">{card.name}</CardTitle>
+        {card.description && (
+          <p className="text-xs text-muted-foreground line-clamp-2">
+            {card.description}
+          </p>
+        )}
+      </CardHeader>
+      <CardContent className="space-y-3">
+        <div className="flex items-center gap-2 flex-wrap">
+          {lastRun ? (
+            <>
+              <Badge variant={statusVariant[lastRun.status]}>
+                {lastRun.status}
+              </Badge>
+              <span className="text-xs text-muted-foreground">
+                {formatAgo(lastRun.createdAt)}
+              </span>
+            </>
+          ) : (
+            <span className="text-xs text-muted-foreground">never run</span>
+          )}
+          <span className="text-xs text-muted-foreground">
+            · {runCount30d} {runCount30d === 1 ? "run" : "runs"} · 30d
+          </span>
+        </div>
+        {isRowInsert ? (
+          <p className="flex items-center gap-1.5 text-xs text-muted-foreground">
+            <RefreshCw className="h-3.5 w-3.5" />
+            Runs on its own when you add a row to the{" "}
+            {card.trigger?.tableName ?? "linked"} table
+          </p>
+        ) : (
+          <div className="space-y-1.5">
+            <RunNowButton
+              blueprintId={card.id}
+              variables={card.variables}
+              label="Run"
+            />
+            {/* FEAT-5.2: on the "Start here" card, tell a first-time user what
+                Run does. Only the primary card carries this hint, so the grid
+                stays scannable (progressive disclosure). */}
+            {card.isPrimary && (
+              <p className="text-xs text-muted-foreground">
+                {card.variables.length > 0
+                  ? "Run asks a few questions, then starts a workflow you can watch."
+                  : "Run starts a workflow you can watch as it works."}
+              </p>
+            )}
+          </div>
+        )}
+      </CardContent>
+    </Card>
+  );
+}
+
 function HeroVariant({ task, previousRuns }: HeroProps) {
   const [sheetOpen, setSheetOpen] = useState(false);
 

package/src/components/apps/ledger-hero-panel.tsx

@@ -15,7 +15,8 @@ export function LedgerHeroPanel({ series, categories, period }: LedgerHeroPanelP
   if (series.length === 0 && categories.length === 0) {
     return (
       <div className="surface-card rounded-xl p-12 text-center text-muted-foreground border">
-        No data yet. Add transactions or click <strong>Run now</strong> to ingest a CSV.
+        No data yet. Click <strong>Run now</strong> to start this app&apos;s workflow.
+        Results show up here once it finishes.
       </div>
     );
   }

package/src/components/chat/app-composer-hero.tsx

@@ -16,7 +16,7 @@ const EXAMPLE_PROMPTS: { label: string; prompt: string }[] = [
   {
     label: "Build me a reading log…",
     prompt:
-      "Build me a reading log. Track each book with title, author, date finished, and a 1–5 rating. Every Friday at 5pm, summarize what I read this week.",
+      "Build me a reading log. Track each book with title, author, date finished, and a rating from 1 to 5. Every Friday at 5pm, summarize what I read this week.",
   },
   {
     label: "Build me an expense tracker for my contractors…",

package/src/components/chat/chat-empty-state.tsx

@@ -97,10 +97,10 @@ export function ChatEmptyState({
         <div className="flex h-12 w-12 items-center justify-center rounded-xl bg-primary/10">
           <Bot className="h-6 w-6 text-primary" />
         </div>
-        <h2 className="text-lg font-semibold">Describe an app. Orionfold Relay builds it.</h2>
+        <h2 className="text-lg font-semibold">Describe an app. Relay builds it.</h2>
         <p className="text-sm text-muted-foreground text-center max-w-md">
-          Profiles, blueprints, tables, and schedules, composed from a single prompt.
-          Or ask anything about your workspace.
+          One prompt builds the whole app: profiles, blueprints, tables, and
+          schedules. Or ask anything about your workspace.
         </p>
       </div>
 

package/src/components/dashboard/welcome-landing.tsx

@@ -9,17 +9,17 @@ const pillars = [
   {
     icon: Sparkles,
     title: "Apps from a sentence",
-    description: "Describe what you do every week. Orionfold Relay composes the profile, blueprint, schedule, and tables into a running app. No code.",
+    description: "Tell Relay what you do each week. It builds a running app for you. No code needed.",
   },
   {
     icon: Shield,
     title: "Your rules, enforced",
-    description: "Every agent action respects your policies. Full audit trail for every decision.",
+    description: "Agents follow your rules on every task. You get a full record of what they did.",
   },
   {
     icon: Wallet,
     title: "Know what you spend",
-    description: "Track spend per task, per provider. Budget guardrails prevent surprise bills.",
+    description: "See the cost of each task. Set a budget so you never get a surprise bill.",
   },
 ];
 
@@ -44,7 +44,7 @@ export function WelcomeLanding({ starters = [] }: WelcomeLandingProps) {
         Welcome
       </h1>
       <p className="text-base text-muted-foreground mb-8 max-w-lg">
-        Your AI Business Operating System. Describe an app, Orionfold Relay builds it, and runs it on your rules, your budget, your data.
+        Relay is your AI business operating system. Describe an app. Relay builds it and runs it on your rules, your budget, and your data.
       </p>
 
       <div className="grid grid-cols-1 sm:grid-cols-3 gap-4 w-full mb-8">

package/src/components/onboarding/runtime-preference-modal.tsx

@@ -42,7 +42,7 @@ const STATIC_OPTIONS: readonly PreferenceOption[] = [
     id: "quality",
     label: "Best quality",
     capabilityNote:
-      "Top-tier model (Opus). Full filesystem + tool access; highest cost.",
+      "Our smartest model (Opus). It can use every tool and read files. Costs the most.",
     recommendedModel: "opus",
     icon: Sparkles,
   },
@@ -50,7 +50,7 @@ const STATIC_OPTIONS: readonly PreferenceOption[] = [
     id: "balanced",
     label: "Balanced (recommended)",
     capabilityNote:
-      "Strong quality at a moderate price (Sonnet). Same capabilities as Opus.",
+      "Great quality for less (Sonnet). It can do everything Opus can.",
     recommendedModel: "sonnet",
     icon: Scale,
   },
@@ -58,7 +58,7 @@ const STATIC_OPTIONS: readonly PreferenceOption[] = [
     id: "cost",
     label: "Lowest cost",
     capabilityNote:
-      "Fastest, cheapest cloud model (Haiku). Same tool surface as Sonnet.",
+      "Our fastest, cheapest model (Haiku). It uses the same tools as Sonnet.",
     recommendedModel: "haiku",
     icon: DollarSign,
   },
@@ -66,7 +66,7 @@ const STATIC_OPTIONS: readonly PreferenceOption[] = [
     id: "privacy",
     label: "Best privacy (local only)",
     capabilityNote:
-      "Runs entirely on your machine via Ollama. No cloud calls; no MCP servers; smaller context window.",
+      "Runs on your own computer with Ollama. Nothing leaves your machine. It skips cloud tools and holds less at once.",
     recommendedModel: "", // resolved against the Ollama discovery list at submit time
     icon: Lock,
   },
@@ -168,7 +168,7 @@ export function RuntimePreferenceModal({
       return {
         modelId: BALANCED_FALLBACK_MODEL,
         fallbackNote:
-          "No local models found. Point Orionfold Relay at your Ollama install in Settings. Using balanced default for now.",
+          "We could not find a local model. We will use the balanced model for now. To use your own, point Relay at Ollama in Settings.",
       };
     }
     return {
@@ -248,8 +248,8 @@ export function RuntimePreferenceModal({
         <DialogHeader>
           <DialogTitle>Pick your default chat model</DialogTitle>
           <DialogDescription>
-            We&apos;ll set sensible defaults based on what matters most to you.
-            You can change this anytime in Settings.
+            Tell us what matters most and we will set a good default. You can
+            change it anytime in Settings.
           </DialogDescription>
         </DialogHeader>
 
@@ -311,7 +311,7 @@ export function RuntimePreferenceModal({
                 onClick={handleSkip}
                 disabled={submitting}
               >
-                Skip — use default
+                Skip, use default
               </Button>
               <Button onClick={handleConfirm} disabled={submitting}>
                 {submitting ? "Saving…" : "Continue"}