@redis-iris/agent-playbook 0.0.0-stage → 0.1.0-alpha.3

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

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 29948658a79d
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import {
+  DiscoveredPlaybookPreviewEntry,
+  DiscoveredPlaybookPreviewEntry$inboundSchema,
+} from "./discovered-playbook-preview-entry.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export type SearchSkillsResponseContent = {
+  matches: Array<DiscoveredPlaybookPreviewEntry>;
+};
+
+/** @internal */
+export const SearchSkillsResponseContent$inboundSchema: z.ZodType<
+  SearchSkillsResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  matches: z.array(DiscoveredPlaybookPreviewEntry$inboundSchema),
+});
+
+export function searchSkillsResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<SearchSkillsResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SearchSkillsResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SearchSkillsResponseContent' from JSON`,
+  );
+}

package/src/models/security.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2b5e866071a9
+ */
+
+import * as z from "zod/v3";
+
+export type Security = {
+  apiKey?: string | undefined;
+};
+
+/** @internal */
+export type Security$Outbound = {
+  apiKey?: string | undefined;
+};
+
+/** @internal */
+export const Security$outboundSchema: z.ZodType<
+  Security$Outbound,
+  z.ZodTypeDef,
+  Security
+> = z.object({
+  apiKey: z.string().optional(),
+});
+
+export function securityToJSON(security: Security): string {
+  return JSON.stringify(Security$outboundSchema.parse(security));
+}

package/src/models/skill-content.ts

@@ -0,0 +1,54 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2cb9a65a695e
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  ResourceDescriptor,
+  ResourceDescriptor$inboundSchema,
+} from "./resource-descriptor.js";
+import { SkillFormat, SkillFormat$inboundSchema } from "./skill-format.js";
+import {
+  SkillManifest,
+  SkillManifest$inboundSchema,
+} from "./skill-manifest.js";
+
+/**
+ * Complete parsed Skill content, including the instructions extracted from SKILL.md.
+ *
+ * @remarks
+ * Resources contain descriptors and URIs, never file bytes. Search and discovery use the
+ * smaller SkillPreviewContent, also used by StableEntry publications. Version responses use this complete shape.
+ */
+export type SkillContent = {
+  format: SkillFormat;
+  manifest: SkillManifest;
+  instructions: string;
+  resources: Array<ResourceDescriptor>;
+};
+
+/** @internal */
+export const SkillContent$inboundSchema: z.ZodType<
+  SkillContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  format: SkillFormat$inboundSchema,
+  manifest: SkillManifest$inboundSchema,
+  instructions: z.string(),
+  resources: z.array(ResourceDescriptor$inboundSchema),
+});
+
+export function skillContentFromJSON(
+  jsonString: string,
+): SafeParseResult<SkillContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SkillContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SkillContent' from JSON`,
+  );
+}

package/src/models/skill-format.ts

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

package/src/models/skill-manifest.ts

@@ -0,0 +1,42 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b22b007d4e12
+ */
+
+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";
+
+export type SkillManifest = {
+  name: string;
+  description: string;
+  license?: string | undefined;
+  compatibility?: string | undefined;
+  metadata?: { [k: string]: string } | undefined;
+  allowedTools?: Array<string> | undefined;
+};
+
+/** @internal */
+export const SkillManifest$inboundSchema: z.ZodType<
+  SkillManifest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string(),
+  description: z.string(),
+  license: z.string().optional(),
+  compatibility: z.string().optional(),
+  metadata: z.record(z.string()).optional(),
+  allowedTools: z.array(z.string()).optional(),
+});
+
+export function skillManifestFromJSON(
+  jsonString: string,
+): SafeParseResult<SkillManifest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SkillManifest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SkillManifest' from JSON`,
+  );
+}

package/src/models/skill-preview-content.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4bddff4ba2a9
+ */
+
+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";
+
+export type SkillPreviewContent = {
+  name: string;
+  description: string;
+  /**
+   * Canonical SKILL.md URI for the exact published Skill version.
+   */
+  uri: string;
+};
+
+/** @internal */
+export const SkillPreviewContent$inboundSchema: z.ZodType<
+  SkillPreviewContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string(),
+  description: z.string(),
+  uri: z.string(),
+});
+
+export function skillPreviewContentFromJSON(
+  jsonString: string,
+): SafeParseResult<SkillPreviewContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SkillPreviewContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SkillPreviewContent' from JSON`,
+  );
+}

package/src/models/sort-order.ts

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

package/src/models/stable-entry.ts

@@ -0,0 +1,61 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3c120b314037
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { EntryType, EntryType$inboundSchema } from "./entry-type.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import { Publication, Publication$inboundSchema } from "./publication.js";
+
+export type StableEntry = {
+  /**
+   * Opaque stable entry identifier.
+   */
+  entryId: string;
+  /**
+   * Optional Playbook-unique immutable human-readable entry key.
+   */
+  entryKey?: string | undefined;
+  entryType: EntryType;
+  /**
+   * Newest immutable version number. Versions are append-only, so this also equals the version count.
+   */
+  latestVersion: number;
+  publication?: Publication | undefined;
+  /**
+   * UTC timestamp resolved to microsecond precision.
+   */
+  createdAt: Date;
+  /**
+   * Last create, append, publication change, or withdrawal of an existing publication. Repeating the current publication, already-unpublished withdrawal, and reads leave it unchanged. Publication/append updates never move this timestamp backwards.
+   */
+  updatedAt: Date;
+};
+
+/** @internal */
+export const StableEntry$inboundSchema: z.ZodType<
+  StableEntry,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  entryId: z.string(),
+  entryKey: z.string().optional(),
+  entryType: EntryType$inboundSchema,
+  latestVersion: z.number().int(),
+  publication: Publication$inboundSchema.optional(),
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+
+export function stableEntryFromJSON(
+  jsonString: string,
+): SafeParseResult<StableEntry, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StableEntry$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StableEntry' from JSON`,
+  );
+}

package/src/models/submit-proposal-evidence-request-content.ts

@@ -0,0 +1,71 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: cbf38c91f84f
+ */
+
+import * as z from "zod/v3";
+import {
+  EvidenceProducer,
+  EvidenceProducer$Outbound,
+  EvidenceProducer$outboundSchema,
+} from "./evidence-producer.js";
+import {
+  ProposalSource,
+  ProposalSource$Outbound,
+  ProposalSource$outboundSchema,
+} from "./proposal-source.js";
+
+export type SubmitProposalEvidenceRequestContent = {
+  /**
+   * Time of the source observation, not submission or retry time.
+   */
+  observedAt: Date;
+  /**
+   * Caller-declared producing component, prompt, and source-code build revision.
+   *
+   * @remarks
+   * These fields describe the original observation and are not authenticated attribution.
+   */
+  producer: EvidenceProducer;
+  /**
+   * Caller-supplied origin and observed material, not verified attribution.
+   *
+   * @remarks
+   * On a proposal this is immutable creation context, excluded from evidenceCount.
+   * On evidence this describes an additional observation relevant to the same need.
+   * Reference locates the input; content preserves the submitter's observation or
+   * excerpt. Both, when present, must be JSON objects. Their fields are source-specific.
+   * RAM extraction uses agent-memory-session or agent-memory-summary references and
+   * questionAnswer content; its question/answer are model-derived, not verbatim events.
+   * See docs/specs/MOD-18196-playbook-extraction-readiness-follow-up.md for that contract.
+   */
+  source: ProposalSource;
+};
+
+/** @internal */
+export type SubmitProposalEvidenceRequestContent$Outbound = {
+  observedAt: string;
+  producer: EvidenceProducer$Outbound;
+  source: ProposalSource$Outbound;
+};
+
+/** @internal */
+export const SubmitProposalEvidenceRequestContent$outboundSchema: z.ZodType<
+  SubmitProposalEvidenceRequestContent$Outbound,
+  z.ZodTypeDef,
+  SubmitProposalEvidenceRequestContent
+> = z.object({
+  observedAt: z.date().transform(v => v.toISOString()),
+  producer: EvidenceProducer$outboundSchema,
+  source: ProposalSource$outboundSchema,
+});
+
+export function submitProposalEvidenceRequestContentToJSON(
+  submitProposalEvidenceRequestContent: SubmitProposalEvidenceRequestContent,
+): string {
+  return JSON.stringify(
+    SubmitProposalEvidenceRequestContent$outboundSchema.parse(
+      submitProposalEvidenceRequestContent,
+    ),
+  );
+}

package/src/models/submit-proposal-evidence-response-content.ts

@@ -0,0 +1,46 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 844465583432
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import {
+  ProposalEvidenceDisposition,
+  ProposalEvidenceDisposition$inboundSchema,
+} from "./proposal-evidence-disposition.js";
+
+export type SubmitProposalEvidenceResponseContent = {
+  evidenceId: string;
+  disposition: ProposalEvidenceDisposition;
+  evidenceCount: number;
+  /**
+   * UTC timestamp resolved to microsecond precision.
+   */
+  updatedAt: Date;
+};
+
+/** @internal */
+export const SubmitProposalEvidenceResponseContent$inboundSchema: z.ZodType<
+  SubmitProposalEvidenceResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  evidenceId: z.string(),
+  disposition: ProposalEvidenceDisposition$inboundSchema,
+  evidenceCount: z.number().int(),
+  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+
+export function submitProposalEvidenceResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<SubmitProposalEvidenceResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      SubmitProposalEvidenceResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SubmitProposalEvidenceResponseContent' from JSON`,
+  );
+}

package/src/models/timeout-error-type.ts

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

package/src/models/too-many-requests-error-type.ts

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4e74020be904
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Problem type URI for rate-limit errors.
+ */
+export const TooManyRequestsErrorType = {
+  RootErrorsTooManyRequests: "/errors/too-many-requests",
+} as const;
+/**
+ * Problem type URI for rate-limit errors.
+ */
+export type TooManyRequestsErrorType = ClosedEnum<
+  typeof TooManyRequestsErrorType
+>;
+
+/** @internal */
+export const TooManyRequestsErrorType$inboundSchema: z.ZodNativeEnum<
+  typeof TooManyRequestsErrorType
+> = z.nativeEnum(TooManyRequestsErrorType);

package/src/models/version.ts

@@ -0,0 +1,58 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4c1d3cf17bef
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import {
+  AuthoredContent,
+  AuthoredContent$inboundSchema,
+} from "./authored-content.js";
+import { EntryType, EntryType$inboundSchema } from "./entry-type.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export type Version = {
+  /**
+   * Opaque stable entry identifier.
+   */
+  entryId: string;
+  entryType: EntryType;
+  version: number;
+  /**
+   * UTC timestamp resolved to microsecond precision.
+   */
+  createdAt: Date;
+  /**
+   * SHA-256 digest of normalized authored Playbook content in sha256:<lowercase-hex> form. The canonicalization contract is documented as playbook-entry-v1.
+   */
+  contentDigest: string;
+  /**
+   * Complete normalized authored content. Responses emit empty intents/attributes collections.
+   */
+  content: AuthoredContent;
+};
+
+/** @internal */
+export const Version$inboundSchema: z.ZodType<Version, z.ZodTypeDef, unknown> =
+  z.object({
+    entryId: z.string(),
+    entryType: EntryType$inboundSchema,
+    version: z.number().int(),
+    createdAt: z.string().datetime({ offset: true }).transform(v =>
+      new Date(v)
+    ),
+    contentDigest: z.string(),
+    content: AuthoredContent$inboundSchema,
+  });
+
+export function versionFromJSON(
+  jsonString: string,
+): SafeParseResult<Version, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Version$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Version' from JSON`,
+  );
+}

package/src/models/withdraw-faq-response-content.ts

@@ -0,0 +1,61 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 217e56aac68f
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { EntryType, EntryType$inboundSchema } from "./entry-type.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import { Publication, Publication$inboundSchema } from "./publication.js";
+
+export type WithdrawFaqResponseContent = {
+  /**
+   * Opaque stable entry identifier.
+   */
+  entryId: string;
+  /**
+   * Optional Playbook-unique immutable human-readable entry key.
+   */
+  entryKey?: string | undefined;
+  entryType: EntryType;
+  /**
+   * Newest immutable version number. Versions are append-only, so this also equals the version count.
+   */
+  latestVersion: number;
+  publication?: Publication | undefined;
+  /**
+   * UTC timestamp resolved to microsecond precision.
+   */
+  createdAt: Date;
+  /**
+   * Last create, append, publication change, or withdrawal of an existing publication. Repeating the current publication, already-unpublished withdrawal, and reads leave it unchanged. Publication/append updates never move this timestamp backwards.
+   */
+  updatedAt: Date;
+};
+
+/** @internal */
+export const WithdrawFaqResponseContent$inboundSchema: z.ZodType<
+  WithdrawFaqResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  entryId: z.string(),
+  entryKey: z.string().optional(),
+  entryType: EntryType$inboundSchema,
+  latestVersion: z.number().int(),
+  publication: Publication$inboundSchema.optional(),
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+
+export function withdrawFaqResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<WithdrawFaqResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WithdrawFaqResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WithdrawFaqResponseContent' from JSON`,
+  );
+}

package/src/models/withdraw-skill-response-content.ts

@@ -0,0 +1,61 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 72c71a3bd208
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { EntryType, EntryType$inboundSchema } from "./entry-type.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+import { Publication, Publication$inboundSchema } from "./publication.js";
+
+export type WithdrawSkillResponseContent = {
+  /**
+   * Opaque stable entry identifier.
+   */
+  entryId: string;
+  /**
+   * Optional Playbook-unique immutable human-readable entry key.
+   */
+  entryKey?: string | undefined;
+  entryType: EntryType;
+  /**
+   * Newest immutable version number. Versions are append-only, so this also equals the version count.
+   */
+  latestVersion: number;
+  publication?: Publication | undefined;
+  /**
+   * UTC timestamp resolved to microsecond precision.
+   */
+  createdAt: Date;
+  /**
+   * Last create, append, publication change, or withdrawal of an existing publication. Repeating the current publication, already-unpublished withdrawal, and reads leave it unchanged. Publication/append updates never move this timestamp backwards.
+   */
+  updatedAt: Date;
+};
+
+/** @internal */
+export const WithdrawSkillResponseContent$inboundSchema: z.ZodType<
+  WithdrawSkillResponseContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  entryId: z.string(),
+  entryKey: z.string().optional(),
+  entryType: EntryType$inboundSchema,
+  latestVersion: z.number().int(),
+  publication: Publication$inboundSchema.optional(),
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+
+export function withdrawSkillResponseContentFromJSON(
+  jsonString: string,
+): SafeParseResult<WithdrawSkillResponseContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => WithdrawSkillResponseContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'WithdrawSkillResponseContent' from JSON`,
+  );
+}

package/src/sdk/index.ts

@@ -0,0 +1,6 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a4ac9d32aebc
+ */
+
+export * from "./sdk.js";