@peasant-labs/schema 0.29.1 → 0.31.0

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

@@ -1,4 +1,5 @@
 // publication-contract-semantic-refinement
+import { collectiveContractIssue } from "../../../collective-validation.js";
 // This file is auto-generated by @hey-api/openapi-ts
 import * as z from 'zod';
 export const zActivityEdge = z.object({
@@ -376,6 +377,110 @@ export const zChildSessionRef = z.object({
     project: z.string().optional(),
     startTime: z.iso.datetime()
 });
+/**
+ * Collective Evidence Coverage
+ *
+ * Available saved evidence or explicitly unknown source ranges
+ */
+export const zCollectiveEvidenceCoverage = z.enum(['available', 'unknown']);
+/**
+ * Collective Fetch Commit
+ *
+ * Committed effect, including earlier commits before cancellation
+ */
+export const zCollectiveFetchCommit = z.enum([
+    'updated',
+    'unchanged',
+    'retained'
+]);
+/**
+ * Collective Fetch Domain
+ *
+ * Independently installed complete metadata dataset
+ */
+export const zCollectiveFetchDomain = z.enum([
+    'catalog',
+    'history',
+    'associations'
+]);
+/**
+ * Collective Fetch Outcome
+ *
+ * Complete only when every requested required scope completed
+ */
+export const zCollectiveFetchOutcome = z.enum([
+    'complete',
+    'partial',
+    'failed'
+]);
+/**
+ * Collective Fetch State
+ *
+ * One invocation result; a failed domain retains prior completed dates
+ */
+export const zCollectiveFetchState = z.enum([
+    'complete',
+    'failed',
+    'cancelled',
+    'superseded',
+    'not_requested'
+]);
+/**
+ * Collective Observation Reason
+ *
+ * Independent dated relevance reason, not authority
+ */
+export const zCollectiveObservationReason = z.enum([
+    'membership',
+    'contribution',
+    'organization',
+    'explicit'
+]);
+/**
+ * Collective Observation Source
+ *
+ * Narrow metadata source, no world directory or transcript content
+ */
+export const zCollectiveObservationSource = z.enum([
+    'membership',
+    'contribution-discovery',
+    'organization',
+    'explicit',
+    'submissions',
+    'attempts',
+    'associations'
+]);
+/**
+ * Collective Observation State
+ *
+ * Dated disclosure state, never current authorization
+ */
+export const zCollectiveObservationState = z.enum([
+    'observed',
+    'unavailable',
+    'invalidated'
+]);
+/**
+ * Collective Operation
+ *
+ * Operation whose actual outcome is recorded
+ */
+export const zCollectiveOperation = z.enum([
+    'publish',
+    'share',
+    'fetch',
+    'pull'
+]);
+/**
+ * Collective Source Outcome
+ *
+ * Privacy-safe source outcome without hidden reasons
+ */
+export const zCollectiveSourceOutcome = z.enum([
+    'disclosed',
+    'not_disclosed',
+    'failed'
+]);
 export const zCommandInvocation = z.object({
     args: z.string().optional(),
     name: z.string()
@@ -436,6 +541,11 @@ export const zContentOwnership = z.enum([
     'uncertain'
 ]);
 export const zContractVersion = z.string().nullable();
+/**
+ * Opaque versioned selected-category traversal token; not cacheRevision or authority
+ */
+export const zContributionTraversalRevision = z.string().max(4096).superRefine((value, ctx) => { const issue = collectiveContractIssue("ContributionTraversalRevision", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
 export const zCreateAnnotationRequest = z.object({
     annotatorName: z.string().optional(),
     confidence: z.number().nullish(),
@@ -731,6 +841,28 @@ export const zLocalCollectiveSuggestion = z.object({
     match: z.string(),
     reason: zLocalCollectiveSuggestionReason
 });
+/**
+ * Confirmed Contribution Outcome
+ *
+ * Actual request effect, never collective approval
+ */
+export const zLocalConfirmedContributionOutcome = z.enum(['published', 'submitted']);
+/**
+ * Local Contribution Evidence Kind
+ *
+ * One independently bounded evidence category
+ */
+export const zLocalContributionEvidenceKind = z.enum([
+    'remote-attempts',
+    'receipts',
+    'operation-diagnostics'
+]);
+/**
+ * Local Operation Diagnostic Outcome
+ *
+ * Failure or uncertain remote effect, never successful contribution
+ */
+export const zLocalOperationDiagnosticOutcome = z.enum(['failed', 'uncertain']);
 export const zLocalPublicationAttemptFailure = z.object({
     attemptedAt: z.iso.datetime(),
     message: z.string()
@@ -784,6 +916,17 @@ export const zLocalSettingUpdateRequest = z.object({
     key: z.string().min(1),
     value: zLocalSettingValue
 }).strict();
+/**
+ * Local Sync Publication Filter
+ *
+ * Root publication filter; auto uses the canonical live hook decision
+ */
+export const zLocalSyncPublicationFilter = z.enum([
+    'all',
+    'not-published',
+    'published',
+    'auto'
+]);
 export const zMapEdge = z.object({
     count: z.int(),
     from: z.string(),
@@ -885,6 +1028,46 @@ export const zNativePiMessageRole = z.enum(['toolResult']);
  * Exact UTF-8 model identifier observed on an assistant-generated turn; producer-enforced as assistant or subagent evidence. Values are non-empty and may not have a Unicode White_Space code point at either edge; all accepted bytes, including Unicode, mixed case, slashes, and internal spaces, are preserved.
  */
 export const zObservedModelID = z.string().min(1).regex(/^(?:|[^\s])(?:[\s\S]*(?:|[^\s]))?$/).refine((value) => { const edge = (text) => text === "\uFEFF" || (!/\s/u.test(text) && text !== "\u0085"); return edge(value.charAt(0)) && edge(value.charAt(value.length - 1)); }, { error: "ObservedModelID must match pattern without edge whitespace" });
+/**
+ * Operation Issue Code
+ *
+ * Bounded failure category; retry is corrective text only
+ */
+export const zOperationIssueCode = z.enum([
+    'auth',
+    'remote',
+    'contract',
+    'deadline',
+    'persistence',
+    'superseded'
+]);
+export const zOperationIssue = z.object({
+    code: zOperationIssueCode,
+    message: z.string().min(1).max(2048),
+    operation: zCollectiveOperation,
+    retry: z.string().min(1).max(2048)
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("OperationIssue", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
+export const zCollectiveFetchDomainSummary = z.object({
+    coverage: zCollectiveEvidenceCoverage,
+    issue: zOperationIssue.nullish(),
+    lastAttemptAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
+    lastCompletedAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
+    lastInstalledRevision: z.string().nullish(),
+    state: zCollectiveFetchState
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("CollectiveFetchDomainSummary", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
+export const zCollectiveFetchSourceResult = z.object({
+    complete: z.boolean(),
+    issue: zOperationIssue.nullish(),
+    observedAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
+    outcome: zCollectiveSourceOutcome,
+    source: zCollectiveObservationSource
+});
+export const zLocalContributionTraversalConflict = z.object({
+    currentTraversalRevision: zContributionTraversalRevision,
+    issue: zOperationIssue
+});
 /**
  * Omitted preserves, null requests clear, and a canonical license replaces
  */
@@ -893,6 +1076,12 @@ export const zOwnerUpdateLicenseIntent = z.enum([
     'CC-BY-4.0',
     'CC-BY-SA-4.0'
 ]).nullable();
+/**
+ * Page Token
+ *
+ * Opaque continuation; empty starts traversal or marks its end. Not a credential or snapshot token.
+ */
+export const zPageToken = z.string();
 /**
  * Project Hash
  *
@@ -904,6 +1093,13 @@ export const zAuthoritativeProjectContext = z.object({
     hash: zProjectHash,
     name: z.string()
 }).strict();
+export const zLocalSyncProjectOption = z.object({
+    projectHash: zProjectHash,
+    projectName: z.string()
+});
+export const zLocalSyncProjectOptions = z.object({
+    projects: z.array(zLocalSyncProjectOption)
+});
 export const zProjectContext = z.object({
     filePath: z.string().optional(),
     hash: zProjectHash,
@@ -1054,6 +1250,23 @@ export const zPublishAssociationOperation = z.object({
         prior = key;
     }
 });
+/**
+ * Pull Association Metadata State
+ *
+ * Optional metadata result, independent of required content success
+ */
+export const zPullAssociationMetadataState = z.enum([
+    'observed',
+    'stale',
+    'unknown',
+    'invalidated'
+]);
+export const zPullAssociationMetadataResult = z.object({
+    observedAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
+    state: zPullAssociationMetadataState,
+    warning: zOperationIssue.nullish()
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("PullAssociationMetadataResult", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
 /**
  * Read Attribution State
  *
@@ -2284,6 +2497,36 @@ export const zCanonicalPublishOperation = z.object({
  * 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 zCollectiveFetchAssociationScopeResult = z.object({
+    commit: zCollectiveFetchCommit,
+    completedAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
+    issue: zOperationIssue.nullish(),
+    observedAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
+    state: zCollectiveFetchState,
+    transcriptId: zTranscriptID
+});
+export const zCollectiveFetchAssociationResults = z.object({
+    completed: z.int().gte(0).lte(10000),
+    failed: z.int().gte(0).lte(10000),
+    requested: z.int().gte(0).lte(10000),
+    scopes: z.array(zCollectiveFetchAssociationScopeResult).max(10000)
+});
+export const zCollectiveFetchDomainResult = z.object({
+    associations: zCollectiveFetchAssociationResults.nullish(),
+    commit: zCollectiveFetchCommit,
+    completedAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
+    coverage: zCollectiveEvidenceCoverage,
+    domain: zCollectiveFetchDomain,
+    issue: zOperationIssue.nullish(),
+    lastAttemptAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
+    lastCompletedAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
+    lastInstalledRevision: z.string().nullish(),
+    requested: z.boolean(),
+    sourceOutcomes: z.array(zCollectiveFetchSourceResult).max(10000),
+    startedAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
+    state: zCollectiveFetchState
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("CollectiveFetchDomainResult", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
 export const zPromptDigestItem = z.object({
     additions: z.int().nullish(),
     args: z.string().optional(),
@@ -2653,7 +2896,7 @@ export const zTaxonomyNode = z.object({
  *
  * Collective roles an owner may assign through the member role endpoint
  */
-export const zVillageAssignableGroupRole = z.enum(['contributor', 'member']);
+export const zVillageAssignableCollectiveRole = z.enum(['contributor', 'member']);
 export const zVillageAvailableRepository = z.object({
     is_private: z.boolean(),
     name: z.string(),
@@ -2672,36 +2915,12 @@ export const zVillageBatchShareRequest = z.object({
     transcript_ids: z.array(zTranscriptID).optional(),
     visibility_confirmed: z.boolean()
 });
-/**
- * Village Contribution Status
- *
- * Status assigned when a new collective contribution is opened
- */
-export const zVillageContributionStatus = z.enum(['approved', 'pending']);
-export const zVillageBatchShareEntry = z.object({
-    status: zVillageContributionStatus,
-    transcript_id: zTranscriptID
-});
-export const zVillageBatchShareResponse = z.object({
-    already_shared: z.array(zTranscriptID),
-    project_hash: zProjectHash,
-    shared: z.array(zVillageBatchShareEntry)
-});
-export const zVillageErrorResponse = z.object({
-    error: z.string()
-});
-/**
- * GitHub Webhook Payload
- *
- * GitHub event payload forwarded verbatim; validated by the X-Hub-Signature-256 HMAC over the raw body, never by shape
- */
-export const zVillageGitHubWebhookPayload = z.record(z.string(), z.unknown());
 /**
  * Village Group Acceptance Mode
  *
  * How a collective accepts new members and contributions
  */
-export const zVillageGroupAcceptanceMode = z.enum([
+export const zVillageCollectiveAcceptanceMode = z.enum([
     'open',
     'verified_only',
     'curated'
@@ -2711,25 +2930,18 @@ export const zVillageGroupAcceptanceMode = z.enum([
  *
  * Who may read a collective's pooled transcript data
  */
-export const zVillageGroupDataAccess = z.enum([
+export const zVillageCollectiveDataAccess = z.enum([
     'members_only',
     'contributors',
     'public'
 ]);
-export const zVillageCreateGroupRequest = z.object({
-    acceptance_mode: zVillageGroupAcceptanceMode.optional(),
-    data_access: zVillageGroupDataAccess.optional(),
-    description: z.string().optional(),
-    linked_github_org: z.string().nullish(),
-    name: z.string()
-});
-export const zVillageGroupMemberRoleRequest = z.object({
-    role: zVillageAssignableGroupRole
+export const zVillageCollectiveMemberRoleRequest = z.object({
+    role: zVillageAssignableCollectiveRole
 });
-export const zVillageGroupMemberUsernameRequest = z.object({
+export const zVillageCollectiveMemberUsernameRequest = z.object({
     username: z.string()
 });
-export const zVillageGroupModelBreakdown = z.object({
+export const zVillageCollectiveModelBreakdown = z.object({
     model_provider: z.string(),
     transcript_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' })
 });
@@ -2738,17 +2950,17 @@ export const zVillageGroupModelBreakdown = z.object({
  *
  * A user's role in one collective
  */
-export const zVillageGroupRole = z.enum([
+export const zVillageCollectiveRole = z.enum([
     'owner',
     'member',
     'contributor',
     'pending'
 ]);
-export const zVillageGroupStatusRoleResponse = z.object({
-    role: zVillageGroupRole,
+export const zVillageCollectiveStatusRoleResponse = z.object({
+    role: zVillageCollectiveRole,
     status: z.string()
 });
-export const zVillageGroupTranscriptStats = z.object({
+export const zVillageCollectiveTranscriptStats = 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' }),
@@ -2761,13 +2973,44 @@ export const zVillageGroupTranscriptStats = z.object({
  *
  * The caller's role in a collective, or an empty string when the caller has none
  */
-export const zVillageGroupViewerRole = z.enum([
+export const zVillageCollectiveViewerRole = z.enum([
     '',
     'owner',
     'member',
     'contributor',
     'pending'
 ]);
+/**
+ * Village Contribution Status
+ *
+ * Status assigned when a new collective contribution is opened
+ */
+export const zVillageContributionStatus = z.enum(['approved', 'pending']);
+export const zVillageBatchShareEntry = z.object({
+    status: zVillageContributionStatus,
+    transcript_id: zTranscriptID
+});
+export const zVillageBatchShareResponse = z.object({
+    already_shared: z.array(zTranscriptID),
+    project_hash: zProjectHash,
+    shared: z.array(zVillageBatchShareEntry)
+});
+export const zVillageCreateCollectiveRequest = z.object({
+    acceptance_mode: zVillageCollectiveAcceptanceMode.optional(),
+    data_access: zVillageCollectiveDataAccess.optional(),
+    description: z.string().optional(),
+    linked_github_org: z.string().nullish(),
+    name: z.string()
+});
+export const zVillageErrorResponse = z.object({
+    error: z.string()
+});
+/**
+ * GitHub Webhook Payload
+ *
+ * GitHub event payload forwarded verbatim; validated by the X-Hub-Signature-256 HMAC over the raw body, never by shape
+ */
+export const zVillageGitHubWebhookPayload = z.record(z.string(), z.unknown());
 export const zVillageLinkRepositoryRequest = z.object({
     installation_id: z.int().nullish(),
     name: z.string(),
@@ -2837,7 +3080,7 @@ 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({
+export const zVillageRemoveCollectiveMemberResponse = z.object({
     retracted: z.boolean(),
     status: z.string()
 });
@@ -2897,11 +3140,26 @@ export const zVillageShareStatus = z.enum([
     'revoked'
 ]);
 export const zVillageShareEvent = z.object({
-    decided_at: z.iso.datetime().nullable(),
+    decided_at: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullable(),
     decided_by_actor: zVillageShareEventActor,
     event_num: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
-    recorded_at: z.iso.datetime(),
+    recorded_at: z.iso.datetime().refine((value) => new RegExp("^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{1,9})?Z$").test(value) && !new RegExp("^0001-01-01T00:00:00(\\.0+)?Z$").test(value), { message: "Collective timestamp requires nonzero UTC RFC3339 with explicit seconds and at most nine fractional digits; unsupported precision loses evidence, so correct the source timestamp ending in Z before retrying" }).regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/),
     status: zVillageShareStatus
+}).superRefine((value, ctx) => {
+    const fail = (message) => ctx.addIssue({ code: "custom", message: "Collective contribution attempt validation failed: " + message + "; retain prior evidence and fetch validated owner history before retrying" });
+    const actors = { pending: "", approved: "moderator", rejected: "moderator", retracted: "owner", revoked: "collective" };
+    if (value.event_num < 1)
+        fail("event_num must be a positive int32 ordinal");
+    if (value.recorded_at === "0001-01-01T00:00:00Z" || /^0001-01-01T00:00:00\.0+Z$/.test(value.recorded_at))
+        fail("recorded_at must be a nonzero UTC timestamp");
+    if (value.decided_by_actor !== actors[value.status])
+        fail("decided_by_actor does not match the status's actor capacity");
+    if (value.status === "pending" && value.decided_at !== null)
+        fail("pending attempts must have null decided_at");
+    if (value.status !== "pending" && value.status !== "approved" && value.decided_at === null)
+        fail("this terminal status requires decided_at");
+    if (value.decided_at !== null && (value.decided_at === "0001-01-01T00:00:00Z" || /^0001-01-01T00:00:00\.0+Z$/.test(value.decided_at)))
+        fail("decided_at must be a nonzero UTC timestamp when present");
 });
 export const zVillageStatusResponse = z.object({
     status: z.string()
@@ -2987,6 +3245,71 @@ export const zAutoPublishRuleRequest = z.object({
         context.addIssue({ code: "custom", message: "name exactly one session or explicit pattern target" });
     }
 });
+export const zCollectiveObservation = z.object({
+    acceptanceMode: zVillageCollectiveAcceptanceMode.nullish(),
+    dataAccess: zVillageCollectiveDataAccess.nullish(),
+    description: z.string().nullish(),
+    id: zVillageUUID,
+    name: z.string(),
+    observedAt: z.iso.datetime().refine((value) => new RegExp("^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{1,9})?Z$").test(value) && !new RegExp("^0001-01-01T00:00:00(\\.0+)?Z$").test(value), { message: "Collective timestamp requires nonzero UTC RFC3339 with explicit seconds and at most nine fractional digits; unsupported precision loses evidence, so correct the source timestamp ending in Z before retrying" }).regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/),
+    reasons: z.array(zCollectiveObservationReason).max(4),
+    state: zCollectiveObservationState
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("CollectiveObservation", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
+export const zCollectiveObservationScope = z.object({
+    userId: zVillageUUID,
+    villageUrl: z.string().max(1024)
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("CollectiveObservationScope", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
+export const zCollectiveFetchReport = z.object({
+    cacheRevision: z.string().regex(/^(0|[1-9][0-9]{0,19})$/),
+    domains: z.tuple([
+        zCollectiveFetchDomainResult,
+        zCollectiveFetchDomainResult,
+        zCollectiveFetchDomainResult
+    ]),
+    invocationId: zVillageUUID,
+    issues: z.array(zOperationIssue).max(10000),
+    outcome: zCollectiveFetchOutcome,
+    scope: zCollectiveObservationScope
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("CollectiveFetchReport", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
+export const zCollectiveFetchSummary = z.object({
+    associations: zCollectiveFetchDomainSummary,
+    catalog: zCollectiveFetchDomainSummary,
+    history: zCollectiveFetchDomainSummary,
+    lastAttemptAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
+    lastCompletedFetchAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
+    latestReport: zCollectiveFetchReport.nullish()
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("CollectiveFetchSummary", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
+export const zCollectiveObservationResponse = z.object({
+    cacheRevision: z.string().regex(/^(0|[1-9][0-9]{0,19})$/),
+    collectives: z.array(zCollectiveObservation).max(10000),
+    fetch: zCollectiveFetchSummary,
+    scope: zCollectiveObservationScope
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("CollectiveObservationResponse", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
+export const zLocalConfirmedContributionReceipt = z.object({
+    collectiveId: zVillageUUID.nullish(),
+    confirmedAt: z.iso.datetime().refine((value) => new RegExp("^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{1,9})?Z$").test(value) && !new RegExp("^0001-01-01T00:00:00(\\.0+)?Z$").test(value), { message: "Collective timestamp requires nonzero UTC RFC3339 with explicit seconds and at most nine fractional digits; unsupported precision loses evidence, so correct the source timestamp ending in Z before retrying" }).regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/),
+    operation: zCollectiveOperation,
+    outcome: zLocalConfirmedContributionOutcome,
+    receiptId: z.string().min(1).max(256),
+    sourceReceiptId: z.string().max(256).nullish(),
+    transcriptId: zTranscriptID
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("LocalConfirmedContributionReceipt", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
+export const zLocalOperationDiagnostic = z.object({
+    attemptedAt: z.iso.datetime().refine((value) => new RegExp("^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{1,9})?Z$").test(value) && !new RegExp("^0001-01-01T00:00:00(\\.0+)?Z$").test(value), { message: "Collective timestamp requires nonzero UTC RFC3339 with explicit seconds and at most nine fractional digits; unsupported precision loses evidence, so correct the source timestamp ending in Z before retrying" }).regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/),
+    collectiveId: zVillageUUID.nullish(),
+    issue: zOperationIssue,
+    operation: zCollectiveOperation,
+    operationId: zVillageUUID,
+    outcome: zLocalOperationDiagnosticOutcome,
+    transcriptId: zTranscriptID.nullish()
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("LocalOperationDiagnostic", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
 export const zLocalPublicationAudienceMember = z.object({
     collectiveId: zVillageUUID,
     name: z.string(),
@@ -3006,10 +3329,64 @@ export const zLocalPublication = z.object({
 export const zLocalPublicationsResponse = z.object({
     publications: z.array(zLocalPublication)
 });
+export const zLocalRemoteContributionAttempt = z.object({
+    attempt: zVillageShareEvent,
+    collectiveId: zVillageUUID,
+    firstSeenAt: z.iso.datetime().refine((value) => new RegExp("^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{1,9})?Z$").test(value) && !new RegExp("^0001-01-01T00:00:00(\\.0+)?Z$").test(value), { message: "Collective timestamp requires nonzero UTC RFC3339 with explicit seconds and at most nine fractional digits; unsupported precision loses evidence, so correct the source timestamp ending in Z before retrying" }).regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/),
+    transcriptId: zTranscriptID
+}).superRefine((value, ctx) => {
+    const fail = (message) => ctx.addIssue({ code: "custom", message: "Collective contribution attempt validation failed: " + message + "; retain prior evidence and fetch validated owner history before retrying" });
+    if (value.firstSeenAt === "0001-01-01T00:00:00Z" || /^0001-01-01T00:00:00\.0+Z$/.test(value.firstSeenAt))
+        fail("firstSeenAt must be a nonzero UTC timestamp");
+});
+export const zLocalContributionHistoryResponse = z.union([
+    z.strictObject({
+        coverage: zCollectiveEvidenceCoverage,
+        kind: z.literal('remote-attempts'),
+        limit: z.int().gte(1).lte(200),
+        page: z.int().gte(1).lte(9007199254740991),
+        remoteAttempts: z.array(zLocalRemoteContributionAttempt).max(200),
+        scope: zCollectiveObservationScope,
+        total: z.int().gte(0).lte(9007199254740991),
+        traversalRevision: zContributionTraversalRevision
+    }),
+    z.strictObject({
+        coverage: zCollectiveEvidenceCoverage,
+        kind: z.literal('receipts'),
+        limit: z.int().gte(1).lte(200),
+        page: z.int().gte(1).lte(9007199254740991),
+        receipts: z.array(zLocalConfirmedContributionReceipt).max(200),
+        scope: zCollectiveObservationScope,
+        total: z.int().gte(0).lte(9007199254740991),
+        traversalRevision: zContributionTraversalRevision
+    }),
+    z.strictObject({
+        coverage: zCollectiveEvidenceCoverage,
+        kind: z.literal('operation-diagnostics'),
+        limit: z.int().gte(1).lte(200),
+        operationDiagnostics: z.array(zLocalOperationDiagnostic).max(200),
+        page: z.int().gte(1).lte(9007199254740991),
+        scope: zCollectiveObservationScope,
+        total: z.int().gte(0).lte(9007199254740991),
+        traversalRevision: zContributionTraversalRevision
+    })
+]).superRefine((value, ctx) => { const issue = collectiveContractIssue("LocalContributionHistoryResponse", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
 export const zLocalSettingsResponse = z.object({
     autoPublish: z.array(zAutoPublishRule),
     settings: z.array(zLocalSetting)
 });
+export const zLocalSyncSessionRow = z.object({
+    childCount: z.int().gte(0),
+    preview: z.string(),
+    publication: zLocalPublication,
+    sync: zLocalSyncSummary,
+    title: z.string()
+});
+export const zLocalSyncSessionPage = z.object({
+    items: z.array(zLocalSyncSessionRow),
+    next: z.string()
+});
 export const zSyncPushCollectives = z.object({
     add: z.array(zVillageUUID).optional(),
     remove: z.array(zVillageUUID).optional()
@@ -3041,55 +3418,11 @@ export const zSyncPushResponse = z.object({
     skipped: z.int().gte(0),
     updated: z.int().gte(0)
 });
-export const zVillageCollectiveSearchResult = z.object({
-    description: z.string().nullable(),
-    id: zVillageUUID,
-    linked_github_org: z.string().nullable(),
-    member_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
-    name: z.string(),
-    transcript_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' })
-});
-export const zVillageCollectiveSearchResponse = z.object({
-    collectives: z.array(zVillageCollectiveSearchResult)
-});
-export const zVillageCollectiveSubmission = z.object({
-    event_num: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
-    group_id: zVillageUUID,
-    recorded_at: z.iso.datetime(),
-    status: zVillageShareStatus,
-    title: z.string().nullable(),
-    transcript_id: zTranscriptID
-});
-export const zVillageContributableResponse = z.object({
-    group_id: zVillageUUID,
-    transcripts: z.array(zVillageContributableTranscript)
-});
-export const zVillageContributedCollective = z.object({
-    approved_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
-    description: z.string().nullable(),
-    id: zVillageUUID,
-    linked_github_org: z.string().nullable(),
-    name: z.string(),
-    pending_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
-    rejected_attempt_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
-    withdrawn_attempt_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' })
-});
-export const zVillageContributedCollectivesResponse = z.object({
-    collectives: z.array(zVillageContributedCollective)
-});
-export const zVillageEnrichedTranscriptShare = z.object({
-    acceptance_mode: zVillageGroupAcceptanceMode,
-    group_id: zVillageUUID,
-    group_name: z.string(),
-    shared_at: z.iso.datetime(),
-    status: zVillageShareStatus,
-    transcript_id: zTranscriptID
-});
-export const zVillageGroup = z.object({
-    acceptance_mode: zVillageGroupAcceptanceMode,
+export const zVillageCollective = z.object({
+    acceptance_mode: zVillageCollectiveAcceptanceMode,
     created_at: z.iso.datetime(),
     created_by: zVillageUUID,
-    data_access: zVillageGroupDataAccess,
+    data_access: zVillageCollectiveDataAccess,
     description: z.string().nullable(),
     display_members: z.boolean(),
     id: zVillageUUID,
@@ -3100,17 +3433,17 @@ export const zVillageGroup = z.object({
     transcript_deletion_policy: zVillageTranscriptDeletionPolicy,
     updated_at: z.iso.datetime()
 });
-export const zVillageGroupContributor = z.object({
+export const zVillageCollectiveContributor = z.object({
     avatar_url: z.string().nullable(),
     github_username: z.string(),
     id: zVillageUUID,
     transcript_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' })
 });
-export const zVillageGroupDetailRecord = z.object({
-    acceptance_mode: zVillageGroupAcceptanceMode,
+export const zVillageCollectiveDetailRecord = z.object({
+    acceptance_mode: zVillageCollectiveAcceptanceMode,
     created_at: z.iso.datetime(),
     created_by: zVillageUUID,
-    data_access: zVillageGroupDataAccess,
+    data_access: zVillageCollectiveDataAccess,
     description: z.string().nullable(),
     display_members: z.boolean(),
     id: zVillageUUID,
@@ -3121,16 +3454,35 @@ export const zVillageGroupDetailRecord = z.object({
     transcript_deletion_policy: zVillageTranscriptDeletionPolicy,
     updated_at: z.iso.datetime()
 });
-export const zVillageGroupMember = z.object({
+export const zVillageCollectiveMember = z.object({
     avatar_url: z.string().nullable(),
     display_name: z.string().nullable(),
     github_orgs: z.array(z.string()),
     github_username: z.string(),
     id: zVillageUUID,
     joined_at: z.iso.datetime(),
-    role: zVillageGroupRole
+    role: zVillageCollectiveRole
+});
+export const zVillageCollectiveSearchResult = z.object({
+    description: z.string().nullable(),
+    id: zVillageUUID,
+    linked_github_org: z.string().nullable(),
+    member_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
+    name: z.string(),
+    transcript_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' })
+});
+export const zVillageCollectiveSearchResponse = z.object({
+    collectives: z.array(zVillageCollectiveSearchResult)
 });
-export const zVillageGroupTranscript = z.object({
+export const zVillageCollectiveSubmission = z.object({
+    event_num: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
+    group_id: zVillageUUID,
+    recorded_at: z.iso.datetime(),
+    status: zVillageShareStatus,
+    title: z.string().nullable(),
+    transcript_id: zTranscriptID
+});
+export const zVillageCollectiveTranscript = z.object({
     blob_size_bytes: z.int().nullable(),
     compute_version: z.int().nullable(),
     computed_at: z.iso.datetime().nullable(),
@@ -3205,16 +3557,42 @@ export const zVillageGroupTranscript = z.object({
     visibility: zVillageTranscriptVisibility,
     within_session_reverts: z.int().nullable()
 });
-export const zVillageGroupDetailResponse = z.object({
+export const zVillageCollectiveDetailResponse = z.object({
     can_read: z.boolean(),
-    contributors: z.array(zVillageGroupContributor),
-    group: zVillageGroupDetailRecord,
-    members: z.array(zVillageGroupMember),
-    models: z.array(zVillageGroupModelBreakdown),
-    pending_members: z.array(zVillageGroupMember).optional(),
-    stats: zVillageGroupTranscriptStats,
-    transcripts: z.array(zVillageGroupTranscript),
-    your_role: zVillageGroupViewerRole
+    contributors: z.array(zVillageCollectiveContributor),
+    group: zVillageCollectiveDetailRecord,
+    members: z.array(zVillageCollectiveMember),
+    models: z.array(zVillageCollectiveModelBreakdown),
+    pending_members: z.array(zVillageCollectiveMember).optional(),
+    stats: zVillageCollectiveTranscriptStats,
+    transcripts: z.array(zVillageCollectiveTranscript),
+    your_role: zVillageCollectiveViewerRole
+});
+export const zVillageContributableResponse = z.object({
+    group_id: zVillageUUID,
+    transcripts: z.array(zVillageContributableTranscript)
+});
+export const zVillageContributedCollective = z.object({
+    approved_count: z.int().gte(0).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
+    description: z.string().nullable(),
+    id: zVillageUUID,
+    linked_github_org: z.string().nullable(),
+    name: z.string(),
+    pending_count: z.int().gte(0).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
+    rejected_attempt_count: z.int().gte(0).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
+    withdrawn_attempt_count: z.int().gte(0).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' })
+});
+export const zVillageContributedCollectivesResponse = z.object({
+    collectives: z.array(zVillageContributedCollective)
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("VillageContributedCollectivesResponse", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
+export const zVillageEnrichedTranscriptShare = z.object({
+    acceptance_mode: zVillageCollectiveAcceptanceMode,
+    group_id: zVillageUUID,
+    group_name: z.string(),
+    shared_at: z.iso.datetime(),
+    status: zVillageShareStatus,
+    transcript_id: zTranscriptID
 });
 export const zVillageLinkedRepository = z.object({
     created_at: z.iso.datetime().nullable(),
@@ -3235,6 +3613,17 @@ export const zVillageListUserOrganization = z.object({
     org_login: z.string(),
     user_id: zVillageUUID
 });
+export const zVillageOrganizationCollective = z.object({
+    description: z.string().nullable(),
+    id: zVillageUUID,
+    member_count: z.int().gte(0).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
+    name: z.string(),
+    transcript_count: z.int().gte(0).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' })
+});
+export const zVillageOrganizationCollectivesResponse = z.object({
+    collectives: z.array(zVillageOrganizationCollective)
+}).superRefine((value, ctx) => { const issue = collectiveContractIssue("VillageOrganizationCollectivesResponse", value); if (issue !== undefined)
+    ctx.addIssue({ code: "custom", message: "Collective contract validation: " + issue + "; retain prior evidence and fetch validated metadata before retrying" }); });
 export const zVillagePendingShare = z.object({
     branch: z.string().nullable(),
     input_submission_count: z.int().gte(0).lte(9007199254740991).optional(),
@@ -3253,10 +3642,10 @@ export const zVillagePendingShare = z.object({
     title: z.string().nullable(),
     transcript_id: zTranscriptID
 });
-export const zVillagePublicGroup = z.object({
-    acceptance_mode: zVillageGroupAcceptanceMode,
+export const zVillagePublicCollective = z.object({
+    acceptance_mode: zVillageCollectiveAcceptanceMode,
     created_at: z.iso.datetime(),
-    data_access: zVillageGroupDataAccess,
+    data_access: zVillageCollectiveDataAccess,
     description: z.string().nullable(),
     id: zVillageUUID,
     linked_github_org: z.string().nullable(),
@@ -3392,9 +3781,9 @@ export const zVillageTranscriptShare = z.object({
     group_name: z.string(),
     shared_at: z.iso.datetime()
 });
-export const zVillageUpdateGroupRequest = z.object({
-    acceptance_mode: zVillageGroupAcceptanceMode.optional(),
-    data_access: zVillageGroupDataAccess.optional(),
+export const zVillageUpdateCollectiveRequest = z.object({
+    acceptance_mode: zVillageCollectiveAcceptanceMode.optional(),
+    data_access: zVillageCollectiveDataAccess.optional(),
     description: z.string().optional(),
     display_members: z.boolean().nullish(),
     linked_github_org: z.string().nullish(),
@@ -3447,11 +3836,11 @@ export const zVillageTranscriptMetadataResponse = z.object({
     tags: z.array(zVillageTag),
     transcript: zVillageTranscript
 });
-export const zVillageUserGroup = z.object({
-    acceptance_mode: zVillageGroupAcceptanceMode,
+export const zVillageUserCollective = z.object({
+    acceptance_mode: zVillageCollectiveAcceptanceMode,
     created_at: z.iso.datetime(),
     created_by: zVillageUUID,
-    data_access: zVillageGroupDataAccess,
+    data_access: zVillageCollectiveDataAccess,
     description: z.string().nullable(),
     display_members: z.boolean(),
     id: zVillageUUID,
@@ -3459,19 +3848,19 @@ export const zVillageUserGroup = z.object({
     member_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
     member_since: z.iso.datetime(),
     name: z.string(),
-    role: zVillageGroupRole,
+    role: zVillageCollectiveRole,
     transcript_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
     transcript_deletion_policy: zVillageTranscriptDeletionPolicy,
     updated_at: z.iso.datetime()
 });
 export const zLocalVillageCollective = z.object({
-    group: zVillageUserGroup,
+    group: zVillageUserCollective,
     suggestion: zLocalCollectiveSuggestion.optional()
 });
 export const zLocalVillageCollectivesResponse = z.object({
     collectives: z.array(zLocalVillageCollective)
 });
-export const zVillageUserGroupShare = z.object({
+export const zVillageUserCollectiveShare = z.object({
     id: zTranscriptID,
     input_submission_count: z.int().gte(0).lte(9007199254740991).optional(),
     local_id: zSessionID,
@@ -3492,9 +3881,9 @@ export const zVillageUserGroupShare = z.object({
     visibility: zVillageTranscriptVisibility
 });
 export const zVillageSessionRow = z.object({
-    collective: zVillageGroupTranscript.nullish(),
+    collective: zVillageCollectiveTranscript.nullish(),
     contributable: zVillageContributableTranscript.nullish(),
-    myShare: zVillageUserGroupShare.nullish(),
+    myShare: zVillageUserCollectiveShare.nullish(),
     pending: zVillagePendingShare.nullish(),
     session: zVillageTranscript
 }).superRefine((value, context) => {
@@ -3580,20 +3969,29 @@ export const zVillageSessionListPayload = z.object({
     page: z.int().gte(1).lte(9007199254740991),
     totalItems: z.int().gte(0).lte(9007199254740991)
 });
-export const zVillageGroupedContributableResponse = z.object({
+/**
+ * Released groupId envelope for GET /api/v1/groups/{id}/contributable during the alias window. Use VillageGroupedContributableResponse on /api/v1/collectives/{id}/contributable.
+ *
+ * @deprecated
+ */
+export const zVillageDeprecatedGroupedContributableResponse = z.object({
     groupId: zVillageUUID,
     transcriptList: zVillageSessionListPayload
 });
-export const zVillageGroupedGroupDetailResponse = z.object({
+export const zVillageGroupedCollectiveDetailResponse = z.object({
     can_read: z.boolean(),
-    contributors: z.array(zVillageGroupContributor),
-    group: zVillageGroupDetailRecord,
-    members: z.array(zVillageGroupMember),
-    models: z.array(zVillageGroupModelBreakdown),
-    pending_members: z.array(zVillageGroupMember).optional(),
-    stats: zVillageGroupTranscriptStats,
+    contributors: z.array(zVillageCollectiveContributor),
+    group: zVillageCollectiveDetailRecord,
+    members: z.array(zVillageCollectiveMember),
+    models: z.array(zVillageCollectiveModelBreakdown),
+    pending_members: z.array(zVillageCollectiveMember).optional(),
+    stats: zVillageCollectiveTranscriptStats,
     transcriptList: zVillageSessionListPayload,
-    your_role: zVillageGroupViewerRole
+    your_role: zVillageCollectiveViewerRole
+});
+export const zVillageGroupedContributableResponse = z.object({
+    group_id: zVillageUUID,
+    transcriptList: zVillageSessionListPayload
 });
 export const zVillageUserSettings = z.object({
     auto_attach_pull_requests: z.boolean(),
@@ -3606,11 +4004,11 @@ export const zVillageUserStats = z.object({
     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,
+export const zVillageVisibleCollective = z.object({
+    acceptance_mode: zVillageCollectiveAcceptanceMode,
     created_at: z.iso.datetime(),
     created_by: zVillageUUID,
-    data_access: zVillageGroupDataAccess,
+    data_access: zVillageCollectiveDataAccess,
     description: z.string().nullable(),
     display_members: z.boolean(),
     id: zVillageUUID,
@@ -3618,7 +4016,7 @@ export const zVillageVisibleGroup = z.object({
     member_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
     member_since: z.iso.datetime().nullable(),
     name: z.string(),
-    role: zVillageGroupRole.nullable(),
+    role: zVillageCollectiveRole.nullable(),
     transcript_count: z.int().min(-2147483648, { error: 'Invalid value: Expected int32 to be >= -2147483648' }).max(2147483647, { error: 'Invalid value: Expected int32 to be <= 2147483647' }),
     transcript_deletion_policy: zVillageTranscriptDeletionPolicy,
     updated_at: z.iso.datetime()