verybot 0.1.8

package/dist/tasks/types.js

@@ -0,0 +1,80 @@
+import { z } from "zod";
+/** Max upload file size: 10 MB */
+export const MAX_FILE_SIZE = 10 * 1024 * 1024;
+const ALLOWED_ATTACHMENT_TYPES = ["image/png", "image/jpeg", "image/gif", "image/webp"];
+export const ALLOWED_IMAGE_TYPES = new Set(ALLOWED_ATTACHMENT_TYPES);
+export const EXT_FOR_MIME = {
+    "image/png": ".png",
+    "image/jpeg": ".jpg",
+    "image/gif": ".gif",
+    "image/webp": ".webp",
+};
+/** Legacy list of default status keys — used only for migration backfills. */
+export const LEGACY_STATUS_KEYS = ["backlog", "todo", "plan", "in_progress", "done", "archived"];
+/** Reusable Zod string for task status keys: 1-128 chars, word-chars only. */
+const StatusKeySchema = z.string().min(1).max(128).regex(/^\w+$/, "Status key must be alphanumeric/underscore");
+export const TASK_PRIORITIES = ["low", "medium", "high"];
+/** Default statuses used when a team has no custom config. */
+export const DEFAULT_TASK_STATUSES = [
+    { key: "backlog", label: "Backlog", color: "#71717a" },
+    { key: "todo", label: "Todo", color: "#64748b" },
+    { key: "plan", label: "Plan", color: "#06b6d4" },
+    { key: "in_progress", label: "In Progress", color: "#f59e0b" },
+    { key: "done", label: "Done", color: "#22c55e" },
+];
+const MAX_ATTACHMENTS_PER_TASK = 20;
+export const MAX_TASK_COMMENT_LENGTH = 4000;
+const TaskAttachmentSchema = z.object({
+    id: z.string().regex(/^[0-9a-f-]+\.(png|jpg|gif|webp)$/),
+    name: z.string().max(255),
+    type: z.enum(ALLOWED_ATTACHMENT_TYPES),
+    size: z.number().int().positive().max(10 * 1024 * 1024),
+    createdAt: z.number().int().positive(),
+});
+const TaskCommentContentSchema = z.string().trim().min(1).max(MAX_TASK_COMMENT_LENGTH);
+export const CreateTaskSchema = z.object({
+    title: z.string().min(1),
+    description: z.string().optional(),
+    teamId: z.string().optional(),
+    assignee: z.string().optional(),
+    priority: z.enum(TASK_PRIORITIES).default("medium"),
+    status: StatusKeySchema.default("todo"),
+    needsHumanReview: z.boolean().default(false),
+    attachments: z.array(TaskAttachmentSchema).max(MAX_ATTACHMENTS_PER_TASK).optional(),
+});
+export const UpdateTaskSchema = z.object({
+    id: z.string(),
+    title: z.string().min(1).optional(),
+    description: z.string().nullable().optional(),
+    status: StatusKeySchema.optional(),
+    assignee: z.string().nullable().optional(),
+    priority: z.enum(TASK_PRIORITIES).optional(),
+    teamId: z.string().nullable().optional(),
+    needsHumanReview: z.boolean().optional(),
+    attachments: z.array(TaskAttachmentSchema).max(MAX_ATTACHMENTS_PER_TASK).optional(),
+});
+export const ListTasksSchema = z.object({
+    teamId: z.string().optional(),
+    status: StatusKeySchema.optional(),
+    assignee: z.string().optional(),
+    needsHumanReview: z.boolean().optional(),
+    includeArchived: z.boolean().optional(),
+});
+export const ReorderTasksSchema = z.object({
+    status: StatusKeySchema,
+    orderedIds: z.array(z.string()).min(1),
+});
+export const ListTaskCommentsSchema = z.object({
+    taskId: z.string().min(1),
+});
+export const AddTaskCommentSchema = z.object({
+    taskId: z.string().min(1),
+    content: TaskCommentContentSchema,
+});
+export const UpdateTaskCommentSchema = z.object({
+    id: z.string().min(1),
+    content: TaskCommentContentSchema,
+});
+export const DeleteTaskCommentSchema = z.object({
+    id: z.string().min(1),
+});

package/dist/teams/status-config.d.ts

@@ -0,0 +1,8 @@
+import type { TaskStatusConfig } from "../config/agent-config.js";
+/** Required terminal task status key across all teams. */
+export declare const REQUIRED_DONE_STATUS_KEY = "done";
+/**
+ * Validate a full TaskStatusConfig[] payload.
+ * Enforces structural correctness plus the required `done` status invariant.
+ */
+export declare function validateStatusConfigs(statuses: unknown): asserts statuses is TaskStatusConfig[];

package/dist/teams/status-config.js

@@ -0,0 +1,40 @@
+const STATUS_KEY_RE = /^\w+$/;
+const HEX_COLOR_RE = /^#[0-9a-fA-F]{6}$/;
+const MIN_STATUS_COUNT = 1;
+const MAX_STATUS_KEY_LENGTH = 128;
+const DONE_STATUS_KEY = "done";
+/** Required terminal task status key across all teams. */
+export const REQUIRED_DONE_STATUS_KEY = DONE_STATUS_KEY;
+/**
+ * Validate a full TaskStatusConfig[] payload.
+ * Enforces structural correctness plus the required `done` status invariant.
+ */
+export function validateStatusConfigs(statuses) {
+    if (!Array.isArray(statuses))
+        throw new Error("statuses must be an array");
+    if (statuses.length < MIN_STATUS_COUNT)
+        throw new Error("statuses must contain at least one status");
+    const keys = new Set();
+    for (const status of statuses) {
+        if (typeof status !== "object" || status === null)
+            throw new Error("Each status must be an object");
+        const candidate = status;
+        if (typeof candidate.key !== "string"
+            || candidate.key.length > MAX_STATUS_KEY_LENGTH
+            || !STATUS_KEY_RE.test(candidate.key)) {
+            throw new Error(`Invalid status key "${candidate.key}": only letters, numbers, and underscores allowed`);
+        }
+        if (keys.has(candidate.key))
+            throw new Error(`Duplicate status key "${candidate.key}"`);
+        keys.add(candidate.key);
+        if (typeof candidate.label !== "string" || candidate.label.trim().length === 0) {
+            throw new Error(`Status "${candidate.key}" must have a non-empty label`);
+        }
+        if (typeof candidate.color !== "string" || !HEX_COLOR_RE.test(candidate.color)) {
+            throw new Error(`Status "${candidate.key}" must have a valid hex color`);
+        }
+    }
+    if (!keys.has(DONE_STATUS_KEY)) {
+        throw new Error(`statuses must include a "${DONE_STATUS_KEY}" status key`);
+    }
+}

package/dist/teams/store.d.ts

@@ -0,0 +1,111 @@
+import type { Team, AgentRow } from "./types.js";
+import type { TeamConfig, TaskStatusConfig } from "../config/agent-config.js";
+/** Max allowed length for team/agent names. */
+export declare const MAX_NAME_LENGTH = 128;
+/** Max allowed length for agent identity strings. */
+export declare const MAX_IDENTITY_LENGTH = 10000;
+/** Max allowed length for model strings. */
+export declare const MAX_MODEL_LENGTH = 256;
+/** Hex color pattern: #RRGGBB */
+export declare const HEX_COLOR_RE: RegExp;
+export interface CreateTeamInput {
+    /** Optional caller-provided id. If omitted, a random UUID is generated. */
+    id?: string;
+    name: string;
+    color?: string;
+    workspace?: string;
+    variables?: Record<string, string>;
+    statuses?: TaskStatusConfig[];
+}
+export interface UpdateTeamInput {
+    name?: string;
+    color?: string;
+    workspace?: string;
+    variables?: Record<string, string>;
+    statuses?: TaskStatusConfig[];
+}
+export interface CreateAgentInput {
+    /** Optional caller-provided id. If omitted, a random UUID is generated. */
+    id?: string;
+    name: string;
+    role: "orchestrator" | "worker";
+    model: string;
+    contextWindow?: number;
+    maxSteps?: number;
+    identity?: string;
+    tools?: string[];
+    timeout?: number;
+    templateId?: string | null;
+    subscriptions?: string[];
+    concurrency?: number;
+}
+export interface UpdateAgentInput {
+    name?: string;
+    role?: "orchestrator" | "worker";
+    model?: string;
+    contextWindow?: number;
+    maxSteps?: number;
+    identity?: string;
+    tools?: string[];
+    timeout?: number;
+    templateId?: string | null;
+    subscriptions?: string[];
+    concurrency?: number;
+}
+/**
+ * SQLite-backed persistence for teams and agents.
+ * Shares the same DB file as MemoryStore, TaskStore, etc.
+ */
+export declare class TeamStore {
+    private db;
+    private constructor();
+    static create(dbPath: string): Promise<TeamStore>;
+    private createSchema;
+    /** Run a function inside a SQLite transaction (all-or-nothing). */
+    transaction<T>(fn: () => T): T;
+    createTeam(input: CreateTeamInput): Team;
+    updateTeam(id: string, input: UpdateTeamInput): Team | null;
+    deleteTeam(id: string): boolean;
+    getTeamById(id: string): Team | null;
+    getTeamByName(name: string): Team | null;
+    listTeams(): Team[];
+    /**
+     * Bootstrap helper:
+     * guarantees a team row with id "default" exists.
+     */
+    ensureTeamWhenEmpty(): Team | null;
+    createAgent(teamId: string, input: CreateAgentInput): AgentRow;
+    updateAgent(id: string, input: UpdateAgentInput): AgentRow | null;
+    deleteAgent(id: string): boolean;
+    getAgentById(id: string): AgentRow | null;
+    /**
+     * Runtime lookup for agent execution.
+     * Resolves template-linked identity and interpolates team variables.
+     */
+    getRuntimeAgentById(id: string): AgentRow | null;
+    listAgentsByTeam(teamId: string): AgentRow[];
+    getAgentByName(teamId: string, name: string): AgentRow | null;
+    /** Replace an agent's subscriptions (transactional delete + reinsert). */
+    setSubscriptions(agentId: string, statuses: string[]): void;
+    /** Get an agent's subscribed task statuses. */
+    getSubscriptions(agentId: string): string[];
+    /**
+     * Find claimable tasks by joining tasks, agent_subscriptions, and agents tables.
+     * Used by TaskSubscriberManager to find task/agent matches without raw DB access.
+     * Enforces concurrency at query time from live claim counts.
+     */
+    findClaimableTasks(limit: number): {
+        taskId: string;
+        agentId: string;
+        teamId: string;
+        agentName: string;
+        model: string;
+        concurrency: number;
+    }[];
+    /**
+     * Convert DB rows to the existing TeamConfig[] format so TeamRegistry
+     * constructor is unchanged. Uses a single JOIN query instead of N+1.
+     */
+    toTeamConfigs(): TeamConfig[];
+    close(): void;
+}