This commit is contained in:
138
packages/shared/src/schemas.ts
Normal file
138
packages/shared/src/schemas.ts
Normal file
@@ -0,0 +1,138 @@
|
||||
// @waggle/shared — Zod validation schemas for API requests
|
||||
|
||||
import { z } from 'zod';
|
||||
import { AGENT_RUN_STATES } from './types.js';
|
||||
|
||||
export const createTeamSchema = z.object({
|
||||
name: z.string().min(1).max(100),
|
||||
slug: z.string().min(1).max(50).regex(/^[a-z0-9-]+$/),
|
||||
});
|
||||
|
||||
export const inviteMemberSchema = z.object({
|
||||
email: z.string().email(),
|
||||
role: z.enum(['admin', 'member']),
|
||||
});
|
||||
|
||||
export const updateMemberSchema = z.object({
|
||||
role: z.enum(['admin', 'member']).optional(),
|
||||
roleDescription: z.string().max(500).optional(),
|
||||
interests: z.array(z.string()).optional(),
|
||||
});
|
||||
|
||||
export const createTaskSchema = z.object({
|
||||
title: z.string().min(1).max(200),
|
||||
description: z.string().max(5000).optional(),
|
||||
priority: z.enum(['critical', 'high', 'normal', 'low']).default('normal'),
|
||||
parentTaskId: z.string().uuid().optional(),
|
||||
});
|
||||
|
||||
export const updateTaskSchema = z.object({
|
||||
title: z.string().min(1).max(200).optional(),
|
||||
description: z.string().max(5000).optional(),
|
||||
status: z.enum(['open', 'claimed', 'in_progress', 'done', 'cancelled']).optional(),
|
||||
priority: z.enum(['critical', 'high', 'normal', 'low']).optional(),
|
||||
assignedTo: z.string().uuid().nullable().optional(),
|
||||
});
|
||||
|
||||
export const sendMessageSchema = z.object({
|
||||
type: z.enum(['broadcast', 'request', 'response']),
|
||||
subtype: z.enum([
|
||||
'knowledge_check', 'task_delegation', 'skill_request', 'model_recommendation',
|
||||
'knowledge_match', 'task_claim', 'discovery', 'routed_share', 'skill_share', 'model_recipe',
|
||||
]),
|
||||
content: z.record(z.unknown()),
|
||||
referenceId: z.string().uuid().optional(),
|
||||
routing: z.array(z.object({ userId: z.string().uuid(), reason: z.string() })).optional(),
|
||||
});
|
||||
|
||||
// UX-Refactor Phase 3 (PRD §15.5): shared enum fragments for the Agent entity.
|
||||
// Ref-id arrays use plain min(1) strings — workspace/agent ids in this repo are
|
||||
// NOT all UUIDs (cron ids are numeric, artifact ids are `art_${uuid}`).
|
||||
// status derives from the §14.5 AGENT_RUN_STATES tuple in types.ts (the
|
||||
// vocabulary the sidecar agents-store actually persists) — single source.
|
||||
const agentTypeEnum = z.enum(['personal', 'workspace', 'team', 'autonomous']);
|
||||
const autonomyLevelEnum = z.enum(['manual', 'guided', 'medium', 'high']);
|
||||
const scopeEnum = z.enum(['personal', 'workspace', 'team', 'organization']);
|
||||
const agentStatusEnum = z.enum(AGENT_RUN_STATES);
|
||||
|
||||
// NOTE: this schema is consumed by the Clerk-gated CLOUD route
|
||||
// (packages/server/src/routes/agents.ts). The cloud AgentService persists only
|
||||
// the legacy fields (name/role/systemPrompt/model/tools/config/teamId) — the
|
||||
// §15.5 fields below validate but are NOT stored there yet. The local sidecar
|
||||
// surface (local/routes/agents.ts) is the §15.5 system of record.
|
||||
export const createAgentSchema = z.object({
|
||||
name: z.string().min(1).max(100),
|
||||
role: z.string().max(500).optional(),
|
||||
systemPrompt: z.string().max(10000).optional(),
|
||||
model: z.string().min(1).default('claude-haiku-4-5'),
|
||||
tools: z.array(z.string()).default([]),
|
||||
config: z.record(z.unknown()).default({}),
|
||||
teamId: z.string().uuid().optional(),
|
||||
// §15.5 optional Agent-entity fields (Phase 3) — all optional for back-compat.
|
||||
type: agentTypeEnum.optional(),
|
||||
goal: z.string().max(4000).optional(),
|
||||
description: z.string().max(2000).optional(),
|
||||
personaId: z.string().min(1).max(200).optional(),
|
||||
autonomyLevel: autonomyLevelEnum.optional(),
|
||||
workspaceIds: z.array(z.string().min(1)).optional(),
|
||||
memoryScopes: z.array(scopeEnum).optional(),
|
||||
skillIds: z.array(z.string().min(1)).optional(),
|
||||
connectorIds: z.array(z.string().min(1)).optional(),
|
||||
mcpIds: z.array(z.string().min(1)).optional(),
|
||||
permissions: z.record(z.unknown()).optional(),
|
||||
status: agentStatusEnum.optional(),
|
||||
});
|
||||
|
||||
// NOTE (Phase 3A review): speculative updateAgent/createSkill/updateSkill/
|
||||
// createAutomation/updateAutomation schemas were removed here — no route
|
||||
// consumed them and their shapes contradicted the implemented wire contracts
|
||||
// (the local routes validate inline; skills mandate steps[]; automations use a
|
||||
// nested trigger object). Re-add a schema only together with a route that
|
||||
// parses with it.
|
||||
|
||||
export const createAgentGroupSchema = z.object({
|
||||
name: z.string().min(1).max(100),
|
||||
description: z.string().max(500).optional(),
|
||||
strategy: z.enum(['parallel', 'sequential', 'coordinator']),
|
||||
members: z.array(z.object({
|
||||
agentId: z.string().uuid(),
|
||||
roleInGroup: z.enum(['lead', 'worker']).default('worker'),
|
||||
executionOrder: z.number().int().min(0).default(0),
|
||||
})),
|
||||
});
|
||||
|
||||
export const createEntitySchema = z.object({
|
||||
entityType: z.string().min(1).max(100),
|
||||
name: z.string().min(1).max(200),
|
||||
properties: z.record(z.unknown()).default({}),
|
||||
validFrom: z.string().datetime().optional(),
|
||||
validTo: z.string().datetime().optional(),
|
||||
});
|
||||
|
||||
export const createRelationSchema = z.object({
|
||||
sourceId: z.string().uuid(),
|
||||
targetId: z.string().uuid(),
|
||||
relationType: z.string().min(1).max(100),
|
||||
confidence: z.number().min(0).max(1).default(1.0),
|
||||
properties: z.record(z.unknown()).default({}),
|
||||
});
|
||||
|
||||
export const createResourceSchema = z.object({
|
||||
resourceType: z.enum(['model_recipe', 'skill', 'tool_config', 'prompt_template']),
|
||||
name: z.string().min(1).max(200),
|
||||
description: z.string().max(1000).optional(),
|
||||
config: z.record(z.unknown()),
|
||||
});
|
||||
|
||||
export const createCronSchema = z.object({
|
||||
name: z.string().min(1).max(200),
|
||||
cronExpr: z.string().min(1),
|
||||
jobType: z.string().min(1),
|
||||
jobConfig: z.record(z.unknown()).default({}),
|
||||
});
|
||||
|
||||
export const queueJobSchema = z.object({
|
||||
jobType: z.enum(['chat', 'task', 'cron', 'waggle', 'group']),
|
||||
input: z.record(z.unknown()),
|
||||
teamId: z.string().uuid().optional(),
|
||||
});
|
||||
Reference in New Issue
Block a user