import { StringEnum } from "@earendil-works/pi-ai"; import { Type, type Static, type TProperties } from "typebox"; const text = (maxLength: number) => Type.String({ minLength: 1, maxLength, pattern: "\\S" }); const strings = (maxItems = 20) => Type.Array(text(1_000), { maxItems }); const objectOptions = { additionalProperties: false } as const; const title = text(200); const revision = Type.Integer({ minimum: 1 }); const BriefStatuses = ["active", "blocked", "complete", "archived"] as const; const TaskStatuses = ["pending", "active", "blocked", "done", "cancelled"] as const; const FindingStatuses = ["hypothesis", "confirmed", "refuted"] as const; export const BriefFields = { title, objective: text(1_000), projects: Type.Array(text(4_096), { minItems: 1, maxItems: 20, description: "Absolute repository roots or working directories.", }), scope: Type.Optional(Type.String({ maxLength: 1_000 })), constraints: Type.Optional(Type.String({ maxLength: 1_500 })), approach: Type.Optional(Type.String({ maxLength: 1_500 })), status: StringEnum(BriefStatuses), related: Type.Optional(strings()), }; export const BriefSchema = Type.Object( { kind: Type.Literal("brief"), ...BriefFields }, objectOptions, ); export type Brief = Static; const TaskFields = { title, body: Type.Optional(Type.String({ maxLength: 8_000 })), status: StringEnum(TaskStatuses), blocked_on: Type.Optional( Type.Union([Type.String({ maxLength: 500 }), Type.Null()], { description: "What a blocked task waits for. Required for status blocked. Null or an empty string clears it.", }), ), owner: Type.Optional(Type.String({ maxLength: 200 })), evidence: Type.Optional({ ...strings(), description: "Required for status done." }), parent: Type.Optional({ ...text(100), description: "ID of a top-level task. A subtask cannot have subtasks.", }), }; const TaskSchema = Type.Object({ kind: Type.Literal("task"), ...TaskFields }, objectOptions); const NoteFields = { title, body: text(8_000), sources: Type.Optional({ ...strings(), description: "Required for status confirmed or refuted.", }), supersedes: Type.Optional(text(100)), }; const FindingSchema = Type.Object( { kind: Type.Literal("finding"), ...NoteFields, status: StringEnum(FindingStatuses), }, objectOptions, ); const DecisionSchema = Type.Object( { kind: Type.Literal("decision"), ...NoteFields, user_entry: text(100), }, objectOptions, ); export const ItemSchema = Type.Union([TaskSchema, FindingSchema, DecisionSchema]); export type Item = Static; export const AuthorSchema = Type.Object( { session: text(200), entry: Type.Optional(text(200)), model: Type.Optional(text(200)), }, objectOptions, ); export type Author = Static; export const EntrySchema = Type.Object( { id: text(100), revision, updated: text(100), author: AuthorSchema, content: Type.Union([BriefSchema, ItemSchema]), superseded_by: Type.Optional(text(100)), }, objectOptions, ); export type Entry = Static; export const CreateSchema = Type.Object( { ...Type.Omit(Type.Object(BriefFields), ["projects", "status"]).properties, projects: Type.Optional(BriefFields.projects), }, objectOptions, ); export type CreateInput = Static; const patch = (fields: T) => Type.Partial(Type.Object(fields), { ...objectOptions, minProperties: 1 }); const add = (entry: typeof TaskSchema | typeof FindingSchema | typeof DecisionSchema) => Type.Object({ action: Type.Literal("add"), entry }, objectOptions); export const OperationSchemas = { set_brief: Type.Object( { action: Type.Literal("set_brief"), expected_revision: revision, patch: patch(BriefFields), }, objectOptions, ), update_task: Type.Object( { action: Type.Literal("update_task"), id: text(100), expected_revision: revision, patch: patch(TaskFields), }, objectOptions, ), task: add(TaskSchema), finding: add(FindingSchema), decision: add(DecisionSchema), }; const optional = (fields: T) => Type.Partial(Type.Object(fields)).properties; const LIMITS = new Set([ "minLength", "maxLength", "pattern", "minItems", "maxItems", "minimum", "~optional", ]); // The model sees no limits here. OperationSchemas enforce them with shorter errors. const loose = (schema: T): T => JSON.parse(JSON.stringify(schema, (key, value) => (LIMITS.has(key) ? undefined : value))); const operations = (decision: T) => Type.Array( loose( Type.Object( { action: StringEnum(["set_brief", "add", "update_task"] as const), id: Type.Optional({ ...text(100), description: "Task ID for update_task." }), expected_revision: Type.Optional(revision), patch: Type.Optional( Type.Object( { ...optional({ ...BriefFields, ...TaskFields }), status: Type.Optional( StringEnum([...new Set([...BriefStatuses, ...TaskStatuses])]), ), }, { ...objectOptions, description: "Brief fields for set_brief, task fields for update_task.", }, ), ), entry: Type.Optional( Type.Object( { ...optional({ ...NoteFields, ...decision, ...TaskFields, status: StringEnum([...TaskStatuses, ...FindingStatuses]), }), kind: StringEnum(["task", "finding", "decision"] as const), title, }, objectOptions, ), ), }, objectOptions, ), ), { minItems: 1, maxItems: 30 }, ); export const OperationsSchema = operations({ user_entry: DecisionSchema.properties.user_entry }); export type Operation = Static[number]; export const UpdateOperationsSchema = operations({ user_quote: Type.String({ description: "A contiguous phrase copied from the user message that makes the decision. Case and whitespace are ignored.", }), }); export const FindSchema = Type.Object( { query: Type.Optional({ ...text(1_000), description: "Natural-language description of the work to find.", }), change: Type.Optional( Type.String({ pattern: "^[k-z]{8,32}$", description: "jj change ID. Finds records linked to the change or its predecessors, in all projects and statuses.", }), ), project: Type.Optional( Type.String({ minLength: 1, maxLength: 4_096, description: "Absolute repository root or working directory.", }), ), all_projects: Type.Optional( Type.Boolean({ description: "Include work outside the current repository." }), ), status: Type.Optional(BriefFields.status), limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 50 })), offset: Type.Optional(Type.Integer({ minimum: 0 })), }, objectOptions, ); export type FindInput = Static; export const ReadSchema = Type.Object( { id: Type.Optional(text(100)), attach: Type.Optional(Type.Boolean()), entry_ids: Type.Optional(Type.Array(text(100), { minItems: 1, maxItems: 20 })), since_revision: Type.Optional(Type.Integer({ minimum: 0 })), query: Type.Optional(text(1_000)), history: Type.Optional(Type.Boolean()), after_revision: Type.Optional( Type.Integer({ minimum: 0, description: "next_revision from the previous page. Repeat the same read with it.", }), ), limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 50 })), }, objectOptions, ); export type ReadInput = Static; export const SummarySchema = Type.Object({ id: Type.String(), revision, kind: StringEnum(["task", "finding", "decision"] as const), title: Type.String(), status: Type.Optional(Type.String()), parent: Type.Optional(Type.String()), blocked_on: Type.Optional(Type.String()), }); export type Summary = Static; export const ReadOutput = Type.Object({ id: Type.String(), revision, view: StringEnum(["current", "entries", "changes", "search", "history"] as const), entries: Type.Array(EntrySchema), index: Type.Array(SummarySchema), omitted: Type.Integer({ minimum: 0 }), next_revision: Type.Optional(revision), }); export type ReadResult = Static; export const MutationOutput = Type.Object({ id: Type.String(), revision, changed: Type.Array(Type.Object({ id: Type.String(), revision })), }); export type MutationResult = Static; export const FindOutput = Type.Object({ records: Type.Array( Type.Object({ id: Type.String(), title: Type.String(), objective: Type.String(), projects: Type.Array(Type.String()), status: BriefFields.status, revision, updated: Type.String(), entries: Type.Optional( Type.Array( Type.Object({ id: Type.String(), kind: Type.String(), title: Type.String() }), ), ), linked_revision: Type.Optional(revision), }), ), next_offset: Type.Optional(Type.Integer({ minimum: 0 })), outside_project: Type.Optional(Type.Literal(true)), }); export type FindResult = Static;