Something went wrong. Try again.
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302import { 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<typeof BriefSchema>;
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<typeof ItemSchema>;
export const AuthorSchema = Type.Object( { session: text(200), entry: Type.Optional(text(200)), model: Type.Optional(text(200)), }, objectOptions,);export type Author = Static<typeof AuthorSchema>;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<typeof EntrySchema>;
export const CreateSchema = Type.Object( { ...Type.Omit(Type.Object(BriefFields), ["projects", "status"]).properties, projects: Type.Optional(BriefFields.projects), }, objectOptions,);export type CreateInput = Static<typeof CreateSchema>;
const patch = <T extends TProperties>(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 = <T extends TProperties>(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 = <T>(schema: T): T => JSON.parse(JSON.stringify(schema, (key, value) => (LIMITS.has(key) ? undefined : value)));const operations = <T extends TProperties>(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<typeof OperationsSchema>[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<typeof FindSchema>;
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<typeof ReadSchema>;
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<typeof SummarySchema>;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<typeof ReadOutput>;export const MutationOutput = Type.Object({ id: Type.String(), revision, changed: Type.Array(Type.Object({ id: Type.String(), revision })),});export type MutationResult = Static<typeof MutationOutput>;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<typeof FindOutput>;