@amigo-ai/sdk 0.9.0 → 0.11.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

@@ -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;
             /**
@@ -7949,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.
@@ -8359,7 +8360,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Conflicts with existing organization with the same `org_id`. */
+            /** @description Conflicts with existing organization with the same `org_id`, or a related operation is in progress. */
             409: {
                 headers: {
                     [name: string]: unknown;

package/package.json

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