@peasant-labs/schema 0.18.0 → 0.20.0

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

@@ -6,6 +6,17 @@ export const zActivityEdge = z.object({
     taskCount: z.int(),
     to: z.string()
 });
+/**
+ * Actor Origin
+ *
+ * Closed session graph value
+ */
+export const zActorOrigin = z.enum([
+    'operator',
+    'agent_delegate',
+    'harness',
+    'unknown'
+]);
 /**
  * Annotation Axis
  *
@@ -209,6 +220,7 @@ export const zAuthoritativeSessionStats = 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' }),
+    inputSubmissionCount: z.int().gte(0).lte(9007199254740991).optional(),
     subagentCount: z.int(),
     thoughtTokens: z.int().nullish(),
     tokensIn: z.int(),
@@ -354,6 +366,31 @@ export const zContentCapability = z.string();
  * Payload kind carried by a transcript content envelope
  */
 export const zContentKind = z.enum(['session_detail']);
+/**
+ * Content Origin
+ *
+ * Closed session graph value
+ */
+export const zContentOrigin = z.enum([
+    'submitted_input',
+    'harness_context',
+    'agent_output',
+    'agent_communication',
+    'tool_activity',
+    'system_control',
+    'generated_summary',
+    'unknown'
+]);
+/**
+ * Content Ownership
+ *
+ * Closed session graph value
+ */
+export const zContentOwnership = z.enum([
+    'local',
+    'inherited',
+    'uncertain'
+]);
 export const zContractVersion = z.string().nullable();
 export const zCreateAnnotationRequest = z.object({
     annotatorName: z.string().optional(),
@@ -397,6 +434,20 @@ export const zDecayLevel = z.enum([
     'stale',
     'unexplored'
 ]);
+/**
+ * Delivery Origin
+ *
+ * Closed session graph value
+ */
+export const zDeliveryOrigin = z.enum([
+    'session_admission',
+    'guardian_review',
+    'subagent_delivery',
+    'inherited_context',
+    'tool_delivery',
+    'system_lifecycle',
+    'unknown'
+]);
 export const zDiagnosticEntry = z.object({
     errorType: z.string(),
     location: z.string(),
@@ -442,6 +493,12 @@ export const zDigestItemKind = z.enum([
     'skill',
     'commit'
 ]);
+/**
+ * Earlier History State
+ *
+ * Closed session graph value
+ */
+export const zEarlierHistoryState = z.enum(['uncertain_migrated', 'uncertain_unresolved']);
 /**
  * Edge Violation Kind
  *
@@ -467,6 +524,19 @@ export const zEntryType = z.enum([
     'error',
     'result'
 ]);
+/**
+ * Evidence Kind
+ *
+ * Closed session graph value
+ */
+export const zEvidenceKind = z.enum([
+    'native_typed',
+    'lifecycle_typed',
+    'existing_adapter',
+    'retained_last_good',
+    'unknown',
+    'conflict'
+]);
 export const zExchangeCodeRequest = z.object({
     code: z.string(),
     state: z.string()
@@ -546,6 +616,19 @@ export const zHealthResponse = z.object({
  * Sanitized, filesystem-safe identifier derived from git remote; contains only [a-zA-Z0-9._<>-]
  */
 export const zHostSlug = z.string().regex(/^[a-zA-Z0-9._<>-]+$/);
+/**
+ * Input Modality
+ *
+ * Closed session graph value
+ */
+export const zInputModality = z.enum([
+    'none',
+    'text',
+    'media',
+    'user_action',
+    'mixed',
+    'unknown'
+]);
 export const zInsightClassification = z.object({
     category: z.string(),
     cause: z.string(),
@@ -686,25 +769,12 @@ export const zNativeMetadataSourceType = z.enum([
  * Pi message role needed for public metadata validation
  */
 export const zNativePiMessageRole = z.enum(['toolResult']);
-export const zNativeSourceRef = z.object({
-    entryRef: z.string(),
-    messageRole: zNativePiMessageRole.optional(),
-    sourceType: zNativeMetadataSourceType
-});
-export const zNativeMetadataRecord = z.object({
-    attachment: zNativeAttachmentRef.nullish(),
-    customType: z.string().optional(),
-    data: z.unknown(),
-    id: z.string(),
-    kind: zNativeMetadataKind,
-    source: zNativeSourceRef
-});
 /**
  * Observed Model ID
  *
  * 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\x85])(?:[\s\S]*(?:|[^\s\x85]))?(?![\s\S])/);
+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" });
 /**
  * Omitted preserves, null requests clear, and a canonical license replaces
  */
@@ -724,6 +794,23 @@ 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,
@@ -764,6 +851,20 @@ export const zProvenance = z.object({
     method: z.string(),
     version: z.string().optional()
 });
+/**
+ * Public Revision Reference
+ */
+export const zPublicRevisionRef = z.string().min(1).max(96).refine((value) => !/[\uD800-\uDFFF]/u.test(value) && new TextEncoder().encode(value).length <= 96, { error: "PublicRevisionRef is invalid UTF-8 or exceeds 96 bytes" });
+/**
+ * Public Source Anchor Kind
+ *
+ * Closed session graph value
+ */
+export const zPublicSourceAnchorKind = z.enum([
+    'general_source_session',
+    'before_redacted_entry',
+    'through_redacted_entry'
+]);
 /**
  * Publish Operation Kind
  *
@@ -936,6 +1037,39 @@ export const zRedactionInfo = z.object({
     redacted_at_ms: z.int().nullish(),
     rule_set_version: z.string().optional()
 });
+/**
+ * Relationship Navigation Status
+ *
+ * Closed session graph value
+ */
+export const zRelationshipNavigationStatus = z.enum([
+    'resolved',
+    'general_link_only',
+    'known_unavailable',
+    'inaccessible',
+    'unknown',
+    'conflicting'
+]);
+export const zHelperContextSummary = z.object({
+    groupId: z.string(),
+    ownerStatus: zRelationshipNavigationStatus
+}).superRefine((value, context) => {
+    const fail = (reason) => context.addIssue({ code: "custom", message: "schema.zHelperContextSummary during grouped read validation: " + reason });
+    if (value.groupId === "")
+        fail("context groupId must identify its scoped group; refresh the original list");
+});
+/**
+ * Relationship Target State
+ *
+ * Closed session graph value
+ */
+export const zRelationshipTargetState = z.enum([
+    'target_known',
+    'target_known_retained',
+    'explicit_none',
+    'unknown',
+    'conflicting_current_native_evidence'
+]);
 export const zReviewSuggestion = z.object({
     daysSince: z.int(),
     lastEngaged: z.string(),
@@ -1024,11 +1158,6 @@ export const zServerMessage = z.object({
  * Unique session identifier (UUID, agent-{hex}, ses_{id}, sess_{id} (ACP), msg_{id}, or a Strike session 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]+|[0-9]{8}T[0-9]{6}\.[0-9]{9}Z-[A-Z2-7]{26}|[A-Z2-7]{26})$/);
-export const zAuthoritativeSessionIdentity = z.object({
-    parentSessionId: zSessionID.optional(),
-    schemaVersion: z.int(),
-    sessionId: zSessionID
-}).strict();
 export const zAuthoritativeSubagentRef = z.object({
     parentUuid: zSessionID,
     sessionId: zSessionID
@@ -1122,6 +1251,12 @@ export const zSessionInsight = z.object({
     summary: z.string().optional(),
     title: z.string()
 });
+/**
+ * Session List Item Kind
+ *
+ * Closed session graph value
+ */
+export const zSessionListItemKind = z.enum(['transcript', 'context_container']);
 /**
  * Session Origin
  *
@@ -1230,6 +1365,33 @@ export const zQualityMetrics = z.object({
     turnCount: z.int().nullish(),
     withinSessionReverts: z.int().nullish()
 });
+/**
+ * Session Purpose
+ *
+ * Closed session graph value
+ */
+export const zSessionPurpose = z.enum([
+    'interaction',
+    'delegated_work',
+    'helper_review',
+    'unknown'
+]);
+export const zHelperGroupSummary = z.object({
+    groupId: z.string(),
+    helperThreadCount: z.int().gte(0).lte(9007199254740991),
+    memberScope: z.string(),
+    purpose: zSessionPurpose
+}).superRefine((value, context) => {
+    const fail = (reason) => context.addIssue({ code: "custom", message: "schema.zHelperGroupSummary during grouped read validation: " + reason });
+    if (value.groupId === "" || value.memberScope === "" || value.purpose !== "helper_review")
+        fail("groupId/memberScope must identify an immediate helper_review group; refresh the original scoped list");
+});
+/**
+ * Session Relationship Kind
+ *
+ * Closed session graph value
+ */
+export const zSessionRelationshipKind = z.enum(['started_by', 'context_from']);
 export const zSessionScorecard = z.object({
     costTotalUsd: z.number().nullish(),
     m2TokenOutcomeRatio: z.number().nullish(),
@@ -1249,6 +1411,7 @@ 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' }),
+    inputSubmissionCount: z.int().gte(0).lte(9007199254740991).optional(),
     subagentCount: z.int(),
     thoughtTokens: z.int().nullish(),
     tokensIn: z.int(),
@@ -1256,27 +1419,141 @@ export const zSessionStats = z.object({
     toolCallCount: z.int(),
     turnCount: z.int()
 });
+export const zShutdownResponse = z.object({
+    status: z.string()
+});
+/**
+ * Source Entry Reference
+ */
+export const zSourceEntryRef = z.string().min(1).max(96).refine((value) => !/[\uD800-\uDFFF]/u.test(value) && new TextEncoder().encode(value).length <= 96, { error: "SourceEntryRef is invalid UTF-8 or exceeds 96 bytes" });
+export const zNativeSourceRef = z.object({
+    entryRef: zSourceEntryRef,
+    messageRole: zNativePiMessageRole.optional(),
+    sourceType: zNativeMetadataSourceType
+});
+export const zNativeMetadataRecord = z.object({
+    attachment: zNativeAttachmentRef.nullish(),
+    customType: z.string().optional(),
+    data: z.unknown(),
+    id: z.string(),
+    kind: zNativeMetadataKind,
+    source: zNativeSourceRef
+});
+export const zPublicSourceAnchor = z.object({
+    kind: zPublicSourceAnchorKind,
+    sourceEntryRef: zSourceEntryRef.optional(),
+    sourceRevisionRef: zPublicRevisionRef.optional()
+}).strict();
+export const zSessionRelationship = z.object({
+    anchor: zPublicSourceAnchor.optional(),
+    evidence: zEvidenceKind,
+    kind: zSessionRelationshipKind,
+    targetLocalId: zSessionID.optional(),
+    targetState: zRelationshipTargetState
+}).strict();
+export const zAuthoritativeSessionIdentity = z.object({
+    parentSessionId: zSessionID.optional(),
+    purpose: zSessionPurpose.optional(),
+    relationships: z.array(zSessionRelationship).optional(),
+    rootSessionId: zSessionID.optional(),
+    schemaVersion: z.int(),
+    sessionId: zSessionID
+}).strict();
 export const zSessionSummary = z.object({
     durationMins: z.number(),
     harness: zHarness,
     id: z.string(),
+    inputSubmissionCount: z.int().gte(0).lte(9007199254740991).optional(),
     outcome: z.string().optional(),
     parentSessionId: z.string().nullish(),
     preview: z.string().optional(),
     project: z.string().optional(),
     projectHash: zProjectHash.optional(),
+    purpose: zSessionPurpose.optional(),
+    relationships: z.array(zSessionRelationship).optional(),
+    rootSessionId: zSessionID.nullish(),
     sessionOrigin: zSessionOrigin.optional(),
     startTime: z.iso.datetime(),
     toolCallCount: z.int(),
     totalTokens: z.int(),
     turnCount: z.int()
 });
+export const zLocalSessionRow = z.object({
+    matches: z.array(zSearchResult).optional(),
+    session: zSessionSummary,
+    sync: zLocalSyncSummary.nullish()
+}).superRefine((value, context) => {
+    const fail = (reason) => context.addIssue({ code: "custom", message: "schema.zLocalSessionRow during grouped read validation: " + reason });
+    if (value.session.id === "")
+        fail("session.id is empty; provide the saved transcript identity");
+    if (value.sync && value.matches?.length)
+        fail("sync and matches select incompatible route arms; retain the originating route only");
+    if (value.sync) {
+        const s = value.session, v = value.sync;
+        if (v.id !== s.id || v.harness !== s.harness || v.projectName !== s.project || v.projectHash !== s.projectHash || v.totalTokens !== s.totalTokens || v.turnCount !== s.turnCount || v.inputSubmissionCount !== s.inputSubmissionCount)
+            fail("sync identity or count mirrors disagree; derive both from the same row");
+    }
+    if (value.matches?.some(match => match.sessionId !== value.session.id))
+        fail("search match belongs to another session; retain only this transcript's evidence");
+});
+export const zLocalSessionListItem = z.object({
+    context: zHelperContextSummary.nullish(),
+    helperGroups: z.array(zHelperGroupSummary).optional(),
+    kind: zSessionListItemKind,
+    transcript: zLocalSessionRow.nullish()
+}).superRefine((value, context) => {
+    const fail = (reason) => context.addIssue({ code: "custom", message: "schema.zLocalSessionListItem during grouped read validation: " + reason });
+    if ((value.kind === "transcript") !== (value.transcript != null) || (value.kind === "context_container") !== (value.context != null))
+        fail("kind must select exactly one matching transcript/context arm; omit the other arm");
+    const groups = new Set();
+    for (const group of value.helperGroups ?? []) {
+        if (groups.has(group.groupId))
+            fail("duplicate groupId prevents independent paging; emit each immediate group once");
+        groups.add(group.groupId);
+    }
+});
+export const zLocalHelperMembersPayload = z.object({
+    limit: z.int().gte(1).lte(9007199254740991),
+    members: z.array(zLocalSessionListItem.and(z.object({
+        context: z.null().optional(),
+        kind: z.enum(['transcript']).optional(),
+        transcript: zLocalSessionRow
+    }))),
+    page: z.int().gte(1).lte(9007199254740991),
+    total: z.int().gte(0).lte(9007199254740991)
+}).superRefine((value, context) => {
+    const fail = (reason) => context.addIssue({ code: "custom", message: "schema.zLocalHelperMembersPayload during grouped read validation: " + reason });
+    if (value.members.length > value.limit || value.members.length > value.total)
+        fail("member count exceeds page limit or direct total; count direct saved helpers before paging");
+    const ids = new Set();
+    const groups = new Set();
+    for (const member of value.members) {
+        if (member.kind !== "transcript" || member.transcript == null || member.context != null) {
+            fail("members must be transcript items, never context containers; preserve nested groups on the item");
+            continue;
+        }
+        const id = member.transcript.session.id;
+        if (ids.has(id))
+            fail("duplicate member identity would double count a saved helper; emit each transcript once");
+        ids.add(id);
+        for (const group of member.helperGroups ?? []) {
+            if (groups.has(group.groupId))
+                fail("groupId appears under multiple members; emit each immediate-owner group once");
+            groups.add(group.groupId);
+        }
+    }
+});
+export const zLocalSessionListPayload = z.object({
+    helperThreadTotal: z.int().gte(0).lte(9007199254740991),
+    items: z.array(zLocalSessionListItem),
+    limit: z.int().gte(1).lte(9007199254740991),
+    ordinarySessionTotal: z.int().gte(0).lte(9007199254740991),
+    page: z.int().gte(1).lte(9007199254740991),
+    totalItems: z.int().gte(0).lte(9007199254740991)
+});
 export const zSessionsPayload = z.object({
     sessions: z.array(zSessionSummary).nullable()
 });
-export const zShutdownResponse = z.object({
-    status: z.string()
-});
 /**
  * Source Format
  *
@@ -1307,6 +1584,19 @@ 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();
 /**
  * Target Kind
  *
@@ -1652,9 +1942,11 @@ export const zAuthoritativeSessionEntry = z.object({
     parentEntryId: z.string().nullish(),
     parentIndex: z.int().nullish(),
     partType: z.string().nullish(),
+    provenance: zContentProvenance.optional(),
     rawByteLength: z.int().nullish(),
     role: zRole,
     sessionId: zSessionID,
+    sourceEntryRef: zSourceEntryRef.optional(),
     stopReason: zStopReason.nullish(),
     timestampMs: z.int().nullish(),
     tokensIn: z.int().nullish(),
@@ -1692,9 +1984,11 @@ export const zSessionEntry = z.object({
     parentEntryId: z.string().nullish(),
     parentIndex: z.int().nullish(),
     partType: z.string().nullish(),
+    provenance: zContentProvenance.nullish(),
     rawByteLength: z.int().nullish(),
     role: zRole,
     sessionId: zSessionID,
+    sourceEntryRef: zSourceEntryRef.optional(),
     stopReason: zStopReason.nullish(),
     timestampMs: z.int().nullish(),
     tokensIn: z.int().nullish(),
@@ -1738,8 +2032,11 @@ export const zCanonicalPublishOperation = z.object({
  */
 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 zPromptDigestItem = z.object({
+    additions: z.int().nullish(),
     commitCount: z.int().nullish(),
     commitSha: z.string().optional(),
+    deletions: z.int().nullish(),
+    filesChanged: z.int().nullish(),
     kind: zDigestItemKind,
     ordinal: z.int().nullish(),
     promptCount: z.int().nullish(),
@@ -1769,6 +2066,13 @@ export const zPullSkipGateResult = z.object({
 export const zPullSkipGateResponse = z.object({
     results: z.array(zPullSkipGateResult)
 });
+export const zSessionRelationshipNavigation = z.object({
+    anchor: zPublicSourceAnchor.optional(),
+    kind: zSessionRelationshipKind,
+    localId: zSessionID.optional(),
+    status: zRelationshipNavigationStatus,
+    transcriptId: zTranscriptID.optional()
+}).strict();
 /**
  * TranscriptUpdateLicense
  *
@@ -1859,7 +2163,10 @@ export const zUnifiedMetadata = z.object({
     model: zModelID,
     parentUuid: zSessionID.nullable(),
     project: zProjectContext,
+    purpose: zSessionPurpose.optional(),
     redaction: zRedactionInfo,
+    relationships: z.array(zSessionRelationship).optional(),
+    rootSessionId: zSessionID.nullish(),
     schemaVersion: z.int(),
     sessionId: zSessionID,
     source: zSourceInfo,
@@ -1921,12 +2228,13 @@ export const zUsageDetail = z.object({
     cost: zRecordedCostDetail.nullish(),
     ownerId: z.string(),
     scope: zUsageScope,
-    sourceEntryRef: z.string(),
+    sourceEntryRef: zSourceEntryRef,
     tokens: zTokenUsageDetail.nullish()
 });
 export const zToolCallDetail = z.object({
     arguments: z.string(),
-    callEntryRef: z.string().optional(),
+    callEntryRef: zSourceEntryRef.optional(),
+    callProvenance: zContentProvenance.nullish(),
     durationMs: z.int().nullish(),
     exitCode: z.int().nullish(),
     filePath: z.string().optional(),
@@ -1935,7 +2243,8 @@ export const zToolCallDetail = z.object({
     name: z.string(),
     namespace: z.string().optional(),
     result: z.string(),
-    resultEntryRef: z.string().optional(),
+    resultEntryRef: zSourceEntryRef.optional(),
+    resultProvenance: zContentProvenance.nullish(),
     toolKind: zToolCallKind.optional(),
     usage: zUsageDetail.nullish()
 });
@@ -1949,8 +2258,9 @@ export const zTurnDetail = z.object({
     index: z.int(),
     observedModel: zObservedModelID.optional(),
     parentIndex: z.int().nullish(),
+    provenance: zContentProvenance.nullish(),
     role: zRole,
-    sourceEntryRef: z.string().optional(),
+    sourceEntryRef: zSourceEntryRef.optional(),
     stopReason: zStopReason.nullish(),
     timestamp: z.iso.datetime(),
     tokensIn: z.int().nullish(),
@@ -1958,18 +2268,29 @@ export const zTurnDetail = z.object({
     toolCalls: z.array(zToolCallDetail).optional(),
     usage: zUsageDetail.nullish()
 });
+export const zEarlierHistorySection = z.object({
+    nativeMetadata: z.array(zNativeMetadataRecord).optional(),
+    state: zEarlierHistoryState,
+    turns: z.array(zTurnDetail)
+}).strict();
 export const zSessionDetailPayload = z.object({
     childSessions: z.array(zChildSessionRef).optional(),
     durationMins: z.number(),
+    earlierHistory: z.array(zEarlierHistorySection).optional(),
     endTime: z.iso.datetime(),
     gitBranch: z.string().optional(),
     gitRemote: z.string().optional(),
     harness: zHarness,
     id: z.string(),
+    inputSubmissionCount: z.int().gte(0).lte(9007199254740991).optional(),
     model: z.string().optional(),
     nativeMetadata: z.array(zNativeMetadataRecord).optional(),
     outcome: zSessionOutcome.optional(),
+    parentSessionId: zSessionID.nullish(),
     project: z.string().optional(),
+    purpose: zSessionPurpose.optional(),
+    relationships: z.array(zSessionRelationship).optional(),
+    rootSessionId: zSessionID.nullish(),
     schemaVersion: z.string().optional(),
     scorecard: zSessionScorecard.nullish(),
     sessionOrigin: zSessionOrigin.optional(),
@@ -1984,6 +2305,39 @@ export const zSessionDetailPayload = z.object({
     turns: z.array(zTurnDetail).nullable(),
     workingDirectory: z.string().optional()
 });
+export const zSessionDetailReadPayload = z.object({
+    childSessions: z.array(zChildSessionRef).optional(),
+    durationMins: z.number().optional(),
+    earlierHistory: z.array(zEarlierHistorySection).optional(),
+    endTime: z.iso.datetime().optional(),
+    gitBranch: z.string().optional(),
+    gitRemote: z.string().optional(),
+    harness: zHarness.optional(),
+    id: z.string().optional(),
+    inputSubmissionCount: z.int().gte(0).lte(9007199254740991).optional(),
+    model: z.string().optional(),
+    nativeMetadata: z.array(zNativeMetadataRecord).optional(),
+    outcome: zSessionOutcome.optional(),
+    parentSessionId: zSessionID.optional(),
+    project: z.string().optional(),
+    purpose: zSessionPurpose.optional(),
+    relationshipNavigation: z.array(zSessionRelationshipNavigation).optional(),
+    relationships: z.array(zSessionRelationship).optional(),
+    rootSessionId: zSessionID.optional(),
+    schemaVersion: z.string().optional(),
+    scorecard: zSessionScorecard.optional(),
+    sessionOrigin: zSessionOrigin.optional(),
+    source: z.string().optional(),
+    startTime: z.iso.datetime().optional(),
+    status: z.string().optional(),
+    tokensIn: z.int().optional(),
+    tokensOut: z.int().optional(),
+    toolCallCount: z.int().optional(),
+    totalTokens: z.int().optional(),
+    turnCount: z.int().optional(),
+    turns: z.array(zTurnDetail).nullish(),
+    workingDirectory: z.string().optional()
+});
 export const zTranscriptContent = z.object({
     contractVersion: z.string(),
     kind: zContentKind,
@@ -2140,6 +2494,19 @@ export const zVillageLinkRepositoryRequest = z.object({
     name: z.string(),
     owner: z.string()
 });
+export const zVillageListTranscriptAttestation = z.object({
+    attestation_type: z.string(),
+    created_at: z.iso.datetime(),
+    org_login: z.string(),
+    transcript_id: zTranscriptID
+});
+export const zVillageMetadataUserOrganization = z.object({
+    avatar_url: z.string().nullable(),
+    fetched_at: z.iso.datetime(),
+    org_id: 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' }),
+    org_login: z.string(),
+    visible: z.boolean()
+});
 /**
  * Village Project Name Source
  *
@@ -2270,6 +2637,7 @@ export const zVillageContributableTranscript = z.object({
     already_shared: z.boolean(),
     git_branch: z.string().nullable(),
     id: zTranscriptID,
+    input_submission_count: z.int().gte(0).lte(9007199254740991).optional(),
     local_id: zSessionID,
     model_provider: z.string(),
     parent_session_id: zSessionID.nullable(),
@@ -2277,6 +2645,9 @@ export const zVillageContributableTranscript = z.object({
     project_hash: zProjectHash,
     project_name_source: zVillageProjectNameSource,
     published_at: z.iso.datetime(),
+    purpose: zSessionPurpose.optional(),
+    relationships: z.array(zSessionRelationship).optional(),
+    root_session_id: zSessionID.nullish(),
     session_origin: zSessionOrigin,
     title: z.string().nullable(),
     visibility: zVillageTranscriptVisibility
@@ -2330,6 +2701,14 @@ export const zVillageContributedCollective = z.object({
 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,
     created_at: z.iso.datetime(),
@@ -2351,6 +2730,21 @@ export const zVillageGroupContributor = z.object({
     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,
+    created_at: z.iso.datetime(),
+    created_by: zVillageUUID,
+    data_access: zVillageGroupDataAccess,
+    description: z.string().nullable(),
+    display_members: z.boolean(),
+    id: zVillageUUID,
+    linked_github_org: z.string().nullable(),
+    name: z.string(),
+    post_prompts_check: z.boolean().nullish(),
+    prompts_check_mode: zVillagePromptsCheckMode.nullish(),
+    transcript_deletion_policy: zVillageTranscriptDeletionPolicy,
+    updated_at: z.iso.datetime()
+});
 export const zVillageGroupMember = z.object({
     avatar_url: z.string().nullable(),
     display_name: z.string().nullable(),
@@ -2377,6 +2771,7 @@ export const zVillageGroupTranscript = z.object({
     harness_version: z.string().nullable(),
     id: zTranscriptID,
     ingested_at: z.iso.datetime().nullable(),
+    input_submission_count: z.int().gte(0).lte(9007199254740991).optional(),
     license_id: zLicense.nullable(),
     lines_changed: z.int().nullable(),
     local_id: zSessionID,
@@ -2407,8 +2802,11 @@ export const zVillageGroupTranscript = z.object({
     project_name_source: zVillageProjectNameSource,
     project_remote_label: z.string(),
     published_at: z.iso.datetime(),
+    purpose: zSessionPurpose.optional(),
+    relationships: z.array(zSessionRelationship).optional(),
     retry_loops: z.int().nullable(),
     retry_tokens_wasted: z.int().nullable(),
+    root_session_id: zSessionID.nullish(),
     schema_version: z.string(),
     scope_breadth: z.int().nullable(),
     session_end: z.iso.datetime().nullable(),
@@ -2433,7 +2831,7 @@ export const zVillageGroupTranscript = z.object({
 export const zVillageGroupDetailResponse = z.object({
     can_read: z.boolean(),
     contributors: z.array(zVillageGroupContributor),
-    group: zVillageGroup,
+    group: zVillageGroupDetailRecord,
     members: z.array(zVillageGroupMember),
     models: z.array(zVillageGroupModelBreakdown),
     pending_members: z.array(zVillageGroupMember).optional(),
@@ -2455,8 +2853,14 @@ export const zVillageLinkedRepository = z.object({
 export const zVillageLinkedRepositoriesResponse = z.object({
     repositories: z.array(zVillageLinkedRepository)
 });
+export const zVillageListUserOrganization = z.object({
+    avatar_url: z.string().nullable(),
+    org_login: z.string(),
+    user_id: zVillageUUID
+});
 export const zVillagePendingShare = z.object({
     branch: z.string().nullable(),
+    input_submission_count: z.int().gte(0).lte(9007199254740991).optional(),
     local_id: zSessionID,
     model_provider: z.string(),
     owner_id: zVillageUUID,
@@ -2465,6 +2869,9 @@ export const zVillagePendingShare = z.object({
     parent_session_id: zSessionID.nullable(),
     project_hash: zProjectHash,
     project_name: z.string().nullable(),
+    purpose: zSessionPurpose.optional(),
+    relationships: z.array(zSessionRelationship).optional(),
+    root_session_id: zSessionID.nullish(),
     shared_at: z.iso.datetime(),
     title: z.string().nullable(),
     transcript_id: zTranscriptID
@@ -2506,6 +2913,10 @@ export const zVillagePullRequestAttachmentResponse = z.object({
 export const zVillageShareTranscriptRequest = z.object({
     group_ids: z.array(zVillageUUID)
 });
+export const zVillageTag = z.object({
+    id: zVillageUUID,
+    name: z.string()
+});
 export const zVillageTranscript = z.object({
     blob_size_bytes: z.int().nullable(),
     compute_version: z.int().nullable(),
@@ -2523,6 +2934,7 @@ export const zVillageTranscript = z.object({
     harness_version: z.string().nullable(),
     id: zTranscriptID,
     ingested_at: z.iso.datetime().nullable(),
+    input_submission_count: z.int().gte(0).lte(9007199254740991).optional(),
     license_id: zLicense.nullable(),
     lines_changed: z.int().nullable(),
     local_id: zSessionID,
@@ -2550,8 +2962,11 @@ export const zVillageTranscript = z.object({
     project_name_source: zVillageProjectNameSource,
     project_remote_label: z.string(),
     published_at: z.iso.datetime(),
+    purpose: zSessionPurpose.optional(),
+    relationships: z.array(zSessionRelationship).optional(),
     retry_loops: z.int().nullable(),
     retry_tokens_wasted: z.int().nullable(),
+    root_session_id: zSessionID.nullish(),
     schema_version: z.string(),
     scope_breadth: z.int().nullable(),
     session_end: z.iso.datetime().nullable(),
@@ -2573,6 +2988,16 @@ export const zVillageTranscript = z.object({
     visibility: zVillageTranscriptVisibility,
     within_session_reverts: z.int().nullable()
 });
+export const zVillageTranscriptAttestation = z.object({
+    attestation_type: z.string(),
+    attester_avatar: z.string().nullable(),
+    attester_username: z.string(),
+    created_at: z.iso.datetime(),
+    id: zVillageUUID,
+    note: z.string().nullable(),
+    org_login: z.string(),
+    transcript_id: zTranscriptID
+});
 export const zVillageTranscriptCollective = z.object({
     description: z.string().nullable(),
     id: zVillageUUID,
@@ -2602,6 +3027,45 @@ export const zVillageUpdateGroupRequest = z.object({
 export const zVillageUpdateUserSettingsRequest = z.object({
     preview_before_attach: z.boolean().nullish()
 });
+export const zVillageUser = z.object({
+    avatar_url: z.string().nullable(),
+    created_at: z.iso.datetime(),
+    display_name: z.string().nullable(),
+    github_id: 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' }),
+    github_username: z.string(),
+    id: zVillageUUID,
+    is_discoverable: z.boolean(),
+    provider: z.string(),
+    provider_user_id: z.string(),
+    provider_username: z.string().nullable(),
+    updated_at: z.iso.datetime(),
+    username_chosen: z.boolean()
+});
+export const zVillageTranscriptListRow = z.object({
+    attestations: z.array(zVillageListTranscriptAttestation).nullable(),
+    owner: zVillageUser,
+    owner_orgs: z.array(zVillageListUserOrganization).nullable(),
+    shares: z.array(zVillageEnrichedTranscriptShare).nullable(),
+    tags: z.array(zVillageTag),
+    transcript: zVillageTranscript
+});
+export const zVillageTranscriptListResponse = z.object({
+    agent_total: z.int(),
+    limit: z.int(),
+    page: z.int(),
+    total: z.int(),
+    transcripts: z.array(zVillageTranscriptListRow)
+});
+export const zVillageTranscriptMetadataResponse = z.object({
+    attestations: z.array(zVillageTranscriptAttestation),
+    enriched_shares: z.array(zVillageEnrichedTranscriptShare),
+    owner: zVillageUser,
+    owner_orgs: z.array(zVillageMetadataUserOrganization),
+    relationshipNavigation: z.array(zSessionRelationshipNavigation).optional(),
+    shares: z.array(zVillageTranscriptShare),
+    tags: z.array(zVillageTag),
+    transcript: zVillageTranscript
+});
 export const zVillageUserGroup = z.object({
     acceptance_mode: zVillageGroupAcceptanceMode,
     created_at: z.iso.datetime(),
@@ -2621,12 +3085,16 @@ export const zVillageUserGroup = z.object({
 });
 export const zVillageUserGroupShare = z.object({
     id: zTranscriptID,
+    input_submission_count: z.int().gte(0).lte(9007199254740991).optional(),
     local_id: zSessionID,
     model_name: z.string().nullable(),
     model_provider: z.string(),
     owner_id: zVillageUUID,
     parent_session_id: zSessionID.nullable(),
     published_at: z.iso.datetime(),
+    purpose: zSessionPurpose.optional(),
+    relationships: z.array(zSessionRelationship).optional(),
+    root_session_id: zSessionID.nullish(),
     shared_at: z.iso.datetime(),
     status: zVillageShareStatus,
     title: z.string().nullable(),
@@ -2635,6 +3103,110 @@ export const zVillageUserGroupShare = z.object({
     turn_count: z.int().nullable(),
     visibility: zVillageTranscriptVisibility
 });
+export const zVillageSessionRow = z.object({
+    collective: zVillageGroupTranscript.nullish(),
+    contributable: zVillageContributableTranscript.nullish(),
+    myShare: zVillageUserGroupShare.nullish(),
+    pending: zVillagePendingShare.nullish(),
+    session: zVillageTranscript
+}).superRefine((value, context) => {
+    const fail = (reason) => context.addIssue({ code: "custom", message: "schema.zVillageSessionRow during grouped read validation: " + reason });
+    const s = value.session;
+    const arms = [value.collective, value.pending, value.myShare, value.contributable].filter(v => v != null);
+    if (arms.length > 1)
+        fail("multiple route arms supplied; retain the originating route only");
+    const equal = (a, b) => {
+        if (a === b)
+            return true;
+        if (a === null || b === null || typeof a !== "object" || typeof b !== "object")
+            return false;
+        const left = a, right = b;
+        return Object.keys(left).length === Object.keys(right).length && Object.keys(left).every(k => Object.hasOwn(right, k) && equal(left[k], right[k]));
+    };
+    const check = (v, keys, aliases = {}) => {
+        if (v == null)
+            return;
+        const row = v, session = s;
+        for (const key of keys)
+            if (!equal(row[key], session[aliases[key] ?? key]))
+                fail("route identity or metric mirrors disagree; derive both from the same row");
+    };
+    const graph = ["parent_session_id", "root_session_id", "purpose", "relationships", "input_submission_count"];
+    check(value.collective, [...graph, "id", "owner_id", "local_id", "title", "description", "visibility", "model_provider", "model_name", "harness_version", "turn_count", "token_count", "tokens_in", "tokens_out", "duration_ms", "project_hash", "project_name", "project_display_name", "project_name_source", "project_remote_label", "git_branch", "session_origin"]);
+    check(value.pending, [...graph, "transcript_id", "owner_id", "local_id", "title", "model_provider", "project_hash", "project_name", "branch"], { transcript_id: "id", branch: "git_branch" });
+    check(value.myShare, [...graph, "id", "owner_id", "local_id", "title", "visibility", "published_at", "model_provider", "model_name", "turn_count", "tokens_in", "tokens_out"]);
+    check(value.contributable, [...graph, "id", "local_id", "title", "visibility", "model_provider", "project_hash", "project_display_name", "project_name_source", "git_branch", "published_at", "session_origin"]);
+});
+export const zVillageSessionListItem = z.object({
+    context: zHelperContextSummary.nullish(),
+    helperGroups: z.array(zHelperGroupSummary).optional(),
+    kind: zSessionListItemKind,
+    transcript: zVillageSessionRow.nullish()
+}).superRefine((value, context) => {
+    const fail = (reason) => context.addIssue({ code: "custom", message: "schema.zVillageSessionListItem during grouped read validation: " + reason });
+    if ((value.kind === "transcript") !== (value.transcript != null) || (value.kind === "context_container") !== (value.context != null))
+        fail("kind must select exactly one matching transcript/context arm; omit the other arm");
+    const groups = new Set();
+    for (const group of value.helperGroups ?? []) {
+        if (groups.has(group.groupId))
+            fail("duplicate groupId prevents independent paging; emit each immediate group once");
+        groups.add(group.groupId);
+    }
+});
+export const zVillageHelperMembersPayload = z.object({
+    limit: z.int().gte(1).lte(9007199254740991),
+    members: z.array(zVillageSessionListItem.and(z.object({
+        context: z.null().optional(),
+        kind: z.enum(['transcript']).optional(),
+        transcript: zVillageSessionRow
+    }))),
+    page: z.int().gte(1).lte(9007199254740991),
+    total: z.int().gte(0).lte(9007199254740991)
+}).superRefine((value, context) => {
+    const fail = (reason) => context.addIssue({ code: "custom", message: "schema.zVillageHelperMembersPayload during grouped read validation: " + reason });
+    if (value.members.length > value.limit || value.members.length > value.total)
+        fail("member count exceeds page limit or direct total; count direct saved helpers before paging");
+    const ids = new Set();
+    const groups = new Set();
+    for (const member of value.members) {
+        if (member.kind !== "transcript" || member.transcript == null || member.context != null) {
+            fail("members must be transcript items, never context containers; preserve nested groups on the item");
+            continue;
+        }
+        const id = member.transcript.session.id;
+        if (ids.has(id))
+            fail("duplicate member identity would double count a saved helper; emit each transcript once");
+        ids.add(id);
+        for (const group of member.helperGroups ?? []) {
+            if (groups.has(group.groupId))
+                fail("groupId appears under multiple members; emit each immediate-owner group once");
+            groups.add(group.groupId);
+        }
+    }
+});
+export const zVillageSessionListPayload = z.object({
+    helperThreadTotal: z.int().gte(0).lte(9007199254740991),
+    items: z.array(zVillageSessionListItem),
+    limit: z.int().gte(1).lte(9007199254740991),
+    ordinarySessionTotal: z.int().gte(0).lte(9007199254740991),
+    page: z.int().gte(1).lte(9007199254740991),
+    totalItems: z.int().gte(0).lte(9007199254740991)
+});
+export const zVillageGroupedContributableResponse = z.object({
+    groupId: zVillageUUID,
+    transcriptList: zVillageSessionListPayload
+});
+export const zVillageGroupedGroupDetailResponse = 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,
+    transcriptList: zVillageSessionListPayload,
+    your_role: zVillageGroupViewerRole
+});
 export const zVillageUserSettings = z.object({
     preview_before_attach: z.boolean()
 });