@rudderhq/agent-runtime-codex-local 0.6.6-canary.8 → 0.7.0

package/skills/app-builder/assets/scaffold/components/contacts-workspace.tsx

@@ -0,0 +1,292 @@
+"use client";
+
+import { Button } from "@/components/ui/button";
+import { Card, CardContent, CardHeader } from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Download, Plus, Search, Trash2, Upload } from "lucide-react";
+import { FormEvent, useCallback, useEffect, useMemo, useRef, useState } from "react";
+
+type Contact = {
+  id: string;
+  name: string;
+  email: string;
+  company: string;
+  status: "new" | "contacted" | "replied" | "paused";
+  createdAt: string;
+  updatedAt: string;
+};
+
+type Draft = {
+  name: string;
+  email: string;
+  company: string;
+};
+
+const emptyDraft: Draft = { name: "", email: "", company: "" };
+
+export function ContactsWorkspace() {
+  const [contacts, setContacts] = useState<Contact[]>([]);
+  const [draft, setDraft] = useState<Draft>(emptyDraft);
+  const [query, setQuery] = useState("");
+  const [loading, setLoading] = useState(true);
+  const [saving, setSaving] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const importRef = useRef<HTMLInputElement>(null);
+
+  const loadContacts = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const response = await fetch("/api/contacts", { cache: "no-store" });
+      if (!response.ok) throw new Error("Could not load contacts.");
+      const body = await response.json() as { contacts: Contact[] };
+      setContacts(body.contacts);
+    } catch (reason) {
+      setError(reason instanceof Error ? reason.message : "Could not load contacts.");
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    void loadContacts();
+  }, [loadContacts]);
+
+  const visibleContacts = useMemo(() => {
+    const normalized = query.trim().toLowerCase();
+    if (!normalized) return contacts;
+    return contacts.filter((contact) => (
+      `${contact.name} ${contact.email} ${contact.company} ${contact.status}`
+        .toLowerCase()
+        .includes(normalized)
+    ));
+  }, [contacts, query]);
+
+  async function createContact(event: FormEvent) {
+    event.preventDefault();
+    setSaving(true);
+    setError(null);
+    try {
+      const response = await fetch("/api/contacts", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(draft),
+      });
+      if (!response.ok) {
+        const body = await response.json().catch(() => null) as { error?: string } | null;
+        throw new Error(body?.error === "invalid_contact"
+          ? "Enter a name and a valid email address."
+          : "Could not create the contact.");
+      }
+      setDraft(emptyDraft);
+      await loadContacts();
+    } catch (reason) {
+      setError(reason instanceof Error ? reason.message : "Could not create the contact.");
+    } finally {
+      setSaving(false);
+    }
+  }
+
+  async function deleteContact(contact: Contact) {
+    if (!window.confirm(`Delete ${contact.name}? This cannot be undone.`)) return;
+    setError(null);
+    const response = await fetch(`/api/contacts/${contact.id}`, { method: "DELETE" });
+    if (!response.ok) {
+      setError("Could not delete the contact.");
+      return;
+    }
+    setContacts((current) => current.filter((candidate) => candidate.id !== contact.id));
+  }
+
+  async function importData(file: File) {
+    setError(null);
+    try {
+      const payload = JSON.parse(await file.text());
+      const response = await fetch("/api/data/import", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload),
+      });
+      if (!response.ok) throw new Error("The import file is invalid or incompatible.");
+      await loadContacts();
+    } catch (reason) {
+      setError(reason instanceof Error ? reason.message : "Could not import this file.");
+    } finally {
+      if (importRef.current) importRef.current.value = "";
+    }
+  }
+
+  return (
+    <div className="mx-auto grid max-w-7xl gap-6 px-4 py-6 lg:grid-cols-[minmax(0,1fr)_22rem] lg:px-8">
+      <section className="min-w-0">
+        <header className="mb-5 flex flex-col gap-4 sm:flex-row sm:items-end sm:justify-between">
+          <div>
+            <p className="mb-1 text-sm font-medium text-[var(--primary)]">Contacts</p>
+            <h1 className="m-0 text-2xl font-semibold tracking-tight">Customer workspace</h1>
+            <p className="mb-0 mt-2 text-sm text-[var(--muted-foreground)]">
+              Keep the next conversation visible and every record on this device.
+            </p>
+          </div>
+          <div className="flex flex-wrap gap-2">
+            <input
+              ref={importRef}
+              aria-label="Import app data"
+              className="sr-only"
+              type="file"
+              accept="application/json,.json"
+              onChange={(event) => {
+                const file = event.currentTarget.files?.[0];
+                if (file) void importData(file);
+              }}
+            />
+            <Button type="button" variant="outline" onClick={() => importRef.current?.click()}>
+              <Upload aria-hidden size={16} />
+              Import
+            </Button>
+            <Button asChild variant="outline">
+              <a href="/api/data/export" download>
+                <Download aria-hidden size={16} />
+                Export
+              </a>
+            </Button>
+          </div>
+        </header>
+
+        <Card>
+          <CardHeader className="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
+            <div>
+              <h2 className="m-0 text-base font-semibold">All contacts</h2>
+              <p className="mb-0 mt-1 text-sm text-[var(--muted-foreground)]">
+                {contacts.length} {contacts.length === 1 ? "record" : "records"}
+              </p>
+            </div>
+            <div className="relative w-full sm:w-72">
+              <Search
+                aria-hidden
+                className="pointer-events-none absolute left-3 top-1/2 -translate-y-1/2 text-[var(--muted-foreground)]"
+                size={16}
+              />
+              <Input
+                aria-label="Search contacts"
+                className="pl-9"
+                placeholder="Search name, email, company…"
+                value={query}
+                onChange={(event) => setQuery(event.target.value)}
+              />
+            </div>
+          </CardHeader>
+          <div aria-live="polite">
+            {loading ? (
+              <p className="p-8 text-center text-sm text-[var(--muted-foreground)]">
+                Loading contacts…
+              </p>
+            ) : visibleContacts.length === 0 ? (
+              <div className="p-10 text-center">
+                <h3 className="m-0 text-base font-semibold">
+                  {contacts.length === 0 ? "No contacts yet" : "No matching contacts"}
+                </h3>
+                <p className="mb-0 mt-2 text-sm text-[var(--muted-foreground)]">
+                  {contacts.length === 0
+                    ? "Add the first contact with the form beside this list."
+                    : "Try a different name, email, company, or status."}
+                </p>
+              </div>
+            ) : (
+              <div className="overflow-x-auto">
+                <table className="w-full min-w-[42rem] border-collapse text-left text-sm">
+                  <thead className="bg-[var(--muted)] text-xs uppercase tracking-wide text-[var(--muted-foreground)]">
+                    <tr>
+                      <th className="px-5 py-3 font-medium" scope="col">Contact</th>
+                      <th className="px-5 py-3 font-medium" scope="col">Company</th>
+                      <th className="px-5 py-3 font-medium" scope="col">Status</th>
+                      <th className="px-5 py-3 text-right font-medium" scope="col">Actions</th>
+                    </tr>
+                  </thead>
+                  <tbody>
+                    {visibleContacts.map((contact) => (
+                      <tr className="border-t" key={contact.id}>
+                        <td className="px-5 py-4">
+                          <strong className="block font-medium">{contact.name}</strong>
+                          <span className="text-[var(--muted-foreground)]">{contact.email}</span>
+                        </td>
+                        <td className="px-5 py-4">{contact.company || "—"}</td>
+                        <td className="px-5 py-4">
+                          <span className="rounded-full bg-[var(--muted)] px-2.5 py-1 text-xs font-medium capitalize">
+                            {contact.status}
+                          </span>
+                        </td>
+                        <td className="px-5 py-4 text-right">
+                          <Button
+                            aria-label={`Delete ${contact.name}`}
+                            size="sm"
+                            type="button"
+                            variant="ghost"
+                            onClick={() => void deleteContact(contact)}
+                          >
+                            <Trash2 aria-hidden size={16} />
+                          </Button>
+                        </td>
+                      </tr>
+                    ))}
+                  </tbody>
+                </table>
+              </div>
+            )}
+          </div>
+        </Card>
+      </section>
+
+      <aside>
+        <Card>
+          <CardHeader>
+            <h2 className="m-0 flex items-center gap-2 text-base font-semibold">
+              <Plus aria-hidden size={18} />
+              Add contact
+            </h2>
+          </CardHeader>
+          <CardContent>
+            <form className="grid gap-4" onSubmit={(event) => void createContact(event)}>
+              <div className="grid gap-1.5">
+                <Label htmlFor="contact-name">Name</Label>
+                <Input
+                  id="contact-name"
+                  required
+                  autoComplete="name"
+                  value={draft.name}
+                  onChange={(event) => setDraft({ ...draft, name: event.target.value })}
+                />
+              </div>
+              <div className="grid gap-1.5">
+                <Label htmlFor="contact-email">Email</Label>
+                <Input
+                  id="contact-email"
+                  required
+                  autoComplete="email"
+                  type="email"
+                  value={draft.email}
+                  onChange={(event) => setDraft({ ...draft, email: event.target.value })}
+                />
+              </div>
+              <div className="grid gap-1.5">
+                <Label htmlFor="contact-company">Company</Label>
+                <Input
+                  id="contact-company"
+                  autoComplete="organization"
+                  value={draft.company}
+                  onChange={(event) => setDraft({ ...draft, company: event.target.value })}
+                />
+              </div>
+              {error ? (
+                <p className="m-0 text-sm text-[var(--destructive)]" role="alert">{error}</p>
+              ) : null}
+              <Button disabled={saving} type="submit">
+                {saving ? "Adding…" : "Add contact"}
+              </Button>
+            </form>
+          </CardContent>
+        </Card>
+      </aside>
+    </div>
+  );
+}

package/skills/app-builder/assets/scaffold/components/ui/button.tsx

@@ -0,0 +1,42 @@
+import { cn } from "@/lib/utils";
+import { Slot } from "@radix-ui/react-slot";
+import { cva, type VariantProps } from "class-variance-authority";
+import * as React from "react";
+
+const buttonVariants = cva(
+  "inline-flex min-h-10 items-center justify-center gap-2 rounded-lg px-4 text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--ring)] disabled:pointer-events-none disabled:opacity-50",
+  {
+    variants: {
+      variant: {
+        default: "bg-[var(--primary)] text-[var(--primary-foreground)] hover:brightness-95",
+        outline: "border bg-[var(--card)] hover:bg-[var(--muted)]",
+        ghost: "hover:bg-[var(--muted)]",
+        destructive: "bg-[var(--destructive)] text-white hover:brightness-95",
+      },
+      size: {
+        default: "h-10",
+        sm: "h-9 px-3",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  },
+);
+
+export interface ButtonProps
+  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
+    VariantProps<typeof buttonVariants> {
+  asChild?: boolean;
+}
+
+export function Button({ className, variant, size, asChild, ...props }: ButtonProps) {
+  const Component = asChild ? Slot : "button";
+  return (
+    <Component
+      className={cn(buttonVariants({ variant, size, className }))}
+      {...props}
+    />
+  );
+}

package/skills/app-builder/assets/scaffold/components/ui/card.tsx

@@ -0,0 +1,19 @@
+import { cn } from "@/lib/utils";
+import * as React from "react";
+
+export function Card({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
+  return (
+    <section
+      className={cn("rounded-xl border bg-[var(--card)] text-[var(--card-foreground)] shadow-sm", className)}
+      {...props}
+    />
+  );
+}
+
+export function CardHeader({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
+  return <div className={cn("border-b px-5 py-4", className)} {...props} />;
+}
+
+export function CardContent({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
+  return <div className={cn("p-5", className)} {...props} />;
+}

package/skills/app-builder/assets/scaffold/components/ui/input.tsx

@@ -0,0 +1,17 @@
+import { cn } from "@/lib/utils";
+import * as React from "react";
+
+export const Input = React.forwardRef<HTMLInputElement, React.ComponentProps<"input">>(
+  ({ className, type, ...props }, ref) => (
+    <input
+      ref={ref}
+      type={type}
+      className={cn(
+        "flex h-10 w-full rounded-lg border bg-white px-3 py-2 text-sm outline-none placeholder:text-[var(--muted-foreground)] focus:ring-2 focus:ring-[var(--ring)] disabled:opacity-50",
+        className,
+      )}
+      {...props}
+    />
+  ),
+);
+Input.displayName = "Input";

package/skills/app-builder/assets/scaffold/components/ui/label.tsx

@@ -0,0 +1,6 @@
+import { cn } from "@/lib/utils";
+import * as React from "react";
+
+export function Label({ className, ...props }: React.LabelHTMLAttributes<HTMLLabelElement>) {
+  return <label className={cn("text-sm font-medium", className)} {...props} />;
+}

package/skills/app-builder/assets/scaffold/data/.gitkeep

@@ -0,0 +1 @@
+

package/skills/app-builder/assets/scaffold/drizzle.config.ts

@@ -0,0 +1,18 @@
+import { defineConfig } from "drizzle-kit";
+import path from "node:path";
+
+const dataDir = process.env.RUDDER_APP_DATA_DIR
+  ? path.resolve(process.env.RUDDER_APP_DATA_DIR)
+  : path.resolve("data");
+const mode = process.env.RUDDER_APP_DATA_MODE === "production"
+  ? "app.sqlite"
+  : "dev.sqlite";
+
+export default defineConfig({
+  dialect: "sqlite",
+  schema: "./lib/db/schema.ts",
+  out: "./migrations",
+  dbCredentials: {
+    url: path.join(dataDir, mode),
+  },
+});

package/skills/app-builder/assets/scaffold/instrumentation.ts

@@ -0,0 +1,5 @@
+export async function register() {
+  if (process.env.NEXT_RUNTIME !== "nodejs") return;
+  const { startJobRunner } = await import("@/lib/jobs/runner");
+  startJobRunner();
+}

package/skills/app-builder/assets/scaffold/lib/data-transfer.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { contactStatusSchema } from "./domain";
+
+export const exportedContactSchema = z.object({
+  id: z.string().uuid(),
+  name: z.string().min(1).max(120),
+  email: z.email().max(320),
+  company: z.string().max(160),
+  status: contactStatusSchema,
+  createdAt: z.iso.datetime(),
+  updatedAt: z.iso.datetime(),
+});
+
+export const importEnvelopeSchema = z.object({
+  format: z.literal("rudder-app-data/v1"),
+  exportedAt: z.iso.datetime(),
+  data: z.object({
+    contacts: z.array(exportedContactSchema).max(100_000),
+  }),
+}).strict();
+
+type ContactRow = {
+  id: string;
+  name: string;
+  email: string;
+  company: string;
+  status: "new" | "contacted" | "replied" | "paused";
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+export function buildExportEnvelope(rows: ContactRow[]) {
+  return {
+    format: "rudder-app-data/v1" as const,
+    exportedAt: new Date().toISOString(),
+    data: {
+      contacts: rows.map((row) => ({
+        ...row,
+        createdAt: row.createdAt.toISOString(),
+        updatedAt: row.updatedAt.toISOString(),
+      })),
+    },
+  };
+}

package/skills/app-builder/assets/scaffold/lib/db/client.ts

@@ -0,0 +1,78 @@
+import {
+  drizzle,
+  type SqliteRemoteDatabase,
+} from "drizzle-orm/sqlite-proxy";
+import { mkdirSync } from "node:fs";
+import path from "node:path";
+import { DatabaseSync, type SQLInputValue } from "node:sqlite";
+import * as schema from "./schema";
+
+type DatabaseHandle = {
+  sqlite: DatabaseSync;
+  db: SqliteRemoteDatabase<typeof schema>;
+  filePath: string;
+};
+
+const handles = new Map<string, DatabaseHandle>();
+
+export function dataMode() {
+  return process.env.RUDDER_APP_DATA_MODE === "production"
+    ? "production"
+    : "development";
+}
+
+export function dataDirectory() {
+  return process.env.RUDDER_APP_DATA_DIR
+    ? path.resolve(process.env.RUDDER_APP_DATA_DIR)
+    : path.resolve("data");
+}
+
+export function databasePath() {
+  if (process.env.RUDDER_APP_DATA_DIR) {
+    return path.join(
+      dataDirectory(),
+      dataMode() === "production" ? "app.sqlite" : "dev.sqlite",
+    );
+  }
+  return path.join(
+    dataDirectory(),
+    dataMode() === "production" ? "production/app.sqlite" : "development/dev.sqlite",
+  );
+}
+
+export function getDatabase(): DatabaseHandle {
+  const filePath = databasePath();
+  const cached = handles.get(filePath);
+  if (cached) return cached;
+
+  mkdirSync(path.dirname(filePath), { recursive: true });
+  const sqlite = new DatabaseSync(filePath);
+  sqlite.exec("PRAGMA journal_mode = WAL");
+  sqlite.exec("PRAGMA foreign_keys = ON");
+  sqlite.exec("PRAGMA busy_timeout = 5000");
+  const db = drizzle(async (query, parameters, method): Promise<{ rows: unknown[] }> => {
+    const statement = sqlite.prepare(query);
+    statement.setReturnArrays(true);
+    const values = parameters as SQLInputValue[];
+    if (method === "run") {
+      statement.run(...values);
+      return { rows: [] };
+    }
+    if (method === "get") {
+      return { rows: statement.get(...values) as unknown as unknown[] };
+    }
+    return { rows: statement.all(...values) as unknown as unknown[][] };
+  }, { schema });
+  const handle: DatabaseHandle = {
+    sqlite,
+    db,
+    filePath,
+  };
+  handles.set(filePath, handle);
+  return handle;
+}
+
+export function closeDatabases() {
+  for (const handle of handles.values()) handle.sqlite.close();
+  handles.clear();
+}

package/skills/app-builder/assets/scaffold/lib/db/schema.ts

@@ -0,0 +1,35 @@
+import { integer, sqliteTable, text, uniqueIndex } from "drizzle-orm/sqlite-core";
+
+export const contacts = sqliteTable("contacts", {
+  id: text("id").primaryKey(),
+  name: text("name").notNull(),
+  email: text("email").notNull(),
+  company: text("company").notNull().default(""),
+  status: text("status", { enum: ["new", "contacted", "replied", "paused"] })
+    .notNull()
+    .default("new"),
+  createdAt: integer("created_at", { mode: "timestamp_ms" }).notNull(),
+  updatedAt: integer("updated_at", { mode: "timestamp_ms" }).notNull(),
+}, (table) => [
+  uniqueIndex("contacts_email_uq").on(table.email),
+]);
+
+export const jobs = sqliteTable("jobs", {
+  id: text("id").primaryKey(),
+  kind: text("kind").notNull(),
+  idempotencyKey: text("idempotency_key").notNull(),
+  payloadJson: text("payload_json").notNull().default("{}"),
+  status: text("status", { enum: ["pending", "running", "completed", "failed", "missed"] })
+    .notNull()
+    .default("pending"),
+  catchUpPolicy: text("catch_up_policy", { enum: ["run", "skip", "prompt"] })
+    .notNull()
+    .default("prompt"),
+  scheduledFor: integer("scheduled_for", { mode: "timestamp_ms" }).notNull(),
+  attempts: integer("attempts").notNull().default(0),
+  lastError: text("last_error"),
+  createdAt: integer("created_at", { mode: "timestamp_ms" }).notNull(),
+  updatedAt: integer("updated_at", { mode: "timestamp_ms" }).notNull(),
+}, (table) => [
+  uniqueIndex("jobs_idempotency_key_uq").on(table.idempotencyKey),
+]);

package/skills/app-builder/assets/scaffold/lib/domain.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+
+export const contactStatusSchema = z.enum(["new", "contacted", "replied", "paused"]);
+
+export const contactCreateSchema = z.object({
+  name: z.string().trim().min(1).max(120),
+  email: z.email().max(320),
+  company: z.string().trim().max(160).default(""),
+  status: contactStatusSchema.default("new"),
+});
+
+export const contactUpdateSchema = contactCreateSchema.partial().refine(
+  (value) => Object.keys(value).length > 0,
+  "At least one contact field is required",
+);
+
+export type ContactInput = z.infer<typeof contactCreateSchema>;
+export type ContactStatus = z.infer<typeof contactStatusSchema>;

package/skills/app-builder/assets/scaffold/lib/jobs/runner.ts

@@ -0,0 +1,56 @@
+import { getDatabase } from "@/lib/db/client";
+
+type RunnerState = {
+  timer: NodeJS.Timeout | null;
+  ticking: boolean;
+};
+
+const globalState = globalThis as typeof globalThis & {
+  __rudderAppJobRunner?: RunnerState;
+};
+
+function state(): RunnerState {
+  globalState.__rudderAppJobRunner ??= { timer: null, ticking: false };
+  return globalState.__rudderAppJobRunner;
+}
+
+async function tick() {
+  const current = state();
+  if (current.ticking) return;
+  current.ticking = true;
+  try {
+    const { sqlite } = getDatabase();
+    const now = Date.now();
+    sqlite.prepare(`
+      update jobs
+      set status = case catch_up_policy
+        when 'skip' then 'missed'
+        when 'run' then 'pending'
+        else 'missed'
+      end,
+      updated_at = ?
+      where status = 'pending' and scheduled_for < ?
+    `).run(now, now - 60_000);
+    // Domain-specific handlers should claim one pending job transactionally,
+    // execute it with the persisted idempotency key, and then complete/fail it.
+  } catch {
+    // The health endpoint remains authoritative. A missing pre-migration table
+    // must not create an unhandled background rejection during startup.
+  } finally {
+    current.ticking = false;
+  }
+}
+
+export function startJobRunner() {
+  const current = state();
+  if (current.timer) return;
+  current.timer = setInterval(() => void tick(), 15_000);
+  current.timer.unref();
+  void tick();
+}
+
+export function stopJobRunner() {
+  const current = state();
+  if (current.timer) clearInterval(current.timer);
+  current.timer = null;
+}

package/skills/app-builder/assets/scaffold/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/skills/app-builder/assets/scaffold/migrations/0000_app_builder_foundation.sql

@@ -0,0 +1,27 @@
+CREATE TABLE `contacts` (
+  `id` text PRIMARY KEY NOT NULL,
+  `name` text NOT NULL,
+  `email` text NOT NULL,
+  `company` text DEFAULT '' NOT NULL,
+  `status` text DEFAULT 'new' NOT NULL,
+  `created_at` integer NOT NULL,
+  `updated_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `contacts_email_uq` ON `contacts` (`email`);
+--> statement-breakpoint
+CREATE TABLE `jobs` (
+  `id` text PRIMARY KEY NOT NULL,
+  `kind` text NOT NULL,
+  `idempotency_key` text NOT NULL,
+  `payload_json` text DEFAULT '{}' NOT NULL,
+  `status` text DEFAULT 'pending' NOT NULL,
+  `catch_up_policy` text DEFAULT 'prompt' NOT NULL,
+  `scheduled_for` integer NOT NULL,
+  `attempts` integer DEFAULT 0 NOT NULL,
+  `last_error` text,
+  `created_at` integer NOT NULL,
+  `updated_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `jobs_idempotency_key_uq` ON `jobs` (`idempotency_key`);