@redis-iris/agent-playbook 0.1.0-beta.2 → 1.0.0-beta.2

package/README.md

@@ -81,7 +81,7 @@ Use an authorized control-plane bearer token for `token` and a resource-scoped
 agent key for `apiKey`. TypeScript accepts an async credential provider for either
 argument. Pass environment variables explicitly, as above. Creating a Playbook
 does not mint a data-plane key; obtain that key through your deployment's Identity
-Service. A freshly created resource may need to reach `ready` before DP calls.
+Service. A freshly created resource may need to reach `READY` before DP calls.
 
 Control-plane methods take resource IDs per operation, such as
 `service.getPlaybook(playbookId)`. Existing data-plane methods and constructor
@@ -137,8 +137,8 @@ binding synchronously checks the caller's management consent, same-account RAM
 store ownership, destination readiness, and execution scope. A foreign or missing
 source is refused without revealing its metadata.
 
-A new binding returns `ready` with `enabled=false`. Enable it with an update that
-passes its `version` as `expectedVersion`. Every explicit enable revalidates source
+A new binding returns `READY` with `enabled=false`. Enable it with an update that
+passes its opaque `revision` as `expectedRevision`. Every explicit enable revalidates source
 consent and ownership with the current caller and can recover a blocked binding.
 Pausing or deleting requires destination management access and makes no source or
 grant-administration request. Runtime failures can mark a binding `blocked`;
@@ -150,11 +150,13 @@ responses omit `intervalSeconds`; `idleWindowSeconds` remains user-configurable.
 ## Release status
 
 This SDK is a beta prerelease. Breaking changes may land between beta releases
-without a major-version increment. The prepared npm release is `0.1.0-beta.2`,
-matching Python `0.1.0b2`. Install an exact published version and upgrade intentionally:
+without a major-version increment. Version `1.0.0-beta.2` includes structured
+validation feedback, Skill package proposals and revision-bound resource reads,
+public health operations, and typed control-plane payload-limit errors.
+Pin package versions intentionally:
 
 ```bash
-npm install @redis-iris/agent-playbook@0.1.0-beta.2
+npm install @redis-iris/agent-playbook@1.0.0-beta.2
 ```
 
 Node.js 20 or later is required. Both ESM and CommonJS imports are supported.
@@ -164,18 +166,86 @@ The generated snippets below use `<id>`, `https://api.example.com`, and
 bearer token, and service-issued IDs before running a snippet. In particular,
 `<id>` does not satisfy the Playbook ID format and is rejected before a request.
 
-## Upgrading to beta.2
+## Unified API migration (Iris #2186)
+
+These clients target the unified Playbook API, merged to Iris `main` in Iris #2186, at revision
+`0d9ccad23977a7f0f778253331d6e54a56e8f244`, from matched control/data-plane
+artifacts in publisher run `41094034623`. This includes structured validation
+feedback, Skill proposals with revision-bound resource reads, and public health
+operations. Later backend changes require a separate contract refresh.
+
+Configure a base origin for each plane. The SDK appends
+`/iris/v1/agent-playbooks/...` for control-plane calls and
+`/iris/data/v1/agent-playbooks/...` for data-plane calls. List and search responses
+now expose `items` (Python and TypeScript) with optional `nextCursor` / `next_cursor`
+on paginated lists. Continue until that cursor is absent, even after an empty page.
+Use `minScore` / `min_score`, `entryKind` / `entry_kind`, and `state` in place of
+`minimumScore`, `entryType`, and proposal `status`. Enum values such as `READY`,
+`FAQ`, `ADD`, and `INBOX` are uppercase; sorting fields such as `updatedAt` and
+`evidenceCount` retain their field spelling. Resource IDs are service-issued;
+extraction binding IDs use `bind_`.
+
+Proposal and extraction-binding concurrency now uses opaque string `revision`
+values returned by the service, sent back as `expectedRevision` / `expected_revision`.
+Compare them only for equality. Stale guarded writes return HTTP 412 with
+`PreconditionFailedErrorResponseContent`; they are distinct from HTTP 409 conflicts.
+Playbook metadata responses no longer include `tenantId`. Administrative clear
+requires a `scope` of `ALL`, `ENTRIES`, or `PROPOSALS` and returns no body (HTTP 204).
+TypeScript control-plane PATCH calls now take `(playbookId, projectId, body, options)`;
+pass `undefined` for the reserved project argument when updating a body.
+Request errors identify a body field by JSON `pointer` or a query/path field by
+`parameter` inside `errors`.
+
+### Preview policy and inventory counts
+
+Discovery has a saved `previewTokenBudget` / `preview_token_budget` and a separate
+`previewTokenBudgetEnabled` / `preview_token_budget_enabled` flag. Budgeting defaults
+to disabled. Saving a limit alone does not enable it; disabling preserves the
+saved limit. PATCH fields are optional: omission preserves each field and applies
+no defaults. Explicit null is rejected upstream. Use partial discovery objects;
+do not substitute the create/response configuration for an update. The retired
+`maxPreviewTokens` field is not supported.
+
+The estimate covers one discovery preview payload, not an agent's context window
+or later Skill reads. `budgetTruncated` reports candidates omitted for budget;
+`truncated` separately reports result-count truncation.
+
+```typescript
+import { AgentPlaybooksService, Playbook } from "@redis-iris/agent-playbook";
+
+const service = new AgentPlaybooksService({ serverURL: "https://cp.example.com" });
+const playbookId = "pb_0123456789abcdef0123456789abcdef";
+await service.updatePlaybook(playbookId, undefined, { discovery: { previewTokenBudget: 4000 } });
+await service.updatePlaybook(playbookId, undefined, { discovery: { previewTokenBudgetEnabled: true } });
+
+const playbook = new Playbook({ serverURL: "https://dp.example.com", playbookId });
+const stats = await playbook.getPlaybookStats(undefined, undefined, undefined, "INBOX");
+if (stats.faqs.total.available) console.log(stats.faqs.total.value);
+if (stats.proposals.inbox?.available) console.log(stats.proposals.inbox.value);
+```
+
+The data-plane stats operation requires content-read permission. `published` and
+exclusive `createdAfter`/`createdBefore` filter only FAQ/Skill inventory; `view`,
+`actionType`, and `entryKind` filter only proposals. Omit `view` to request both
+queues; an unrequested queue is absent. No sort, cursor, or limit applies.
+Each count has `available`; an available zero is different from an unavailable
+count, whose `value` is absent. These are independent indexed observations, subject
+to indexing delay and concurrent changes, rather than an atomic snapshot or a
+receipt of how many entries a clear deleted. Python preserves integer precision;
+TypeScript callers must account for JavaScript's `Number.MAX_SAFE_INTEGER` limit.
+
+## Earlier beta compatibility changes
 
 Extraction job responses no longer expose `intervalSeconds`, and
-`ExtractionBindingStatus` no longer declares `preparing`. Successful binding
-creation returns `ready` and disabled; remove preparation polling and enable
+`ExtractionBindingState` no longer declares `PREPARING`. Successful binding
+creation returns `READY` and disabled; remove preparation polling and enable
 explicitly after reviewing the binding. Remove reads of the retired scan-cadence
 field and configure cadence on the deployment instead.
 
-Cloud list/detail responses can report `state=unavailable` while preserving saved
+Cloud list/detail responses can report `state=UNAVAILABLE` while preserving saved
 configuration and omitting live database enrichment. This read state does not
 confirm deletion or probe content Redis health. It cannot be submitted in a
-mutation; writable states remain `ready` and `suspended`.
+mutation; writable states remain `READY` and `SUSPENDED`.
 
 ## Upgrading to beta.1
 
@@ -186,8 +256,7 @@ Rename `PlaybookServiceOptions` to `AgentPlaybooksServiceOptions`, and import
 `AgentPlaybooksServiceError` from the control-plane errors subpath in place of
 `PlaybookServiceError`. The data-plane client remains `Playbook`. Environment variables now use the
 product prefix `AGENT_PLAYBOOKS`; the previous runtime names remain fallback
-aliases as described above. Endpoints are unchanged. Both clients are regenerated
-from the same Iris main revision recorded in the contract provenance.
+aliases as described above. See the unified API migration below for the current endpoint paths and contract provenance.
 
 ## Upgrading from alpha.2
 
@@ -203,7 +272,7 @@ the actual prompt set, and `commitSHA`/`commit_sha` accepts a full lowercase Git
 SHA-1 or SHA-256 revision. Omit unavailable metadata and retain the original
 observation timestamp for retries. Creation `source` is immutable and does not
 increment `evidenceCount`/`evidence_count`. Proposal list/search support action and
-entry type selectors. `listProposals` now takes optional `actionType` and `entryType`
+entry type selectors. `listProposals` now takes optional `actionType` and `entryKind`
 before `RequestOptions`; move positional options to the eighth argument. The data-plane clear operation and its models have been removed;
 use explicit FAQ/Skill deletion operations when needed. Administrative clear is
 available separately through `AgentPlaybooksService.clearPlaybook`.
@@ -222,7 +291,8 @@ contract for future actions without content.
   * [Documentation](#documentation)
   * [Two clients, one package](#two-clients-one-package)
   * [Release status](#release-status)
-  * [Upgrading to beta.2](#upgrading-to-beta2)
+  * [Unified API migration (Iris #2186)](#unified-api-migration-iris-2186)
+  * [Earlier beta compatibility changes](#earlier-beta-compatibility-changes)
   * [Upgrading to beta.1](#upgrading-to-beta1)
   * [Upgrading from alpha.2](#upgrading-from-alpha2)
   * [SDK Installation](#sdk-installation)
@@ -240,6 +310,7 @@ contract for future actions without content.
 * [Development](#development)
   * [Maturity](#maturity)
   * [Contributions](#contributions)
+  * [Playbook validation feedback (MOD-20505)](#playbook-validation-feedback-mod-20505)
 
 <!-- End Table of Contents [toc] -->
 
@@ -250,25 +321,25 @@ The SDK can be installed with either [npm](https://www.npmjs.com/), [pnpm](https
 ### NPM
 
 ```bash
-npm add @redis-iris/agent-playbook@0.1.0-beta.2
+npm add @redis-iris/agent-playbook@1.0.0-beta.2
 ```
 
 ### PNPM
 
 ```bash
-pnpm add @redis-iris/agent-playbook@0.1.0-beta.2
+pnpm add @redis-iris/agent-playbook@1.0.0-beta.2
 ```
 
 ### Bun
 
 ```bash
-bun add @redis-iris/agent-playbook@0.1.0-beta.2
+bun add @redis-iris/agent-playbook@1.0.0-beta.2
 ```
 
 ### Yarn
 
 ```bash
-yarn add @redis-iris/agent-playbook@0.1.0-beta.2
+yarn add @redis-iris/agent-playbook@1.0.0-beta.2
 ```
 
 > [!NOTE]
@@ -483,7 +554,7 @@ async function run() {
         },
       ],
     },
-    minimumScore: 0.72,
+    minScore: 0.72,
     limit: 5,
   });
 
@@ -516,7 +587,7 @@ async function run() {
         value: "support",
       },
     },
-    minimumScore: 0.72,
+    minScore: 0.72,
     limit: 5,
   });
 
@@ -645,7 +716,7 @@ async function run() {
         promptVersion: "support-review-v1",
       },
       source: {
-        type: "document",
+        kind: "document",
         reference: {
           "documentId": "support-refund-policy-v5",
         },
@@ -680,7 +751,7 @@ async function run() {
   const result = await playbook.acceptProposal(
     "prp_0123456789abcdef0123456789abcdef",
     {
-      expectedProposalRevision: 1,
+      expectedRevision: "reviewed-revision",
     },
   );
 
@@ -727,7 +798,7 @@ const exact = await playbook.getFaqVersion(faqId, appended.version.version);
 const entries = await playbook.listFaqs();
 const versions = await playbook.listFaqVersions(faqId);
 if (!("faq" in exact.content.payload)) throw new Error("Expected an FAQ payload");
-console.log(entry, exact.content.payload.faq.answer, entries.faqs, versions.versions);
+console.log(entry, exact.content.payload.faq.answer, entries.items, versions.items);
 ```
 
 Continue list requests using `nextCursor` as the next request's `cursor` until it
@@ -765,8 +836,8 @@ import { Playbook } from "@redis-iris/agent-playbook";
 const playbook = new Playbook({ serverURL: "https://api.example.com",
   playbookId: "pb_0123456789abcdef0123456789abcdef", apiKey: "<AGENT_PLAYBOOKS_API_KEY>" });
 const filter = { eq: { name: "audience", value: "support" } };
-console.log(await playbook.searchFaqs({ query: "Where is my refund?", filter, minimumScore: 0.72, limit: 5 }));
-console.log(await playbook.searchSkills({ query: "Resolve a late delivery", filter, minimumScore: 0.72, limit: 5 }));
+console.log(await playbook.searchFaqs({ query: "Where is my refund?", filter, minScore: 0.72, limit: 5 }));
+console.log(await playbook.searchSkills({ query: "Resolve a late delivery", filter, minScore: 0.72, limit: 5 }));
 const discovered = await playbook.discoverEntries({ query: "My delivery is late", filter, limit: 10,
   pinnedEntries: [{ entryKey: "late-delivery-resolution" }] });
 console.log(discovered);
@@ -783,7 +854,7 @@ semantic matches, and Skill previews contain exact-version `SKILL.md` URIs. Chec
 New proposals have zero attached evidence, including when creation `source` is supplied.
 Creation source is immutable and separate from evidence. Submit further evidence separately, and persist the
 `evidenceId` together with its complete payload before sending it. An exact replay
-returns `alreadyPresent`; reusing the ID with changed content returns
+returns `ALREADY_PRESENT`; reusing the ID with changed content returns
 `/errors/proposal-evidence-conflict`. Evidence is caller-supplied review context,
 not verified attribution, and is not copied to the accepted FAQ. Details expose
 `evidence` and `evidenceCount`; list/search previews expose `evidenceCount`.
@@ -798,21 +869,21 @@ const action = { add: { target: { newEntry: { entryKey: "refund-bank-delay" } },
   candidate: { content: { payload: { faq: { question: "Why hasn't my refund appeared?",
     answer: "The issuing bank controls final posting time." } } } } } };
 const created = await playbook.createProposal({ action,
-  source: { type: "document", reference: { documentId: "refund-policy-v5" } } });
+  source: { kind: "document", reference: { documentId: "refund-policy-v5" } } });
 const proposalId = created.proposalId;
 const evidenceId = "evd_" + randomUUID().replaceAll("-", "");
 const evidence = { observedAt: new Date(), producer: { name: "support-review", promptVersion: "support-review-v1" },
-  source: { type: "document", reference: { documentId: "refund-policy-v5" },
+  source: { kind: "document", reference: { documentId: "refund-policy-v5" },
     content: { excerpt: "The issuing bank controls final refund posting time." } } };
 // Persist evidenceId and evidence; reuse both unchanged for every retry.
 await playbook.submitProposalEvidence(proposalId, evidenceId, evidence);
-console.log(await playbook.listProposals("inbox", "evidenceCount"));
-console.log(await playbook.searchProposals({ query: "refund", actionType: "add", entryType: "faq" }));
+console.log(await playbook.listProposals("INBOX", "evidenceCount"));
+console.log(await playbook.searchProposals({ query: "refund", actionType: "ADD", entryKind: "FAQ" }));
 const reviewed = await playbook.getProposal(proposalId);
-const replaced = await playbook.replaceProposal(proposalId, { action, expectedProposalRevision: reviewed.proposalRevision });
-await playbook.dismissProposal(proposalId, { expectedProposalRevision: replaced.proposalRevision });
+const replaced = await playbook.replaceProposal(proposalId, { action, expectedRevision: reviewed.revision });
+await playbook.dismissProposal(proposalId, { expectedRevision: replaced.revision });
 const restored = await playbook.restoreProposal(proposalId);
-const accepted = await playbook.acceptProposal(proposalId, { expectedProposalRevision: restored.proposalRevision });
+const accepted = await playbook.acceptProposal(proposalId, { expectedRevision: restored.revision });
 if (!("versionCreated" in accepted.result)) throw new Error("Review the unrecognized acceptance result before publishing");
 const receipt = accepted.result.versionCreated;
 await playbook.publishFaq(receipt.entryId, { version: receipt.version });
@@ -882,25 +953,10 @@ import { Playbook } from "@redis-iris/agent-playbook";
 const playbook = new Playbook({
   serverURL: "https://api.example.com",
   apiKey: "<AGENT_PLAYBOOKS_API_KEY>",
-  playbookId: "<id>",
 });
 
 async function run() {
-  const result = await playbook.discoverEntries({
-    query: "A customer's order is late and they want a refund",
-    filter: {
-      eq: {
-        name: "audience",
-        value: "support",
-      },
-    },
-    limit: 10,
-    pinnedEntries: [
-      {
-        entryKey: "late-delivery-resolution",
-      },
-    ],
-  });
+  const result = await playbook.getServiceLiveness();
 
   console.log(result);
 }
@@ -918,11 +974,13 @@ run();
 
 ### Playbook SDK
 
+* getServiceLiveness - Reports that this API process can answer requests, independently of downstream dependencies.
+* getServiceReadiness - Evaluates the same serving dependencies as the operational readiness probe. Returns 503 without dependency details when the service cannot serve requests.
 * discoverEntries
 * lookupEntries - Resolves bounded entry references to compact management state. Results preserve input order and report misses explicitly. Each item is authoritative when read, but the batch is not a global snapshot.
-* deleteFaqs - Deletes the requested FAQ families sequentially. Each family deletion is atomic, but the batch is not: deletions completed before an error remain applied. Retrying the same request is safe because already absent entries are ignored.
 * listFaqs
 * createFaq
+* deleteFaqs - Deletes the requested FAQ families sequentially. Each family deletion is atomic, but the batch is not: a family that cannot be deleted is reported in errors and the others are still processed, and deletions completed before a request-level error remain applied. Retrying the same request is safe because already absent entries are ignored.
 * searchFaqs
 * deleteFaq
 * getFaq
@@ -933,7 +991,7 @@ run();
 * getFaqVersion
 * getPlaybookHealth
 * listProposals
-* createProposal
+* createProposal - Submit an FAQ or complete Skill package for human review. Extraction and agent submissions share proposalPolicy.maxOpenProposals. When the Inbox is full, HTTP 409 content-limit-exceeded identifies the configured limit and observed open count; the proposal was not saved. Review/dismiss existing proposals or ask an administrator to increase the configured limit before retrying. Capacity is advisory because Search is eventually consistent.
 * searchProposals
 * purgeProposal
 * getProposal
@@ -945,9 +1003,10 @@ promoted, but remains absent from serving until separately published.
 * restoreProposal
 * dismissProposal
 * submitProposalEvidence
-* deleteSkills - Deletes the requested Skill families sequentially. Each family deletion is atomic, but the batch is not: deletions completed before an error remain applied. Retrying the same request is safe because already absent entries are ignored.
+* getProposalResource - Returns exact candidate file bytes for the requested proposal revision. A stale revision returns HTTP 412 /errors/revision-conflict; responses must not be cached.
 * listSkills
 * createSkill
+* deleteSkills - Deletes the requested Skill families sequentially. Each family deletion is atomic, but the batch is not: a family that cannot be deleted is reported in errors and the others are still processed, and deletions completed before a request-level error remain applied. Retrying the same request is safe because already absent entries are ignored.
 * searchSkills
 * deleteSkill
 * getSkill
@@ -964,6 +1023,10 @@ header. Header names are case-insensitive. The header uses the RFC 9530
 Skill version uses `sha256:<lowercase-hex>`. Both encode the same SHA-256
 digest bytes and must not be compared as strings.
 
+* getPlaybookStats - Returns independent best-effort indexed observations using content-read permissions.
+Indexing delay, expiry and concurrent writes can make counts differ from list results
+or prevent publication buckets from summing to the total. This is not an atomic
+snapshot or a receipt of entries deleted by clear or bulk delete.
 
 </details>
 <!-- End Available Resources and Operations [operations] -->
@@ -990,18 +1053,25 @@ promoted, but remains absent from serving until separately published.
 - `appendFaqVersion`
 - `appendSkillVersion`
 - `createFaq`
-- `createProposal`
+- `createProposal` - Submit an FAQ or complete Skill package for human review. Extraction and agent submissions share proposalPolicy.maxOpenProposals. When the Inbox is full, HTTP 409 content-limit-exceeded identifies the configured limit and observed open count; the proposal was not saved. Review/dismiss existing proposals or ask an administrator to increase the configured limit before retrying. Capacity is advisory because Search is eventually consistent.
 - `createSkill`
 - `deleteFaq`
-- `deleteFaqs` - Deletes the requested FAQ families sequentially. Each family deletion is atomic, but the batch is not: deletions completed before an error remain applied. Retrying the same request is safe because already absent entries are ignored.
+- `deleteFaqs` - Deletes the requested FAQ families sequentially. Each family deletion is atomic, but the batch is not: a family that cannot be deleted is reported in errors and the others are still processed, and deletions completed before a request-level error remain applied. Retrying the same request is safe because already absent entries are ignored.
 - `deleteSkill`
-- `deleteSkills` - Deletes the requested Skill families sequentially. Each family deletion is atomic, but the batch is not: deletions completed before an error remain applied. Retrying the same request is safe because already absent entries are ignored.
+- `deleteSkills` - Deletes the requested Skill families sequentially. Each family deletion is atomic, but the batch is not: a family that cannot be deleted is reported in errors and the others are still processed, and deletions completed before a request-level error remain applied. Retrying the same request is safe because already absent entries are ignored.
 - `discoverEntries`
 - `dismissProposal`
 - `getFaq`
 - `getFaqVersion`
 - `getPlaybookHealth`
+- `getPlaybookStats` - Returns independent best-effort indexed observations using content-read permissions.
+Indexing delay, expiry and concurrent writes can make counts differ from list results
+or prevent publication buckets from summing to the total. This is not an atomic
+snapshot or a receipt of entries deleted by clear or bulk delete.
 - `getProposal`
+- `getProposalResource` - Returns exact candidate file bytes for the requested proposal revision. A stale revision returns HTTP 412 /errors/revision-conflict; responses must not be cached.
+- `getServiceLiveness` - Reports that this API process can answer requests, independently of downstream dependencies.
+- `getServiceReadiness` - Evaluates the same serving dependencies as the operational readiness probe. Returns 503 without dependency details when the service cannot serve requests.
 - `getSkill`
 - `getSkillResource` - Returns the exact immutable Skill resource bytes as a streamed response.
 
@@ -1062,7 +1132,7 @@ see RetryConfig for the full options.
 
 Use retries only when repeating the operation is safe for your workflow. For
 proposal evidence, persist the same evidence ID and payload across attempts;
-the service treats an exact replay as `alreadyPresent`.
+the service treats an exact replay as `ALREADY_PRESENT`.
 
 <!-- No Retries [retries] -->
 
@@ -1087,27 +1157,11 @@ import * as errors from "@redis-iris/agent-playbook/models/errors";
 
 const playbook = new Playbook({
   serverURL: "https://api.example.com",
-  playbookId: "<id>",
-  apiKey: "<AGENT_PLAYBOOKS_API_KEY>",
 });
 
 async function run() {
   try {
-    const result = await playbook.discoverEntries({
-      query: "A customer's order is late and they want a refund",
-      filter: {
-        eq: {
-          name: "audience",
-          value: "support",
-        },
-      },
-      limit: 10,
-      pinnedEntries: [
-        {
-          entryKey: "late-delivery-resolution",
-        },
-      ],
-    });
+    const result = await playbook.getServiceLiveness();
 
     console.log(result);
   } catch (error) {
@@ -1119,12 +1173,12 @@ async function run() {
       console.log(error.headers);
 
       // Depending on the method different errors may be thrown
-      if (error instanceof errors.RequestValidationErrorResponseContent) {
+      if (error instanceof errors.BadRequestErrorResponseContent) {
         console.log(error.data$.title); // string
         console.log(error.data$.status); // number
         console.log(error.data$.detail); // string
         console.log(error.data$.instance); // string
-        console.log(error.data$.type); // models.RequestValidationErrorType
+        console.log(error.data$.type); // models.BadRequestErrorType
       }
     }
   }
@@ -1137,18 +1191,19 @@ run();
 ### Error Classes
 **Primary errors:**
 * `PlaybookError`: The base class for HTTP error responses.
-  * `RequestValidationErrorResponseContent`: One HTTP 400 schema preserves every validation problem type in generated clients. Status code `400`.
+  * `BadRequestErrorResponseContent`: Request validation or input decoding failed. Status code `400`.
   * `AuthenticationErrorResponseContent`: Authentication credentials are missing, malformed, or invalid. Status code `401`.
   * `ForbiddenErrorResponseContent`: The caller is authenticated but not allowed to access the requested resource. Status code `403`.
   * `NotFoundErrorResponseContent`: The requested resource does not exist. Status code `404`.
   * `TimeoutErrorResponseContent`: The request timed out before the service could complete it. Status code `408`.
-  * `PlaybookConflictErrorResponseContent`: One schema per HTTP status preserves the complete problem catalog in generated clients, following the Iris/Agent Memory dedicated error-type enum pattern. Status code `409`.
+  * `ConflictErrorResponseContent`: The request conflicts with the current state of the resource. Status code `409`.
+  * `PreconditionFailedErrorResponseContent`: The write named an expected revision (expectedRevision or If-Match) that is no longer current. Read the resource again and retry. Status code `412`.
   * `PayloadTooLargeErrorResponseContent`: The request payload exceeds the maximum supported size. Status code `413`.
   * `ResourceSuspendedErrorResponseContent`: The requested resource exists but is suspended by an administrator. Status code `423`.
   * `FailedDependencyErrorResponseContent`: A dependent resource required to process the request is unavailable or unhealthy. Status code `424`.
   * `TooManyRequestsErrorResponseContent`: The service rejected the request because rate limits were exceeded. Status code `429`.
-  * `PlaybookInternalErrorResponseContent`: Stored integrity failures require operator investigation; editing or blindly retrying the request does not repair the stored record. Status code `500`.
-  * `PlaybookServiceUnavailableErrorResponseContent`: Retry reads and proposal acceptance with bounded backoff. Acceptance resumes its recorded canonical target. An uncertain create or append response may have written another logical record or version and should not be blindly retried when the caller requires exactly one result. Status code `503`.
+  * `UnexpectedErrorResponseContent`: The service failed with an unexpected internal error. Status code `500`.
+  * `ServiceUnavailableErrorResponseContent`: ServiceUnavailableError 503 response. Status code `503`.
 
 <details><summary>Less common errors (6)</summary>
 
@@ -1254,3 +1309,19 @@ While we value open-source contributions to this SDK, this library is generated
 We look forward to hearing your feedback. Feel free to open a PR or an issue with a proof of concept and we'll do our best to include it in a future release.
 
 ### SDK Created by [Speakeasy](https://www.speakeasy.com/?utm_source=@redis-iris/agent-playbook&utm_campaign=typescript)
+
+
+## Playbook validation feedback (MOD-20505)
+
+Authoring accepts at most five unique intents. HTTP 400 failures expose the
+shared `errors` array with a JSON `pointer` and safe `detail`; proposal candidates
+retain their full nested pointer. A Skill ZIP needs one enclosing directory,
+for example `demo/SKILL.md`, and matching manifest name; flat archives are invalid.
+
+Extraction and agent proposals share `proposalPolicy.maxOpenProposals`, configured
+per Playbook by its administrator on create/update (default 5,000, range 1–10,000).
+At capacity, HTTP 409 `content-limit-exceeded` explains the limit and observed
+count. The proposal was not saved. Review/dismiss the backlog or deliberately
+change the policy before retrying. This remains an advisory Search-based check.
+Programmatic clients raise typed errors; model-facing recovery belongs in the
+calling integration, such as redis-iris's opt-in proposal tool adapter.

package/dist/commonjs/controlplane/funcs/clear-playbook.d.ts

@@ -9,7 +9,7 @@ import * as models from "../models/index.js";
 import { APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 /**
- * Administratively clears all (default), entries, or proposals from a ready Playbook, preserving configuration and index readiness. Requires product_admin or suite_admin. Cleanup is not atomic across content: failures can leave partial progress; retry the same scope after resolving the failure. Without new writes, repeating a successful clear removes no additional entry families.
+ * Administratively clears ALL, ENTRIES or PROPOSALS from a READY Playbook, preserving configuration and index readiness. Requires product_admin or suite_admin. Cleanup is not atomic across content: failures can leave partial progress; retry the same scope after resolving the failure. Without new writes, repeating a successful clear removes no additional entry families.
  */
-export declare function clearPlaybook(client: AgentPlaybooksServiceCore, playbookId: string, scope?: models.ClearScope | undefined, options?: RequestOptions): APIPromise<Result<models.ClearPlaybookResponseContent, errors.BadRequestErrorResponseContent | errors.AuthenticationErrorResponseContent | errors.ExtractionForbiddenErrorResponseContent | errors.NotFoundErrorResponseContent | errors.TimeoutErrorResponseContent | errors.ResourceSuspendedErrorResponseContent | errors.FailedDependencyErrorResponseContent | errors.UnexpectedErrorResponseContent | errors.PlaybookServiceUnavailableErrorResponseContent | AgentPlaybooksServiceError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+export declare function clearPlaybook(client: AgentPlaybooksServiceCore, playbookId: string, scope: models.ClearScope, projectId?: string | undefined, options?: RequestOptions): APIPromise<Result<void, errors.BadRequestErrorResponseContent | errors.AuthenticationErrorResponseContent | errors.ForbiddenErrorResponseContent | errors.NotFoundErrorResponseContent | errors.TimeoutErrorResponseContent | errors.PayloadTooLargeErrorResponseContent | errors.ResourceSuspendedErrorResponseContent | errors.FailedDependencyErrorResponseContent | errors.UnexpectedErrorResponseContent | errors.NotImplementedErrorResponseContent | errors.ServiceUnavailableErrorResponseContent | AgentPlaybooksServiceError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 //# sourceMappingURL=clear-playbook.d.ts.map

package/dist/commonjs/controlplane/funcs/clear-playbook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clear-playbook.d.ts","sourceRoot":"","sources":["../../../../src/controlplane/funcs/clear-playbook.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAMvD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,yBAAyB,EACjC,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,MAAM,CAAC,4BAA4B,EACjC,MAAM,CAAC,8BAA8B,GACrC,MAAM,CAAC,kCAAkC,GACzC,MAAM,CAAC,uCAAuC,GAC9C,MAAM,CAAC,4BAA4B,GACnC,MAAM,CAAC,2BAA2B,GAClC,MAAM,CAAC,qCAAqC,GAC5C,MAAM,CAAC,oCAAoC,GAC3C,MAAM,CAAC,8BAA8B,GACrC,MAAM,CAAC,8CAA8C,GACrD,0BAA0B,GAC1B,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAOA"}
+{"version":3,"file":"clear-playbook.d.ts","sourceRoot":"","sources":["../../../../src/controlplane/funcs/clear-playbook.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAMvD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,yBAAyB,EACjC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,CAAC,UAAU,EACxB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,IAAI,EACF,MAAM,CAAC,8BAA8B,GACrC,MAAM,CAAC,kCAAkC,GACzC,MAAM,CAAC,6BAA6B,GACpC,MAAM,CAAC,4BAA4B,GACnC,MAAM,CAAC,2BAA2B,GAClC,MAAM,CAAC,mCAAmC,GAC1C,MAAM,CAAC,qCAAqC,GAC5C,MAAM,CAAC,oCAAoC,GAC3C,MAAM,CAAC,8BAA8B,GACrC,MAAM,CAAC,kCAAkC,GACzC,MAAM,CAAC,sCAAsC,GAC7C,0BAA0B,GAC1B,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAQA"}

package/dist/commonjs/controlplane/funcs/clear-playbook.js

@@ -37,6 +37,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.clearPlaybook = clearPlaybook;
+const z = __importStar(require("zod/v3"));
 const encodings_js_1 = require("../lib/encodings.js");
 const http_js_1 = require("../lib/http.js");
 const M = __importStar(require("../lib/matchers.js"));
@@ -45,19 +46,19 @@ const schemas_js_1 = require("../lib/schemas.js");
 const security_js_1 = require("../lib/security.js");
 const url_js_1 = require("../lib/url.js");
 const errors = __importStar(require("../models/errors/index.js"));
-const models = __importStar(require("../models/index.js"));
 const operations = __importStar(require("../models/operations/index.js"));
 const async_js_1 = require("../types/async.js");
 /**
- * Administratively clears all (default), entries, or proposals from a ready Playbook, preserving configuration and index readiness. Requires product_admin or suite_admin. Cleanup is not atomic across content: failures can leave partial progress; retry the same scope after resolving the failure. Without new writes, repeating a successful clear removes no additional entry families.
+ * Administratively clears ALL, ENTRIES or PROPOSALS from a READY Playbook, preserving configuration and index readiness. Requires product_admin or suite_admin. Cleanup is not atomic across content: failures can leave partial progress; retry the same scope after resolving the failure. Without new writes, repeating a successful clear removes no additional entry families.
  */
-function clearPlaybook(client, playbookId, scope, options) {
-    return new async_js_1.APIPromise($do(client, playbookId, scope, options));
+function clearPlaybook(client, playbookId, scope, projectId, options) {
+    return new async_js_1.APIPromise($do(client, playbookId, scope, projectId, options));
 }
-async function $do(client, playbookId, scope, options) {
+async function $do(client, playbookId, scope, projectId, options) {
     const input = {
         playbookId: playbookId,
         scope: scope,
+        projectId: projectId,
     };
     const parsed = (0, schemas_js_1.safeParse)(input, (value) => operations.ClearPlaybookRequest$outboundSchema.parse(value), "Input validation failed");
     if (!parsed.ok) {
@@ -71,8 +72,9 @@ async function $do(client, playbookId, scope, options) {
             charEncoding: "percent",
         }),
     };
-    const path = (0, url_js_1.pathToFunc)("/v1/playbooks/{playbookId}/clear")(pathParams);
+    const path = (0, url_js_1.pathToFunc)("/iris/v1/agent-playbooks/playbooks/{playbookId}/clear")(pathParams);
     const query = (0, encodings_js_1.encodeFormQuery)({
+        "projectId": payload.projectId,
         "scope": payload.scope,
     });
     const headers = new Headers((0, primitives_js_1.compactMap)({
@@ -121,7 +123,7 @@ async function $do(client, playbookId, scope, options) {
     const responseFields = {
         HttpMeta: { Response: response, Request: req },
     };
-    const [result] = await M.match(M.json(200, models.ClearPlaybookResponseContent$inboundSchema), M.jsonErr(400, errors.BadRequestErrorResponseContent$inboundSchema), M.jsonErr(401, errors.AuthenticationErrorResponseContent$inboundSchema), M.jsonErr(403, errors.ExtractionForbiddenErrorResponseContent$inboundSchema), M.jsonErr(404, errors.NotFoundErrorResponseContent$inboundSchema), M.jsonErr(408, errors.TimeoutErrorResponseContent$inboundSchema), M.jsonErr(423, errors.ResourceSuspendedErrorResponseContent$inboundSchema), M.jsonErr(424, errors.FailedDependencyErrorResponseContent$inboundSchema), M.jsonErr(500, errors.UnexpectedErrorResponseContent$inboundSchema), M.jsonErr(503, errors.PlaybookServiceUnavailableErrorResponseContent$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
+    const [result] = await M.match(M.nil(204, z.void()), M.jsonErr(400, errors.BadRequestErrorResponseContent$inboundSchema), M.jsonErr(401, errors.AuthenticationErrorResponseContent$inboundSchema), M.jsonErr(403, errors.ForbiddenErrorResponseContent$inboundSchema), M.jsonErr(404, errors.NotFoundErrorResponseContent$inboundSchema), M.jsonErr(408, errors.TimeoutErrorResponseContent$inboundSchema), M.jsonErr(413, errors.PayloadTooLargeErrorResponseContent$inboundSchema), M.jsonErr(423, errors.ResourceSuspendedErrorResponseContent$inboundSchema), M.jsonErr(424, errors.FailedDependencyErrorResponseContent$inboundSchema), M.jsonErr(500, errors.UnexpectedErrorResponseContent$inboundSchema), M.jsonErr(501, errors.NotImplementedErrorResponseContent$inboundSchema), M.jsonErr(503, errors.ServiceUnavailableErrorResponseContent$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
     if (!result.ok) {
         return [result, { status: "complete", request: req, response }];
     }

package/dist/commonjs/controlplane/funcs/clear-playbook.js.map

@@ -1 +1 @@
-{"version":3,"file":"clear-playbook.js","sourceRoot":"","sources":["../../../../src/controlplane/funcs/clear-playbook.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"clear-playbook.js","sourceRoot":"","sources":["../../../../src/controlplane/funcs/clear-playbook.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/controlplane/funcs/create-extraction-binding.d.ts

@@ -9,7 +9,7 @@ import * as models from "../models/index.js";
 import { APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 /**
- * Validates caller management consent, exact same-account RAM source ownership, destination readiness and execution scope synchronously. Success returns ready and enabled=false. Every explicit enable revalidates with the current caller. Pause/delete require destination management only and make no source or grant-administration request. A foreign or missing source is refused without revealing its metadata.
+ * Validates caller management consent, exact same-account Agent Memory source ownership, destination readiness and execution scope synchronously. Success returns ready and enabled=false. Every explicit enable revalidates with the current caller. Pause/delete require destination management only and make no source or grant-administration request. A foreign or missing source is refused without revealing its metadata.
  */
-export declare function createExtractionBinding(client: AgentPlaybooksServiceCore, playbookId: string, body: models.CreateExtractionBindingRequestContent, options?: RequestOptions): APIPromise<Result<models.CreateExtractionBindingResponseContent, errors.BadRequestErrorResponseContent | errors.AuthenticationErrorResponseContent | errors.ExtractionForbiddenErrorResponseContent | errors.NotFoundErrorResponseContent | errors.TimeoutErrorResponseContent | errors.ExtractionConflictErrorResponseContent | errors.FailedDependencyErrorResponseContent | errors.UnexpectedErrorResponseContent | errors.PlaybookServiceUnavailableErrorResponseContent | AgentPlaybooksServiceError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+export declare function createExtractionBinding(client: AgentPlaybooksServiceCore, playbookId: string, body: models.CreateExtractionBindingRequestContent, projectId?: string | undefined, options?: RequestOptions): APIPromise<Result<models.CreateExtractionBindingResponseContent, errors.BadRequestErrorResponseContent | errors.AuthenticationErrorResponseContent | errors.ForbiddenErrorResponseContent | errors.NotFoundErrorResponseContent | errors.TimeoutErrorResponseContent | errors.ConflictErrorResponseContent | errors.PayloadTooLargeErrorResponseContent | errors.FailedDependencyErrorResponseContent | errors.UnexpectedErrorResponseContent | errors.NotImplementedErrorResponseContent | errors.ServiceUnavailableErrorResponseContent | AgentPlaybooksServiceError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 //# sourceMappingURL=create-extraction-binding.d.ts.map

package/dist/commonjs/controlplane/funcs/create-extraction-binding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-extraction-binding.d.ts","sourceRoot":"","sources":["../../../../src/controlplane/funcs/create-extraction-binding.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAMvD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,yBAAyB,EACjC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,qCAAqC,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,MAAM,CAAC,sCAAsC,EAC3C,MAAM,CAAC,8BAA8B,GACrC,MAAM,CAAC,kCAAkC,GACzC,MAAM,CAAC,uCAAuC,GAC9C,MAAM,CAAC,4BAA4B,GACnC,MAAM,CAAC,2BAA2B,GAClC,MAAM,CAAC,sCAAsC,GAC7C,MAAM,CAAC,oCAAoC,GAC3C,MAAM,CAAC,8BAA8B,GACrC,MAAM,CAAC,8CAA8C,GACrD,0BAA0B,GAC1B,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAOA"}
+{"version":3,"file":"create-extraction-binding.d.ts","sourceRoot":"","sources":["../../../../src/controlplane/funcs/create-extraction-binding.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAMvD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,yBAAyB,EACjC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,qCAAqC,EAClD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,MAAM,CAAC,sCAAsC,EAC3C,MAAM,CAAC,8BAA8B,GACrC,MAAM,CAAC,kCAAkC,GACzC,MAAM,CAAC,6BAA6B,GACpC,MAAM,CAAC,4BAA4B,GACnC,MAAM,CAAC,2BAA2B,GAClC,MAAM,CAAC,4BAA4B,GACnC,MAAM,CAAC,mCAAmC,GAC1C,MAAM,CAAC,oCAAoC,GAC3C,MAAM,CAAC,8BAA8B,GACrC,MAAM,CAAC,kCAAkC,GACzC,MAAM,CAAC,sCAAsC,GAC7C,0BAA0B,GAC1B,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAQA"}