syllable-sdk 0.1.0-alpha.44 → 0.1.0-alpha.46

package/src/funcs/{dataSourcesGetByName.ts → dataSourcesGetById.ts}

@@ -30,9 +30,9 @@ import { Result } from "../types/fp.js";
  * @remarks
  * Fetch a given data source, including its text.
  */
-export async function dataSourcesGetByName(
+export async function dataSourcesGetById(
   client: SyllableSDKCore,
-  request: operations.DataSourcesGetByNameRequest,
+  request: operations.DataSourcesGetByIdRequest,
   options?: RequestOptions,
 ): Promise<
   Result<
@@ -49,8 +49,7 @@ export async function dataSourcesGetByName(
 > {
   const parsed = safeParse(
     request,
-    (value) =>
-      operations.DataSourcesGetByNameRequest$outboundSchema.parse(value),
+    (value) => operations.DataSourcesGetByIdRequest$outboundSchema.parse(value),
     "Input validation failed",
   );
   if (!parsed.ok) {
@@ -60,16 +59,13 @@ export async function dataSourcesGetByName(
   const body = null;
 
   const pathParams = {
-    data_source_name: encodeSimple(
-      "data_source_name",
-      payload.data_source_name,
-      { explode: false, charEncoding: "percent" },
-    ),
+    data_source_id: encodeSimple("data_source_id", payload.data_source_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
   };
 
-  const path = pathToFunc("/api/v1/data_sources/{data_source_name}")(
-    pathParams,
-  );
+  const path = pathToFunc("/api/v1/data_sources/{data_source_id}")(pathParams);
 
   const headers = new Headers(compactMap({
     Accept: "application/json",
@@ -81,7 +77,7 @@ export async function dataSourcesGetByName(
 
   const context = {
     baseURL: options?.serverURL ?? "",
-    operationID: "data_sources_get_by_name",
+    operationID: "data_sources_get_by_id",
     oAuth2Scopes: [],
 
     resolvedSecurity: requestSecurity,

package/src/funcs/v1Delete.ts

@@ -0,0 +1,147 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { SyllableSDKCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Delete Data Source
+ *
+ * @remarks
+ * Delete a given data source.
+ */
+export async function v1Delete(
+  client: SyllableSDKCore,
+  request: operations.DataSourcesDeleteRequest,
+  options?: RequestOptions,
+): Promise<
+  Result<
+    any,
+    | errors.HTTPValidationError
+    | SDKError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.DataSourcesDeleteRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return parsed;
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    data_source_id: encodeSimple("data_source_id", payload.data_source_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/api/v1/data_sources/{data_source_id}")(pathParams);
+
+  const query = encodeFormQuery({
+    "reason": payload.reason,
+  });
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKeyHeader);
+  const securityInput = secConfig == null ? {} : { apiKeyHeader: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    baseURL: options?.serverURL ?? "",
+    operationID: "data_sources_delete",
+    oAuth2Scopes: [],
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKeyHeader,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "DELETE",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    query: query,
+    body: body,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return requestRes;
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["422", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return doResult;
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    any,
+    | errors.HTTPValidationError
+    | SDKError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json(200, z.any()),
+    M.jsonErr(422, errors.HTTPValidationError$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, { extraFields: responseFields });
+  if (!result.ok) {
+    return result;
+  }
+
+  return result;
+}

package/src/funcs/v1GetById.ts

@@ -0,0 +1,142 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { SyllableSDKCore } from "../core.js";
+import { encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as components from "../models/components/index.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get Data Source
+ *
+ * @remarks
+ * Fetch a given data source, including its text.
+ */
+export async function v1GetById(
+  client: SyllableSDKCore,
+  request: operations.DataSourcesGetByIdRequest,
+  options?: RequestOptions,
+): Promise<
+  Result<
+    components.DataSourceDetailResponse,
+    | errors.HTTPValidationError
+    | SDKError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.DataSourcesGetByIdRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return parsed;
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    data_source_id: encodeSimple("data_source_id", payload.data_source_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/api/v1/data_sources/{data_source_id}")(pathParams);
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKeyHeader);
+  const securityInput = secConfig == null ? {} : { apiKeyHeader: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    baseURL: options?.serverURL ?? "",
+    operationID: "data_sources_get_by_id",
+    oAuth2Scopes: [],
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKeyHeader,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return requestRes;
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["422", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return doResult;
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    components.DataSourceDetailResponse,
+    | errors.HTTPValidationError
+    | SDKError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json(200, components.DataSourceDetailResponse$inboundSchema),
+    M.jsonErr(422, errors.HTTPValidationError$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, { extraFields: responseFields });
+  if (!result.ok) {
+    return result;
+  }
+
+  return result;
+}

package/src/lib/config.ts

@@ -57,8 +57,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.0.2",
-  sdkVersion: "0.1.0-alpha.44",
+  sdkVersion: "0.1.0-alpha.46",
   genVersion: "2.512.4",
   userAgent:
-    "speakeasy-sdk/typescript 0.1.0-alpha.44 2.512.4 0.0.2 syllable-sdk",
+    "speakeasy-sdk/typescript 0.1.0-alpha.46 2.512.4 0.0.2 syllable-sdk",
 } as const;

package/src/models/components/datasourcecreaterequest.ts

@@ -10,7 +10,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type DataSourceCreateRequest = {
   /**
-   * The data source name. Must be unique within suborg.
+   * The data source name. Must be unique within suborg. Cannot contain whitespace.
    */
   name: string;
   /**

package/src/models/components/datasourcedetailresponse.ts

@@ -13,7 +13,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  */
 export type DataSourceDetailResponse = {
   /**
-   * The data source name. Must be unique within suborg.
+   * The data source name. Must be unique within suborg. Cannot contain whitespace.
    */
   name: string;
   /**
@@ -32,6 +32,10 @@ export type DataSourceDetailResponse = {
    * String that should be treated as delimiter between intended chunks if chunk == True. This string will not be included in any chunks. Defaults to a blank line ('\n\n').
    */
   chunkDelimiter?: string | undefined;
+  /**
+   * The data source ID.
+   */
+  id: number;
   /**
    * The comments for the most recent edit to the data source
    */
@@ -61,6 +65,7 @@ export const DataSourceDetailResponse$inboundSchema: z.ZodType<
   labels: z.array(z.string()).optional(),
   chunk: z.boolean(),
   chunk_delimiter: z.string().default("\n\n"),
+  id: z.number().int(),
   edit_comments: z.nullable(z.string()).optional(),
   updated_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   last_updated_by: z.nullable(z.string()),
@@ -81,6 +86,7 @@ export type DataSourceDetailResponse$Outbound = {
   labels?: Array<string> | undefined;
   chunk: boolean;
   chunk_delimiter: string;
+  id: number;
   edit_comments?: string | null | undefined;
   updated_at: string;
   last_updated_by: string | null;
@@ -98,6 +104,7 @@ export const DataSourceDetailResponse$outboundSchema: z.ZodType<
   labels: z.array(z.string()).optional(),
   chunk: z.boolean(),
   chunkDelimiter: z.string().default("\n\n"),
+  id: z.number().int(),
   editComments: z.nullable(z.string()).optional(),
   updatedAt: z.date().transform(v => v.toISOString()),
   lastUpdatedBy: z.nullable(z.string()),

package/src/models/components/datasourcemetadataresponse.ts

@@ -13,7 +13,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  */
 export type DataSourceMetadataResponse = {
   /**
-   * The data source name. Must be unique within suborg.
+   * The data source name. Must be unique within suborg. Cannot contain whitespace.
    */
   name: string;
   /**
@@ -32,6 +32,10 @@ export type DataSourceMetadataResponse = {
    * String that should be treated as delimiter between intended chunks if chunk == True. This string will not be included in any chunks. Defaults to a blank line ('\n\n').
    */
   chunkDelimiter?: string | undefined;
+  /**
+   * The data source ID.
+   */
+  id: number;
   /**
    * The comments for the most recent edit to the data source
    */
@@ -57,6 +61,7 @@ export const DataSourceMetadataResponse$inboundSchema: z.ZodType<
   labels: z.array(z.string()).optional(),
   chunk: z.boolean(),
   chunk_delimiter: z.string().default("\n\n"),
+  id: z.number().int(),
   edit_comments: z.nullable(z.string()).optional(),
   updated_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   last_updated_by: z.nullable(z.string()),
@@ -76,6 +81,7 @@ export type DataSourceMetadataResponse$Outbound = {
   labels?: Array<string> | undefined;
   chunk: boolean;
   chunk_delimiter: string;
+  id: number;
   edit_comments?: string | null | undefined;
   updated_at: string;
   last_updated_by: string | null;
@@ -92,6 +98,7 @@ export const DataSourceMetadataResponse$outboundSchema: z.ZodType<
   labels: z.array(z.string()).optional(),
   chunk: z.boolean(),
   chunkDelimiter: z.string().default("\n\n"),
+  id: z.number().int(),
   editComments: z.nullable(z.string()).optional(),
   updatedAt: z.date().transform(v => v.toISOString()),
   lastUpdatedBy: z.nullable(z.string()),

package/src/models/components/datasourceupdaterequest.ts

@@ -10,7 +10,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type DataSourceUpdateRequest = {
   /**
-   * The data source name. Must be unique within suborg.
+   * The data source name. Must be unique within suborg. Cannot contain whitespace.
    */
   name: string;
   /**
@@ -29,6 +29,10 @@ export type DataSourceUpdateRequest = {
    * String that should be treated as delimiter between intended chunks if chunk == True. This string will not be included in any chunks. Defaults to a blank line ('\n\n').
    */
   chunkDelimiter?: string | undefined;
+  /**
+   * The data source ID.
+   */
+  id: number;
   /**
    * The comments for the most recent edit to the data source
    */
@@ -50,6 +54,7 @@ export const DataSourceUpdateRequest$inboundSchema: z.ZodType<
   labels: z.array(z.string()).optional(),
   chunk: z.boolean(),
   chunk_delimiter: z.string().default("\n\n"),
+  id: z.number().int(),
   edit_comments: z.nullable(z.string()).optional(),
   text: z.string(),
 }).transform((v) => {
@@ -66,6 +71,7 @@ export type DataSourceUpdateRequest$Outbound = {
   labels?: Array<string> | undefined;
   chunk: boolean;
   chunk_delimiter: string;
+  id: number;
   edit_comments?: string | null | undefined;
   text: string;
 };
@@ -81,6 +87,7 @@ export const DataSourceUpdateRequest$outboundSchema: z.ZodType<
   labels: z.array(z.string()).optional(),
   chunk: z.boolean(),
   chunkDelimiter: z.string().default("\n\n"),
+  id: z.number().int(),
   editComments: z.nullable(z.string()).optional(),
   text: z.string(),
 }).transform((v) => {

package/src/models/components/index.ts

@@ -81,6 +81,7 @@ export * from "./sttprovider.js";
 export * from "./targetmodes.js";
 export * from "./testmessage.js";
 export * from "./testmessageresponse.js";
+export * from "./toolagentinfo.js";
 export * from "./toolargumentlocation.js";
 export * from "./toolcreaterequest.js";
 export * from "./tooldefinition.js";

package/src/models/components/toolagentinfo.ts

@@ -0,0 +1,75 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Information about an agent linked to a tool via a prompt.
+ */
+export type ToolAgentInfo = {
+  /**
+   * The ID of the agent
+   */
+  id: number;
+  /**
+   * The name of the agent
+   */
+  name: string;
+};
+
+/** @internal */
+export const ToolAgentInfo$inboundSchema: z.ZodType<
+  ToolAgentInfo,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.number().int(),
+  name: z.string(),
+});
+
+/** @internal */
+export type ToolAgentInfo$Outbound = {
+  id: number;
+  name: string;
+};
+
+/** @internal */
+export const ToolAgentInfo$outboundSchema: z.ZodType<
+  ToolAgentInfo$Outbound,
+  z.ZodTypeDef,
+  ToolAgentInfo
+> = z.object({
+  id: z.number().int(),
+  name: z.string(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace ToolAgentInfo$ {
+  /** @deprecated use `ToolAgentInfo$inboundSchema` instead. */
+  export const inboundSchema = ToolAgentInfo$inboundSchema;
+  /** @deprecated use `ToolAgentInfo$outboundSchema` instead. */
+  export const outboundSchema = ToolAgentInfo$outboundSchema;
+  /** @deprecated use `ToolAgentInfo$Outbound` instead. */
+  export type Outbound = ToolAgentInfo$Outbound;
+}
+
+export function toolAgentInfoToJSON(toolAgentInfo: ToolAgentInfo): string {
+  return JSON.stringify(ToolAgentInfo$outboundSchema.parse(toolAgentInfo));
+}
+
+export function toolAgentInfoFromJSON(
+  jsonString: string,
+): SafeParseResult<ToolAgentInfo, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ToolAgentInfo$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ToolAgentInfo' from JSON`,
+  );
+}

package/src/models/components/tooldetailresponse.ts

@@ -7,6 +7,12 @@ import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  ToolAgentInfo,
+  ToolAgentInfo$inboundSchema,
+  ToolAgentInfo$Outbound,
+  ToolAgentInfo$outboundSchema,
+} from "./toolagentinfo.js";
 import {
   ToolDefinition,
   ToolDefinition$inboundSchema,
@@ -56,6 +62,10 @@ export type ToolDetailResponse = {
    * IDs and names of the prompts linked to the tool
    */
   promptsInfo?: Array<ToolPromptInfo> | null | undefined;
+  /**
+   * IDs and names of the agents linked to the tool via a prompt
+   */
+  agentsInfo?: Array<ToolAgentInfo> | null | undefined;
   /**
    * The timestamp of the most recent update to the service
    */
@@ -83,6 +93,7 @@ export const ToolDetailResponse$inboundSchema: z.ZodType<
   last_updated_comments: z.nullable(z.string()).optional(),
   service_name: z.nullable(z.string()).optional(),
   prompts_info: z.nullable(z.array(ToolPromptInfo$inboundSchema)).optional(),
+  agents_info: z.nullable(z.array(ToolAgentInfo$inboundSchema)).optional(),
   last_updated: z.string().datetime({ offset: true }).transform(v =>
     new Date(v)
   ),
@@ -94,6 +105,7 @@ export const ToolDetailResponse$inboundSchema: z.ZodType<
     "last_updated_comments": "lastUpdatedComments",
     "service_name": "serviceName",
     "prompts_info": "promptsInfo",
+    "agents_info": "agentsInfo",
     "last_updated": "lastUpdated",
     "last_updated_by": "lastUpdatedBy",
   });
@@ -108,6 +120,7 @@ export type ToolDetailResponse$Outbound = {
   last_updated_comments?: string | null | undefined;
   service_name?: string | null | undefined;
   prompts_info?: Array<ToolPromptInfo$Outbound> | null | undefined;
+  agents_info?: Array<ToolAgentInfo$Outbound> | null | undefined;
   last_updated: string;
   last_updated_by: string;
   fields: Array<string>;
@@ -126,6 +139,7 @@ export const ToolDetailResponse$outboundSchema: z.ZodType<
   lastUpdatedComments: z.nullable(z.string()).optional(),
   serviceName: z.nullable(z.string()).optional(),
   promptsInfo: z.nullable(z.array(ToolPromptInfo$outboundSchema)).optional(),
+  agentsInfo: z.nullable(z.array(ToolAgentInfo$outboundSchema)).optional(),
   lastUpdated: z.date().transform(v => v.toISOString()),
   lastUpdatedBy: z.string(),
   fields: z.array(z.string()),
@@ -135,6 +149,7 @@ export const ToolDetailResponse$outboundSchema: z.ZodType<
     lastUpdatedComments: "last_updated_comments",
     serviceName: "service_name",
     promptsInfo: "prompts_info",
+    agentsInfo: "agents_info",
     lastUpdated: "last_updated",
     lastUpdatedBy: "last_updated_by",
   });