@redis-iris/agent-playbook 0.1.0-alpha.2 → 0.1.0-alpha.4

package/src/models/operations/list-skill-versions.ts

@@ -31,7 +31,7 @@ export type ListSkillVersionsRequest$Outbound = {
   skillId: string;
   createdAfter?: string | undefined;
   createdBefore?: string | undefined;
-  limit?: number | undefined;
+  limit: number;
   cursor?: string | undefined;
 };
 
@@ -44,7 +44,7 @@ export const ListSkillVersionsRequest$outboundSchema: z.ZodType<
   skillId: z.string(),
   createdAfter: z.date().transform(v => v.toISOString()).optional(),
   createdBefore: z.date().transform(v => v.toISOString()).optional(),
-  limit: z.number().int().optional(),
+  limit: z.number().int().default(50),
   cursor: z.string().optional(),
 });
 

package/src/models/operations/list-skills.ts

@@ -42,7 +42,7 @@ export type ListSkillsRequest$Outbound = {
   createdAfter?: string | undefined;
   createdBefore?: string | undefined;
   published?: boolean | undefined;
-  limit?: number | undefined;
+  limit: number;
   cursor?: string | undefined;
 };
 
@@ -57,7 +57,7 @@ export const ListSkillsRequest$outboundSchema: z.ZodType<
   createdAfter: z.date().transform(v => v.toISOString()).optional(),
   createdBefore: z.date().transform(v => v.toISOString()).optional(),
   published: z.boolean().optional(),
-  limit: z.number().int().optional(),
+  limit: z.number().int().default(50),
   cursor: z.string().optional(),
 });
 

package/src/models/proposal-acceptance-result.ts

@@ -0,0 +1,59 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 42754763c463
+ */
+
+import * as z from "zod/v3";
+import { proposalMember, UnknownProposalMember } from "../lib/proposal-unions.js";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  ProposalVersionCreated,
+  ProposalVersionCreated$inboundSchema,
+} from "./proposal-version-created.js";
+
+export type VersionCreated = {
+  versionCreated: ProposalVersionCreated;
+};
+
+/**
+ * Clients must preserve unrecognized result members.
+ */
+export type ProposalAcceptanceResult = VersionCreated | UnknownProposalMember;
+
+/** @internal */
+export const VersionCreated$inboundSchema: z.ZodType<
+  VersionCreated,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  versionCreated: ProposalVersionCreated$inboundSchema,
+});
+
+export function versionCreatedFromJSON(
+  jsonString: string,
+): SafeParseResult<VersionCreated, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => VersionCreated$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'VersionCreated' from JSON`,
+  );
+}
+
+/** @internal */
+export const ProposalAcceptanceResult$inboundSchema: z.ZodType<
+  ProposalAcceptanceResult,
+  z.ZodTypeDef,
+  unknown
+> = z.lazy(() => proposalMember("versionCreated", VersionCreated$inboundSchema));
+
+export function proposalAcceptanceResultFromJSON(
+  jsonString: string,
+): SafeParseResult<ProposalAcceptanceResult, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ProposalAcceptanceResult$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ProposalAcceptanceResult' from JSON`,
+  );
+}

package/src/models/proposal-action-preview.ts

@@ -4,6 +4,7 @@
  */
 
 import * as z from "zod/v3";
+import { proposalMember, UnknownProposalMember } from "../lib/proposal-unions.js";
 import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import {
@@ -16,7 +17,7 @@ export type ProposalActionPreviewAdd = {
   add: AddProposalActionPreview;
 };
 
-export type ProposalActionPreview = ProposalActionPreviewAdd;
+export type ProposalActionPreview = ProposalActionPreviewAdd | UnknownProposalMember;
 
 /** @internal */
 export const ProposalActionPreviewAdd$inboundSchema: z.ZodType<
@@ -42,7 +43,7 @@ export const ProposalActionPreview$inboundSchema: z.ZodType<
   ProposalActionPreview,
   z.ZodTypeDef,
   unknown
-> = z.lazy(() => ProposalActionPreviewAdd$inboundSchema);
+> = z.lazy(() => proposalMember("add", ProposalActionPreviewAdd$inboundSchema));
 
 export function proposalActionPreviewFromJSON(
   jsonString: string,

package/src/models/proposal-action-type.ts

@@ -0,0 +1,17 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 70f8f1a8601d
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+export const ProposalActionType = {
+  Add: "add",
+} as const;
+export type ProposalActionType = ClosedEnum<typeof ProposalActionType>;
+
+/** @internal */
+export const ProposalActionType$outboundSchema: z.ZodNativeEnum<
+  typeof ProposalActionType
+> = z.nativeEnum(ProposalActionType);

package/src/models/proposal-action.ts

@@ -4,6 +4,7 @@
  */
 
 import * as z from "zod/v3";
+import { proposalMember, UnknownProposalMember } from "../lib/proposal-unions.js";
 import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import {
@@ -19,7 +20,7 @@ export type ProposalActionAdd = {
 /**
  * Exactly one action. Response clients must preserve unrecognized members.
  */
-export type ProposalAction = ProposalActionAdd;
+export type ProposalAction = ProposalActionAdd | UnknownProposalMember;
 
 /** @internal */
 export const ProposalActionAdd$inboundSchema: z.ZodType<
@@ -45,7 +46,7 @@ export const ProposalAction$inboundSchema: z.ZodType<
   ProposalAction,
   z.ZodTypeDef,
   unknown
-> = z.lazy(() => ProposalActionAdd$inboundSchema);
+> = z.lazy(() => proposalMember("add", ProposalActionAdd$inboundSchema));
 
 export function proposalActionFromJSON(
   jsonString: string,

package/src/models/proposal-candidate-input.ts

@@ -5,24 +5,24 @@
 
 import * as z from "zod/v3";
 import {
-  FaqAuthoredContent,
-  FaqAuthoredContent$Outbound,
-  FaqAuthoredContent$outboundSchema,
-} from "./faq-authored-content.js";
+  ProposalInputContent,
+  ProposalInputContent$Outbound,
+  ProposalInputContent$outboundSchema,
+} from "./proposal-input-content.js";
 
 /**
  * Launch proposal authoring accepts FAQ content only.
  */
 export type ProposalCandidateInput = {
   /**
-   * Author-provided context shared by FAQ, Skill and proposal authoring.
+   * Proposal input owns its payload independently of normalized read content.
    */
-  content: FaqAuthoredContent;
+  content: ProposalInputContent;
 };
 
 /** @internal */
 export type ProposalCandidateInput$Outbound = {
-  content: FaqAuthoredContent$Outbound;
+  content: ProposalInputContent$Outbound;
 };
 
 /** @internal */
@@ -31,7 +31,7 @@ export const ProposalCandidateInput$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   ProposalCandidateInput
 > = z.object({
-  content: FaqAuthoredContent$outboundSchema,
+  content: ProposalInputContent$outboundSchema,
 });
 
 export function proposalCandidateInputToJSON(

package/src/models/proposal-evidence.ts

@@ -16,21 +16,41 @@ import {
   ProposalSource$inboundSchema,
 } from "./proposal-source.js";
 
+/**
+ * Immutable reviewer context relevant to the proposal's underlying need. An
+ *
+ * @remarks
+ * observation may disagree with the proposed answer; it is not a vote or proof.
+ * Evidence survives candidate edits and is never copied into an accepted entry.
+ */
 export type ProposalEvidence = {
-  schemaVersion: number;
   /**
-   * UTC timestamp resolved to microsecond precision.
+   * Time of the source observation, not submission or retry time.
    */
   observedAt: Date;
+  /**
+   * Caller-declared producing component, prompt, and source-code build revision.
+   *
+   * @remarks
+   * These fields describe the original observation and are not authenticated attribution.
+   */
   producer: EvidenceProducer;
   /**
-   * Caller-supplied context for a proposal or supporting evidence, not verified
+   * Caller-supplied origin and observed material, not verified attribution.
    *
    * @remarks
-   * attribution. Reference and content, when present, are source-specific JSON
-   * objects. Playbook does not interpret their fields.
+   * On a proposal this is immutable creation context, excluded from evidenceCount.
+   * On evidence this describes an additional observation relevant to the same need.
+   * Reference locates the input; content preserves the submitter's observation or
+   * excerpt. Both, when present, must be JSON objects. Their fields are source-specific.
+   * RAM extraction uses agent-memory-session or agent-memory-summary references and
+   * questionAnswer content; its question/answer are model-derived, not verbatim events.
+   * See docs/specs/MOD-18196-playbook-extraction-readiness-follow-up.md for that contract.
    */
   source: ProposalSource;
+  /**
+   * Identity scoped to this proposal: exact replay is unchanged; changed payload conflicts.
+   */
   evidenceId: string;
 };
 
@@ -40,7 +60,6 @@ export const ProposalEvidence$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  schemaVersion: z.number().int(),
   observedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   producer: EvidenceProducer$inboundSchema,
   source: ProposalSource$inboundSchema,

package/src/models/proposal-input-content.ts

@@ -0,0 +1,58 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f721afca939b
+ */
+
+import * as z from "zod/v3";
+import {
+  ProposalInputPayload,
+  ProposalInputPayload$Outbound,
+  ProposalInputPayload$outboundSchema,
+} from "./proposal-input-payload.js";
+
+/**
+ * Proposal input owns its payload independently of normalized read content.
+ */
+export type ProposalInputContent = {
+  intents?: Array<string> | undefined;
+  /**
+   * Exact-match attributes. Values are typed scalars or nonempty lists of typed scalars.
+   */
+  attributes?: { [k: string]: any } | undefined;
+  /**
+   * Author-provided JSON metadata. Its normalized JSON encoding must not exceed 65,536 bytes or nesting depth 16; deployments may enforce lower limits. Exceeding the byte limit returns payload-too-large, while excessive nesting returns invalid-data.
+   */
+  metadata?: any | undefined;
+  /**
+   * Launch accepts FAQ only; future package inputs add their own members.
+   */
+  payload: ProposalInputPayload;
+};
+
+/** @internal */
+export type ProposalInputContent$Outbound = {
+  intents?: Array<string> | undefined;
+  attributes?: { [k: string]: any } | undefined;
+  metadata?: any | undefined;
+  payload: ProposalInputPayload$Outbound;
+};
+
+/** @internal */
+export const ProposalInputContent$outboundSchema: z.ZodType<
+  ProposalInputContent$Outbound,
+  z.ZodTypeDef,
+  ProposalInputContent
+> = z.object({
+  intents: z.array(z.string()).optional(),
+  attributes: z.record(z.any()).optional(),
+  metadata: z.any().optional(),
+  payload: ProposalInputPayload$outboundSchema,
+});
+
+export function proposalInputContentToJSON(
+  proposalInputContent: ProposalInputContent,
+): string {
+  return JSON.stringify(
+    ProposalInputContent$outboundSchema.parse(proposalInputContent),
+  );
+}

package/src/models/proposal-input-payload.ts

@@ -0,0 +1,60 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: fa24675302d8
+ */
+
+import * as z from "zod/v3";
+import {
+  FaqContent,
+  FaqContent$Outbound,
+  FaqContent$outboundSchema,
+} from "./faq-content.js";
+
+export type ProposalInputPayloadFaq = {
+  faq: FaqContent;
+};
+
+/**
+ * Launch accepts FAQ only; future package inputs add their own members.
+ */
+export type ProposalInputPayload = ProposalInputPayloadFaq;
+
+/** @internal */
+export type ProposalInputPayloadFaq$Outbound = {
+  faq: FaqContent$Outbound;
+};
+
+/** @internal */
+export const ProposalInputPayloadFaq$outboundSchema: z.ZodType<
+  ProposalInputPayloadFaq$Outbound,
+  z.ZodTypeDef,
+  ProposalInputPayloadFaq
+> = z.object({
+  faq: FaqContent$outboundSchema,
+});
+
+export function proposalInputPayloadFaqToJSON(
+  proposalInputPayloadFaq: ProposalInputPayloadFaq,
+): string {
+  return JSON.stringify(
+    ProposalInputPayloadFaq$outboundSchema.parse(proposalInputPayloadFaq),
+  );
+}
+
+/** @internal */
+export type ProposalInputPayload$Outbound = ProposalInputPayloadFaq$Outbound;
+
+/** @internal */
+export const ProposalInputPayload$outboundSchema: z.ZodType<
+  ProposalInputPayload$Outbound,
+  z.ZodTypeDef,
+  ProposalInputPayload
+> = z.lazy(() => ProposalInputPayloadFaq$outboundSchema);
+
+export function proposalInputPayloadToJSON(
+  proposalInputPayload: ProposalInputPayload,
+): string {
+  return JSON.stringify(
+    ProposalInputPayload$outboundSchema.parse(proposalInputPayload),
+  );
+}

package/src/models/proposal-preview.ts

@@ -23,10 +23,13 @@ export type ProposalPreview = {
   proposalId: string;
   status: ProposalStatus;
   /**
-   * SHA-256 digest of normalized authored Playbook content in sha256:<lowercase-hex> form. The canonicalization contract is documented as playbook-entry-v1.
+   * Present for actions that author content; absent for candidate-free actions.
    */
-  contentDigest: string;
+  contentDigest?: string | undefined;
   proposalRevision: number;
+  /**
+   * Attached records only, excluding creation source; not distinct sessions or confidence.
+   */
   evidenceCount: number;
   /**
    * UTC timestamp resolved to microsecond precision.
@@ -60,7 +63,7 @@ export const ProposalPreview$inboundSchema: z.ZodType<
 > = z.object({
   proposalId: z.string(),
   status: ProposalStatus$inboundSchema,
-  contentDigest: z.string(),
+  contentDigest: z.string().optional(),
   proposalRevision: z.number().int(),
   evidenceCount: z.number().int(),
   createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),

package/src/models/proposal-source.ts

@@ -9,11 +9,16 @@ import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
 /**
- * Caller-supplied context for a proposal or supporting evidence, not verified
+ * Caller-supplied origin and observed material, not verified attribution.
  *
  * @remarks
- * attribution. Reference and content, when present, are source-specific JSON
- * objects. Playbook does not interpret their fields.
+ * On a proposal this is immutable creation context, excluded from evidenceCount.
+ * On evidence this describes an additional observation relevant to the same need.
+ * Reference locates the input; content preserves the submitter's observation or
+ * excerpt. Both, when present, must be JSON objects. Their fields are source-specific.
+ * RAM extraction uses agent-memory-session or agent-memory-summary references and
+ * questionAnswer content; its question/answer are model-derived, not verbatim events.
+ * See docs/specs/MOD-18196-playbook-extraction-readiness-follow-up.md for that contract.
  */
 export type ProposalSource = {
   type: string;

package/src/models/proposal-target.ts

@@ -4,6 +4,7 @@
  */
 
 import * as z from "zod/v3";
+import { proposalMember, UnknownProposalMember } from "../lib/proposal-unions.js";
 import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
@@ -19,7 +20,7 @@ export type ProposalTargetNewEntry = {
 /**
  * Exactly one target. Launch supports creating a new entry.
  */
-export type ProposalTarget = ProposalTargetNewEntry;
+export type ProposalTarget = ProposalTargetNewEntry | UnknownProposalMember;
 
 /** @internal */
 export const ProposalTargetNewEntry$inboundSchema: z.ZodType<
@@ -45,7 +46,7 @@ export const ProposalTarget$inboundSchema: z.ZodType<
   ProposalTarget,
   z.ZodTypeDef,
   unknown
-> = z.lazy(() => ProposalTargetNewEntry$inboundSchema);
+> = z.lazy(() => proposalMember("newEntry", ProposalTargetNewEntry$inboundSchema));
 
 export function proposalTargetFromJSON(
   jsonString: string,

package/src/models/proposal-version-created.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f8478a54aeeb
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { EntryType, EntryType$inboundSchema } from "./entry-type.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export type ProposalVersionCreated = {
+  /**
+   * Opaque stable entry identifier.
+   */
+  entryId: string;
+  entryType: EntryType;
+  version: number;
+  /**
+   * SHA-256 digest of normalized authored Playbook content in sha256:<lowercase-hex> form. The canonicalization contract is documented as playbook-entry-v1.
+   */
+  contentDigest: string;
+};
+
+/** @internal */
+export const ProposalVersionCreated$inboundSchema: z.ZodType<
+  ProposalVersionCreated,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  entryId: z.string(),
+  entryType: EntryType$inboundSchema,
+  version: z.number().int(),
+  contentDigest: z.string(),
+});
+
+export function proposalVersionCreatedFromJSON(
+  jsonString: string,
+): SafeParseResult<ProposalVersionCreated, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ProposalVersionCreated$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ProposalVersionCreated' from JSON`,
+  );
+}

package/src/models/replace-proposal-response-content.ts

@@ -7,6 +7,10 @@ import * as z from "zod/v3";
 import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  ProposalAcceptanceResult,
+  ProposalAcceptanceResult$inboundSchema,
+} from "./proposal-acceptance-result.js";
 import {
   ProposalAction,
   ProposalAction$inboundSchema,
@@ -15,6 +19,10 @@ import {
   ProposalEvidence,
   ProposalEvidence$inboundSchema,
 } from "./proposal-evidence.js";
+import {
+  ProposalSource,
+  ProposalSource$inboundSchema,
+} from "./proposal-source.js";
 import {
   ProposalStatus,
   ProposalStatus$inboundSchema,
@@ -24,10 +32,13 @@ export type ReplaceProposalResponseContent = {
   proposalId: string;
   status: ProposalStatus;
   /**
-   * SHA-256 digest of normalized authored Playbook content in sha256:<lowercase-hex> form. The canonicalization contract is documented as playbook-entry-v1.
+   * Present for actions that author content; absent for candidate-free actions.
    */
-  contentDigest: string;
+  contentDigest?: string | undefined;
   proposalRevision: number;
+  /**
+   * Attached records only, excluding creation source; not distinct sessions or confidence.
+   */
   evidenceCount: number;
   /**
    * UTC timestamp resolved to microsecond precision.
@@ -50,11 +61,28 @@ export type ReplaceProposalResponseContent = {
    * UTC timestamp resolved to microsecond precision.
    */
   purgeAt: Date;
+  /**
+   * Caller-supplied origin and observed material, not verified attribution.
+   *
+   * @remarks
+   * On a proposal this is immutable creation context, excluded from evidenceCount.
+   * On evidence this describes an additional observation relevant to the same need.
+   * Reference locates the input; content preserves the submitter's observation or
+   * excerpt. Both, when present, must be JSON objects. Their fields are source-specific.
+   * RAM extraction uses agent-memory-session or agent-memory-summary references and
+   * questionAnswer content; its question/answer are model-derived, not verbatim events.
+   * See docs/specs/MOD-18196-playbook-extraction-readiness-follow-up.md for that contract.
+   */
+  source?: ProposalSource | undefined;
   /**
    * Exactly one action. Response clients must preserve unrecognized members.
    */
   action: ProposalAction;
   evidence: Array<ProposalEvidence>;
+  /**
+   * Clients must preserve unrecognized result members.
+   */
+  result?: ProposalAcceptanceResult | undefined;
 };
 
 /** @internal */
@@ -65,7 +93,7 @@ export const ReplaceProposalResponseContent$inboundSchema: z.ZodType<
 > = z.object({
   proposalId: z.string(),
   status: ProposalStatus$inboundSchema,
-  contentDigest: z.string(),
+  contentDigest: z.string().optional(),
   proposalRevision: z.number().int(),
   evidenceCount: z.number().int(),
   createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
@@ -74,8 +102,10 @@ export const ReplaceProposalResponseContent$inboundSchema: z.ZodType<
     new Date(v)
   ),
   purgeAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  source: ProposalSource$inboundSchema.optional(),
   action: ProposalAction$inboundSchema,
   evidence: z.array(ProposalEvidence$inboundSchema),
+  result: ProposalAcceptanceResult$inboundSchema.optional(),
 });
 
 export function replaceProposalResponseContentFromJSON(

package/src/models/restore-proposal-response-content.ts

@@ -7,6 +7,10 @@ import * as z from "zod/v3";
 import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  ProposalAcceptanceResult,
+  ProposalAcceptanceResult$inboundSchema,
+} from "./proposal-acceptance-result.js";
 import {
   ProposalAction,
   ProposalAction$inboundSchema,
@@ -15,6 +19,10 @@ import {
   ProposalEvidence,
   ProposalEvidence$inboundSchema,
 } from "./proposal-evidence.js";
+import {
+  ProposalSource,
+  ProposalSource$inboundSchema,
+} from "./proposal-source.js";
 import {
   ProposalStatus,
   ProposalStatus$inboundSchema,
@@ -24,10 +32,13 @@ export type RestoreProposalResponseContent = {
   proposalId: string;
   status: ProposalStatus;
   /**
-   * SHA-256 digest of normalized authored Playbook content in sha256:<lowercase-hex> form. The canonicalization contract is documented as playbook-entry-v1.
+   * Present for actions that author content; absent for candidate-free actions.
    */
-  contentDigest: string;
+  contentDigest?: string | undefined;
   proposalRevision: number;
+  /**
+   * Attached records only, excluding creation source; not distinct sessions or confidence.
+   */
   evidenceCount: number;
   /**
    * UTC timestamp resolved to microsecond precision.
@@ -50,11 +61,28 @@ export type RestoreProposalResponseContent = {
    * UTC timestamp resolved to microsecond precision.
    */
   purgeAt: Date;
+  /**
+   * Caller-supplied origin and observed material, not verified attribution.
+   *
+   * @remarks
+   * On a proposal this is immutable creation context, excluded from evidenceCount.
+   * On evidence this describes an additional observation relevant to the same need.
+   * Reference locates the input; content preserves the submitter's observation or
+   * excerpt. Both, when present, must be JSON objects. Their fields are source-specific.
+   * RAM extraction uses agent-memory-session or agent-memory-summary references and
+   * questionAnswer content; its question/answer are model-derived, not verbatim events.
+   * See docs/specs/MOD-18196-playbook-extraction-readiness-follow-up.md for that contract.
+   */
+  source?: ProposalSource | undefined;
   /**
    * Exactly one action. Response clients must preserve unrecognized members.
    */
   action: ProposalAction;
   evidence: Array<ProposalEvidence>;
+  /**
+   * Clients must preserve unrecognized result members.
+   */
+  result?: ProposalAcceptanceResult | undefined;
 };
 
 /** @internal */
@@ -65,7 +93,7 @@ export const RestoreProposalResponseContent$inboundSchema: z.ZodType<
 > = z.object({
   proposalId: z.string(),
   status: ProposalStatus$inboundSchema,
-  contentDigest: z.string(),
+  contentDigest: z.string().optional(),
   proposalRevision: z.number().int(),
   evidenceCount: z.number().int(),
   createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
@@ -74,8 +102,10 @@ export const RestoreProposalResponseContent$inboundSchema: z.ZodType<
     new Date(v)
   ),
   purgeAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  source: ProposalSource$inboundSchema.optional(),
   action: ProposalAction$inboundSchema,
   evidence: z.array(ProposalEvidence$inboundSchema),
+  result: ProposalAcceptanceResult$inboundSchema.optional(),
 });
 
 export function restoreProposalResponseContentFromJSON(