@amigo-ai/sdk 0.8.0 → 0.10.0

package/README.md

@@ -44,6 +44,14 @@ async function example() {
 example()
 ```
 
+## Examples
+
+- **Conversation management**:
+  - [Basic conversation](examples/conversation/basic-conversation.ts)
+  - [Streaming conversation events](examples/conversation/conversation-events.ts)
+- **User management**:
+  - [User management examples](examples/user/user-management.ts)
+
 ## Configuration
 
 The SDK requires the following configuration parameters:
@@ -68,6 +76,34 @@ For detailed instructions on generating API keys, see the [Authentication Guide]
 
 This SDK auto-generates its types from the latest Amigo OpenAPI schema. As a result, only the latest published SDK version is guaranteed to match the current API. If you pin to an older version, it may not include the newest endpoints or fields.
 
+## Generated types
+
+The SDK ships with TypeScript types generated from the latest OpenAPI schema and re-exports them for convenience.
+
+- **Importing types**:
+
+```typescript
+import type { components, operations, paths } from '@amigo-ai/sdk'
+
+// Example: response types
+type Conversation = components['schemas']['Conversation']
+
+// Example: operation params
+type GetConversationsParams = operations['getConversations']['parameters']['query']
+```
+
+## Retries
+
+The HTTP client includes sensible, configurable retries:
+
+- **Defaults**:
+  - max attempts: 3
+  - backoff base: 250ms (exponential with full jitter)
+  - max delay per attempt: 30s
+  - retry on status: {408, 429, 500, 502, 503, 504}
+  - retry on methods: {GET}
+  - special-case: POST is retried on 429 when `Retry-After` is present
+
 ## Error Handling
 
 The SDK provides typed error handling:

package/dist/types/generated/api-types.d.ts

@@ -3231,9 +3231,9 @@ export interface components {
             };
         };
         /** @enum {string} */
-        LLMLoadBalancingSetType: "o4-mini-2025-04-16" | "gpt-4.1-2025-04-14" | "gpt-4.1-mini-2025-04-14" | "gpt-5-2025-08-07" | "gpt-5-mini-2025-08-07" | "gpt-5-nano-2025-08-07" | "gpt-5-chat-2025-08-07" | "claude-sonnet-4-20250514";
+        LLMLoadBalancingSetType: "o4-mini-2025-04-16" | "gpt-5-2025-08-07" | "gpt-5-mini-2025-08-07" | "gpt-5-nano-2025-08-07" | "gpt-5-chat-2025-08-07" | "claude-sonnet-4-20250514";
         /** @enum {string} */
-        LLMType: "openai_o4-mini-2025-04-16" | "openai_gpt-4.1-2025-04-14" | "openai_gpt-4.1-mini-2025-04-14" | "openai_gpt-5-2025-08-07" | "openai_gpt-5-mini-2025-08-07" | "openai_gpt-5-nano-2025-08-07" | "openai_gpt-5-chat-2025-08-07" | "azure_o4-mini-2025-04-16" | "azure_gpt-4.1-2025-04-14" | "azure_gpt-4.1-mini-2025-04-14" | "azure_gpt-5-2025-08-07" | "azure_gpt-5-mini-2025-08-07" | "azure_gpt-5-nano-2025-08-07" | "azure_gpt-5-chat-2025-08-07" | "google_claude-sonnet-4@20250514" | "aws_claude-sonnet-4-20250514" | "anthropic_claude-sonnet-4-20250514" | "google_gemini-2.5-pro" | "google_gemini-2.5-flash";
+        LLMType: "openai_o4-mini-2025-04-16" | "openai_gpt-5-2025-08-07" | "openai_gpt-5-mini-2025-08-07" | "openai_gpt-5-nano-2025-08-07" | "openai_gpt-5-chat-2025-08-07" | "azure_o4-mini-2025-04-16" | "azure_gpt-4.1-2025-04-14" | "azure_gpt-4.1-mini-2025-04-14" | "azure_gpt-5-2025-08-07" | "azure_gpt-5-mini-2025-08-07" | "azure_gpt-5-nano-2025-08-07" | "azure_gpt-5-chat-2025-08-07" | "google_claude-sonnet-4@20250514" | "aws_claude-sonnet-4-20250514" | "anthropic_claude-sonnet-4-20250514" | "google_gemini-2.5-pro" | "google_gemini-2.5-flash";
         /** MP3UserMessageAudioConfig */
         MP3UserMessageAudioConfig: {
             /**
@@ -5240,13 +5240,14 @@ export interface components {
                 [key: string]: unknown;
             };
             /**
-             * Tool Branch Name
-             * @description The name of the branch in the tool repository that this version corresponds to.
+             * Tool Repo
+             * @description Whether this tool is published from the main repository or the team-specific repository.
+             * @enum {string}
              */
-            tool_branch_name: string;
+            tool_repo: "main" | "team";
             /**
              * Tool Commit Hash
-             * @description The commit hash of the tool within the `tool_branch_name`.
+             * @description The commit hash of the tool within the repository.
              */
             tool_commit_hash: string;
             /**
@@ -5960,6 +5961,7 @@ export interface components {
         amigo_lib__pydantic__base_model__StrippedNonemptyString__1: string;
         amigo_lib__pydantic__base_model__StrippedNonemptyString__2: string;
         amigo_lib__pydantic__base_model__StrippedNonemptyString__3: string;
+        amigo_lib__pydantic__base_model__StrippedNonemptyString__4: string;
         src__app__amigo__service__conversation__Action: components["schemas"]["SelectDynamicBehaviorAgentActionEvent"] | components["schemas"]["CheckIfActiveMemoryNeededAgentActionEvent"] | components["schemas"]["ExtractActiveMemoriesAgentActionEvent"] | components["schemas"]["NavigateStateMachineAgentActionEvent"] | components["schemas"]["EngageUserAgentActionEvent"];
         /** Response */
         admin__ping_server__Response: {
@@ -6475,7 +6477,7 @@ export interface components {
         /** Request */
         organization__create_agent__Request: {
             /** @description The name of the new agent. */
-            agent_name: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__2"];
+            agent_name: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__3"];
         };
         /** Response */
         organization__create_agent__Response: {
@@ -6488,7 +6490,7 @@ export interface components {
         /** Request */
         organization__create_agent_version__Request: {
             /** @description The agent's initials. */
-            initials?: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__3"] | null;
+            initials?: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__4"] | null;
             /** @description Information about the agent's identity. */
             identity?: components["schemas"]["Identity-Input"] | null;
             /** @description A description of the agent's background. */
@@ -6625,7 +6627,7 @@ export interface components {
             onboarding_instructions: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__1"][];
             /** @description The name of the Azure DevOps team to create (if it doesn't exist) for this organization. All orgs with the same Azure DevOps team name will share access to the same Azure DevOps resources, namely
              *     the source code for tools. */
-            azure_devops_team_name: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__1"];
+            azure_devops_team_name: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__2"];
         };
         /** Preferences */
         organization__create_organization__Request__Preferences: {
@@ -6663,7 +6665,7 @@ export interface components {
         /** Request */
         organization__create_service_hierarchical_state_machine__Request: {
             /** @description The name of the new state machine. */
-            state_machine_name: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__2"];
+            state_machine_name: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__3"];
         };
         /** Response */
         organization__create_service_hierarchical_state_machine__Response: {
@@ -7049,7 +7051,7 @@ export interface components {
         /** Request */
         role__create_role__Request: {
             /** @description The name of the role to create. The role must have a max length of 256 characters. */
-            role_name: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__2"];
+            role_name: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__3"];
             /** @description A description about the role. */
             description: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__1"];
             /**
@@ -7948,12 +7950,12 @@ export interface components {
         /** Request */
         tool__publish_tool_version__Request: {
             /**
-             * Branch
-             * @description The branch of the tools repo to publish the tool version from. If `team`, then it's published from the release branch of the organization's
-             *     Azure DevOps team. If `main`, then it's published from the main branch of the tools repo.
+             * Repo
+             * @description The repo to publish the tool version from. If `team`, then it's published from the repo of the organization's Azure DevOps team. If `main`, then it's published
+             *     from the `tools-main` repo.
              * @enum {string}
              */
-            branch: "main" | "team";
+            repo: "main" | "team";
             /**
              * Project Path
              * @description The directory in the tools repo that contains the `pyproject.toml` file corresponding to the tool version to publish.
@@ -8480,7 +8482,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description The current environment does not support this endpoint. */
+            /** @description The current environment or organization does not support this endpoint. */
             400: {
                 headers: {
                     [name: string]: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amigo-ai/sdk",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Amigo TypeScript SDK",
   "publishConfig": {
     "access": "public"