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

package/src/controlplane/models/errors/{extraction-conflict-error-response-content.ts → not-implemented-error-response-content.ts}

@@ -7,9 +7,9 @@ import * as models from "../index.js";
 import { AgentPlaybooksServiceError } from "./agent-playbooks-service-error.js";
 
 /**
- * Binding version/state conflict, or extraction disabled by deployment configuration. Disabled extraction still permits inspection, pause and deletion.
+ * The requested capability is recognized but not implemented.
  */
-export type ExtractionConflictErrorResponseContentData = {
+export type NotImplementedErrorResponseContentData = {
   /**
    * A short, human-readable summary of the problem
    *
@@ -31,13 +31,16 @@ export type ExtractionConflictErrorResponseContentData = {
    * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
    */
   instance?: string | undefined;
-  type: models.ExtractionConflictErrorType;
+  /**
+   * Problem type URI for not-implemented errors.
+   */
+  type: models.NotImplementedErrorType;
 };
 
 /**
- * Binding version/state conflict, or extraction disabled by deployment configuration. Disabled extraction still permits inspection, pause and deletion.
+ * The requested capability is recognized but not implemented.
  */
-export class ExtractionConflictErrorResponseContent
+export class NotImplementedErrorResponseContent
   extends AgentPlaybooksServiceError
 {
   /**
@@ -61,13 +64,16 @@ export class ExtractionConflictErrorResponseContent
    * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
    */
   instance?: string | undefined;
-  type: models.ExtractionConflictErrorType;
+  /**
+   * Problem type URI for not-implemented errors.
+   */
+  type: models.NotImplementedErrorType;
 
   /** The original data that was passed to this error instance. */
-  data$: ExtractionConflictErrorResponseContentData;
+  data$: NotImplementedErrorResponseContentData;
 
   constructor(
-    err: ExtractionConflictErrorResponseContentData,
+    err: NotImplementedErrorResponseContentData,
     httpMeta: { response: Response; request: Request; body: string },
   ) {
     const message = "message" in err && typeof err.message === "string"
@@ -81,27 +87,27 @@ export class ExtractionConflictErrorResponseContent
     if (err.instance != null) this.instance = err.instance;
     this.type = err.type;
 
-    this.name = "ExtractionConflictErrorResponseContent";
+    this.name = "NotImplementedErrorResponseContent";
   }
 }
 
 /** @internal */
-export const ExtractionConflictErrorResponseContent$inboundSchema: z.ZodType<
-  ExtractionConflictErrorResponseContent,
+export const NotImplementedErrorResponseContent$inboundSchema: z.ZodType<
+  NotImplementedErrorResponseContent,
   z.ZodTypeDef,
   unknown
 > = z.object({
   title: z.string(),
-  status: z.number().int().default(409),
+  status: z.number().int().default(501),
   detail: z.string().optional(),
   instance: z.string().optional(),
-  type: models.ExtractionConflictErrorType$inboundSchema,
+  type: models.NotImplementedErrorType$inboundSchema,
   request$: z.instanceof(Request),
   response$: z.instanceof(Response),
   body$: z.string(),
 })
   .transform((v) => {
-    return new ExtractionConflictErrorResponseContent(v, {
+    return new NotImplementedErrorResponseContent(v, {
       request: v.request$,
       response: v.response$,
       body: v.body$,

package/src/controlplane/models/errors/precondition-failed-error-response-content.ts

@@ -0,0 +1,125 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import * as models from "../index.js";
+import { AgentPlaybooksServiceError } from "./agent-playbooks-service-error.js";
+
+/**
+ * The write named an expected revision (expectedRevision or If-Match) that is no longer current. Read the resource again and retry.
+ */
+export type PreconditionFailedErrorResponseContentData = {
+  /**
+   * A short, human-readable summary of the problem
+   *
+   * @remarks
+   *                                       type.  It SHOULD NOT change from occurrence to occurrence of the
+   *                                       problem, except for purposes of localization (e.g., using
+   *                                       proactive content negotiation; see [RFC7231], Section 3.4).
+   */
+  title: string;
+  /**
+   * The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.
+   */
+  status?: number | undefined;
+  /**
+   * A human-readable explanation specific to this occurrence of the problem.
+   */
+  detail?: string | undefined;
+  /**
+   * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
+   */
+  instance?: string | undefined;
+  /**
+   * Problem type URI for a write whose expected revision is no longer current. A write guarded by an If-Match header on an HTTP entity tag uses a different type; see the Identity Service API.
+   */
+  type: models.PreconditionFailedErrorType;
+  /**
+   * The resource's current revision, when the service reports it. Read the resource again before retrying; do not send this value back without reading.
+   */
+  currentRevision?: string | undefined;
+};
+
+/**
+ * The write named an expected revision (expectedRevision or If-Match) that is no longer current. Read the resource again and retry.
+ */
+export class PreconditionFailedErrorResponseContent
+  extends AgentPlaybooksServiceError
+{
+  /**
+   * A short, human-readable summary of the problem
+   *
+   * @remarks
+   *                                       type.  It SHOULD NOT change from occurrence to occurrence of the
+   *                                       problem, except for purposes of localization (e.g., using
+   *                                       proactive content negotiation; see [RFC7231], Section 3.4).
+   */
+  title: string;
+  /**
+   * The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.
+   */
+  status?: number | undefined;
+  /**
+   * A human-readable explanation specific to this occurrence of the problem.
+   */
+  detail?: string | undefined;
+  /**
+   * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
+   */
+  instance?: string | undefined;
+  /**
+   * Problem type URI for a write whose expected revision is no longer current. A write guarded by an If-Match header on an HTTP entity tag uses a different type; see the Identity Service API.
+   */
+  type: models.PreconditionFailedErrorType;
+  /**
+   * The resource's current revision, when the service reports it. Read the resource again before retrying; do not send this value back without reading.
+   */
+  currentRevision?: string | undefined;
+
+  /** The original data that was passed to this error instance. */
+  data$: PreconditionFailedErrorResponseContentData;
+
+  constructor(
+    err: PreconditionFailedErrorResponseContentData,
+    httpMeta: { response: Response; request: Request; body: string },
+  ) {
+    const message = "message" in err && typeof err.message === "string"
+      ? err.message
+      : `API error occurred: ${JSON.stringify(err)}`;
+    super(message, httpMeta);
+    this.data$ = err;
+    this.title = err.title;
+    if (err.status != null) this.status = err.status;
+    if (err.detail != null) this.detail = err.detail;
+    if (err.instance != null) this.instance = err.instance;
+    this.type = err.type;
+    if (err.currentRevision != null) this.currentRevision = err.currentRevision;
+
+    this.name = "PreconditionFailedErrorResponseContent";
+  }
+}
+
+/** @internal */
+export const PreconditionFailedErrorResponseContent$inboundSchema: z.ZodType<
+  PreconditionFailedErrorResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  title: z.string(),
+  status: z.number().int().default(412),
+  detail: z.string().optional(),
+  instance: z.string().optional(),
+  type: models.PreconditionFailedErrorType$inboundSchema,
+  currentRevision: z.string().optional(),
+  request$: z.instanceof(Request),
+  response$: z.instanceof(Response),
+  body$: z.string(),
+})
+  .transform((v) => {
+    return new PreconditionFailedErrorResponseContent(v, {
+      request: v.request$,
+      response: v.response$,
+      body: v.body$,
+    });
+  });

package/src/controlplane/models/errors/{extraction-forbidden-error-response-content.ts → service-unavailable-error-response-content.ts}

@@ -6,10 +6,7 @@ import * as z from "zod/v3";
 import * as models from "../index.js";
 import { AgentPlaybooksServiceError } from "./agent-playbooks-service-error.js";
 
-/**
- * Caller authorization failure.
- */
-export type ExtractionForbiddenErrorResponseContentData = {
+export type ServiceUnavailableErrorResponseContentData = {
   /**
    * A short, human-readable summary of the problem
    *
@@ -31,13 +28,10 @@ export type ExtractionForbiddenErrorResponseContentData = {
    * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
    */
   instance?: string | undefined;
-  type: models.ExtractionForbiddenErrorType;
+  type: models.ServiceUnavailableErrorType;
 };
 
-/**
- * Caller authorization failure.
- */
-export class ExtractionForbiddenErrorResponseContent
+export class ServiceUnavailableErrorResponseContent
   extends AgentPlaybooksServiceError
 {
   /**
@@ -61,13 +55,13 @@ export class ExtractionForbiddenErrorResponseContent
    * A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced.
    */
   instance?: string | undefined;
-  type: models.ExtractionForbiddenErrorType;
+  type: models.ServiceUnavailableErrorType;
 
   /** The original data that was passed to this error instance. */
-  data$: ExtractionForbiddenErrorResponseContentData;
+  data$: ServiceUnavailableErrorResponseContentData;
 
   constructor(
-    err: ExtractionForbiddenErrorResponseContentData,
+    err: ServiceUnavailableErrorResponseContentData,
     httpMeta: { response: Response; request: Request; body: string },
   ) {
     const message = "message" in err && typeof err.message === "string"
@@ -81,27 +75,27 @@ export class ExtractionForbiddenErrorResponseContent
     if (err.instance != null) this.instance = err.instance;
     this.type = err.type;
 
-    this.name = "ExtractionForbiddenErrorResponseContent";
+    this.name = "ServiceUnavailableErrorResponseContent";
   }
 }
 
 /** @internal */
-export const ExtractionForbiddenErrorResponseContent$inboundSchema: z.ZodType<
-  ExtractionForbiddenErrorResponseContent,
+export const ServiceUnavailableErrorResponseContent$inboundSchema: z.ZodType<
+  ServiceUnavailableErrorResponseContent,
   z.ZodTypeDef,
   unknown
 > = z.object({
   title: z.string(),
-  status: z.number().int().default(403),
+  status: z.number().int().default(503),
   detail: z.string().optional(),
   instance: z.string().optional(),
-  type: models.ExtractionForbiddenErrorType$inboundSchema,
+  type: models.ServiceUnavailableErrorType$inboundSchema,
   request$: z.instanceof(Request),
   response$: z.instanceof(Response),
   body$: z.string(),
 })
   .transform((v) => {
-    return new ExtractionForbiddenErrorResponseContent(v, {
+    return new ServiceUnavailableErrorResponseContent(v, {
       request: v.request$,
       response: v.response$,
       body: v.body$,

package/src/controlplane/models/extraction-binding-source.ts

@@ -7,17 +7,20 @@ import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 import {
-  ExtractionSourceType,
-  ExtractionSourceType$inboundSchema,
-  ExtractionSourceType$outboundSchema,
-} from "./extraction-source-type.js";
+  ExtractionSourceKind,
+  ExtractionSourceKind$inboundSchema,
+  ExtractionSourceKind$outboundSchema,
+} from "./extraction-source-kind.js";
 
 /**
- * Typed RAM store reference. This release accepts only redis_agent_memory and a client-supplied storeId. The source is implicitly whole-store. When the deployment enables the RAM connection, server-side preparation verifies store access. Namespace selection and extraction workers arrive later; credentials are never accepted here. Unknown fields are rejected.
+ * Typed RAM store reference. Only REDIS_AGENT_MEMORY with a client-supplied storeId is supported. The source is implicitly whole-store. The control plane verifies source consent and same-account/tenant RAM ownership on create and every explicit enable. Namespace selection is not supported. Credentials are never accepted here. Unknown fields are rejected.
  */
 export type ExtractionBindingSource = {
+  /**
+   * A RAM store or namespace ID: letters, digits, `_` and `-`, so minted `st_` store IDs fit.
+   */
   storeId: string;
-  type: ExtractionSourceType;
+  kind: ExtractionSourceKind;
 };
 
 /** @internal */
@@ -27,12 +30,12 @@ export const ExtractionBindingSource$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   storeId: z.string(),
-  type: ExtractionSourceType$inboundSchema,
+  kind: ExtractionSourceKind$inboundSchema,
 });
 /** @internal */
 export type ExtractionBindingSource$Outbound = {
   storeId: string;
-  type: string;
+  kind: string;
 };
 
 /** @internal */
@@ -42,7 +45,7 @@ export const ExtractionBindingSource$outboundSchema: z.ZodType<
   ExtractionBindingSource
 > = z.object({
   storeId: z.string(),
-  type: ExtractionSourceType$outboundSchema,
+  kind: ExtractionSourceKind$outboundSchema,
 });
 
 export function extractionBindingSourceToJSON(

package/src/controlplane/models/extraction-binding-state.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+export const ExtractionBindingState = {
+  Ready: "READY",
+  Blocked: "BLOCKED",
+  Deleting: "DELETING",
+} as const;
+export type ExtractionBindingState = OpenEnum<typeof ExtractionBindingState>;
+
+/** @internal */
+export const ExtractionBindingState$inboundSchema: z.ZodType<
+  ExtractionBindingState,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(ExtractionBindingState);

package/src/controlplane/models/extraction-binding.ts

@@ -11,16 +11,16 @@ import {
   ExtractionBindingSource$inboundSchema,
 } from "./extraction-binding-source.js";
 import {
-  ExtractionBindingStatus,
-  ExtractionBindingStatus$inboundSchema,
-} from "./extraction-binding-status.js";
+  ExtractionBindingState,
+  ExtractionBindingState$inboundSchema,
+} from "./extraction-binding-state.js";
 import {
   ExtractionJob,
   ExtractionJob$inboundSchema,
 } from "./extraction-job.js";
 
 /**
- * Durable tenant-owned metadata for one Playbook, one RAM store, and one FAQ policy. Ready means the configured extraction-worker grants were accepted; the worker validates live RAM access during execution. Without a configured RAM connection, preparation remains pending and cannot be enabled. This release has no extraction worker. Activation requires a separate PATCH after readiness.
+ * Durable tenant-owned metadata for one Playbook, one RAM store, and one FAQ policy. Creation synchronously validates caller consent and exact RAM source ownership, returning READY and disabled. Every explicit enable revalidates with the current caller. Consent is durable account-owned configuration.
  */
 export type ExtractionBinding = {
   bindingId: string;
@@ -29,21 +29,21 @@ export type ExtractionBinding = {
    */
   playbookId: string;
   /**
-   * Typed RAM store reference. This release accepts only redis_agent_memory and a client-supplied storeId. The source is implicitly whole-store. When the deployment enables the RAM connection, server-side preparation verifies store access. Namespace selection and extraction workers arrive later; credentials are never accepted here. Unknown fields are rejected.
+   * Typed RAM store reference. Only REDIS_AGENT_MEMORY with a client-supplied storeId is supported. The source is implicitly whole-store. The control plane verifies source consent and same-account/tenant RAM ownership on create and every explicit enable. Namespace selection is not supported. Credentials are never accepted here. Unknown fields are rejected.
    */
   source: ExtractionBindingSource;
   job: ExtractionJob;
-  status: ExtractionBindingStatus;
+  state: ExtractionBindingState;
   /**
-   * Activation intent. Creation is disabled; enabling requires ready status and a separate PATCH. Pausing clears intent and retains prepared source/destination grants.
+   * Activation intent. Creation is disabled. A separate enable PATCH revalidates current source consent and ownership, and can recover a blocked binding. Pausing clears intent without a RAM request or source permission.
    */
   enabled: boolean;
   /**
-   * Optimistic configuration revision, independent of schedules and job runs.
+   * Optimistic configuration revision, independent of schedules and job runs. Opaque: send it back as expectedRevision.
    */
-  version: number;
+  revision: string;
   /**
-   * Machine-readable source preparation or execution failure reason, such as source_grant_refused, source_not_found, or source_access_denied. Clients must tolerate unknown reasons.
+   * Machine-readable runtime failure reason, such as source_not_found or source_access_denied. Clients must tolerate unknown reasons.
    */
   blockedReason?: string | undefined;
   /**
@@ -66,9 +66,9 @@ export const ExtractionBinding$inboundSchema: z.ZodType<
   playbookId: z.string(),
   source: ExtractionBindingSource$inboundSchema,
   job: ExtractionJob$inboundSchema,
-  status: ExtractionBindingStatus$inboundSchema,
+  state: ExtractionBindingState$inboundSchema,
   enabled: z.boolean(),
-  version: z.number().int(),
+  revision: z.string(),
   blockedReason: z.string().optional(),
   createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),

package/src/controlplane/models/extraction-job-configuration.ts

@@ -4,24 +4,24 @@
 
 import * as z from "zod/v3";
 import {
-  ExtractionJobType,
-  ExtractionJobType$outboundSchema,
-} from "./extraction-job-type.js";
+  ExtractionJobKind,
+  ExtractionJobKind$outboundSchema,
+} from "./extraction-job-kind.js";
 
 /**
- * One extraction kind and its user-owned policy. Scan cadence is fixed at 300 seconds and is not accepted in requests. Omitted idleWindowSeconds defaults to 1800 on create and retains its existing value on update. Idle bounds are 60–86400 seconds. Model context and output budgets are deployment-owned worker settings rather than binding fields. Job type is immutable; changing extraction kind requires a new binding. Policy changes advance the binding version and do not reset completed-source deduplication.
+ * One extraction kind and its user-owned policy. Scan cadence is deployment-owned worker configuration and is not accepted in requests or returned on bindings. Omitted idleWindowSeconds defaults to 1800 on create and retains its existing value on update. Idle bounds are 60–86400 seconds. Model context and output budgets are deployment-owned worker settings rather than binding fields. Job kind is immutable; changing extraction kind requires a new binding. Policy changes advance the binding revision and do not reset completed-source deduplication.
  */
 export type ExtractionJobConfiguration = {
   /**
    * Exactly one extraction job kind. Skill extraction is reserved for future implementation and is currently rejected.
    */
-  type: ExtractionJobType;
+  kind: ExtractionJobKind;
   idleWindowSeconds?: number | undefined;
 };
 
 /** @internal */
 export type ExtractionJobConfiguration$Outbound = {
-  type: string;
+  kind: string;
   idleWindowSeconds?: number | undefined;
 };
 
@@ -31,7 +31,7 @@ export const ExtractionJobConfiguration$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   ExtractionJobConfiguration
 > = z.object({
-  type: ExtractionJobType$outboundSchema,
+  kind: ExtractionJobKind$outboundSchema,
   idleWindowSeconds: z.number().int().optional(),
 });
 

package/src/controlplane/models/{extraction-job-type.ts → extraction-job-kind.ts}

@@ -8,19 +8,19 @@ import { ClosedEnum } from "../types/enums.js";
 /**
  * Exactly one extraction job kind. Skill extraction is reserved for future implementation and is currently rejected.
  */
-export const ExtractionJobType = {
-  Faq: "faq",
+export const ExtractionJobKind = {
+  Faq: "FAQ",
 } as const;
 /**
  * Exactly one extraction job kind. Skill extraction is reserved for future implementation and is currently rejected.
  */
-export type ExtractionJobType = ClosedEnum<typeof ExtractionJobType>;
+export type ExtractionJobKind = ClosedEnum<typeof ExtractionJobKind>;
 
 /** @internal */
-export const ExtractionJobType$inboundSchema: z.ZodNativeEnum<
-  typeof ExtractionJobType
-> = z.nativeEnum(ExtractionJobType);
+export const ExtractionJobKind$inboundSchema: z.ZodNativeEnum<
+  typeof ExtractionJobKind
+> = z.nativeEnum(ExtractionJobKind);
 /** @internal */
-export const ExtractionJobType$outboundSchema: z.ZodNativeEnum<
-  typeof ExtractionJobType
-> = ExtractionJobType$inboundSchema;
+export const ExtractionJobKind$outboundSchema: z.ZodNativeEnum<
+  typeof ExtractionJobKind
+> = ExtractionJobKind$inboundSchema;

package/src/controlplane/models/extraction-job.ts

@@ -7,19 +7,15 @@ import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 import {
-  ExtractionJobType,
-  ExtractionJobType$inboundSchema,
-} from "./extraction-job-type.js";
+  ExtractionJobKind,
+  ExtractionJobKind$inboundSchema,
+} from "./extraction-job-kind.js";
 
 export type ExtractionJob = {
   /**
    * Exactly one extraction job kind. Skill extraction is reserved for future implementation and is currently rejected.
    */
-  type: ExtractionJobType;
-  /**
-   * Read-only platform scan cadence, fixed at 300 seconds.
-   */
-  intervalSeconds: number;
+  kind: ExtractionJobKind;
   idleWindowSeconds: number;
 };
 
@@ -29,8 +25,7 @@ export const ExtractionJob$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  type: ExtractionJobType$inboundSchema,
-  intervalSeconds: z.number().int(),
+  kind: ExtractionJobKind$inboundSchema,
   idleWindowSeconds: z.number().int(),
 });
 

package/src/controlplane/models/extraction-source-kind.ts

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

package/src/controlplane/models/failed-dependency-error-type.ts

@@ -12,6 +12,8 @@ import { OpenEnum } from "../types/enums.js";
 export const FailedDependencyErrorType = {
   RootErrorsResourceUnavailable: "/errors/resource-unavailable",
   RootErrorsDatabaseOutOfMemory: "/errors/database-out-of-memory",
+  RootErrorsInvalidModelCredentials: "/errors/invalid-model-credentials",
+  RootErrorsModelQuotaExceeded: "/errors/model-quota-exceeded",
 } as const;
 /**
  * Problem type URI for failed-dependency errors.

package/src/controlplane/models/field-error.ts

@@ -8,21 +8,21 @@ import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
 /**
- * Validation error details for a single request field.
+ * One invalid request member. A body member is named by `pointer`, a path or query parameter by `parameter`; exactly one of the two is present.
  */
 export type FieldError = {
   /**
-   * Name of the invalid request field.
+   * JSON Pointer (RFC 6901) to the invalid body member, such as `/vectorSpace/dimensions`.
    */
-  field: string;
+  pointer?: string | undefined;
   /**
-   * Validation rule that was violated.
+   * Name of the invalid path or query parameter, such as `limit`.
    */
-  rule: string;
+  parameter?: string | undefined;
   /**
-   * Human-readable validation error message.
+   * What is wrong with the member, in fixed words about the rule it broke, never the rejected value.
    */
-  message: string;
+  detail: string;
 };
 
 /** @internal */
@@ -31,9 +31,9 @@ export const FieldError$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  field: z.string(),
-  rule: z.string(),
-  message: z.string(),
+  pointer: z.string().optional(),
+  parameter: z.string().optional(),
+  detail: z.string(),
 });
 
 export function fieldErrorFromJSON(

package/src/controlplane/models/forbidden-error-type.ts

@@ -0,0 +1,22 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Problem type URI for authorization errors.
+ */
+export const ForbiddenErrorType = {
+  RootErrorsInsufficientPermissions: "/errors/insufficient-permissions",
+} as const;
+/**
+ * Problem type URI for authorization errors.
+ */
+export type ForbiddenErrorType = ClosedEnum<typeof ForbiddenErrorType>;
+
+/** @internal */
+export const ForbiddenErrorType$inboundSchema: z.ZodNativeEnum<
+  typeof ForbiddenErrorType
+> = z.nativeEnum(ForbiddenErrorType);