@peasant-labs/schema 0.24.0 → 0.25.0

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

@@ -233,6 +233,50 @@ export const zAuthoritativeTimestampInfo = z.object({
     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' })
 }).strict();
+/**
+ * Auto Publish Event
+ *
+ * Git hook that publishes an auto-publish rule's sessions
+ */
+export const zAutoPublishEvent = z.enum(['pre-push', 'post-commit']);
+export const zAutoPublishHookRemedy = z.object({
+    message: z.string().min(1),
+    snippet: z.string().optional()
+});
+/**
+ * Auto Publish Hook Status
+ *
+ * State of one repository's auto-publish hook for one event
+ */
+export const zAutoPublishHookStatus = z.enum([
+    'absent',
+    'installed',
+    'blocked',
+    'failed'
+]);
+export const zAutoPublishHook = z.object({
+    event: zAutoPublishEvent,
+    remedy: zAutoPublishHookRemedy.optional(),
+    status: zAutoPublishHookStatus
+});
+export const zAutoPublishInstallRequest = z.object({
+    path: z.string().min(1)
+}).strict();
+export const zAutoPublishRepository = z.object({
+    hooks: z.array(zAutoPublishHook),
+    label: z.string().optional(),
+    path: z.string().min(1)
+});
+export const zAutoPublishRemovalResponse = z.object({
+    id: z.string().min(1),
+    repositories: z.array(zAutoPublishRepository)
+});
+/**
+ * Auto Publish Rule Kind
+ *
+ * What an auto-publish rule's match pattern names
+ */
+export const zAutoPublishRuleKind = z.enum(['folder', 'remote']);
 export const zBatchCreateAnnotationsErrorResponse = z.object({
     error: z.string(),
     failingIndex: z.int()
@@ -677,6 +721,69 @@ export const zLicense = z.enum([
     'CC-BY-4.0',
     'CC-BY-SA-4.0'
 ]);
+/**
+ * Local Collective Suggestion Reason
+ *
+ * Why the local server suggests a collective for a session
+ */
+export const zLocalCollectiveSuggestionReason = z.enum(['linked_repository', 'linked_github_org']);
+export const zLocalCollectiveSuggestion = z.object({
+    match: z.string(),
+    reason: zLocalCollectiveSuggestionReason
+});
+export const zLocalPublicationAttemptFailure = z.object({
+    attemptedAt: z.iso.datetime(),
+    message: z.string()
+});
+/**
+ * Local Publication State
+ *
+ * Whether a local session has a publication on Village
+ */
+export const zLocalPublicationState = z.enum(['unpublished', 'published']);
+/**
+ * Local Setting Kind
+ *
+ * JSON type of one local setting's value
+ */
+export const zLocalSettingKind = z.enum([
+    'boolean',
+    'integer',
+    'string',
+    'string_list',
+    'choice',
+    'structured'
+]);
+export const zLocalSettingRefusal = z.object({
+    error: z.string().min(1),
+    key: z.string().min(1)
+});
+/**
+ * Local Setting Value
+ *
+ * One setting's value, of the JSON type its kind names; null means the key is unset and the server's default applies
+ */
+export const zLocalSettingValue = z.union([
+    z.boolean(),
+    z.int(),
+    z.string(),
+    z.array(z.unknown()),
+    z.record(z.string(), z.unknown())
+]).nullable();
+export const zLocalSetting = z.object({
+    description: z.string().optional(),
+    editable: z.boolean(),
+    effective: zLocalSettingValue,
+    inPeasantConfig: z.boolean(),
+    key: z.string().min(1),
+    kind: zLocalSettingKind,
+    options: z.array(z.string()).optional(),
+    value: zLocalSettingValue
+});
+export const zLocalSettingUpdateRequest = z.object({
+    key: z.string().min(1),
+    value: zLocalSettingValue
+}).strict();
 export const zMapEdge = z.object({
     count: z.int(),
     from: z.string(),
@@ -797,23 +904,6 @@ export const zAuthoritativeProjectContext = z.object({
     hash: zProjectHash,
     name: z.string()
 }).strict();
-export const zLocalSyncSummary = z.object({
-    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' }),
-    harness: zHarness,
-    hostSlug: z.string(),
-    id: z.string(),
-    inputSubmissionCount: z.int().gte(0).lte(9007199254740991).optional(),
-    model: z.string(),
-    projectHash: zProjectHash,
-    projectName: z.string(),
-    startTime: z.string(),
-    syncStatus: z.string(),
-    totalTokens: z.int(),
-    turnCount: z.int()
-});
-export const zLocalSyncSessionsPayload = z.object({
-    sessions: z.array(zLocalSyncSummary)
-});
 export const zProjectContext = z.object({
     filePath: z.string().optional(),
     hash: zProjectHash,
@@ -1490,6 +1580,171 @@ export const zSessionSummary = z.object({
     totalTokens: z.int(),
     turnCount: z.int()
 });
+export const zSessionsPayload = z.object({
+    sessions: z.array(zSessionSummary).nullable()
+});
+/**
+ * Source Format
+ *
+ * Transcript file format
+ */
+export const zSourceFormat = z.enum(['jsonl', 'json']);
+export const zAuthoritativeSourceInfo = z.object({
+    filePath: z.string().optional(),
+    format: zSourceFormat
+}).strict();
+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
+});
+/**
+ * Submission Reference
+ */
+export const zSubmissionRef = z.string().min(1).max(96).refine((value) => !/[\uD800-\uDFFF]/u.test(value) && new TextEncoder().encode(value).length <= 96, { error: "SubmissionRef is invalid UTF-8 or exceeds 96 bytes" });
+export const zContentProvenance = z.object({
+    actor: zActorOrigin,
+    delivery: zDeliveryOrigin,
+    evidence: zEvidenceKind,
+    inputModality: zInputModality,
+    origin: zContentOrigin,
+    ownership: zContentOwnership,
+    submissionRef: zSubmissionRef.optional()
+}).strict();
+export const zSyncAuthResponse = z.object({
+    authenticated: z.boolean(),
+    username: z.string().optional(),
+    villageConfigured: z.boolean().optional(),
+    villageUrl: z.string().optional()
+});
+/**
+ * Sync Hold Reason
+ *
+ * Why a held local session cannot be published yet
+ */
+export const zSyncHoldReason = z.enum(['metrics_missing', 'metadata_missing']);
+/**
+ * Sync Login Status
+ *
+ * Result of starting the Village sign-in from the local server
+ */
+export const zSyncLoginStatus = z.enum(['pending', 'already_authenticated']);
+export const zSyncLoginResponse = z.object({
+    status: zSyncLoginStatus
+});
+/**
+ * Sync Logout Status
+ *
+ * Result of ending this computer's Village sign-in
+ */
+export const zSyncLogoutStatus = z.enum(['logged_out', 'already_logged_out']);
+export const zSyncLogoutResponse = z.object({
+    status: zSyncLogoutStatus
+});
+/**
+ * Sync Push Session Status
+ *
+ * Outcome of one session in a push
+ */
+export const zSyncPushSessionStatus = z.enum([
+    'new',
+    'updated',
+    'skipped',
+    'error',
+    'held'
+]);
+/**
+ * Sync Push Step
+ *
+ * One step a push runs for a session
+ */
+export const zSyncPushStep = z.enum([
+    'content',
+    'add_collective',
+    'remove_collective'
+]);
+/**
+ * Sync Push Step Outcome
+ *
+ * Result of one push step
+ */
+export const zSyncPushStepOutcome = z.enum([
+    'succeeded',
+    'pending_approval',
+    'skipped',
+    'failed',
+    'not_attempted'
+]);
+export const zSyncRedactionItem = z.object({
+    category: z.string(),
+    contextAfter: z.array(z.string()),
+    contextBefore: z.array(z.string()),
+    description: z.string(),
+    entryIndex: z.int().gte(0).optional(),
+    lineNumber: z.int().gte(0),
+    originalText: z.string(),
+    redactedReplacement: z.string(),
+    ruleDisplayName: z.string(),
+    ruleId: z.string(),
+    toolCallId: z.string().optional()
+});
+export const zSyncRedactionRuleGroup = z.object({
+    count: z.int().gte(0),
+    displayName: z.string(),
+    items: z.array(zSyncRedactionItem),
+    ruleId: z.string()
+});
+export const zSyncRedactionCategoryGroup = z.object({
+    category: z.string(),
+    rules: z.array(zSyncRedactionRuleGroup),
+    totalCount: z.int().gte(0)
+});
+export const zSyncRedactionsResponse = z.object({
+    categories: z.array(zSyncRedactionCategoryGroup),
+    total: z.int().gte(0)
+});
+/**
+ * Sync Status
+ *
+ * Publication status of one listed local session; held rows always carry a hold reason
+ */
+export const zSyncStatus = z.enum([
+    'new',
+    'updated',
+    'synced',
+    'held'
+]);
+export const zLocalSyncSummary = z.object({
+    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' }),
+    harness: zHarness,
+    holdReason: zSyncHoldReason.optional(),
+    hostSlug: z.string(),
+    id: z.string(),
+    inputSubmissionCount: z.int().gte(0).lte(9007199254740991).optional(),
+    model: z.string(),
+    previouslyPushed: z.boolean(),
+    projectHash: zProjectHash,
+    projectName: z.string(),
+    startTime: z.string(),
+    syncStatus: zSyncStatus,
+    totalTokens: z.int(),
+    turnCount: z.int()
+});
 export const zLocalSessionRow = z.object({
     matches: z.array(zSearchResult).optional(),
     session: zSessionSummary,
@@ -1563,52 +1818,9 @@ export const zLocalSessionListPayload = z.object({
     page: z.int().gte(1).lte(9007199254740991),
     totalItems: z.int().gte(0).lte(9007199254740991)
 });
-export const zSessionsPayload = z.object({
-    sessions: z.array(zSessionSummary).nullable()
-});
-/**
- * Source Format
- *
- * Transcript file format
- */
-export const zSourceFormat = z.enum(['jsonl', 'json']);
-export const zAuthoritativeSourceInfo = z.object({
-    filePath: z.string().optional(),
-    format: zSourceFormat
-}).strict();
-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
+export const zLocalSyncSessionsPayload = z.object({
+    sessions: z.array(zLocalSyncSummary)
 });
-/**
- * Submission Reference
- */
-export const zSubmissionRef = z.string().min(1).max(96).refine((value) => !/[\uD800-\uDFFF]/u.test(value) && new TextEncoder().encode(value).length <= 96, { error: "SubmissionRef is invalid UTF-8 or exceeds 96 bytes" });
-export const zContentProvenance = z.object({
-    actor: zActorOrigin,
-    delivery: zDeliveryOrigin,
-    evidence: zEvidenceKind,
-    inputModality: zInputModality,
-    origin: zContentOrigin,
-    ownership: zContentOwnership,
-    submissionRef: zSubmissionRef.optional()
-}).strict();
 /**
  * Target Kind
  *
@@ -2405,7 +2617,8 @@ export const zVillageAssignableGroupRole = z.enum(['contributor', 'member']);
 export const zVillageAvailableRepository = z.object({
     is_private: z.boolean(),
     name: z.string(),
-    owner: z.string()
+    owner: z.string(),
+    publisher_count: z.int().gte(0).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' })
 });
 export const zVillageAvailableRepositoriesResponse = z.object({
     repositories: z.array(zVillageAvailableRepository)
@@ -2467,7 +2680,7 @@ export const zVillageCreateGroupRequest = z.object({
     acceptance_mode: zVillageGroupAcceptanceMode.optional(),
     data_access: zVillageGroupDataAccess.optional(),
     description: z.string().optional(),
-    linked_github_org: z.string().optional(),
+    linked_github_org: z.string().nullish(),
     name: z.string()
 });
 export const zVillageGroupMemberRoleRequest = z.object({
@@ -2497,6 +2710,7 @@ export const zVillageGroupStatusRoleResponse = z.object({
 });
 export const zVillageGroupTranscriptStats = z.object({
     contributor_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
+    pull_request_count: z.int().gte(0).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
     total_duration_ms: 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' }),
     total_tokens: 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' }),
     total_transcripts: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
@@ -2574,6 +2788,15 @@ export const zVillagePromptRequest = z.object({
 export const zVillagePromptRequestsResponse = z.object({
     requests: z.array(zVillagePromptRequest)
 });
+export const zVillagePullRequestRef = z.object({
+    name: z.string().min(1),
+    number: z.int().gte(1),
+    owner: z.string().min(1)
+});
+export const zVillagePullRequestsSummary = z.object({
+    count: z.int().gte(0).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
+    recent: z.array(zVillagePullRequestRef)
+});
 export const zVillageRemoveGroupMemberResponse = z.object({
     retracted: z.boolean(),
     status: z.string()
@@ -2649,6 +2872,17 @@ export const zVillageStatusResponse = z.object({
  * Whether leaving a collective retracts contributed transcripts by default
  */
 export const zVillageTranscriptDeletionPolicy = z.enum(['user_choice', 'mandatory']);
+export const zVillageTranscriptPullRequest = z.object({
+    head_ref: z.string().nullable(),
+    name: z.string().min(1),
+    number: z.int().gte(1),
+    owner: z.string().min(1),
+    state: zVillagePullRequestAttachmentState,
+    title: z.string().nullable()
+});
+export const zVillageTranscriptPullRequestsResponse = z.object({
+    pull_requests: z.array(zVillageTranscriptPullRequest)
+});
 /**
  * Village Transcript Visibility
  *
@@ -2691,6 +2925,74 @@ export const zVillagePullRequestAttachedTranscript = z.object({
  * Village-side canonical lowercase UUID identifier
  */
 export const zVillageUUID = 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 zAutoPublishRule = z.object({
+    collectives: z.array(zVillageUUID),
+    events: z.array(zAutoPublishEvent),
+    id: z.string().min(1),
+    kind: zAutoPublishRuleKind,
+    match: z.string().min(1),
+    repositories: z.array(zAutoPublishRepository)
+});
+export const zAutoPublishRuleRequest = z.object({
+    collectives: z.array(zVillageUUID),
+    events: z.array(zAutoPublishEvent),
+    kind: zAutoPublishRuleKind,
+    match: z.string().min(1)
+}).strict();
+export const zLocalPublicationAudienceMember = z.object({
+    collectiveId: zVillageUUID,
+    name: z.string(),
+    status: zVillageShareStatus
+});
+export const zLocalPublication = z.object({
+    audience: z.array(zLocalPublicationAudienceMember).optional(),
+    autoPublish: z.boolean(),
+    lastAttempt: zLocalPublicationAttemptFailure.optional(),
+    outsideSelection: z.boolean(),
+    publishedAt: z.iso.datetime().optional(),
+    sessionId: z.string(),
+    state: zLocalPublicationState,
+    transcriptId: zTranscriptID.optional(),
+    transcriptUrl: z.string().optional()
+});
+export const zLocalPublicationsResponse = z.object({
+    publications: z.array(zLocalPublication)
+});
+export const zLocalSettingsResponse = z.object({
+    autoPublish: z.array(zAutoPublishRule),
+    settings: z.array(zLocalSetting)
+});
+export const zSyncPushCollectives = z.object({
+    add: z.array(zVillageUUID).optional(),
+    remove: z.array(zVillageUUID).optional()
+}).strict();
+export const zSyncPushRequest = z.object({
+    collectives: zSyncPushCollectives.optional(),
+    redactionLevel: z.string().optional(),
+    sessionIds: z.array(z.string()).min(1)
+}).strict();
+export const zSyncPushStepResult = z.object({
+    collectiveId: zVillageUUID.optional(),
+    outcome: zSyncPushStepOutcome,
+    reason: z.string().optional(),
+    step: zSyncPushStep
+});
+export const zSyncPushSessionResult = z.object({
+    error: z.string().optional(),
+    sessionId: z.string(),
+    status: zSyncPushSessionStatus,
+    steps: z.array(zSyncPushStepResult).optional(),
+    title: z.string().optional(),
+    transcriptUrl: z.string().optional(),
+    waitingPullRequests: z.array(zVillagePromptRequest).optional()
+});
+export const zSyncPushResponse = z.object({
+    errors: z.int().gte(0),
+    new: z.int().gte(0),
+    sessions: z.array(zSyncPushSessionResult),
+    skipped: z.int().gte(0),
+    updated: z.int().gte(0)
+});
 export const zVillageCollectiveSearchResult = z.object({
     description: z.string().nullable(),
     id: zVillageUUID,
@@ -2828,6 +3130,7 @@ export const zVillageGroupTranscript = z.object({
     project_name_source: zVillageProjectNameSource,
     project_remote_label: z.string(),
     published_at: z.iso.datetime(),
+    pull_requests: zVillagePullRequestsSummary,
     purpose: zSessionPurpose.optional(),
     relationships: z.array(zSessionRelationship).optional(),
     retry_loops: z.int().nullable(),
@@ -2920,6 +3223,7 @@ export const zVillagePullRequestAttachment = z.object({
     confirmed_at: z.iso.datetime().nullable(),
     created_at: z.iso.datetime(),
     detached_at: z.iso.datetime().nullable(),
+    head_ref: z.string().nullable(),
     head_sha: z.string(),
     id: zVillageUUID,
     is_private_repository: z.boolean(),
@@ -2928,6 +3232,7 @@ export const zVillagePullRequestAttachment = z.object({
     owner: z.string(),
     requested_by_github_id: z.int().nullable(),
     state: zVillagePullRequestAttachmentState,
+    title: z.string().nullable(),
     updated_at: z.iso.datetime()
 });
 export const zVillagePullRequestAttachmentResponse = z.object({
@@ -3051,6 +3356,7 @@ export const zVillageUpdateGroupRequest = z.object({
     transcript_deletion_policy: zVillageTranscriptDeletionPolicy.optional()
 });
 export const zVillageUpdateUserSettingsRequest = z.object({
+    auto_attach_pull_requests: z.boolean().nullish(),
     preview_before_attach: z.boolean().nullish()
 });
 export const zVillageUser = z.object({
@@ -3071,6 +3377,7 @@ export const zVillageTranscriptListRow = z.object({
     attestations: z.array(zVillageListTranscriptAttestation).nullable(),
     owner: zVillageUser,
     owner_orgs: z.array(zVillageListUserOrganization).nullable(),
+    pull_requests: zVillagePullRequestsSummary,
     shares: z.array(zVillageEnrichedTranscriptShare).nullable(),
     tags: z.array(zVillageTag),
     transcript: zVillageTranscript
@@ -3109,6 +3416,13 @@ export const zVillageUserGroup = z.object({
     transcript_deletion_policy: zVillageTranscriptDeletionPolicy,
     updated_at: z.iso.datetime()
 });
+export const zLocalVillageCollective = z.object({
+    group: zVillageUserGroup,
+    suggestion: zLocalCollectiveSuggestion.optional()
+});
+export const zLocalVillageCollectivesResponse = z.object({
+    collectives: z.array(zLocalVillageCollective)
+});
 export const zVillageUserGroupShare = z.object({
     id: zTranscriptID,
     input_submission_count: z.int().gte(0).lte(9007199254740991).optional(),
@@ -3234,8 +3548,16 @@ export const zVillageGroupedGroupDetailResponse = z.object({
     your_role: zVillageGroupViewerRole
 });
 export const zVillageUserSettings = z.object({
+    auto_attach_pull_requests: z.boolean(),
     preview_before_attach: z.boolean()
 });
+export const zVillageUserStats = z.object({
+    pull_request_count: z.int().gte(0).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
+    total_duration_ms: z.coerce.bigint().gte(BigInt(0)).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    total_tokens: z.coerce.bigint().gte(BigInt(0)).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
+    total_transcripts: z.int().gte(0).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
+    total_turns: z.coerce.bigint().gte(BigInt(0)).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' })
+});
 export const zVillageVisibleGroup = z.object({
     acceptance_mode: zVillageGroupAcceptanceMode,
     created_at: z.iso.datetime(),