A personal agent with a browser, terminal, files, and work that keeps going built with CopilotKit and AG-UI.
TypeScript
import { z } from "zod";
export type TaskStatus =
| "queued"
| "running"
| "waiting_approval"
| "waiting_input"
| "scheduled"
| "paused"
| "succeeded"
| "failed"
| "cancelled";
export interface Evidence {
id: string;
kind: "mail" | "file" | "web" | "user";
title: string;
excerpt: string;
url?: string;
}
export interface TaskStep {
id: string;
title: string;
status: "pending" | "running" | "succeeded" | "failed" | "waiting";
detail?: string;
}
export interface AgentTask {
id: string;
title: string;
prompt: string;
kind: "agent" | "document" | "monitor" | "finance" | "plan";
status: TaskStatus;
goalId?: string;
milestoneId?: string;
plan: TaskStep[];
evidence: Evidence[];
input: Record<string, unknown>;
state: Record<string, unknown>;
createdAt: string;
updatedAt: string;
nextRunAt?: string;
leaseId?: string | null;
leaseUntil?: string | null;
attempts: number;
actionId?: string | null;
result?: string;
error?: string | null;
question?: string;
artifactIds: string[];
}
export interface RunEvent {
id: string;
taskId: string;
date: string;
kind: "plan" | "step" | "observation" | "approval" | "result" | "error" | "status";
title: string;
detail: string;
}
export interface Goal {
id: string;
title: string;
description: string;
category: string;
status: "active" | "paused" | "completed";
milestones: { id: string; title: string; done: boolean }[];
createdAt: string;
}
export interface Monitor {
id: string;
taskId: string;
title: string;
url: string;
condition: "change" | "contains" | "price_below";
value: string;
intervalMinutes: number;
status: "active" | "paused" | "stopped";
nextCheckAt: string;
lastCheckedAt?: string;
lastValue?: string;
lastHash?: string;
error?: string;
checks: number;
}
export interface Idea {
id: string;
title: string;
reason: string;
evidence: Evidence[];
prompt: string;
kind: AgentTask["kind"];
input: Record<string, unknown>;
status: "new" | "dismissed" | "accepted";
taskId?: string;
createdAt: string;
}
export interface AgentMemory {
id: string;
text: string;
source: string;
createdAt: string;
}
export interface AgentArtifact {
id: string;
taskId: string;
kind: "plan" | "comparison" | "finance" | "report";
title: string;
summary: string;
data: Record<string, unknown>;
createdAt: string;
}
export interface AgentNotification {
id: string;
taskId?: string;
title: string;
body: string;
createdAt: string;
read: boolean;
}
export interface AgentIdentity {
name: string;
tone: "warm" | "concise" | "thoughtful";
avatar?: "sky" | "sand" | "lilac";
showChatUpdates?: boolean;
}
export interface AgentWorkspace {
tasks: AgentTask[];
goals: Goal[];
monitors: Monitor[];
ideas: Idea[];
memories: AgentMemory[];
artifacts: AgentArtifact[];
notifications: AgentNotification[];
identity: AgentIdentity;
worker: { running: boolean; lastTickAt?: string };
}
export const createTaskSchema = z.object({
title: z.string().trim().min(1).max(160).optional(),
prompt: z.string().trim().min(1).max(12000),
kind: z.enum(["agent", "document", "monitor", "finance", "plan"]).default("agent"),
goalId: z.string().optional(),
milestoneId: z.string().min(1).max(200).optional(),
input: z.record(z.string(), z.unknown()).default({}),
});
export type CreateTaskInput = z.infer<typeof createTaskSchema>;
export const monitorInputSchema = z
.object({
title: z.string().min(1).max(160),
url: z.url().max(4096),
condition: z.enum(["change", "contains", "price_below"]).default("change"),
value: z.string().max(300).default(""),
intervalMinutes: z.number().int().min(1).max(10080).default(15),
})
.superRefine((v, c) => {
if (v.condition !== "change" && !v.value.trim())
c.addIssue({ code: "custom", message: "Enter a condition value" });
if (
v.condition === "price_below" &&
(!Number.isFinite(Number(v.value)) || Number(v.value) <= 0)
)
c.addIssue({ code: "custom", message: "Enter a positive price" });
});
export const goalInputSchema = z.object({
title: z.string().trim().min(1).max(160),
description: z.string().max(4000).default(""),
category: z.string().max(80).default("Personal"),
milestones: z.array(z.string().min(1).max(200)).max(20).default([]),
});