@peasant-labs/schema 0.22.0 → 0.24.0

package/dist/internal/generated/session-graph-capability-fixtures.gen.d.ts

@@ -1,11 +1,27 @@
 export declare const canonicalSessionGraphCapabilityFixtures: {
     readonly requiredNames: {
-        readonly derivation: readonly ["legacy-empty", "root-null", "usage-null", "model-only", "source-ref-only", "count-only-zero", "count-only-positive", "root-only", "purpose-only-interaction", "purpose-only-delegated", "purpose-only-helper", "purpose-only-unknown", "relationship-only", "main-deeper-provenance", "folded-call-provenance", "folded-result-provenance", "earlier-only", "earlier-nested-tool-native-usage-model", "navigation-only-read"];
-        readonly reader: readonly ["advertisement-omitted", "advertisement-empty", "advertisement-null", "advertisement-unknown-duplicate-unordered", "advertisement-future-suffix"];
-        readonly producer: readonly ["producer-canonical-four", "producer-unsorted-four", "producer-duplicate", "producer-unknown"];
+        readonly derivation: readonly ["legacy-empty", "root-null", "usage-null", "model-only", "source-ref-only", "count-only-zero", "count-only-positive", "root-only", "purpose-only-interaction", "purpose-only-delegated", "purpose-only-helper", "purpose-only-unknown", "relationship-only", "main-deeper-provenance", "folded-call-provenance", "folded-result-provenance", "earlier-only", "earlier-nested-tool-native-usage-model", "navigation-only-read", "retained-accumulates-all"];
+        readonly reader: readonly ["advertisement-omitted", "advertisement-empty", "advertisement-null", "advertisement-unknown-duplicate-unordered", "advertisement-future-suffix", "advertisement-retained-duplicate"];
+        readonly producer: readonly ["producer-canonical-four", "producer-unsorted-four", "producer-duplicate", "producer-unknown", "producer-canonical-retained", "producer-unsorted-retained", "producer-duplicate-retained"];
     };
     readonly derivation: {
         readonly cases: readonly [{
+            readonly name: "retained-accumulates-all";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "content-capability-negotiation";
+            };
+            readonly mutation: {
+                readonly description: "Retained evidence accumulates every existing preservation requirement";
+            };
+            readonly input: {
+                readonly detailJSON: "{\"id\":\"fixture-session\",\"harness\":\"pi\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":1,\"toolCallCount\":1,\"purpose\":\"interaction\",\"turns\":[{\"index\":0,\"role\":\"assistant\",\"depth\":0,\"content\":\"\",\"timestamp\":\"2020-01-01T00:00:00Z\",\"sourceEntryRef\":\"e1\",\"observedModel\":\"provider/model\",\"usage\":{\"ownerId\":\"u1\",\"sourceEntryRef\":\"e1\",\"scope\":\"assistant\",\"completeness\":\"unknown\"},\"toolCalls\":[{\"id\":\"t1\",\"name\":\"tool\",\"namespace\":\"extension\",\"arguments\":\"\",\"result\":\"\"}]}],\"nativeMetadata\":[{\"id\":\"n1\",\"kind\":\"pi.custom.data\",\"source\":{\"entryRef\":\"custom1\",\"sourceType\":\"pi.custom\"},\"customType\":\"extension\",\"data\":{}}],\"diagnostics\":{\"partial\":true},\"retainedUnknown\":[{\"sourceRef\":\"source-0\",\"recordIndex\":2,\"position\":4,\"pointer\":\"\",\"namespace\":\"record\",\"kind\":\"future\",\"payload\":\"{\\\"type\\\":\\\"future\\\"}\"}]}";
+            };
+            readonly expected: {
+                readonly capabilities: readonly ["detailed_usage_v1", "native_metadata_v1", "observed_model_v1", "retained_unknown_v1", "session_graph_provenance_v1", "tool_namespace_v1"];
+            };
+        }, {
             readonly name: "legacy-empty";
             readonly classification: "must-pass";
             readonly provenance: {
@@ -303,6 +319,22 @@ export declare const canonicalSessionGraphCapabilityFixtures: {
     };
     readonly reader: {
         readonly cases: readonly [{
+            readonly name: "advertisement-retained-duplicate";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "content-capability-negotiation";
+            };
+            readonly mutation: {
+                readonly description: "Exact retained token survives forward-open discovery";
+            };
+            readonly input: {
+                readonly json: "{\"contentCapabilities\":[\"retained_unknown_v1\",\"retained_unknown_v2\",\"retained_unknown_v1\",\"session_graph_provenance_v1\"]}";
+            };
+            readonly expected: {
+                readonly known: readonly ["retained_unknown_v1", "session_graph_provenance_v1"];
+            };
+        }, {
             readonly name: "advertisement-omitted";
             readonly classification: "must-pass";
             readonly provenance: {
@@ -386,6 +418,54 @@ export declare const canonicalSessionGraphCapabilityFixtures: {
     };
     readonly producer: {
         readonly cases: readonly [{
+            readonly name: "producer-canonical-retained";
+            readonly classification: "must-pass";
+            readonly provenance: {
+                readonly source: "requirement";
+                readonly ref: "content-capability-negotiation";
+            };
+            readonly mutation: {
+                readonly description: "Emits sorted accumulated inventory";
+            };
+            readonly input: {
+                readonly tokens: readonly ["detailed_usage_v1", "native_metadata_v1", "observed_model_v1", "retained_unknown_v1", "session_graph_provenance_v1", "tool_namespace_v1"];
+            };
+            readonly expected: {
+                readonly accepted: true;
+            };
+        }, {
+            readonly name: "producer-unsorted-retained";
+            readonly classification: "must-fail";
+            readonly provenance: {
+                readonly source: "boundary";
+                readonly ref: "content-capability-negotiation";
+            };
+            readonly mutation: {
+                readonly description: "Retained token out of canonical order refuses";
+            };
+            readonly input: {
+                readonly tokens: readonly ["retained_unknown_v1", "observed_model_v1"];
+            };
+            readonly expected: {
+                readonly errorContains: "canonical lexicographic order";
+            };
+        }, {
+            readonly name: "producer-duplicate-retained";
+            readonly classification: "must-fail";
+            readonly provenance: {
+                readonly source: "boundary";
+                readonly ref: "content-capability-negotiation";
+            };
+            readonly mutation: {
+                readonly description: "Duplicate retained token refuses";
+            };
+            readonly input: {
+                readonly tokens: readonly ["retained_unknown_v1", "retained_unknown_v1"];
+            };
+            readonly expected: {
+                readonly errorContains: "duplicated";
+            };
+        }, {
             readonly name: "producer-canonical-four";
             readonly classification: "must-pass";
             readonly provenance: {

package/dist/internal/generated/session-graph-capability-fixtures.gen.js

@@ -20,24 +20,53 @@ export const canonicalSessionGraphCapabilityFixtures = {
             "folded-result-provenance",
             "earlier-only",
             "earlier-nested-tool-native-usage-model",
-            "navigation-only-read"
+            "navigation-only-read",
+            "retained-accumulates-all"
         ],
         "reader": [
             "advertisement-omitted",
             "advertisement-empty",
             "advertisement-null",
             "advertisement-unknown-duplicate-unordered",
-            "advertisement-future-suffix"
+            "advertisement-future-suffix",
+            "advertisement-retained-duplicate"
         ],
         "producer": [
             "producer-canonical-four",
             "producer-unsorted-four",
             "producer-duplicate",
-            "producer-unknown"
+            "producer-unknown",
+            "producer-canonical-retained",
+            "producer-unsorted-retained",
+            "producer-duplicate-retained"
         ]
     },
     "derivation": {
         "cases": [
+            {
+                "name": "retained-accumulates-all",
+                "classification": "must-pass",
+                "provenance": {
+                    "source": "requirement",
+                    "ref": "content-capability-negotiation"
+                },
+                "mutation": {
+                    "description": "Retained evidence accumulates every existing preservation requirement"
+                },
+                "input": {
+                    "detailJSON": "{\"id\":\"fixture-session\",\"harness\":\"pi\",\"startTime\":\"2020-01-01T00:00:00Z\",\"endTime\":\"2020-01-01T00:00:00Z\",\"durationMins\":0,\"totalTokens\":0,\"tokensIn\":0,\"tokensOut\":0,\"turnCount\":1,\"toolCallCount\":1,\"purpose\":\"interaction\",\"turns\":[{\"index\":0,\"role\":\"assistant\",\"depth\":0,\"content\":\"\",\"timestamp\":\"2020-01-01T00:00:00Z\",\"sourceEntryRef\":\"e1\",\"observedModel\":\"provider/model\",\"usage\":{\"ownerId\":\"u1\",\"sourceEntryRef\":\"e1\",\"scope\":\"assistant\",\"completeness\":\"unknown\"},\"toolCalls\":[{\"id\":\"t1\",\"name\":\"tool\",\"namespace\":\"extension\",\"arguments\":\"\",\"result\":\"\"}]}],\"nativeMetadata\":[{\"id\":\"n1\",\"kind\":\"pi.custom.data\",\"source\":{\"entryRef\":\"custom1\",\"sourceType\":\"pi.custom\"},\"customType\":\"extension\",\"data\":{}}],\"diagnostics\":{\"partial\":true},\"retainedUnknown\":[{\"sourceRef\":\"source-0\",\"recordIndex\":2,\"position\":4,\"pointer\":\"\",\"namespace\":\"record\",\"kind\":\"future\",\"payload\":\"{\\\"type\\\":\\\"future\\\"}\"}]}"
+                },
+                "expected": {
+                    "capabilities": [
+                        "detailed_usage_v1",
+                        "native_metadata_v1",
+                        "observed_model_v1",
+                        "retained_unknown_v1",
+                        "session_graph_provenance_v1",
+                        "tool_namespace_v1"
+                    ]
+                }
+            },
             {
                 "name": "legacy-empty",
                 "classification": "must-pass",
@@ -384,6 +413,26 @@ export const canonicalSessionGraphCapabilityFixtures = {
     },
     "reader": {
         "cases": [
+            {
+                "name": "advertisement-retained-duplicate",
+                "classification": "must-pass",
+                "provenance": {
+                    "source": "requirement",
+                    "ref": "content-capability-negotiation"
+                },
+                "mutation": {
+                    "description": "Exact retained token survives forward-open discovery"
+                },
+                "input": {
+                    "json": "{\"contentCapabilities\":[\"retained_unknown_v1\",\"retained_unknown_v2\",\"retained_unknown_v1\",\"session_graph_provenance_v1\"]}"
+                },
+                "expected": {
+                    "known": [
+                        "retained_unknown_v1",
+                        "session_graph_provenance_v1"
+                    ]
+                }
+            },
             {
                 "name": "advertisement-omitted",
                 "classification": "must-pass",
@@ -482,6 +531,70 @@ export const canonicalSessionGraphCapabilityFixtures = {
     },
     "producer": {
         "cases": [
+            {
+                "name": "producer-canonical-retained",
+                "classification": "must-pass",
+                "provenance": {
+                    "source": "requirement",
+                    "ref": "content-capability-negotiation"
+                },
+                "mutation": {
+                    "description": "Emits sorted accumulated inventory"
+                },
+                "input": {
+                    "tokens": [
+                        "detailed_usage_v1",
+                        "native_metadata_v1",
+                        "observed_model_v1",
+                        "retained_unknown_v1",
+                        "session_graph_provenance_v1",
+                        "tool_namespace_v1"
+                    ]
+                },
+                "expected": {
+                    "accepted": true
+                }
+            },
+            {
+                "name": "producer-unsorted-retained",
+                "classification": "must-fail",
+                "provenance": {
+                    "source": "boundary",
+                    "ref": "content-capability-negotiation"
+                },
+                "mutation": {
+                    "description": "Retained token out of canonical order refuses"
+                },
+                "input": {
+                    "tokens": [
+                        "retained_unknown_v1",
+                        "observed_model_v1"
+                    ]
+                },
+                "expected": {
+                    "errorContains": "canonical lexicographic order"
+                }
+            },
+            {
+                "name": "producer-duplicate-retained",
+                "classification": "must-fail",
+                "provenance": {
+                    "source": "boundary",
+                    "ref": "content-capability-negotiation"
+                },
+                "mutation": {
+                    "description": "Duplicate retained token refuses"
+                },
+                "input": {
+                    "tokens": [
+                        "retained_unknown_v1",
+                        "retained_unknown_v1"
+                    ]
+                },
+                "expected": {
+                    "errorContains": "duplicated"
+                }
+            },
             {
                 "name": "producer-canonical-four",
                 "classification": "must-pass",

package/dist/internal/generated/versions.gen.d.ts

@@ -1,4 +1,4 @@
-export declare const VillageAPIVersion: "0.20.0";
-export declare const PeasantLocalAPIVersion: "0.13.0";
-export declare const TypesVersion: "0.22.0";
+export declare const VillageAPIVersion: "0.22.0";
+export declare const PeasantLocalAPIVersion: "0.14.0";
+export declare const TypesVersion: "0.24.0";
 export declare const MetadataSchemaVersion: 11;

package/dist/internal/generated/versions.gen.js

@@ -1,5 +1,5 @@
 // Code generated from the canonical Go/OpenAPI contract. DO NOT EDIT.
-export const VillageAPIVersion = "0.20.0";
-export const PeasantLocalAPIVersion = "0.13.0";
-export const TypesVersion = "0.22.0";
+export const VillageAPIVersion = "0.22.0";
+export const PeasantLocalAPIVersion = "0.14.0";
+export const TypesVersion = "0.24.0";
 export const MetadataSchemaVersion = 11;

package/dist/internal/generated/village-api.d.ts

@@ -745,7 +745,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** @description List the caller's attachments that are waiting for a transcript from the caller's machine, with each repository's normalized remote so a client can match the repository it is about to push. */
+        /** @description List the caller's attachments that are waiting for a transcript from the caller's machine, naming both the base and head remotes of each pull request so a client can match the repository it is about to push against either. */
         get: operations["listMyPromptRequests"];
         put?: never;
         post?: never;
@@ -978,6 +978,7 @@ export interface components {
          * @enum {string}
          */
         SchemaInputModality: Schema.InputModality;
+        SchemaInterpretationDiagnostics: Schema.InterpretationDiagnostics;
         /**
          * License
          * @description Content license for a published transcript
@@ -1101,6 +1102,7 @@ export interface components {
          * @enum {string}
          */
         SchemaRelationshipTargetState: Schema.RelationshipTargetState;
+        SchemaRetainedUnknownRecord: Schema.RetainedUnknownRecord;
         /**
          * Role
          * @description Sender role of a message turn

package/dist/internal/generated/wire-alias-shapes.gen.d.ts

@@ -0,0 +1,267 @@
+export declare const wireAliasShapes: {
+    readonly ActorOrigin: {};
+    readonly ChildSessionRef: {
+        readonly fields: {
+            readonly id: {};
+            readonly project: {};
+            readonly startTime: {};
+        };
+    };
+    readonly CommandInvocation: {
+        readonly fields: {
+            readonly args: {};
+            readonly name: {};
+        };
+    };
+    readonly ContentKind: {};
+    readonly ContentOrigin: {};
+    readonly ContentOwnership: {};
+    readonly ContentProvenance: {
+        readonly fields: {
+            readonly actor: "ActorOrigin";
+            readonly delivery: "DeliveryOrigin";
+            readonly evidence: "EvidenceKind";
+            readonly inputModality: "InputModality";
+            readonly origin: "ContentOrigin";
+            readonly ownership: "ContentOwnership";
+            readonly submissionRef: "SubmissionRef";
+        };
+    };
+    readonly DeliveryOrigin: {};
+    readonly EarlierHistorySection: {
+        readonly fields: {
+            readonly nativeMetadata: {
+                readonly items: "NativeMetadataRecord";
+            };
+            readonly state: "EarlierHistoryState";
+            readonly turns: {
+                readonly items: "TurnDetail";
+            };
+        };
+    };
+    readonly EarlierHistoryState: {};
+    readonly EntryType: {};
+    readonly EvidenceKind: {};
+    readonly Harness: {};
+    readonly InputModality: {};
+    readonly InterpretationDiagnostics: {
+        readonly fields: {
+            readonly partial: {};
+        };
+    };
+    readonly NativeAttachmentRef: {
+        readonly fields: {
+            readonly toolCallId: {};
+            readonly turnIndex: {};
+        };
+    };
+    readonly NativeMetadataKind: {};
+    readonly NativeMetadataRecord: {
+        readonly fields: {
+            readonly attachment: "NativeAttachmentRef";
+            readonly customType: {};
+            readonly data: {};
+            readonly id: {};
+            readonly kind: "NativeMetadataKind";
+            readonly source: "NativeSourceRef";
+        };
+    };
+    readonly NativeMetadataSourceType: {};
+    readonly NativePiMessageRole: {};
+    readonly NativeSourceRef: {
+        readonly fields: {
+            readonly entryRef: "SourceEntryRef";
+            readonly messageRole: "NativePiMessageRole";
+            readonly sourceType: "NativeMetadataSourceType";
+        };
+    };
+    readonly ObservedModelID: {};
+    readonly PublicRevisionRef: {};
+    readonly PublicSourceAnchor: {
+        readonly fields: {
+            readonly kind: "PublicSourceAnchorKind";
+            readonly sourceEntryRef: "SourceEntryRef";
+            readonly sourceRevisionRef: "PublicRevisionRef";
+        };
+    };
+    readonly PublicSourceAnchorKind: {};
+    readonly RecordedCostDetail: {
+        readonly fields: {
+            readonly cacheRead: {};
+            readonly cacheWrite: {};
+            readonly input: {};
+            readonly output: {};
+            readonly source: {};
+            readonly total: {};
+        };
+    };
+    readonly RelationshipTargetState: {};
+    readonly RetainedUnknownRecord: {
+        readonly fields: {
+            readonly kind: {};
+            readonly namespace: {};
+            readonly payload: {};
+            readonly pointer: {};
+            readonly position: {};
+            readonly recordIndex: {};
+            readonly sourceRef: {};
+        };
+    };
+    readonly Role: {};
+    readonly SessionDetailPayload: {
+        readonly fields: {
+            readonly childSessions: {
+                readonly items: "ChildSessionRef";
+            };
+            readonly diagnostics: "InterpretationDiagnostics";
+            readonly durationMins: {};
+            readonly earlierHistory: {
+                readonly items: "EarlierHistorySection";
+            };
+            readonly endTime: {};
+            readonly gitBranch: {};
+            readonly gitRemote: {};
+            readonly harness: "Harness";
+            readonly id: {};
+            readonly inputSubmissionCount: {};
+            readonly model: {};
+            readonly nativeMetadata: {
+                readonly items: "NativeMetadataRecord";
+            };
+            readonly outcome: "SessionOutcome";
+            readonly parentSessionId: "SessionID";
+            readonly project: {};
+            readonly purpose: "SessionPurpose";
+            readonly relationships: {
+                readonly items: "SessionRelationship";
+            };
+            readonly retainedUnknown: {
+                readonly items: "RetainedUnknownRecord";
+            };
+            readonly rootSessionId: "SessionID";
+            readonly schemaVersion: {};
+            readonly scorecard: "SessionScorecard";
+            readonly sessionOrigin: "SessionOrigin";
+            readonly source: {};
+            readonly startTime: {};
+            readonly status: {};
+            readonly tokensIn: {};
+            readonly tokensOut: {};
+            readonly toolCallCount: {};
+            readonly totalTokens: {};
+            readonly turnCount: {};
+            readonly turns: {
+                readonly items: "TurnDetail";
+            };
+            readonly workingDirectory: {};
+        };
+    };
+    readonly SessionID: {};
+    readonly SessionOrigin: {};
+    readonly SessionOutcome: {};
+    readonly SessionPurpose: {};
+    readonly SessionRelationship: {
+        readonly fields: {
+            readonly anchor: "PublicSourceAnchor";
+            readonly evidence: "EvidenceKind";
+            readonly kind: "SessionRelationshipKind";
+            readonly targetLocalId: "SessionID";
+            readonly targetState: "RelationshipTargetState";
+        };
+    };
+    readonly SessionRelationshipKind: {};
+    readonly SessionScorecard: {
+        readonly fields: {
+            readonly costTotalUsd: {};
+            readonly m2TokenOutcomeRatio: {};
+            readonly m4ConsecutiveErrorMax: {};
+            readonly m5ContextUtilizationPct: {};
+            readonly m6OutputSurvivalPct: {};
+            readonly m7SpecHasConstraints: {};
+            readonly m7SpecHasExamples: {};
+            readonly outcome: "SessionOutcome";
+            readonly retryTokensWasted: {};
+            readonly signalDensity: {};
+            readonly specQualityScore: {};
+            readonly totalTokens: {};
+            readonly withinSessionReverts: {};
+        };
+    };
+    readonly SourceEntryRef: {};
+    readonly StopReason: {};
+    readonly SubmissionRef: {};
+    readonly TokenUsageDetail: {
+        readonly fields: {
+            readonly cacheRead: {};
+            readonly cacheWrite: {};
+            readonly cacheWrite1h: {};
+            readonly input: {};
+            readonly output: {};
+            readonly reasoning: {};
+            readonly totalTokens: {};
+        };
+    };
+    readonly ToolCallDetail: {
+        readonly fields: {
+            readonly arguments: {};
+            readonly callEntryRef: "SourceEntryRef";
+            readonly callProvenance: "ContentProvenance";
+            readonly durationMs: {};
+            readonly exitCode: {};
+            readonly filePath: {};
+            readonly id: {};
+            readonly isError: {};
+            readonly name: {};
+            readonly namespace: {};
+            readonly result: {};
+            readonly resultEntryRef: "SourceEntryRef";
+            readonly resultProvenance: "ContentProvenance";
+            readonly toolKind: "ToolCallKind";
+            readonly usage: "UsageDetail";
+        };
+    };
+    readonly ToolCallKind: {};
+    readonly TranscriptContent: {
+        readonly fields: {
+            readonly contractVersion: {};
+            readonly kind: "ContentKind";
+            readonly sessionDetail: "SessionDetailPayload";
+        };
+    };
+    readonly TurnDetail: {
+        readonly fields: {
+            readonly agentName: {};
+            readonly command: "CommandInvocation";
+            readonly content: {};
+            readonly depth: {};
+            readonly entryType: "EntryType";
+            readonly hasThinking: {};
+            readonly index: {};
+            readonly observedModel: "ObservedModelID";
+            readonly parentIndex: {};
+            readonly provenance: "ContentProvenance";
+            readonly role: "Role";
+            readonly sourceEntryRef: "SourceEntryRef";
+            readonly stopReason: "StopReason";
+            readonly timestamp: {};
+            readonly tokensIn: {};
+            readonly tokensOut: {};
+            readonly toolCalls: {
+                readonly items: "ToolCallDetail";
+            };
+            readonly usage: "UsageDetail";
+        };
+    };
+    readonly UsageCompleteness: {};
+    readonly UsageDetail: {
+        readonly fields: {
+            readonly completeness: "UsageCompleteness";
+            readonly cost: "RecordedCostDetail";
+            readonly ownerId: {};
+            readonly scope: "UsageScope";
+            readonly sourceEntryRef: "SourceEntryRef";
+            readonly tokens: "TokenUsageDetail";
+        };
+    };
+    readonly UsageScope: {};
+};