@peasant-labs/schema 0.1.0-rc6

package/dist/internal/generated/contract/zod.gen.js

@@ -0,0 +1,1196 @@
+// This file is auto-generated by @hey-api/openapi-ts
+import * as z from 'zod';
+export const zActivityEdge = z.object({
+    from: z.string(),
+    taskCount: z.int(),
+    to: z.string()
+});
+/**
+ * Annotation Axis
+ *
+ * Subscription dimension for annotation channels
+ */
+export const zAnnotationAxis = z.enum([
+    'type',
+    'session',
+    'project'
+]);
+/**
+ * Annotation Datatype
+ *
+ * Storage type for annotation values (maps to SQLite STRICT column type)
+ */
+export const zAnnotationDatatype = z.enum([
+    'text',
+    'integer',
+    'real',
+    'boolean'
+]);
+export const zAnnotationEntryTarget = z.object({
+    endIndex: z.int(),
+    entryIndex: z.int(),
+    sessionId: z.string()
+});
+export const zAnnotationManifestResponse = z.object({
+    digest: z.string(),
+    hashes: z.array(z.string())
+});
+/**
+ * Annotation Push Status
+ *
+ * Per-item annotation push outcome
+ */
+export const zAnnotationPushStatus = z.enum([
+    'created',
+    'updated',
+    'skipped',
+    'error'
+]);
+export const zAnnotationPushResult = z.object({
+    contentHash: z.string().optional(),
+    error: z.string().optional(),
+    status: zAnnotationPushStatus
+});
+export const zAnnotationPushResponse = z.object({
+    created: z.int(),
+    errors: z.int(),
+    results: z.array(zAnnotationPushResult).optional(),
+    skipped: z.int(),
+    updated: z.int()
+});
+/**
+ * Annotation Status
+ *
+ * ISO 11179 lifecycle state of an annotation type
+ */
+export const zAnnotationStatus = z.enum([
+    'proposed',
+    'active',
+    'deprecated',
+    'retired'
+]);
+/**
+ * Annotator Kind
+ *
+ * Type of entity that produced an annotation: human, agent (AI model), or rule (automated classifier)
+ */
+export const zAnnotatorKind = z.enum([
+    'human',
+    'agent',
+    'rule'
+]);
+export const zAnnotatorSummary = z.object({
+    description: z.string().optional(),
+    displayName: z.string(),
+    id: z.string(),
+    kind: zAnnotatorKind,
+    modelId: z.string().nullish(),
+    name: z.string(),
+    providerKey: z.string().nullish(),
+    status: z.string()
+});
+export const zBatchCreateAnnotationsErrorResponse = z.object({
+    error: z.string(),
+    failingIndex: z.int()
+});
+export const zBatchCreateAnnotationsResponse = z.object({
+    ids: z.array(z.string()).nullable()
+});
+/**
+ * Built-in Command
+ *
+ * Claude Code built-in slash command name without the leading slash
+ */
+export const zBuiltinCommand = z.enum([
+    'exit',
+    'compact',
+    'clear',
+    'new',
+    'model',
+    'usage',
+    'cost',
+    'context',
+    'plugin',
+    'permissions',
+    'login',
+    'resume',
+    'plan',
+    'fast',
+    'voice',
+    'todos',
+    'reload-plugins',
+    'sandbox',
+    'config',
+    'statusline',
+    'upgrade',
+    'extra-usage',
+    'rate-limit-options',
+    'privacy-settings',
+    'help',
+    'commands'
+]);
+export const zCLILoginQuery = z.object({
+    port: z.int(),
+    state: z.string()
+});
+/**
+ * Change Binding
+ *
+ * Strength of the evidence connecting a recorded session to a code change
+ */
+export const zChangeBinding = z.enum(['bound', 'candidate']);
+export const zChangeSummary = z.object({
+    aheadCount: z.int(),
+    baseHash: z.string().optional(),
+    behindCount: z.int(),
+    branch: z.string(),
+    filesChanged: z.int(),
+    lastWorkMs: z.int().nullish(),
+    mergeCommitHash: z.string().optional(),
+    merged: z.boolean(),
+    mergedAtMs: z.int().nullish(),
+    newEdges: z.int(),
+    removedEdges: z.int(),
+    reverted: z.boolean().optional(),
+    sessionCount: z.int(),
+    taskCount: z.int(),
+    tipCommitMs: z.int().nullish(),
+    violations: z.int()
+});
+/**
+ * Channel Topic
+ *
+ * Subscribable WebSocket data stream
+ */
+export const zChannelTopic = z.enum([
+    'dashboard',
+    'sessions',
+    'session_detail',
+    'trends',
+    'quality',
+    'annotations',
+    'project_familiarity'
+]);
+export const zChannelSubscription = z.object({
+    axis: zAnnotationAxis.optional(),
+    id: z.string().optional(),
+    topic: zChannelTopic
+});
+export const zChildSessionRef = z.object({
+    id: z.string(),
+    project: z.string().optional(),
+    startTime: z.iso.datetime()
+});
+export const zCommitInfo = z.object({
+    authorEmail: z.string(),
+    authorName: z.string(),
+    authorTime: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    commitTime: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    hash: z.string(),
+    message: z.string()
+});
+/**
+ * Content Kind
+ *
+ * Payload kind carried by a transcript content envelope
+ */
+export const zContentKind = z.enum(['session_detail']);
+export const zContractVersion = z.string().nullable();
+export const zCreateAnnotationRequest = z.object({
+    annotatorName: z.string().optional(),
+    confidence: z.number().nullish(),
+    isPrimary: z.boolean(),
+    reason: z.string().nullish(),
+    sessionId: z.string(),
+    targetAnnotationId: z.string().nullish(),
+    targetEntryEndIndex: z.int().nullish(),
+    targetEntryIndex: z.int().nullish(),
+    typeId: z.string(),
+    value: z.string()
+});
+export const zBatchCreateAnnotationsRequest = z.object({
+    annotations: z.array(zCreateAnnotationRequest).nullable()
+});
+export const zCreateAnnotationResponse = z.object({
+    id: z.string()
+});
+export const zDashboardPayload = z.object({
+    acceptanceRate: z.number(),
+    avgDurationMins: z.number(),
+    avgTurnsPerSession: z.number(),
+    harnessBreakdown: z.record(z.string(), z.int()).nullable(),
+    totalSessions: z.int(),
+    totalTokens: z.int()
+});
+export const zDayStats = z.object({
+    date: z.string(),
+    sessions: z.int(),
+    tokens: z.int()
+});
+/**
+ * Decay Level
+ *
+ * Recency band for project file familiarity
+ */
+export const zDecayLevel = z.enum([
+    'fresh',
+    'fading',
+    'stale',
+    'unexplored'
+]);
+export const zDiagnosticEntry = z.object({
+    errorType: z.string(),
+    location: z.string(),
+    message: z.string(),
+    remediation: z.string()
+});
+export const zDiagnosticsInfo = z.object({
+    partial: z.boolean().nullish(),
+    warnings: z.array(zDiagnosticEntry).nullable()
+});
+/**
+ * Diff Line Kind
+ *
+ * Unified-diff line kind: context, addition, or deletion
+ */
+export const zDiffLineKind = z.enum([
+    'context',
+    'add',
+    'del'
+]);
+export const zDiffLine = z.object({
+    kind: zDiffLineKind,
+    text: z.string()
+});
+export const zDiffHunk = z.object({
+    header: z.string().optional(),
+    lines: z.array(zDiffLine).nullable(),
+    newLines: z.int(),
+    newStart: z.int(),
+    oldLines: z.int(),
+    oldStart: z.int(),
+    sessionId: z.string().optional(),
+    sessionTitle: z.string().optional()
+});
+/**
+ * Edge Violation Kind
+ *
+ * Structural violation detected on a map edge
+ */
+export const zEdgeViolationKind = z.enum(['cycle', 'wrong_way']);
+export const zEdgeViolation = z.object({
+    from: z.string(),
+    kind: zEdgeViolationKind,
+    to: z.string()
+});
+/**
+ * Entry Type
+ *
+ * Classification of a single entry within an agent session transcript
+ */
+export const zEntryType = z.enum([
+    'text',
+    'tool_use',
+    'tool_result',
+    'thinking',
+    'system',
+    'error',
+    'result'
+]);
+export const zExchangeCodeRequest = z.object({
+    code: z.string(),
+    state: z.string()
+});
+export const zExchangeCodeResponse = z.object({
+    api_key: z.string(),
+    key_id: z.string(),
+    user_id: z.string(),
+    username: z.string()
+});
+/**
+ * File Change Status
+ *
+ * Git file delta status: modified, added, deleted, or renamed
+ */
+export const zFileChangeStatus = z.enum([
+    'M',
+    'A',
+    'D',
+    'R'
+]);
+export const zChangeDiffPayload = z.object({
+    binary: z.boolean(),
+    branch: z.string(),
+    file: z.string(),
+    hunks: z.array(zDiffHunk).nullable(),
+    oldPath: z.string().nullish(),
+    status: zFileChangeStatus,
+    truncated: z.boolean()
+});
+export const zFileChange = z.object({
+    linesAdded: z.int(),
+    linesRemoved: z.int(),
+    oldPath: z.string().nullish(),
+    path: z.string(),
+    status: zFileChangeStatus
+});
+export const zFileFamiliarity = z.object({
+    daysSince: z.int().nullable(),
+    decayLevel: zDecayLevel,
+    depth: z.int(),
+    humanTurns: z.int(),
+    isSourceFile: z.boolean(),
+    lastEngagedAt: z.string().nullable(),
+    path: z.string(),
+    sessionCount: z.int(),
+    totalTurns: z.int()
+});
+export const zFrictionCluster = z.object({
+    count: z.int(),
+    file: z.string(),
+    kind: z.string(),
+    label: z.string(),
+    sessions: z.int()
+});
+export const zGitContext = z.object({
+    branch: z.string().nullish(),
+    commits: z.array(zCommitInfo).optional(),
+    remote: z.string().nullish(),
+    tracking: z.string().nullish(),
+    worktree: z.string().nullish()
+});
+/**
+ * Harness
+ *
+ * AI coding tool or development environment
+ */
+export const zHarness = z.enum([
+    'claude-code',
+    'gemini-cli',
+    'codex',
+    'opencode',
+    'cursor',
+    'antigravity'
+]);
+export const zHealthResponse = z.object({
+    status: z.string()
+});
+/**
+ * Host Slug
+ *
+ * Sanitized, filesystem-safe identifier derived from git remote; contains only [a-zA-Z0-9._<>-]
+ */
+export const zHostSlug = z.string().regex(/^[a-zA-Z0-9._<>-]+$/);
+/**
+ * Interaction Type
+ *
+ * How deeply a session engaged with a project file
+ */
+export const zInteractionType = z.enum([
+    'mentioned',
+    'read',
+    'discussed',
+    'questioned'
+]);
+/**
+ * License
+ *
+ * Content license for a published transcript
+ */
+export const zLicense = z.enum([
+    'CC0-1.0',
+    'CC-BY-4.0',
+    'CC-BY-SA-4.0'
+]);
+export const zMapEdge = z.object({
+    count: z.int(),
+    from: z.string(),
+    to: z.string()
+});
+/**
+ * Map Node Kind
+ *
+ * Path-derived map node classification
+ */
+export const zMapNodeKind = z.enum([
+    'module',
+    'package',
+    'file'
+]);
+export const zMapNode = z.object({
+    effortDensity: z.number(),
+    fileCount: z.int(),
+    id: z.string(),
+    kind: zMapNodeKind,
+    language: z.string().optional(),
+    layer: z.int(),
+    loc: z.int(),
+    name: z.string(),
+    order: z.int(),
+    parent: z.string().optional(),
+    recordedFiles: z.int(),
+    totalFiles: z.int(),
+    touchCount: z.int()
+});
+export const zMapSlice = z.object({
+    activityEdges: z.array(zActivityEdge).nullable(),
+    nodes: z.array(zMapNode).nullable(),
+    structureEdges: z.array(zMapEdge).nullable()
+});
+/**
+ * Message Type
+ *
+ * WebSocket message discriminator
+ */
+export const zMessageType = z.enum([
+    'subscribe',
+    'unsubscribe',
+    'dashboard',
+    'sessions',
+    'session_detail',
+    'trends',
+    'quality',
+    'annotations',
+    'project_familiarity',
+    'connected',
+    'error'
+]);
+export const zClientMessage = z.object({
+    channels: z.array(zChannelSubscription).optional(),
+    type: zMessageType
+});
+export const zMockConfigResponse = z.object({
+    api: z.array(z.string()).optional(),
+    enabled: z.boolean(),
+    tui: z.array(z.string()).optional(),
+    web: z.array(z.string()).optional()
+});
+/**
+ * Model ID
+ *
+ * Model identifier (e.g. 'claude-opus-4-6', 'gemini-2.0-flash')
+ */
+export const zModelID = z.string().min(1);
+export const zModelInfo = z.object({
+    harness: zHarness,
+    hostSlug: zHostSlug.optional(),
+    model: zModelID,
+    version: z.string().optional()
+});
+/**
+ * Project Hash
+ *
+ * SHA-256 hex digest of the project's origin URL or local path
+ */
+export const zProjectHash = z.string().regex(/^[0-9a-f]{64}$/).brand();
+export const zMapGraphPayload = z.object({
+    activityEdges: z.array(zActivityEdge).nullable(),
+    atCommit: z.string().optional(),
+    generatedAtMs: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    nodes: z.array(zMapNode).nullable(),
+    parsedLanguages: z.array(z.string()).nullable(),
+    projectHash: zProjectHash,
+    repoFound: z.boolean(),
+    repoPath: z.string().optional(),
+    structureEdges: z.array(zMapEdge).nullable(),
+    violations: z.array(zEdgeViolation).nullable()
+});
+export const zProjectContext = z.object({
+    filePath: z.string().optional(),
+    hash: zProjectHash,
+    name: z.string()
+});
+export const zProjectResolutionPayload = z.object({
+    project: z.string(),
+    projectHash: zProjectHash
+});
+export const zProjectSummary = z.object({
+    lastWorkMs: z.int().nullish(),
+    openChanges: z.int(),
+    project: z.string(),
+    projectHash: zProjectHash,
+    recordedFiles: z.int(),
+    sessions: z.int(),
+    totalFiles: z.int()
+});
+export const zProjectSummariesPayload = z.object({
+    projects: z.array(zProjectSummary).nullable()
+});
+export const zProvenance = z.object({
+    details: z.record(z.string(), z.string()).optional(),
+    function: z.string().optional(),
+    method: z.string(),
+    version: z.string().optional()
+});
+export const zPublishResponse = z.object({
+    blobKey: z.string(),
+    blobSizeBytes: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    created: z.boolean(),
+    publishedAt: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    transcriptId: z.string(),
+    updatedAt: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' })
+});
+export const zRedactionInfo = z.object({
+    applied: z.boolean(),
+    content_hash_at_redact: z.string().optional(),
+    level: z.string().optional(),
+    redacted_at_ms: z.int().nullish(),
+    rule_set_version: z.string().optional()
+});
+export const zReviewSuggestion = z.object({
+    daysSince: z.int(),
+    lastEngaged: z.string(),
+    path: z.string(),
+    suggestedPrompt: z.string()
+});
+/**
+ * Role
+ *
+ * Sender role of a message turn
+ */
+export const zRole = z.enum([
+    'user',
+    'assistant',
+    'tool',
+    'system'
+]);
+/**
+ * Scale Kind
+ *
+ * Stevens measurement level: nominal (categories without order), ordinal (ordered categories), continuous (numeric range)
+ */
+export const zScaleKind = z.enum([
+    'nominal',
+    'ordinal',
+    'continuous'
+]);
+export const zSchemaVersionResponse = z.object({
+    annotationSchemaVersion: z.string(),
+    minPullContractVersion: z.string().optional(),
+    minPushContractVersion: z.string(),
+    pullContractVersion: z.string().optional(),
+    pushContractVersion: z.string(),
+    supportedTargetKinds: z.array(z.string()).nullable(),
+    supportedTypeIds: z.array(z.string()).nullable()
+});
+export const zSearchResult = z.object({
+    entryIndex: z.int(),
+    project: z.string(),
+    projectHash: zProjectHash.optional(),
+    role: z.string(),
+    score: z.number(),
+    sessionId: z.string(),
+    snippet: z.string()
+});
+export const zSearchPayload = z.object({
+    query: z.string(),
+    results: z.array(zSearchResult).nullable()
+});
+export const zServerMessage = z.object({
+    axis: zAnnotationAxis.optional(),
+    data: z.unknown().optional(),
+    id: z.string().optional(),
+    message: z.string().optional(),
+    topic: zChannelTopic.optional(),
+    type: zMessageType,
+    version: z.string().optional()
+});
+/**
+ * Session ID
+ *
+ * Unique session identifier (UUID, agent-{hex}, ses_{id}, sess_{id} (ACP), or msg_{id})
+ */
+export const zSessionID = z.string().regex(/^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|agent-[a-f0-9]+|sess?_[a-zA-Z0-9]+|msg_[a-zA-Z0-9]+)$/);
+export const zCommitRef = z.object({
+    hasSession: z.boolean(),
+    hash: z.string(),
+    sessionIds: z.array(zSessionID),
+    subject: z.string(),
+    timeMs: z.int().nullish()
+});
+export const zSessionIdentity = z.object({
+    parentUuid: zSessionID.nullish(),
+    schemaVersion: z.int(),
+    sessionId: zSessionID
+});
+/**
+ * Session Outcome
+ *
+ * Resolution status of the session
+ */
+export const zSessionOutcome = z.enum([
+    'resolved',
+    'partial',
+    'failed'
+]);
+export const zQualityMetrics = z.object({
+    computeVersion: z.int().nullish(),
+    computedAt: z.int().nullish(),
+    costCacheReadUsd: z.number().nullish(),
+    costCacheWriteUsd: z.number().nullish(),
+    costInputUsd: z.number().nullish(),
+    costModelId: z.string().nullish(),
+    costOutputUsd: z.number().nullish(),
+    costReasoningUsd: z.number().nullish(),
+    costTotalUsd: z.number().nullish(),
+    discoveryTurns: z.int().nullish(),
+    durationMinutes: z.number().nullish(),
+    explorationRatio: z.number().nullish(),
+    filesTouched: z.int().nullish(),
+    inputTokens: z.int().nullish(),
+    linesChanged: z.int().nullish(),
+    m2TokenOutcomeRatio: z.number().nullish(),
+    m3UniqueToolCount: z.int().nullish(),
+    m4ConsecutiveErrorMax: z.int().nullish(),
+    m4ErrorRecoveryCount: z.int().nullish(),
+    m5AvgMessageTokens: z.int().nullish(),
+    m5ContextUtilizationPct: z.number().nullish(),
+    m5PeakContextTokens: z.int().nullish(),
+    m6LinesSurvived: z.int().nullish(),
+    m6LinesTotal: z.int().nullish(),
+    m6OutputSurvivalPct: z.number().nullish(),
+    m7SpecHasConstraints: z.boolean().nullish(),
+    m7SpecHasExamples: z.boolean().nullish(),
+    m7SpecWordCount: z.int().nullish(),
+    outcome: zSessionOutcome.nullish(),
+    outputTokens: z.int().nullish(),
+    retryLoops: z.int().nullish(),
+    retryTokensWasted: z.int().nullish(),
+    scope: z.string().nullish(),
+    scopeBreadth: z.int().nullish(),
+    signalDensity: z.number().nullish(),
+    specQualityScore: z.number().nullish(),
+    subagentCount: z.int().nullish(),
+    titleGenerated: z.string().nullish(),
+    toolCalls: z.int().nullish(),
+    totalTokens: z.int().nullish(),
+    turnCount: z.int().nullish(),
+    withinSessionReverts: z.int().nullish()
+});
+export const zSessionScorecard = z.object({
+    costTotalUsd: z.number().nullish(),
+    m2TokenOutcomeRatio: z.number().nullish(),
+    m4ConsecutiveErrorMax: z.int().nullish(),
+    m5ContextUtilizationPct: z.number().nullish(),
+    m6OutputSurvivalPct: z.number().nullish(),
+    m7SpecHasConstraints: z.boolean().nullish(),
+    m7SpecHasExamples: z.boolean().nullish(),
+    outcome: zSessionOutcome.optional(),
+    retryTokensWasted: z.int().nullish(),
+    signalDensity: z.number().nullish(),
+    specQualityScore: z.number().nullish(),
+    totalTokens: z.int().nullish(),
+    withinSessionReverts: z.int().nullish()
+});
+export const zSessionStats = z.object({
+    cachedReadTokens: z.int().nullish(),
+    cachedWriteTokens: z.int().nullish(),
+    durationMs: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    subagentCount: z.int(),
+    thoughtTokens: z.int().nullish(),
+    tokensIn: z.int(),
+    tokensOut: z.int(),
+    toolCallCount: z.int(),
+    turnCount: z.int()
+});
+export const zSessionSummary = z.object({
+    durationMins: z.number(),
+    harness: zHarness,
+    id: z.string(),
+    outcome: z.string().optional(),
+    parentSessionId: z.string().nullish(),
+    preview: z.string().optional(),
+    project: z.string().optional(),
+    projectHash: zProjectHash.optional(),
+    startTime: z.iso.datetime(),
+    toolCallCount: z.int(),
+    totalTokens: z.int(),
+    turnCount: z.int()
+});
+export const zSessionsPayload = z.object({
+    sessions: z.array(zSessionSummary).nullable()
+});
+export const zShutdownResponse = z.object({
+    status: z.string()
+});
+/**
+ * Source Format
+ *
+ * Transcript file format
+ */
+export const zSourceFormat = z.enum(['jsonl', 'json']);
+export const zSourceInfo = z.object({
+    filePath: z.string().optional(),
+    format: zSourceFormat
+});
+/**
+ * Stop Reason
+ *
+ * Reason why a session or turn ended (ACP-aligned)
+ */
+export const zStopReason = z.enum([
+    'end_turn',
+    'cancelled',
+    'max_tokens',
+    'max_turn_requests',
+    'refusal'
+]);
+export const zSubagentRef = z.object({
+    parentUuid: zSessionID,
+    sessionId: zSessionID
+});
+/**
+ * Target Kind
+ *
+ * What is being annotated: session-level, entry-level (turn/tool call), meta-annotation, or project-level
+ */
+export const zTargetKind = z.enum([
+    'session',
+    'entry',
+    'annotation',
+    'project'
+]);
+export const zAnnotationPushItem = z.object({
+    annotationId: z.string().nullish(),
+    annotatorName: z.string().optional(),
+    confidence: z.number().nullish(),
+    contentHash: z.string(),
+    entryTarget: zAnnotationEntryTarget.nullish(),
+    isPrimary: z.boolean(),
+    projectHash: zProjectHash.nullish(),
+    provenance: zProvenance.nullish(),
+    reason: z.string().nullish(),
+    sessionId: z.string().nullish(),
+    targetKind: zTargetKind,
+    typeId: z.string(),
+    value: z.string()
+});
+export const zAnnotationPushRequest = z.object({
+    annotations: z.array(zAnnotationPushItem).nullable(),
+    retractions: z.array(z.string()).optional()
+});
+export const zAnnotationSummary = z.object({
+    annotatorKind: zAnnotatorKind,
+    annotatorName: z.string(),
+    confidence: z.number().nullish(),
+    contentHash: z.string().nullish(),
+    createdAt: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    id: z.string(),
+    isPrimary: z.boolean(),
+    provenance: zProvenance.nullish(),
+    reason: z.string().nullish(),
+    supersededBy: z.string().nullish(),
+    targetAnnotationId: z.string().nullish(),
+    targetEntryEndIndex: z.int().nullish(),
+    targetEntryIndex: z.int().nullish(),
+    targetKind: zTargetKind,
+    targetProjectHash: zProjectHash.nullish(),
+    targetSessionId: z.string().nullish(),
+    typeId: z.string(),
+    typeName: z.string(),
+    value: z.string()
+});
+export const zAnnotationsPayload = z.object({
+    annotations: z.array(zAnnotationSummary).nullable(),
+    axis: zAnnotationAxis,
+    id: z.string()
+});
+export const zPullAnnotation = z.object({
+    annotatorKind: zAnnotatorKind.optional(),
+    annotatorName: z.string().optional(),
+    authorUserId: z.string(),
+    authorUsername: z.string(),
+    confidence: z.number().nullish(),
+    contentHash: z.string().nullish(),
+    createdAt: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }).optional(),
+    id: z.string().optional(),
+    isPrimary: z.boolean().optional(),
+    provenance: zProvenance.optional(),
+    reason: z.string().nullish(),
+    supersededBy: z.string().nullish(),
+    targetAnnotationId: z.string().nullish(),
+    targetEntryEndIndex: z.int().nullish(),
+    targetEntryIndex: z.int().nullish(),
+    targetKind: zTargetKind.optional(),
+    targetProjectHash: zProjectHash.optional(),
+    targetSessionId: z.string().nullish(),
+    typeId: z.string().optional(),
+    typeName: z.string().optional(),
+    value: z.string().optional()
+});
+export const zQualitySession = z.object({
+    date: z.string(),
+    discoveryTurns: z.int(),
+    durationMinutes: z.number(),
+    effectiveAnnotations: z.array(zAnnotationSummary).optional(),
+    explorationRatio: z.number(),
+    filesTouched: z.int(),
+    id: z.string(),
+    inputTokens: z.int(),
+    linesChanged: z.int(),
+    outcome: z.string(),
+    outputTokens: z.int(),
+    project: z.string(),
+    retryLoops: z.int(),
+    retryTokensWasted: z.int(),
+    scope: z.string(),
+    scopeBreadth: z.int(),
+    signalDensity: z.number(),
+    specQualityScore: z.number(),
+    title: z.string(),
+    toolCalls: z.int(),
+    totalTokens: z.int(),
+    turnCount: z.int(),
+    withinSessionReverts: z.int()
+});
+export const zQualityPayload = z.object({
+    sessions: z.array(zQualitySession).nullable()
+});
+export const zTaskSummary = z.object({
+    editedFiles: z.array(z.string()).nullable(),
+    entryIndex: z.int(),
+    labels: z.array(z.string()).nullable(),
+    outcome: z.string().optional(),
+    readCount: z.int(),
+    retryLoop: z.boolean(),
+    sessionId: z.string(),
+    startMs: z.int().nullish(),
+    title: z.string()
+});
+export const zChangeSession = z.object({
+    binding: zChangeBinding,
+    harness: z.string(),
+    sessionId: z.string(),
+    startMs: z.int().nullish(),
+    tasks: z.array(zTaskSummary).nullable(),
+    title: z.string()
+});
+export const zMapNodeDetailPayload = z.object({
+    costUsd: z.number().nullish(),
+    dependsOn: z.array(z.string()).nullable(),
+    kind: zMapNodeKind,
+    language: z.string().optional(),
+    lastTouchMs: z.int().nullish(),
+    loc: z.int(),
+    path: z.string(),
+    reEdits: z.int(),
+    recentCommits: z.array(zCommitRef).nullable(),
+    recordedFiles: z.int(),
+    retryLoops: z.int(),
+    sessionCount: z.int(),
+    shapedBy: z.array(zTaskSummary).nullable(),
+    taskCount: z.int(),
+    totalFiles: z.int(),
+    usedBy: z.array(z.string()).nullable()
+});
+export const zProjectTasksPayload = z.object({
+    fileFilter: z.string().optional(),
+    projectHash: zProjectHash,
+    tasks: z.array(zTaskSummary).nullable()
+});
+export const zTimelineSessionRef = z.object({
+    harness: zHarness,
+    hasCommitBinding: z.boolean(),
+    sessionId: zSessionID,
+    startMs: z.int().nullish(),
+    title: z.string()
+});
+export const zReviewListPayload = z.object({
+    changes: z.array(zChangeSummary),
+    defaultBranch: z.string().optional(),
+    projectHash: zProjectHash,
+    recentCommits: z.array(zCommitRef),
+    repoFound: z.boolean(),
+    sessions: z.array(zTimelineSessionRef)
+});
+export const zTimestampInfo = z.object({
+    end: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    ingested: z.int().nullish(),
+    start: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' })
+});
+/**
+ * Tool Call Kind
+ *
+ * Classification of a tool call, aligned with ACP ToolCallUpdate.kind
+ */
+export const zToolCallKind = z.enum([
+    'read',
+    'edit',
+    'delete',
+    'move',
+    'search',
+    'execute',
+    'think',
+    'fetch',
+    'other'
+]);
+export const zSessionEntry = z.object({
+    contentPreview: z.string().nullish(),
+    depth: z.int(),
+    entryId: z.string().nullish(),
+    entryIndex: z.int(),
+    entryType: zEntryType,
+    extra: z.string().nullish(),
+    harness: zHarness,
+    hasThinking: z.boolean(),
+    hasToolUse: z.boolean(),
+    isError: z.boolean(),
+    parentEntryId: z.string().nullish(),
+    parentIndex: z.int().nullish(),
+    partType: z.string().nullish(),
+    rawByteLength: z.int().nullish(),
+    role: zRole,
+    sessionId: zSessionID,
+    stopReason: zStopReason.nullish(),
+    timestampMs: z.int().nullish(),
+    tokensIn: z.int().nullish(),
+    tokensOut: z.int().nullish(),
+    toolCallId: z.string().nullish(),
+    toolInput: z.string().nullish(),
+    toolKind: zToolCallKind.nullish(),
+    toolNamesCsv: z.string().nullish(),
+    toolOutput: z.string().nullish()
+});
+export const zPublishRequest = z.object({
+    diagnostics: zDiagnosticsInfo,
+    entries: z.array(zSessionEntry).optional(),
+    git: zGitContext,
+    identity: zSessionIdentity,
+    license: zLicense.optional(),
+    model: zModelInfo,
+    project: zProjectContext,
+    quality: zQualityMetrics.nullish(),
+    source: zSourceInfo,
+    stats: zSessionStats,
+    subagents: z.array(zSubagentRef).optional(),
+    timestamp: zTimestampInfo
+});
+export const zToolCallDetail = z.object({
+    arguments: z.string(),
+    durationMs: z.int().nullish(),
+    exitCode: z.int().nullish(),
+    filePath: z.string().optional(),
+    id: z.string(),
+    isError: z.boolean().optional(),
+    name: z.string(),
+    result: z.string(),
+    toolKind: zToolCallKind.optional()
+});
+/**
+ * Transcript ID
+ *
+ * Village-side transcript identifier (canonical lowercase-hex UUID)
+ */
+export const zTranscriptID = z.uuid().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/);
+export const zPullSkipGateItem = z.object({
+    annotationHashes: z.array(z.string()),
+    contentHash: z.string(),
+    transcriptId: zTranscriptID
+});
+export const zPullSkipGateRequest = z.object({
+    items: z.array(zPullSkipGateItem)
+});
+export const zPullSkipGateResult = z.object({
+    annotationsCurrent: z.boolean(),
+    contentCurrent: z.boolean(),
+    transcriptId: zTranscriptID
+});
+export const zPullSkipGateResponse = z.object({
+    results: z.array(zPullSkipGateResult)
+});
+export const zTrendsPayload = z.object({
+    days: z.array(zDayStats).nullable(),
+    totalSessions: z.int(),
+    totalTokens: z.int()
+});
+export const zTurnDetail = z.object({
+    agentName: z.string().optional(),
+    content: z.string(),
+    depth: z.int(),
+    entryType: zEntryType.optional(),
+    hasThinking: z.boolean().optional(),
+    index: z.int(),
+    parentIndex: z.int().nullish(),
+    role: zRole,
+    stopReason: zStopReason.nullish(),
+    timestamp: z.iso.datetime(),
+    tokensIn: z.int().nullish(),
+    tokensOut: z.int().nullish(),
+    toolCalls: z.array(zToolCallDetail).optional()
+});
+export const zSessionDetailPayload = z.object({
+    childSessions: z.array(zChildSessionRef).optional(),
+    durationMins: z.number(),
+    endTime: z.iso.datetime(),
+    gitBranch: z.string().optional(),
+    gitRemote: z.string().optional(),
+    harness: zHarness,
+    id: z.string(),
+    model: z.string().optional(),
+    outcome: zSessionOutcome.optional(),
+    project: z.string().optional(),
+    schemaVersion: z.string().optional(),
+    scorecard: zSessionScorecard.nullish(),
+    source: z.string().optional(),
+    startTime: z.iso.datetime(),
+    status: z.string().optional(),
+    tokensIn: z.int(),
+    tokensOut: z.int(),
+    toolCallCount: z.int(),
+    totalTokens: z.int(),
+    turnCount: z.int(),
+    turns: z.array(zTurnDetail).nullable(),
+    workingDirectory: z.string().optional()
+});
+export const zTranscriptContent = z.object({
+    contractVersion: z.string(),
+    kind: zContentKind,
+    sessionDetail: zSessionDetailPayload.nullish()
+});
+/**
+ * Type Origin
+ *
+ * Who created an annotation type: system (built-in), user (individual), or group (shared)
+ */
+export const zTypeOrigin = z.enum([
+    'system',
+    'user',
+    'group'
+]);
+export const zUnifiedMetadata = z.object({
+    contentHash: z.string(),
+    cwd: z.string().optional(),
+    derivedAt: z.int().nullish(),
+    diagnostics: zDiagnosticsInfo,
+    git: zGitContext,
+    harness: zHarness,
+    hostSlug: zHostSlug,
+    metadataHash: z.string(),
+    model: zModelID,
+    parentUuid: zSessionID.nullable(),
+    project: zProjectContext,
+    redaction: zRedactionInfo,
+    schemaVersion: z.int(),
+    sessionId: zSessionID,
+    source: zSourceInfo,
+    stats: zSessionStats,
+    subagents: z.array(zSubagentRef).nullable(),
+    timestamp: zTimestampInfo,
+    version: z.string()
+});
+export const zUnusualSignal = z.object({
+    kind: z.string(),
+    label: z.string(),
+    perChange: z.number(),
+    perProject: z.number()
+});
+export const zChangeDetailPayload = z.object({
+    baseRef: z.string(),
+    branch: z.string(),
+    costUsd: z.number().nullish(),
+    defaultBranch: z.string(),
+    files: z.array(zFileChange).nullable(),
+    frictions: z.array(zFrictionCluster).nullable(),
+    linesAdded: z.int(),
+    linesRemoved: z.int(),
+    newEdges: z.array(zMapEdge).nullable(),
+    newNodes: z.array(z.string()).nullable(),
+    outputTokens: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    removedEdges: z.array(zMapEdge).nullable(),
+    removedNodes: z.array(z.string()).nullable(),
+    slice: zMapSlice,
+    unrecordedCommits: z.array(zCommitRef).nullable(),
+    unusual: z.array(zUnusualSignal).nullable(),
+    violations: z.array(zEdgeViolation).nullable(),
+    work: z.array(zChangeSession).nullable()
+});
+/**
+ * Value Domain Kind
+ *
+ * ISO 11179 value domain: enumerated (finite allowed set) or described (range/pattern constraint)
+ */
+export const zValueDomainKind = z.enum(['enumerated', 'described']);
+export const zValueDomain = z.object({
+    constraintSpec: z.string().optional(),
+    datatype: zAnnotationDatatype,
+    kind: zValueDomainKind,
+    permissibleValues: z.array(z.string()).optional()
+});
+export const zAnnotationTypeSummary = z.object({
+    allowedTargetKinds: z.array(zTargetKind).optional(),
+    class: z.string(),
+    description: z.string().optional(),
+    displayName: z.string(),
+    family: z.string(),
+    id: z.string().optional(),
+    lowerIsBetter: z.boolean().nullish(),
+    origin: zTypeOrigin,
+    priorityOverride: z.int().nullish(),
+    scaleKind: zScaleKind.optional(),
+    status: zAnnotationStatus,
+    typeId: z.string(),
+    valueDomain: zValueDomain,
+    version: z.int()
+});
+export const zTaxonomyFamilyNode = z.object({
+    family: z.string(),
+    types: z.array(zAnnotationTypeSummary).nullable()
+});
+export const zTaxonomyNode = z.object({
+    class: z.string(),
+    families: z.array(zTaxonomyFamilyNode).nullable()
+});
+/**
+ * Visibility
+ *
+ * Access control level for a published transcript
+ */
+export const zVisibility = z.enum([
+    'private',
+    'group',
+    'public'
+]);
+export const zPullTranscriptInfo = z.object({
+    annotationCount: z.int(),
+    contentHash: z.string().optional(),
+    contractVersion: z.string().optional(),
+    harness: zHarness.optional(),
+    license: zLicense.optional(),
+    localId: z.string().optional(),
+    ownerUserId: z.string(),
+    ownerUsername: z.string(),
+    projectName: z.string().optional(),
+    publishedAt: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    title: z.string().optional(),
+    transcriptId: zTranscriptID,
+    updatedAt: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    visibility: zVisibility
+});
+export const zPullListResponse = z.object({
+    limit: z.int(),
+    page: z.int(),
+    total: z.int(),
+    transcripts: z.array(zPullTranscriptInfo).nullable()
+});
+export const zWalkthroughStep = z.object({
+    excerpt: z.string(),
+    file: z.string(),
+    line: z.int().nullish()
+});
+export const zWalkthroughTrail = z.object({
+    date: z.string(),
+    isCoherent: z.boolean(),
+    sessionId: z.string(),
+    steps: z.array(zWalkthroughStep).nullable(),
+    title: z.string(),
+    turnCount: z.int()
+});
+export const zFamiliarityPayload = z.object({
+    familiarityPct: z.number(),
+    files: z.array(zFileFamiliarity).nullable(),
+    freshnessDays: z.int().nullable(),
+    projectHash: zProjectHash,
+    suggestions: z.array(zReviewSuggestion).nullable(),
+    trails: z.array(zWalkthroughTrail).nullable(),
+    unexploredCount: z.int()
+});