syllable-sdk 0.0.9

package/src/lib/security.ts

@@ -0,0 +1,218 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as components from "../models/components/index.js";
+import { env } from "./env.js";
+
+export enum SecurityErrorCode {
+  Incomplete = "incomplete",
+  UnrecognisedSecurityType = "unrecognized_security_type",
+}
+
+export class SecurityError extends Error {
+  constructor(
+    public code: SecurityErrorCode,
+    message: string,
+  ) {
+    super(message);
+    this.name = "SecurityError";
+  }
+
+  static incomplete(): SecurityError {
+    return new SecurityError(
+      SecurityErrorCode.Incomplete,
+      "Security requirements not met in order to perform the operation",
+    );
+  }
+  static unrecognizedType(type: string): SecurityError {
+    return new SecurityError(
+      SecurityErrorCode.UnrecognisedSecurityType,
+      `Unrecognised security type: ${type}`,
+    );
+  }
+}
+
+export type SecurityState = {
+  basic: { username?: string | undefined; password?: string | undefined };
+  headers: Record<string, string>;
+  queryParams: Record<string, string>;
+  cookies: Record<string, string>;
+};
+
+type SecurityInputBasic = {
+  type: "http:basic";
+  value:
+    | { username?: string | undefined; password?: string | undefined }
+    | null
+    | undefined;
+};
+
+type SecurityInputBearer = {
+  type: "http:bearer";
+  value: string | null | undefined;
+  fieldName: string;
+};
+
+type SecurityInputAPIKey = {
+  type: "apiKey:header" | "apiKey:query" | "apiKey:cookie";
+  value: string | null | undefined;
+  fieldName: string;
+};
+
+type SecurityInputOIDC = {
+  type: "openIdConnect";
+  value: string | null | undefined;
+  fieldName: string;
+};
+
+type SecurityInputOAuth2 = {
+  type: "oauth2";
+  value: string | null | undefined;
+  fieldName: string;
+};
+
+type SecurityInputOAuth2ClientCredentials = {
+  type: "oauth2:client_credentials";
+  value: string | null | undefined;
+  fieldName: string;
+};
+
+type SecurityInputCustom = {
+  type: "http:custom";
+  value: any | null | undefined;
+  fieldName: string;
+};
+
+export type SecurityInput =
+  | SecurityInputBasic
+  | SecurityInputBearer
+  | SecurityInputAPIKey
+  | SecurityInputOAuth2
+  | SecurityInputOAuth2ClientCredentials
+  | SecurityInputOIDC
+  | SecurityInputCustom;
+
+export function resolveSecurity(
+  ...options: SecurityInput[][]
+): SecurityState | null {
+  const state: SecurityState = {
+    basic: { username: "", password: "" },
+    headers: {},
+    queryParams: {},
+    cookies: {},
+  };
+
+  const option = options.find((opts) => {
+    return opts.every((o) => {
+      if (o.value == null) {
+        return false;
+      } else if (o.type === "http:basic") {
+        return o.value.username != null || o.value.password != null;
+      } else if (o.type === "http:custom") {
+        return null;
+      } else if (typeof o.value === "string") {
+        return !!o.value;
+      } else {
+        throw new Error(
+          `Unrecognized security type: ${o.type} (value type: ${typeof o
+            .value})`,
+        );
+      }
+    });
+  });
+  if (option == null) {
+    return null;
+  }
+
+  option.forEach((spec) => {
+    if (spec.value == null) {
+      return;
+    }
+
+    const { type } = spec;
+
+    switch (type) {
+      case "apiKey:header":
+        state.headers[spec.fieldName] = spec.value;
+        break;
+      case "apiKey:query":
+        state.queryParams[spec.fieldName] = spec.value;
+        break;
+      case "apiKey:cookie":
+        state.cookies[spec.fieldName] = spec.value;
+        break;
+      case "http:basic":
+        applyBasic(state, spec);
+        break;
+      case "http:custom":
+        break;
+      case "http:bearer":
+        applyBearer(state, spec);
+        break;
+      case "oauth2":
+        applyBearer(state, spec);
+        break;
+      case "oauth2:client_credentials":
+        break;
+      case "openIdConnect":
+        applyBearer(state, spec);
+        break;
+      default:
+        spec satisfies never;
+        throw SecurityError.unrecognizedType(type);
+    }
+  });
+
+  return state;
+}
+
+function applyBasic(
+  state: SecurityState,
+  spec: SecurityInputBasic,
+) {
+  if (spec.value == null) {
+    return;
+  }
+
+  state.basic = spec.value;
+}
+
+function applyBearer(
+  state: SecurityState,
+  spec: SecurityInputBearer | SecurityInputOAuth2 | SecurityInputOIDC,
+) {
+  if (spec.value == null) {
+    return;
+  }
+
+  let value = spec.value;
+  if (value.slice(0, 7).toLowerCase() !== "bearer ") {
+    value = `Bearer ${value}`;
+  }
+
+  state.headers[spec.fieldName] = value;
+}
+export function resolveGlobalSecurity(
+  security: Partial<components.Security> | null | undefined,
+): SecurityState | null {
+  return resolveSecurity(
+    [
+      {
+        fieldName: "Syllable-API-Key",
+        type: "apiKey:header",
+        value: security?.apiKeyHeader ?? env().SYLLABLESDK_API_KEY_HEADER,
+      },
+    ],
+  );
+}
+
+export async function extractSecurity<
+  T extends string | Record<string, unknown>,
+>(sec: T | (() => Promise<T>) | undefined): Promise<T | undefined> {
+  if (sec == null) {
+    return;
+  }
+
+  return typeof sec === "function" ? sec() : sec;
+}

package/src/lib/url.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+const hasOwn = Object.prototype.hasOwnProperty;
+
+export type Params = Partial<Record<string, string | number>>;
+
+export function pathToFunc(
+  pathPattern: string,
+  options?: { charEncoding?: "percent" | "none" },
+): (params?: Params) => string {
+  const paramRE = /\{([a-zA-Z0-9_]+?)\}/g;
+
+  return function buildURLPath(params: Record<string, unknown> = {}): string {
+    return pathPattern.replace(paramRE, function (_, placeholder) {
+      if (!hasOwn.call(params, placeholder)) {
+        throw new Error(`Parameter '${placeholder}' is required`);
+      }
+
+      const value = params[placeholder];
+      if (typeof value !== "string" && typeof value !== "number") {
+        throw new Error(
+          `Parameter '${placeholder}' must be a string or number`,
+        );
+      }
+
+      return options?.charEncoding === "percent"
+        ? encodeURIComponent(`${value}`)
+        : `${value}`;
+    });
+  };
+}

package/src/models/components/agent.ts

@@ -0,0 +1,134 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { remap as remap$ } from "../../lib/primitives.js";
+import {
+  AgentToolDefaults,
+  AgentToolDefaults$inboundSchema,
+  AgentToolDefaults$Outbound,
+  AgentToolDefaults$outboundSchema,
+} from "./agenttooldefaults.js";
+
+export type Variables = {};
+
+export type Agent = {
+  name: string;
+  timezone: string;
+  type: string;
+  promptId: number;
+  customMessageId: number | null;
+  languages: Array<string>;
+  promptToolDefaults?: Array<AgentToolDefaults> | undefined;
+  toolHeaders?: { [k: string]: string } | null | undefined;
+  variables?: Variables | null | undefined;
+  /**
+   * The Agent ID
+   */
+  id: number;
+};
+
+/** @internal */
+export const Variables$inboundSchema: z.ZodType<
+  Variables,
+  z.ZodTypeDef,
+  unknown
+> = z.object({});
+
+/** @internal */
+export type Variables$Outbound = {};
+
+/** @internal */
+export const Variables$outboundSchema: z.ZodType<
+  Variables$Outbound,
+  z.ZodTypeDef,
+  Variables
+> = z.object({});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace Variables$ {
+  /** @deprecated use `Variables$inboundSchema` instead. */
+  export const inboundSchema = Variables$inboundSchema;
+  /** @deprecated use `Variables$outboundSchema` instead. */
+  export const outboundSchema = Variables$outboundSchema;
+  /** @deprecated use `Variables$Outbound` instead. */
+  export type Outbound = Variables$Outbound;
+}
+
+/** @internal */
+export const Agent$inboundSchema: z.ZodType<Agent, z.ZodTypeDef, unknown> = z
+  .object({
+    name: z.string(),
+    timezone: z.string(),
+    type: z.string(),
+    prompt_id: z.number().int(),
+    custom_message_id: z.nullable(z.number().int()),
+    languages: z.array(z.string()),
+    prompt_tool_defaults: z.array(AgentToolDefaults$inboundSchema).optional(),
+    tool_headers: z.nullable(z.record(z.string())).optional(),
+    variables: z.nullable(z.lazy(() => Variables$inboundSchema)).optional(),
+    id: z.number().int(),
+  }).transform((v) => {
+    return remap$(v, {
+      "prompt_id": "promptId",
+      "custom_message_id": "customMessageId",
+      "prompt_tool_defaults": "promptToolDefaults",
+      "tool_headers": "toolHeaders",
+    });
+  });
+
+/** @internal */
+export type Agent$Outbound = {
+  name: string;
+  timezone: string;
+  type: string;
+  prompt_id: number;
+  custom_message_id: number | null;
+  languages: Array<string>;
+  prompt_tool_defaults?: Array<AgentToolDefaults$Outbound> | undefined;
+  tool_headers?: { [k: string]: string } | null | undefined;
+  variables?: Variables$Outbound | null | undefined;
+  id: number;
+};
+
+/** @internal */
+export const Agent$outboundSchema: z.ZodType<
+  Agent$Outbound,
+  z.ZodTypeDef,
+  Agent
+> = z.object({
+  name: z.string(),
+  timezone: z.string(),
+  type: z.string(),
+  promptId: z.number().int(),
+  customMessageId: z.nullable(z.number().int()),
+  languages: z.array(z.string()),
+  promptToolDefaults: z.array(AgentToolDefaults$outboundSchema).optional(),
+  toolHeaders: z.nullable(z.record(z.string())).optional(),
+  variables: z.nullable(z.lazy(() => Variables$outboundSchema)).optional(),
+  id: z.number().int(),
+}).transform((v) => {
+  return remap$(v, {
+    promptId: "prompt_id",
+    customMessageId: "custom_message_id",
+    promptToolDefaults: "prompt_tool_defaults",
+    toolHeaders: "tool_headers",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace Agent$ {
+  /** @deprecated use `Agent$inboundSchema` instead. */
+  export const inboundSchema = Agent$inboundSchema;
+  /** @deprecated use `Agent$outboundSchema` instead. */
+  export const outboundSchema = Agent$outboundSchema;
+  /** @deprecated use `Agent$Outbound` instead. */
+  export type Outbound = Agent$Outbound;
+}

package/src/models/components/agentcreate.ts

@@ -0,0 +1,132 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { remap as remap$ } from "../../lib/primitives.js";
+import {
+  AgentToolDefaults,
+  AgentToolDefaults$inboundSchema,
+  AgentToolDefaults$Outbound,
+  AgentToolDefaults$outboundSchema,
+} from "./agenttooldefaults.js";
+
+export type AgentCreateVariables = {};
+
+export type AgentCreate = {
+  name: string;
+  timezone: string;
+  type: string;
+  promptId: number;
+  customMessageId: number | null;
+  languages: Array<string>;
+  promptToolDefaults?: Array<AgentToolDefaults> | undefined;
+  toolHeaders?: { [k: string]: string } | null | undefined;
+  variables?: AgentCreateVariables | null | undefined;
+};
+
+/** @internal */
+export const AgentCreateVariables$inboundSchema: z.ZodType<
+  AgentCreateVariables,
+  z.ZodTypeDef,
+  unknown
+> = z.object({});
+
+/** @internal */
+export type AgentCreateVariables$Outbound = {};
+
+/** @internal */
+export const AgentCreateVariables$outboundSchema: z.ZodType<
+  AgentCreateVariables$Outbound,
+  z.ZodTypeDef,
+  AgentCreateVariables
+> = z.object({});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace AgentCreateVariables$ {
+  /** @deprecated use `AgentCreateVariables$inboundSchema` instead. */
+  export const inboundSchema = AgentCreateVariables$inboundSchema;
+  /** @deprecated use `AgentCreateVariables$outboundSchema` instead. */
+  export const outboundSchema = AgentCreateVariables$outboundSchema;
+  /** @deprecated use `AgentCreateVariables$Outbound` instead. */
+  export type Outbound = AgentCreateVariables$Outbound;
+}
+
+/** @internal */
+export const AgentCreate$inboundSchema: z.ZodType<
+  AgentCreate,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string(),
+  timezone: z.string(),
+  type: z.string(),
+  prompt_id: z.number().int(),
+  custom_message_id: z.nullable(z.number().int()),
+  languages: z.array(z.string()),
+  prompt_tool_defaults: z.array(AgentToolDefaults$inboundSchema).optional(),
+  tool_headers: z.nullable(z.record(z.string())).optional(),
+  variables: z.nullable(z.lazy(() => AgentCreateVariables$inboundSchema))
+    .optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "prompt_id": "promptId",
+    "custom_message_id": "customMessageId",
+    "prompt_tool_defaults": "promptToolDefaults",
+    "tool_headers": "toolHeaders",
+  });
+});
+
+/** @internal */
+export type AgentCreate$Outbound = {
+  name: string;
+  timezone: string;
+  type: string;
+  prompt_id: number;
+  custom_message_id: number | null;
+  languages: Array<string>;
+  prompt_tool_defaults?: Array<AgentToolDefaults$Outbound> | undefined;
+  tool_headers?: { [k: string]: string } | null | undefined;
+  variables?: AgentCreateVariables$Outbound | null | undefined;
+};
+
+/** @internal */
+export const AgentCreate$outboundSchema: z.ZodType<
+  AgentCreate$Outbound,
+  z.ZodTypeDef,
+  AgentCreate
+> = z.object({
+  name: z.string(),
+  timezone: z.string(),
+  type: z.string(),
+  promptId: z.number().int(),
+  customMessageId: z.nullable(z.number().int()),
+  languages: z.array(z.string()),
+  promptToolDefaults: z.array(AgentToolDefaults$outboundSchema).optional(),
+  toolHeaders: z.nullable(z.record(z.string())).optional(),
+  variables: z.nullable(z.lazy(() => AgentCreateVariables$outboundSchema))
+    .optional(),
+}).transform((v) => {
+  return remap$(v, {
+    promptId: "prompt_id",
+    customMessageId: "custom_message_id",
+    promptToolDefaults: "prompt_tool_defaults",
+    toolHeaders: "tool_headers",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace AgentCreate$ {
+  /** @deprecated use `AgentCreate$inboundSchema` instead. */
+  export const inboundSchema = AgentCreate$inboundSchema;
+  /** @deprecated use `AgentCreate$outboundSchema` instead. */
+  export const outboundSchema = AgentCreate$outboundSchema;
+  /** @deprecated use `AgentCreate$Outbound` instead. */
+  export type Outbound = AgentCreate$Outbound;
+}

package/src/models/components/agentproperties.ts

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../../types/enums.js";
+
+export const AgentProperties = {
+  Id: "id",
+  Name: "name",
+  Type: "type",
+  Timezone: "timezone",
+  PromptId: "prompt_id",
+  CustomMessageId: "custom_message_id",
+  Languages: "languages",
+  Variables: "variables",
+  PromptToolDefaults: "prompt_tool_defaults",
+  ToolHeaders: "tool_headers",
+} as const;
+export type AgentProperties = ClosedEnum<typeof AgentProperties>;
+
+/** @internal */
+export const AgentProperties$inboundSchema: z.ZodNativeEnum<
+  typeof AgentProperties
+> = z.nativeEnum(AgentProperties);
+
+/** @internal */
+export const AgentProperties$outboundSchema: z.ZodNativeEnum<
+  typeof AgentProperties
+> = AgentProperties$inboundSchema;
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace AgentProperties$ {
+  /** @deprecated use `AgentProperties$inboundSchema` instead. */
+  export const inboundSchema = AgentProperties$inboundSchema;
+  /** @deprecated use `AgentProperties$outboundSchema` instead. */
+  export const outboundSchema = AgentProperties$outboundSchema;
+}

package/src/models/components/agenttooldefaults.ts

@@ -0,0 +1,66 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { remap as remap$ } from "../../lib/primitives.js";
+import {
+  AgentToolFieldDefault,
+  AgentToolFieldDefault$inboundSchema,
+  AgentToolFieldDefault$Outbound,
+  AgentToolFieldDefault$outboundSchema,
+} from "./agenttoolfielddefault.js";
+
+export type AgentToolDefaults = {
+  toolName: string;
+  defaultValues: Array<AgentToolFieldDefault>;
+};
+
+/** @internal */
+export const AgentToolDefaults$inboundSchema: z.ZodType<
+  AgentToolDefaults,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  tool_name: z.string(),
+  default_values: z.array(AgentToolFieldDefault$inboundSchema),
+}).transform((v) => {
+  return remap$(v, {
+    "tool_name": "toolName",
+    "default_values": "defaultValues",
+  });
+});
+
+/** @internal */
+export type AgentToolDefaults$Outbound = {
+  tool_name: string;
+  default_values: Array<AgentToolFieldDefault$Outbound>;
+};
+
+/** @internal */
+export const AgentToolDefaults$outboundSchema: z.ZodType<
+  AgentToolDefaults$Outbound,
+  z.ZodTypeDef,
+  AgentToolDefaults
+> = z.object({
+  toolName: z.string(),
+  defaultValues: z.array(AgentToolFieldDefault$outboundSchema),
+}).transform((v) => {
+  return remap$(v, {
+    toolName: "tool_name",
+    defaultValues: "default_values",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace AgentToolDefaults$ {
+  /** @deprecated use `AgentToolDefaults$inboundSchema` instead. */
+  export const inboundSchema = AgentToolDefaults$inboundSchema;
+  /** @deprecated use `AgentToolDefaults$outboundSchema` instead. */
+  export const outboundSchema = AgentToolDefaults$outboundSchema;
+  /** @deprecated use `AgentToolDefaults$Outbound` instead. */
+  export type Outbound = AgentToolDefaults$Outbound;
+}

package/src/models/components/agenttoolfielddefault.ts

@@ -0,0 +1,60 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { remap as remap$ } from "../../lib/primitives.js";
+
+export type AgentToolFieldDefault = {
+  fieldName: string;
+  defaultValue?: any | undefined;
+};
+
+/** @internal */
+export const AgentToolFieldDefault$inboundSchema: z.ZodType<
+  AgentToolFieldDefault,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  field_name: z.string(),
+  default_value: z.any().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "field_name": "fieldName",
+    "default_value": "defaultValue",
+  });
+});
+
+/** @internal */
+export type AgentToolFieldDefault$Outbound = {
+  field_name: string;
+  default_value?: any | undefined;
+};
+
+/** @internal */
+export const AgentToolFieldDefault$outboundSchema: z.ZodType<
+  AgentToolFieldDefault$Outbound,
+  z.ZodTypeDef,
+  AgentToolFieldDefault
+> = z.object({
+  fieldName: z.string(),
+  defaultValue: z.any().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    fieldName: "field_name",
+    defaultValue: "default_value",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace AgentToolFieldDefault$ {
+  /** @deprecated use `AgentToolFieldDefault$inboundSchema` instead. */
+  export const inboundSchema = AgentToolFieldDefault$inboundSchema;
+  /** @deprecated use `AgentToolFieldDefault$outboundSchema` instead. */
+  export const outboundSchema = AgentToolFieldDefault$outboundSchema;
+  /** @deprecated use `AgentToolFieldDefault$Outbound` instead. */
+  export type Outbound = AgentToolFieldDefault$Outbound;
+}