syllable-sdk 0.1.0-alpha.231 → 0.1.0-alpha.233

package/openapi.json

@@ -5476,7 +5476,7 @@
           "prompts"
         ],
         "summary": "Get Prompt History",
-        "description": "Get a prompt by ID",
+        "description": "Get a list of historical versions of a prompt by its ID",
         "operationId": "prompts_history",
         "security": [
           {
@@ -13032,7 +13032,7 @@
             "title": "Batch Id",
             "description": "Unique ID for conversation batch",
             "examples": [
-              "20250805.9"
+              "20250806.9"
             ]
           },
           "campaign_id": {
@@ -13056,7 +13056,7 @@
             "title": "Expires On",
             "description": "Timestamp of batch expiration",
             "examples": [
-              "2025-08-06T00:00:00Z"
+              "2025-08-07T00:00:00Z"
             ]
           },
           "paused": {
@@ -13109,7 +13109,7 @@
             "title": "Created At",
             "description": "Timestamp of batch creation",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "deleted_at": {
@@ -13125,7 +13125,7 @@
             "title": "Deleted At",
             "description": "Timestamp of batch deletion",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "deleted_reason": {
@@ -13156,7 +13156,7 @@
             "title": "Last Updated At",
             "description": "Timestamp of last change to batch",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "last_updated_by": {
@@ -13858,7 +13858,7 @@
             "title": "Batch Id",
             "description": "Unique ID for conversation batch",
             "examples": [
-              "20250805.9"
+              "20250806.9"
             ]
           },
           "campaign_id": {
@@ -13882,7 +13882,7 @@
             "title": "Expires On",
             "description": "Timestamp of batch expiration",
             "examples": [
-              "2025-08-06T00:00:00Z"
+              "2025-08-07T00:00:00Z"
             ]
           },
           "paused": {
@@ -13935,7 +13935,7 @@
             "title": "Created At",
             "description": "Timestamp of batch creation",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "deleted_at": {
@@ -13951,7 +13951,7 @@
             "title": "Deleted At",
             "description": "Timestamp of batch deletion",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "deleted_reason": {
@@ -13982,7 +13982,7 @@
             "title": "Last Updated At",
             "description": "Timestamp of last change to batch",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "last_updated_by": {
@@ -14025,7 +14025,7 @@
             "title": "Batch Id",
             "description": "Unique ID for conversation batch",
             "examples": [
-              "20250805.9"
+              "20250806.9"
             ]
           },
           "campaign_id": {
@@ -14049,7 +14049,7 @@
             "title": "Expires On",
             "description": "Timestamp of batch expiration",
             "examples": [
-              "2025-08-06T00:00:00Z"
+              "2025-08-07T00:00:00Z"
             ]
           },
           "paused": {
@@ -14198,7 +14198,7 @@
             "title": "Created At",
             "description": "Timestamp of request creation",
             "examples": [
-              "2025-08-04T00:00:00Z"
+              "2025-08-05T00:00:00Z"
             ]
           },
           "sent_at": {
@@ -14214,7 +14214,7 @@
             "title": "Sent At",
             "description": "Timestamp at which request was sent",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "attempt_count": {
@@ -16130,7 +16130,7 @@
             "title": "Created At",
             "description": "Timestamp at which insight upload folder was created",
             "examples": [
-              "2025-08-04T00:00:00Z"
+              "2025-08-05T00:00:00Z"
             ]
           },
           "updated_at": {
@@ -16139,7 +16139,7 @@
             "title": "Updated At",
             "description": "Timestamp at which insight upload folder was last updated",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "last_updated_by": {
@@ -16854,7 +16854,7 @@
             "title": "Created At",
             "description": "Timestamp of at which insight tool configuration was created",
             "examples": [
-              "2025-08-04T00:00:00Z"
+              "2025-08-05T00:00:00Z"
             ]
           },
           "updated_at": {
@@ -16863,7 +16863,7 @@
             "title": "Updated At",
             "description": "Timestamp at which insight tool configuration was last updated",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "last_updated_by": {
@@ -17244,7 +17244,7 @@
             "title": "Start Datetime",
             "description": "Target session timestamp the workflow (backfill) should start. An empty value indicates start on activation - live sessions only",
             "examples": [
-              "2025-08-04T00:00:00Z"
+              "2025-08-05T00:00:00Z"
             ]
           },
           "end_datetime": {
@@ -17260,7 +17260,7 @@
             "title": "End Datetime",
             "description": "Target session timestamp the workflow (backfill) should end. An empty value indicates no end, i.e., include live sessions until deactivation",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           }
         },
@@ -17335,7 +17335,7 @@
             "title": "Start Datetime",
             "description": "Target session timestamp the workflow (backfill) should start. An empty value indicates start on activation - live sessions only",
             "examples": [
-              "2025-08-04T00:00:00Z"
+              "2025-08-05T00:00:00Z"
             ]
           },
           "end_datetime": {
@@ -17351,7 +17351,7 @@
             "title": "End Datetime",
             "description": "Target session timestamp the workflow (backfill) should end. An empty value indicates no end, i.e., include live sessions until deactivation",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "id": {
@@ -17404,7 +17404,7 @@
             "title": "Created At",
             "description": "Timestamp at which the insight workflow was created",
             "examples": [
-              "2025-08-04T00:00:00Z"
+              "2025-08-05T00:00:00Z"
             ]
           },
           "updated_at": {
@@ -17413,7 +17413,7 @@
             "title": "Updated At",
             "description": "Timestamp of most recent update to the insight workflow",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "last_updated_by": {
@@ -17509,7 +17509,7 @@
             "title": "Created At",
             "description": "Timestamp at which insight upload folder was created",
             "examples": [
-              "2025-08-04T00:00:00Z"
+              "2025-08-05T00:00:00Z"
             ]
           },
           "updated_at": {
@@ -17518,7 +17518,7 @@
             "title": "Updated At",
             "description": "Timestamp at which insight upload folder was last updated",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "last_updated_by": {
@@ -17753,7 +17753,7 @@
             "title": "Created At",
             "description": "Timestamp at which insight tool result was created",
             "examples": [
-              "2025-08-04T00:00:00Z"
+              "2025-08-05T00:00:00Z"
             ]
           },
           "updated_at": {
@@ -17762,7 +17762,7 @@
             "title": "Updated At",
             "description": "Timestamp at which insight tool result was last updated",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           }
         },
@@ -17897,7 +17897,7 @@
             "title": "Start Time",
             "description": "Start time of the uploaded file",
             "examples": [
-              "2025-08-04T00:00:00Z"
+              "2025-08-05T00:00:00Z"
             ]
           },
           "end_time": {
@@ -17913,7 +17913,7 @@
             "title": "End Time",
             "description": "End time of the uploaded file",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "error_message": {
@@ -17968,7 +17968,7 @@
             "title": "Created At",
             "description": "Timestamp at which insight upload file was created",
             "examples": [
-              "2025-08-04T00:00:00Z"
+              "2025-08-05T00:00:00Z"
             ]
           }
         },
@@ -18117,7 +18117,7 @@
           "th-TH",
           "vi-VN",
           "bs-BA",
-          "sw"
+          "sw-KE"
         ],
         "title": "LanguageCode",
         "description": "BCP 47 codes of languages that Syllable supports."
@@ -20861,7 +20861,7 @@
             "title": "Created At",
             "description": "Timestamp of campaign creation",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "updated_at": {
@@ -20870,7 +20870,7 @@
             "title": "Updated At",
             "description": "Timestamp of campaign update",
             "examples": [
-              "2025-08-05T00:00:00Z"
+              "2025-08-06T00:00:00Z"
             ]
           },
           "last_updated_by": {
@@ -21261,7 +21261,7 @@
             "type": "string",
             "format": "date-time",
             "title": "Timestamp",
-            "description": "Timestamp of the change",
+            "description": "Timestamp of the change resulting in this version",
             "examples": [
               "2024-01-01T12:00:00Z"
             ]
@@ -21274,10 +21274,18 @@
               "1"
             ]
           },
+          "version_number": {
+            "type": "integer",
+            "title": "Version Number",
+            "description": "Version number of this version. Starts at 1 when prompt is created, and incremented on each change.",
+            "examples": [
+              1
+            ]
+          },
           "prompt_text": {
             "type": "string",
             "title": "Prompt Text",
-            "description": "Text of the prompt",
+            "description": "Text of the prompt at this version",
             "examples": [
               "You are a weather agent. Answer the user's questions about weather and nothing else."
             ]
@@ -21292,7 +21300,7 @@
               }
             ],
             "title": "Prompt Description",
-            "description": "Description of the prompt",
+            "description": "Description of the prompt at this version",
             "examples": [
               "Prompt for a weather agent."
             ]
@@ -21300,7 +21308,7 @@
           "prompt_name": {
             "type": "string",
             "title": "Prompt Name",
-            "description": "Name of the prompt",
+            "description": "Name of the prompt at this version",
             "examples": [
               "Weather Agent Prompt"
             ]
@@ -21315,7 +21323,7 @@
               }
             ],
             "title": "Llm Config",
-            "description": "String representation of LLM config for the prompt"
+            "description": "String representation of LLM config for the prompt at this version"
           },
           "comments": {
             "anyOf": [
@@ -21327,7 +21335,7 @@
               }
             ],
             "title": "Comments",
-            "description": "Comments describing the change",
+            "description": "Comments describing the change that resulted in this version",
             "examples": [
               "Updated prompt text to include requirement to not answer questions that aren't about weather."
             ]
@@ -21335,22 +21343,86 @@
           "user_email": {
             "type": "string",
             "title": "User Email",
-            "description": "Email address of the user who made the change",
+            "description": "Email address of the user who made the change that resulted in this version",
             "examples": [
               "user@email.com"
             ]
+          },
+          "linked_tools": {
+            "items": {
+              "$ref": "#/components/schemas/PromptHistoryLinkedTool"
+            },
+            "type": "array",
+            "title": "Linked Tools",
+            "description": "Tools that were linked to this version of the prompt",
+            "default": []
+          },
+          "is_pre_enhancements": {
+            "type": "boolean",
+            "title": "Is Pre Enhancements",
+            "description": "Whether this version of the prompt was created before history of tool-prompt linking was tracked",
+            "examples": [
+              true
+            ]
           }
         },
         "type": "object",
         "required": [
           "timestamp",
           "prompt_id",
+          "version_number",
           "prompt_text",
           "prompt_name",
-          "user_email"
+          "user_email",
+          "is_pre_enhancements"
         ],
         "title": "PromptHistory",
-        "description": "Record of a change to a prompt. Values reflect post-change state."
+        "description": "Record of a specific version of a prompt."
+      },
+      "PromptHistoryLinkedTool": {
+        "properties": {
+          "tool_id": {
+            "type": "integer",
+            "title": "Tool Id",
+            "description": "ID of the tool",
+            "examples": [
+              1
+            ]
+          },
+          "current_tool_name": {
+            "type": "string",
+            "title": "Current Tool Name",
+            "description": "Current name of the tool (may have been different at the time the given version of the prompt was created)",
+            "examples": [
+              "hangup"
+            ]
+          },
+          "out_of_date": {
+            "type": "boolean",
+            "title": "Out Of Date",
+            "description": "Whether the tool has changed (not including being deleted) since the given version of the prompt was created",
+            "examples": [
+              false
+            ]
+          },
+          "deleted": {
+            "type": "boolean",
+            "title": "Deleted",
+            "description": "Whether the tool has been deleted since the given version of the prompt was created",
+            "examples": [
+              false
+            ]
+          }
+        },
+        "type": "object",
+        "required": [
+          "tool_id",
+          "current_tool_name",
+          "out_of_date",
+          "deleted"
+        ],
+        "title": "PromptHistoryLinkedTool",
+        "description": "Record of a tool linked to a previous prompt version in the prompt history."
       },
       "PromptLlmConfig": {
         "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "syllable-sdk",
-  "version": "0.1.0-alpha.231",
+  "version": "0.1.0-alpha.233",
   "author": "Syllable",
   "main": "./index.js",
   "sideEffects": false,

package/sdk/prompts.d.ts

@@ -41,7 +41,7 @@ export declare class Prompts extends ClientSDK {
      * Get Prompt History
      *
      * @remarks
-     * Get a prompt by ID
+     * Get a list of historical versions of a prompt by its ID
      */
     promptsHistory(request: operations.PromptsHistoryRequest, options?: RequestOptions): Promise<Array<components.PromptHistory>>;
     /**

package/sdk/prompts.js

@@ -63,7 +63,7 @@ class Prompts extends sdks_js_1.ClientSDK {
      * Get Prompt History
      *
      * @remarks
-     * Get a prompt by ID
+     * Get a list of historical versions of a prompt by its ID
      */
     async promptsHistory(request, options) {
         return (0, fp_js_1.unwrapAsync)((0, promptsPromptsHistory_js_1.promptsPromptsHistory)(this, request, options));

package/src/funcs/promptsPromptsHistory.ts

@@ -29,7 +29,7 @@ import { Result } from "../types/fp.js";
  * Get Prompt History
  *
  * @remarks
- * Get a prompt by ID
+ * Get a list of historical versions of a prompt by its ID
  */
 export async function promptsPromptsHistory(
   client: SyllableSDKCore,

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.231",
+  sdkVersion: "0.1.0-alpha.233",
   genVersion: "2.512.4",
   userAgent:
-    "speakeasy-sdk/typescript 0.1.0-alpha.231 2.512.4 0.0.2 syllable-sdk",
+    "speakeasy-sdk/typescript 0.1.0-alpha.233 2.512.4 0.0.2 syllable-sdk",
 } as const;

package/src/models/components/index.ts

@@ -140,6 +140,7 @@ export * from "./permissiongroupresponse.js";
 export * from "./permissionresponse.js";
 export * from "./promptcreaterequest.js";
 export * from "./prompthistory.js";
+export * from "./prompthistorylinkedtool.js";
 export * from "./promptllmconfig.js";
 export * from "./promptllmprovider.js";
 export * from "./promptproperties.js";

package/src/models/components/languagecode.ts

@@ -18,7 +18,7 @@ export const LanguageCode = {
   THTH: "th-TH",
   ViVN: "vi-VN",
   BsBA: "bs-BA",
-  Sw: "sw",
+  SwKE: "sw-KE",
 } as const;
 /**
  * BCP 47 codes of languages that Syllable supports.

package/src/models/components/prompthistory.ts

@@ -7,13 +7,19 @@ 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 {
+  PromptHistoryLinkedTool,
+  PromptHistoryLinkedTool$inboundSchema,
+  PromptHistoryLinkedTool$Outbound,
+  PromptHistoryLinkedTool$outboundSchema,
+} from "./prompthistorylinkedtool.js";
 
 /**
- * Record of a change to a prompt. Values reflect post-change state.
+ * Record of a specific version of a prompt.
  */
 export type PromptHistory = {
   /**
-   * Timestamp of the change
+   * Timestamp of the change resulting in this version
    */
   timestamp: Date;
   /**
@@ -21,29 +27,41 @@ export type PromptHistory = {
    */
   promptId: string;
   /**
-   * Text of the prompt
+   * Version number of this version. Starts at 1 when prompt is created, and incremented on each change.
+   */
+  versionNumber: number;
+  /**
+   * Text of the prompt at this version
    */
   promptText: string;
   /**
-   * Description of the prompt
+   * Description of the prompt at this version
    */
   promptDescription?: string | null | undefined;
   /**
-   * Name of the prompt
+   * Name of the prompt at this version
    */
   promptName: string;
   /**
-   * String representation of LLM config for the prompt
+   * String representation of LLM config for the prompt at this version
    */
   llmConfig?: string | null | undefined;
   /**
-   * Comments describing the change
+   * Comments describing the change that resulted in this version
    */
   comments?: string | null | undefined;
   /**
-   * Email address of the user who made the change
+   * Email address of the user who made the change that resulted in this version
    */
   userEmail: string;
+  /**
+   * Tools that were linked to this version of the prompt
+   */
+  linkedTools?: Array<PromptHistoryLinkedTool> | undefined;
+  /**
+   * Whether this version of the prompt was created before history of tool-prompt linking was tracked
+   */
+  isPreEnhancements: boolean;
 };
 
 /** @internal */
@@ -54,20 +72,26 @@ export const PromptHistory$inboundSchema: z.ZodType<
 > = z.object({
   timestamp: z.string().datetime({ offset: true }).transform(v => new Date(v)),
   prompt_id: z.string(),
+  version_number: z.number().int(),
   prompt_text: z.string(),
   prompt_description: z.nullable(z.string()).optional(),
   prompt_name: z.string(),
   llm_config: z.nullable(z.string()).optional(),
   comments: z.nullable(z.string()).optional(),
   user_email: z.string(),
+  linked_tools: z.array(PromptHistoryLinkedTool$inboundSchema).optional(),
+  is_pre_enhancements: z.boolean(),
 }).transform((v) => {
   return remap$(v, {
     "prompt_id": "promptId",
+    "version_number": "versionNumber",
     "prompt_text": "promptText",
     "prompt_description": "promptDescription",
     "prompt_name": "promptName",
     "llm_config": "llmConfig",
     "user_email": "userEmail",
+    "linked_tools": "linkedTools",
+    "is_pre_enhancements": "isPreEnhancements",
   });
 });
 
@@ -75,12 +99,15 @@ export const PromptHistory$inboundSchema: z.ZodType<
 export type PromptHistory$Outbound = {
   timestamp: string;
   prompt_id: string;
+  version_number: number;
   prompt_text: string;
   prompt_description?: string | null | undefined;
   prompt_name: string;
   llm_config?: string | null | undefined;
   comments?: string | null | undefined;
   user_email: string;
+  linked_tools?: Array<PromptHistoryLinkedTool$Outbound> | undefined;
+  is_pre_enhancements: boolean;
 };
 
 /** @internal */
@@ -91,20 +118,26 @@ export const PromptHistory$outboundSchema: z.ZodType<
 > = z.object({
   timestamp: z.date().transform(v => v.toISOString()),
   promptId: z.string(),
+  versionNumber: z.number().int(),
   promptText: z.string(),
   promptDescription: z.nullable(z.string()).optional(),
   promptName: z.string(),
   llmConfig: z.nullable(z.string()).optional(),
   comments: z.nullable(z.string()).optional(),
   userEmail: z.string(),
+  linkedTools: z.array(PromptHistoryLinkedTool$outboundSchema).optional(),
+  isPreEnhancements: z.boolean(),
 }).transform((v) => {
   return remap$(v, {
     promptId: "prompt_id",
+    versionNumber: "version_number",
     promptText: "prompt_text",
     promptDescription: "prompt_description",
     promptName: "prompt_name",
     llmConfig: "llm_config",
     userEmail: "user_email",
+    linkedTools: "linked_tools",
+    isPreEnhancements: "is_pre_enhancements",
   });
 });