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

package/src/funcs/withdraw-skill.ts

@@ -38,18 +38,19 @@ export function withdrawSkill(
 ): APIPromise<
   Result<
     models.WithdrawSkillResponseContent,
-    | errors.RequestValidationErrorResponseContent
+    | errors.BadRequestErrorResponseContent
     | errors.AuthenticationErrorResponseContent
     | errors.ForbiddenErrorResponseContent
     | errors.NotFoundErrorResponseContent
     | errors.TimeoutErrorResponseContent
-    | errors.PlaybookConflictErrorResponseContent
+    | errors.ConflictErrorResponseContent
+    | errors.PreconditionFailedErrorResponseContent
     | errors.PayloadTooLargeErrorResponseContent
     | errors.ResourceSuspendedErrorResponseContent
     | errors.FailedDependencyErrorResponseContent
     | errors.TooManyRequestsErrorResponseContent
-    | errors.PlaybookInternalErrorResponseContent
-    | errors.PlaybookServiceUnavailableErrorResponseContent
+    | errors.UnexpectedErrorResponseContent
+    | errors.ServiceUnavailableErrorResponseContent
     | PlaybookError
     | ResponseValidationError
     | ConnectionError
@@ -75,18 +76,19 @@ async function $do(
   [
     Result<
       models.WithdrawSkillResponseContent,
-      | errors.RequestValidationErrorResponseContent
+      | errors.BadRequestErrorResponseContent
       | errors.AuthenticationErrorResponseContent
       | errors.ForbiddenErrorResponseContent
       | errors.NotFoundErrorResponseContent
       | errors.TimeoutErrorResponseContent
-      | errors.PlaybookConflictErrorResponseContent
+      | errors.ConflictErrorResponseContent
+      | errors.PreconditionFailedErrorResponseContent
       | errors.PayloadTooLargeErrorResponseContent
       | errors.ResourceSuspendedErrorResponseContent
       | errors.FailedDependencyErrorResponseContent
       | errors.TooManyRequestsErrorResponseContent
-      | errors.PlaybookInternalErrorResponseContent
-      | errors.PlaybookServiceUnavailableErrorResponseContent
+      | errors.UnexpectedErrorResponseContent
+      | errors.ServiceUnavailableErrorResponseContent
       | PlaybookError
       | ResponseValidationError
       | ConnectionError
@@ -125,7 +127,7 @@ async function $do(
     }),
   };
   const path = pathToFunc(
-    "/v1/playbooks/{playbookId}/skills/{skillId}/publication",
+    "/iris/data/v1/agent-playbooks/playbooks/{playbookId}/skills/{skillId}/publication",
   )(pathParams);
 
   const headers = new Headers(compactMap({
@@ -184,18 +186,19 @@ async function $do(
 
   const [result] = await M.match<
     models.WithdrawSkillResponseContent,
-    | errors.RequestValidationErrorResponseContent
+    | errors.BadRequestErrorResponseContent
     | errors.AuthenticationErrorResponseContent
     | errors.ForbiddenErrorResponseContent
     | errors.NotFoundErrorResponseContent
     | errors.TimeoutErrorResponseContent
-    | errors.PlaybookConflictErrorResponseContent
+    | errors.ConflictErrorResponseContent
+    | errors.PreconditionFailedErrorResponseContent
     | errors.PayloadTooLargeErrorResponseContent
     | errors.ResourceSuspendedErrorResponseContent
     | errors.FailedDependencyErrorResponseContent
     | errors.TooManyRequestsErrorResponseContent
-    | errors.PlaybookInternalErrorResponseContent
-    | errors.PlaybookServiceUnavailableErrorResponseContent
+    | errors.UnexpectedErrorResponseContent
+    | errors.ServiceUnavailableErrorResponseContent
     | PlaybookError
     | ResponseValidationError
     | ConnectionError
@@ -206,21 +209,19 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.WithdrawSkillResponseContent$inboundSchema),
-    M.jsonErr(400, errors.RequestValidationErrorResponseContent$inboundSchema),
+    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(409, errors.PlaybookConflictErrorResponseContent$inboundSchema),
+    M.jsonErr(409, errors.ConflictErrorResponseContent$inboundSchema),
+    M.jsonErr(412, errors.PreconditionFailedErrorResponseContent$inboundSchema),
     M.jsonErr(413, errors.PayloadTooLargeErrorResponseContent$inboundSchema),
     M.jsonErr(423, errors.ResourceSuspendedErrorResponseContent$inboundSchema),
     M.jsonErr(424, errors.FailedDependencyErrorResponseContent$inboundSchema),
     M.jsonErr(429, errors.TooManyRequestsErrorResponseContent$inboundSchema),
-    M.jsonErr(500, errors.PlaybookInternalErrorResponseContent$inboundSchema),
-    M.jsonErr(
-      503,
-      errors.PlaybookServiceUnavailableErrorResponseContent$inboundSchema,
-    ),
+    M.jsonErr(500, errors.UnexpectedErrorResponseContent$inboundSchema),
+    M.jsonErr(503, errors.ServiceUnavailableErrorResponseContent$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
   )(response, req, { extraFields: responseFields });

package/src/lib/config.ts

@@ -49,8 +49,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "0.1.0-beta.2",
+  sdkVersion: "1.0.0-beta.1",
   genVersion: "2.948.4",
   userAgent:
-    "speakeasy-sdk/typescript 0.1.0-beta.2 2.948.4 1.0.0 @redis-iris/agent-playbook",
+    "speakeasy-sdk/typescript 1.0.0-beta.1 2.948.4 1.0.0 @redis-iris/agent-playbook",
 } as const;

package/src/models/accept-proposal-request-content.ts

@@ -6,12 +6,21 @@
 import * as z from "zod/v3";
 
 export type AcceptProposalRequestContent = {
-  expectedProposalRevision: number;
+  /**
+   * Resource revision. Opaque: each change to a resource's own configuration writes a
+   *
+   * @remarks
+   * new value, and a resource never gets a value it had before. Compare for equality
+   * only; its format is the service's, so only its length is constrained. Returned as
+   * `revision`; sent back as `expectedRevision` to make a write conditional. Omitting
+   * `expectedRevision` makes the write unconditional.
+   */
+  expectedRevision: string;
 };
 
 /** @internal */
 export type AcceptProposalRequestContent$Outbound = {
-  expectedProposalRevision: number;
+  expectedRevision: string;
 };
 
 /** @internal */
@@ -20,7 +29,7 @@ export const AcceptProposalRequestContent$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   AcceptProposalRequestContent
 > = z.object({
-  expectedProposalRevision: z.number().int(),
+  expectedRevision: z.string(),
 });
 
 export function acceptProposalRequestContentToJSON(

package/src/models/bad-request-error-type.ts

@@ -0,0 +1,31 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0feedc8d1ffb
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * Problem type URI for bad request errors.
+ */
+export const BadRequestErrorType = {
+  RootErrorsInvalidData: "/errors/invalid-data",
+  RootErrorsInvalidCursor: "/errors/invalid-cursor",
+  RootErrorsUnknownRequestMember: "/errors/unknown-request-member",
+  RootErrorsInvalidModelConfig: "/errors/invalid-model-config",
+  RootErrorsModelConfigImmutable: "/errors/model-config-immutable",
+  RootErrorsModelConfigNotSupported: "/errors/model-config-not-supported",
+} as const;
+/**
+ * Problem type URI for bad request errors.
+ */
+export type BadRequestErrorType = OpenEnum<typeof BadRequestErrorType>;
+
+/** @internal */
+export const BadRequestErrorType$inboundSchema: z.ZodType<
+  BadRequestErrorType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(BadRequestErrorType);

package/src/models/bulk-delete-entry-error.ts

@@ -0,0 +1,65 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6762892270be
+ */
+
+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";
+
+/**
+ * Why one entry of a bulk delete was not deleted, as RFC 9457 problem fields.
+ */
+export type BulkDeleteEntryError = {
+  /**
+   * 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;
+  /**
+   * 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;
+  /**
+   * Opaque stable entry identifier.
+   */
+  entryId: string;
+  type: string;
+};
+
+/** @internal */
+export const BulkDeleteEntryError$inboundSchema: z.ZodType<
+  BulkDeleteEntryError,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  title: z.string(),
+  status: z.number().int(),
+  detail: z.string().optional(),
+  instance: z.string().optional(),
+  entryId: z.string(),
+  type: z.string(),
+});
+
+export function bulkDeleteEntryErrorFromJSON(
+  jsonString: string,
+): SafeParseResult<BulkDeleteEntryError, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BulkDeleteEntryError$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BulkDeleteEntryError' from JSON`,
+  );
+}

package/src/models/{playbook-conflict-error-type.ts → conflict-error-type.ts}

@@ -1,6 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: cf47275e9b0c
+ * @generated-id: dde8905f1e1d
  */
 
 import * as z from "zod/v3";
@@ -8,9 +8,10 @@ import * as openEnums from "../types/enums.js";
 import { OpenEnum } from "../types/enums.js";
 
 /**
- * Distinguish resource state conflicts by type, never by human-readable title.
+ * Problem type URI for conflict errors.
  */
-export const PlaybookConflictErrorType = {
+export const ConflictErrorType = {
+  RootErrorsConflict: "/errors/conflict",
   RootErrorsEntryNotPublished: "/errors/entry-not-published",
   RootErrorsEntryKeyConflict: "/errors/entry-key-conflict",
   RootErrorsContentLimitExceeded: "/errors/content-limit-exceeded",
@@ -18,21 +19,26 @@ export const PlaybookConflictErrorType = {
   RootErrorsProposalAlreadyExists: "/errors/proposal-already-exists",
   RootErrorsProposalEvidenceConflict: "/errors/proposal-evidence-conflict",
   RootErrorsProposalEvidenceCapacity: "/errors/proposal-evidence-capacity",
-  RootErrorsProposalRevisionConflict: "/errors/proposal-revision-conflict",
   RootErrorsProposalTrashed: "/errors/proposal-trashed",
   RootErrorsProposalOpen: "/errors/proposal-open",
   RootErrorsProposalPromotionLocked: "/errors/proposal-promotion-locked",
+  RootErrorsExtractionDisabled: "/errors/extraction-disabled",
+  RootErrorsGatewayMutationInProgress: "/errors/gateway-mutation-in-progress",
+  RootErrorsSurfaceMutationInProgress: "/errors/surface-mutation-in-progress",
+  RootErrorsNamespaceConflict: "/errors/namespace-conflict",
+  RootErrorsGatewayNotEmpty: "/errors/gateway-not-empty",
+  RootErrorsGatewayDeleting: "/errors/gateway-deleting",
+  RootErrorsCatalogPublicationConflict: "/errors/catalog-publication-conflict",
+  RootErrorsSummaryViewConflict: "/errors/summary-view-conflict",
 } as const;
 /**
- * Distinguish resource state conflicts by type, never by human-readable title.
+ * Problem type URI for conflict errors.
  */
-export type PlaybookConflictErrorType = OpenEnum<
-  typeof PlaybookConflictErrorType
->;
+export type ConflictErrorType = OpenEnum<typeof ConflictErrorType>;
 
 /** @internal */
-export const PlaybookConflictErrorType$inboundSchema: z.ZodType<
-  PlaybookConflictErrorType,
+export const ConflictErrorType$inboundSchema: z.ZodType<
+  ConflictErrorType,
   z.ZodTypeDef,
   unknown
-> = openEnums.inboundSchema(PlaybookConflictErrorType);
+> = openEnums.inboundSchema(ConflictErrorType);

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

@@ -24,18 +24,27 @@ import {
   ProposalSource$inboundSchema,
 } from "./proposal-source.js";
 import {
-  ProposalStatus,
-  ProposalStatus$inboundSchema,
-} from "./proposal-status.js";
+  ProposalState,
+  ProposalState$inboundSchema,
+} from "./proposal-state.js";
 
 export type CreateProposalResponseContent = {
   proposalId: string;
-  status: ProposalStatus;
+  state: ProposalState;
   /**
    * Present for actions that author content; absent for candidate-free actions.
    */
   contentDigest?: string | undefined;
-  proposalRevision: number;
+  /**
+   * Resource revision. Opaque: each change to a resource's own configuration writes a
+   *
+   * @remarks
+   * new value, and a resource never gets a value it had before. Compare for equality
+   * only; its format is the service's, so only its length is constrained. Returned as
+   * `revision`; sent back as `expectedRevision` to make a write conditional. Omitting
+   * `expectedRevision` makes the write unconditional.
+   */
+  revision: string;
   /**
    * Attached records only, excluding creation source; not distinct sessions or confidence.
    */
@@ -92,9 +101,9 @@ export const CreateProposalResponseContent$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   proposalId: z.string(),
-  status: ProposalStatus$inboundSchema,
+  state: ProposalState$inboundSchema,
   contentDigest: z.string().optional(),
-  proposalRevision: z.number().int(),
+  revision: z.string(),
   evidenceCount: z.number().int(),
   createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),

package/src/models/delete-faqs-response-content.ts

@@ -6,16 +6,28 @@
 import * as z from "zod/v3";
 import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
+import {
+  BulkDeleteEntryError,
+  BulkDeleteEntryError$inboundSchema,
+} from "./bulk-delete-entry-error.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
 export type DeleteFaqsResponseContent = {
   /**
-   * Number of entries removed by this successful attempt. Entries already absent at
+   * Entries removed by this successful attempt. Entries already absent at the start
    *
    * @remarks
-   * the start of the attempt are ignored and do not contribute to the count.
+   * of the attempt are ignored and are not listed, so a retry can return an empty list.
    */
-  deletedEntriesCount: number;
+  deleted: Array<string>;
+  /**
+   * Requested entries this attempt did not delete, one problem each; the other entries
+   *
+   * @remarks
+   * were still processed. Empty when every entry was deleted or already absent. Retry
+   * the listed entries.
+   */
+  errors: Array<BulkDeleteEntryError>;
 };
 
 /** @internal */
@@ -24,7 +36,8 @@ export const DeleteFaqsResponseContent$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  deletedEntriesCount: z.number().int(),
+  deleted: z.array(z.string()),
+  errors: z.array(BulkDeleteEntryError$inboundSchema),
 });
 
 export function deleteFaqsResponseContentFromJSON(

package/src/models/delete-skills-response-content.ts

@@ -6,16 +6,28 @@
 import * as z from "zod/v3";
 import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
+import {
+  BulkDeleteEntryError,
+  BulkDeleteEntryError$inboundSchema,
+} from "./bulk-delete-entry-error.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
 export type DeleteSkillsResponseContent = {
   /**
-   * Number of entries removed by this successful attempt. Entries already absent at
+   * Entries removed by this successful attempt. Entries already absent at the start
    *
    * @remarks
-   * the start of the attempt are ignored and do not contribute to the count.
+   * of the attempt are ignored and are not listed, so a retry can return an empty list.
    */
-  deletedEntriesCount: number;
+  deleted: Array<string>;
+  /**
+   * Requested entries this attempt did not delete, one problem each; the other entries
+   *
+   * @remarks
+   * were still processed. Empty when every entry was deleted or already absent. Retry
+   * the listed entries.
+   */
+  errors: Array<BulkDeleteEntryError>;
 };
 
 /** @internal */
@@ -24,7 +36,8 @@ export const DeleteSkillsResponseContent$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  deletedEntriesCount: z.number().int(),
+  deleted: z.array(z.string()),
+  errors: z.array(BulkDeleteEntryError$inboundSchema),
 });
 
 export function deleteSkillsResponseContentFromJSON(

package/src/models/discovered-playbook-preview-entry.ts

@@ -29,7 +29,7 @@ export type DiscoveredPlaybookPreviewEntry = {
    * Optional Playbook-unique immutable human-readable entry key.
    */
   entryKey?: string | undefined;
-  entryType: EntryType;
+  kind: EntryType;
   version: number;
   intents: Array<string>;
   faq?: FaqContent | undefined;
@@ -48,7 +48,7 @@ export const DiscoveredPlaybookPreviewEntry$inboundSchema: z.ZodType<
 > = z.object({
   entryId: z.string(),
   entryKey: z.string().optional(),
-  entryType: EntryType$inboundSchema,
+  kind: EntryType$inboundSchema,
   version: z.number().int(),
   intents: z.array(z.string()),
   faq: FaqContent$inboundSchema.optional(),

package/src/models/dismiss-proposal-request-content.ts

@@ -10,16 +10,16 @@ export type DismissProposalRequestContent = {
    * Optional revision check for an open proposal; omission dismisses the current
    *
    * @remarks
-   * candidate regardless of revision. A mismatch returns ProposalRevisionConflict.
+   * candidate regardless of revision. A mismatch returns 412 /errors/revision-conflict.
    * Dismissal preserves the candidate for restoration; an already trashed proposal
    * is a successful no-op regardless of the supplied revision.
    */
-  expectedProposalRevision?: number | undefined;
+  expectedRevision?: string | undefined;
 };
 
 /** @internal */
 export type DismissProposalRequestContent$Outbound = {
-  expectedProposalRevision?: number | undefined;
+  expectedRevision?: string | undefined;
 };
 
 /** @internal */
@@ -28,7 +28,7 @@ export const DismissProposalRequestContent$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   DismissProposalRequestContent
 > = z.object({
-  expectedProposalRevision: z.number().int().optional(),
+  expectedRevision: z.string().optional(),
 });
 
 export function dismissProposalRequestContentToJSON(

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

@@ -24,18 +24,27 @@ import {
   ProposalSource$inboundSchema,
 } from "./proposal-source.js";
 import {
-  ProposalStatus,
-  ProposalStatus$inboundSchema,
-} from "./proposal-status.js";
+  ProposalState,
+  ProposalState$inboundSchema,
+} from "./proposal-state.js";
 
 export type DismissProposalResponseContent = {
   proposalId: string;
-  status: ProposalStatus;
+  state: ProposalState;
   /**
    * Present for actions that author content; absent for candidate-free actions.
    */
   contentDigest?: string | undefined;
-  proposalRevision: number;
+  /**
+   * Resource revision. Opaque: each change to a resource's own configuration writes a
+   *
+   * @remarks
+   * new value, and a resource never gets a value it had before. Compare for equality
+   * only; its format is the service's, so only its length is constrained. Returned as
+   * `revision`; sent back as `expectedRevision` to make a write conditional. Omitting
+   * `expectedRevision` makes the write unconditional.
+   */
+  revision: string;
   /**
    * Attached records only, excluding creation source; not distinct sessions or confidence.
    */
@@ -92,9 +101,9 @@ export const DismissProposalResponseContent$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   proposalId: z.string(),
-  status: ProposalStatus$inboundSchema,
+  state: ProposalState$inboundSchema,
   contentDigest: z.string().optional(),
-  proposalRevision: z.number().int(),
+  revision: z.string(),
   evidenceCount: z.number().int(),
   createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),

package/src/models/entry-lookup-state.ts

@@ -22,7 +22,7 @@ export type EntryLookupState = {
    * Optional Playbook-unique immutable human-readable entry key.
    */
   entryKey?: string | undefined;
-  entryType: EntryType;
+  kind: EntryType;
   latest: EntryVersionDigest;
   versionCount: number;
   publication?: EntryVersionDigest | undefined;
@@ -36,7 +36,7 @@ export const EntryLookupState$inboundSchema: z.ZodType<
 > = z.object({
   entryId: z.string(),
   entryKey: z.string().optional(),
-  entryType: EntryType$inboundSchema,
+  kind: EntryType$inboundSchema,
   latest: EntryVersionDigest$inboundSchema,
   versionCount: z.number().int(),
   publication: EntryVersionDigest$inboundSchema.optional(),

package/src/models/entry-type.ts

@@ -8,8 +8,8 @@ import * as openEnums from "../types/enums.js";
 import { OpenEnum } from "../types/enums.js";
 
 export const EntryType = {
-  Faq: "faq",
-  Skill: "skill",
+  Faq: "FAQ",
+  Skill: "SKILL",
 } as const;
 export type EntryType = OpenEnum<typeof EntryType>;