@nocobase/app-plugin-projects 0.0.0-stage → 0.1.0-beta.1

package/dist/server/routes/schemas.js

@@ -0,0 +1,1181 @@
+import { z } from 'zod';
+import { BUSINESS_KEYS, SETTINGS_KEYS, } from '../../shared/access.js';
+import { REACTION_EMOJIS, } from '../../shared/comments.js';
+import { COLORS, PRIORITIES } from '../../shared/common.js';
+import { INTAKE_AI_MODES, INTAKE_AI_STATUSES, } from '../../shared/intake-ai.js';
+import { PLAN_OPS, PLAN_RISK_FLAGS, PLAN_STATUSES, PLAN_UNDO_OPS, } from '../../shared/plans.js';
+import { PROJECT_RESOURCE_TYPES, PROJECT_STATUSES, PROJECT_VISIBILITIES, } from '../../shared/projects.js';
+import { SUBSCRIPTION_REASONS, } from '../../shared/subscriptions.js';
+import { DEPENDENCY_TYPES, } from '../../shared/subtasks.js';
+export const DEFAULT_PAGE_SIZE = 20;
+export const MAX_PAGE_SIZE = 100;
+const MAX_PAGE_TOKEN_LENGTH = 2048;
+const id = z.string().min(1);
+/** A query value; `''` is read as absent, as the browser's forms send it. */
+const text = z
+    .string()
+    .optional()
+    .transform((value) => (value === '' ? undefined : value));
+const pageToken = z.string().min(1).max(MAX_PAGE_TOKEN_LENGTH).optional();
+const pageSize = (max = MAX_PAGE_SIZE) => z.coerce.number().int().min(1).max(max).default(DEFAULT_PAGE_SIZE);
+const boolean = z.enum(['true', 'false']).optional();
+const priority = z.enum(PRIORITIES);
+/** `YYYY-MM-DD`; the services check that it is a real date. */
+const date = z.string().nullable();
+const executor = z.strictObject({ type: id, id }).nullable();
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+// Path parameters
+export const ProjectParams = z.object({
+    projectId: id,
+});
+export const ProjectMemberParams = z.object({ projectId: id, userId: id });
+export const ProjectResourceParams = z.object({ projectId: id, resourceId: id });
+export const IssueParams = z.object({
+    issueId: id,
+});
+export const DependencyParams = z.object({ issueId: id, dependencyId: id });
+export const ChecklistItemParams = z.object({ issueId: id, statusKey: id, itemKey: id });
+export const CommentParams = z.object({
+    commentId: id,
+});
+export const LabelParams = z.object({
+    labelId: id,
+});
+export const WorkflowParams = z.object({
+    workflowId: id,
+});
+export const InvitationParams = z.object({
+    invitationId: id,
+});
+export const ApprovalParams = z.object({
+    approvalId: id,
+});
+export const PlanParams = z.object({
+    planId: id,
+});
+export const IntakeFileParams = z.object({
+    fileId: id,
+});
+export const IntakeJobParams = z.object({
+    jobId: id,
+});
+export const AttachmentParams = z.object({
+    attachmentId: id,
+});
+/** `GET /projects/mentionCandidates`: one short page of the `@` list, at most 20. */
+export const MentionCandidatesQuery = z
+    .object({
+    q: text,
+    issueId: text,
+    pageSize: z.coerce.number().int().min(1).max(20).default(8),
+})
+    .transform(({ q, issueId, pageSize: limit }) => ({
+    ...(q ? { q } : {}),
+    ...(issueId ? { issueId } : {}),
+    limit,
+}));
+export const CreateInvitationsBody = z.strictObject({
+    emails: z.array(z.string()),
+    projectIds: z.array(id).optional(),
+});
+export const UpdateSettingsBody = z.strictObject({ issuePrefix: z.string().optional() });
+// Labels and workflows
+export const CreateLabelBody = z.strictObject({
+    name: z.string(),
+    color: z.enum(COLORS).optional(),
+});
+export const UpdateLabelBody = z.strictObject({
+    name: z.string().optional(),
+    color: z.enum(COLORS).optional(),
+});
+/** The definition's structure is checked by the workflow service, which reports every problem at its path. */
+const definition = z
+    .custom(isObject, 'definition must be an object.')
+    .meta({
+    description: 'A workflow definition, shaped as `ProjectsWorkflowDefinition`: `{ states, transitions }`.',
+});
+export const CreateWorkflowBody = z.strictObject({ name: z.string(), copyFrom: id.nullable() });
+export const UpdateWorkflowBody = z.strictObject({
+    revision: z.number().int(),
+    name: z.string().optional(),
+    description: z.string().nullable().optional(),
+    definition: definition.optional(),
+});
+export const PreviewWorkflowBody = z.strictObject({ definition });
+// Projects
+const projectFields = {
+    description: z.string().nullable().optional(),
+    visibility: z.enum(PROJECT_VISIBILITIES).optional(),
+    status: z.enum(PROJECT_STATUSES).optional(),
+    priority: priority.optional(),
+    leadUserId: id.nullable().optional(),
+    startDate: date.optional(),
+    dueDate: date.optional(),
+    workflowId: id.nullable().optional(),
+};
+export const CreateProjectBody = z.strictObject({ name: z.string(), ...projectFields });
+export const UpdateProjectBody = z.strictObject({ name: z.string().optional(), ...projectFields });
+export const AddProjectMemberBody = z.strictObject({ userId: id });
+const binding = z
+    .strictObject({
+    provider: id,
+    connectionId: id,
+    repoId: id,
+    fullName: id,
+})
+    .nullable();
+export const CreateProjectResourceBody = z.strictObject({
+    type: z.enum(PROJECT_RESOURCE_TYPES),
+    url: z.string().nullable().optional(),
+    defaultRef: z.string().nullable().optional(),
+    binding: binding.optional(),
+    runnerId: z.string().nullable().optional(),
+    path: z.string().nullable().optional(),
+    label: z.string().nullable().optional(),
+    initPrompt: z.string().nullable().optional(),
+});
+export const UpdateProjectResourceBody = z.strictObject({
+    url: z.string().optional(),
+    defaultRef: z.string().nullable().optional(),
+    binding: binding.optional(),
+    runnerId: z.string().optional(),
+    path: z.string().optional(),
+    label: z.string().nullable().optional(),
+    initPrompt: z.string().nullable().optional(),
+    position: z.number().int().optional(),
+});
+// Issues
+const ORDER_FIELDS = {
+    updatedAt: 'updated',
+    createdAt: 'created',
+    number: 'number',
+    priority: 'priority',
+};
+/**
+ * `orderBy`: `updatedAt`, `createdAt`, `number` or `priority`, then optionally ` asc` or ` desc` (ascending when left
+ * out). The default is `updatedAt desc`.
+ */
+const orderBy = z
+    .string()
+    .regex(new RegExp(`^(${Object.keys(ORDER_FIELDS).join('|')})( (asc|desc))?$`, 'u'), 'orderBy must be a field (updatedAt, createdAt, number, priority) and optionally asc or desc.')
+    .optional();
+function sortOf(value) {
+    if (!value)
+        return { sort: 'updated', direction: 'desc' };
+    const [field = 'updatedAt', direction] = value.split(' ');
+    return {
+        sort: ORDER_FIELDS[field] ?? 'updated',
+        direction: direction === 'desc' ? 'desc' : 'asc',
+    };
+}
+const issueFilters = {
+    statusKey: text,
+    projectId: text,
+    ownerUserId: text,
+    executorId: text,
+    labelId: text,
+    /** An issue id, or `none` for top-level issues only. */
+    parentIssueId: text,
+    q: text,
+    deleted: boolean,
+    orderBy,
+};
+function issueQueryOf(input) {
+    const { deleted, orderBy: order, ...filters } = input;
+    return {
+        ...Object.fromEntries(Object.entries(filters).filter(([, value]) => value !== undefined)),
+        deleted: deleted === 'true',
+        ...sortOf(order),
+    };
+}
+/** `GET /projects/issues`: a cursor-paged list. */
+export const IssueListQuerySchema = z
+    .object({ ...issueFilters, pageSize: pageSize(), pageToken })
+    .transform(({ pageSize: limit, pageToken: cursor, ...filters }) => ({
+    ...issueQueryOf(filters),
+    limit,
+    ...(cursor ? { cursor } : {}),
+}));
+/** `GET /projects/issues/board`: the list's filters; `pageSize` issues per column. */
+export const IssueBoardQuery = z
+    .object({ ...issueFilters, pageSize: pageSize() })
+    .transform(({ pageSize: limit, ...filters }) => ({
+    ...issueQueryOf(filters),
+    limit,
+}));
+export const ProjectFilterQuery = z
+    .object({ projectId: text })
+    .transform(({ projectId }) => ({ projectId: projectId ?? null }));
+/** Older activities or comment threads of an issue. */
+export const CursorPageQuery = z
+    .object({ pageSize: pageSize(), pageToken })
+    .transform(({ pageSize: limit, pageToken: cursor }) => ({
+    limit,
+    ...(cursor ? { cursor } : {}),
+}));
+const issueFields = {
+    description: z.string().optional(),
+    statusKey: z.string().optional(),
+    priority: priority.optional(),
+    ownerUserId: id.optional(),
+    executor: executor.optional(),
+    parentIssueId: id.nullable().optional(),
+    stage: z.number().int().nullable().optional(),
+    projectId: id.nullable().optional(),
+    startDate: date.optional(),
+    dueDate: date.optional(),
+    labelIds: z.array(id).optional(),
+    start: z.boolean().optional(),
+};
+export const CreateIssueBody = z.strictObject({
+    title: z.string(),
+    ...issueFields,
+    blockedBy: z.array(id).optional(),
+    projectSetup: z.boolean().optional(),
+});
+export const UpdateIssueBody = z.strictObject({
+    revision: z.number().int().optional().meta({
+        description: 'The revision the change is based on; left out, the change applies to the issue as it is now.',
+    }),
+    title: z.string().optional(),
+    ...issueFields,
+});
+export const UpdateChecklistItemBody = z.strictObject({ checked: z.boolean() });
+export const AddDependencyBody = z.strictObject({
+    dependsOnIssueId: id,
+    type: z
+        .enum(DEPENDENCY_TYPES)
+        .optional(),
+});
+/** `POST /projects/issues/{issueId}/removeDependency`: the link to another issue, by that issue and the type. */
+export const RemoveDependencyBody = AddDependencyBody;
+// Comments and approvals
+export const CreateCommentBody = z.strictObject({
+    content: z.string(),
+    parentId: id.nullable().optional(),
+    attachmentIds: z.array(id).optional(),
+});
+export const UpdateCommentBody = z.strictObject({ content: z.string() });
+export const ReactionBody = z.strictObject({
+    emoji: z.enum(REACTION_EMOJIS),
+});
+export const DecideApprovalBody = z.strictObject({ comment: z.string().optional() });
+// Plans and intake
+/** A row's `params` are checked per operation by the plan engine, which reports each row's problems (`PLAN_INVALID`). */
+const planRow = z
+    .custom((value) => isObject(value) &&
+    PLAN_OPS.includes(value.op), `A row must be an object with op one of ${PLAN_OPS.join(', ')}.`)
+    .meta({
+    description: 'A row shaped as `ProjectsPlanRowInput`: `{ op, params, ref? }`, `op` one of `issue.create`, `issue.update`, `comment.create`, `dependency` and `project.create`.',
+});
+const planBody = z.strictObject({
+    title: z.string(),
+    description: z.string().optional(),
+    source: z.strictObject({
+        kind: z.string().min(1),
+        key: z.string().nullable().optional(),
+        issueId: id.nullable().optional(),
+        // Opaque JSON the proposer gets back untouched (`PlanSource.data`).
+        data: z.unknown().optional(),
+    }),
+    proposer: z
+        .strictObject({
+        agentId: id,
+        runId: id.nullable().optional(),
+        conversationId: id.nullable().optional(),
+    })
+        .nullable()
+        .optional(),
+    deciderUserId: id.optional(),
+    rows: z.array(planRow),
+});
+export const CreatePlanBody = planBody;
+export const EditPlanBody = z.strictObject({
+    revision: z.number().int(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    rows: z.array(z.strictObject({
+        id,
+        // Replaces the row's params, checked by the plan engine as on creation.
+        params: z.unknown().optional(),
+        remove: z.boolean().optional(),
+    })),
+});
+export const PlanActionBody = z.strictObject({
+    revision: z.number().int(),
+});
+export const PlanUndoBody = z.strictObject({
+    dryRun: z.boolean().optional(),
+});
+/** `GET /projects/plans`: a cursor-paged list, newest first. */
+export const PlanListQuerySchema = z
+    .object({
+    status: z.enum(['open', ...PLAN_STATUSES]).optional(),
+    sourceKind: text,
+    sourceKey: text,
+    issueId: text,
+    pageSize: pageSize(50),
+    pageToken,
+})
+    .transform(({ pageSize: limit, pageToken: cursor, ...filters }) => ({
+    ...Object.fromEntries(Object.entries(filters).filter(([, value]) => value !== undefined)),
+    limit,
+    ...(cursor ? { cursor } : {}),
+}));
+export const IntakeSplitBody = z.strictObject({
+    text: z.string().optional(),
+    fileIds: z.array(id).optional(),
+    projectId: id.nullable().optional(),
+});
+export const IntakeTextsBody = z.strictObject({
+    fileIds: z.array(id),
+});
+export const IntakeAiStartBody = z.strictObject({
+    mode: z.enum(INTAKE_AI_MODES),
+    text: z.string().optional(),
+    fileIds: z.array(id).optional(),
+    projectId: id.nullable().optional(),
+    planId: id.nullable().optional(),
+    instruction: z.string().optional(),
+    issueId: id.optional(),
+});
+export const IssueAttachmentsQuery = z.object({
+    comments: z.enum(['true', 'false']).optional().meta({
+        description: 'Whether the issue’s comments’ files follow its own.',
+    }),
+});
+export const AttachmentContentQuery = z
+    .object({ download: boolean })
+    .transform(({ download }) => ({ download: download === 'true' }));
+// ---------------------------------------------------------------------------------------------------------------------
+// Responses: what the handlers answer, annotated with the services' view types so the document cannot drift from them.
+// ---------------------------------------------------------------------------------------------------------------------
+const dateTime = z.string().meta({ format: 'date-time' });
+/** `YYYY-MM-DD`. */
+const day = z.string().meta({ format: 'date' });
+const statusCategory = z.enum(['unstarted', 'started', 'done', 'closed']);
+const color = z.enum(COLORS);
+const record = z.record(z.string(), z.unknown());
+const i18nKey = z.object({ key: z.string(), ns: z.string() });
+const UserRefSchema = z
+    .object({ id: z.string(), name: z.string() })
+    .meta({ ref: 'ProjectsUserRef' });
+export const StatusDefinitionSchema = z
+    .object({
+    key: z.string(),
+    name: z.string(),
+    category: statusCategory,
+    color,
+})
+    .meta({ ref: 'ProjectsStatusDefinition' });
+const ExecutorSchema = z
+    .object({
+    type: z.string().meta({ description: 'A kind’s key, such as `user`.' }),
+    id: z.string(),
+})
+    .meta({ ref: 'ProjectsExecutor' });
+export const LabelSchema = z
+    .object({ id: z.string(), name: z.string(), color })
+    .meta({ ref: 'ProjectsLabel' });
+// Members
+const scope = z.union([
+    z.literal('all'),
+    z.literal('none'),
+    z.object({ users: z.array(z.string()) }),
+]);
+const PermissionsSchema = z
+    .object({
+    scopes: z.record(z.enum(BUSINESS_KEYS.map(({ key }) => key)), scope),
+    settings: z.record(z.enum(SETTINGS_KEYS.map(({ key }) => key)), z.boolean()),
+})
+    .meta({
+    ref: 'ProjectsPermissions',
+    description: 'Each business action’s reach (`all`, `none` or the records related to `users`) and each settings capability.',
+});
+export const MeSchema = z.object({
+    userId: z.string(),
+    name: z.string(),
+    permissions: PermissionsSchema,
+    kinds: z.array(z.object({
+        key: z.string(),
+        title: z.union([z.string(), i18nKey]).nullable(),
+        executor: z.boolean(),
+        mentionable: z.boolean(),
+    })),
+});
+export const MemberSchema = z.object({
+    userId: z.string(),
+    name: z.string(),
+    email: z.string().nullable(),
+});
+export const ApiKeyActorSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    disabled: z.boolean(),
+});
+const NameTextSchema = z.object({ key: z.string(), ns: z.string() });
+export const ExecutorCandidateSchema = z.object({
+    type: z.string(),
+    id: z.string(),
+    name: z.string(),
+    nameText: NameTextSchema.optional(),
+    online: z.boolean().optional(),
+    busy: z.number().int().optional(),
+});
+export const MentionCandidateSchema = z.object({
+    kind: z.string(),
+    id: z.string(),
+    name: z.string(),
+    nameText: NameTextSchema.optional(),
+    hint: z.string().optional(),
+});
+/** `{ total }`: a bounded list, answered whole. */
+export const BoundedListMeta = z
+    .object({ total: z.number().int() })
+    .meta({ ref: 'ProjectsBoundedListMeta' });
+/** `{ nextPageToken? }`: absent on the last page. */
+export const CursorListMeta = z
+    .object({ nextPageToken: z.string().optional() })
+    .meta({ ref: 'ProjectsCursorListMeta' });
+/** An empty `meta`: the `@` list is one short page. */
+export const EmptyListMeta = z.object({});
+// Invitations and settings
+export const InvitationSchema = z.object({
+    id: z.string(),
+    email: z.string(),
+    status: z.enum(['pending', 'expired', 'accepted', 'revoked']),
+    projects: z.array(z.object({ id: z.string(), name: z.string() })),
+    invitedBy: z.object({ userId: z.string(), name: z.string() }),
+    expiresAt: dateTime,
+    sentAt: dateTime.nullable(),
+    createdAt: dateTime,
+});
+export const InvitationResultSchema = z
+    .object({
+    email: z.string(),
+    outcome: z.enum(['invited', 'added', 'alreadyMember']),
+    emailSent: z.boolean().optional(),
+    inviteUrl: z.string().optional().meta({
+        description: 'When sending failed, the link, once, for the inviter to forward.',
+    }),
+})
+    .meta({ ref: 'ProjectsInvitationResult' });
+export const InvitationResultsSchema = z.object({ results: z.array(InvitationResultSchema) });
+export const WorkspaceSettingsSchema = z.object({
+    issuePrefix: z.string(),
+});
+// Workflows
+const ruleMessage = z
+    .union([
+    z.string(),
+    z.object({
+        key: z.string(),
+        ns: z.string().optional(),
+        defaultValue: z.string().optional(),
+    }),
+])
+    .meta({
+    ref: 'ProjectsRuleMessage',
+    description: 'Plain text, or an i18n key with its namespace and default.',
+});
+const statusRule = z
+    .object({
+    type: z.string(),
+    config: record.optional(),
+})
+    .meta({
+    ref: 'ProjectsWorkflowStatusRule',
+    description: 'What entering a status does. Built in: `checklist` (`config.items`: `{ key, label, required }[]`), `notifyOwner` (`config.message`), `subtasksDone`, `blockersDone` and `startOption` (`config.label`, `config.hint`); other plugins contribute their own types.',
+});
+const WorkflowDefinitionSchema = z
+    .object({
+    states: z.array(z.object({
+        key: z.string(),
+        name: z.string(),
+        category: statusCategory,
+        color,
+        builtIn: z.boolean().optional(),
+        rules: z.array(statusRule).optional(),
+    })),
+    transitions: z.array(z.object({
+        from: z.string().meta({ description: 'A status key, or `*`.' }),
+        to: z.string().meta({ description: 'A status key, or `*`.' }),
+        actors: z.array(z.string()),
+        approval: z
+            .object({
+            approvers: z.array(z.enum(['owner', 'projectLead', 'admin'])),
+        })
+            .optional(),
+        on: z.string().optional().meta({
+            description: 'An event the system takes the transition on, such as `subtasks.done`.',
+        }),
+    })),
+})
+    .meta({ ref: 'ProjectsWorkflowDefinition' });
+export const WorkflowSchema = z
+    .object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().nullable(),
+    isDefault: z.boolean(),
+    builtInKey: z.string().nullable(),
+    definition: WorkflowDefinitionSchema,
+    revision: z.number().int(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    projectCount: z.number().int(),
+    title: i18nKey.optional(),
+    descriptionTitle: i18nKey.optional(),
+})
+    .meta({ ref: 'ProjectsWorkflow' });
+export const WorkflowPreviewSchema = z.object({
+    rules: z.array(z.object({
+        statusKey: z.string(),
+        change: z.enum(['added', 'removed']),
+        rule: statusRule,
+        available: z.boolean(),
+        summary: z.string().nullable(),
+        attention: z.boolean(),
+    })),
+    attention: z.array(z.object({
+        statusKey: z.string(),
+        rule: statusRule,
+        summary: z.string(),
+        isNew: z.boolean(),
+    })),
+});
+// Approvals and checklists
+export const ApprovalRequestSchema = z
+    .object({
+    id: z.string(),
+    issueId: z.string(),
+    issueIdentifier: z.string().nullable(),
+    issueTitle: z.string().nullable(),
+    fromStatus: z.string(),
+    toStatus: z.string(),
+    requestedByType: z.string(),
+    requestedById: z.string(),
+    requestedByName: z.string().nullable(),
+    approvers: z.array(z.enum(['owner', 'projectLead', 'admin'])),
+    approverUserIds: z.array(z.string()),
+    approverNames: z.array(z.string()),
+    status: z.enum(['pending', 'approved', 'rejected', 'withdrawn', 'stale']),
+    decidedById: z.string().nullable(),
+    decidedByName: z.string().nullable(),
+    decidedAt: dateTime.nullable(),
+    comment: z.string().nullable(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+})
+    .meta({ ref: 'ProjectsApprovalRequest' });
+export const IssueChecklistSchema = z
+    .object({
+    statusKey: z.string(),
+    current: z.boolean(),
+    complete: z.boolean(),
+    items: z.array(z.object({
+        itemKey: z.string(),
+        label: z.string(),
+        required: z.boolean(),
+        checked: z.boolean(),
+        checkedByType: z.string().nullable(),
+        checkedById: z.string().nullable(),
+        checkedByName: z.string().nullable(),
+        checkedAt: dateTime.nullable(),
+    })),
+})
+    .meta({ ref: 'ProjectsIssueChecklist' });
+// Attachments and comments
+export const AttachmentSchema = z
+    .object({
+    id: z.string(),
+    filename: z.string(),
+    ext: z.string(),
+    mimeType: z.string(),
+    size: z.number().int(),
+    issueId: z.string().nullable(),
+    commentId: z.string().nullable(),
+    uploader: z.object({
+        type: z.string(),
+        id: z.string(),
+        name: z.string().nullable(),
+    }),
+    createdAt: dateTime,
+    contentUrl: z.string().meta({
+        description: 'The content route: a safe image inline, anything else as a download.',
+    }),
+    downloadUrl: z.string(),
+    previewable: z.boolean(),
+    canDelete: z.boolean(),
+})
+    .meta({ ref: 'ProjectsAttachment' });
+const CommentReactionSchema = z
+    .object({
+    emoji: z.enum(REACTION_EMOJIS),
+    count: z.number().int(),
+    userIds: z.array(z.string()),
+})
+    .meta({ ref: 'ProjectsCommentReaction' });
+const MentionRefSchema = z.object({
+    kind: z.string(),
+    id: z.string(),
+});
+export const IssueCommentSchema = z
+    .object({
+    id: z.string(),
+    issueId: z.string(),
+    authorType: z.string(),
+    authorId: z.string().nullable(),
+    authorName: z.string().nullable(),
+    kind: z.string(),
+    content: z.string().meta({ description: 'Markdown; empty once deleted.' }),
+    note: z.boolean(),
+    parentId: z.string().nullable(),
+    rootId: z.string(),
+    via: z.enum(['cli', 'api_key', 'agent']).nullable(),
+    createdAt: dateTime,
+    editedAt: dateTime.nullable(),
+    deleted: z.boolean(),
+    reactions: z.array(CommentReactionSchema),
+    resolvedAt: dateTime.nullable(),
+    resolvedById: z.string().nullable(),
+    resolvedByName: z.string().nullable(),
+    attachments: z.array(AttachmentSchema),
+})
+    .meta({ ref: 'ProjectsIssueComment' });
+export const CommentThreadSchema = z
+    .object({
+    root: IssueCommentSchema,
+    replies: z.array(IssueCommentSchema),
+})
+    .meta({ ref: 'ProjectsCommentThread' });
+export const CreateCommentResultSchema = z.object({
+    comment: IssueCommentSchema,
+    triggered: z.array(MentionRefSchema).meta({
+        description: 'Whom the comment started work for; empty without a plugin that does.',
+    }),
+});
+export const CommentReactionsSchema = z.object({
+    reactions: z.array(CommentReactionSchema),
+});
+export const ThreadResolutionSchema = z.object({
+    commentId: z.string(),
+    resolvedAt: dateTime.nullable(),
+    resolvedById: z.string().nullable(),
+});
+export const SubscriptionStateSchema = z.object({
+    subscribed: z.boolean(),
+});
+// Issues
+const ActivityViaSchema = z
+    .object({
+    type: z.enum(['cli', 'api_key', 'agent', 'plan']),
+    agentId: z.string().optional(),
+    agentName: z.string().nullable().optional(),
+    runId: z.string().optional(),
+    conversationId: z.string().optional(),
+    planId: z.string().optional(),
+})
+    .meta({ ref: 'ProjectsActivityVia' });
+export const ActivitySchema = z
+    .object({
+    id: z.string(),
+    actorType: z.string(),
+    actorId: z.string().nullable(),
+    actorName: z.string().nullable(),
+    action: z.string(),
+    details: record,
+    via: ActivityViaSchema.nullable(),
+    createdAt: dateTime,
+})
+    .meta({ ref: 'ProjectsActivity' });
+const issueShape = {
+    id: z.string(),
+    number: z.number().int(),
+    identifier: z
+        .string()
+        .meta({ description: '`PREFIX-number`, such as `PM-12`.' }),
+    title: z.string(),
+    description: z.string().meta({ description: 'Markdown.' }),
+    statusKey: z.string(),
+    priority: z.enum(PRIORITIES),
+    ownerUserId: z.string(),
+    executor: ExecutorSchema.nullable(),
+    parentIssueId: z.string().nullable(),
+    stage: z.number().int().nullable(),
+    projectId: z.string().nullable(),
+    startDate: day.nullable(),
+    dueDate: day.nullable(),
+    revision: z.number().int().meta({
+        description: 'Increases with every change; a write names the revision it read.',
+    }),
+    createdById: z.string().nullable(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    lastActivityAt: dateTime,
+    deletedAt: dateTime.nullable(),
+};
+export const IssueSchema = z
+    .object(issueShape)
+    .meta({ ref: 'ProjectsIssue' });
+const issueListItemShape = {
+    ...issueShape,
+    owner: UserRefSchema.nullable(),
+    executorName: z.string().nullable(),
+    project: z
+        .object({
+        id: z.string(),
+        name: z.string(),
+        leadUserId: z.string().nullable(),
+    })
+        .nullable(),
+    labels: z.array(LabelSchema),
+    subtaskCount: z.number().int(),
+    blockedCount: z.number().int(),
+};
+export const IssueListItemSchema = z
+    .object(issueListItemShape)
+    .meta({ ref: 'ProjectsIssueListItem' });
+export const IssueDependencySchema = z
+    .object({
+    dependencyId: z.string(),
+    issueId: z.string(),
+    identifier: z.string(),
+    title: z.string(),
+    status: StatusDefinitionSchema,
+    type: z.enum(['blockedBy', 'relatedTo']),
+})
+    .meta({ ref: 'ProjectsIssueDependency' });
+export const IssueDetailSchema = z.object({
+    ...issueListItemShape,
+    parent: z
+        .object({ id: z.string(), identifier: z.string(), title: z.string() })
+        .nullable(),
+    statuses: z.array(StatusDefinitionSchema),
+    activities: z.array(ActivitySchema),
+    activitiesNextCursor: z.string().nullable(),
+    threads: z.array(CommentThreadSchema),
+    threadsNextCursor: z.string().nullable(),
+    subscribers: z.array(z.object({
+        userId: z.string(),
+        name: z.string(),
+        reason: z.enum(SUBSCRIPTION_REASONS),
+    })),
+    attachments: z.array(AttachmentSchema),
+    checklist: IssueChecklistSchema.nullable(),
+    pendingApproval: ApprovalRequestSchema.nullable(),
+    recentApprovals: z.array(ApprovalRequestSchema),
+    subtasks: z.array(z.object({
+        id: z.string(),
+        identifier: z.string(),
+        title: z.string(),
+        status: StatusDefinitionSchema,
+        stage: z.number().int().nullable(),
+        executor: ExecutorSchema.nullable(),
+        executorName: z.string().nullable(),
+        blockedCount: z.number().int(),
+        terminal: z.boolean(),
+    })),
+    blockedBy: z.array(IssueDependencySchema),
+    blocks: z.array(IssueDependencySchema),
+    relatedTo: z.array(IssueDependencySchema),
+    blockers: z.array(z.object({
+        issueId: z.string(),
+        identifier: z.string(),
+        title: z.string(),
+        status: StatusDefinitionSchema,
+        reason: z.enum(['dependency', 'stage']),
+    })),
+    hiddenBlockerCount: z.number().int(),
+});
+export const UpdateIssueResultSchema = z.object({
+    issue: IssueSchema,
+    pendingApproval: ApprovalRequestSchema.nullable().meta({
+        description: 'With 202: the request holding the status change for approval; the issue is unchanged.',
+    }),
+});
+export const IssueBoardSchema = z.object({
+    columns: z.array(z.object({
+        status: StatusDefinitionSchema,
+        issues: z.array(IssueListItemSchema),
+        nextCursor: z.string().nullable().meta({
+            description: 'The `pageToken` of the column’s next page.',
+        }),
+    })),
+});
+export const IssueStartsSchema = z.object({
+    initialStatus: z.string(),
+    options: z.array(z.object({
+        status: StatusDefinitionSchema,
+        label: ruleMessage.nullable(),
+        hint: ruleMessage.nullable(),
+    })),
+});
+// Projects
+const projectShape = {
+    id: z.string(),
+    name: z.string(),
+    description: z.string().nullable(),
+    visibility: z.enum(PROJECT_VISIBILITIES),
+    status: z.enum(PROJECT_STATUSES),
+    priority: z.enum(PRIORITIES),
+    leadUserId: z.string().nullable(),
+    startDate: day.nullable(),
+    dueDate: day.nullable(),
+    workflowId: z.string().nullable(),
+    setupIssueId: z.string().nullable(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    lead: UserRefSchema.nullable(),
+    memberCount: z.number().int(),
+    issueCounts: z.object({
+        total: z.number().int(),
+        done: z.number().int(),
+        byStatus: z.record(z.string(), z.number().int()),
+    }),
+};
+export const ProjectListItemSchema = z
+    .object(projectShape)
+    .meta({ ref: 'ProjectsProjectListItem' });
+export const ProjectResourceSchema = z
+    .object({
+    id: z.string(),
+    projectId: z.string(),
+    type: z.enum(PROJECT_RESOURCE_TYPES),
+    url: z.string().nullable(),
+    defaultRef: z.string().nullable(),
+    binding: z
+        .object({
+        provider: z.string(),
+        connectionId: z.string(),
+        repoId: z.string(),
+        fullName: z.string(),
+    })
+        .nullable(),
+    runnerId: z.string().nullable(),
+    path: z.string().nullable(),
+    label: z.string().nullable(),
+    initPrompt: z.string().nullable(),
+    position: z.number().int(),
+})
+    .meta({ ref: 'ProjectsProjectResource' });
+export const ProjectDetailSchema = z
+    .object({
+    ...projectShape,
+    members: z.array(UserRefSchema),
+    resources: z.array(ProjectResourceSchema),
+})
+    .meta({ ref: 'ProjectsProjectDetail' });
+export const ProjectMemberSchema = UserRefSchema.nullable();
+// Plans
+const issueTarget = z.union([z.string(), z.object({ ref: z.string() })]).meta({
+    ref: 'ProjectsPlanIssueTarget',
+    description: 'An issue id or identifier, or `{ ref }`: the issue an earlier row created.',
+});
+const projectTarget = z
+    .union([z.string(), z.object({ ref: z.string() })])
+    .meta({
+    ref: 'ProjectsPlanProjectTarget',
+    description: 'A project id, or `{ ref }`: the project an earlier row created.',
+});
+const issueFieldChanges = {
+    description: z.string().optional(),
+    statusKey: z.string().optional(),
+    priority: priority.optional(),
+    ownerUserId: z.string().optional(),
+    executor: ExecutorSchema.nullable().optional(),
+    parentIssueId: issueTarget.nullable().optional(),
+    stage: z.number().int().nullable().optional(),
+    projectId: projectTarget.nullable().optional(),
+    startDate: z.string().nullable().optional(),
+    dueDate: z.string().nullable().optional(),
+    labelIds: z.array(z.string()).optional(),
+};
+const PlanRowInputSchema = z
+    .discriminatedUnion('op', [
+    z.object({
+        op: z.literal('issue.create'),
+        ref: z.string().optional(),
+        params: z.object({
+            title: z.string(),
+            ...issueFieldChanges,
+            blockedBy: z.array(issueTarget).optional(),
+            start: z.boolean().optional(),
+        }),
+    }),
+    z.object({
+        op: z.literal('issue.update'),
+        ref: z.string().optional(),
+        params: z.object({
+            issue: issueTarget,
+            set: z.object({ title: z.string().optional(), ...issueFieldChanges }),
+            start: z.boolean().optional(),
+        }),
+    }),
+    z.object({
+        op: z.literal('comment.create'),
+        ref: z.string().optional(),
+        params: z.object({
+            issue: issueTarget,
+            content: z.string(),
+            parentId: z.string().nullable().optional(),
+            attachmentIds: z.array(z.string()).optional(),
+        }),
+    }),
+    z.object({
+        op: z.literal('dependency'),
+        ref: z.string().optional(),
+        params: z.object({
+            action: z.enum(['add', 'remove']),
+            issue: issueTarget,
+            dependsOn: issueTarget,
+            type: z.enum(['blockedBy', 'relatedTo']).optional(),
+        }),
+    }),
+    z.object({
+        op: z.literal('project.create'),
+        ref: z.string().optional(),
+        params: z.object({
+            name: z.string(),
+            description: z.string().nullable().optional(),
+            visibility: z.enum(PROJECT_VISIBILITIES).optional(),
+            priority: priority.optional(),
+            leadUserId: z.string().nullable().optional(),
+            startDate: z.string().nullable().optional(),
+            dueDate: z.string().nullable().optional(),
+            workflowId: z.string().nullable().optional(),
+        }),
+    }),
+])
+    .meta({ ref: 'ProjectsPlanRowInput' });
+const planSource = z.object({
+    kind: z.string(),
+    key: z.string().nullable().optional(),
+    issueId: z.string().nullable().optional(),
+    data: z.unknown().optional().meta({
+        description: 'Opaque JSON the proposer gets back untouched.',
+    }),
+});
+const planProposer = z.object({
+    agentId: z.string(),
+    runId: z.string().nullable().optional(),
+    conversationId: z.string().nullable().optional(),
+});
+const CreatePlanRequestSchema = z
+    .object({
+    title: z.string(),
+    description: z.string().optional(),
+    source: planSource,
+    proposer: planProposer.nullable().optional(),
+    deciderUserId: z.string().optional(),
+    rows: z.array(PlanRowInputSchema),
+})
+    .meta({ ref: 'ProjectsCreatePlanRequest' });
+const PlanObjectRefSchema = z
+    .object({
+    type: z.enum(['issue', 'project', 'comment', 'dependency']),
+    id: z.string().nullable(),
+    identifier: z.string().nullable().optional(),
+    title: z.string().nullable().optional(),
+})
+    .meta({ ref: 'ProjectsPlanObjectRef' });
+const PlanWakeSchema = z
+    .object({
+    kind: z.string(),
+    principalId: z.string(),
+    name: z.string().nullable(),
+    subjectId: z.string(),
+    triggerType: z.string(),
+    started: z.boolean(),
+    skipped: z.string().optional(),
+    runId: z.string().optional(),
+})
+    .meta({ ref: 'ProjectsPlanWake' });
+const PlanRowCheckSchema = z
+    .object({
+    ok: z.boolean(),
+    error: z
+        .object({
+        code: z.string(),
+        message: z.string(),
+        details: record.optional(),
+    })
+        .nullable(),
+    target: PlanObjectRefSchema.nullable(),
+    wakes: z.array(PlanWakeSchema),
+    flags: z.array(z.enum(PLAN_RISK_FLAGS)),
+    baseline: z
+        .object({ target: PlanObjectRefSchema, fields: record })
+        .nullable(),
+})
+    .meta({ ref: 'ProjectsPlanRowCheck' });
+export const PlanRehearsalSchema = z
+    .object({ ok: z.boolean(), rows: z.array(PlanRowCheckSchema) })
+    .meta({ ref: 'ProjectsPlanRehearsal' });
+const planRowOp = z.enum([...PLAN_OPS, ...PLAN_UNDO_OPS]);
+const planUndoSkip = z.object({
+    rowId: z.string(),
+    position: z.number().int(),
+    reason: z.enum(['changed', 'gone', 'notReversible']),
+    message: z.string(),
+});
+export const PlanSchema = z
+    .object({
+    id: z.string(),
+    title: z.string(),
+    description: z.string(),
+    status: z.enum(PLAN_STATUSES),
+    voidReason: z.enum(['person', 'superseded']).nullable(),
+    source: planSource,
+    proposer: planProposer.nullable(),
+    proposerName: z.string().nullable(),
+    deciderUserId: z.string(),
+    deciderName: z.string().nullable(),
+    createdBy: z.object({ type: z.string(), id: z.string().nullable() }),
+    revision: z.number().int(),
+    rows: z.array(z.object({
+        id: z.string(),
+        position: z.number().int(),
+        op: planRowOp,
+        ref: z.string().nullable(),
+        params: z.unknown().meta({
+            description: 'The operation’s parameters, as the proposer wrote them.',
+        }),
+        check: PlanRowCheckSchema.nullable(),
+        result: z
+            .object({
+            target: PlanObjectRefSchema.nullable(),
+            created: PlanObjectRefSchema.nullable(),
+            after: record.nullable(),
+            revision: z.number().int().nullable(),
+            wakes: z.array(PlanWakeSchema),
+        })
+            .nullable(),
+    })),
+    failure: z
+        .object({
+        code: z.string(),
+        message: z.string(),
+        rowId: z.string().nullable(),
+        details: record.optional(),
+    })
+        .nullable(),
+    expiresAt: dateTime,
+    rehearsedAt: dateTime,
+    executedAt: dateTime.nullable(),
+    executedById: z.string().nullable(),
+    undoableUntil: dateTime.nullable(),
+    skipped: z.array(planUndoSkip),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+})
+    .meta({ ref: 'ProjectsPlan' });
+export const PlanUndoPreviewSchema = z.object({
+    planId: z.string(),
+    revert: z.array(z.object({
+        rowId: z.string(),
+        position: z.number().int(),
+        op: planRowOp,
+        target: PlanObjectRefSchema.nullable(),
+        restore: record.nullable(),
+    })),
+    skipped: z.array(planUndoSkip),
+});
+export const PlanUndoResultSchema = z
+    .union([PlanSchema, PlanUndoPreviewSchema])
+    .meta({
+    description: 'With `dryRun: true`, what undoing would do (`planId`, `revert`, `skipped`); otherwise the plan, undone.',
+});
+// Intake
+export const IntakeFileSchema = z.object({
+    id: z.string(),
+    filename: z.string(),
+    ext: z.string(),
+    mimeType: z.string(),
+    size: z.number().int(),
+    createdAt: dateTime,
+});
+const intakeFileRead = z.object({
+    fileId: z.string(),
+    filename: z.string(),
+    state: z.enum([
+        'read',
+        'truncated',
+        'empty',
+        'image',
+        'unsupported',
+        'legacy',
+        'failed',
+        'skipped',
+    ]),
+    chars: z.number().int(),
+});
+export const IntakeSplitResultSchema = z.object({
+    plan: PlanSchema.nullable().meta({
+        description: 'The stored draft plan; null when a row failed its rehearsal (see `rehearsal`).',
+    }),
+    request: CreatePlanRequestSchema,
+    rehearsal: PlanRehearsalSchema.nullable(),
+    files: z.array(intakeFileRead),
+    unknownLabels: z.array(z.string()),
+    dropped: z.number().int(),
+});
+export const IntakeTextsResultSchema = z.object({
+    documents: z.array(z.object({ fileId: z.string(), filename: z.string(), text: z.string() })),
+    files: z.array(intakeFileRead),
+});
+export const IntakeAiAvailabilitySchema = z.object({
+    available: z.boolean(),
+    reason: z.string().nullable(),
+    by: z.string().nullable(),
+    waits: z.boolean(),
+});
+export const IntakeAiJobSchema = z
+    .object({
+    id: z.string(),
+    mode: z.enum(INTAKE_AI_MODES),
+    status: z.enum(INTAKE_AI_STATUSES),
+    instruction: z.string().nullable(),
+    basePlanId: z.string().nullable(),
+    issue: z
+        .object({ id: z.string(), identifier: z.string(), title: z.string() })
+        .nullable(),
+    planId: z.string().nullable(),
+    changes: z
+        .object({
+        rows: z.record(z.string(), z.enum(['added', 'changed'])),
+        removed: z.array(z.string()),
+    })
+        .nullable(),
+    unknownLabels: z.array(z.string()),
+    dropped: z.number().int(),
+    error: z.object({ code: z.string(), message: z.string() }).nullable(),
+    progress: z
+        .object({
+        phase: z.enum(['queued', 'working']),
+        by: z.string().nullable(),
+        waitReason: z.string().nullable(),
+        activity: z.string().nullable(),
+        since: dateTime.nullable(),
+    })
+        .nullable(),
+    createdAt: dateTime,
+    finishedAt: dateTime.nullable(),
+})
+    .meta({ ref: 'ProjectsIntakeAiJob' });
+/** A multipart body holding one `file`; validated by the handler, documented here. */
+export const singleFileBody = {
+    required: true,
+    content: {
+        'multipart/form-data': {
+            schema: {
+                type: 'object',
+                required: ['file'],
+                properties: {
+                    file: { type: 'string', format: 'binary' },
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=schemas.js.map